From patchwork Thu Jun 1 19:46:15 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Scott Mayhew X-Patchwork-Id: 13264408 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 629E8C77B7A for ; Thu, 1 Jun 2023 19:47:04 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231883AbjFATrD (ORCPT ); Thu, 1 Jun 2023 15:47:03 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:36176 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229651AbjFATrB (ORCPT ); Thu, 1 Jun 2023 15:47:01 -0400 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E5B0118D for ; Thu, 1 Jun 2023 12:46:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1685648779; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=IcCjm6j5Lkzo515T96+Acs/cfc5OaO3WQZ2b+eBZkG0=; b=EkbCaEeQYNA5+1DevoePIdfuYKwhyHO84urlJztOhW0FgKYcS95s3q3oqLnQWklobaSije SJVKItklfF1j2/H0A8CGeDMc8ISbqBCO1CtfTBB2XCpQ9QkNOXrP3bsDmS0aPvP+62wNO9 2mb9dkKa4OXQW6VpgjyGtrbiX+CKE7M= Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-66-vUwb8O6uOraqFtdq2cstsw-1; Thu, 01 Jun 2023 15:46:17 -0400 X-MC-Unique: vUwb8O6uOraqFtdq2cstsw-1 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.rdu2.redhat.com [10.11.54.4]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 7F2FD3C025AD for ; Thu, 1 Jun 2023 19:46:17 +0000 (UTC) Received: from aion.usersys.redhat.com (unknown [10.22.32.208]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 700B220296C6; Thu, 1 Jun 2023 19:46:17 +0000 (UTC) Received: by aion.usersys.redhat.com (Postfix, from userid 1000) id 167A51A27F3; Thu, 1 Jun 2023 15:46:17 -0400 (EDT) From: Scott Mayhew To: steved@redhat.com Cc: linux-nfs@vger.kernel.org Subject: [nfs-utils PATCH 1/3] nfs(5): Document the softerr mount option. Date: Thu, 1 Jun 2023 15:46:15 -0400 Message-Id: <20230601194617.2174639-2-smayhew@redhat.com> In-Reply-To: <20230601194617.2174639-1-smayhew@redhat.com> References: <20230601194617.2174639-1-smayhew@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.4 Precedence: bulk List-ID: X-Mailing-List: linux-nfs@vger.kernel.org Signed-off-by: Scott Mayhew --- utils/mount/nfs.man | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/utils/mount/nfs.man b/utils/mount/nfs.man index 7a410422..3cef2e23 100644 --- a/utils/mount/nfs.man +++ b/utils/mount/nfs.man @@ -94,31 +94,38 @@ This option is an alternative to the option. It is included for compatibility with other operating systems .TP 1.5i -.BR soft " / " hard +.BR soft " / " softerr " / " hard Determines the recovery behavior of the NFS client after an NFS request times out. -If neither option is specified (or if the +If no option is specified (or if the .B hard option is specified), NFS requests are retried indefinitely. -If the -.B soft +If either the +.BR soft " or " softerr option is specified, then the NFS client fails an NFS request after .B retrans retransmissions have been sent, -causing the NFS client to return an error -to the calling application. +causing the NFS client to return either the error +.B EIO +(for the +.B soft +option) or +.B ETIMEDOUT +(for the +.B softerr +option) to the calling application. .IP .I NB: A so-called "soft" timeout can cause silent data corruption in certain cases. As such, use the -.B soft +.BR soft " or " softerr option only when client responsiveness is more important than data integrity. Using NFS over TCP or increasing the value of the .B retrans option may mitigate some of the risks of using the -.B soft +.BR soft " or " softerr option. .TP 1.5i .BR softreval " / " nosoftreval From patchwork Thu Jun 1 19:46:16 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Scott Mayhew X-Patchwork-Id: 13264409 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 EF810C77B7E for ; Thu, 1 Jun 2023 19:47:04 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229651AbjFATrD (ORCPT ); Thu, 1 Jun 2023 15:47:03 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:36172 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231178AbjFATrB (ORCPT ); Thu, 1 Jun 2023 15:47:01 -0400 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E59A1189 for ; Thu, 1 Jun 2023 12:46:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1685648779; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=ZqkHy8ZAPKlr+SHQRkpklX7yxS0TC5cn4LTH+deSobE=; b=KbeJHp6jgWXYQkEIsSRHBufPvfSfAiYHtkaVU/bINBITUssxklTR5SRjzJPEoJ/qNzJ4RJ aj/Qpay2u81GTU7lHcKneY2u3Xm26KX+nFpAElFaNU4ApEdilyagPHyVeeLW9fcmd8Oq9Y B6LXoG/b7pKGSoCKfjDWRmzdgdFrgWs= Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-66-CpWQFkeIOp2-SXEIRkgfTg-1; Thu, 01 Jun 2023 15:46:17 -0400 X-MC-Unique: CpWQFkeIOp2-SXEIRkgfTg-1 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 7FD12101A52C for ; Thu, 1 Jun 2023 19:46:17 +0000 (UTC) Received: from aion.usersys.redhat.com (unknown [10.22.32.208]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 73DBC9E60; Thu, 1 Jun 2023 19:46:17 +0000 (UTC) Received: by aion.usersys.redhat.com (Postfix, from userid 1000) id 1E86E1A27F7; Thu, 1 Jun 2023 15:46:17 -0400 (EDT) From: Scott Mayhew To: steved@redhat.com Cc: linux-nfs@vger.kernel.org Subject: [nfs-utils PATCH 2/3] nfs(5): Document the write=lazy|eager|wait mount option. Date: Thu, 1 Jun 2023 15:46:16 -0400 Message-Id: <20230601194617.2174639-3-smayhew@redhat.com> In-Reply-To: <20230601194617.2174639-1-smayhew@redhat.com> References: <20230601194617.2174639-1-smayhew@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.5 Precedence: bulk List-ID: X-Mailing-List: linux-nfs@vger.kernel.org Signed-off-by: Scott Mayhew --- utils/mount/nfs.man | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/utils/mount/nfs.man b/utils/mount/nfs.man index 3cef2e23..2ed898f8 100644 --- a/utils/mount/nfs.man +++ b/utils/mount/nfs.man @@ -614,6 +614,28 @@ option is not specified, the default behavior depends on the kernel, but is usually equivalent to .BR "xprtsec=none" . +.TP 1.5i +.BI write= behavior +Controls how the NFS client handles the +.BR write (2) +system call. +.I behavior +can be one of +.BR lazy , +.BR eager , +or +.BR wait . +If +.B lazy +(the default) is specified, then the NFS client delays sending application +writes to the NFS server as described in the DATA AND METADATA COHERENCE +section. If +.B eager +is specified, then the NFS client sends off the write immediately as an +unstable WRITE to the NFS server. If +.B wait +is specified, then the NFS client sends off the write immediately as an +unstable WRITE to the NFS server and then waits for the reply. .SS "Options for NFS versions 2 and 3 only" Use these options, along with the options in the above subsection, for NFS versions 2 and 3 only. From patchwork Thu Jun 1 19:46:17 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Scott Mayhew X-Patchwork-Id: 13264410 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 E3CDDC77B7E for ; Thu, 1 Jun 2023 19:47:08 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231298AbjFATrH (ORCPT ); Thu, 1 Jun 2023 15:47:07 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:36170 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231423AbjFATrH (ORCPT ); Thu, 1 Jun 2023 15:47:07 -0400 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B114E184 for ; Thu, 1 Jun 2023 12:46:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1685648778; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=s8OTCkfhnXCqr3MSd46tEPZird3E+hLWGbqbVPI2Tf8=; b=C/GtXd/77+rCCpo36eB6Oh3Y1cX20XOCHmkLpl1d1NlX57xKhPA1tkL1LYJulE/p5VDl0a eze/IjDsdzUaLI+Hx8AmRXXhCfi3e8A95iI2iE4LwfBbfyRRQi7s57rbwBY2TUHQiUedkK wXJOKrimL+OkC0agOy5JZOddRTlYQto= Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-622-XCOjvm7iPmK2PwcYSNZSDQ-1; Thu, 01 Jun 2023 15:46:17 -0400 X-MC-Unique: XCOjvm7iPmK2PwcYSNZSDQ-1 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 81220800888 for ; Thu, 1 Jun 2023 19:46:17 +0000 (UTC) Received: from aion.usersys.redhat.com (unknown [10.22.32.208]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 75E1CC154D7; Thu, 1 Jun 2023 19:46:17 +0000 (UTC) Received: by aion.usersys.redhat.com (Postfix, from userid 1000) id 22F5C1A27F8; Thu, 1 Jun 2023 15:46:17 -0400 (EDT) From: Scott Mayhew To: steved@redhat.com Cc: linux-nfs@vger.kernel.org Subject: [nfs-utils PATCH 3/3] nfs(5): Document the trunkdiscovery/notrunkdiscovery mount option. Date: Thu, 1 Jun 2023 15:46:17 -0400 Message-Id: <20230601194617.2174639-4-smayhew@redhat.com> In-Reply-To: <20230601194617.2174639-1-smayhew@redhat.com> References: <20230601194617.2174639-1-smayhew@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.8 Precedence: bulk List-ID: X-Mailing-List: linux-nfs@vger.kernel.org Also, move the documentation for max_connect to the section for NFSv4-specific options. Signed-off-by: Scott Mayhew --- utils/mount/nfs.man | 39 ++++++++++++++++++++++++++------------- 1 file changed, 26 insertions(+), 13 deletions(-) diff --git a/utils/mount/nfs.man b/utils/mount/nfs.man index 2ed898f8..0b976731 100644 --- a/utils/mount/nfs.man +++ b/utils/mount/nfs.man @@ -423,19 +423,6 @@ Note that the option may also be used by some pNFS drivers to decide how many connections to set up to the data servers. .TP 1.5i -.BR max_connect= n -While -.BR nconnect -option sets a limit on the number of connections that can be established -to a given server IP, -.BR max_connect -option allows the user to specify maximum number of connections to different -server IPs that belong to the same NFSv4.1+ server (session trunkable -connections) up to a limit of 16. When client discovers that it established -a client ID to an already existing server, instead of dropping the newly -created network transport, the client will add this new connection to the -list of available transports for that RPC client. -.TP 1.5i .BR rdirplus " / " nordirplus Selects whether to use NFS v3 or v4 READDIRPLUS requests. If this option is not specified, the NFS client uses READDIRPLUS requests @@ -1000,6 +987,32 @@ when it identifies itself via a traditional identification string. .IP This mount option has no effect with NFSv4 minor versions newer than zero, which always use TSM-compatible client identification strings. +.TP 1.5i +.BR max_connect= n +While +.BR nconnect +option sets a limit on the number of connections that can be established +to a given server IP, +.BR max_connect +option allows the user to specify maximum number of connections to different +server IPs that belong to the same NFSv4.1+ server (session trunkable +connections) up to a limit of 16. When client discovers that it established +a client ID to an already existing server, instead of dropping the newly +created network transport, the client will add this new connection to the +list of available transports for that RPC client. +.TP 1.5i +.BR trunkdiscovery " / " notrunkdiscovery +When the client discovers a new filesystem on a NFSv4.1+ server, the +.BR trunkdiscovery +mount option will cause it to send a GETATTR for the fs_locations attribute. +If is receives a non-zero length reply, it will iterate through the response, +and for each server location it will establish a connection, send an +EXCHANGE_ID, and test for session trunking. If the trunking test succeeds, +the connection will be added to the existing set of transports for the server, +subject to the limit specified by the +.BR max_connect +option. The default is +.BR notrunkdiscovery . .SH nfs4 FILE SYSTEM TYPE The .BR nfs4