DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
SVR5 and SCO OpenServer 5

MAC_BIND_REQ(D7mdi)


MAC_BIND_REQ -- Requests the MDI driver to enable transmission and receipt of MAC frames

Synopsis

   #include <sys/stream.h>
   #include <sys/mdi.h>
   

typedef struct mac_bind_req { ulong mac_primitive; void *mac_cookie; } mac_bind_req_t;

Description

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

A STREAM is viewed as active when a MAC_BIND_REQ has been successfully processed by the MDI driver and a DL_OK_ACK returned. No frames will be transmitted by the MDI driver on behalf of the MAC user, nor will any frames be received from the network and passed to the MAC user until a MAC_BIND_REQ has been successfully processed by the MDI driver.

Parameters


mac_primitive
conveys the MAC_BIND_REQ

mac_cookie
used as argument to the mdi_valid_mca(D3mdi) and mdi_get_mctable(D3mdi) functions.

State

The message is valid unless a MAC_BIND_REQ has already been successfully processed by the MDI driver.

Response

If the bind request is successful, MAC_OK_ACK(D7mdi).

If the bind request is unsuccessful, MAC_ERROR_ACK(D7mdi).

Reasons for Failure


MAC_OUTSTATE
The primitive was issued after a successful MAC_BIND_REQ (that is, the driver is already bound)

MAC_INITFAILED
The adapter hardware has failed since the MDI device was opened.

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