Name
t_close - close a transport endpoint
Syntax
#include <tiuser.h>
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. In addition, t_close closes the file
associated with the transport endpoint.
The t_close function should be called from the T_UNBND state
[see t_getstate (NSL)]. 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. In addition, close(S) will 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.
On failure, t_errno may be set to the following:
[TBADF] The specified file descriptor does not refer to
a transport endpoint.
See Also
t_getstate(NSL), t_open(NSL), t_unbind(NSL).
Network Programmer's Guide.
Diagnostics
The t_close function returns 0 on success and -1 on failure,
and t_errno is set to indicate the error.
Standards Conformance
t_close is conformant with:
AT&T SVID Issue 2, Select Code 307-127.
(printed 6/18/89)