ntx_macaddr Command

Commands Reference, Volume 4

ntx_macaddr Command

Purpose

Configures the Network Terminal Accelerator (NTX) MAC-layer addresses.

Syntax

ntx_macaddr [-d Device ] [ -i Address ] [ -c ] [-m Address...]

Description

The ntx_macaddr command configures the adapter MAC-layer addresses. By default, this command displays the current individual and multicast addresses of the adapter specified by the /dev/rhp0 file. The addresses are sent to standard output. Addresses appear in hexadecimal notation (for example, 80:00:40:1a:22:f3).

By default, the adapter is configured with a single individual MAC address. This address uniquely identifies the adapter. The address is factory-supplied and the ntx_macaddr command allows you to change it using the -i flag.

Flags

-c	Clears the list of multicast addresses for which the adapter will receive frames.
-d Device	Identifies the adapter raw device file. The /dev/rhp0 file is the default.
-i Address	Specifies an individual MAC-layer address. This is the address for the adapter's IEEE 802.3 MAC-layer address. The least significant bits of this address must be clear. For example, a valid address would be `fe:ff:ff:ff:ff:ff`.
-m Address...	Adds a list of MAC-layer addresses as multicast addresses the adapter will receive. The least significant bits of these addresses must be set. You can only program a maximum of 32 multicast addresses at any one time.

Exit Status

This command returns the following exit values:

0	Successful completion.
>0	An error occurred.

Security

Access Control: You must have root authority to run this command.

Auditing Events: N/A

Examples

To add two multicast addresses, enter:

ntx_macaddr -d /dev/rhp1 -m 1:0:0:0:0:0 83:0:4:1a:2:f3

To clear the existing multicast addresses, change an individual address, and add a new multicast address, enter:
```
ntx_macaddr -c -i 0:80:0:70:0:1 -m 83:0:4:1a:2:00
```

Files

/usr/bin/ntx_macaddr	Contains the ntx_macaddr command.
/dev/rhp0	Default NTX raw device file name.

Related Information

The /dev/rhp file.

Network Terminal Accelerator Overview in AIX Versions 3.2 and 4 Asynchronous Communications Guide.