AIX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systems

Nfstimeout

The nfstimeout option specifies the number of seconds the client waits for a status system call on an NFS file system before it times out.

You can use this option to mitigate the default behavior of status calls on file systems. For example, if an NFS file system is stale, a status system call is timed out by NFS (soft mounted) or hang the process (hard mounted).

When the value of this option is changed to a value other than zero, a new thread is created by a caller thread to issue the status system call. The new thread is timed out by the caller thread and the operation can continue.

Oracle Solaris operating systemsNote: On Solaris, the nfstimeout option can fail if the NFS mount is hard. If a hang occurs, deactivate the nfstimeout option and mount the NFS file system soft mounted, as follows:
mount -o soft,timeo=5,retry=5 machine:/filesystem /mountpoint
The parameters are defined as follows:
soft
Generates a soft mount of the NFS file system. If an error occurs, the stat() function returns with an error. If the option hard is used, stat() does not return until the file system is available.
timeo=n
Sets the time out for a soft mount error to n tenths of a second.
retry=n
Set the internal retries and the mount retries to n, the default is 10000.

Supported Clients

This option is for all UNIX and Linux clients. The server can also define this option.

Options File

Place this option in the dsm.sys file within a server stanza or the client options file (dsm.opt).

Syntax

Read syntax diagramSkip visual syntax diagram
>>-NFSTIMEout-- --number---------------------------------------><

Parameters

number
Specifies the number of seconds the client waits for a status system call on a file system before timing out. The range of values is 0 through 120; the default is 0 seconds.

Examples

Options file:
nfstimeout 10
Command line:
-nfstimeout=10

This option is valid only on the initial command line. It is not valid in interactive mode.