SVR5 and SCO OpenServer 5

MAC_HWFAIL_IND(D7mdi)

MAC_HWFAIL_IND -- Generated by the MDI driver when it detects a fatal hardware failure

Synopsis

   #include <sys/stream.h>
   #include <sys/mdi.h>
   
   typedef struct mac_hwfail_ind {
   	ulong		mac_primitive;
   } mac_hwfail_ind_t;

Description

The MAC_HWFAIL_IND message consists of one M_PCPROTO(D7str) message block. This primitive causes the DLPI module above the MDI driver to start the hardware recovery process. The MDI driver will be closed, re-opened, and then a MAC_BIND_REQ(D7mdi) message will be issued. After this has been processed by the MDI driver, the device should be operational once more.

In addition, the DLPI in HDK Technical Reference module will send this primitive automatically if it discovers that the MDI driver has not taken the first mblk_t off the queue in a configurable time period.

Sending a MAC_HW_FAIL_IND message initiates a failover if the system is configured to support failover. Drivers should be coded to send one of these messages whenever there is a chance that the card is unusable, such as if the network cable has fallen off.

Parameters

mac_primitive: conveys the MAC_HWFAIL_IND

State

This message can only be sent after a successful MAC_BIND_REQ. The MDI driver must send MAC_ERROR_ACK(D7mdi) messages, with mac_errno set to MAC_INITFAILED to indicate hardware failure conditions, until the MDI driver receives a MAC_BIND_REQ and responds with a MAC_OK_ACK(D7mdi).

Hardware applicability

All

Version applicability

mdi: 1, 2, 2.1

Differences between versions

For MDI version 1 on SCO OpenServer 5 systems, MAC_HWFAIL_IND is followed by the multicast address table.

References

Section MDI manual pages on OpenServer 6, Section 7mdi manual pages on UnixWare 7.1.4

``Failover (Network cards)'' in HDK Technical Reference