From patchwork Sun Dec 18 16:41:29 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chuck Lever X-Patchwork-Id: 13076070 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 62808C4332F for ; Sun, 18 Dec 2022 17:37:35 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230272AbiLRRhd (ORCPT ); Sun, 18 Dec 2022 12:37:33 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55290 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231289AbiLRRhL (ORCPT ); Sun, 18 Dec 2022 12:37:11 -0500 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AD3927E2A8 for ; Sun, 18 Dec 2022 08:41:31 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id DE6D2604AD for ; Sun, 18 Dec 2022 16:41:30 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 106A2C433D2; Sun, 18 Dec 2022 16:41:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1671381690; bh=vt1rLS3aeIIQ4yiZza9OlSwNYWZVdWW0daNNoQRlcDA=; h=Subject:From:To:Cc:Date:From; b=YsMwHTxAxEbsSVG2vLcn/9GLrBcZm1jGTzx62kUQats7yHoXowKoaZxrMOmX5Ovad I5nDnNs4wH5q2NelFAt7TGQQwbcTJhzgciFMHw31N5Dj2X3omZEzZp2EJQ/gMXWnnW X6oItUZXzi8LymhskpfMzSd0sfzW8pIe1WWbNQGwteENRwKq+QTtoeEkpkNiIsOAaT ybZ87Ejicmi1yIZfI49Gr0nBYR3q5tV3BrvI2kCNQ3eIIIHy1KTfl4coV5fNS9Q/tO WcXCA9HOaLO1PGClmX/qqrnEENeibAt90SvYxqMjrcqVAanyXRgDW8flr/1VxRKtTx zfj9y53v/v2kQ== Subject: [PATCH 1/6] nfsd(7): Use "backslash" consistently From: cel@kernel.org To: SteveD@redhat.com Cc: linux-nfs@vger.kernel.org, debian@helgefjell.de Date: Sun, 18 Dec 2022 11:41:29 -0500 Message-ID: <167138168903.1584402.12231405451604036910.stgit@morisot.1015granger.net> User-Agent: StGit/1.5 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-nfs@vger.kernel.org From: Chuck Lever Man page: nfsd.7 Issue: back-slash vs. backslash, should be consistent "Each line of the file contains a path name, a client name, and a number of " "options in parentheses. Any space, tab, newline or back-slash character in " "the path name or client name will be replaced by a backslash followed by the " "octal ASCII code for that character." Reported-by: Helge Kreutzmann Signed-off-by: Chuck Lever --- utils/exportfs/nfsd.man | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/utils/exportfs/nfsd.man b/utils/exportfs/nfsd.man index 514153f024fa..2abb8933fb11 100644 --- a/utils/exportfs/nfsd.man +++ b/utils/exportfs/nfsd.man @@ -50,7 +50,7 @@ being treated identically. Each line of the file contains a path name, a client name, and a number of options in parentheses. Any space, tab, newline or -back-slash character in the path name or client name will be replaced +backslash character in the path name or client name will be replaced by a backslash followed by the octal ASCII code for that character. .TP From patchwork Sun Dec 18 16:41:35 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Chuck Lever X-Patchwork-Id: 13076071 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id A271AC4332F for ; Sun, 18 Dec 2022 17:37:38 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231562AbiLRRhg (ORCPT ); Sun, 18 Dec 2022 12:37:36 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55368 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231322AbiLRRhM (ORCPT ); Sun, 18 Dec 2022 12:37:12 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9FFF4E0B9 for ; Sun, 18 Dec 2022 08:41:39 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id EC7D0B80BAA for ; Sun, 18 Dec 2022 16:41:37 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 63C98C433D2; Sun, 18 Dec 2022 16:41:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1671381696; bh=VDWnbkHG6WLXl36i9gSzHpZbbHkjRqGCZi+DjHgIoaQ=; h=Subject:From:To:Cc:Date:In-Reply-To:References:From; b=rszIVcJVmcadN9sGQgj1MiNnTSH1mua+RAU9TrRkN8ftD8uZ1amk1oFCJnLTXw9ge soTLVsM8cq0ZdedOWxsvLvL3eArgtpKtybZL7efJzqkrEHRG8f7kc3AWY+vkK2qR+H QKGNDQ9KART+ui8ds/KbrMs2k0S4DHgCWHp5ODqijVq1P3zqmcLQylkTkeDjbOVKXv iJlbiQVZHudg075I2bOyjuk0sELT3k2LOirL1l5/sqrw70pSY3jXIakbYqGRnxASE7 Rt9gGSeiizNkpzJ8Q7h7BWyU8LOiTpTmGJQxBa8q7cxtv2VQwEXMR+W7QJ6pnp1o8Q 8k9QOSuM+lrdw== Subject: [PATCH 2/6] nfsd(7): Correct grammatical usage of "threads" From: cel@kernel.org To: SteveD@redhat.com Cc: linux-nfs@vger.kernel.org, debian@helgefjell.de Date: Sun, 18 Dec 2022 11:41:35 -0500 Message-ID: <167138169547.1584402.5771788433072234381.stgit@morisot.1015granger.net> In-Reply-To: <167138168903.1584402.12231405451604036910.stgit@morisot.1015granger.net> References: <167138168903.1584402.12231405451604036910.stgit@morisot.1015granger.net> User-Agent: StGit/1.5 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-nfs@vger.kernel.org From: Chuck Lever Man page: nfsd.7 Issue: thread currently → threads currently "This file represents the number of B thread currently running. " "Reading it will show the number of threads. Writing an ASCII decimal number " "will cause the number of threads to be changed (increased or decreased as " "necessary) to achieve that number." Reported-by: Helge Kreutzmann Signed-off-by: Chuck Lever --- utils/exportfs/nfsd.man | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/utils/exportfs/nfsd.man b/utils/exportfs/nfsd.man index 2abb8933fb11..6992e10829e7 100644 --- a/utils/exportfs/nfsd.man +++ b/utils/exportfs/nfsd.man @@ -57,7 +57,7 @@ by a backslash followed by the octal ASCII code for that character. .B threads This file represents the number of .B nfsd -thread currently running. Reading it will show the number of +threads currently running. Reading it will show the number of threads. Writing an ASCII decimal number will cause the number of threads to be changed (increased or decreased as necessary) to achieve that number. From patchwork Sun Dec 18 16:41:41 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chuck Lever X-Patchwork-Id: 13076072 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 99923C4332F for ; Sun, 18 Dec 2022 17:37:47 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231652AbiLRRho (ORCPT ); Sun, 18 Dec 2022 12:37:44 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55414 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230522AbiLRRhU (ORCPT ); Sun, 18 Dec 2022 12:37:20 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9E4307F202 for ; Sun, 18 Dec 2022 08:41:45 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 597ACB80BAB for ; Sun, 18 Dec 2022 16:41:44 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id BC4FFC433EF; Sun, 18 Dec 2022 16:41:42 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1671381703; bh=Yty2yghX/PY19eOtJid0OflOIGns1EAuLZN7D08hrrM=; h=Subject:From:To:Cc:Date:In-Reply-To:References:From; b=r0QCOE8xiJrFeM6pqZz9Jk04IsiAvMm0UFcNW52mQSvixxNwh+EFmav0b2k+PqO+q X4jUQaa2f7sCDyk1KYnXsIif76UkQufftiYcfX3pAM7V3rCz2VOxAPMtnaGu2rtvYn NV1RzVKbjLL7VpLqQwWhyuDJ+ReFcHAIy/5ufADZqgsVPdGL7XFLEXqEOa2ul22NFr DrRPNFJUwryL3ObWWx7U2c7eVlUzbuZAjui8XHvLX/cph0QJbewK3pucPyjbz/VOeW nUPqwd661Y35C5iF5CWYfCrsMVGUtd7ShkzoppN5qjpR4DGmrLNNnYkLMzW839/6O4 sXI5zZPtMSQRA== Subject: [PATCH 3/6] nfsd(7): Clarify description of From: cel@kernel.org To: SteveD@redhat.com Cc: linux-nfs@vger.kernel.org, debian@helgefjell.de Date: Sun, 18 Dec 2022 11:41:41 -0500 Message-ID: <167138170181.1584402.14449106893754326594.stgit@morisot.1015granger.net> In-Reply-To: <167138168903.1584402.12231405451604036910.stgit@morisot.1015granger.net> References: <167138168903.1584402.12231405451604036910.stgit@morisot.1015granger.net> User-Agent: StGit/1.5 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-nfs@vger.kernel.org From: Chuck Lever Man page: nfsd.7 Issue: The first sentence is somewhat logical, but is this really the speciality of this file? "This is a somewhat unusual file in that what is read from it depends on what " "was just written to it. It provides a transactional interface where a " "program can open the file, write a request, and read a response. If two " "separate programs open, write, and read at the same time, their requests " "will not be mixed up." Reported-by: Helge Kreutzmann Signed-off-by: Chuck Lever --- utils/exportfs/nfsd.man | 24 +++++++++--------------- 1 file changed, 9 insertions(+), 15 deletions(-) diff --git a/utils/exportfs/nfsd.man b/utils/exportfs/nfsd.man index 6992e10829e7..e1f3f65fb297 100644 --- a/utils/exportfs/nfsd.man +++ b/utils/exportfs/nfsd.man @@ -64,23 +64,17 @@ that number. .TP .B filehandle -This is a somewhat unusual file in that what is read from it depends -on what was just written to it. It provides a transactional interface -where a program can open the file, write a request, and read a -response. If two separate programs open, write, and read at the same -time, their requests will not be mixed up. +This file provides a transactional interface where a program can +read back a filehandle for a path as exported to a given client. -The request written to -.B filehandle -should be a client name, a path name, and a number of bytes. This -should be followed by a newline, with white-space separating the -fields, and octal quoting of special characters. - -On writing this, the program will be able to read back a filehandle -for that path as exported to the given client. The filehandle's length -will be at most the number of bytes given. +Each written request to +.I filehandle +should be a client name, a path name, and a number of bytes. +This should be followed by a newline, with white-space separating +the fields and octal quoting of special characters. -The filehandle will be represented in hex with a leading '\ex'. +The returned filehandle is represented in hex with a leading '\ex'. +The filehandle's length will be at most the number of bytes given. .TP .B clients/ From patchwork Sun Dec 18 16:41:48 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Chuck Lever X-Patchwork-Id: 13076073 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id A2530C4332F for ; Sun, 18 Dec 2022 17:37:51 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230394AbiLRRhs (ORCPT ); Sun, 18 Dec 2022 12:37:48 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55742 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231531AbiLRRh1 (ORCPT ); Sun, 18 Dec 2022 12:37:27 -0500 Received: from sin.source.kernel.org (sin.source.kernel.org [IPv6:2604:1380:40e1:4800::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C0A9E7F211 for ; Sun, 18 Dec 2022 08:41:52 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sin.source.kernel.org (Postfix) with ESMTPS id 0957FCE0B78 for ; Sun, 18 Dec 2022 16:41:51 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 17911C433EF; Sun, 18 Dec 2022 16:41:49 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1671381709; bh=IAsPb5sAHWEdR1KyAM0hh6mb011FQIFZ4+rnuEOfo+Q=; h=Subject:From:To:Cc:Date:In-Reply-To:References:From; b=qkMtHxt7Ve+yFAgrO/xL2rVnRpUsBeB3ffbyWjwl8EO9rgZUm9n5iaKwucwgyzwnu r2kmHEMN4BsSHQEQqwFD08SSNrlG1+9E3Fy4Xz65xI0mKE0HnTryKZNlcR33jtTdwr oywO5tXYQh4FKaOgeLPKqirYdMMz2Wsv7GwFjoTdvmxi/Fz5f3FOYHkHD3nHHkAf6q lynV/17iQSxjd9UOEwp1CSxQACDSe7r40MY065C4wk+ZvuwbZXjP6J+kFsE7E7I0Hn Jo0ytewU3JOLeC4pkZO4Ca4ZX9G7YY1PVOzfy1CNRKC3Zb/g/SoPN31hqesE9sxoH0 RTCv+W0zIKLmA== Subject: [PATCH 4/6] nfsd(7): Correct grammatical usage of "can be displayed" From: cel@kernel.org To: SteveD@redhat.com Cc: linux-nfs@vger.kernel.org, debian@helgefjell.de Date: Sun, 18 Dec 2022 11:41:48 -0500 Message-ID: <167138170820.1584402.3538764439169383145.stgit@morisot.1015granger.net> In-Reply-To: <167138168903.1584402.12231405451604036910.stgit@morisot.1015granger.net> References: <167138168903.1584402.12231405451604036910.stgit@morisot.1015granger.net> User-Agent: StGit/1.5 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-nfs@vger.kernel.org From: Chuck Lever Man page: nfsd.7 Issue: can be display → can be displayed "The directory B in the B filesystem contains a number " "of files and directories. The files contain statistics that can be display " "using the I program. The directories contain information about " "various caches that the NFS server maintains to keep track of access " "permissions that different clients have for different filesystems. The " "caches are:" Reported-by: Helge Kreutzmann Signed-off-by: Chuck Lever --- utils/exportfs/nfsd.man | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/utils/exportfs/nfsd.man b/utils/exportfs/nfsd.man index e1f3f65fb297..9481670f9ffc 100644 --- a/utils/exportfs/nfsd.man +++ b/utils/exportfs/nfsd.man @@ -91,7 +91,7 @@ The directory in the .B procfs filesystem contains a number of files and directories. -The files contain statistics that can be display using the +The files contain statistics that can be displayed using the .I nfsstat program. The directories contain information about various caches that the NFS From patchwork Sun Dec 18 16:41:54 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Chuck Lever X-Patchwork-Id: 13076074 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2B482C4332F for ; Sun, 18 Dec 2022 17:37:56 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231243AbiLRRhw (ORCPT ); Sun, 18 Dec 2022 12:37:52 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56266 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231224AbiLRRha (ORCPT ); Sun, 18 Dec 2022 12:37:30 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 44E307F21E for ; Sun, 18 Dec 2022 08:41:58 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id F2060B80BD9 for ; Sun, 18 Dec 2022 16:41:56 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6773DC433D2; Sun, 18 Dec 2022 16:41:55 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1671381715; bh=eeUeXt2AO7/nwldm9rI6cBamDX/Gpp0tzrzing6UFcw=; h=Subject:From:To:Cc:Date:In-Reply-To:References:From; b=fkPaTAaKgw9ER6gn5T4txl4PsyMLQW9wVHEv4wP18pwzRQPVw1pyXXx7DN0Rprvtp 7lkMLitd0rA2gjoOPbFvwTdMdWQL2mc8Pdvc7MS1I6RMv11h4GbHuFu7XXcWFpr9bL LtOnEigVjbrD0HI69JbBOekP2kPuqP55frZwn9QbFcU29CHZc4MfhvgoLLRdk9sqwb FSn7uYiR5HMUylIKFHsTCdsdCzCzcFrPuAbEyLRc3l5Lkwoo4PdvZSRvoL8SvHmjEC CaBjambwP52OAortuibnXvUVxmPnEiVgQhHLqFbpX/QRhG7w5zAjgLHXNJuUc38wMa h7MBmOUJ8ksrQ== Subject: [PATCH 5/6] nfsd(7): Correct formatting of "select or poll" From: cel@kernel.org To: SteveD@redhat.com Cc: linux-nfs@vger.kernel.org, debian@helgefjell.de Date: Sun, 18 Dec 2022 11:41:54 -0500 Message-ID: <167138171450.1584402.1832671837785160899.stgit@morisot.1015granger.net> In-Reply-To: <167138168903.1584402.12231405451604036910.stgit@morisot.1015granger.net> References: <167138168903.1584402.12231405451604036910.stgit@morisot.1015granger.net> User-Agent: StGit/1.5 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-nfs@vger.kernel.org From: Chuck Lever Man page: nfsd.7 Issue: select(2) or poll(2) → B