t_close(3N)							   t_close(3N)

NAME    [Toc]    [Back]

     t_close - close a transport endpoint

SYNOPSIS    [Toc]    [Back]

     #ifdef _XOPEN_SOURCE
     #include <xti.h>
     #else
     #include <tiuser.h>
     #endif

     int t_close(fd)
     int fd;

DESCRIPTION    [Toc]    [Back]

     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.

     t_close should be called from the T_UNBND state [see t_getstate(3N)].
     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(2) 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.

     This function resides within both the X/Open compliant libxnet and	the
     SVR4 compliant libnsl Network Services libraries.	Network	Services
     applications which	require	X/Open compliance must link-load with -lxnet.
     Network Services applications which require SVR4 compliance must linkload
 with -lnsl.

     On	failure, t_errno may be	set to the following:

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

SEE ALSO    [Toc]    [Back]

     t_getstate(3N), t_open(3N), t_unbind(3N)

DIAGNOSTICS    [Toc]    [Back]

     t_close returns 0 on success and -1 on failure and	t_errno	is set to
     indicate the error.


									PPPPaaaaggggeeee 1111