Received: by 2002:ac0:a5a7:0:0:0:0:0 with SMTP id m36-v6csp2551629imm; Thu, 16 Aug 2018 11:19:50 -0700 (PDT) X-Google-Smtp-Source: AA+uWPwTnBWvabvutB3Vu1jOlw/RkZWJ6CaHwXgEvomuleSU8w1pAwtj6rPYk7whnL/HiKVqPtbA X-Received: by 2002:a62:1157:: with SMTP id z84-v6mr33495009pfi.66.1534443590785; Thu, 16 Aug 2018 11:19:50 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1534443590; cv=none; d=google.com; s=arc-20160816; b=m37mIF0/QW7Rdl3bctS9SfFAXvapCqtNhDRnSSajc3DRS0G38HFKCVc9U9e1f/qCZA F9BK3lLysLHA37f7bRdaqgbjA+r7s3EC5Tjz95z+IfGBK2kWxnrUhN69ZxjSrLHIy85c s5Y4dTxQmC+mUtiuTdan43kehDdon6bmFopVK0qtj5cK7RYSUT8EbZSwv/sxO+v7Gfjq b3yKZvpYDvzvPV8IQOOzP1u4NlsUQTYkD8zwdOMau97hM/+pgOGgZT6OKUSo199PNi45 PE/6lU23Qw0h9m/OGLINTYHlse/dz6Hoj5UTxIlNNTl7lgEQSHfWQRYc+CKZ2w0K1fJN Uydg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:date:subject:cc:to:from :arc-authentication-results; bh=PT00oGTOLUgUATW8DmY+J/+R/m6nRf+v9gxBrTQd+Qs=; b=CCoTzYSDwLYY3oC+jKGsklv+Q51URwuVhCEcZns/2JQbCB4OHxKVPZgEXaqIwgxLa2 JNYm5ZoickK6u3seKwwb5TKLiczKOIs6XPJugF5Z591OrYLHRE3p7EAe6K40XNkRDv33 mkssmg5jo4743BvpIKF0dnlgFAsqjhEFeIGRXdHGQqOelcNIIKZisMUANUmzBIqM+meC AT5mb3EAttAN0OxaFkNNLoNSGryKI0R5dJy+TY/Ea2Zhb4nzvj+PuA8w1vY3a7y28b15 3FbPOGY03sC1kRckIM6c0KJgSMrzyRwvO3DIocxZIJ6nxz6JpAhFED9yOCGx8HrvLZzf b2uw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id r10-v6si25614966pli.248.2018.08.16.11.19.35; Thu, 16 Aug 2018 11:19:50 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2391568AbeHPQC0 (ORCPT + 99 others); Thu, 16 Aug 2018 12:02:26 -0400 Received: from mx0a-001b2d01.pphosted.com ([148.163.156.1]:51690 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2391531AbeHPQCW (ORCPT ); Thu, 16 Aug 2018 12:02:22 -0400 Received: from pps.filterd (m0098409.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w7GD0uGL122221 for ; Thu, 16 Aug 2018 09:03:52 -0400 Received: from e06smtp04.uk.ibm.com (e06smtp04.uk.ibm.com [195.75.94.100]) by mx0a-001b2d01.pphosted.com with ESMTP id 2kw6p4fqk6-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Thu, 16 Aug 2018 09:03:50 -0400 Received: from localhost by e06smtp04.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Thu, 16 Aug 2018 14:03:47 +0100 Received: from b06cxnps3074.portsmouth.uk.ibm.com (9.149.109.194) by e06smtp04.uk.ibm.com (192.168.101.134) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Thu, 16 Aug 2018 14:03:43 +0100 Received: from d06av26.portsmouth.uk.ibm.com (d06av26.portsmouth.uk.ibm.com [9.149.105.62]) by b06cxnps3074.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w7GD3gYX37945558 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Thu, 16 Aug 2018 13:03:42 GMT Received: from d06av26.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 9E250AE064; Thu, 16 Aug 2018 16:03:26 +0100 (BST) Received: from d06av26.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 0647AAE057; Thu, 16 Aug 2018 16:03:25 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.8.148]) by d06av26.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Thu, 16 Aug 2018 16:03:24 +0100 (BST) Received: by rapoport-lnx (sSMTP sendmail emulation); Thu, 16 Aug 2018 16:03:39 +0300 From: Mike Rapoport To: Jonathan Corbet Cc: Michal Hocko , Randy Dunlap , Matthew Wilcox , Vlastimil Babka , linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Mike Rapoport Subject: [PATCH v2 0/3] docs/core-api: add memory allocation guide Date: Thu, 16 Aug 2018 16:03:35 +0300 X-Mailer: git-send-email 2.7.4 X-TM-AS-GCONF: 00 x-cbid: 18081613-0016-0000-0000-000001F7B1C3 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18081613-0017-0000-0000-0000324DE84B Message-Id: <1534424618-24713-1-git-send-email-rppt@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-08-16_03:,, signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=742 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1808160137 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi, As Vlastimil mentioned at [1], it would be nice to have some guide about memory allocation. This set adds such guide that summarizes the "best practices". The changes from the RFC include additions and corrections from Michal and Randy. I've also added markup to cross-reference the kernel-doc documentation. I've split the patch into three to separate labels addition to the exiting files from the new contents. Note that the second patch depends on the mm docs update [2] that Andrew took to the -mm tree. [1] https://www.spinics.net/lists/netfilter-devel/msg55542.html [2] https://lkml.org/lkml/2018/7/26/684 Mike Rapoport (3): docs: core-api/gfp_mask-from-fs-io: add a label for cross-referencing docs: core-api/mm-api: add a lable for GFP flags section docs: core-api: add memory allocation guide Documentation/core-api/gfp_mask-from-fs-io.rst | 2 + Documentation/core-api/index.rst | 1 + Documentation/core-api/memory-allocation.rst | 124 +++++++++++++++++++++++++ Documentation/core-api/mm-api.rst | 2 + 4 files changed, 129 insertions(+) create mode 100644 Documentation/core-api/memory-allocation.rst -- 2.7.4