t_close(3xti)
Name
t_close − close a transport endpoint
Syntax
#include <xti.h>
int t_close fd)
int fd;
Arguments
fdIdentifies the local transport endpoint.
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. However, this function does not check state information, so it can be called from any state to close a transport endpoint. If this occurs, the local library resources associated with the endpoint are freed automatically. In addition, close() is issued for that file descriptor; the t_close() abortives if there are no other descriptors in this or in another process that references the transport endpoint and breaks the transport connection that may be associated with that endpoint.
| Parameters | Before Call | After Call |
| fd | x | / |
Return Values
The t_close returns 0 on success and −1 on failure, and t_errno is set to indicate the error.
Diagnostics
On failure, t_errno is set to the following:
The specified file descriptor does not refer to a transport endpoint.