HP-UX Reference (11i v3 07/02) - 1M System Administration Commands N-Z (vol 4)
s
setoncenv(1M) setoncenv(1M)
NAME
setoncenv - NFS environment configuration command
SYNOPSIS
/usr/sbin/setoncenv
[-av] variable value
/usr/sbin/setoncenv -l
[v][subsystem|variable]
/usr/sbin/setoncenv -r
[v] variable [value]
DESCRIPTION
setoncenv initializes, displays, and removes the value of NFS configuration variables, found either in
/etc/rc.config.d/nfsconf
,
/etc/rc.config.d/namesvrs
, /etc/default/autofs
,
/etc/default/key
, /etc/default/nfs
,or/etc/default/nfslogd
. 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
setoncenv command can also be used to display the NFS kernel tunable variables.
Options
setoncenv recognizes the following flags:
-a Add a supported configuration variable, or change the value of an existing configuration
variable in the configuration file. The -a option cannot be used to set a kernel tunable
variable. You must use kctune to manage kernel tunable variables.
-l Display the values of all configuration variables and kernel tunable variables supported by
setoncenv. Optionally you can specify either a subsystem or an individual variable.
-r Remove or comment out a configuration variable in a configuration file. The
setoncenv
command will not remove or comment out variables from
/etc/rc.config.d/nfsconf
or /etc/rc.config.d/namesvrs
; it also cannot
be used to remove kernel tunable variables. The value parameter is only used when remov-
ing an entry for a configuration variable that supports multiple entries in a configuration
file (for example,
AUTOMOUNTD_ENV
).
-v Provide verbose output.
NOTE: Using a command or editor other than setoncenv to modify the supported configuration files can
cause problems if used simultaneously. The
setoncenv command will attempt to correct some issues,
such as duplicate entries where duplicate entries are not allowed, but there is no guarantee that
seton-
cenv
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
/etc/rc.config.d/nfsconf
and /etc/rc.config.d/namesvrs
, the last entry is the value
used. For
/etc/default/nfs
, /etc/default/nfslogd, /etc/default/key
, and
/etc/default/autofs
, the first entry is the value used.
The
setoncenv command recognizes the following subsystem names:
autofs Will display all variables associated with the AutoFS subsystem.
key Will display all variables associated with the KEY, keyserv subsystem.
klm Will display all variables associated with the Kernel Lock Manager subsystem.
krpc Will display all variables associated with the kernel RPC subsystem.
nfs Will display all variables associated with the NFS subsystem.
nfslogd
Will display all variables associated with the NFS logging, nfslogd subsystem.
nis Will display all variables associated with the NIS subsystem.
rpcbind
Will display all variables associated with the rpcbind subsystem.
The setoncenv command recognizes the following configuration variable names for the AutoFS subsys-
tem:
AUTO_MASTER [path]
The location of the default auto_master file.
362 Hewlett-Packard Company − 1 − HP-UX 11i Version 3: February 2007