NAME

atmreg − ATM address registration

SYNOPSIS

/opt/SUNWatm/bin/atmreg interface [ -r | -d ] atm_address

AVAILABILITY

SUNWatmu

DESCRIPTION

atmreg communicates with the ILMI daemon, ilmid, which controls notifications to the switch of local address changes. The user may register new addresses, check the status of addresses, or de-register addresses.  A list of all registered addresses for an interface is printed in the output of qccstat(1M). 

The first parameter is the physical interface name. This should be specified in the form “device unit;” an example is ba0. If neither of the optional flags is specified, the status of atm_address is printed. atm_address may be either 20 or 7 colon-separated hexadecimal octets (2 characters), providing an entire ATM address or simply the local ESI and selector bytes.  If only 7 bytes are provided, the default 13-byte prefix assigned by the switch is assumed. 

OPTIONS

-r This flag specifies that the given address should be registered on this interface. As soon as the registration request has been sent to the switch, the program will return; therefore, the output of qccstat(1M) or atmreg with no flag should be checked to verify that the address has been successfully registered. The switch will fail an address registration request if the same address has already been registered by a different host. 

-d This flag specifies that the given address should be de-registered on this interface. As is the case with the -r flag, the atmreg program will exit as soon as the request has been sent to the switch, and successful de-registration should be verified with either qccstat(1M) or atmreg. 

EXAMPLES

The following example shows three operations: first, the status of an address is checked on an interface, which indicates that the address is not registered. Next, registration of the address is requested. Finally, another status request is sent to verify that the address was successfully registered. 

muskogee# atmreg sa0 08:00:20:aa:bb:cc:00            ATM address  45:00:00:00:00:00:00:00:0f:00:00:00:00:08:00:20:aa:bb:cc:00 is unknown on sa0. 

muskogee# atmreg sa0 -r 08:00:20:aa:bb:cc:00  Requested registration of ATM address on sa0:  45:00:00:00:00:00:00:00:0f:00:00:00:00:08:00:20:aa:bb:cc:00 

muskogee# atmreg sa0 08:00:20:aa:bb:cc:00             ATM address  45:00:00:00:00:00:00:00:0f:00:00:00:00:08:00:20:aa:bb:cc:00 is registered on sa0. 

SEE ALSO

ilmid(1M), qccstat(1M)

SunOS 2.0  —  Last change: 27 Oct 1995