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