SVR5

mdi_get_mctable(D3mdi)

mdi_get_mctable -- Send multicast address state to MDI driver

Synopsis

   #include <sys/types.h>
   #include <sys/stream.h>
   #include <sys/stropt.h>
   #include <sys/mdi.h>
   #include <sys/ddi.h>
   
   mblk_t * mdi_get_mctable(void *mac_cookie);

Description

mdi_get_mctable( ) returns a STREAMS message block that contains the multicast address state to the MDI driver.

Arguments

mac_cookie: The mac_cookie value passed in the mac_bind_req structure returned by the MAC_BIND_REQ(D7mdi) primitive.

Return values

If successful, mdi_get_mctable( ) returns a pointer to a STREAMS msgb(D4str) structure that contains the mac_mcast(D4mdi) structure, followed by all multicast addresses that are valid for this driver. Returns NULL on failure.

Usage

mdi_get_mctable( ) relieves the driver of the responsibility of maintaining its own list of multicast addresses, although the mblk must returned by mdi_get_mctable( ) must be freed. However, this function only returns multicast addresses acknowledged by an M_IOCACK(D7str) from the driver. Therefore, when a MACIOC_SETMCA ioctl is passed to the driver, mdi_get_mctable( ) will not return the new multicast address. Similarly when a MACIOC_DELMCA ioctl is passed to the driver, mdi_get_mctable( ) returns a table that includes the multicast address being deleted.

Context and synchronization

All contexts

Hardware applicability

All

Version applicability

mdi: 2, 2.1

Differences between versions

This function is not supported in MDI on SCO OpenServer systems.

References

MAC_BIND_REQ(D7mdi), mac_mcast(D4mdi)