admtcpipparams(1M) DG/UX R4.11 admtcpipparams(1M)
NAME
admtcpipparams - manage the TCP/IP host parameters and tunable
parameters
SYNOPSIS
admtcpipparams -o set [ -n hostname ] [ -i hostid ] [ parameter=value
... ]
admtcpipparams -o get [ -qv ] [ all | parameter ... ]
admtcpipparams -o reset [ -qv ] all | parameter ...
admtcpipparams -o restore
DESCRIPTION
Admtcpipparams manages the TCP/IP host parameters and the TCP/IP
tunable parameters in the tcpip.params(4M) database. The parameters
include hostname(1C) and hostid(1C) as well as the tunable parameters
within the group tcpip configurable by sysconfig(1M). These tunable
parameters are:
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.
ipforwarding
IP Forwarding is a switch to permit 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 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).
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.
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.
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.
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.
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.
Operations
set Set the hostname and/or the hostid and/or the TCP/IP
tunable parameters. The hostname, hostid, and tunable
parameters are set immediately.
get If no arguments are specified, get the hostname and the
hostid only. This maintains backwards compatibility with
pre-DG/UX 5.4R3.00 versions of admtcpipparams.
If the argument all is specified, get the tunable
parameters in addition to the hostname and the hostid. In
this case the hostname and the hostid appear with the
tunable parameters as parameter = value pairs under the
parameter and value headings.
Otherwise get the values of the tunable parameters
specified as arguments to this operation.
reset Reset one or more tunable parameters to their kernel-
defined default values as given above.
restore Set all the TCP/IP tunable parameters to their respective
values stored in the tunable parameters section of the
tcpip.params(4M) database.
Options
-n hostname
hostname is the name that uniquely identifies a host.
Every host has a hostname for each network interface which
associates an Internet address with that interface. But
the hostname uniquely identifies a host system. By
convention, the hostname is also the hostname for the
primary network interface.
-i hostid hostid is a number that uniquely identifies a host. By
convention, this number is the Internet address of the
host's primary network interface. The number may be
entered in either Internet address or hexadecimal format:
for example, as Internet address 128.222.8.61 or the
corresponding hexadecimal number 0x80de083d.
-q "Quiet." Produce an unformatted listing (i.e. no headers,
fields delimited by a single space).
-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 the hostname to myhost; set ipttl to 10 and
ipforwarding to off; set the hostname to myhost2 and ipttl to 5;
get the hostname and hostid only; get the values for arptimeout and
for tcpkeepalive; and get the values of all tunable parameters, the
hostname and the hostid.
admtcpipparams -o set -n myhost
admtcpipparams -o set ipttl=10 ipforwarding=off
admtcpipparams -o set -n myhost2 ipttl=25
admtcpipparams -o get
admtcpipparams -o get arptimeout tcpkeepalive
admtcpipparams -o get all
FILES
/etc/tcpip.params
TCP/IP parameters file which stores the TCP/IP host
parameters and TCP/IP tunable parameters.
OUTPUT
The get operation writes its output to stdout. The set, reset, and
restore operations also write their acknowledgment messages to
stdout.
The verbose form of the get operation outputs information in aligned
columns with column headers.
The quiet form of the get operation suppresses headers.
DIAGNOSTICS
Errors
- The hostid is not in hexadecimal or Internet address format.
- Cannot access tcpip.params.
- No value specified for parameter <parameter name>.
- Failed to modify parameter <parameter name> in tcpip.params.
- Parameter <parameter name> is an unknown parameter name.
- Unable to obtain the value of one or more parameters!"
- Invalid entry(s) in TCPIPPARAMS section of tcpip.params.
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
sysconfig(1M), hostname(1C), hostid(1C), tcpip.params(4M),
capdefaults(5).
NOTES
Only a user with appropriate privilege can use the set, reset and
restore operations. For systems supporting the DG/UX Capability
Option, appropriate privilege is defined as having one or more
specific capabilities enabled in the effective capability set of the
user. See capdefaults(5) for the default capabilities for this
command.
On generic DG/UX systems, appropriate privilege means that your
process has an effective UID of root. See the
appropriateprivilege(5) man page for more information.
Access to the get operation is granted based upon read access to the
tcpip.params file. Generally, all have read access to the
tcpip.params file.
Licensed material--property of copyright holder(s)