wanadm(1M) DG/UX 5.4.2 wanadm(1M)
NAME
wanadm - wide area network administration
SYNOPSIS
wanadm [-v] [-c config sub-options]
[-s statistics sub-options]
[-i interface sub-options] -l line -d device
DESCRIPTION
Wanadm provides a user interface for directly managing a wide area
network. This command is used for configuration, statistics, and
interface management. Only superuser is allowed to use this command
with the exception of requesting statistics and configuration
information.
Options are specified as follows:
-o option1=value1,option2=value2,option3,...
where -o is one of the options listed below, option1,option2, and
option3 are sub-options listed below each option, and value and
value2 are values assigned to the sub-options. Not all sub-options
require assigned values as is the case with option3. Sub-options may
be listed in any order.
Options are:
-v Specify verbose mode. If verbose is specified, extra
information about the operation is displayed to standard
output.
-c Configuration management. Specify configuration
management sub-options.
defaults Display the default configuration. These
values will be used for all wan
configuration parameters which are not
explicitly overwritten.
get Display the current wan configuration. The
wan interface must be configured prior to
issuing this sub-option.
set Set a new wan configuration. The wan
interface must be in a "stopped" state
prior to issuing this sub-option.
The following sub-options are used in conjunction with
the set sub_option to override the default configuration
parameters. Any of the following wan configuration sub-
options not specified will be defaulted.
baud=n Specifies the baud rate in bits per second.
This parameter is only valid for internal
Licensed material--property of copyright holder(s) 1
wanadm(1M) DG/UX 5.4.2 wanadm(1M)
or split clock source configurations. The
following is a list of supported baud
rates.
1200 19200
2400 38400
4800 56000
9600 64000
Default: 9600
clk=n Specify the clock source as follows:
0 external clock
receive clock on 15 (TC)
receive clock on 17 (RC)
1 internal clock
tie BRG to transmitter (TxC)
tie BRG to receiver (RxC)
generate clock on 24 (Ext TC)
2 split clock
tie BRG to transmitter (TxC)
receive clock on 17 (RC)
generate clock on 24 (Ext TC)
Default: external clock
maxframe=n Specified maximum size for transmit and
receive frames to be processed through the
wan interface.
Default: 512
dsrtimer=n DSR timer value. The number of 10 ms ticks
to wait for DSR to be detected after
asserting DTR.
Default: 100
ctstimer=n CTS timer value. The number of 10 ms ticks
to wait for CTS to be detected after
asserting RTS.
Default: 100
flags=n The minimum number of flags that will
appear between the last non-flag byte of
one frame and the first non-flag byte of
the next. A value of 0 or 1 constitute
flag sharing.
Default: 0
Licensed material--property of copyright holder(s) 2
wanadm(1M) DG/UX 5.4.2 wanadm(1M)
station=n Station address to match at the hardware
level. Specifies the specific address that
the communications chip will recognize. For
specific address recognition to function,
this field AND the match_address field MUST
BOTH be set.
Default: 0x00
nrzi=n Selects the encoding method used for data
communication as follows:
0 NRZ encoding.
1 NRZI encoding.
Default: NRZ encoding
switched=n Selects RTS operating mode as follows:
0 Continuous RTS.
1 Switched RTS.
Default: Continuous RTS
NOTE: The line idle condition of a switched
RTS line will be marked (all ones). The
line idle condition of a continuous RTS
line will be flags (0x7E).
matchaddr=n Selects specific address match as follows:
0 All frames regardless of their
address will be accepted.
1 Only those frames whose addresses
match the address set in the
station_address will be accepted.
Default: Accept all frames
NOTE: If match_address is selected, the
specific address to be accepted MUST be
specified in the station_address field.
broadcast=n Selects whether broadcast (global)
addresses will be accepted as follows:
0 Broadcast addresses will not be
accepted.
1 Implies broadcast addresses (0xFF)
will be accepted.
Licensed material--property of copyright holder(s) 3
wanadm(1M) DG/UX 5.4.2 wanadm(1M)
Default: Do not accept broadcast address
events=n Selects the processing of wan events as
follows:
0 Only non-errored messages including
over sized messages will be
returned.
1 All "events" supported by the sync
driver will be returned.
Default: Only non-errored messages will be
returned
NOTE: Frames containing buffer overflow
condition will be delivered regardless of
the condition of this flag.
-s Statistics Management. Specify statistics management
sub-options.
display Display the latest statistics from the wan
interface.
display=n Continuously display the latest statistics
from the wan interface every n seconds.
clear Clear or zero the wan interface statistics
counters.
displayclear Display the latest statistics from the wan
interface and clear or zero the wan
interface statistics counters.
-i Interface Management. Specify interface management sub-
options.
start Start the wan interface. This must be done
prior to performing I/O operations.
However, this is usually done directly by
wan interface users.
stop Stop the wan interface. This is usually
done directly by wan interface users.
-l line The line number of the wan interface to be managed.
-d device The sync driver clone device for the wan interface to be
managed. The clone device name should be of the form
/dev/devicesbb, where device is the name of the device, s
identifies the device as a cloneable device, and bb is
the controller number.
Licensed material--property of copyright holder(s) 4
wanadm(1M) DG/UX 5.4.2 wanadm(1M)
EXAMPLES
The following is an example of a typical wanadm command used to issue
a new wan configuration to line 0 of the interface supported by the
/dev/vsxb01 device. In this example, we will overwrite the wan
configuration defaults for baud rate, clock source, and RTS operating
mode.
wanadm -v -c set,baud=56000,clk=1,switched=1 -l 0 -d /dev/vsxbs01
The following is an example of a typical wanadm command used to get
the current wan configuration from line 2 of the interface supported
by the /dev/vsxb01 device.
wanadm -c get -l 2 -d /dev/vsxbs01
The following is an example of a typical wanadm command used to get
the current wan statistics from line 1 of the interface supported by
the /dev/vsxb01 device.
wanadm -v -s display -l 1 -d /dev/vsxbs01
The following is an example of a typical wanadm command used to
continuously get the current wan statistics every 20 seconds from
line 2 of the interface supported by the /dev/vsxb01 device.
wanadm -v -s display=20 -l 2 -d /dev/vsxbs01
The following is an example of a typical wanadm command used to stop
line 0 of the wan interface supported by the /dev/vsxb01 device.
wanadm -v -i stop -l 0 -d /dev/vsxbs01
SEE ALSO
syncadm(1M), vsxb(7), iscd(7).
NOTES
This command does not support the ssid(7) sync driver.
Licensed material--property of copyright holder(s) 5