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
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005