setoncenv.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

setoncenv(1M) setoncenv(1M)

NAME

setoncenv - NFS environment conﬁguration command

SYNOPSIS

/usr/sbin/setoncenv

[-a[v]] variable value

/usr/sbin/setoncenv -l

[v][subsystem |variable ]

/usr/sbin/setoncenv -r

[v] variable [value ]

/usr/sbin/setoncenv -S

[v][subsystem ]

DESCRIPTION

setoncenv initializes, displays, and removes the value of NFS conﬁguration variables, found either in

/etc/rc.config.d/nfsconf

/etc/rc.config.d/namesvrs

, /etc/default/autofs

/etc/default/keyserv

, /etc/default/nfs

, /etc/default/nfslogd

,or

/etc/pcnfsd.conf

. The value can be an integer or a string and should be consistent with the vari-

able 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 options:

-a Add a supported conﬁguration variable, or change the value of an existing conﬁguration

variable in the conﬁguration ﬁle. The -a option cannot be used to set a kernel tunable

variable. You must use kctune to manage kernel tunable variables.

-av Provide verbose output for the -a option.

-l Display the values of all conﬁguration variables and kernel tunable variables supported

by setoncenv. Optionally you can specify either a subsystem or an individual variable.

For subsystem names, see the Subsystem Names section of this manpage. For variable

names, see the Variable Names sections in this manpage for each subsystem.

-lv Provide verbose output for the -l option.

-r Remove or comment out a conﬁguration variable in a conﬁguration ﬁle. 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

removing an entry for a conﬁguration variable that supports multiple entries in a

conﬁguration ﬁle (for example,

AUTOMOUNTD_ENV

-rv Provide verbose output for the -r option.

-S 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 Subsystem Names section of this manpage.

-Sv Provide verbose output for the -S option.

NOTE: Using a command or editor other than

setoncenv to modify the supported conﬁguration ﬁles

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

setoncenv can recover a conﬁguration ﬁle once the ﬁle has been edited by another process. In the

event of duplicate entries in a conﬁguration ﬁle, the following precedence is followed:

• For

/etc/rc.config.d/nfsconf, /etc/rc.config.d/namesvrs

, and

/etc/pcnfsd.conf, the last entry is the value used.

• For

/etc/default/nfs, /etc/default/nfslogd, /etc/default/keyserv, and

/etc/default/autofs, the ﬁrst entry is the value used.

Subsystem Names

The

setoncenv command recognizes the following subsystem names:

autofs Display all variables associated with the AutoFS subsystem.

key Display all variables associated with the KEY, keyserv subsystem.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (8 pages)

PAGE 1
setoncenv(1M) setoncenv(1M) NAME setoncenv - NFS environment configuration command SYNOPSIS /usr/sbin/setoncenv [-a[v]] variable value /usr/sbin/setoncenv -l[v] [subsystem |variable ] /usr/sbin/setoncenv -r[v] variable [value ] /usr/sbin/setoncenv -S[v] [subsystem ] DESCRIPTION setoncenv initializes, displays, and removes the value of NFS configuration variables, found either in /etc/rc.config.d/nfsconf, /etc/rc.config.
PAGE 2
setoncenv(1M) setoncenv(1M) klm Display all variables associated with the Kernel Lock Manager subsystem. krpc Display all variables associated with the kernel RPC subsystem. nfs Display all variables associated with the NFS subsystem. nfslogd Display all variables associated with the NFS logging, nfslogd subsystem. nis Display all variables associated with the NIS subsystem. pcnfsd Display all variables associated with the pcnfsd subsystem.
PAGE 3
setoncenv(1M) setoncenv(1M) ENABLE_NOBODY_KEYS is yes. KEYSERV_OPTIONS [option_string] keyserv The run time arguments for the daemon /sbin/init.d/nis.client or /sbin/init.d/nis.server. used by This variable will be obsolete in a future release.
PAGE 4
setoncenv(1M) setoncenv(1M) /var/statmon/sm.bak 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 PERCENT_STATD_THREADS will be effective only if MAX_STATD_THREADS is set (i.e., when rpc.statd is started in enhanced mode).
PAGE 5
setoncenv(1M) setoncenv(1M) NFSD_DEVICE [device_name ] Start nfsd on the transport specified by the given device only. Equivalent to the -t option in nfsd. Mutually exclusive of NFSD_PROTOCOL. Either NFSD_DEVICE or NFSD_PROTOCOL must be commented out. NFSD_LISTEN_BACKLOG [number] 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 -l option in nfsd.
PAGE 6
setoncenv(1M) setoncenv(1M) MIN_PROCESS_SIZE [number] Specifies the minimum size, in bytes, that the buffer file must reach before processing the work information and writing to the log file. PRUNE_TIMEOUT [number] Specifies when a database record times out, in hours. If the time that elapsed since the record was last accessed is greater than PRUNE_TIMEOUT then the record can be pruned from the database. The default value for PRUNE_TIMEOUT is 168 hours (7 days).
PAGE 7
setoncenv(1M) setoncenv(1M) Variable Names for the pcnfsd Subsystem The setoncenv command recognizes the following configuration variable names for the pcnfsd subsystem: port [number] The port number rpc.pcnfsd should use for listening for incoming requests. printer [option_string] Defines a virtual printer for pcnfsd clients. You can specify multiple virtual printers. When using the -r option, just specifying printer will remove all entries. Using printer option_string will remove that entry only.
PAGE 8
setoncenv(1M) nfs4_max_threads(5), nfs_portmon(5).