t_rcvrel(3)

NAME

t_rcvrel − acknowledge receipt of an orderly release indication

SYNOPSIS

#include <tiuser.h>

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 specified by fd, which is a file descriptor previously returned by the t_open() function.

After receipt of this orderly release indication at the transport endpoint specified 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() function 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).

ERRORS

On failure, t_errno is set to one of the following:

[TBADF] The specified identifier does not refer to a transport endpoint.

[TNOREL] No orderly release indication currently exists on the specified transport endpoint.

[TBUFOVFLW] The number of bytes allocated for incoming data is not sufficient 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.

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.

NOTE

HP XTI does not support t_rcvrel.

In HP-UX 9.0, XTI (X/Open Transport Interface) supports only OSI as a transport provider, and is available only as part of the OSI Transport Services 9000 product. Users of this product can access XTI versions of the t_* routines by linking with /usr/lib/libxti.a. For more information on XTI, see "HP-UX/9000 XTI Programmer’s Guide".

In HP-UX 9.0, TLI (Transport Layer Interface) supports any transport provider which is compliant with TPI (Transport Provider Interface). TLI is available only as part of the STREAMS product. Users of this product can access TLI versions of the t_* routines by linking with /usr/lib/libnsl_s.a. For more information on TLI, see the TLI section of "STREAMS/UX for HP 9000 Reference Manual".

Museum

Related Articles