t_sndrel(3)

NAME

t_sndrel − initiate an orderly release

SYNOPSIS

#include <tiuser.h>

int t_sndrel (fd)
int fd;

DESCRIPTION

The t_sndrel() function is used in connection-oriented mode to initiate an orderly release at a transport endpoint specified by fd, which is a file descriptor previously returned by the t_open() function.

After this orderly release is indicated, the transport user should not try to send more data through that transport endpoint; an attempt to send more data to a released transport endpoint may block continuously. However, the transport user may continue to receive data over the connection until an orderly release indication is received.

The t_sndrel() 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.

[TFLOW] Asynchronous mode is indicated because O_NONBLOCK or O_NDELAY was set, but the transport provider cannot accept a release because of flow-control restrictions.

[TLOOK] An asynchronous event has occurred on this transport endpoint and requires immediate attention.

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

[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

For portability purposes, it is recommended that O_NONBLOCK be used instead of O_NDELAY.

HP XTI does not support t_sndrel.

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