sysconfig(1M) — DG/UX 5.4R3.00



sysconfig(1M)                  DG/UX 5.4R3.00                  sysconfig(1M)


NAME
       sysconfig - configure DG/UX tunable parameters

SYNOPSIS
       sysconfig -o set -g group [ parameter=value ... ]

       sysconfig -o get -g group [ -qv ] all | parameter ...

       sysconfig -o help -g group [ -qv ] all | parameter ...

       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:

       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.  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.

       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.

       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 value of one or more tunable parameters within a
                 given parameter group.




Licensed material--property of copyright holder(s)                         1



sysconfig(1M)                  DG/UX 5.4R3.00                  sysconfig(1M)


       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 the only group supported is
                 tcpip.

       -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.




Licensed material--property of copyright holder(s)                         2



sysconfig(1M)                  DG/UX 5.4R3.00                  sysconfig(1M)


   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)                         3

Museum

Related Articles