[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Communications Technical Reference, Volume 1

DL_INFO_ACK Primitive

Purpose

Returns information about the Data Link Provider Interface (DLPI) stream in response to the DL_INFO_REQ primitive.

Structure

The message consists of one M_PCPROTO message block, which contains the following structure:

typedef struct 
{
   ulong dl_primitive;
   ulong dl_max_sdu;
   ulong dl_min_sdu;
   ulong dl_addr_length;
   ulong dl_mac_type;
   ulong dl_reserved;
   ulong dl_current_state;
   long dl_sap_length;
   ulong dl_service_mode;
   ulong dl_qos_length;
   ulong dl_qos_offset;
   ulong dl_qos_range_length;
   ulong dl_qos_range_offset;
   ulong dl_provider_style;
   ulong dl_addr_offset;
   ulong dl_version;
   ulong dl_brdcst_addr_length;
   ulong dl_brdcst_addr_offset;
   ulong dl_growth;
} dl_info_ack_t;

This structure is defined in /usr/include/sys/dlpi.h.

Description

The DL_INFO_ACK primitive returns information about the DLPI stream to the data link service (DLS). The DL_INFO_ACK primitive is a response to the DL_INFO_REQ primitive.

Parameters

dl_primitive Specifies the DL_INFO_ACK primitive.
dl_max_sdu Specifies the maximum number of bytes that can be transmitted in a data link service data unit (DLSDU). This value must be a positive integer greater than or equal to the value of the dl_min_sdu parameter.
dl_min_sdu Specifies the minimum number of bytes that can be transmitted in a DLSDU. The minimum value is 1.
dl_addr_length Specifies the length, in bytes, of the provider's data link service access point (DLSAP) address. For hierarchical subsequent binds, the length returned is the total length. The total length is the sum of the values for the physical address, service access point (SAP), and subsequent address length.
dl_mac_type Specifies the type of medium supported by this DLPI stream. Possible values include:
DL_CSMACD Indicates the medium is carrier sense multiple access with collision detection (ISO 8802/3).
DL_TPR Indicates the medium is token-passing ring (ISO 8802/5).
DL_ETHER Indicates the medium is Ethernet bus.
DL_FDDI Indicates the medium is a Fiber Distributed Data Interface.
DL_OTHER Indicates any other medium.
dl_reserved Indicates a reserved field, the value of which must be set to 0.
dl_current_state Specifies the state of the DLPI interface for the stream the DLS provider issues this acknowledgement.
dl_sap_length Indicates the current length of the SAP component of the DLSAP address. The specified value must be an integer. The absolute value of the dl_sap_length parameter provides the length of the SAP component within the DLSAP address. The value can be one of the following:
>0 Indicates the SAP component precedes the physical component within the DLSAP address.
<0 Indicates the physical component precedes the SAP component within the DLSAP address.
0 Indicates that no SAP has been bound.
dl_service_mode Specifies which service modes that the DLS provider supports if the DL_INFO_ACK primitive is returned before the DL_BIND_REQ primitive is processed. This parameter contains a bit-mask specifying the following value:
DL_CODLS Indicates connection-oriented DLS.
DL_CLDLS Indicates connectionless DLS.

Once a specific service mode has been bound to the stream, this field returns that specific service mode.

dl_qos_length The DLS provider does not support *_qos_* parameters. This value is set to 0.
dl_qos_offset The DLS provider does not support *_qos_* parameters. This value is set to 0.
dl_qos_range_length The DLS provider does not support *_qos_* parameters. This value is set to 0.
dl_qos_range_offset The DLS provider does not support *_qos_* parameters. This value is set to 0.
dl_provider_style Specifies the style of the DLS provider associated with the DLPI stream. The following provider class is defined:
DL_STYLE2 Indicates the DLS user must explicitly attach a PPA to the DLPI stream using the DL_ATTACH_REQ primitive.
dl_addr_offset Specifies the offset of the address that is bound to the associated stream. If the DLS user issues a DL_INFO_REQ primitive before binding a DLSAP, the value of the dl_addr_length parameter is set to 0.
dl_version Indicates the version of the supported DLPI.
dl_brdcst_addr_length Indicates the length of the physical broadcast address.
dl_brdcst_addr_offset Indicates where the physical broadcast address begins. The value of this parameter is the offset from the beginning of the PCPROTO block.
dl_growth Specifies a growth field for future use. The value of this parameter is 0.

States

Valid The primitive is valid in any state in response to a DL_INFO_REQ primitive.
New The resulting state is unchanged.

Implementation Specifics

This primitive is part of Base Operating System (BOS) Runtime.

Related Information

The DL_INFO_REQ primitive, DL_BIND_REQ primitive, DL_ATTACH_REQ primitive.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]