NAME
t_unbind() — disable a transport endpoint
SYNOPSIS
#include <xti.h> /* for X/OPEN Transport Interface - XTI */
/* or */
#include <tiuser.h> /* for Transport Layer Interface - TLI */
int t_unbind (fd);
int fd;
DESCRIPTION
The
t_unbind()
function disables the transport endpoint specified by
fd
which was previously bound by
t_bind().
On completion of this call, no further data or events destined for
this transport endpoint will be accepted by the transport provider.
Thread-Safeness
The
t_unbind()
function is safe to be called by multithreaded applications, and it is
thread-safe for both POSIX Threads and DCE User Threads.
It has a cancellation point.
It is neither async-cancel safe nor async-signal safe.
Finally, it is not fork-safe.
Note
Users can access XTI versions of the
t_*
routines by linking with
/usr/lib/libxti.a.
For more information on XTI, see
HP-UX/9000 XTI Programmer's Guide.
TLI supports any transport provider which is compliant with TPI (Transport
Provider Interface). Users can access TLI versions of the t_* routines by
linking with
/usr/lib/libnsl_s.a.
For more information on TLI, see the TLI section of the
STREAMS/UX for HP 9000 Reference Manual.
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 an error.
ERRORS
On failure,
t_errno
is set to the following:
- [TBADF]
The specified identifier does not refer to a transport endpoint.
- [TOUTSTATE]
The function was issued in the wrong sequence.
- [TLOOK]
An asynchronous event has occurred on this transport endpoint.
- [TSYSERR]
A system error has occurred during execution of this function.
STANDARDS CONFORMANCE
t_unbind(): SVID2, XPG3, XPG4
