diff mbox

nfs.man: clarify effect of 'retry' option.

Message ID 87por9lufn.fsf@notabene.neil.brown.name (mailing list archive)
State New, archived
Headers show

Commit Message

NeilBrown June 22, 2016, 4:27 a.m. UTC
The total timeout for a "mount" attempt to an non-responsive server
will always be a multiple of time a single mount attempt in the kernel takes,
which for TCP defaults to about 4 minutes.
The documentation for the "retry" option seems to suggest that this can be used
to set a maximum but it really sets a time after which to stop retrying.
The total can be as much as "retry" plus the time for a single attempt.

So clarify the documentation a bit, and also note that retrans
defaults are different for UDP and TCP:
   #define NFS_DEF_UDP_RETRANS	(3)
   #define NFS_DEF_TCP_RETRANS	(2)

Reported-by: Howard Guo<hguo@suse.com>
Signed-off-by: NeilBrown <neilb@suse.com>

Comments

Trond Myklebust June 22, 2016, 5:08 a.m. UTC | #1
> On Jun 22, 2016, at 00:27, NeilBrown <neilb@suse.com> wrote:
> 
> 
> 
> The total timeout for a "mount" attempt to an non-responsive server
> will always be a multiple of time a single mount attempt in the kernel takes,
> which for TCP defaults to about 4 minutes.
> The documentation for the "retry" option seems to suggest that this can be used
> to set a maximum but it really sets a time after which to stop retrying.
> The total can be as much as "retry" plus the time for a single attempt.
> 
> So clarify the documentation a bit, and also note that retrans
> defaults are different for UDP and TCP:
>   #define NFS_DEF_UDP_RETRANS	(3)
>   #define NFS_DEF_TCP_RETRANS	(2)
> 
> Reported-by: Howard Guo<hguo@suse.com>
> Signed-off-by: NeilBrown <neilb@suse.com>
> 
> diff --git a/utils/mount/nfs.man b/utils/mount/nfs.man
> index e541cdc95cb1..fab24f898f64 100644
> --- a/utils/mount/nfs.man
> +++ b/utils/mount/nfs.man
> @@ -391,6 +391,13 @@ is 2 minutes, and the default value for background mounts is 10000 minutes
> If a value of zero is specified, the
> .BR mount (8)
> command exits immediately after the first failure.
> +.IP
> +Note that the total timeout will always be a multiple of the time
> +determined by the
> +.BR timeo
> +and
> +.BR retrans
> +options, which by default will be 30 minutes.

How do we get to 30 minutes?

--
To unsubscribe from this list: send the line "unsubscribe linux-nfs" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
diff mbox

Patch

diff --git a/utils/mount/nfs.man b/utils/mount/nfs.man
index e541cdc95cb1..fab24f898f64 100644
--- a/utils/mount/nfs.man
+++ b/utils/mount/nfs.man
@@ -391,6 +391,13 @@  is 2 minutes, and the default value for background mounts is 10000 minutes
 If a value of zero is specified, the
 .BR mount (8)
 command exits immediately after the first failure.
+.IP
+Note that the total timeout will always be a multiple of the time
+determined by the
+.BR timeo
+and
+.BR retrans
+options, which by default will be 30 minutes.
 .TP 1.5i
 .BI sec= flavors
 A colon-separated list of one or more security flavors to use for accessing