Received: by 2002:ac0:a5a6:0:0:0:0:0 with SMTP id m35-v6csp1395034imm; Sun, 2 Sep 2018 22:14:09 -0700 (PDT) X-Google-Smtp-Source: ANB0VdZPpx4NM6V9s2Lfnzbn1JUp+034VmiJb2c44SHHY9PPrDvyahyY6Bn3VcX74RMT6cOL/K8r X-Received: by 2002:a17:902:a715:: with SMTP id w21-v6mr8890993plq.61.1535951649415; Sun, 02 Sep 2018 22:14:09 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1535951649; cv=none; d=google.com; s=arc-20160816; b=okqpK4hSvKGDyEckoUSV1/cey+yCbBo5/g5ril6NfXWjTptEhnuI5cKDEceissvb+E bgIrWaahnW7QnGYWl45w5vft6pwbVZ19M+gFOBDL6vNT/A5TqhJSCOn7Yw++xl3diXCB EnYwv/O4ggo2VULZ0+3YQGtqLCJb5HrtB8MOUohPkFKzi1J4WBuQC/VqCeN+BbeiXQDw noiSqctNbA7NOag8CvkZIlq5sGWr+UBry3/ESY7zEV5blrFW1lTfLFJXT9DrVwi4P5VC IwPBAjf0ftySxGylY29cobuJI88QKaesUCyVKFGcohaO2iIuWhXtnL9fv77auujXTMnI YQJg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:user-agent:in-reply-to :content-disposition:mime-version:references:subject:cc:to:from:date :arc-authentication-results; bh=6fpTqQemQWk5M605i/WAQ7pJn/BtJV1T9eGLbnKgG3Y=; b=Oqa9TOwTmxscBtp1YdnZG9WX/i9wdiJoBIY+5D8ua8qZ8Tf4zX7yrM3bac8wfK8gT8 srsKZnNpVpx8j4FeekktoLuMc76IXH4Q9bi8mZxq5QQ3KJqkPLi2tf1tP7V3Mzpousys PL+wbK3qdXuZb6ezSaILLR4ayvOtVuIhdoLNOp5N4qiG8GrrWMZyoc7KwYnmHkWzai+e tMKWuUdPqaOCJzCYoMaW7Xcv8RmctdcV/IsjsqTsT4jMoqIuDqWs58PdDbN4Y8VKBv2r UB1r+mbKQDbdeS1muHtQlTl9wZuVVkdMZ67FcuzFSFI2+ndA+E/8Zo8fvxaHDJHxU1iR K6Wg== 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 z71-v6si17128570pff.223.2018.09.02.22.13.54; Sun, 02 Sep 2018 22:14:09 -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 S1726157AbeICJbS (ORCPT + 99 others); Mon, 3 Sep 2018 05:31:18 -0400 Received: from mx0b-001b2d01.pphosted.com ([148.163.158.5]:51714 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1725977AbeICJbR (ORCPT ); Mon, 3 Sep 2018 05:31:17 -0400 Received: from pps.filterd (m0098414.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w8358lA5078327 for ; Mon, 3 Sep 2018 01:12:48 -0400 Received: from e06smtp01.uk.ibm.com (e06smtp01.uk.ibm.com [195.75.94.97]) by mx0b-001b2d01.pphosted.com with ESMTP id 2m8u1spa4j-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Mon, 03 Sep 2018 01:12:47 -0400 Received: from localhost by e06smtp01.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Mon, 3 Sep 2018 06:12:46 +0100 Received: from b06cxnps4075.portsmouth.uk.ibm.com (9.149.109.197) by e06smtp01.uk.ibm.com (192.168.101.131) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Mon, 3 Sep 2018 06:12:43 +0100 Received: from d06av26.portsmouth.uk.ibm.com (d06av26.portsmouth.uk.ibm.com [9.149.105.62]) by b06cxnps4075.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w835CgiV42467396 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Mon, 3 Sep 2018 05:12:42 GMT Received: from d06av26.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E80AAAE04D; Mon, 3 Sep 2018 08:12:07 +0100 (BST) Received: from d06av26.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 46554AE045; Mon, 3 Sep 2018 08:12:07 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.8.79]) by d06av26.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Mon, 3 Sep 2018 08:12:07 +0100 (BST) Date: Mon, 3 Sep 2018 08:12:40 +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 Subject: Re: [PATCH v3 0/3] docs/core-api: add memory allocation guide References: <1534517236-16762-1-git-send-email-rppt@linux.vnet.ibm.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1534517236-16762-1-git-send-email-rppt@linux.vnet.ibm.com> User-Agent: Mutt/1.5.24 (2015-08-30) X-TM-AS-GCONF: 00 x-cbid: 18090305-4275-0000-0000-000002B43073 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18090305-4276-0000-0000-000037BD3CDA Message-Id: <20180903051239.GB5826@rapoport-lnx> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-09-03_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=949 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1809030056 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Any updates on this? On Fri, Aug 17, 2018 at 05:47:13PM +0300, Mike Rapoport wrote: > 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 > -- Sincerely yours, Mike.