Received: by 2002:ac0:a5a7:0:0:0:0:0 with SMTP id m36-v6csp856806imm; Fri, 17 Aug 2018 07:49:16 -0700 (PDT) X-Google-Smtp-Source: AA+uWPyECufYQAqVsNbc6+1+QItBOPeLScrKT+nA4srd3+Z9Ps43BSOwItstbyP0c7D6zeY6Yj8w X-Received: by 2002:a62:7d8d:: with SMTP id y135-v6mr5498769pfc.259.1534517356426; Fri, 17 Aug 2018 07:49:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1534517356; cv=none; d=google.com; s=arc-20160816; b=eL5ctcO6rvxnES2TR9pgRc2Y4V0emXXX6p+n8plkbGjJZijikTuIenpheF2w2bxZ4l A3u1GF/fQVnT3dprJWDxVMBSuLqClaMW75exgidROxyVVeDDqE1t3zIlgwJzmvrwkNuo f3NFEYHUOI1OcEgRUHihjZ+TTvrMW1BalJ8XSaXh0Ho65Mz/uTTxLjSqngNSC3oI6/I1 TsAiMFKyF02HbnB6w7JntoJ46gbiDYbMMmFZvYA1BX6tXkJ1QinEu7LgtA8uXJwOPWU/ AwwbUYtxAHlhHEY29IMkNXDY0YZgyDcqC0Gnfzlp/kI5dbAOGT79pifE3m7gNX8TT8cJ nQ7w== 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=BDkFQx7qYQ3xAhNnbac8FoFhsxBNCRuocWjpMSFmz/U=; b=yIMwMuqPmTwf7QllMUuCt4p5APtiJTMnbqajdrEoeD4vzNlighSVj3K8fGUeobrXK6 4NpHvhoelpUIdSYdEj0ZqqAC7m6N/k+P4+K0VAB6z21f5pOGt9RzGBTS3rzy+w2Gn1wa ZUI/ohtigICe6TVNii/O57ugsgRpgJOD2q6wHvZqIUtquDPhKo8EvoT6IMv1dEZJglRz vNUvqSUT7x9RSfTxXvhXTox8mzikqJkZ21eosA4FvXFbQHCViSmOJgp0xox5tuoJnKJf wCztJ2KMpidV6h8WlVRl0UhfB+2VJspHPkfcdGYWeXTjOTfuULT6pTJdyuMVQ7bAeU4v Z6Wg== 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 a8-v6si2387879ple.189.2018.08.17.07.49.01; Fri, 17 Aug 2018 07:49:16 -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 S1727437AbeHQRvH (ORCPT + 99 others); Fri, 17 Aug 2018 13:51:07 -0400 Received: from mx0a-001b2d01.pphosted.com ([148.163.156.1]:47816 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726377AbeHQRvH (ORCPT ); Fri, 17 Aug 2018 13:51:07 -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 w7HEiAmt005512 for ; Fri, 17 Aug 2018 10:47:27 -0400 Received: from e06smtp02.uk.ibm.com (e06smtp02.uk.ibm.com [195.75.94.98]) by mx0a-001b2d01.pphosted.com with ESMTP id 2kwvcjt1ak-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 17 Aug 2018 10:47:27 -0400 Received: from localhost by e06smtp02.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 17 Aug 2018 15:47:25 +0100 Received: from b06cxnps4076.portsmouth.uk.ibm.com (9.149.109.198) by e06smtp02.uk.ibm.com (192.168.101.132) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 17 Aug 2018 15:47:21 +0100 Received: from d06av24.portsmouth.uk.ibm.com (mk.ibm.com [9.149.105.60]) by b06cxnps4076.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w7HElK8Z24510492 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Fri, 17 Aug 2018 14:47:20 GMT Received: from d06av24.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id CF29D42047; Fri, 17 Aug 2018 17:47:24 +0100 (BST) Received: from d06av24.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B21B34203F; Fri, 17 Aug 2018 17:47:22 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.205.113]) by d06av24.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Fri, 17 Aug 2018 17:47:22 +0100 (BST) Received: by rapoport-lnx (sSMTP sendmail emulation); Fri, 17 Aug 2018 17:47:17 +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 v3 0/3] docs/core-api: add memory allocation guide Date: Fri, 17 Aug 2018 17:47:13 +0300 X-Mailer: git-send-email 2.7.4 X-TM-AS-GCONF: 00 x-cbid: 18081714-0008-0000-0000-000002633A12 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18081714-0009-0000-0000-000021CB6A31 Message-Id: <1534517236-16762-1-git-send-email-rppt@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-08-17_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=769 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1808170160 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. v2 -> v3: * s/HW/hardware [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