Manual Pages for UNIX Operating System command usage for man t_unbind

Networking Services Library Functions              t_unbind(3NSL)



NAME
     t_unbind - disable a transport endpoint

SYNOPSIS
     #include 



     int t_unbind(int fd);


DESCRIPTION
     The This routine is part of the XTI interfaces which evolved
     from the TLI interfaces. XTI represents the future evolution
     of these interfaces. However, TLI interfaces  are  supported
     for  compatibility.  When  using  a TLI routine that has the
     same name as an XTI routine, the  tiuser.h header file  must
     be  used.   Refer  to  the   TLI COMPATIBILITY section for a
     description of differences between the two interfaces.


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

RETURN VALUES
     Upon successful completion, a value of  0 is returned.  Oth-
     erwise,  a  value  of   -1 is returned and t_errno is set to
     indicate an error.

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.




SunOS 5.11           Last change: 7 May 1998                    1






Networking Services Library Functions              t_unbind(3NSL)



     TPROTO       This error indicates that a communication prob-
                  lem has been detected between XTI and the tran-
                  sport provider for  which  there  is  no  other
                  suitable XTI error (t_errno).


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


TLI COMPATIBILITY
     The XTI and TLI interface definitions have common names  but
     use different header files. This, and other semantic differ-
     ences between the two interfaces are described in  the  sub-
     sections below.

  Interface Header
     The XTI interfaces use the header file, xti.h .  TLI  inter-
     faces  should  not  use  this  header.   They should use the
     header:
       #include 

  Error Description Values
     The t_errno value that can be set by the XTI  interface  and
     cannot be set by the TLI interface is:
       TPROTO

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     t_bind(3NSL), attributes(5)













SunOS 5.11           Last change: 7 May 1998                    2