HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

t_close(3) 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 ﬁnished with the transport end-

point speciﬁed by fd, and frees any local library resources associated with the endpoint.

t_close() also

closes the ﬁle 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 ﬁle descriptor. The close will be abortive if no other process has that ﬁle open and will break

any transport connection that may be associated with that endpoint.

Valid States

All - apart from

T_UNINIT.

Fork Safety

t_close is not fork-safe.

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 speciﬁed ﬁle 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).