NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       /usr/sbin/srconfig [options]

OPTIONS    [Toc]    [Back]

       The options are case insensitive;  use  uppercase,  lowercase,
  or  any combination.  The short form of each option
       is indicated by capital letters. 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  superuser  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 routing database.  Each entry describes  the
       current  description  of the best path to the node.  There
       is no default value for mac_address.  Displays 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 privileges.  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
       privileges.   Specifies that the MAC addresses are in noncanonical
 form. This option can be used with  the  -DElentry,
  -DISEntry,  -REntry, and -RTable options only.  Sets
       the source routing counters to zero.

DESCRIPTION    [Toc]    [Back]

       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  system  maintains  a  source  routing
       database so token ring adapters,  for  example  tra0,  can
       find  the  route a message is to take to a remote destination.
  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    [Toc]    [Back]

       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    [Toc]    [Back]

       Network Administration: Connections

       Network Programmer's Guide



                                                      srconfig(8)