nfsserv:nfs_shrinkreaddir
Description | Due to a bug in the
NFS version 2 server implementation, some older NFS servers can not correctly
handle NFS Version 2 READDIR requests for more than 1024
bytes of directory information in certain situations. This parameter provides
a workaround in the NFS Version 2 client.
If this parameter is enabled, the client does not generate a READDIR request for larger than 1024 bytes of directory information.
If this parameter is disabled, the over the wire size is set to the
minimum of either the size passed in by the getdents(2) system call
or NFS_MAXDATA, which is 8192 bytes.
|
Data Type | 32-bit integer
|
Default | 0 (disabled)
|
Range | 0 (disabled), 1 (enabled)
|
Units | Boolean values
|
Dynamic? | Yes
|
Validation | None
|
When to Change | Examine the value
of this parameter when using an older NFS Version 2 only server and interoperability
problems occur when trying to read directories. Enabling this parameter might
cause a slight performance drop to occur for applications that read directories.
|
Stability Level | Evolving
|
nfsserv:nfs3_shrinkreaddir
Description | A recent change to Solaris
has changed the default buffer size that the readdir(3C) library support
uses from 1048 bytes to 8192 bytes. This changes the number of bytes requested
through the getdents(2)
system call correspondingly. This in turn, translates almost directly into
larger READDIR and READDIRPLUS requests
made to NFS Version 3 server. This might result in interoperability problems
with server implementations that cannot handle the larger request size.
|
Data Type | 32-bit integer
|
Default | 0 (disabled)
|
Range | 0 (disabled), 1 (enabled)
|
Units | Boolean values
|
Dynamic? | Yes
|
Validation | None
|
When to Change | Examine the value
of this parameter when using an NFS Version 3 server and interoperability
problems occur when trying to read directories. Enabling this parameter might
cause a slight performance drop to occur for applications that read directories.
|
Stability Level | Evolving
|
rpcmod Module Parameters
This section describes NFS parameters for the rpcmod
module.
rpcmod:clnt_max_conns
Description | Controls the number
of TCP connections that the NFS client uses when communicating with each NFS
server. The kernel RPC is constructed so that it can multiplex RPCs over a
single connection, but multiple connections can be used if desired.
|
Data Type | Integer (32-bit)
|
Default | 1
|
Range | 1 to 231
- 1
|
Units | Connections
|
Dynamic? | Yes
|
Validation | None
|
When to Change | In general, 1 connection
is sufficient to achieve full network bandwidth. However, if TCP cannot utilize
the bandwidth offered by the network in a single stream, then multiple connections
might increase the throughput between the client and the server.
Increasing the number of connections doesn't come for free though. The
price for increasing the number of connections is increased kernel resource
usage to keep track of each of the connections.
|
Stability Level | Evolving
|
rpcmod:clnt_idle_timeout
Description | Controls the duration
of time on the client that a connection between the client and server is allowed
to remain idle before being closed.
|
Data Type | Long integer (32 bits
on 32-bit platforms and 64 bits on 64-bit platforms)
|
Default | 300,000 milliseconds (5
minutes)
|
Range | 0 to 231
- 1 on 32-bit platforms
0 to 263 - 1 on 64-bit platforms
|
Units | Milliseconds
|
Dynamic? | Yes
|
Validation | None
|
When to Change | Use this parameter
to change the time that idle connections are allowed to exist on the client
before being closed, if desired. You might might want to close connections
at a faster rate to avoid consuming system resources.
|
Stability Level | Evolving
|
rpcmod:svc_idle_timeout
Description | Controls the duration
of time on the server that a connection between the client and server is allowed
to remain idle before being closed.
|
Data Type | Long integer (32 bits
on 32-bit platforms and 64 bits on 64-bit platforms)
|
Default | 360,000 milliseconds (6
minutes)
|
Range | 0 to 231
- 1 on 32-bit platforms
0 to 263 - 1 on 64-bit platforms
|
Units | Milliseconds
|
Dynamic? | Yes
|
Validation | None
|
When to Change | Use this parameter
to change the time that idle connections are allowed to exist on the server
before being closed, if desired. Close connections at a faster rate to avoid
consuming system resources, if desired.
|
Stability Level | Evolving
|