From patchwork Wed Jun 22 04:27:24 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: NeilBrown X-Patchwork-Id: 9191903 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 655E46075A for ; Wed, 22 Jun 2016 04:27:41 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 4E4B328365 for ; Wed, 22 Jun 2016 04:27:41 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 41805283E1; Wed, 22 Jun 2016 04:27:41 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=2.0 tests=BAYES_00, RCVD_IN_DNSWL_HI, T_TVD_MIME_EPI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id E141C28365 for ; Wed, 22 Jun 2016 04:27:40 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1750721AbcFVE1j (ORCPT ); Wed, 22 Jun 2016 00:27:39 -0400 Received: from mx2.suse.de ([195.135.220.15]:39131 "EHLO mx2.suse.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750718AbcFVE1j (ORCPT ); Wed, 22 Jun 2016 00:27:39 -0400 X-Virus-Scanned: by amavisd-new at test-mx.suse.de X-Amavis-Alert: BAD HEADER SECTION, Duplicate header field: "Cc" Received: from relay1.suse.de (charybdis-ext.suse.de [195.135.220.254]) by mx2.suse.de (Postfix) with ESMTP id DBEF3AAAD; Wed, 22 Jun 2016 04:27:32 +0000 (UTC) From: NeilBrown To: Steve Dickson Date: Wed, 22 Jun 2016 14:27:24 +1000 Cc: Howard Guo Subject: [PATCH] nfs.man: clarify effect of 'retry' option. User-Agent: Notmuch/0.20.2 (http://notmuchmail.org) Emacs/24.5.1 (x86_64-suse-linux-gnu) cc: NFS List Message-ID: <87por9lufn.fsf@notabene.neil.brown.name> MIME-Version: 1.0 Sender: linux-nfs-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-nfs@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP 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 Signed-off-by: NeilBrown 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