LAN(4) —
NAME
lan − IBM RT PC Token-Ring Adapter
SYNOPSIS
For the IBM RT PC:
controller lanc0 at iocc0 csr 0xf00001c0 priority 12
device lan0 at lanc0 drive 0
For the IBM 6152 Academic System:
devicelan0at iocc0 csr 0x00000a20 priority 9
devicelan1at iocc0 csr 0x00000a24 priority 10
DESCRIPTION
The lan interface provides access to the IBM local area network, a token-ring, star-wired network accommodating up to 260 attaching devices.
On the IBM RT PC, the hardware has 16k bytes of RAM, of which 4k bytes are used for transmit buffers and 12k for receive buffers. Simultaneous transmission and reception of data are supported. The adapter operates as a DMA bus master. The use of trailers is negotiated with ARP. This negotiation may be disabled on a per-interface basis by setting the IFF_NOTRAILERS flag with an SIOCSIFFLAGS ioctl.
The host’s Internet address is specified at boot time with an SIOCSIFADDR ioctl. The lan interface uses the address resolution protocol described in arp(4P) to map dynamically between Internet and token-ring addresses on the local network.
On the IBM 6152 Academic System, the interface has 8K bytes of expansion RAM, of which 3K bytes are used for transmit buffers and 5K for receive buffers. Simultaneous transmission and reception of data are supported.
The lan interface uses the address resolution protocol, described in arp(4P), to map dynamically between Internet and token-ring addresses on the local network.
The lan driver uses the new token ring packet format (the bridge and snap options on) as the default configuration.
DIAGNOSTICS
For the IBM RT PC:
lan%d: address xx:xx:xx:xx:xx:xx The hardware address used to open the adapter is displayed.
lan%d: token ring adapter initialization failure, status = 0x%b, error code = 0x%x. An unrecoverable hardware error has occurred during initialization of the adapter.
If status indicates TEST and ERR, the bring-up diagnostic error codes are:
CodeDescription
XX30 or XXB0Initial test error
XX31 or XXB1ROM CRC error
XX32 or XXB2RAM error
XX33 or XXB3Instruction test error
XX34 or XXB4Context/interrupt test error
XX35 or XXB5Protocol handler hardware error
XX36 or XXB6System interface register error
If status indicates INIT and ERR, the initialization error codes are:
CodeDescription
XX58 or XXD8DIO parity error
XX59 or XXD9DMA timeout
XX5A or XXDADMA parity error
XX5B or XXDBDMA bus error
XX5C or XXDCDMA data error
XX5D or XXDDAdapter check
lan%d: dma channel %x. The adapter has not gained exclusive use of the necessary system dma channel. The adapter is unusable.
lan%d: unrecoverable token ring adapter failure, interrupt code = 0x%x, parm0=0x%x, parm1=0x%x, parm2=0x%x. An unrecoverable adapter error has occurred.
CodeParm0Parm1Parm2Description
0001∗∗∗Program Check
0002R13R14R15Invalid XOP
0004R13R14R15Invalid Error Interrupt
0008R13R14R15Invalid Interrupt
0010XXXXXXXXXXXXRing Overrun
0020XXXXXXXXXXXXRing Underrun
0040R13R14R15XMIT Parity Error
0080R13R14R15RECV Parity Error
0100R13R14R15PH Parity Error
0200R13R14R15RIF Parity Error
0400R13R14R15EM Parity Error
0800R13R14R15LB Parity Error
1000R13R14R15Illegal Op Code
20000000Sys AddressSys AddressDMA Write Abort - timeout
20000001Sys AddressSys AddressDMA Write Abort - parity error
20000002Sys AddressSys AddressDMA Write Abort - bus error
40000000Sys AddressSys AddressDMA Read Abort - timeout
40000001Sys AddressSys AddressDMA Read Abort - parity error
40000002Sys AddressSys AddressDMA Read Abort - bus error
8000XXXXXXXXXXXXDIO Parity Error
∗ -- is an abend code containing information about the program check.
lan%d: single station on network. The adapter can transmit/receive frames only to/from itself. This state is normal for the first station on the ring; however, it also occurs when the adapter is not inserted on the ring.
lan%d: hardware error, adapter removed from ring.
lan%d: beaconing. A break has occurred in the ring between this station and its nearest addressable upstream neighbor. The ring is in an automatic process of being restored.
lan%d: cable failure. The cable connecting the adapter to the ring is either open or shorted. The driver will attempt to reopen the adapter after 60 seconds.
lan%d: removed from network. A remove MAC (Media Access Control) frame was received from an authorized LAN Manager. The adapter is closed and removed from the ring.
lan%d: node address error. An error was detected in the address used in opening the adapter. The adapter remains closed.
lan%d: open err = 0x%x, function failure. Hardware failure detected during open processing. This may be due to a cable problem. The driver will attempt to reopen the adapter up to 3 times.
lan%d: open err = 0x%x, receiver exception. A loss of signal has been detected at receiver input. The driver will attempt to reopen the adapter after 60 seconds.
lan%d: open err = 0x%x, ring failure. The driver will attempt to reopen the adapter after 60 seconds.
lan%d: open err = 0x%x, ring beaconing. The driver will attempt to reopen the adapter after 60 seconds.
lan%d: open err = 0x%x, duplicate node address. Two stations on the ring have the same physical address. The adapter remains closed.
lan%d: open err = 0x%x, timeout. The adapter failed to insert onto the ring within 18 seconds. The driver will attempt to reopen the adapter up to 3 times.
lan%d: open err = 0x%x, request parameters. The ring parameter server failed to respond to a request-initialization MAC (Media Access Control) frame. The driver will attempt to reopen the adapter up to 3 times.
lan%d: open err = 0x%x, remove received. The adapter remains closed.
lan%d: command reject, internal software error, reject reason = 0x%x.
lan%d: adapter jammed. The adapter has not cleared the system control block within 5 seconds. The state of the adapter is unknown.
lan%d: can’t handle af%d. The interface was handed a message with address formatted in a unsuitable address family; the packet was dropped.
For the IBM 6152 Academic System:
lan%d: adapter check. The adapter has encountered an unrecoverable error and is detached from the ring.
lan%d: adapter error. An unexpected adapter timer interrupt, adapter machine check, adapter deadman timer interrupt, 40-millisecond timer overrun, shared RAM access violation or an illegal operation to an attachment control area register has occurred.
lan%d: ARB new ring status = 0x%x. The adapter is reporting a new ring status. See "Ring Status" in the "Technical Reference Token-Ring Network PC Adapter" IBM Personal Computer Hardware Reference Library.
lan%d: can’t handle af%d. The interface was handed a message with addresses formatted in an unsuitable address family; the packet was dropped.
SEE ALSO
PRPQs 5799-WZQ/5799-PFF: IBM/4.3 — Dec 1987