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