SVR5 and SCO OpenServer 5

MAC_ERROR_ACK(D7mdi)

MAC_ERROR_ACK -- Acknowledges to the MAC user that a previously issued request primitive was received but caused an error

Synopsis

   #include <sys/stream.h>
   #include <sys/mdi.h>
   
   typedef struct mac_error_ack {
   	ulong	mac_primitive;
   	ulong	mac_error_primitive;
   	ulong	mac_errno;
   } mac_error_ack_t;

Description

The MAC_ERROR_ACK message consists of one M_PCPROTO(D7str) message block.

MAC_ERROR_ACK informs the MAC user that a previously issued request primitive was received but caused an error. It conveys the identity of the primitive in error and an MDI error code.

Whenever this primitive is generated, it indicates that the MDI state is identical to what it was before the erroneous request or response.

Parameters

mac_primitive

conveys the MAC_ERROR_ACK(D7mdi)

mac_error_primitive

identifies the received MDI primitive that is being acknowledged.

mac_errno

conveys the MDI error code associated with the failure. Applicable error codes are:

MAC_OUTSTATE: The primitive was issued from an illegal state.
MAC_BADPRIM: The primitive was not known by the MDI driver.
MAC_INITFAILED: The adapter hardware has failed since the MDI device was opened.

NOTE: There is no error code to report system resource limitation problems. If an MDI driver is unable to allocate sufficient STREAMS blocks to process MDI data, these frames should be dropped and no message issued. STREAMS records allocb( ) failures and these errors will show up in STREAMS statistics monitoring utilities; for example, crash and rtpm on SVR5 systems, and crash(ADM) and netstat(TC) with the -m option on SCO OpenServer 5 systems.

State

The message is valid in every state where an acknowledgement or confirmation of previous request or response is pending.

Hardware applicability

All

Version applicability

mdi: 1, 2, 2.1

References

Section MDI manual pages on OpenServer 6, Section 7mdi manual pages on UnixWare 7.1.4, mdi_macerrorack(D3mdi)