t_unbind(3)                                                     t_unbind(3)




 NAME    [Toc]    [Back]
      t_unbind() - disable a transport endpoint

 SYNOPSIS    [Toc]    [Back]
      #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    [Toc]    [Back]
      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    [Toc]    [Back]
      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 asynccancel
 safe nor async-signal safe.  Finally, it is not fork-safe.

    Note    [Toc]    [Back]
      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.

    Valid States    [Toc]    [Back]
      T_IDLE

 RETURN VALUE    [Toc]    [Back]
      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    [Toc]    [Back]
      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.



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 t_unbind(3)                                                     t_unbind(3)




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

 SEE ALSO    [Toc]    [Back]
      t_bind(3).

 STANDARDS CONFORMANCE    [Toc]    [Back]
      t_unbind(): SVID2, XPG3, XPG4


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003