Received: by 2002:ac0:a5a6:0:0:0:0:0 with SMTP id m35-v6csp540438imm; Fri, 14 Sep 2018 02:29:01 -0700 (PDT) X-Google-Smtp-Source: ANB0Vdb1aiBJBwiiFYHOZDi87AmvknNHlGCD9U9vs+rQ2jvLORHBeyKG7At+/8VEMY9BjZmJodRW X-Received: by 2002:a65:65c6:: with SMTP id y6-v6mr11110395pgv.436.1536917341525; Fri, 14 Sep 2018 02:29:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1536917341; cv=none; d=google.com; s=arc-20160816; b=UXvewGrinbyAo2rqMBG4bAm51+eQEJ0C4TBKz+zSd7boaQcM0lyTA0hTw1dWi231s1 zxMChE5LNcQcaqWcLVO0Mv2zB8ZWC5by34XHocw4i5zTCLeQNj5pXV/m/KuxjcwkpmKV bJbNwjx0wenSl7SOaDS+QnJJTCxxhorSuh52JCZeypzeWF767VfBXQmn5nyBxHF8xhjg NZJ5I6pbgIDjkwMLFOMVPxslJzpzsTKl2QBpMJtcRO543HKDJhYyuNJRjjqhXvbFllNH W45SP65njgCoBqctwNpDrSHsrzZs0yE//HP5+yJmV5tVeNjWDbabzXPkLUklmjpT/dW3 e6Bw== 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; bh=5clQw+lMZGKuMmfrqGECBEV6H/aXFNB91zqLAMNkVdU=; b=nBTkRYdd1Ipm+9dl/94zqSfzB6wiDeAKsomKUpWisCgSvnwTldYgDfog5G3zlFLHp7 XuWFN7lX3IW3aP0mA5nTQZf14mLQFseMLNySRTU5RxWqUCj1TsXp4B4+VhXMSRW+s6om U/dUsrjU2+by757I03wGGfBvDbA7+Hqb+ik56ne4IWWqybbuMCIQWtuL2Z5BBsRoXqL1 n9horAz/LHE/Ql2kqd+aM81XGQMvY8pQvNucGUgJCc9dNJX9jF2E2fbTtoi4/oi0gGIl KL1mtM2tP65gEI8/DWz7b71gCCM2MaumxJtGO8iMD+wwXUV0xak2sSkfzvDoQOQXzVDz 6+cg== 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 k2-v6si5382709pgp.602.2018.09.14.02.28.46; Fri, 14 Sep 2018 02:29:01 -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 S1728253AbeINOlw (ORCPT + 99 others); Fri, 14 Sep 2018 10:41:52 -0400 Received: from mx0a-001b2d01.pphosted.com ([148.163.156.1]:54392 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727966AbeINOlw (ORCPT ); Fri, 14 Sep 2018 10:41:52 -0400 Received: from pps.filterd (m0098394.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w8E9O7As008999 for ; Fri, 14 Sep 2018 05:28:13 -0400 Received: from e06smtp03.uk.ibm.com (e06smtp03.uk.ibm.com [195.75.94.99]) by mx0a-001b2d01.pphosted.com with ESMTP id 2mg8nk4n3c-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 14 Sep 2018 05:28:09 -0400 Received: from localhost by e06smtp03.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 14 Sep 2018 10:28:07 +0100 Received: from b06cxnps3074.portsmouth.uk.ibm.com (9.149.109.194) by e06smtp03.uk.ibm.com (192.168.101.133) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 14 Sep 2018 10:28:03 +0100 Received: from d06av21.portsmouth.uk.ibm.com (d06av21.portsmouth.uk.ibm.com [9.149.105.232]) by b06cxnps3074.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w8E9S2vR1376560 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Fri, 14 Sep 2018 09:28:02 GMT Received: from d06av21.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 9BBD452050; Fri, 14 Sep 2018 12:27:50 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.207.116]) by d06av21.portsmouth.uk.ibm.com (Postfix) with ESMTPS id C4F665204E; Fri, 14 Sep 2018 12:27:48 +0100 (BST) Received: by rapoport-lnx (sSMTP sendmail emulation); Fri, 14 Sep 2018 12:28:00 +0300 From: Mike Rapoport To: Jonathan Corbet Cc: Matthew Wilcox , Michal Hocko , Randy Dunlap , Vlastimil Babka , linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Mike Rapoport Subject: [PATCH v4 0/3] docs/core-api: add memory allocation guide Date: Fri, 14 Sep 2018 12:27:55 +0300 X-Mailer: git-send-email 2.7.4 X-TM-AS-GCONF: 00 x-cbid: 18091409-0012-0000-0000-000002A8C421 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18091409-0013-0000-0000-000020DD0E27 Message-Id: <1536917278-31191-1-git-send-email-rppt@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-09-14_04:,, 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=783 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1809140101 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. v3 -> v4: * make GFP_*USER* description less confusing v2 -> v3: * s/HW/hardware [1] https://www.spinics.net/lists/netfilter-devel/msg55542.html 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 | 122 +++++++++++++++++++++++++ Documentation/core-api/mm-api.rst | 2 + 4 files changed, 127 insertions(+) create mode 100644 Documentation/core-api/memory-allocation.rst -- 2.7.4