[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Communications Technical Reference, Volume 1

DL_PHYS_ADDR_REQ Primitive

Purpose

Requests that the data link service (DLS) provider return the current value of the physical address associated with the stream.

Structure

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

typedef struct 
{
   ulong dl_primitive;
   ulong dl_addr_type;
} dl_phys_addr_req_t;

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

Description

The DL_PHYS_ADDR_REQ primitive requests that the DLS provider return the current value of the physical address associated with the stream.

Parameters

dl_primitive Specifies the DL_PHYS_ADDR_REQ primitive.
dl_addr_type Specifies the requested address. The value is:
DL_CURR_PHYS_ADDR Current physical address.

States

Valid The primitive is valid in any attached state in which a local acknowledgment is not pending. For a style 2 DLS provider, this is after a PPA is attached using the DL_ATTACH_REQ provider.
New The resulting state is unchanged.

Acknowledgments

Successful The DL_PHYS_ADDR_ACK primitive is sent to the DLS user.
Unsuccessful The DL_ERROR_ACK primitive is returned to the DLS user.

Error Codes

DL_NOTSUPPORTED Indicates the primitive is known but not supported by the DLS provider.
DL_OUTSTATE Indicates the primitive was issued from an invalid state.
DL_UNSUPPORTED Indicates the requested address type is not supplied by the DLS provider.
DL_SYSERR Indicates a system error occurred and the provider did not have access to the physical address.

Implementation Specifics

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

Related Information

The DL_PHYS_ADDR_ACK primitive, DL_ERROR_ACK primitive.


[ Previous | Next | Contents | Glossary | Home | Search ]