From patchwork Wed Jul 25 11:26:04 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 10543853 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 92C82184F for ; Wed, 25 Jul 2018 11:26:27 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 81D7129A00 for ; Wed, 25 Jul 2018 11:26:27 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 7577829A9F; Wed, 25 Jul 2018 11:26:27 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=2.0 tests=BAYES_00,MAILING_LIST_MULTI, RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.1 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 0F08829A00 for ; Wed, 25 Jul 2018 11:26:27 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id F0D1A6B0284; Wed, 25 Jul 2018 07:26:25 -0400 (EDT) Delivered-To: linux-mm-outgoing@kvack.org Received: by kanga.kvack.org (Postfix, from userid 40) id E99C56B0286; Wed, 25 Jul 2018 07:26:25 -0400 (EDT) X-Original-To: int-list-linux-mm@kvack.org X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id C952A6B0287; Wed, 25 Jul 2018 07:26:25 -0400 (EDT) X-Original-To: linux-mm@kvack.org X-Delivered-To: linux-mm@kvack.org Received: from mail-ed1-f71.google.com (mail-ed1-f71.google.com [209.85.208.71]) by kanga.kvack.org (Postfix) with ESMTP id 6B99C6B0284 for ; Wed, 25 Jul 2018 07:26:25 -0400 (EDT) Received: by mail-ed1-f71.google.com with SMTP id r9-v6so2985645edh.14 for ; Wed, 25 Jul 2018 04:26:25 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-original-authentication-results:x-gm-message-state:from:to:cc :subject:date:in-reply-to:references:message-id; bh=TibzKu7s9JcVfBnBJfOYh4WY8gv2SH3SsOTziV9MyGU=; b=rqRdAwprE0qCf2PBqbGYKEfmMxbCTUiJgcnu67/hgmHMNNTHKz44Ryld6bw4vAyIos xxPUr59kpVMaaXtrzedFiLrfgIY6QMBpHpT8Usv4sY9s89nVT2lMjleDp3Ne9XGTAzpT IBMZzuteo/QSOvebWAQqI/vgtwIq/7YLM7D3OKWmSAt7Rq0N006s+h+9sGdzNMd8pF/8 Z9a3NPXD4j2ukql04RKH56EdLCLVp724tW8nzrHsvLUrMDSckDWe8BioEk7ObRc3imDZ nr8XptY226s/VA6lV9hwCr5M+3zExTMncNW5XlQC2R1lAyPq4yEKYUwc2SnUlWIfX0Y6 Dwaw== X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com X-Gm-Message-State: AOUpUlEamDlevsEb1F528XPUODy112yowNa/3QfXwdZJ0pvK8/fLnObi lcN5KDIEU/RHIHrqOroFFnPCohy/GogYqXM6CVTO3+AYnAgjUMcGC6IliT1gSJ9l6eu/tJjxNzG iwNND6urxz6suGlVjQ1uHOL06v3lPTF2hpu/H/VPCJHho0paGNxSl0SFO7+YNglQ= X-Received: by 2002:a50:abc2:: with SMTP id u60-v6mr23262777edc.43.1532517985014; Wed, 25 Jul 2018 04:26:25 -0700 (PDT) X-Google-Smtp-Source: AAOMgpdk0kly8lxdPcbv8bFPfdWktZW5JMHQkhHezOSBBhLaMWgH4QniJsrmw4m1ftUyAPcFeh7D X-Received: by 2002:a50:abc2:: with SMTP id u60-v6mr23262741edc.43.1532517984373; Wed, 25 Jul 2018 04:26:24 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1532517984; cv=none; d=google.com; s=arc-20160816; b=I8B22mfZeMQFD5fp433TxeU26aguYZKl6huDodjsMb+ypqKkTUToqjiOgXIa2Wwf8Z z0coloI7QbXvMq/wwdXFt61XGdeJDQzOMedGqOFDSi52R8uoLr0wORm4Qv6vnMBiuXaI BRgjy+VYa1cUQELsLgS/aaIqFOnA97MEfvgp/IUeHbX5+SJ2QXEa9crLKoiTF6z0UPuX z/DGtBf/sYsmlCBc1e9c6pjosgCYqBPcKReuzGZgKvFr4XZEKwsuIhZBDM8d7gX8SXT9 64+uCFyZKHVKfYdEeUnXKUPKrl/NrV35TVHTC7ZqNk2X1MlIbL8TxcSznwshoKSVX8F4 Z+8A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:references:in-reply-to:date:subject:cc:to:from :arc-authentication-results; bh=TibzKu7s9JcVfBnBJfOYh4WY8gv2SH3SsOTziV9MyGU=; b=BVTtDMwDcGdFBj+7k9i3gXdYQ/Xhf9DYYsPkyrHP+lVH3f1VkcSqsdgjW1CcjfQnpz kmM0AMFL7l3O9MXoNOf0UmKqBI4+vMkyo83Js/9juFCJd3xiQ/lJ1sjoaq8x+xkaCDga tsrZzI5c906iAcyLMyeIP/BNTWhpR8DeTG6wEvtxFSqNS+kt9cLCUK/MWBhvg+EJXgmk rbSq8uITCsjarZEGAyk5byJElOY5KCFrldj6On1rpfAHQy1fGC+zvj/SEuPPcklVFFP2 s/b1tsT7SDL4zZZXM4ChJCDtrMcXKomqpj1XVqqTzt8VSH7ZJ8fTWSMTGmHcDFtMkW3X oZAw== ARC-Authentication-Results: i=1; mx.google.com; spf=neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com. [148.163.158.5]) by mx.google.com with ESMTPS id z14-v6si2313709edd.127.2018.07.25.04.26.23 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 25 Jul 2018 04:26:24 -0700 (PDT) Received-SPF: neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) client-ip=148.163.158.5; Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from pps.filterd (m0098420.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w6PBOAEf047745 for ; Wed, 25 Jul 2018 07:26:22 -0400 Received: from e06smtp03.uk.ibm.com (e06smtp03.uk.ibm.com [195.75.94.99]) by mx0b-001b2d01.pphosted.com with ESMTP id 2keq0ckhfg-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 25 Jul 2018 07:26:22 -0400 Received: from localhost by e06smtp03.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Wed, 25 Jul 2018 12:26:20 +0100 Received: from b06cxnps4074.portsmouth.uk.ibm.com (9.149.109.196) 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) Wed, 25 Jul 2018 12:26:17 +0100 Received: from d06av24.portsmouth.uk.ibm.com (mk.ibm.com [9.149.105.60]) by b06cxnps4074.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w6PBQGLV31391960 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Wed, 25 Jul 2018 11:26:16 GMT Received: from d06av24.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id E8E8D42041; Wed, 25 Jul 2018 14:26:30 +0100 (BST) Received: from d06av24.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 7314F42049; Wed, 25 Jul 2018 14:26:29 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.8.110]) by d06av24.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Wed, 25 Jul 2018 14:26:29 +0100 (BST) Received: by rapoport-lnx (sSMTP sendmail emulation); Wed, 25 Jul 2018 14:26:13 +0300 From: Mike Rapoport To: Jonathan Corbet , Andrew Morton Cc: linux-doc@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Mike Rapoport Subject: [PATCH 1/7] mm/util: make strndup_user description a kernel-doc comment Date: Wed, 25 Jul 2018 14:26:04 +0300 X-Mailer: git-send-email 2.7.4 In-Reply-To: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> References: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> X-TM-AS-GCONF: 00 x-cbid: 18072511-0012-0000-0000-0000028E948B X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18072511-0013-0000-0000-000020C07B88 Message-Id: <1532517970-16409-2-git-send-email-rppt@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-07-25_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=761 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1806210000 definitions=main-1807250124 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: X-Virus-Scanned: ClamAV using ClamSMTP The description of the strndup_user function misses '*' character at the beginning of the comment to be proper kernel-doc. Add the missing character. Signed-off-by: Mike Rapoport --- mm/util.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mm/util.c b/mm/util.c index 3351659..6809014 100644 --- a/mm/util.c +++ b/mm/util.c @@ -196,7 +196,7 @@ void *vmemdup_user(const void __user *src, size_t len) } EXPORT_SYMBOL(vmemdup_user); -/* +/** * strndup_user - duplicate an existing string from user space * @s: The string to duplicate * @n: Maximum number of bytes to copy, including the trailing NUL. From patchwork Wed Jul 25 11:26:05 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 10543855 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 0BC9E1822 for ; Wed, 25 Jul 2018 11:26:30 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id EED9529960 for ; Wed, 25 Jul 2018 11:26:29 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id E273E29A55; Wed, 25 Jul 2018 11:26:29 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=2.0 tests=BAYES_00,MAILING_LIST_MULTI, RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.1 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 749D529960 for ; Wed, 25 Jul 2018 11:26:29 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 765576B0286; Wed, 25 Jul 2018 07:26:27 -0400 (EDT) Delivered-To: linux-mm-outgoing@kvack.org Received: by kanga.kvack.org (Postfix, from userid 40) id 726A06B028A; Wed, 25 Jul 2018 07:26:27 -0400 (EDT) X-Original-To: int-list-linux-mm@kvack.org X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 543E56B0289; Wed, 25 Jul 2018 07:26:27 -0400 (EDT) X-Original-To: linux-mm@kvack.org X-Delivered-To: linux-mm@kvack.org Received: from mail-oi0-f72.google.com (mail-oi0-f72.google.com [209.85.218.72]) by kanga.kvack.org (Postfix) with ESMTP id 24DBA6B0286 for ; Wed, 25 Jul 2018 07:26:27 -0400 (EDT) Received: by mail-oi0-f72.google.com with SMTP id w185-v6so7233156oig.19 for ; Wed, 25 Jul 2018 04:26:27 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-original-authentication-results:x-gm-message-state:from:to:cc :subject:date:in-reply-to:references:message-id; bh=tsgWAzD/V/iTM9XVrNLk/H44DkI8oDZBWthlaIbs3ZI=; b=PT49XZuZcLbSA0cHhyH8tuK/AOu6D9h0FO+/F1f4ngFwrzKfP6Ns3n9R4zP+2xeM8Q SSmApSX96uxl2EQ00bUIfGO+KfM5mZLtzmNsB5WR9xumRVkADnTRV76DLf0kLnMk22KP sP14qsIhcNp7yehUyepFFvMANRnMvX1sCGouTA9iYXGJBTiLBwqmoDPBuUcZf3dWeWrK H+mQdds6h7orBVruiFFw++3KJIXBTCxd9YPzrzHNe3VWnlzIbO/SEt1VfQCQEuvwzRdQ U6XA7n5xKCdDT70tFnO41YThlgwOsD0wsFGckmK5Dy+f3TZMR1zspLTQ3NbWHlFTSO08 Wsyw== X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com X-Gm-Message-State: AOUpUlHyrPh8YNhA/0S/xXCPdmiIFujZBSBhoqq8I+ti8+7rY5PNcRfF 45stRrqmpxYDfkl2UxRrYHIM0D332FhySVAJXB1WhdmYETjOpGvk0Han+Dx40jwN0c0zWm2KQ1Q cJI5yYsujqxnIeWSvPYtJQtOErMr+w6aDTAPMiXDl88ZozxUgF6/3mn6skKZtkpc= X-Received: by 2002:aca:2808:: with SMTP id 8-v6mr3140356oix.7.1532517986952; Wed, 25 Jul 2018 04:26:26 -0700 (PDT) X-Google-Smtp-Source: AAOMgpdT3KkR6cKfovbnZwHwwnzJi/TtS2opJX6+zUUTib8C9cYpKyMfRGbwHGq82pSVo/k2TskZ X-Received: by 2002:aca:2808:: with SMTP id 8-v6mr3140318oix.7.1532517986390; Wed, 25 Jul 2018 04:26:26 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1532517986; cv=none; d=google.com; s=arc-20160816; b=fAdW8zAFRg9ZAy1PicJO39Pt27Ep/ulTsUZFqYNHMFmDIArAoZb1KspylPcndglggo Qribq/tzIEAAgmlo2tyrVGASv8uVeWfjDE/DfgGDOlL9xldimel8thamFzQv2GcyGou2 NGDDtho+3l6B5k3dB8R+47O+LoLjqMRwhAGmySnjZqZMoUE8PsR4WIU9qVOWWqxD5Psf v9RJnuKCcDrWzhJEq+ZII0IHZvNnSTL/0sso/+COwxHK0RdY64Vo/cVZGRL2p12ZuIP2 aJCASSO8xcWSakUtJvCSsJbKw8gtbbmikUbEvKotLY8axFh5sjZ8HAOsjyHR2QNnt/w5 ZX+Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:references:in-reply-to:date:subject:cc:to:from :arc-authentication-results; bh=tsgWAzD/V/iTM9XVrNLk/H44DkI8oDZBWthlaIbs3ZI=; b=bT9yMFJXSBr2WlQBYK1RAv9fJ8DUH1i9fJv5H82aeBqAw7HAXZ6jhEwwPoBkYxplxl oXrTanv0r7BKKqpYdtWO8iZ4hNg1LTe6GA1604KivHmZZmh1dN1jR2CQqOKie+C+brpH 30h3BeThW+0NdMURGxKrr5JjtIVGj3sTZd6FOl8VL0k5laBQPqIJsO3KJh8p5mDc/DIV MpaJkpyYTZIEavxg3puhfeBAoRVen5/KvtLkDZDIysY639pPD/ER62h2RJO9NJ6wXT4e r3322W80Wj4LO+mHd00K2e6YtA21w8Hm7dxAiv7MreCJq73G/Y/+lre1/VtcIg9H8rkZ asJg== ARC-Authentication-Results: i=1; mx.google.com; spf=neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com. [148.163.156.1]) by mx.google.com with ESMTPS id t194-v6si10212244oif.388.2018.07.25.04.26.26 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 25 Jul 2018 04:26:26 -0700 (PDT) Received-SPF: neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) client-ip=148.163.156.1; Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from pps.filterd (m0098410.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w6PBOH14082943 for ; Wed, 25 Jul 2018 07:26:25 -0400 Received: from e06smtp05.uk.ibm.com (e06smtp05.uk.ibm.com [195.75.94.101]) by mx0a-001b2d01.pphosted.com with ESMTP id 2kep26pc9h-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 25 Jul 2018 07:26:25 -0400 Received: from localhost by e06smtp05.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Wed, 25 Jul 2018 12:26:21 +0100 Received: from b06cxnps4076.portsmouth.uk.ibm.com (9.149.109.198) by e06smtp05.uk.ibm.com (192.168.101.135) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Wed, 25 Jul 2018 12:26:19 +0100 Received: from d06av25.portsmouth.uk.ibm.com (d06av25.portsmouth.uk.ibm.com [9.149.105.61]) by b06cxnps4076.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w6PBQI5a42074250 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Wed, 25 Jul 2018 11:26:18 GMT Received: from d06av25.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 2BC7E11C058; Wed, 25 Jul 2018 14:26:32 +0100 (BST) Received: from d06av25.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id AAEE411C04C; Wed, 25 Jul 2018 14:26:30 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.8.110]) by d06av25.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Wed, 25 Jul 2018 14:26:30 +0100 (BST) Received: by rapoport-lnx (sSMTP sendmail emulation); Wed, 25 Jul 2018 14:26:16 +0300 From: Mike Rapoport To: Jonathan Corbet , Andrew Morton Cc: linux-doc@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Mike Rapoport Subject: [PATCH 2/7] mm/util: add kernel-doc for kvfree Date: Wed, 25 Jul 2018 14:26:05 +0300 X-Mailer: git-send-email 2.7.4 In-Reply-To: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> References: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> X-TM-AS-GCONF: 00 x-cbid: 18072511-0020-0000-0000-000002AAF0A7 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18072511-0021-0000-0000-000020F789E9 Message-Id: <1532517970-16409-3-git-send-email-rppt@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-07-25_03:,, signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=2 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=832 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1806210000 definitions=main-1807250124 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: X-Virus-Scanned: ClamAV using ClamSMTP Signed-off-by: Mike Rapoport --- mm/util.c | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/mm/util.c b/mm/util.c index 6809014..d2890a4 100644 --- a/mm/util.c +++ b/mm/util.c @@ -434,6 +434,13 @@ void *kvmalloc_node(size_t size, gfp_t flags, int node) } EXPORT_SYMBOL(kvmalloc_node); +/** + * kvfree - free memory allocated with kvmalloc + * @addr: pointer returned by kvmalloc + * + * If the memory is allocated from vmalloc area it is freed with vfree(). + * Otherwise kfree() is used. + */ void kvfree(const void *addr) { if (is_vmalloc_addr(addr)) From patchwork Wed Jul 25 11:26:06 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 10543857 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id A305B17FD for ; Wed, 25 Jul 2018 11:26:36 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 9194B29960 for ; Wed, 25 Jul 2018 11:26:36 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 85B7E29A9F; Wed, 25 Jul 2018 11:26:36 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=2.0 tests=BAYES_00,MAILING_LIST_MULTI, RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.1 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 8AFB829960 for ; Wed, 25 Jul 2018 11:26:34 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 808E56B0289; Wed, 25 Jul 2018 07:26:28 -0400 (EDT) Delivered-To: linux-mm-outgoing@kvack.org Received: by kanga.kvack.org (Postfix, from userid 40) id 73E3C6B028A; Wed, 25 Jul 2018 07:26:28 -0400 (EDT) X-Original-To: int-list-linux-mm@kvack.org X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 6030C6B028D; Wed, 25 Jul 2018 07:26:28 -0400 (EDT) X-Original-To: linux-mm@kvack.org X-Delivered-To: linux-mm@kvack.org Received: from mail-ed1-f72.google.com (mail-ed1-f72.google.com [209.85.208.72]) by kanga.kvack.org (Postfix) with ESMTP id 00CDE6B028A for ; Wed, 25 Jul 2018 07:26:28 -0400 (EDT) Received: by mail-ed1-f72.google.com with SMTP id n4-v6so2995380edr.5 for ; Wed, 25 Jul 2018 04:26:27 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-original-authentication-results:x-gm-message-state:from:to:cc :subject:date:in-reply-to:references:message-id; bh=ubI1RXGG1ZPcJI88EitZOFGyQ0e3sySCTZaYiVqhXgU=; b=izyQTFBYXfb9xLf8ANqphvezCPtQ+QHUHGU2cW1MgjfK2lH/gFSdgeFFeHLitnZE22 IBhDhVX6xoD6TpOSyrwS6bRgs9kB+jUp/JUJv8yoWr8Bq1w5t5NYrWyhc+qkNW9KfFyu +Q5xStvha2PxYOsmx2tu+YVv+yVn2s84Q5no//BIc/PBd9jAOoYuVcxz+Xpni9ykCmMZ +mvhkKtjImfQbQ4VwRCjTZyL7QYxYMQT/rqIxfm0w8ct2V+VY+Uqoluv9NypJK8kI4BO Sh5aENtHqQQtDqSd/TwsnJ7itwhRF+Yf9E2eC2yTq640lJpdBBS6emM9AQJz6eibhW6o 8WyQ== X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com X-Gm-Message-State: AOUpUlFFjg5iLuB61B1HElEXhXfaDb4i2Yqlw7LnnMr9dsXoQF93PP13 ivGsr2verYHJ4FwkiMVb2k757Lh7jcnHvE5BWtK7+LshS0hRK3pFaUZW6+ePGON7KXfLrLIQ9FR uDsfTDf6dWij2ALisu/YGMxFuTmvwr0j8dlnvPeulc2JTSSjeHRl9CqWgCgVIizE= X-Received: by 2002:a50:8345:: with SMTP id 63-v6mr3214829edh.5.1532517987582; Wed, 25 Jul 2018 04:26:27 -0700 (PDT) X-Google-Smtp-Source: AAOMgpeJVVk+K/egaqLwJqSrXywaw5hSQ9+PiHxvOB9oJ1ZAEccN96SFfcqbIf7h03QMYrf0yIwh X-Received: by 2002:a50:8345:: with SMTP id 63-v6mr3214804edh.5.1532517987021; Wed, 25 Jul 2018 04:26:27 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1532517987; cv=none; d=google.com; s=arc-20160816; b=uoZJpv+LHzd5oRnTqYggvg9Xk/RCFxPNBgaTG3qJBtu0WOOmUYiBpxPeVdO76hJ5ZX bqYzula+lKFNYtdmIa34cfHFV7g1xFVXT8AwZWdvndmrx1AYMyc1QPhTz0Ms5GPz4Kyg AnbyCIqHPmwlTTXeAIB4CRbO44UN4b1Wl/t4pPJYrVnteJ8A6ulUlzKswi4bp+7PvVdu AmaV2+sCGsKilku3Q0cZ1KtK5gcn3pFjOFogAND/YR5OHP9p1zs2kIBdb3J4sEgpqiZx keYuyWdF3JU62MJGxYRdn3nGD1towqI4xOseFaM7gbY74bpY1PL32vzEjHpLfB2/Wt+k yI4w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:references:in-reply-to:date:subject:cc:to:from :arc-authentication-results; bh=ubI1RXGG1ZPcJI88EitZOFGyQ0e3sySCTZaYiVqhXgU=; b=QORSctDt+T095q6EU8EwhpxDJvM3ummikkaPj4Mv4idEkdFWHwQ0z8ZFeFEFHDEZsQ rTOUTV2/3LBfPGOb+Jb27gjIOPCE2VuGEqCkw+BlcElI9e3JUPwQKwY1Kwi9pjsB3fEl 9A53SJKX3GV6OuQYHHzkih4xn7RV6syTdJFm4Vtg/NWfA3vL5jxu2Sd27o7JCvIxN5Dp 7+diMpsVfs/iZ9LB5pOZ95xPDMilM/5TGCCYBqIPqBETDNTpcdQ0yYdfxRE7VZ/BR1Wt qYN269Jnj6RZ36bB1oCALkzu1AWhjOYezJvdupUFWtR59mU703jTSrY8pfPWeOqfiI2j jiNw== ARC-Authentication-Results: i=1; mx.google.com; spf=neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com. [148.163.158.5]) by mx.google.com with ESMTPS id o13-v6si1073606edh.418.2018.07.25.04.26.26 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 25 Jul 2018 04:26:26 -0700 (PDT) Received-SPF: neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) client-ip=148.163.158.5; Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w6PBP7Q0108815 for ; Wed, 25 Jul 2018 07:26:25 -0400 Received: from e06smtp02.uk.ibm.com (e06smtp02.uk.ibm.com [195.75.94.98]) by mx0b-001b2d01.pphosted.com with ESMTP id 2kepdcn37f-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 25 Jul 2018 07:26:25 -0400 Received: from localhost by e06smtp02.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Wed, 25 Jul 2018 12:26:23 +0100 Received: from b06cxnps3074.portsmouth.uk.ibm.com (9.149.109.194) 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) Wed, 25 Jul 2018 12:26:21 +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 w6PBQKdu42926272 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Wed, 25 Jul 2018 11:26:20 GMT Received: from d06av26.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 51729AE053; Wed, 25 Jul 2018 14:26:28 +0100 (BST) Received: from d06av26.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id D0898AE045; Wed, 25 Jul 2018 14:26:26 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.8.110]) by d06av26.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Wed, 25 Jul 2018 14:26:26 +0100 (BST) Received: by rapoport-lnx (sSMTP sendmail emulation); Wed, 25 Jul 2018 14:26:18 +0300 From: Mike Rapoport To: Jonathan Corbet , Andrew Morton Cc: linux-doc@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Mike Rapoport Subject: [PATCH 3/7] docs/core-api: kill trailing whitespace in kernel-api.rst Date: Wed, 25 Jul 2018 14:26:06 +0300 X-Mailer: git-send-email 2.7.4 In-Reply-To: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> References: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> X-TM-AS-GCONF: 00 x-cbid: 18072511-0008-0000-0000-00000257806F X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18072511-0009-0000-0000-000021BDF970 Message-Id: <1532517970-16409-4-git-send-email-rppt@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-07-25_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=874 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1806210000 definitions=main-1807250124 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: X-Virus-Scanned: ClamAV using ClamSMTP Signed-off-by: Mike Rapoport --- Documentation/core-api/kernel-api.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/Documentation/core-api/kernel-api.rst b/Documentation/core-api/kernel-api.rst index 76fe2d0f..25e9496 100644 --- a/Documentation/core-api/kernel-api.rst +++ b/Documentation/core-api/kernel-api.rst @@ -437,4 +437,3 @@ Read-Copy Update (RCU) .. kernel-doc:: include/linux/rcu_sync.h .. kernel-doc:: kernel/rcu/sync.c - From patchwork Wed Jul 25 11:26:07 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 10543859 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id E69121805 for ; Wed, 25 Jul 2018 11:26:37 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id D63CA29960 for ; Wed, 25 Jul 2018 11:26:37 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id CA47029B3F; Wed, 25 Jul 2018 11:26:37 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=2.0 tests=BAYES_00,MAILING_LIST_MULTI, RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.1 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 61DBA29960 for ; Wed, 25 Jul 2018 11:26:37 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id E96166B028A; Wed, 25 Jul 2018 07:26:32 -0400 (EDT) Delivered-To: linux-mm-outgoing@kvack.org Received: by kanga.kvack.org (Postfix, from userid 40) id E40CE6B028E; Wed, 25 Jul 2018 07:26:32 -0400 (EDT) X-Original-To: int-list-linux-mm@kvack.org X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id CBB5C6B028F; Wed, 25 Jul 2018 07:26:32 -0400 (EDT) X-Original-To: linux-mm@kvack.org X-Delivered-To: linux-mm@kvack.org Received: from mail-ed1-f69.google.com (mail-ed1-f69.google.com [209.85.208.69]) by kanga.kvack.org (Postfix) with ESMTP id 695FF6B028A for ; Wed, 25 Jul 2018 07:26:32 -0400 (EDT) Received: by mail-ed1-f69.google.com with SMTP id s18-v6so2980861edr.15 for ; Wed, 25 Jul 2018 04:26:32 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-original-authentication-results:x-gm-message-state:from:to:cc :subject:date:in-reply-to:references:message-id; bh=XM+7L2BilOtR0Lf4ViYxHiZv5B/fzeAqge+WEoT92wM=; b=U6nO6fSchS5T2zLPZtwc5SgKxfu74o98OUbsfsv6nw8apJl7odieODdY9/LxEZX9ou vsW3Kmcx5h4uJ8iNGYcNjEi5FOgka97ZUrRvehNxJ/PWEHfNPUJTH+RmQFv/JnUipRr+ gjCriQH6qvjOGgbQdvRwo53abmdbLzRQHnQq4hEk8aSp0fta+ZYQn2+w3+gdyOiuk8X2 2VQ/iIvha4+pAHA6CrxJbRzB50hPemX0EQDi4EZg9ohhYs7jUFFQsS0Gvj+su2yAGAPQ 0lU0EB0A8yb0k/gsL1cYffWnfCvv5fqy3Hq1K2nGslmBkZLPLyZFypebLuonjcdsvcI8 UzGA== X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com X-Gm-Message-State: AOUpUlGJ5bUfGJ9y/Emv3uSmUkQaycIdhBIRbpRqx0T0LYn/qDhPdA3D puCYT5Oue2e7/qx0KH2kgN1mwKZ09rKsJ8/7EnV3b+0FSv24oceqV/yeJO3Pc2anuybVWB1Ls7M L+gyMOvPFpFgsdpcg+acTYjFQNK/nJB8qHnAczfL1vyBE4biDvskYhGKG80+KTSM= X-Received: by 2002:aa7:da9a:: with SMTP id q26-v6mr22352505eds.115.1532517991989; Wed, 25 Jul 2018 04:26:31 -0700 (PDT) X-Google-Smtp-Source: AAOMgpdjWqOa6PeYwL+L1diuWsJnl1a/m5MYO4YsM6GhwK0QAei4Zk3lM9YhY1+NFWnhxm0Dwv/G X-Received: by 2002:aa7:da9a:: with SMTP id q26-v6mr22352470eds.115.1532517991385; Wed, 25 Jul 2018 04:26:31 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1532517991; cv=none; d=google.com; s=arc-20160816; b=g0TZcsrfNxK2P26lyGMUFq1X0vmtEHQ3Z1yBWMKH54y5zl8TExj27RRiKAprSZRr7U xX/7iz+KpKY0RZiIIIY9YXJoFC88xxEjZ6WzncF7D7QyoGAx0tyq7BbPs/g2sinr5O12 t125M2W0UoKlLv0J4Sxdi9lVbhkD/WD/vDGdpBZ7lVPJQ6vKTiPcu6kbJzhWFBwwhBE7 FByQ0KW1h/Z0xj/mx7vTsNeC9Pu7V7GHKQruAxBxisYb2j7mCJMx7t/0sm/isA5OUWqV 1zbflox0dr6+4eT7cDo+x/8gULcYTzo9m6nrY6E17sCdRmpJlIZT3krhVMju0xwc8xPX fphw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:references:in-reply-to:date:subject:cc:to:from :arc-authentication-results; bh=XM+7L2BilOtR0Lf4ViYxHiZv5B/fzeAqge+WEoT92wM=; b=FUiB4+8iTsKUy2VFnBYSLMRzLaSw2gBnZ6RA6Owoq+y5ttijagwb3sWt9Cl8uFudRt Utcd1WNhG6zKzxQoIoKKWCcedCUZWmLmsF5J5oyD38GPARvaK3+b2GsXpKI11CsZsNBY /bVHFPGO3CmiXpVwNyGwC62GoIDLbIB8nOFLOrzOymAvIJZeqshLI7tcM3JmGjZF822j YnqBnsTkDz8BvyM7/fkbyLKhCSI75ASeAm4EkmYc88B7G6+3MSB3Up+RyNmitPwtKhvq WsDIMtW6VLLHEeRtRGV8gWEelg85VVBfuNgHI37yY5eV/hNKZ+KyDucmkQUs82l7hK1k MfMw== ARC-Authentication-Results: i=1; mx.google.com; spf=neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com. [148.163.156.1]) by mx.google.com with ESMTPS id h7-v6si1696266edb.124.2018.07.25.04.26.30 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 25 Jul 2018 04:26:31 -0700 (PDT) Received-SPF: neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) client-ip=148.163.156.1; Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from pps.filterd (m0098396.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w6PBPJ8G086245 for ; Wed, 25 Jul 2018 07:26:29 -0400 Received: from e06smtp07.uk.ibm.com (e06smtp07.uk.ibm.com [195.75.94.103]) by mx0a-001b2d01.pphosted.com with ESMTP id 2keqphhb6p-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 25 Jul 2018 07:26:29 -0400 Received: from localhost by e06smtp07.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Wed, 25 Jul 2018 12:26:26 +0100 Received: from b06cxnps3075.portsmouth.uk.ibm.com (9.149.109.195) by e06smtp07.uk.ibm.com (192.168.101.137) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Wed, 25 Jul 2018 12:26:23 +0100 Received: from d06av22.portsmouth.uk.ibm.com (d06av22.portsmouth.uk.ibm.com [9.149.105.58]) by b06cxnps3075.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w6PBQMhd28835938 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Wed, 25 Jul 2018 11:26:22 GMT Received: from d06av22.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 8073C4C046; Wed, 25 Jul 2018 14:26:37 +0100 (BST) Received: from d06av22.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 153364C059; Wed, 25 Jul 2018 14:26:36 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.8.110]) by d06av22.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Wed, 25 Jul 2018 14:26:35 +0100 (BST) Received: by rapoport-lnx (sSMTP sendmail emulation); Wed, 25 Jul 2018 14:26:20 +0300 From: Mike Rapoport To: Jonathan Corbet , Andrew Morton Cc: linux-doc@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Mike Rapoport Subject: [PATCH 4/7] docs/core-api: move *{str,mem}dup* to "String Manipulation" Date: Wed, 25 Jul 2018 14:26:07 +0300 X-Mailer: git-send-email 2.7.4 In-Reply-To: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> References: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> X-TM-AS-GCONF: 00 x-cbid: 18072511-0028-0000-0000-000002E001AD X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18072511-0029-0000-0000-00002397ED3E Message-Id: <1532517970-16409-5-git-send-email-rppt@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-07-25_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=913 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1806210000 definitions=main-1807250124 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: X-Virus-Scanned: ClamAV using ClamSMTP The string and memory duplication routines fit better to the "String Manipulation" section than to "The SLAB Cache". Signed-off-by: Mike Rapoport --- Documentation/core-api/kernel-api.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Documentation/core-api/kernel-api.rst b/Documentation/core-api/kernel-api.rst index 25e9496..39f1460 100644 --- a/Documentation/core-api/kernel-api.rst +++ b/Documentation/core-api/kernel-api.rst @@ -39,6 +39,10 @@ String Manipulation .. kernel-doc:: lib/string.c :export: +.. kernel-doc:: mm/util.c + :functions: kstrdup kstrdup_const kstrndup kmemdup kmemdup_nul memdup_user + vmemdup_user strndup_user memdup_user_nul + Basic Kernel Library Functions ============================== @@ -168,7 +172,7 @@ The Slab Cache :export: .. kernel-doc:: mm/util.c - :export: + :functions: kfree_const kvmalloc_node kvfree get_user_pages_fast User Space Memory Access ------------------------ From patchwork Wed Jul 25 11:26:08 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 10543861 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 8ADF71805 for ; Wed, 25 Jul 2018 11:26:40 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 79A7F29960 for ; Wed, 25 Jul 2018 11:26:40 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 6BB8C29A55; Wed, 25 Jul 2018 11:26:40 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=2.0 tests=BAYES_00,MAILING_LIST_MULTI, RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.1 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id DEF1E29960 for ; Wed, 25 Jul 2018 11:26:39 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 1A1426B028E; Wed, 25 Jul 2018 07:26:34 -0400 (EDT) Delivered-To: linux-mm-outgoing@kvack.org Received: by kanga.kvack.org (Postfix, from userid 40) id 0D5D46B0290; Wed, 25 Jul 2018 07:26:34 -0400 (EDT) X-Original-To: int-list-linux-mm@kvack.org X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id F0D946B0291; Wed, 25 Jul 2018 07:26:33 -0400 (EDT) X-Original-To: linux-mm@kvack.org X-Delivered-To: linux-mm@kvack.org Received: from mail-oi0-f71.google.com (mail-oi0-f71.google.com [209.85.218.71]) by kanga.kvack.org (Postfix) with ESMTP id B1E316B028E for ; Wed, 25 Jul 2018 07:26:33 -0400 (EDT) Received: by mail-oi0-f71.google.com with SMTP id j5-v6so7232417oiw.13 for ; Wed, 25 Jul 2018 04:26:33 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-original-authentication-results:x-gm-message-state:from:to:cc :subject:date:in-reply-to:references:message-id; bh=zGe2azKGEp/muaSeVOvIMXRKyhuCTHnTymRklC/4mh8=; b=BH5E643D1KY2RajNA22h6qtQDze4bIttSvfMD158tmUJxm5yRGRIbpozOZ7eYoYWkw LqxbjmWyUP45ZGrpZUB7EzYxTGbOIuKFh/HFGaqR+KkpEIG2oKluO1HciviXnNU45q/Y l9A34lEqFTAWYSL77L3+hdn5bCj+LkXb1PH/NoPnw1lAJuS8J73PftNbjoXXUKN/Cupd Sc0pmzTGJn14jrJIs3p+B2vPCvKxCr+zag2w8YISZ8ltod7Cs+zSwbh1NXttnlsOODmU nFMlqxgWLtqC+SHvcf8CbRFy5Z5nH+6HZDtbQ14TNqN6uWRsgmNx3ZlhPL4Wi9CWyOJX Fi4w== X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com X-Gm-Message-State: AOUpUlEkJn1jzNe6F8FQ2qH5wE02lV0iBkwgX5t2ei1ZV6WZcHGKbiUz +Hjn74toIhrAQHZkPFTNcjqmJmp+VWw62iCVyTPSsXMm3+g5W+QaIuRkk+pCOWGFlMesyLw0RhI 4oZz5edxa56WpQEqEFe60GnKV9PO2U3qMCvfScl97tgYT0zkFZyaJEU913e8fXjc= X-Received: by 2002:aca:e184:: with SMTP id y126-v6mr3120433oig.313.1532517993506; Wed, 25 Jul 2018 04:26:33 -0700 (PDT) X-Google-Smtp-Source: AAOMgpf/+OLfu3saB8i0jTt1FCL+9nGP2fX0KUFfIV3y8fsh+8lfkuCWCatdF+MgKTHcQrHeViXF X-Received: by 2002:aca:e184:: with SMTP id y126-v6mr3120386oig.313.1532517992732; Wed, 25 Jul 2018 04:26:32 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1532517992; cv=none; d=google.com; s=arc-20160816; b=O7LY2KZRGJ/pQfizhKuTvlrMzgLxr6RpWexqERu1nqckB1KNzFzYWgPiyH9VbiW2HO bOGRikUy+ccBTIxy0+dPadBz6uOXDWPXbQQ7aP+cJ2M4ND9aqpoZ10cWPjmd03UE0MI1 rXcd1PbJhFeQkkMIr+5H47vd0QSrHISswDhHUBprNRbYPYphmDnnb7izN4VSCWVHgger HKTRSh5vImm/HKbsyI+u1ZA8CHwv320Df6xKW1Vt6FPG3lhDav09mfL/rhyWZjwIEDkN RSKclYNs6LoD6ybxWqTHaaG7DrHkUtdSRmvGsPLqNugjr0jmIqQ5ILwuj0QDzeFTbgGO zPTA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:references:in-reply-to:date:subject:cc:to:from :arc-authentication-results; bh=zGe2azKGEp/muaSeVOvIMXRKyhuCTHnTymRklC/4mh8=; b=VRGYoRI76hXI1h5H4X7ZcS09SVG1LklUfNx8nJ+bkT95o0jIF9+TiucM9u/k41gcKc O6uPWn7e2upVEvS9fnNmg/AD/ExnRseh3hSsLFPU/bOWhoyoeDbDPUfhVqzfbyDsqcr9 DGHbD6CUg7Xjs7d4vMwQSksTv19ugd14h50KYn18/zw6EmqDraj2DMeTPL1PPJKaANdP 7QPJ1Gi/ycQnRkX+1glGkI5RwDrrBEkqwZwJTEpGwy35ULCB4NHqpLJexqbOyvCASXe7 LJSKU1bYcRuz+T+pkFyDmaHAAoYGfFB5Kuu2oGv/VINLnlaZkpJoTcgW4Yv4u20w4iTx zlBw== ARC-Authentication-Results: i=1; mx.google.com; spf=neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com. [148.163.156.1]) by mx.google.com with ESMTPS id r3-v6si9674326oig.150.2018.07.25.04.26.32 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 25 Jul 2018 04:26:32 -0700 (PDT) Received-SPF: neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) client-ip=148.163.156.1; Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from pps.filterd (m0098410.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w6PBOGcl082846 for ; Wed, 25 Jul 2018 07:26:32 -0400 Received: from e06smtp03.uk.ibm.com (e06smtp03.uk.ibm.com [195.75.94.99]) by mx0a-001b2d01.pphosted.com with ESMTP id 2kep26pcpd-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 25 Jul 2018 07:26:31 -0400 Received: from localhost by e06smtp03.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Wed, 25 Jul 2018 12:26:29 +0100 Received: from b06cxnps4075.portsmouth.uk.ibm.com (9.149.109.197) 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) Wed, 25 Jul 2018 12:26:25 +0100 Received: from d06av23.portsmouth.uk.ibm.com (d06av23.portsmouth.uk.ibm.com [9.149.105.59]) by b06cxnps4075.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w6PBQOjo42139768 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Wed, 25 Jul 2018 11:26:24 GMT Received: from d06av23.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id AD27CA4053; Wed, 25 Jul 2018 14:26:38 +0100 (BST) Received: from d06av23.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 380C9A404D; Wed, 25 Jul 2018 14:26:37 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.8.110]) by d06av23.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Wed, 25 Jul 2018 14:26:37 +0100 (BST) Received: by rapoport-lnx (sSMTP sendmail emulation); Wed, 25 Jul 2018 14:26:22 +0300 From: Mike Rapoport To: Jonathan Corbet , Andrew Morton Cc: linux-doc@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Mike Rapoport Subject: [PATCH 5/7] docs/core-api: split memory management API to a separate file Date: Wed, 25 Jul 2018 14:26:08 +0300 X-Mailer: git-send-email 2.7.4 In-Reply-To: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> References: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> X-TM-AS-GCONF: 00 x-cbid: 18072511-0012-0000-0000-0000028E9491 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18072511-0013-0000-0000-000020C07B8D Message-Id: <1532517970-16409-6-git-send-email-rppt@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-07-25_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=863 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1806210000 definitions=main-1807250124 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: X-Virus-Scanned: ClamAV using ClamSMTP Signed-off-by: Mike Rapoport --- Documentation/core-api/index.rst | 1 + Documentation/core-api/kernel-api.rst | 54 ----------------------------------- Documentation/core-api/mm-api.rst | 54 +++++++++++++++++++++++++++++++++++ 3 files changed, 55 insertions(+), 54 deletions(-) create mode 100644 Documentation/core-api/mm-api.rst diff --git a/Documentation/core-api/index.rst b/Documentation/core-api/index.rst index f5a66b7..b580204 100644 --- a/Documentation/core-api/index.rst +++ b/Documentation/core-api/index.rst @@ -27,6 +27,7 @@ Core utilities errseq printk-formats circular-buffers + mm-api gfp_mask-from-fs-io Interfaces for kernel debugging diff --git a/Documentation/core-api/kernel-api.rst b/Documentation/core-api/kernel-api.rst index 39f1460..3431337 100644 --- a/Documentation/core-api/kernel-api.rst +++ b/Documentation/core-api/kernel-api.rst @@ -159,60 +159,6 @@ UUID/GUID .. kernel-doc:: lib/uuid.c :export: -Memory Management in Linux -========================== - -The Slab Cache --------------- - -.. kernel-doc:: include/linux/slab.h - :internal: - -.. kernel-doc:: mm/slab.c - :export: - -.. kernel-doc:: mm/util.c - :functions: kfree_const kvmalloc_node kvfree get_user_pages_fast - -User Space Memory Access ------------------------- - -.. kernel-doc:: arch/x86/include/asm/uaccess.h - :internal: - -.. kernel-doc:: arch/x86/lib/usercopy_32.c - :export: - -More Memory Management Functions --------------------------------- - -.. kernel-doc:: mm/readahead.c - :export: - -.. kernel-doc:: mm/filemap.c - :export: - -.. kernel-doc:: mm/memory.c - :export: - -.. kernel-doc:: mm/vmalloc.c - :export: - -.. kernel-doc:: mm/page_alloc.c - :internal: - -.. kernel-doc:: mm/mempool.c - :export: - -.. kernel-doc:: mm/dmapool.c - :export: - -.. kernel-doc:: mm/page-writeback.c - :export: - -.. kernel-doc:: mm/truncate.c - :export: - Kernel IPC facilities ===================== diff --git a/Documentation/core-api/mm-api.rst b/Documentation/core-api/mm-api.rst new file mode 100644 index 0000000..65a8ef09 --- /dev/null +++ b/Documentation/core-api/mm-api.rst @@ -0,0 +1,54 @@ +====================== +Memory Management APIs +====================== + +User Space Memory Access +======================== + +.. kernel-doc:: arch/x86/include/asm/uaccess.h + :internal: + +.. kernel-doc:: arch/x86/lib/usercopy_32.c + :export: + +The Slab Cache +============== + +.. kernel-doc:: include/linux/slab.h + :internal: + +.. kernel-doc:: mm/slab.c + :export: + +.. kernel-doc:: mm/util.c + :functions: kfree_const kvmalloc_node kvfree get_user_pages_fast + +More Memory Management Functions +================================ + +.. kernel-doc:: mm/readahead.c + :export: + +.. kernel-doc:: mm/filemap.c + :export: + +.. kernel-doc:: mm/memory.c + :export: + +.. kernel-doc:: mm/vmalloc.c + :export: + +.. kernel-doc:: mm/page_alloc.c + :internal: + +.. kernel-doc:: mm/mempool.c + :export: + +.. kernel-doc:: mm/dmapool.c + :export: + +.. kernel-doc:: mm/page-writeback.c + :export: + +.. kernel-doc:: mm/truncate.c + :export: From patchwork Wed Jul 25 11:26:09 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 10543863 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 6CA0B17FD for ; Wed, 25 Jul 2018 11:26:44 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 5833029960 for ; Wed, 25 Jul 2018 11:26:44 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 4BE9F29A55; Wed, 25 Jul 2018 11:26:44 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=2.0 tests=BAYES_00,MAILING_LIST_MULTI, RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.1 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id E6E9E29960 for ; Wed, 25 Jul 2018 11:26:42 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 090946B0290; Wed, 25 Jul 2018 07:26:36 -0400 (EDT) Delivered-To: linux-mm-outgoing@kvack.org Received: by kanga.kvack.org (Postfix, from userid 40) id 013236B0293; Wed, 25 Jul 2018 07:26:35 -0400 (EDT) X-Original-To: int-list-linux-mm@kvack.org X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id DF7786B0294; Wed, 25 Jul 2018 07:26:35 -0400 (EDT) X-Original-To: linux-mm@kvack.org X-Delivered-To: linux-mm@kvack.org Received: from mail-oi0-f69.google.com (mail-oi0-f69.google.com [209.85.218.69]) by kanga.kvack.org (Postfix) with ESMTP id B8A436B0290 for ; Wed, 25 Jul 2018 07:26:35 -0400 (EDT) Received: by mail-oi0-f69.google.com with SMTP id v205-v6so7258241oie.20 for ; Wed, 25 Jul 2018 04:26:35 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-original-authentication-results:x-gm-message-state:from:to:cc :subject:date:in-reply-to:references:message-id; bh=mntXm4P8E+75SM4+tFlOB3z6exz9sY8VZc6a83C6Dms=; b=ZiV2h1AuPH1kz5tvAoC5mNxCvy02FWfY8ASgJJZj2A6Kbrt3cbvudwurhrYBvvz7oK 6mC/E2E/3AWCZQ+DH3x/YFoGbrYaveDEoU41qk83aHRjLr+ZtVIyOoeHSZOqzMlwuPTN e8tFug6uml/HbOElsgahDhzKAI+7mCwhQ7AWPCuBDhSYRhzdtgjR938zsOPmhWp6T0cS 8C4Z3s2ceYAptZFig5atslcEqPkNx3ZlZlpNDYtR25jEL2BeiDrjr5isxexj5qYq2Wpk wPIz6PnX/HLR8qaPb8npu8fW/s3u0wdy4uP3MYkm/7v1AHZHujgHaHftLEs0OPH8RtnH LKAw== X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com X-Gm-Message-State: AOUpUlFDcdqacfVsGXifhGtzJevWyhhVfLYur9jrtJf9ALPyeC52faUU qgmUAjVMBYq29nSXZA2xRqVJab/yQCo6ogyrvWpSOkWmidgpVO2NdVegU4g9YD3RyKV9XURQxiG IjHXcdIFY+zsdom5hildYpAP4oh8COCbUIlSQJUsvic4IAzstSa/QaUDbFNqHptA= X-Received: by 2002:aca:3110:: with SMTP id x16-v6mr2814922oix.126.1532517995434; Wed, 25 Jul 2018 04:26:35 -0700 (PDT) X-Google-Smtp-Source: AAOMgpcVWFxi6Mhtn8tfpzWIVALYgAHdl1htdAbhXUSVeXyrjCl5X/MhUnZPtcrQciL2TNceup67 X-Received: by 2002:aca:3110:: with SMTP id x16-v6mr2814834oix.126.1532517993728; Wed, 25 Jul 2018 04:26:33 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1532517993; cv=none; d=google.com; s=arc-20160816; b=UoNrhDf7lT5452oovs8feUty5uG1lPtTGd+B+ndBYS344CHebBUwDMvNd+O7Gn+Ygi pk5EGMl18/hdLlfhuxyPmri2cP9659IJ57xAPFZ06wnCXgl1Hqb76gobmsAzLWDiC1bH PgR0GsgFKFtqWKQes7R8N2E4y+4Zb8/KT18kOJM4hKTsfKZJ0X8+r2fxaAe7rXVm44mB mxw18iUEgP0tMVrflt797uYD2JNj+WZat7HdDXghKtMx8yxzfPtbKgA2cC4xB9Oj/ioq NHp2R4UdZxqFoo5o7RDP9wUoMb98l9HEygZYizrOJ5anGDSnvCpSwr/Yu0POFewF7uf+ CdKg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:references:in-reply-to:date:subject:cc:to:from :arc-authentication-results; bh=mntXm4P8E+75SM4+tFlOB3z6exz9sY8VZc6a83C6Dms=; b=dEGIKCJKCDbCqmt3USAnLOfA8CWgmvaddtIabrJpj2C/ZHhP/X7r56XdeK/OdPW9x2 fdnc1v8CrxI+W7X4APWSxy4viT6J7VdwpzpzggBkfxJ6cE00eEirvC2aQ99uOOBnarcr 8V3Sk4PtFQTJvuOgWoctY6taAFMTOhoo2mcgX42FloFCBpMllQqu/PCl8G12T3++djVw 6r8LneNkPjKqv/POXoLr+AXYwXGChqEkeFJ3O4bpCJ37MV5uVaO32/NC2YmJjaBeHSyc w2HgyiavSVNs85SN3/NgeaH6cG/ns/c1c+H0EhP8nY0kCy/MrOwEoWUjiaGIcmRvQMlX +ndA== ARC-Authentication-Results: i=1; mx.google.com; spf=neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com. [148.163.158.5]) by mx.google.com with ESMTPS id s69-v6si9207341oie.222.2018.07.25.04.26.33 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 25 Jul 2018 04:26:33 -0700 (PDT) Received-SPF: neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) client-ip=148.163.158.5; Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.158.5 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com 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 w6PBPGPm026586 for ; Wed, 25 Jul 2018 07:26:33 -0400 Received: from e06smtp07.uk.ibm.com (e06smtp07.uk.ibm.com [195.75.94.103]) by mx0b-001b2d01.pphosted.com with ESMTP id 2ker0tgssc-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 25 Jul 2018 07:26:32 -0400 Received: from localhost by e06smtp07.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Wed, 25 Jul 2018 12:26:31 +0100 Received: from b06cxnps4076.portsmouth.uk.ibm.com (9.149.109.198) by e06smtp07.uk.ibm.com (192.168.101.137) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Wed, 25 Jul 2018 12:26:27 +0100 Received: from d06av24.portsmouth.uk.ibm.com (d06av24.portsmouth.uk.ibm.com [9.149.105.60]) by b06cxnps4076.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w6PBQQDi29294610 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Wed, 25 Jul 2018 11:26:26 GMT Received: from d06av24.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 9917D42041; Wed, 25 Jul 2018 14:26:41 +0100 (BST) Received: from d06av24.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 22C214203F; Wed, 25 Jul 2018 14:26:40 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.8.110]) by d06av24.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Wed, 25 Jul 2018 14:26:40 +0100 (BST) Received: by rapoport-lnx (sSMTP sendmail emulation); Wed, 25 Jul 2018 14:26:24 +0300 From: Mike Rapoport To: Jonathan Corbet , Andrew Morton Cc: linux-doc@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Mike Rapoport Subject: [PATCH 6/7] docs/mm: make GFP flags descriptions usable as kernel-doc Date: Wed, 25 Jul 2018 14:26:09 +0300 X-Mailer: git-send-email 2.7.4 In-Reply-To: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> References: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> X-TM-AS-GCONF: 00 x-cbid: 18072511-0028-0000-0000-000002E001B4 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18072511-0029-0000-0000-00002397ED47 Message-Id: <1532517970-16409-7-git-send-email-rppt@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-07-25_03:,, signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=2 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1806210000 definitions=main-1807250124 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: X-Virus-Scanned: ClamAV using ClamSMTP This patch adds DOC: headings for GFP flag descriptions and adjusts the formatting to fit sphinx expectations of paragraphs. Signed-off-by: Mike Rapoport --- include/linux/gfp.h | 291 +++++++++++++++++++++++++++------------------------- 1 file changed, 154 insertions(+), 137 deletions(-) diff --git a/include/linux/gfp.h b/include/linux/gfp.h index a6afcec..50c1d85 100644 --- a/include/linux/gfp.h +++ b/include/linux/gfp.h @@ -59,29 +59,32 @@ struct vm_area_struct; #define __GFP_MOVABLE ((__force gfp_t)___GFP_MOVABLE) /* ZONE_MOVABLE allowed */ #define GFP_ZONEMASK (__GFP_DMA|__GFP_HIGHMEM|__GFP_DMA32|__GFP_MOVABLE) -/* +/** + * DOC: Page mobility and placement hints + * * Page mobility and placement hints + * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * * These flags provide hints about how mobile the page is. Pages with similar * mobility are placed within the same pageblocks to minimise problems due * to external fragmentation. * - * __GFP_MOVABLE (also a zone modifier) indicates that the page can be - * moved by page migration during memory compaction or can be reclaimed. + * %__GFP_MOVABLE (also a zone modifier) indicates that the page can be + * moved by page migration during memory compaction or can be reclaimed. * - * __GFP_RECLAIMABLE is used for slab allocations that specify - * SLAB_RECLAIM_ACCOUNT and whose pages can be freed via shrinkers. + * %__GFP_RECLAIMABLE is used for slab allocations that specify + * SLAB_RECLAIM_ACCOUNT and whose pages can be freed via shrinkers. * - * __GFP_WRITE indicates the caller intends to dirty the page. Where possible, - * these pages will be spread between local zones to avoid all the dirty - * pages being in one zone (fair zone allocation policy). + * %__GFP_WRITE indicates the caller intends to dirty the page. Where possible, + * these pages will be spread between local zones to avoid all the dirty + * pages being in one zone (fair zone allocation policy). * - * __GFP_HARDWALL enforces the cpuset memory allocation policy. + * %__GFP_HARDWALL enforces the cpuset memory allocation policy. * - * __GFP_THISNODE forces the allocation to be satisified from the requested - * node with no fallbacks or placement policy enforcements. + * %__GFP_THISNODE forces the allocation to be satisified from the requested + * node with no fallbacks or placement policy enforcements. * - * __GFP_ACCOUNT causes the allocation to be accounted to kmemcg. + * %__GFP_ACCOUNT causes the allocation to be accounted to kmemcg. */ #define __GFP_RECLAIMABLE ((__force gfp_t)___GFP_RECLAIMABLE) #define __GFP_WRITE ((__force gfp_t)___GFP_WRITE) @@ -89,54 +92,60 @@ struct vm_area_struct; #define __GFP_THISNODE ((__force gfp_t)___GFP_THISNODE) #define __GFP_ACCOUNT ((__force gfp_t)___GFP_ACCOUNT) -/* +/** + * DOC: Watermark modifiers + * * Watermark modifiers -- controls access to emergency reserves + * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * - * __GFP_HIGH indicates that the caller is high-priority and that granting - * the request is necessary before the system can make forward progress. - * For example, creating an IO context to clean pages. + * %__GFP_HIGH indicates that the caller is high-priority and that granting + * the request is necessary before the system can make forward progress. + * For example, creating an IO context to clean pages. * - * __GFP_ATOMIC indicates that the caller cannot reclaim or sleep and is - * high priority. Users are typically interrupt handlers. This may be - * used in conjunction with __GFP_HIGH + * %__GFP_ATOMIC indicates that the caller cannot reclaim or sleep and is + * high priority. Users are typically interrupt handlers. This may be + * used in conjunction with %__GFP_HIGH * - * __GFP_MEMALLOC allows access to all memory. This should only be used when - * the caller guarantees the allocation will allow more memory to be freed - * very shortly e.g. process exiting or swapping. Users either should - * be the MM or co-ordinating closely with the VM (e.g. swap over NFS). + * %__GFP_MEMALLOC allows access to all memory. This should only be used when + * the caller guarantees the allocation will allow more memory to be freed + * very shortly e.g. process exiting or swapping. Users either should + * be the MM or co-ordinating closely with the VM (e.g. swap over NFS). * - * __GFP_NOMEMALLOC is used to explicitly forbid access to emergency reserves. - * This takes precedence over the __GFP_MEMALLOC flag if both are set. + * %__GFP_NOMEMALLOC is used to explicitly forbid access to emergency reserves. + * This takes precedence over the %__GFP_MEMALLOC flag if both are set. */ #define __GFP_ATOMIC ((__force gfp_t)___GFP_ATOMIC) #define __GFP_HIGH ((__force gfp_t)___GFP_HIGH) #define __GFP_MEMALLOC ((__force gfp_t)___GFP_MEMALLOC) #define __GFP_NOMEMALLOC ((__force gfp_t)___GFP_NOMEMALLOC) -/* +/** + * DOC: Reclaim modifiers + * * Reclaim modifiers + * ~~~~~~~~~~~~~~~~~ * - * __GFP_IO can start physical IO. + * %__GFP_IO can start physical IO. * - * __GFP_FS can call down to the low-level FS. Clearing the flag avoids the - * allocator recursing into the filesystem which might already be holding - * locks. + * %__GFP_FS can call down to the low-level FS. Clearing the flag avoids the + * allocator recursing into the filesystem which might already be holding + * locks. * - * __GFP_DIRECT_RECLAIM indicates that the caller may enter direct reclaim. - * This flag can be cleared to avoid unnecessary delays when a fallback - * option is available. + * %__GFP_DIRECT_RECLAIM indicates that the caller may enter direct reclaim. + * This flag can be cleared to avoid unnecessary delays when a fallback + * option is available. * - * __GFP_KSWAPD_RECLAIM indicates that the caller wants to wake kswapd when - * the low watermark is reached and have it reclaim pages until the high - * watermark is reached. A caller may wish to clear this flag when fallback - * options are available and the reclaim is likely to disrupt the system. The - * canonical example is THP allocation where a fallback is cheap but - * reclaim/compaction may cause indirect stalls. + * %__GFP_KSWAPD_RECLAIM indicates that the caller wants to wake kswapd when + * the low watermark is reached and have it reclaim pages until the high + * watermark is reached. A caller may wish to clear this flag when fallback + * options are available and the reclaim is likely to disrupt the system. The + * canonical example is THP allocation where a fallback is cheap but + * reclaim/compaction may cause indirect stalls. * - * __GFP_RECLAIM is shorthand to allow/forbid both direct and kswapd reclaim. + * %__GFP_RECLAIM is shorthand to allow/forbid both direct and kswapd reclaim. * * The default allocator behavior depends on the request size. We have a concept - * of so called costly allocations (with order > PAGE_ALLOC_COSTLY_ORDER). + * of so called costly allocations (with order > %PAGE_ALLOC_COSTLY_ORDER). * !costly allocations are too essential to fail so they are implicitly * non-failing by default (with some exceptions like OOM victims might fail so * the caller still has to check for failures) while costly requests try to be @@ -144,40 +153,40 @@ struct vm_area_struct; * The following three modifiers might be used to override some of these * implicit rules * - * __GFP_NORETRY: The VM implementation will try only very lightweight - * memory direct reclaim to get some memory under memory pressure (thus - * it can sleep). It will avoid disruptive actions like OOM killer. The - * caller must handle the failure which is quite likely to happen under - * heavy memory pressure. The flag is suitable when failure can easily be - * handled at small cost, such as reduced throughput - * - * __GFP_RETRY_MAYFAIL: The VM implementation will retry memory reclaim - * procedures that have previously failed if there is some indication - * that progress has been made else where. It can wait for other - * tasks to attempt high level approaches to freeing memory such as - * compaction (which removes fragmentation) and page-out. - * There is still a definite limit to the number of retries, but it is - * a larger limit than with __GFP_NORETRY. - * Allocations with this flag may fail, but only when there is - * genuinely little unused memory. While these allocations do not - * directly trigger the OOM killer, their failure indicates that - * the system is likely to need to use the OOM killer soon. The - * caller must handle failure, but can reasonably do so by failing - * a higher-level request, or completing it only in a much less - * efficient manner. - * If the allocation does fail, and the caller is in a position to - * free some non-essential memory, doing so could benefit the system - * as a whole. - * - * __GFP_NOFAIL: The VM implementation _must_ retry infinitely: the caller - * cannot handle allocation failures. The allocation could block - * indefinitely but will never return with failure. Testing for - * failure is pointless. - * New users should be evaluated carefully (and the flag should be - * used only when there is no reasonable failure policy) but it is - * definitely preferable to use the flag rather than opencode endless - * loop around allocator. - * Using this flag for costly allocations is _highly_ discouraged. + * %__GFP_NORETRY: The VM implementation will try only very lightweight + * memory direct reclaim to get some memory under memory pressure (thus + * it can sleep). It will avoid disruptive actions like OOM killer. The + * caller must handle the failure which is quite likely to happen under + * heavy memory pressure. The flag is suitable when failure can easily be + * handled at small cost, such as reduced throughput + * + * %__GFP_RETRY_MAYFAIL: The VM implementation will retry memory reclaim + * procedures that have previously failed if there is some indication + * that progress has been made else where. It can wait for other + * tasks to attempt high level approaches to freeing memory such as + * compaction (which removes fragmentation) and page-out. + * There is still a definite limit to the number of retries, but it is + * a larger limit than with %__GFP_NORETRY. + * Allocations with this flag may fail, but only when there is + * genuinely little unused memory. While these allocations do not + * directly trigger the OOM killer, their failure indicates that + * the system is likely to need to use the OOM killer soon. The + * caller must handle failure, but can reasonably do so by failing + * a higher-level request, or completing it only in a much less + * efficient manner. + * If the allocation does fail, and the caller is in a position to + * free some non-essential memory, doing so could benefit the system + * as a whole. + * + * %__GFP_NOFAIL: The VM implementation _must_ retry infinitely: the caller + * cannot handle allocation failures. The allocation could block + * indefinitely but will never return with failure. Testing for + * failure is pointless. + * New users should be evaluated carefully (and the flag should be + * used only when there is no reasonable failure policy) but it is + * definitely preferable to use the flag rather than opencode endless + * loop around allocator. + * Using this flag for costly allocations is _highly_ discouraged. */ #define __GFP_IO ((__force gfp_t)___GFP_IO) #define __GFP_FS ((__force gfp_t)___GFP_FS) @@ -188,14 +197,17 @@ struct vm_area_struct; #define __GFP_NOFAIL ((__force gfp_t)___GFP_NOFAIL) #define __GFP_NORETRY ((__force gfp_t)___GFP_NORETRY) -/* +/** + * DOC: Action modifiers + * * Action modifiers + * ~~~~~~~~~~~~~~~~ * - * __GFP_NOWARN suppresses allocation failure reports. + * %__GFP_NOWARN suppresses allocation failure reports. * - * __GFP_COMP address compound page metadata. + * %__GFP_COMP address compound page metadata. * - * __GFP_ZERO returns a zeroed page on success. + * %__GFP_ZERO returns a zeroed page on success. */ #define __GFP_NOWARN ((__force gfp_t)___GFP_NOWARN) #define __GFP_COMP ((__force gfp_t)___GFP_COMP) @@ -208,66 +220,71 @@ struct vm_area_struct; #define __GFP_BITS_SHIFT (23 + IS_ENABLED(CONFIG_LOCKDEP)) #define __GFP_BITS_MASK ((__force gfp_t)((1 << __GFP_BITS_SHIFT) - 1)) -/* +/** + * DOC: Common combinations + * + * Common combinations + * ~~~~~~~~~~~~~~~~~~~ + * * Useful GFP flag combinations that are commonly used. It is recommended * that subsystems start with one of these combinations and then set/clear - * __GFP_FOO flags as necessary. - * - * GFP_ATOMIC users can not sleep and need the allocation to succeed. A lower - * watermark is applied to allow access to "atomic reserves" - * - * GFP_KERNEL is typical for kernel-internal allocations. The caller requires - * ZONE_NORMAL or a lower zone for direct access but can direct reclaim. - * - * GFP_KERNEL_ACCOUNT is the same as GFP_KERNEL, except the allocation is - * accounted to kmemcg. - * - * GFP_NOWAIT is for kernel allocations that should not stall for direct - * reclaim, start physical IO or use any filesystem callback. - * - * GFP_NOIO will use direct reclaim to discard clean pages or slab pages - * that do not require the starting of any physical IO. - * Please try to avoid using this flag directly and instead use - * memalloc_noio_{save,restore} to mark the whole scope which cannot - * perform any IO with a short explanation why. All allocation requests - * will inherit GFP_NOIO implicitly. - * - * GFP_NOFS will use direct reclaim but will not use any filesystem interfaces. - * Please try to avoid using this flag directly and instead use - * memalloc_nofs_{save,restore} to mark the whole scope which cannot/shouldn't - * recurse into the FS layer with a short explanation why. All allocation - * requests will inherit GFP_NOFS implicitly. - * - * GFP_USER is for userspace allocations that also need to be directly - * accessibly by the kernel or hardware. It is typically used by hardware - * for buffers that are mapped to userspace (e.g. graphics) that hardware - * still must DMA to. cpuset limits are enforced for these allocations. - * - * GFP_DMA exists for historical reasons and should be avoided where possible. - * The flags indicates that the caller requires that the lowest zone be - * used (ZONE_DMA or 16M on x86-64). Ideally, this would be removed but - * it would require careful auditing as some users really require it and - * others use the flag to avoid lowmem reserves in ZONE_DMA and treat the - * lowest zone as a type of emergency reserve. - * - * GFP_DMA32 is similar to GFP_DMA except that the caller requires a 32-bit - * address. - * - * GFP_HIGHUSER is for userspace allocations that may be mapped to userspace, - * do not need to be directly accessible by the kernel but that cannot - * move once in use. An example may be a hardware allocation that maps - * data directly into userspace but has no addressing limitations. - * - * GFP_HIGHUSER_MOVABLE is for userspace allocations that the kernel does not - * need direct access to but can use kmap() when access is required. They - * are expected to be movable via page reclaim or page migration. Typically, - * pages on the LRU would also be allocated with GFP_HIGHUSER_MOVABLE. - * - * GFP_TRANSHUGE and GFP_TRANSHUGE_LIGHT are used for THP allocations. They are - * compound allocations that will generally fail quickly if memory is not - * available and will not wake kswapd/kcompactd on failure. The _LIGHT - * version does not attempt reclaim/compaction at all and is by default used - * in page fault path, while the non-light is used by khugepaged. + * %__GFP_FOO flags as necessary. + * + * %GFP_ATOMIC users can not sleep and need the allocation to succeed. A lower + * watermark is applied to allow access to "atomic reserves" + * + * %GFP_KERNEL is typical for kernel-internal allocations. The caller requires + * %ZONE_NORMAL or a lower zone for direct access but can direct reclaim. + * + * %GFP_KERNEL_ACCOUNT is the same as GFP_KERNEL, except the allocation is + * accounted to kmemcg. + * + * %GFP_NOWAIT is for kernel allocations that should not stall for direct + * reclaim, start physical IO or use any filesystem callback. + * + * %GFP_NOIO will use direct reclaim to discard clean pages or slab pages + * that do not require the starting of any physical IO. + * Please try to avoid using this flag directly and instead use + * memalloc_noio_{save,restore} to mark the whole scope which cannot + * perform any IO with a short explanation why. All allocation requests + * will inherit GFP_NOIO implicitly. + * + * %GFP_NOFS will use direct reclaim but will not use any filesystem interfaces. + * Please try to avoid using this flag directly and instead use + * memalloc_nofs_{save,restore} to mark the whole scope which cannot/shouldn't + * recurse into the FS layer with a short explanation why. All allocation + * requests will inherit GFP_NOFS implicitly. + * + * %GFP_USER is for userspace allocations that also need to be directly + * accessibly by the kernel or hardware. It is typically used by hardware + * for buffers that are mapped to userspace (e.g. graphics) that hardware + * still must DMA to. cpuset limits are enforced for these allocations. + * + * %GFP_DMA exists for historical reasons and should be avoided where possible. + * The flags indicates that the caller requires that the lowest zone be + * used (%ZONE_DMA or 16M on x86-64). Ideally, this would be removed but + * it would require careful auditing as some users really require it and + * others use the flag to avoid lowmem reserves in %ZONE_DMA and treat the + * lowest zone as a type of emergency reserve. + * + * %GFP_DMA32 is similar to %GFP_DMA except that the caller requires a 32-bit + * address. + * + * %GFP_HIGHUSER is for userspace allocations that may be mapped to userspace, + * do not need to be directly accessible by the kernel but that cannot + * move once in use. An example may be a hardware allocation that maps + * data directly into userspace but has no addressing limitations. + * + * %GFP_HIGHUSER_MOVABLE is for userspace allocations that the kernel does not + * need direct access to but can use kmap() when access is required. They + * are expected to be movable via page reclaim or page migration. Typically, + * pages on the LRU would also be allocated with %GFP_HIGHUSER_MOVABLE. + * + * %GFP_TRANSHUGE and %GFP_TRANSHUGE_LIGHT are used for THP allocations. They + * are compound allocations that will generally fail quickly if memory is not + * available and will not wake kswapd/kcompactd on failure. The _LIGHT + * version does not attempt reclaim/compaction at all and is by default used + * in page fault path, while the non-light is used by khugepaged. */ #define GFP_ATOMIC (__GFP_HIGH|__GFP_ATOMIC|__GFP_KSWAPD_RECLAIM) #define GFP_KERNEL (__GFP_RECLAIM | __GFP_IO | __GFP_FS) From patchwork Wed Jul 25 11:26:10 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 10543865 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 9222617FD for ; Wed, 25 Jul 2018 11:26:46 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 812C929960 for ; Wed, 25 Jul 2018 11:26:46 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 753F329A55; Wed, 25 Jul 2018 11:26:46 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=2.0 tests=BAYES_00,MAILING_LIST_MULTI, RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.1 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 192A129960 for ; Wed, 25 Jul 2018 11:26:46 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 4A7316B0293; Wed, 25 Jul 2018 07:26:36 -0400 (EDT) Delivered-To: linux-mm-outgoing@kvack.org Received: by kanga.kvack.org (Postfix, from userid 40) id 430EB6B0294; Wed, 25 Jul 2018 07:26:36 -0400 (EDT) X-Original-To: int-list-linux-mm@kvack.org X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 0FC9D6B0295; Wed, 25 Jul 2018 07:26:36 -0400 (EDT) X-Original-To: linux-mm@kvack.org X-Delivered-To: linux-mm@kvack.org Received: from mail-oi0-f72.google.com (mail-oi0-f72.google.com [209.85.218.72]) by kanga.kvack.org (Postfix) with ESMTP id D8B046B0291 for ; Wed, 25 Jul 2018 07:26:35 -0400 (EDT) Received: by mail-oi0-f72.google.com with SMTP id m197-v6so7140764oig.18 for ; Wed, 25 Jul 2018 04:26:35 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-original-authentication-results:x-gm-message-state:from:to:cc :subject:date:in-reply-to:references:message-id; bh=ByNu2pRirRqKgFzNHUK6phfE5DOCImJ2REERDFg+THQ=; b=oGQsBo821QE+bz2HVSCvCDJ8Ox7c4BRHpQl8Kb5px5xzVfTqiWNomuwfiwe2uyis2i MEzGNrnIEwheOCAXuBkqBlBT4mXycdgaNt7pE+uKWys3OaQ1tosr5e8MApklDgZWI09Z rOIPR1C2yVKO8oLEfT4H1g9y+rV7ywbPa53nw7c3e2VjawgQIFrjcrg2B2M1OkN6RCue v9Wj35MsssnfoFz1RT/nwMbTM/oWXWxQkrvgodOea9+c58PrnXlrdPiHwUh0qUffWi3J /FjEfBtEBNL3KCSaHBJJ73uLYAoQq9cpaSp4WaE4NcmOhFbsMFqbWmWrxHQETxx74oho 8C+w== X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com X-Gm-Message-State: AOUpUlFsxFs+pJSSTJPTvKu8zwvH47EzCUSY1CMSm/CZqwTYm/mWVPdu YD7aNswVhMd4War2uXw1PGehYQ5sZinBbGPKVql6kjjdrjaGP0tk1SarKO++X1JUF+oUB8hT3J9 QzLdx++lQX7U7Pu9yH9PXOw6lfjY0tVyj2U5qLpYJf2YZyWopUt7BCG30lnmT5sY= X-Received: by 2002:aca:af11:: with SMTP id y17-v6mr2723397oie.274.1532517995664; Wed, 25 Jul 2018 04:26:35 -0700 (PDT) X-Google-Smtp-Source: AAOMgpeyhOTPUQwOEIQ5/PZDAajVbcxDIg7RQXQXkHEQWH1j6wHDxQ1qn4Dd8jHkDI/i0ZLWLWGq X-Received: by 2002:aca:af11:: with SMTP id y17-v6mr2723366oie.274.1532517994999; Wed, 25 Jul 2018 04:26:34 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1532517994; cv=none; d=google.com; s=arc-20160816; b=iLOcbnjuchs0gMHhT0jYPSE8A8yJomV08SYgMV6JPte2HNG8yX1l3nzXqAT6780TDN YR8hy+L802M8+PKAQjHhL2QXMk/QFjXcDkpDmJOdvGuVkmC856PI28KTQoDhcTSLRuAX 2i6xj+xFqCAg6ukOjJaHu+SpbnNIHzCusAN+zrliyFQaTY9hGvJGmy19yXLkqNxAUHta xkY2CkzU93IxfVkUKSESxYPaXa/0rH+hiDil1Ib+KVSczCsbQvnW0i4r3vhBvzMxF5bx LvcnCchdgSK6QZRhfKGNoScQ/ifRT1T9tagLvr4jlNLgV1HmoMmtoQqNVtdpt20FYy5r F/xQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:references:in-reply-to:date:subject:cc:to:from :arc-authentication-results; bh=ByNu2pRirRqKgFzNHUK6phfE5DOCImJ2REERDFg+THQ=; b=m+uCzsSiH9EqEp/Mym/4pjUpjenNkPPY6PYWwvjJ8MqnJezBWfuclqH2GZ9o892MhB B3v+UpMQ7gDfuR+2SDITYYozEhw8DZm2wzblE6yPmMdsOADAbKlfOy1wPgxTfJMTSDT9 7RmLbwaNwvRUFdEXo83R98QO66Sa6xgKMnmqEf/eUZCManbz17p4UmNUaRIRfDWUa327 LRLqaqGz5cNC7/qQehwk81fOD5MvGB5qx/OcNLELsSBtHy47ZtrdSHwg9FWgte38TAIC SMxSbuw40sEie67CUw0BFFZ0GzQVm4FbtsveALw+kLvt464n374kcUNo2yuCTH67hxMw f8sg== ARC-Authentication-Results: i=1; mx.google.com; spf=neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com. [148.163.156.1]) by mx.google.com with ESMTPS id s7-v6si9307983oig.299.2018.07.25.04.26.34 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 25 Jul 2018 04:26:34 -0700 (PDT) Received-SPF: neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) client-ip=148.163.156.1; Authentication-Results: mx.google.com; spf=neutral (google.com: 148.163.156.1 is neither permitted nor denied by best guess record for domain of rppt@linux.vnet.ibm.com) smtp.mailfrom=rppt@linux.vnet.ibm.com; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com 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 w6PBPnVi037683 for ; Wed, 25 Jul 2018 07:26:34 -0400 Received: from e06smtp05.uk.ibm.com (e06smtp05.uk.ibm.com [195.75.94.101]) by mx0a-001b2d01.pphosted.com with ESMTP id 2keqph9s3x-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Wed, 25 Jul 2018 07:26:33 -0400 Received: from localhost by e06smtp05.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Wed, 25 Jul 2018 12:26:31 +0100 Received: from b06cxnps4074.portsmouth.uk.ibm.com (9.149.109.196) by e06smtp05.uk.ibm.com (192.168.101.135) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Wed, 25 Jul 2018 12:26:29 +0100 Received: from d06av25.portsmouth.uk.ibm.com (d06av25.portsmouth.uk.ibm.com [9.149.105.61]) by b06cxnps4074.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w6PBQS1w36831476 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Wed, 25 Jul 2018 11:26:28 GMT Received: from d06av25.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id D2ED011C04A; Wed, 25 Jul 2018 14:26:42 +0100 (BST) Received: from d06av25.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 5C1F111C050; Wed, 25 Jul 2018 14:26:41 +0100 (BST) Received: from rapoport-lnx (unknown [9.148.8.110]) by d06av25.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Wed, 25 Jul 2018 14:26:41 +0100 (BST) Received: by rapoport-lnx (sSMTP sendmail emulation); Wed, 25 Jul 2018 14:26:26 +0300 From: Mike Rapoport To: Jonathan Corbet , Andrew Morton Cc: linux-doc@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Mike Rapoport Subject: [PATCH 7/7] docs/core-api: mm-api: add section about GFP flags Date: Wed, 25 Jul 2018 14:26:10 +0300 X-Mailer: git-send-email 2.7.4 In-Reply-To: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> References: <1532517970-16409-1-git-send-email-rppt@linux.vnet.ibm.com> X-TM-AS-GCONF: 00 x-cbid: 18072511-0020-0000-0000-000002AAF0BB X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18072511-0021-0000-0000-000020F789FF Message-Id: <1532517970-16409-8-git-send-email-rppt@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-07-25_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=958 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1806210000 definitions=main-1807250124 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: X-Virus-Scanned: ClamAV using ClamSMTP Signed-off-by: Mike Rapoport --- Documentation/core-api/mm-api.rst | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Documentation/core-api/mm-api.rst b/Documentation/core-api/mm-api.rst index 65a8ef09..1e8c011 100644 --- a/Documentation/core-api/mm-api.rst +++ b/Documentation/core-api/mm-api.rst @@ -11,6 +11,28 @@ User Space Memory Access .. kernel-doc:: arch/x86/lib/usercopy_32.c :export: +Memory Allocation Controls +========================== + +Linux provides a variety of APIs for memory allocation from direct +calls to page allocator through slab caches and vmalloc to allocators +of compressed memory. Although these allocators have different +semantics and are used in different circumstances, they all share the +GFP (get free page) flags that control behavior of each allocation +request. + +.. kernel-doc:: include/linux/gfp.h + :doc: Page mobility and placement hints + +.. kernel-doc:: include/linux/gfp.h + :doc: Watermark modifiers + +.. kernel-doc:: include/linux/gfp.h + :doc: Reclaim modifiers + +.. kernel-doc:: include/linux/gfp.h + :doc: Common combinations + The Slab Cache ==============