DLPI_ENABMULTI(3DLPI) Data Link Provider Interface Library Functions


NAME


dlpi_enabmulti, dlpi_disabmulti - enable or disable DLPI multicast
messages for an address

SYNOPSIS


cc [ flag... ] file... -ldlpi [ library... ]
#include <libdlpi.h>

int dlpi_enabmulti(dlpi_handle_t dh, const void *addrp,
size_t addrlen);


int dlpi_disabmulti(dlpi_handle_t dh, const void *addrp,
size_t addrlen);


DESCRIPTION


The dlpi_enabmulti() function enables reception of messages destined to
the multicast address pointed to by addrp on the DLPI link instance
associated with DLPI handle dh. The DLPI link instance will pass up only
those messages destined for enabled multicast addresses. This operation
can be performed in any DLPI state of a handle.


The dlpi_disabmulti() function disables a specified multicast address
pointed to by addrp on the DLPI link instance associated with DLPI handle
dh. This operation can be performed in any DLPI state of a handle.

RETURN VALUES


Upon success, DLPI_SUCCESS is returned. If DL_SYSERR is returned, errno
contains the specific UNIX system error value. Otherwise, a DLPI error
value defined in <sys/dlpi.h> or DLPI_EINHANDLE is returned.

ERRORS


DLPI_EBADMSG
Bad DLPI message


DLPI_EINHANDLE
Invalid DLPI handle


DLPI_EINVAL
Invalid argument


DLPI_ETIMEDOUT
DLPI operation timed out


ATTRIBUTES


See attributes(5) for description of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+

SEE ALSO


libdlpi(3LIB), attributes(5)


August 22, 2007 DLPI_ENABMULTI(3DLPI)