From nobody Tue Nov 26 08:48:41 2024 Received: from smtpbgau2.qq.com (smtpbgau2.qq.com [54.206.34.216]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 51BC71CC15E; Sat, 19 Oct 2024 07:17:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=54.206.34.216 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729322261; cv=none; b=ov3Q/QA4e8UVTAGnzK+liOkh5HnW5f++O76jnxAvv5/wltfHJ/k6+8ePN9HOMJVnFxH7bKRAo5tfZ2b8zFH5l0dyrG6mYYHBoe7YZ+eeHKSF0tAqwWyTTwfX5HbqyHn2oa/2cnXcF5qktPzHCUVGLZOciSj5eygBi7y2r3mETns= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729322261; c=relaxed/simple; bh=pjx16WCMw/sQrrsCxHRbpEFWf5y2yLaA1KolqpC+Wjc=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=FrNcKTKvELEV3uM1FX6x0gKWKo2T4gi/R4E8w8l4Fi4xdqM/v08jZZNDCHlSwNdKIcI7g2TP4jEuVbn3SdjF426cBIG5yM/W9B2Ah5PWKQ5jTm7wYTtw9I668Qoe15nqZCyLZHcvTCEqouKCJMFc2D40dCQ24xGvKjH4kQlKiPE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=chenxiaosong.com; spf=none smtp.mailfrom=chenxiaosong.com; arc=none smtp.client-ip=54.206.34.216 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=chenxiaosong.com Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=chenxiaosong.com X-QQ-mid: bizesmtpsz10t1729322168tw3qsh X-QQ-Originating-IP: Eh4zX456hZMGcfuxgcpGlK9/0p8Mh8Jxw52RkerpuR4= Received: from sonvhi-TianYi510S-07IMB.. ( [116.128.244.171]) by bizesmtp.qq.com (ESMTP) with id ; Sat, 19 Oct 2024 15:15:48 +0800 (CST) X-QQ-SSF: 0000000000000000000000000000000 X-QQ-GoodBg: 0 X-BIZMAIL-ID: 3942789612294147170 From: chenxiaosong@chenxiaosong.com To: corbet@lwn.net, dhowells@redhat.com, jlayton@kernel.org, brauner@kernel.org, rostedt@goodmis.org, mhiramat@kernel.org, mathieu.desnoyers@efficios.com, trondmy@kernel.org, anna@kernel.org, chuck.lever@oracle.com, neilb@suse.de, okorniev@redhat.com, Dai.Ngo@oracle.com, tom@talpey.com Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, netfs@lists.linux.dev, linux-fsdevel@vger.kernel.org, linux-trace-kernel@vger.kernel.org, linux-nfs@vger.kernel.org, ChenXiaoSong Subject: [PATCH 1/3] Documentation: nfs: idmapper: keep consistent with nfsidmap manual Date: Sat, 19 Oct 2024 15:15:37 +0800 Message-Id: <20241019071539.125934-2-chenxiaosong@chenxiaosong.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20241019071539.125934-1-chenxiaosong@chenxiaosong.com> References: <20241019071539.125934-1-chenxiaosong@chenxiaosong.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-QQ-SENDSIZE: 520 Feedback-ID: bizesmtpsz:chenxiaosong.com:qybglogicsvrsz:qybglogicsvrsz4a-0 X-QQ-XMAILINFO: M3ziZXKDk+iOsjm9mH5d8oiRCkBzKEtIIucugsMBUMQ55Qpcs0Vu5/nF jh380GYPkKGRjKRY+9KiCfo+R6eo86AcouDlMcp9K5VgCvz4eCjNENksuVdC2CRie94Mn9G 5WTszOitSep0BTjrWXb/48bVXlUCXCyycTG1JiXcyU6kYK94m2qVPnaP6UXMi680/2DGMKd 2TExRoJGs1KCkFTO9Q5oXx5x65VVI2cXCi5AUvpGSyVjGTZTpgbMEdakLlW/ypicWcDN9qG edBBTVjdGN+XDVlTTFZAIMpmB5fk9GsxHy+LF7XWohk4TbykhZ43cyNWaAFJGMNLx1lSTZS ULb6wynlDG09NO2fNBR5GXOJr+Lgq68WTC7SOKguspcb5ZkBvS7ocxY/pQBC1WRUfq9IQBf V3Nm+SMY9jJlqWasK/cCMRhHpvwFV3yULijxq7y0Jqns5bC/E+zXsfYQ15+fZfuTVZG7V8F uIOhEEGi0BdtBF7RNwEXIJ7K5DF2NCaR0LKp/gXIgtuTTWy2SCniOeMZV5CncWP3KByQXRT n9y4vLBs70+FPYfkXYvHfFY8ubXPj8t/zxAlu2d2rwIEx/ca+rm5FriKJn0/38xlgvtYX87 nygNGL6q+AQrVJbvw9+FGMvTgxQUmlhbO6Or9PC0cAC+F2WDr8V66TZ/VcaB6KV/kcvixjm yneJ5V2k56faGXsfT0+StU54YmGk4wQs6TDcdNHRKDS9vL0h3NRrbedqjQZumtExacx2NLP a/zgEEdOyx2DZVMdJjtfNlFa90uVu8KufV4cDx653xwFyraHlJO0CV/rjAv9G4QaHliuSZK 85BH3vEfj9qgcCJ9P2/NgoxJSvKG4Z2BSbjyJM161cct7qJhUbw8ayxrjjWCDERjIdcLI4a 4tabA75lY9EW3VLuD6/nIcSfumGnzU/Lem+6miMkkkt6O0Gje0ZDubKmZ+qFHLKoWBeqNx4 zaXmtwCwACQK6LE3+tGYOVswiHtA2V1K5uPc= X-QQ-XMRINFO: OD9hHCdaPRBwq3WW+NvGbIU= X-QQ-RECHKSPAM: 0 Content-Type: text/plain; charset="utf-8" From: ChenXiaoSong The usage of `nfsidmap` has been updated(e.g., use `-t 600` set the expiration timer), keep it consistent with nfsidmap manual (Link[1]). Link[1]: https://git.kernel.org/pub/scm/linux/kernel/git/rw/nfs-utils.git/t= ree/utils/nfsidmap/nfsidmap.man Signed-off-by: ChenXiaoSong --- Documentation/admin-guide/nfs/nfs-idmapper.rst | 59 ++++++++++++++++++++++= ++++++++++--------------------------- 1 file changed, 32 insertions(+), 27 deletions(-) diff --git a/Documentation/admin-guide/nfs/nfs-idmapper.rst b/Documentation= /admin-guide/nfs/nfs-idmapper.rst index 58b8e63412d5..0b72fd3a38af 100644 --- a/Documentation/admin-guide/nfs/nfs-idmapper.rst +++ b/Documentation/admin-guide/nfs/nfs-idmapper.rst @@ -24,55 +24,60 @@ Configuring =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 The file /etc/request-key.conf will need to be modified so /sbin/request-k= ey can -direct the upcall. The following line should be added: +properly direct the upcall. The following line should be added before a ca= ll to +keyctl negate: =20 -``#OP TYPE DESCRIPTION CALLOUT INFO PROGRAM ARG1 ARG2 ARG3 ...`` -``#=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D`` -``create id_resolver * * /usr/sbin/nfs.idmap %k %d 600`` +.. code-block:: none =20 + #OP TYPE DESCRIPTION CALLOUT INFO PROGRAM ARG1 ARG2 ARG3 ... + #=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + create id_resolver * * /usr/sbin/nfsidmap -t 600 %k %d =20 -This will direct all id_resolver requests to the program /usr/sbin/nfs.idm= ap. -The last parameter, 600, defines how many seconds into the future the key = will -expire. This parameter is optional for /usr/sbin/nfs.idmap. When the tim= eout -is not specified, nfs.idmap will default to 600 seconds. +This will direct all id_resolver requests to the program /usr/sbin/nfsidma= p. +The -t 600 defines how many seconds into the future the key will expire. +This is an optional parameter for /usr/sbin/nfsidmap and will default t= o 600 +seconds when not specified. =20 -id mapper uses for key descriptions:: +The idmapper system uses four key descriptions: =20 - uid: Find the UID for the given user - gid: Find the GID for the given group - user: Find the user name for the given UID - group: Find the group name for the given GID +.. code-block:: none =20 -You can handle any of these individually, rather than using the generic up= call -program. If you would like to use your own program for a uid lookup then = you -would edit your request-key.conf so it look similar to this: + uid: Find the UID for the given user + gid: Find the GID for the given group + user: Find the user name for the given UID + group: Find the group name for the given GID =20 -``#OP TYPE DESCRIPTION CALLOUT INFO PROGRAM ARG1 ARG2 ARG3 ...`` -``#=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D`` -``create id_resolver uid:* * /some/other/program %k %d 600`` -``create id_resolver * * /usr/sbin/nfs.idmap %k %d 600`` +You can choose to handle any of these individually, rather than using the +generic upcall program. If you would like to use your own program for a u= id +lookup then you would edit your request-key.conf so it looks similar to th= is: =20 +.. code-block:: none + + #OP TYPE DESCRIPTION CALLOUT INFO PROGRAM ARG1 ARG2 ARG3 ... + #=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D + create id_resolver uid:* * /some/other/program %k %d + create id_resolver * * /usr/sbin/nfsidmap %k %d =20 Notice that the new line was added above the line for the generic program. -request-key will find the first matching line and corresponding program. = In -this case, /some/other/program will handle all uid lookups and -/usr/sbin/nfs.idmap will handle gid, user, and group lookups. +request-key will find the first matching line and run the corresponding pr= ogram. +In this case, /some/other/program will handle all uid lookups, +and /usr/sbin/nfsidmap will handle gid, user, and group lookups. =20 See Documentation/security/keys/request-key.rst for more information about the request-key function. =20 =20 -nfs.idmap +nfsidmap =3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -nfs.idmap is designed to be called by request-key, and should not be run "= by +nfsidmap is designed to be called by request-key, and should not be run "by hand". This program takes two arguments, a serialized key and a key description. The serialized key is first converted into a key_serial_t, a= nd then passed as an argument to keyctl_instantiate (both are part of keyutil= s.h). =20 -The actual lookups are performed by functions found in nfsidmap.h. nfs.id= map +The actual lookups are performed by functions found in nfsidmap.h. nfsidm= ap determines the correct function to call by looking at the first part of the description string. For example, a uid lookup description will appear as "uid:user@domain". =20 -nfs.idmap will return 0 if the key was instantiated, and non-zero otherwis= e. +nfsidmap will return 0 if the key was instantiated, and non-zero otherwise. --=20 2.34.1 From nobody Tue Nov 26 08:48:41 2024 Received: from smtpbgau1.qq.com (smtpbgau1.qq.com [54.206.16.166]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 128A31D54D3; Sat, 19 Oct 2024 07:17:37 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=54.206.16.166 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729322262; cv=none; b=R+Lm1VVxiZKZRX4T2HNWEEhDo6UpRXR0YZv65fUbvbt2j6fBSt31Y5Gmo2SyNfxzXpZNrG7i4ezhuAwg+shUP00CuqKFmWokPqthWwiO16J81tzuTkBd7X40OzEJzkq6mOl29XAnhtBlkxDf/ofvCeQeg0O3cVW7UhmXuNbg2as= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729322262; c=relaxed/simple; bh=Z5Q8B4bck1mews/VXCUSRyo4bdvk5UfW/acuCx1L4IE=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=I/ouwQV07OFGdEcIWVM+wADnqgMaQ4C3+r2Bm8WYMG5DLacd+9rjritnI2YChW3+gfFcm3UV90qm0Wx38Jj3Kp144OE3+4HvD5v7TfOjGYTpcxRf5YxgwRBSeKy655fCa1/53u/cpYLrJqagZRITCR9vFCxPO6DY0qN25q8g2sw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=chenxiaosong.com; spf=none smtp.mailfrom=chenxiaosong.com; arc=none smtp.client-ip=54.206.16.166 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=chenxiaosong.com Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=chenxiaosong.com X-QQ-mid: bizesmtpsz10t1729322177tbh1ui X-QQ-Originating-IP: gaImgFu32Uh/c26jfCC4kBP+8UkdjHLBLPOMsCWpONg= Received: from sonvhi-TianYi510S-07IMB.. ( [116.128.244.171]) by bizesmtp.qq.com (ESMTP) with id ; Sat, 19 Oct 2024 15:16:10 +0800 (CST) X-QQ-SSF: 0000000000000000000000000000000 X-QQ-GoodBg: 0 X-BIZMAIL-ID: 16716936677098621295 From: chenxiaosong@chenxiaosong.com To: corbet@lwn.net, dhowells@redhat.com, jlayton@kernel.org, brauner@kernel.org, rostedt@goodmis.org, mhiramat@kernel.org, mathieu.desnoyers@efficios.com, trondmy@kernel.org, anna@kernel.org, chuck.lever@oracle.com, neilb@suse.de, okorniev@redhat.com, Dai.Ngo@oracle.com, tom@talpey.com Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, netfs@lists.linux.dev, linux-fsdevel@vger.kernel.org, linux-trace-kernel@vger.kernel.org, linux-nfs@vger.kernel.org, ChenXiaoSong Subject: [PATCH 2/3] docs: filesystems: fix compile error in netfs_library.rst Date: Sat, 19 Oct 2024 15:15:38 +0800 Message-Id: <20241019071539.125934-3-chenxiaosong@chenxiaosong.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20241019071539.125934-1-chenxiaosong@chenxiaosong.com> References: <20241019071539.125934-1-chenxiaosong@chenxiaosong.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-QQ-SENDSIZE: 520 Feedback-ID: bizesmtpsz:chenxiaosong.com:qybglogicsvrsz:qybglogicsvrsz4a-0 X-QQ-XMAILINFO: MzQ3kK1NFVdtbyNQqC/NW/vd0Py0Qlt5KVRuvjZ+R0C/NzlRqD4ywbwg 0HR6I0ZW9Zxei/lI1TPAVmuQHMDUVRX5pvLuLJKqfksW5v/rf+XwaMMmM6hfis93qu125QC qXdOgfndt842VGVteIFIJ8vzStF5scUT/42oAf2I7RxBfX4m5zaiYVeK7jtpJ4t4PsZzoD4 dcPQD0wWxqWpQ7YkFv/tMZYAkRQ1+mKDYP0jWcCErcGLZQTJIsFktuv6ryizs7o1Tvd5QXt o1NST0+0HbBJf3Fw0lkiSi2hKt2B0eDb/Wlp12wOmJbjwN52Y/HqaaoaCtnFxM1dCuGwZVo tTlOxOlqRy/mWjRA4CjTjhhYSCC3KOwKsnd2Z8cxDAkjcLtbaEbqnP53CwtOCLPgMl1VkDD ev402suzXqht/4a4YEmOHrLMcH9An4FcrI3u4h4ms5rNypJ9kTdZSzYcgWZRldJClhA/LGg Om7OiEbB+WI2Oz+TsaBiWrnuJ/Y0HP6K0OLjBqinv3Dl0tWapQUGIMoDxyGW+9D2515VRP2 4ZZCLZUxW/4TDxYy3236JgRmSs+bMqRv9N+A4LFWpGnebdrUNjD1ALw/IvP9ysobM/05C0s lsNSHNlnAy2kcyb1cK+QSWwdrnVCiSV0cB6Ei/28YnMghE/+g/6lsgkL7wS2pDG+BcWd7Tr ylBJx9gKPt8AxdiHXuiqIXTJIaek4XoRYvenpDMBGlyR4f8M3YeH9ftL/jjXOBmSaw8PeNP u4EzQufSAm1HcmJ/djnvwkkpiXDAxHIgDZ0KoEI2jr+SDvVFHatwt5cJtZnKFdCmpBlRmQT g1k5pskZ04tUmHw18UyxPN8aLedNdxxrvRlvixptRbs5+GV2mNC1GKp0F6r/PpQ69ZdOIYO ChwX4RqfoGt9EX/UhfeM5PGFmuINFtkZhUoJosqXQAcGS+SpA7KO+YITtDPcC3zh X-QQ-XMRINFO: Nq+8W0+stu50PRdwbJxPCL0= X-QQ-RECHKSPAM: 0 Content-Type: text/plain; charset="utf-8" From: ChenXiaoSong `make htmldocs` reports the following error: Error: Cannot open file fs/netfs/io.c Fix it by removing the unused kernel-doc reference. Fixes: 86b374d061ee ("netfs: Remove fs/netfs/io.c") Signed-off-by: ChenXiaoSong --- Documentation/filesystems/netfs_library.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/Documentation/filesystems/netfs_library.rst b/Documentation/fi= lesystems/netfs_library.rst index f0d2cb257bb8..73f0bfd7e903 100644 --- a/Documentation/filesystems/netfs_library.rst +++ b/Documentation/filesystems/netfs_library.rst @@ -592,4 +592,3 @@ API Function Reference =20 .. kernel-doc:: include/linux/netfs.h .. kernel-doc:: fs/netfs/buffered_read.c -.. kernel-doc:: fs/netfs/io.c --=20 2.34.1 From nobody Tue Nov 26 08:48:41 2024 Received: from smtpbgau2.qq.com (smtpbgau2.qq.com [54.206.34.216]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 0B2181D63DC; Sat, 19 Oct 2024 07:17:38 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=54.206.34.216 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729322263; cv=none; b=nmPKgkN/3YLIwgrQ0NxJpuBoNSKrlRzzD1+EISubRqBYOvbePiRe3zwvKxZZRm8im11cqi241kQGzBX0er6GU2nOepuNIASu+uBpDA0v7uGMChSHpKGC/Blf5fA9rOc4/gULYkMPeTBMjNT0tzMgbnr2nALhO2HOIx6qvtZX3Xk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729322263; c=relaxed/simple; bh=x77Leu//zcELEFm/jviPtto7y+OnBK4QnxtY2HQIYU0=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=BfcLHnSeL4qcRDrylHSyEWZ0h+DjTmmM4sOalZ7VcjE5TdNzTeimjJq4QyTR7NCUn7h1ekI21ZoIkvy0RcooR13v5kJ4h8f2e1rNNRdAOybWBYSvGYKYt9JtnXp2O1WId5XF1lYntSSDVya9EVJA7SKiAcZdXW9/PL8Cz/m9irU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=chenxiaosong.com; spf=none smtp.mailfrom=chenxiaosong.com; arc=none smtp.client-ip=54.206.34.216 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=chenxiaosong.com Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=chenxiaosong.com X-QQ-mid: bizesmtpsz10t1729322183tmx9pd X-QQ-Originating-IP: 2wrtZZMSoIeiW4tN+ltGHjUUxkkLFPmvDWr8Q0tu8H4= Received: from sonvhi-TianYi510S-07IMB.. ( [116.128.244.171]) by bizesmtp.qq.com (ESMTP) with id ; Sat, 19 Oct 2024 15:16:18 +0800 (CST) X-QQ-SSF: 0000000000000000000000000000000 X-QQ-GoodBg: 0 X-BIZMAIL-ID: 15998112844559155357 From: chenxiaosong@chenxiaosong.com To: corbet@lwn.net, dhowells@redhat.com, jlayton@kernel.org, brauner@kernel.org, rostedt@goodmis.org, mhiramat@kernel.org, mathieu.desnoyers@efficios.com, trondmy@kernel.org, anna@kernel.org, chuck.lever@oracle.com, neilb@suse.de, okorniev@redhat.com, Dai.Ngo@oracle.com, tom@talpey.com Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, netfs@lists.linux.dev, linux-fsdevel@vger.kernel.org, linux-trace-kernel@vger.kernel.org, linux-nfs@vger.kernel.org, ChenXiaoSong Subject: [PATCH 3/3] tracing/Documentation: fix compile warning in debugging.rst Date: Sat, 19 Oct 2024 15:15:39 +0800 Message-Id: <20241019071539.125934-4-chenxiaosong@chenxiaosong.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20241019071539.125934-1-chenxiaosong@chenxiaosong.com> References: <20241019071539.125934-1-chenxiaosong@chenxiaosong.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-QQ-SENDSIZE: 520 Feedback-ID: bizesmtpsz:chenxiaosong.com:qybglogicsvrsz:qybglogicsvrsz4a-0 X-QQ-XMAILINFO: ML8hOghqQD+0/XlLMPZYyEW0x1ZBxbHmjrEen821kLJ3+EqgbZQLh6Cy UkRLh36+wxHT7KAAgoyj7eJ8swsbAQYzMcdcqPAKg5uMJiOUPAxCS+Jdu9NW1N8Y7Cn2y5y M/kHE3rY/sraBmR5uYHJ/GvL4mJEgOOHB3euVodIhelLhReAy9iYv94GVt0IOjpmgLWVcVx w95IZuuX4muGZbdQOXhHr458oRZ6nbSjxHAOsqHLREkmoiSI6Sb5FqCn6RMIDV/gIRbvm02 CroCN8cJXutCHZIFvNLXpaV+y/zFRdk1jKFVkuRKXDnNqq1XXajNxExcVsgbPnLC52j7D/D q8vh201husHxCpjjdY/nuFQrrGuF7jJLFhEt6G490NI2Mhe1SzeCrSDFz29ti7+V7H8keD9 86MTTsjjm16rY0ZnIHP+qj6QOxQhOHMgadsQ+ICh/AUOA3oiwocHWY1JZHGHe0kM7Xs0yMo vZrAw+ERTmuwM4DwvZLNTBI1an50mQn+eRP3T0TCUQrJdIwsgRDF89jgJlObYHcRB3kW0FV OVssBpf1nx/tbhNPx8gsi1ZddwNJe/r1QOazlNTZ5D+gfm1frvBlCQ1APhSW8Xiw4R2ep0y RfiP0gtSUDtVwRf1T1o4QpLMKMnqyKQGgerzuK6bixjiyev9xucpWWZ5wMPLudypNJWm6q+ slQY8ciSVublXTprzNgUJ+qUSr6uUMeZNoTL7VCUVPtbBYOnYi+ttpWcU7DL6lxqoRQfXcd GtW2bPrbDSNfCdODYNbWDgI+HZNrwUZaeUzeH5b0nH3RI3rXpg5cAhhU9FZwxIURRXFFrV+ ggV3+YpWJ+4SQxJKa5sso81BakSjpQzb84vjEKxZZCFInb1slSrfaCxDJ6Pwkv8pfHyTHZc x5xLKYDdeOFyq6O3AJ2lrd0Yox+JtGOpjjmY7Ep7QIJtnF1YVszQM/jkWaj4V5oJBcqtpCR V2y9gS7RQn6uUQDkezFSnnQN6R7x+qaU7Lp4= X-QQ-XMRINFO: Mp0Kj//9VHAxr69bL5MkOOs= X-QQ-RECHKSPAM: 0 Content-Type: text/plain; charset="utf-8" From: ChenXiaoSong `make htmldocs` reports the following warning: Documentation/trace/debugging.rst: WARNING: document isn't included \ in any toctree Fix it by adding debugging.rst to toctree. Signed-off-by: ChenXiaoSong --- Documentation/trace/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/trace/index.rst b/Documentation/trace/index.rst index 0b300901fd75..2827292f8f34 100644 --- a/Documentation/trace/index.rst +++ b/Documentation/trace/index.rst @@ -36,3 +36,4 @@ Linux Tracing Technologies user_events rv/index hisi-ptt + debugging --=20 2.34.1