HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

541

542

543

544

545

546

547

548

549

550

t_rcvrel(3) t_rcvrel(3)

NAME

t_rcvrel() - acknowledge receipt of an orderly release indication at a transport endpoint

SYNOPSIS

#include <xti.h> /* for X/OPEN Transport Interface - XTI */

/* or */

#include <tiuser.h> /* for Transport Layer Interface - TLI */

int t_rcvrel (fd);

int fd;

DESCRIPTION

The t_rcvrel() function is used in connection-oriented mode to acknowledge receipt of an orderly

release indication at a transport endpoint. The released endpoint is speciﬁed by fd, which is a ﬁle descriptor

previously returned by the

t_open() function.

After receipt of this orderly release indication at the transport endpoint speciﬁed by fd, the transport user

should not try to receive additional data from that transport endpoint. Any attempt to receive more data

from a released transport endpoint blocks continuously. However, the transport user may continue to send

data across the connection until a release is sent by the transport user by invoking the

t_sndrel()

func-

tion call.

The

t_rcvrel() function should not be used unless the servtype type-of-service returned by the

t_open() or t_getinfo() functions is T_COTS_ORD (supports connection-mode service with the

optional orderly release facility).

Valid States

T_DATAXFER , T_OUTREL

Note

HP OSI XTI does not support t_rcvrel() .

Fork Safety

t_rcvrel is not fork-safe.

RETURN VALUE

Upon successful completion, a value of 0 is returned. Otherwise, a value of −1 is returned and

t_errno is

set to indicate the error.

ERRORS

On failure,

t_errno is set to one of the following:

[TBADF] The speciﬁed identiﬁer does not refer to a transport endpoint.

[TNOREL] No orderly release indication currently exists on the speciﬁed transport endpoint.

[TBUFOVFLW] The number of bytes allocated for incoming data is not sufﬁcient to store the data.

[TNOTSUPPORT] This function is not supported by the underlying transport provider.

[TLOOK] An asynchronous event has occurred on the transport endpoint referenced by fd and

requires immediate attention.

[TSYSERR] A system error has occurred during execution of this function.

[TPROTO] (XTI only) This error indicates that a communication problem has been detected

between XTI and the transport provider for which there is no other suitable XTI

(t_errno).

[TOUTSTATE] (XTI only) The function was issued in the wrong sequence on the transport endpoint

referenced by fd.