From nobody Wed Sep 21 01:17:41 2022 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 4MXLBF4RMkz4cvq1; Wed, 21 Sep 2022 01:17:41 +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 4MXLBF3sTkz3sRG; Wed, 21 Sep 2022 01:17:41 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1663723061; 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=YNFEXDoB+L+YxfrbZIjCKol1Ou3dwLv7oXGOkE9djNY=; b=FzTo4WPF8389Kt8VovSefNSrHDrtih8vw6+IuiMy6NKdW2Aig4dyRgw6La1b7v6JoYetYs hG8cYrYfYZKSCQZUimKiLcue+NbZCWCLnaX6XU4Qrael+Lls9ghWIFq/dUib4Xa5b+O4G2 KILyEHuH0Updc4sHcvXuux5+VmU7CTMJjlUXvG0TNBj/XhEaN729hLpMfdHSIDJIUpMxb+ KnoWIxkg4/v2Pj+lawT6bJxALyr2xOolS4Ljv2rV6DhtLVW+1+Ms0y94BL4mU+e6WJtH05 FtnOQn6RwbpYtTxoyBQmc290Sh6gmhkN+2QEpX4CMR3EDUJgIfPx4y/j+JYxug== 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 4MXLBF2kprztph; Wed, 21 Sep 2022 01:17:41 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 28L1HfUA044648; Wed, 21 Sep 2022 01:17:41 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 28L1HfJi044647; Wed, 21 Sep 2022 01:17:41 GMT (envelope-from git) Date: Wed, 21 Sep 2022 01:17:41 GMT Message-Id: <202209210117.28L1HfJi044647@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Rick Macklem Subject: git: a72dee6742c4 - stable/12 - mount_nfs.8: Update for NFSv4 use of "nolockd" 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/stable/12 X-Git-Reftype: branch X-Git-Commit: a72dee6742c4e7b9beafcb15b15243b92381eb2d Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1663723061; 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=YNFEXDoB+L+YxfrbZIjCKol1Ou3dwLv7oXGOkE9djNY=; b=MC295OxtiyAj6sndIQyxHn3OezAKbf5uZGHDAVWmwkqLZsIcabyLc6qS2VzBwmx88qn7Zf z4wSoBXJpSfXVGNUEEIgQpOtcNsXuSrsI7CtgAfGFHoajlOU3evgNPwjvuwnIdV5oCK0QP G453PeBmYyKCTyVIDL6TI8ZFvUlvxS6tupSVYCpAs6l+NQUMMdEXNQQKi5XCwD0Y7ViAEG nq3csj0bWd8X84593AMa8yfJk1ugv2UZENPHJCoMggw1YHAFez8/B1hLhVN7UV7i4W3U9d biPEDuAdJDOWiWVgVtdSIEnlglc8GjuJ0vgh5wrQOgShLX9aHYIMkN57KIBUuw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1663723061; a=rsa-sha256; cv=none; b=DhjU6OCA3VUAB1PkliJ94GHMSGTpZf3kLFcpPJhHh0rF/KDPdxyV05U1DyPhLO/EJe/5d7 a+ijEYXiCm6iNckbSFAjKzpxScWi81/6jZ8IwuEmq7JHtPkLzXwSj14pi3F0XIOdGV/krI fHV/nlqxNvhf7UDmj4unH2KAgdtOeWCOlN6aHSc3e/nSIPA+PPxpkWFk7R+RmB4+v2NToF aM0wNKgQ4qJQyauK3gcL5W0Yr3h0eJi3KatOZvFLw0vm7C48ZZZPk/MKMNP/eVySgd1xJx BFw6zWkjMFghxJM8gfy8a95xj5W8Stvxsk2Rgt8cI2BDUs1esLtR2UPi5c6QUQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/12 has been updated by rmacklem: URL: https://cgit.FreeBSD.org/src/commit/?id=a72dee6742c4e7b9beafcb15b15243b92381eb2d commit a72dee6742c4e7b9beafcb15b15243b92381eb2d Author: Rick Macklem AuthorDate: 2022-09-07 21:07:20 +0000 Commit: Rick Macklem CommitDate: 2022-09-21 01:13:38 +0000 mount_nfs.8: Update for NFSv4 use of "nolockd" Commit 33721eb991d8 enabled use of "nolockd" for NFSv4 mounts. This was done primarily to allow its use with the "intr" mount option. This patch updates the man page for this. This is a content change. (cherry picked from commit 9b436906fa10b8bec4f7c231b389ed9ef5b2acad) --- sbin/mount_nfs/mount_nfs.8 | 23 +++++++++++++++++------ 1 file changed, 17 insertions(+), 6 deletions(-) diff --git a/sbin/mount_nfs/mount_nfs.8 b/sbin/mount_nfs/mount_nfs.8 index 1b83687d950f..a99ace2d1c82 100644 --- a/sbin/mount_nfs/mount_nfs.8 +++ b/sbin/mount_nfs/mount_nfs.8 @@ -28,7 +28,7 @@ .\" @(#)mount_nfs.8 8.3 (Berkeley) 3/29/95 .\" $FreeBSD$ .\" -.Dd August 31, 2022 +.Dd September 5, 2022 .Dt MOUNT_NFS 8 .Os .Sh NAME @@ -186,6 +186,10 @@ Same as not specifying Make the mount interruptible, which implies that file system calls that are delayed due to an unresponsive server will fail with EINTR when a termination signal is posted for the process. +To avoid leaving file locks in an indeterminate state on the NFS +server, it is recommended that the +.Cm nolockd +option be used with this option. .It Cm maxgroups Ns = Ns Aq Ar value Set the maximum size of the group list for the credentials to the specified value. @@ -295,19 +299,23 @@ Do .Em not forward .Xr fcntl 2 -locks over the wire. +locks over the wire via the NLM protocol for NFSv3 mounts +or via the NFSv4 protocol for NFSv4 mounts. All locks will be local and not seen by the server -and likewise not seen by other NFS clients. +and likewise not seen by other NFS clients for NFSv3 or NFSv4 mounts. This removes the need to run the .Xr rpcbind 8 service and the .Xr rpc.statd 8 and .Xr rpc.lockd 8 -servers on the client. +servers on the client for NFSv3 mounts. Note that this option will only be honored when performing the initial mount, it will be silently ignored if used while updating the mount options. +Also, note that NFSv4 mounts do not use these daemons. +The NFSv4 protocol handles locks, +unless this option is specified. .It Cm noncontigwr This mount option allows the NFS client to combine non-contiguous byte ranges being written @@ -575,7 +583,7 @@ A version of the utility appeared in .Bx 4.4 . .Sh BUGS -Since nfsv4 performs open/lock operations that have their ordering strictly +Since NFSv4 performs open/lock operations that have their ordering strictly enforced by the server, the options .Cm intr and @@ -584,5 +592,8 @@ cannot be safely used. For NFSv4 minor version 1 mounts, these options may also result in hung mount points, due to corruption of session slots. +For NFSv4 mounts, .Cm hard -nfsv4 mounts are strongly recommended. +mounts without the +.Cm intr +mount option is strongly recommended.