setoncenv(1M)setoncenv(1M)NAMEsetoncenv - NFS environment configuration command
SYNOPSIS
variable value
[subsystem|variable]
variable [value]
[subsystem]
DESCRIPTION
initializes, displays, and removes the value of NFS configuration vari‐
ables, 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 tun‐
able 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 sub‐
system or an individual variable. For subsystem
names, see the section of this manpage. For variable
names, see the sections in this manpage for each sub‐
system.
Provide verbose output for the
option.
Remove or comment out a configuration variable in a configura‐
tion file.
The command will not remove or comment out variables
from or it also cannot be used to remove kernel tun‐
able 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 vari‐
ables 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 con‐
figuration 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:
· For and the last entry is the value used.
· 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 min‐
utes). 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 daemon switches to "enhanced mode". In
this mode, it is recommended to set this tunable with
a value greater than the probable number of unreach‐
able 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 considered 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 vari‐
able only applies to NFS Version 4. If local pro‐
cesses 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-ori‐
ented
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 con‐
nections.
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 com‐
mented out. For the UDP protocol, only version 2 and
version 3 NFS service is established. 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 over‐
rides the default. This domain is used for identify‐
ing user and group attribute strings in the NFS Ver‐
sion 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 deter‐
mines 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 file‐
name.0. The oldest file will have the highest num‐
bered 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 database. 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 pass‐
word 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 dae‐
mons, 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 ALSOautomount(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), yppass‐
wdd(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_read‐
dirplus(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_transfer_size_cots(5), nfs4_nra(5), nfs_portmon(5).
setoncenv(1M)
