srconfig(8)srconfig(8)NAMEsrconfig - Displays and controls source routing functions and parame‐
ters for communication on token ring networks
SYNOPSIS
/usr/sbin/srconfig [options]
OPTIONS
The options are case insensitive; use uppercase, lowercase, or any com‐
bination. 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 superuser privileges.
Displays whether source routing is enabled. If enabled, it also dis‐
plays 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 Rout‐
ing 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 max‐
imum 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 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 sys‐
tem'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 exe‐
cutes 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 com‐
mands 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: Connections
Network Programmer's Guide
srconfig(8)
