t_unbind Subroutine for Transport Layer Interface

Communications Technical Reference, Volume 2

t_unbind Subroutine for Transport Layer Interface

Purpose

Disables a transport endpoint.

Library

Transport Layer Interface Library (libtli.a)

Syntax

#include <tiuser.h>

int t_unbind(fd)
int fd;

Description

The t_unbind subroutine disables a transport endpoint, which was previously bound by the t_bind subroutine. On completion of this call, no further data or events destined for this transport endpoint are accepted by the transport provider.

Parameter

fd	Specifies the transport endpoint.

Return Values

On successful completion, the t_unbind subroutine returns a value of 0. Otherwise, it returns a value of -1 and sets the t_errno variable to indicate the error.

Error Codes

If unsuccessful, the t_errno variable is set to one of the following:

TBADF	The specified file descriptor 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.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The t_bind subroutine.

List of Streams Programming References and STREAMS Overview in AIX Version 4.3 Communications Programming Concepts.