Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP DLPI Programmer's Guide: HP-UX 11i v2 > Chapter 2 DLPI Primitives

Raw Mode Service Primitives

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

This section describes the raw mode service primitives.

DL_HP_RAWDATA_REQ

Requests the DLS provider to send one completely formatted DLSDU to a peer DLS user. The DLSDU is assumed to have a complete Link and MAC Level header included.

As with connectionless data transfer, raw mode is an unacknowledged service, and the DLS provider makes no guarantees of delivery of connectionless DLSDUs. It is the responsibility of the DLS user to do any necessary sequencing or retransmission of DLSDUs in the event of a presumed loss.

Format

The message consists of one M_PROTO message block containing the structure shown below, followed by one or more M_DATA message blocks containing at least one byte of data. The amount of user data that may be transferred in a single DLSDU is limited. This limit is conveyed by the parameter dl_max_sdu in the DL_INFO_ACK primitive.

typedef struct {
ulong dl_primitive;
} dl_hp_rawdata_req_t;

Parameters

dl_primitive

  • DL_HP_RAWDATA_REQ

State

The message is valid in state DL_IDLE.

New State

The resulting state is unchanged.

Response

If the DLS provider accepts the data for transmission, there is no response. This does not, however, guarantee that the data will be delivered to the destination DLS user, since the connectionless data transfer is not a confirmed service.

If the request is erroneous, a DL_ERROR_ACK is returned, and the resulting state is unchanged.

Reasons for Failure

DL_BADPRIM

  • Request was issued from a state in which the DL_HP_RAWDATA_REQ was not recognized.

DL_SYSERR

  • A system error has occurred and the UNIX system error is indicated in the DL_ERROR_ACK.

    The UNIX error returned may be set to (not limited to) errors listed in Table 2-2 “Error Return Values”.

DL_HP_RAWDATA_IND

Conveys one completely formatted DLSDU from the DLS provider to the DLS user. The DLSDU contains the complete Link and MAC Level headers.

Format

The message consists of one M_PROTO message block containing the structure shown below, followed by one or more M_DATA message blocks containing at least one byte of data. The amount of user data that may be transferred in a single DLSDU is limited. This limit is conveyed by the parameter dl_max_sdu in the DL_INFO_ACK primitive.

typedef struct {
ulong dl_primitive;
} dl_hp_rawdata_ind_t;

Parameters

dl_primitive

  • DL_HP_RAWDATA_IND

State

The message is valid in state DL_IDLE.

New State

The resulting state is unchanged.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2007 Hewlett-Packard Development Company, L.P.