t_close(3N) t_close(3N)
NAME
tclose - close a transport endpoint
SYNOPSIS
#include <sys/tiuser.h>
int tclose(int fd);
DESCRIPTION
The tclose 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,
tclose closes the file associated with the transport endpoint.
tclose should be called from the TUNBND state [see tgetstate(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 associ-
ated with that endpoint.
On failure, terrno may be set to the following:
TBADF The specified file descriptor does not refer to a
transport endpoint.
DIAGNOSTICS
tclose returns 0 on success and -1 on failure and terrno is set to
indicate the error.
SEE ALSO
tgetstate(3N), topen(3N), tunbind(3N).
Page 1 Reliant UNIX 5.44 Printed 11/98