DL_ENABMULTI_REQ(7dlpi) DL_ENABMULTI_REQ(7dlpi)
NAME
DL_ENABMULTI_REQ - Message Type
SYNOPSIS
The message consists of one M_PROTO message block, which
contains the following structure:
typedef struct {
ulong dl_primitive;
ulong dl_addr_length;
ulong dl_addr_offset;
} dl_enabmulti_req_t;
DESCRIPTION
Requests the DLS Provider to enable specific multicast
addresses on a per Stream basis. It is invalid for a DLS
Provider to pass upstream messages that are destined for any
address other than those explicitly enabled on that Stream by
the DLS User.
Parameters
dl_primitive conveys DL_ENABMULTI_REQ
dl_addr_length
conveys the length of the multicast address
dl_addr_offset
conveys the offset from the beginning of the
M_PROTO message block where the multicast address
begins
State
This message is valid in any state in which a local
acknowledgement is not pending with the exception of
DL_UNATTACH.
New State
The resulting state is unchanged.
Response
If the enable request is successful, a DL_OK_ACK is sent to
the DLS user. If the request fails, message DL_ERROR_ACK is
returned and the resulting state is unchanged.
Copyright 1994 Novell, Inc. Page 1
DL_ENABMULTI_REQ(7dlpi) DL_ENABMULTI_REQ(7dlpi)
Reasons for Failure
DL_BADADDR Address information was invalid or was in an
incorrect format.
DL_TOOMANY Too many multicast address enable attempts. Limit
exceeded.
DL_OUTSTATE The primitive was issued from an invalid state
DL_NOTSUPPORTED
The primitive is known, but not supported by the
DLS Provider.
Category
Local Management.
Copyright 1994 Novell, Inc. Page 2