DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
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)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005