t_unbind(3)t_unbind(3)NAMEt_unbind - Disable a transport endpoint.
SYNOPSIS
#include <xti.h>
int t_unbind(
int fd );
LIBRARY
XTI Library (libxti.a)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
t_unbind(): XNS4.0, XNS5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
The following table summarizes the relevance of input parameter data
before and after t_bind() is called:
─────────────────────────────────────
Parameter Before Call After Call
─────────────────────────────────────
fd y n
─────────────────────────────────────
Notes to Table: This is a meaningful parameter. This is not a meaning‐
ful parameter.
Specifies a file descriptor returned by the t_open() function that
identifies an active, previously bound local transport endpoint.
DESCRIPTION
The t_unbind() XTI service function is used in connection-oriented and
connectionless modes to disable the transport endpoint, specified by
the file descriptor that was previously bound by a t_bind() call. When
t_bind() completes, no further data destined for this transport end‐
point or events are accepted by the transport provider. An endpoint
that has been disabled using t_unbind() can be enabled by a subsequent
call to t_bind().
RETURN VALUES
Upon successful completion, a value of 0 (zero) is returned. Otherwise,
a value of -1 is returned and t_errno is set to indicate the error.
ERRORS
If the t_unbind() function fails, t_errno is set to one of the follow‐
ing values: File descriptor fd is not a valid transport endpoint. This
function was issued in the wrong sequence. An asynchronous event
occurred at the transport endpoint specified by the fd parameter. A
system error occurred during execution of this function. This error
indicates that a communication problem has been detected between XTI
and the transport provider for which there is no other suitable
XTI(t_errno).
VALID STATES
The t_bind() function can be called only in the T_IDLE transport
provider state.
SEE ALSO
Functions: t_bind(3)
Standards: standards(5)
Network Programmer's Guide
t_unbind(3)
