srconfig(8)						      System Manager's Manual						       srconfig(8)

NAME

       srconfig - Displays and controls source routing functions and parameters for communication on token ring networks

SYNOPSIS

       /usr/sbin/srconfig [options]

OPTIONS

       The options are case insensitive; use uppercase, lowercase, or any combination.	The short form of each option is indicated by capital let-
       ters. For example -DElentry can be shortened to -de and -Enasr can be shortened to -e.  Deletes the entry in the  source  routing  database
       for  the destination (target) node that has the address mac_address.  This option requires superuser privileges.  Disables the entry in the
       source routing database for the destination (target) node that has the address mac_address, marking the entry as Stale. The system attempts
       to  update  the entry through its route discovery process the next time it needs to communicate with this node.	This option requires supe-
       ruser privileges.  Displays whether source routing is enabled. If enabled, it also displays the following source routing  attributes  whose
       values  you can set with the other srconfig options.  Current Source Routing Aging Timer value Current Source Routing Discovery Timer value
       Current Source Routing Table size Displays the following counters that are associated with the source routing database: All Routes  Explore
       (ARE) frames sent ARE frames received Route discovery failures Displays the entry for the node with address mac_address in the source rout-
       ing database.  Each entry describes the current description of the best path to the node.  There is no default value for mac_address.  Dis-
       plays  all  entries  in	the  source routing database.  (See -re option.)  Sets the value of the Source Routing Aging Timer, specifying the
       length of time a source routing table entry remains valid before being marked as invalid or Stale. If not set, the system  default  is  120
       seconds.  This option requires superuser privileges.  Sets the value of the Source Routing Discovery Timer, specifying the amount of time a
       route discovery process can take before it terminates.  If not set, the system default is 5 seconds. This option requires superuser  privi-
       leges.	Sets  the maximum number of entries in the source routing database.  The range of this parameter is a multiple of 256 from 1024 to
       2048. If not set, the system default is 1024. This parameter can only be increased, not decreased. This option  requires  superuser  privi-
       leges.	Specifies  that  the MAC addresses are in non-canonical form.  This option can be used with the -DElentry, -DISEntry, -REntry, and
       -RTable options only.  Sets the source routing counters to zero.

DESCRIPTION

       The srconfig command reads and modifies entries in the your local system's source routing database.

       For every remote system on an extended token ring network with which your local system communicates, there exists a corresponding entry	in
       your local system's source routing database.  Each entry describes the path to the remote system on the network.

       Source  routing is the mechanism by which data transmitted from your local node reaches remote systems on other token ring LANs.  Your sys-
       tem maintains a source routing database so token ring adapters, for example tra0, can find the route a message is to take to a remote  des-
       tination.   The	entries  list  the specific token ring LANs (and their interconnecting bridges) that the data is to traverse to the remote
       system.

       To maintain its source routing database, your system frequently executes a route discovery process to find the most efficient route to each
       remote  system.	The route discovery process and source routing itself are largely automatic. However, you can use the srconfig commands to
       manually change the source routing database entries.

       You need superuser privileges to use the srconfig options, except for the read options.

EXAMPLES

       To display all the entries in your source  routing  database,  enter:  srconfig	-rt  Target  Node  MAC	Address  00-00-0C-01-08-E9  (ip  =
       130.180.4.3)  Have  Route  Routing Information: SRF, length 8, direction 0,largest frame 4472 octets Route Descriptors: 021C 7FFC 0220 0000
       0000 0000 0000 0000

       Target Node MAC Address 00-00-C9-10-1B-F5 On Ring To display the source routing database entry that applies  to	a  destination	node  with
       address 00-00-c9-10-4a-f3, enter: srconfig -re 00-00-c9-10-4a-f3 Target Node MAC Address 00-00-C9-10-4A-F3 On Ring To specify a time period
       of 10 seconds during which your system runs the route discovery process for its target nodes, enter: srconfig -setd 10

SEE ALSO

       Network Administration

       Network Programmer's Guide

																       srconfig(8)