unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



srconfig(8)							  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 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
  -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 option.)

  -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 option
      can be used with the -DElentry, -DISEntry, -REntry, and -RTable options
      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 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
  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



SEE ALSO

  Network Administration: Connections

  Network Programmer's Guide