wanadm(1M) DG/UX R4.11MU05 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. With the exception of requesting statistics
and configuration information, you must have appropriate privilege.
On a generic DG/UX system, appropriate privilege is granted by having
an effective UID of 0 (root). See the appropriate_privilege(5) man
page for more information.
On a system with DG/UX information security, appropriate privilege is
granted by having one or more specific capabilities enabled in the
effective capability set of the user. See the cap_defaults(5) man
page for more 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
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 or loopback mode
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)
3 internal loopback (apsy only)
internally connect transmit data to
receive data
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
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.
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.
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/apsy01 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/apsys01
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 1 of the interface supported by the /dev/apsys01 device.
wanadm -v -s display=20 -l 1 -d /dev/apsys01
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), izscd(7), appropriate_privilege(5),
apsy(7).
NOTES
This command does not support the ssid(7) sync driver.
Licensed material--property of copyright holder(s)