From nobody Fri Dec 22 20:19:03 2023 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4SxdtH5FRTz54QG7; Fri, 22 Dec 2023 20:19:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4SxdtH4JyKz4Mkp; Fri, 22 Dec 2023 20:19:03 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1703276343; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Fky3GwpXyDmmZYM4iOuF5lK1xlunziPiZ91puP1jGsM=; b=aKPbQSaYlIifqBt100pbWGX2oHwaPkoEdXdlk89ixUHakWZMn70sdbId7kB6AHh08bHY6S Vmi7oNhPTe5DosfuetjZnFkhA4e0lytRVyYjpkZW+rEhVWL/pqg04q6rdgRmcPGgfNIR0u KrMk5/rRTxjJKU1yRihc9IdsL92VKABj4F74coBZpAab0lzFQXR8Bws6WA9V1GoL9jBjh3 8zRPws0Wd7I8dEyC1LVnybQ9VFqmdoEeTgIpNAaQBC/kNghI9T+J6VxDcZVZIsg5sQUhUk kRc8xMlX0XzGLzMmQU8JyT6WibG6jU8IyBNS51WWDUefWhrqEVsuBZnx3YLIsw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1703276343; a=rsa-sha256; cv=none; b=PCXo6ww+oNJuaG91nk1QpBFAtWBGaOSEliZnmXsDX7BVnjQ9ayPD0jXHnUAsPldruVuEhi 8fuI8498GlWiEWhpGUV6PurHgQaIsjjZIEtENqXcM4AMtvmwugZDOq+kwpRe0UIpAMOT7W ECU8D0L/+5FtzJQngk0NGZv/uWep/wo6iwmB9VsUMtS/QOiikKhISbX5BjpX+jYdiJlfyp ycYDzFNdfZmZPRl91cnCzr2JWvjABW3GECHyiYWv3GMl4hHC/HcJIVuY98PqBmyh/2TmPa TDlWw5/fned1uy9o2lUSAwLqR2/cmHsbxFTSEmUpj0a/3o4+mesrsYDXF0Vx7Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1703276343; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Fky3GwpXyDmmZYM4iOuF5lK1xlunziPiZ91puP1jGsM=; b=pQXqM9BEZ8cEVAbXRWjsmGNTwVGcCVEzZu7Z0sVuWGOlnafdTCIbl4yDghhxLLvcv1Lmh6 aI1IqkwaL8pohXZdyyMnq2fRalEKrm8x1jx/JDKpiKyly4ungtyXst8D3ZszbLGPRbrp0J kmMdhhs1o3VJzEBUrsifHoryYPZC7a1F32mjlOipWFPjLcAcbnTr+GwJjZUZN2Z+n5YzA6 DzFy+yyIre4gneClcd4os0SK0Nd654dqTMFZZaMH5L/1Ig8Pn8WEjHRb1TGq6Nckw9axNc pUX2aguy9PqtKogaLHcZXP+WiasvLguzSuwrfhKs9TZ5w5+I13vDPiPIlWTREQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4SxdtH3NfGzWQ1; Fri, 22 Dec 2023 20:19:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 3BMKJ3hb048701; Fri, 22 Dec 2023 20:19:03 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 3BMKJ3IS048698; Fri, 22 Dec 2023 20:19:03 GMT (envelope-from git) Date: Fri, 22 Dec 2023 20:19:03 GMT Message-Id: <202312222019.3BMKJ3IS048698@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Rick Macklem Subject: git: 922e78f65fd9 - main - mountd: Update exports.5 for commit 7c5146da1286 List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: rmacklem X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 922e78f65fd9a58db9e52d84290ed7c187b09278 Auto-Submitted: auto-generated The branch main has been updated by rmacklem: URL: https://cgit.FreeBSD.org/src/commit/?id=922e78f65fd9a58db9e52d84290ed7c187b09278 commit 922e78f65fd9a58db9e52d84290ed7c187b09278 Author: Rick Macklem AuthorDate: 2023-12-22 20:17:36 +0000 Commit: Rick Macklem CommitDate: 2023-12-22 20:17:36 +0000 mountd: Update exports.5 for commit 7c5146da1286 Commit 7c5146da1286 modified mountd so that it uses strunvis(3) to decode directory names in exports lines. This allows special characters, such as blanks, to be encoded in the directory names. This patch updates the exports.5 man page for this change. This is a content change. Reviewed by: karels, pauamma_gundo.com (manpages) MFC after: 1 week Differential Revision: https://reviews.freebsd.org/D42163 --- usr.sbin/mountd/exports.5 | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/usr.sbin/mountd/exports.5 b/usr.sbin/mountd/exports.5 index deae95dd6831..8b55162cdcbb 100644 --- a/usr.sbin/mountd/exports.5 +++ b/usr.sbin/mountd/exports.5 @@ -25,7 +25,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd August 16, 2022 +.Dd December 21, 2023 .Dt EXPORTS 5 .Os .Sh NAME @@ -106,6 +106,17 @@ any or .Dq Pa .. components. +Pathnames are decoded by +.Xr strunvis 3 +allowing special characters to be included in the directory name(s). +In particular, whitespace, such as embedded blanks in directory names +can be handled. +For example, a blank can be encoded as \(rs040. +.Xr vis 1 +with the +.Fl M +option may be used to encode directory name(s) with embedded special +characters. Mount points for a file system may appear on multiple lines each with different sets of hosts and export options. .Pp @@ -582,6 +593,8 @@ NFSv4 mount request for a directory that the client does not have permission for will succeed and read/write access will fail afterwards, whereas NFSv3 rejects the mount request. .Sh SEE ALSO +.Xr vis 1 , +.Xr strunvis 3 , .Xr nfsv4 4 , .Xr netgroup 5 , .Xr mountd 8 ,