t_close(3)
NAME
t_close() − close a transport endpoint
SYNOPSIS
#include <xti.h> (for X/OPEN Transport Interface - XTI)
or
#include <tiuser.h> (for Transport Layer Interface - TLI)
int t_close (fd)
int fd;
DESCRIPTION
The t_close() function informs the transport provider that the user is finished with the transport endpoint specified by fd, and frees any local library resources associated with the endpoint. t_close() also closes the file descriptor associated with the transport endpoint.
t_close() should be called from the T_UNBND state (see t_getstate(3)). However, this function does not check state information, so it may be called from any state to close a transport endpoint. If this occurs, the local library resources associated with the endpoint will be freed automatically. close() will also be issued for that file descriptor. The close will be abortive if no other process has that file open and will break any transport connection that may be associated with that endpoint.
Valid States
All - apart from T_UNINIT
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
[TBADF] The specified file descriptor does not refer to a transport endpoint.
[TPROTO] (XTI only) This error indicates that a communication problem has been detected between XTI and the transport provider for which there is no suitable XTI ( t_errno).
SEE ALSO
t_getstate(3), t_open(3), t_unbind(3).
STANDARDS CONFORMANCE
t_close(): SVID2, XPG3, XPG4
Hewlett-Packard Company — HP-UX Release 10.20: July 1996