Manpage of T_BIND_REQ

T_BIND_REQ

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

NAME

T_BIND_REQ - Bind Protocol Address Request

SYNOPSIS

These messages consist of one M_PROTO message block formatted as follows:

struct T_bind_req {
    t_scalar_t    PRIM_type;      /* Always T_BIND_REQ */
    t_scalar_t    ADDR_length;
    t_scalar_t    ADDR_offset;
    t_uscalar_t   CONIND_number;
};

DESCRIPTION

This primitive requests that the transport provider bind a protocol address to the stream, negotiate the number of connect indications allowed to be outstanding by the transport provider for the specified protocol address, and activate the stream associated with the protocol address.

-: Note that a stream is viewed as active when the transport provider may receive and transmit TPDUs (transport protocol data units) associated with the stream.

PARAMETERS

PRIM_type: indicates the primitive type.
ADDR_length: is the length of the protocol address to be bound to the stream.
ADDR_offset: is the offset from the beginning of the M_PROTO block where the protocol address begins. Note that all lengths, offsets, and sizes in all structures refer to the number of bytes.
CONIND_number: is the requested number of connect indications allowed to be outstanding by the transport provider for the specified protocol address.
Note that the CONIND_number should be ignored by those providing a connectionless transport service. Also note that if the number of outstanding connect indications equals CONIND_number, the transport provider need not discard further incoming connect indications, but may choose to queue them internally until the number of outstanding connect indications drops below CONIND_number.

The proper alignment of the address in the M_PROTO message block is not guaranteed. The address in the M_PROTO message block is however, aligned the same as it was received from the transport user.

RULES

For rules governing the requests made by these primitives, see the T_BIND_ACK(7) primitive.

These primitives require the transport provider to generate one of the following acknowledgments on receipt of the primitive, and the transport user must wait for the acknowledgment before issuing any other primitives:

Successful: Correct acknowledgment of the primitive is indicated via the T_BIND_ACK(7) primitive.
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:

[TACCES]: This indicates that the user did not have proper permissions for the use of the requested address.
[TADDRBUSY]: This indicates that the requested address is in use.
[TBADADDR]: This indicates that the protocol address was in an incorrect format or the address contained invalid information. It is not intended to indicate protocol errors.
[TNOADDR]: This indicates that the transport provider could not allocate an address.
[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]

TRADEMARKS

OpenSS7tm: is a trademark of OpenSS7 Corporation.
Linux®: is a registered trademark of Linus Torvalds.
UNIX®: is a registered trademark of The Open Group.
Solaris®: is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

OpenSS7 XTI/TLI Networking: Package strxnet version 0.9.2.12 released 2008-10-31.

This document was created by man2html, using the manual pages.
Time: 21:10:18 GMT, September 09, 2010