sysconfig(1M) DG/UX R4.11 sysconfig(1M)
NAME
sysconfig - configure or retrieve DG/UX tunable parameters
SYNOPSIS
/usr/sbin/sysconfig -o set -g group [ parameter=value ... ]
/usr/sbin/sysconfig -o get -g group [ -qv ] all | parameter ...
/usr/sbin/sysconfig -o help -g group [ -qv ] all | parameter ...
/usr/sbin/sysconfig -o reset -g group all | parameter ...
DESCRIPTION
Sysconfig provides a mechanism for configuring and retrieving the
DG/UX tunable parameters that appear in DG/UX 5.4 Release 3.00 and
later versions of the DG/UX operating system. These tunable
parameters are:
Group: cluster (Note: usable only if Cluster product installed)
vlanetables
is a listing of the network controller devices
linked below the Virtual LAN device and their
corresponding eligibility tables. Note: The set
operation is not permitted on this parameter.
vlanstats
is a listing of the statistics maintained by the
Virtual LAN device. Note: The set operation is
not permitted on this parameter.
vlanloglevel
is the level of logging in use by the Virtual LAN
device. A log level of zero (0) indicates no
logging with larger numbers indicating
increasingly more detailed log messages. The
Virtual LAN log messages are typically sent to
the system console and logged by the syslog(3C)
facility.
Group: tcpip
arptimeout
Base ARP Cache Time-out is the number of seconds
used as the base value for determining ARP cache
time-outs. Complete ARP entries multiply this
value by 20 to get their actual timeout while
incomplete entries multiply the value by 3. The
values for arptimeout may range from 1 to 100000
seconds. The default is 60.
ipbcastforward
IP Broadcast Forwarding is a switch to permit or
prevent the forwarding of IP broadcast packets
through the host to another network. This value
may either be on or off. The default is off
(i.e. prevent). Note: This switch only has
meaning if ipforwarding is on.
ipforwarding
IP Forwarding is a switch to permit or prevent
the forwarding of IP packets through the local
machine so that the local machine acts as a
gateway. This value may either be on or off.
The default is on (i.e. permit). Note: This
value does not affect source-routed IP packets.
ipsrcrtforward
IP Non-Local Source Route Forwarding is a switch
to permit or prevent the forwarding of IP source-
routed packets through an interface and out a
different interface on the local machine. This
value may either be on or off. The default is
off (i.e. prevent).
ipttl IP Time-to-Live is the maximum hop count an IP
packet may travel before being dropped. This
value may range from 1 to 255 hops. The default
is 255.
tcpkeepalive
TCP Default Keep-Alive Idle Time is the number of
seconds TCP will wait before sending Keep-Alive
probes provided the Keep-Alive facility is
active. The value may range from 0 to 14400
seconds. The default is 7200.
tcpkeepcnt
TCP Default Keep-Alive Probe Count is the number
of unanswered TCP Keep-Alive probes required to
declare a connection dead. The value may range
from 2 to 255 packets. The default is 8.
tcpkeepintvl
TCP Default Keep-Alive Interval is the number of
seconds between TCP Keep-Alive probes provided
the Keep-Alive facility is active. The value may
range from 1 to 14400 seconds. The default is
75.
Operations
set Set the value of one or more tunable parameters within a
given parameter group.
get Get the value of one or more tunable parameters within a
given parameter group.
help List the names of all DG/UX tunable parameters configurable
by sysconfig(1M) and their descriptions for a given
parameter group.
reset Reset one or more of the tunable parameters within a
parameter group to its system default value.
Options
-g "Group." The name of the group of DG/UX tunable parameters
to be operated upon. Currently supported groups are
cluster and tcpip. Note that the cluster group parameters
may only be set or retrieved if the Cluster product is
installed.
-q "Quiet." Produce an unformatted listing (i.e. no headers,
fields delimited by a single space) and suppress
acknowledgement messages.
-v "Verbose." Produce a formatted listing with headers and
aligned columns. This option is enabled by default.
EXAMPLES
In the following examples, the system administrator performs the
following actions: set ipttl to 10 and ipforwarding to off; get the
values for arptimeout and for tcpkeepalive; get the values of all
tunable parameters within group tcpip without displaying header
information and get a list of all tunable parameters within the group
tcpip with descriptions and value ranges.
sysconfig -o set -g tcpip ipttl=10 ipforwarding=off
sysconfig -o get -g tcpip arptimeout tcpkeepalive
sysconfig -o get -g tcpip -q all
sysconfig -o help -g tcpip all
OUTPUT
The get and help operations write their output to stdout. The set
and reset operations write their acknowledgment messages to stdout as
well.
The verbose form of the get and help operations output information in
aligned columns with column headers.
The quiet form of these operations suppresses headers, and the quiet
form of the help operation suppresses the description fields as well.
DIAGNOSTICS
The following error messages do not immediately abort the operation.
If the user tries to get or set more than one parameter, sysconfig
will attempt to perform the operation on all of the specified
parameters. It will give an error message for each parameter where
the operation fails.
Errors
- sysconfig: ioctl <error condition>.
- sysconfig: socket <error condition>.
- sysconfig: Invalid <name> = <value> pair.
- sysconfig: Invalid parameter name.
- sysconfig: value for <parameter name> is out of range.
- sysconfig: Error: Unknown group name. Valid group names are:
<valid groups>.
Exit Codes
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
SEE ALSO
admtcpipparams(1M), tcpip.params(4M).
NOTES
Only the system administrator has access to the set and reset
operations. Access to the get and help operations is granted to all.
Licensed material--property of copyright holder(s)