Index for Section 8

Alphabetical listing for S

srconfig(8)
NAME
  srconfig - Displays and controls source routing functions and parameters
  for communication on token ring networks

SYNOPSIS
  /usr/sbin/srconfig  [options]

FLAGS
  The flags are case insensitive; use uppercase, lowercase, or any
  combination. The short form of each flag is indicated by capital letters.
  For example -DElentry can be shortened to -de and -Enasr can be shortened
  to -e.

  -DElentry mac_address
	    Deletes the entry in the source routing database for the
	    destination (target) node that has the address mac_address.	 This
	    option requires superuser privileges.

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

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

  -RCounter Displays the following counters that are associated with the
	    source routing database:

	      ·
	      All Routes Explore (ARE) frames sent

	      ·
	      ARE frames received

	      ·
	      Route discovery failures

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

  -RTable   Displays all entries in the source routing database.  (See -re
	    flag.)

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

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

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

  -u	    Specifies that the MAC addresses are in non-canonical form. This
	    flag can be used with the -DElentry, -DISEntry, -REntry, and
	    -RTable flags only.

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

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

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

RELATED INFORMATION
  Network Administration

  Network Programmer's Guide