macadmin(1M) (RM400 only) macadmin(1M)
NAME
macadmin - display/modify a MAC interface
SYNOPSIS
macadmin [madge] Format 1
macadmin del madge[cid] [force] Format 2
macadmin add madgecid PCIslotno | EISAslotno Format 3
macadmin mod madgecid [ringspeed] [cabletype] Format 4
macadmin [dfe] Format 5
macadmin del dfe[cid] [force] Format 6
macadmin add dfecid PCIslotno | EISAslotno Format 7
macadmin mod dfecid {ON | OFF} Format 8
macadmin [zx] Format 9
macadmin del zx[cid] [force] Format 10
macadmin add zxcid PCIslotno Format 11
macadmin mod zxcid [ringspeed] [transmit-mode] Format 12
DESCRIPTION
macadmin allows you to display and modify the configuration data
stored in the NVRAM in relation to ring speed and cable type for Token
Ring interfaces, full duplex mode for FDDI interface as well as ring
speed and transmit mode for Fast Ethernet interfaces.
OPTIONS
Format 1: Display data (madge)
Invoking macadmin without parameters has the same effect as the
updchannelid -l command [see updchannelid(8)], i.e. a table of all
channel Ids is output.
Invoking
macadmin madge
restricts the output to token ring boards. The data in the speed and
cable fields for ring speed and cable type is then displayed in plain
text. The lowest bit represents the ring speed (0 = 16 Mbit/s, 1 = 4
Mbit/s), and the next bit the cable type (0 = STP, 1 = UTP).
Page 1 Reliant UNIX 5.44 Printed 11/98
macadmin(1M) (RM400 only) macadmin(1M)
Format 2: Delete data (madge)
macadmin can be used to delete NVRAM explicitly:
macadmin del madge[cid] [force]
This forces either one entry (if the channel Id cid is specified) or
all entries in the TOKEN class to be deleted after a query (which can
be disabled with the force option).
Format 3: Add new entries (madge)
macadmin can also be used to add new entries in NVRAM:
macadmin add madgecid PCIslotno | EISAslotno
The specified slot is configured with a madge board with the channel
Id cid if the slot and specified channel Id were previously not
assigned.
The default values for ring speed and cable type are 16 Mbit/s and STP
respectively.
Format 4: Modify entries (madge)
Finally, macadmin can be used to modify the settings for ring speed
and cable type in existing entries. The following values are permitted
here:
macadmin mod madgecid {4|16} {UTP|STP}
Both parameters can be set at the same time.
Format 5: Display data (dfe)
Invoking macadmin without parameters has the same effect as the
updchannelid -l command [see updchannelid(8)], i.e. a table of all
channel Ids is output.
Invoking
macadmin dfe
limits the output to FDDI boards. The data in the option field pro-
vides information on the configuration of full duplex mode, where 0x1
means that the mode is activated and 0x0 that it is deactivated.
Page 2 Reliant UNIX 5.44 Printed 11/98
macadmin(1M) (RM400 only) macadmin(1M)
Format 6: Delete data (dfe)
Invoking
macadmin del dfe[cid] [force]
deletes either a single entry (if the cid channel ID was specified) or
all entries in the FDDI class following consultation (that can be dis-
abled with the force option).
Format 7: Add new entries (dfe)
Invoking
macadmin add dfecid PCIslotno | EISAslotno
assigns the specified slot an FDDI board with the cid channel ID if
the slot and the specified channel ID were previously free.
The default for configuring an FDDI interface is that full duplex mode
be disabled.
Format 8: Enable/disable full duplex mode for FDDI (dfe)
Invoking
macadmin mod dfecid {ON | OFF}
enables or disables full duplex mode. To activate this mode, stop the
interface and start it again.
Format 9: Display data (zx)
Invoking macadmin without parameters has the same effect as the
updchannelid -l command [see updchannelid(8)], i.e. a table of all
channel Ids is output.
Invoking
macadmin zx
limits the output to Fast Ethernet boards, e.g.:
#
#slot.subchannel, channelid, classcode, driver, option, comment
#
PCI#4/4, 2, ETHER, zx, 0x00, ETHER ZNYX 21140 V34
PCI#4/5, 3, ETHER, zx, 0x86, ETHER ZNYX 21140 V34
PCI#4/6, 4, ETHER, zx, 0x00, ETHER ZNYX 21140 V34
PCI#4/7, 5, ETHER, zx, 0x00, ETHER ZNYX 21140 V34
Page 3 Reliant UNIX 5.44 Printed 11/98
macadmin(1M) (RM400 only) macadmin(1M)
The selected ring speed and transmit mode are displayed in the option
parameter 0xAB:
A = 0 : No entry, default value applies
4 : FIFO threshold 128/72 Bytes (100 Mbits or 10 Mbits)
5 : FIFO threshold 256/96 Bytes
6 : FIFO threshold 512/128 Bytes
7 : FIFO threshold 1024/160 Bytes (default in
/etc/conf/pack.d/zx/space.c)
8 : Store&Forward mode
B = 0 : No entry, default value applies
1 : 10 Mbits
4 : 10-Mbit Full Duplex
5 : 100 Mbits
6 : 100-Mbit Full Duplex
F : Autonegotiation
(In the above example, zx3 in PCI#4/5 was set to Store&Forward mode
and 100-Mbit Full Duplex.)
Format 10: Delete data (zx)
macadmin can be used to delete NVRAM explicitly:
macadmin del zx[cid] [force]
This forces either one entry (if the channel Id cid is specified) or
all entries in the ZX class to be deleted after a query (which can be
disabled with the force option).
Format 11: Add new entries (zx)
Invoking
macadmin add zxcid PCIslotno
assigns the specified slot an Fast Ethernet board with the cid channel
ID if the slot and the specified channel ID were previously free.
The defaults for a Fast Ethernet interface are defined by the entries
in the /etc/conf/pack.d/zx/space.c file.
Format 12: Configuration (zx)
Invoking the
macadmin mod zxcid [ringspeed] [transmit-mode]
command allows the ring speed and transmit mode to be set for a Fast
Ethernet interface. If a parameter is missing, the default from the
/etc/conf/pack.d/zx/space.c file is taken.
Page 4 Reliant UNIX 5.44 Printed 11/98
macadmin(1M) (RM400 only) macadmin(1M)
Parameters for ringspeed:
AUTO : Autonegotiation
10 : Twisted Pair 10 Mbits
10FD : Twisted Pair 10-Mbit Full Duplex
100 : 100-Mbit BaseTX
100FD : 100-Mbit BaseTX Full Duplex
NONE : Default from /etc/conf/pack.d/zx/space.c is valid
Parameters for transmit-mode:
F0 : FIFO threshold 128 for 100 Mbits or 72 Bytes for 10 Mbits
F1 : FIFO threshold 256/96 Bytes
F2 : FIFO threshold 512/128 Bytes
F3 : FIFO threshold 1024/160 Bytes (default in
/etc/conf/pack.d/zx/space.c)
SF : Store&Forward mode
FNONE : Default from /etc/conf/pack.d/zx/space.c is valid
EXAMPLES
Example 1: Display and modify data
The
macadmin madge
command produces the following output:
#
#slot, channelid, classcode, driver, speed, cable, comment
#
EISA#1, 0, TOKEN, , 16Mbit STP
PCI#11, 1, TOKEN, , 16Mbit STP
PCI#5, 2, TOKEN, madge, 16Mbit STP TOKEN MADGE Smart 16
PCI#12, 3, TOKEN, , 4Mbit UTP
The
macadmin mod madge2 4 UTP
command sets the board in slot PCI5 to ring speed 4 Mbit/s and cable
type UTP.
macadmin madge
shows the successful result:
Page 5 Reliant UNIX 5.44 Printed 11/98
macadmin(1M) (RM400 only) macadmin(1M)
#
#slot, channelid, classcode, driver, speed, cable, comment
#
EISA#1, 0, TOKEN, , 16Mbit STP
PCI#11, 1, TOKEN, , 16Mbit STP
PCI#12, 3, TOKEN, , 4Mbit UTP
PCI#5, 2, TOKEN, madge, 4Mbit UTP TOKEN MADGE Smart 16
Example 2: Delete data
The
macadmin del madge
command deletes all entries for token ring boards. The following out-
put is then returned by
macadmin madge
#
#slot, channelid, classcode, driver, speed, cable, comment
#
Entries can be deleted specifically if the channel Id is specified:
macadmin del madge2
The following output is then returned by
macadmin madge
#
#slot, channelid, classcode, driver, speed, cable, comment
#
EISA#1, 0, TOKEN, , 16Mbit STP
PCI#11, 1, TOKEN, , 16Mbit STP
PCI#12, 3, TOKEN, , 4Mbit UTP
NOTES
Changes made in the NVRAM with the macadmin command are only effective
after a reboot.
SEE ALSO
ullcadmin(1M), madge(5), nvram(7), updchannelid(8).
Page 6 Reliant UNIX 5.44 Printed 11/98