t_unbind(3nsl)

1t_unbind(3NSL)       Networking Services Library Functions      t_unbind(3NSL)
2
3
4

NAME

6       t_unbind - disable a transport endpoint
7

SYNOPSIS

9       #include <xti.h>
10
11
12
13       int t_unbind(int fd);
14
15

DESCRIPTION

17       The  This  routine is part of the XTI interfaces which evolved from the
18       TLI interfaces. XTI represents the future  evolution  of  these  inter‐
19       faces.  However,  TLI  interfaces are supported for compatibility. When
20       using a TLI routine that has the same  name  as  an  XTI  routine,  the
21       tiuser.h  header  file  must  be used.  Refer to the  TLI COMPATIBILITY
22       section for a description of differences between the two interfaces.
23
24
25       t_unbind() function disables the transport  endpoint  specified  by  fd
26       which was previously bound by t_bind(3NSL). On completion of this call,
27       no further data or events destined for this transport endpoint will  be
28       accepted  by  the  transport provider. An endpoint which is disabled by
29       using t_unbind() can be enabled by a subsequent call to t_bind(3NSL).
30

RETURN VALUES

32       Upon successful completion, a value of  0 is  returned.   Otherwise,  a
33       value of  -1 is returned and t_errno is set to indicate an error.
34

VALID STATES

36       T_IDLE.
37

ERRORS

39       On failure, t_errno is set to one of the following:
40
41       TBADF        The  specified  file descriptor does not refer to a trans‐
42                    port endpoint.
43
44
45       TLOOK        An asynchronous event has occurred on this transport  end‐
46                    point.
47
48
49       TOUTSTATE    The  communications  endpoint  referenced by  fd is not in
50                    one of the states in which a  call  to  this  function  is
51                    valid.
52
53
54       TPROTO       This error indicates that a communication problem has been
55                    detected between XTI and the transport provider for  which
56                    there is no other suitable XTI error (t_errno).
57
58
59       TSYSERR      A system error has occurred during execution of this func‐
60                    tion.
61
62

TLI COMPATIBILITY

64       The XTI and TLI interface definitions have common names but use differ‐
65       ent  header files. This, and other semantic differences between the two
66       interfaces are described in the subsections below.
67
68   Interface Header
69       The XTI interfaces use the header file, xti.h . TLI  interfaces  should
70       not use this header.  They should use the header:
71         #include <tiuser.h>
72
73   Error Description Values
74       The  t_errno  value  that can be set by the XTI interface and cannot be
75       set by the TLI interface is:
76         TPROTO
77

ATTRIBUTES

79       See attributes(5) for descriptions of the following attributes:
80
81
82
83
84       ┌─────────────────────────────┬─────────────────────────────┐
85       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
86       ├─────────────────────────────┼─────────────────────────────┤
87       │MT-Level                     │MT-Safe                      │
88       └─────────────────────────────┴─────────────────────────────┘
89