Manpage of CD_INFO_REQ

CD_INFO_REQ

Section: Communications Device Interface (CDI) (7)
Updated: 2008-10-31
Index Return to Main Contents

NAME

CD_INFO_REQ - information request

SYNOPSIS

This primitive consists of one M_PROTO(9) or M_PCPROTO(9) message block structured as follows:

typedef struct {
    cd_ulong cd_primitive;
} cd_info_req_t;

DESCRIPTION

This user originated primitive requests that the provider acknowledge the primitive with a CD_INFO_ACK(7) primitive indicating protocol and option information.

Parameters

This primitive contains the following parameters:

cd_primitive: Specifies the primitives type.

State

This primitive is valid in any state other than CD_UNUSABLE where a local acknowledgement is not pending. The state is unchanged as a result of the primitive.

RESPONSE

This primitive requires the provider to acknowledge reciept of the primitive as follows:

Successful: When successful, the provider acknowledges the primitive with the CD_INFO_ACK(7).

Unsuccessful (non-fatal errors): When unsuccessful, the provider acknowledges the primitive with the CD_ERROR_ACK(7) indicating the reason for failure of the primitive.

ERRORS

Non-Fatal Errors: applicable non-fatal errors are as follows:

[CD_BADPRIM]: Unrecognized primitive.
[CD_FATALERR]: Device has become unusable.
[CD_NOTSUPP]: Primitive not supported by this device.
[CD_OUTSTATE]: Primitive was issued from an invalid state.
[CD_PROTOSHORT]: M_PROTO block too short.
[CD_SYSERR]: UNIX system error.

FILES

HISTORY

The Communications Device Interface first appeared in SVR 4[1].

CONFORMANCE

This interface conforms to CDI with Gcom extensions.

REFERENCES

[1]: SVR 4, UNIX® System V Release 4 Programmer's Manual, 1990, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[2]: Magic Garden, The Magic Garden Explained: The Internals of UNIX® System V Release 4 / An Open Systems Design, 1994, (Australia), B. Goodheart, J. Cox, Prentice Hall. [ISBN 0-13-098138-9]
[3]: Advanced Programming in the UNIX®Environment, 15th edition, December 1997, (Reading, Massachusetts), W. R. Stevens, Addison Wesley. [ISBN 0-201-56317-7]