t_unbind(3)                                                 t_unbind(3)

  t_unbind()

  NAME

    t_unbind - synchronise transport library

  SYNOPSIS

    #include 

    int t_unbind(
        int fd)

  DESCRIPTION

    The t_unbind(3) function has only one parameter.

    Parameters     Before call     After call

    fd             x               /

    The t_unbind(3) function disables the transport endpoint specified by fd
    which was previously bound by t_bind(3). On completion of this call, no
    further data or events destined for this transport endpoint will be
    accepted by the transport provider. An endpoint which is disabled by using
    t_unbind(3) can be enabled by a subsequent call to t_bind(3).

  VALID STATES

    T_IDLE

  ERRORS

    On failure, t_errno is set to one of the following:

    [TBADF]
        The specified file descriptor does not refer to a transport endpoint.

    [TLOOK]
        An asynchronous event has occurred on this transport endpoint.

    [TOUTSTATE]
        The communications endpoint referenced by fd is not in one of the
        states in which a call to this function is valid.

    [TPROTO]
        This error indicates that a communication problem has been detected
        between XTI and the transport provider for which there is no other
        suitable XTI error (t_errno).

    [TSYSERR]
        A system error has occurred during execution of this function.

  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.

  SEE ALSO

    t_bind(3)

  USAGE NOTES

    The t_unbind function is not thread safe.

    The t_unbind function is not async-signal safe.