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:

See Also

libdlpi(3LIB), attributes(5)