atmconfig(1M)atmconfig(1M)NAMEatmconfig - configure SGI OC-3c ATM port.
SYNOPSISatmconfig [ -i port# ] -l [ -vq ] [ -f firmware ] [ -b prom ]
atmconfig [ -i port# ] -V
atmconfig [ -i port# ] { -r | -d | -u }
atmconfig [ -i port# ] -s
atmconfig [ -i port# ] -T TST-size (Origin/Onyx2 only)
atmconfig [ -i unit# ] -Q queue# , bps (Challenge/Onyx only)
atmconfig [ -i unit# ] -R rl_bufs , rl_size [ , rs_bufs , rs_size ] ]
atmconfig [ -i unit# ] -X xl_bufs , xl_size [ , xs_bufs , xs_size ] ]
atmconfig [ -i port# ] -o phy-opts
atmconfig [ -i port# ] -m
atmconfig [ -i port# ] -a
atmconfig [ -i port# ] -F config-file
DESCRIPTION
The atmconfig command sets and displays configuration information for SGI
OC-3c ATM ports.
The options have the following meanings:
-v Verbose mode.
-q Quiet mode.
-i port#
Specifies a particular ATM port by port number. The default is port
0 (i.e. /hw/atm/0).
The following options control what function atmconfig will perform. They
have the following meanings:
-l Write the specified firmware file into the non-volatile flash EEPROM
on the specified ATM port. There are two copies of the firmware on
any 4-Port(Origin/Onyx2) device (one for ports 0 and 1, and one for
port 2 and 3). The write only occurs if the revision number of the
firmware installed on the interface and the firmware in the
firmware file are not equal. Typically, this function is only used
by the ATM start-up script /etc/init.d/atm.
-L This is the same option as -l but the firmware is rewritten
regardless of the version number present on the port.
-r sends a hardware reset to one of the two on-board processors on the
4-port interface in the Origin/Onyx2. This forces the port and the
port adjacent to it( port#+1 if the specified port # is even,
otherwise port#-1 ) into the pre-init state. On the Challenge/Onyx
platforms the specified port is forced to the pre-init state via a
hardware reset.
Page 1
atmconfig(1M)atmconfig(1M)-d puts the port in the down state. This can be done from either the
up (Challenge/Onyx only) or pre-init states. It is in this state
that the transmit schedule table can be adjusted. This command will
fail if any application programs still have file descriptors open
from the previous time the port was operational.
-u puts the port in the up state.
-V This option shows the version number of the firmware installed on
the port.
-s This option shows the buffer configuration, TST configuration
(Origin/Onyx2), and state of the port. If the state is pre-init,
the configuration will not be displayed.
-Q n,bps
Set rate queue n to bps bits per second. This can fail if any
application has virtual circuits using the rate queue.
(Challenge/Onyx only)
-R rl_bufs,rl_size[,rs_bufs,rs_size]]
Alter the configuration of receive buffers. This can only be done
when the interface is in the down state.
-X xl_bufs,xl_size[,xs_bufs,xs_size]]
Alter the configuration of transmit buffers. This can only be done
when the interface is in the down state.
-o phy-opt-bits
Sets the PHY option bits for the OC3c port. Bit 0 controls the
SONET loop-timing feature. When bit 0 is set with atmconfig-o 1
the SONET transmit clock is derived from the clock captured from the
SONET receiver (this is the default). This is the appropriate
setting when the ATM port is connected to a switch. When bit 0 is
cleared with atmconfig-o 0 the SONET transmit clock is derived from
a clock on the ATM-OC3c device. This configuration allows two OC-3c
ports to function when connected directly to each other without an
ATM switch. Other values used with the -o option are reserved for
diagnostic functions.
-m Show the permanent MAC address assigned to this port.
-a Show the ATM address assigned to this port.
-T TST-size
Adjust the size of the transmit schedule table. (Origin/Onyx2 only)
-F config-file
Read a file containing configuration parameters and set the port
parameters appropriately. Currently, the transmit schedule table
(TST) size and the PHY options are the only parameters that can be
put in the config file. This option is used by the initialization
Page 2
atmconfig(1M)atmconfig(1M)
script, /etc/init.d/atm, to set the TST size and PHY option bits at
system boot time using /var/atm/atmhw.conf as the configuration
file.
NOTE
After software upgrades, the system start-up scripts will update the
flash EEPROM automatically via atmconfig. Under normal circumstances, the
firmware should never need to be manually updated by an administrator.
Under normal conditions, atmconfig should not be used to shut down and
bring up ATM ports. The initialization file /etc/init.d/atm does a
better job of starting and stopping the entire ATM subsystem.
FILES
/usr/lib/atm/atmlincfw (ATM XIO 4-Port OC-3c firmware - Origin/Onyx2)
/usr/lib/atm/lincprom (ATM XIO 4-Port OC-3c prom - Origin/Onyx2)
/usr/lib/atm/atm_firm.o (ATM HIO OC-3c firmware - Challenge/Onyx)
/usr/lib/atm/flash.o (ATM HIO OC-3c prom - Challenge/Onyx)
/var/atm/atmhw.conf
SEE ALSOatm(7M), atmstat(1M), atmtest(1M)
Page 3