Manpage of T_UNBIND_REQ

T_UNBIND_REQ

Section: Transport Provider Interface (TPI) (7)
Updated: 2008-10-31
Index Return to Main Contents

NAME

T_UNBIND_REQ - Unbind Protocol Address Request

SYNOPSIS

This message consists of a M_PROTO message block formatted as follows:

struct T_unbind_req {
    t_scalar_t   PRIM_type;      /* Always T_UNBIND_REQ */
};

DESCRIPTION

This primitive requests that the transport provider unbind the protocol address associated with the stream and deactivate the stream.

PARAMETERS

PRIM_type: indicates the primitive type.

RULES

This primitive requires the transport provider to generate the following acknowledgments on receipt of the primitive and that the transport user must wait for the acknowledgment before issuing any other primitives:

Successful

Correct acknowledgment of the primitive is indicated via the T_OK_ACK(7) primitive described in reference TPI-SMD.

Non-fatal errors

These errors will be indicated via the T_ERROR_ACK(7) primitive described in reference TPI-SMD.

ERRORS

The allowable errors are as follows:

[TOUTSTATE]: The primitive would place the transport interface out of state.
[TSYSERR]: A system error has occurred and the Linux System error is indicated in the primitive.

MODES

Both connection-mode and connectionless-mode.

ORIGINATOR

Transport user.

HISTORY

The Transport Provider Interface first appeared in SVR 4[1].

CONFORMANCE

This interface conforms to TPI Version 2, Draft 2[2].

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]: TPI Revision 2.0.0, Open Group CAE Specification: Transport Provider Interface (TPI) Specification, Revision 2.0.0, Draft 2, 1999, (Berkshire, UK), OpenGroup, Open Group Publication. <http://www.opengroup.org/onlinepubs/>
[3]: 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]
[4]: Advanced Programming in the UNIX®Environment, 15th edition, December 1997, (Reading, Massachusetts), W. R. Stevens, Addison Wesley. [ISBN 0-201-56317-7]