setoncenv(1M) setoncenv(1M)
NAME
setoncenv - NFS environment configuration command
SYNOPSIS
variable value
[subsystem|variable]
variable [value]
[subsystem]
DESCRIPTION
initializes, displays, and removes the value of NFS configuration variables, found either in or The value can be an integer or a string and
should be consistent with the variable being set. There is limited validation of the value parameter. Quotes should be avoided unless the
value can have white space; then quotes should be used. The command can also be used to display the NFS kernel tunable variables.
Options
recognizes the following options:
Add a supported configuration variable, or change the value of an
existing configuration variable in the configuration file. The option cannot be used to set a kernel tunable variable.
You must use to manage kernel tunable variables.
Provide verbose output for the
option.
Display the values of all configuration variables and kernel tunable variables
supported by Optionally you can specify either a subsystem or an individual variable. For subsystem names, see the sec-
tion of this manpage. For variable names, see the sections in this manpage for each subsystem.
Provide verbose output for the
option.
Remove or comment out a configuration variable in a configuration file.
The command will not remove or comment out variables from or it also cannot be used to remove kernel tunable variables.
The value parameter is only used when removing an entry for a configuration variable that supports multiple entries in a
configuration file (for example,
Provide verbose output for the
option.
Display NFS kctune variables that do not have their default value.
The subsystem parameter displays only the kctune variables of the named subsystem. For subsystem names, see the section
of this manpage.
Provide verbose output for the
option.
NOTE: Using a command or editor other than to modify the supported configuration files can cause problems if used simultaneously. The com-
mand will attempt to correct some issues, such as duplicate entries where duplicate entries are not allowed, but there is no guarantee that
can recover a configuration file once the file has been edited by another process. In the event of duplicate entries in a configuration
file, the following precedence is followed:
o For and the last entry is the value used.
o For and the first entry is the value used.
Subsystem Names
The command recognizes the following subsystem names:
Display all variables associated with the AutoFS subsystem.
Display all variables associated with the KEY,
subsystem.
Display all variables associated with the Kernel Lock Manager subsystem.
Display all variables associated with the kernel RPC subsystem.
Display all variables associated with the NFS subsystem.
Display all variables associated with the NFS logging,
subsystem.
Display all variables associated with the NIS subsystem.
Display all variables associated with the pcnfsd subsystem.
Display all variables associated with the
subsystem.
Variable Names for the AutoFS Subsystem
The command recognizes the following configuration variable names for the AutoFS subsystem:
The location of the default auto_master file.
Used to enable or disable the AutoFS service during system startup.
Allowed values are 0 to disable the service or 1 to enable the service.
This variable will be obsolete in a future release.
The run time arguments for the
command used by
This variable will be obsolete in a future release.
Specifies a duration, in seconds, that a file system is to remain mounted
when not in use. The default value is 600 (10 minutes). Equivalent to the option in
Verbose mode.
Causes you to be notified of non-critical events, such as mounts and unmounts. The default value is FALSE. Equivalent to
the option in
Environment variables.
Each environment variable-value pairing must be on its own line. You can specify multiple such pairings. When using the
option, just specifying will remove all variables, using will remove that value only.
Turn on or off browsing for all AutoFS mount points.
The default value is FALSE. Equivalent to the option in
The run time arguments for the
daemon used by
This variable will be obsolete in a future release.
Expands each RPC call and displays it on standard output.
The default value, 0, turns off such tracing. Tracing starts with value 1 and with each higher value the verbosity of
trace output increases.
Verbose mode.
Causes status messages to be logged to the console. The default value is FALSE. Equivalent to the option in
Variable Names for the KEY Subsystem
The command recognizes the following configuration variable names for the KEY subsystem:
Specifies whether default keys for nobody are used.
is equivalent to the command-line option for The default value for is yes.
The run time arguments for the
daemon used by or
This variable will be obsolete in a future release.
Variable Names for the Kernel Lock Manager Subsystem
The command recognizes the following configuration variable names for the Kernel Lock Manager subsystem:
Grace period, in seconds, that all clients (both NLM and NFSv4) have
to reclaim locks after a server reboot. This variable also controls the NFSv4 lease interval. The default value is 90.
Set connection queue length for
over a connection-oriented transport. The default value is 32.
The run time arguments for the
daemon used by
This variable will be obsolete in a future release.
Obsolete. The port number should use for listening for incoming requests.
Retransmit timeout, in seconds, before
retries. The default is 5.
Maximum number of concurrent
requests. The default value is 20.
Used to enable or disable the klm service by
Value can either be 0 to disable the service or 1 to enable the service.
This variable will be obsolete in a future release.
The run time arguments for the
daemon used by
This variable will be obsolete in a future release.
The port number
should use for listening for incoming requests.
Maximum number of threads created by
to contact the clients listed in directory during a crash recovery. Once this variable is set, and is restarted, the dae-
mon switches to "enhanced mode". In this mode, it is recommended to set this tunable with a value greater than the proba-
ble number of unreachable client hosts at any given point of time, so that can have that many threads to notify all the
clients in parallel. If the worst case scenario exists, where all clients can become non-responsive, this tunable should
be at least equal to the total number of clients in the setup.
This variable is optional. If it is not set, will be started in normal mode where only a fixed number of threads(25) will
be created by the daemon to do the crash recovery. The minimum value of is 25. If it is set less than 25, it will be con-
sidered as 25. Also, for a high value, it will be limited by the number of threads that can be created within a process.
In that case, the value will be taken as the kernel tunable variable - 100.
Percentage of threads in
that will wait for to join, before it creates further threads to process remaining entries in directory.
Lesser the value for this variable, faster will be the processing. If this tunable is not set, or if a value less than 4
or greater than 10 is specified, it will be considered as 10, which is the default value. This tunable will be effective
only if is set (i.e., when is started in enhanced mode).
Variable Names for the NFS Subsystem
The command recognizes the following configuration variable names for the NFS subsystem:
Sets the maximum record size, in multiples of 1024 bytes,
of the loopback TCP transport when is run through The default value is 1025. Values less than 1025 will default to 1025.
Defines the run time arguments for the
daemon used by
This variable will be obsolete in a future release.
Defines the port number that
should use for listening for incoming requests.
Enables tracing. This is equivalent to the command-line option. The number can be greater or equal to 1. A value of 1 enables
error tracing and a value greater than 1 increases the verbosity of the output.
Used to enable or disable the NFS client service by
Can either be 0 to disable or 1 to enable the service.
This variable will be obsolete in a future release.
The NFS client only uses NFS versions in the range specified by the
and variables. Valid values are 2, 3, and 4. The default value for is 3. You can override this range on a per-mount
bases by using the option to
The NFS client only uses NFS versions in the range specified by the
and variables. Valid values are 2, 3, and 4. The default values for is 2. You can override this range on a per-mount
bases by using the option to
Used to enable or disable the NFS server service by
Can either be 0 to disable or 1 to enable the service.
This variable will be obsolete in a future release.
The NFS server by default does not provide delegations to clients.
Delegations can be turned on for all exported file systems by setting this variable to be on. This variable only applies
to NFS Version 4. If local processes can access files in exported directories, should not be turned on. The default is
off.
The NFS server only uses NFS versions in the range specified by
and Valid values are 2, 3, and 4. The default value is 3.
The NFS server only uses NFS versions in the range specified by
and Valid values are 2, 3, and 4. The default value is 2.
Start on the transport specified by the given device only. Equivalent to the option in Mutually exclusive of Either or must be
commented out.
Set the connection queue length for NFS over a connection-oriented
transport. The default value is 32, meaning 32 entries in the queue. Equivalent to the option in
Sets the maximum number of concurrent connection-oriented connections.
This variable is read every time is run.
Start over the specified protocol only. Equivalent to the option in is equivalent to the option on the command line. Mutually
exclusive of Either or must be commented out. For the UDP protocol, only version 2 and version 3 NFS service is estab-
lished. NFS Version 4 is not supported for the UDP protocol.
The maximum number of concurrent NFS requests.
Equivalent to last numeric argument on the command line. The default is 16.
By default, the
uses the DNS domain of the system. This setting overrides the default. This domain is used for identifying user and
group attribute strings in the NFS Version 4 protocol. Clients and servers must match with this domain for operations to
proceed normally. This variable only applies to NFS Version 4.
Used to enable or disable the
daemon by
This variable will be obsolete in a future release.
Used to enable or disable the
daemon by
This variable will be obsolete in a future release.
Variable Names for the NFS Logging Subsystem
The command recognizes the following configuration variable names for the NFS logging subsystem:
Specifies how often, in hours, the log files are cycled.
This variable is used to insure that the log files do not get too large.
Specifies the amount of time, in seconds, the daemon,
should sleep while waiting for more information to be placed in the buffer file. This variable also determines how often
the configuration file will be re-read.
Specifies the time interval, in seconds, between updates
of the records in the file handle to path mapping tables. Instead of updating the access time (atime) of a record each
time that record is accessed, it is only updated if it has aged based on this parameter. The record access time is used by
the pruning routine to determine whether the record should be removed from the database.
The daemon periodically cycles its logs. This variable specifies the maximum number of log files to save. When is reached,
the oldest files will be overwritten as new log files are created. These files will be saved with a numbered extension,
beginning with filename.0. The oldest file will have the highest numbered extension up to the value configured for
Specifies the minimum size, in bytes, that the buffer file must reach
before processing the work information and writing to the log file.
Specifies when a database record times out, in hours.
If the time that elapsed since the record was last accessed is greater than then the record can be pruned from the data-
base. The default value for is 168 hours (7 days).
Used to enable or disable the
daemon by
This variable will be obsolete in a future release.
Sets the file mode for the log files, work buffer files and file
handle mapping database.
Variable Names for the NIS Subsystem
The command recognizes the following configuration variable names for the NIS subsystem:
The maximum number of times the NIS client should attempt to contact
an NIS server before failing. This variable is used during system startup.
Used to enable or disable the NIS client during system startup.
Can either be 0 to disable or 1 to enable the service.
Used to set the domain name by
and
Used to enable or disable the NIS Master Server by
/sbin/init.d/nis.server. Can either be 0 to disable or 1 to enable the service.
Used to enable or disable the NIS Slave Server by
Can either be 0 to disable or 1 to enable the service.
Enables and disables support for shadow passwords in NIS.
Can either be 0 to disable or 1 to enable shadow password support.
The run time arguments for the
daemon used by
The run time arguments for the
daemon used by
The run time arguments for the
daemon used by
This sets the IP address of an NIS server that the client should
bind to. This value is used by
The run time arguments for the
daemon used by
The run time arguments for the
daemon used by
Variable Names for the pcnfsd Subsystem
The command recognizes the following configuration variable names for the pcnfsd subsystem:
The port number
should use for listening for incoming requests.
Defines a virtual printer for
clients. You can specify multiple virtual printers. When using the option, just specifying will remove all entries. Using
will remove that entry only.
Specifies the parent spool directory for use by
clients. The default value is /var/spool/pcnfs.
Limits which users have permission to send authentication
or print requests to You can specify multiple entries. When using the option, just specifying will remove all entries.
Using will remove that entry only.
Enables and disables /var/adm/wtmps logging for
authentication requests. By default, logging is enabled. Logging is only disabled when option_string is or
Variable Names for the rpcbind Subsystem
The command recognizes the following configuration variable names for the subsystem:
Used to enable or disable the
service by Can either be 0 to disable or 1 to enable the service.
This variable will be obsolete in a future release.
The run time arguments for the
daemon used by
This variable will be obsolete in a future release.
Used to enable or disable the functionality that allows the NFS
commands to start subsystem daemons required for the NFS subsystem to work properly. If this variable is enabled, the NFS
subsystem start and stop scripts will no longer start the NFS daemons. The daemons will only be started if one of NFS
subsystem commands is run. For example, if a file system is shared using the command, the NFS daemons, and will be
started if not already running. If an NFS file system is mounted, the NFS mount command will start the NFS daemons, and
if it is an NFSv4 mount, and will be started if not already running.
Tunable Variable Names for the Kernel Lock Manager, Kernel RPC, and NFS Subsystems
The command recognizes the kernel tunable variable names which are described in the whitepaper which is available at
AUTHOR
was developed by the Hewlett-Packard Company.
SEE ALSO
automount(1M), automountd(1M), gssd(1M), kctune(1M), keyserv(1M), lockd(1M), mountd(1M), mount_nfs(1M), nfsd(1M), nfslogd(1M), nfsmapid(1M)
pcnfsd(1M), rpcbind(1M), statd(1M), syslogd(1M), yppasswdd(1M), ypupdated(1M), ypserv(1M), autofs(4), nfs(4), rc.config(4), sm(4),
nfs2_max_threads(5), nfs2_nra(5), nfs3_bsize(5), nfs3_do_readdirplus(5), nfs3_jukebox_delay(5), nfs3_max_threads(5), nfs3_max_trans-
fer_size(5), nfs3_max_transfer_size_cots(5), nfs3_nra(5), nfs4_bsize(5), nfs4_max_threads(5), nfs4_max_transfer_size(5), nfs4_max_trans-
fer_size_cots(5), nfs4_nra(5), nfs_portmon(5).
setoncenv(1M)