srconfig - Displays and controls source routing functions and parameters
for communication on token ring networks
The options are case insensitive; use uppercase, lowercase, or any combina-
tion. 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
Deletes the entry in the source routing database for the destination
(target) node that has the address mac_address. This option requires
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
+ 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
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 option
can be used with the -DElentry, -DISEntry, -REntry, and -RTable options
Sets the source routing counters to zero.
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 main-
tains 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
1. To display all the entries in your source routing database, enter:
Target Node MAC Address 00-00-0C-01-08-E9 (ip = 188.8.131.52) 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
Network Administration: Connections
Network Programmer's Guide