t_getprotaddr(3nsl)

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

NAME

6       t_getprotaddr - get the protocol addresses
7

SYNOPSIS

9       #include <xti.h>
10
11       int t_getprotaddr(int fd, struct t_bind *boundaddr,
12            struct t_bind *peeraddr);
13
14

DESCRIPTION

16       This  routine  is part of the XTI interfaces which evolved from the TLI
17       interfaces. XTI represents the future evolution  of  these  interfaces.
18       However,  TLI  interfaces are supported for compatibility. When using a
19       TLI routine that has the same name as an  XTI  routine,  the   tiuser.h
20       header  file must be used.  Refer to the  TLI COMPATIBILITY section for
21       a description of differences between the two interfaces.
22
23
24       The  t_getprotaddr()  function  returns  local  and   remote   protocol
25       addresses currently associated with the transport endpoint specified by
26       fd. In boundaddr and peeraddr the user specifies maxlen, which  is  the
27       maximum  size (in bytes) of the address buffer, and buf which points to
28       the buffer where the address is to be placed. On return, the buf  field
29       of  boundaddr points to the address, if any, currently bound to fd, and
30       the len field specifies the length of the  address.  If  the  transport
31       endpoint  is in the T_UNBND state, zero is returned in the len field of
32       boundaddr. The buf field of peeraddr points to  the  address,  if  any,
33       currently  connected  to  fd, and the len field specifies the length of
34       the address. If the transport  endpoint  is  not  in  the   T_DATAXFER,
35       T_INREL,  T_OUTCON  or   T_OUTREL  states,  zero is returned in the len
36       field of peeraddr. If the  maxlen field of  boundaddr  or  peeraddr  is
37       set to zero, no address is returned.
38

RETURN VALUES

40       Upon  successful  completion,  a value of  0 is returned.  Otherwise, a
41       value of  -1 is returned and t_errno is set to indicate the error.
42

VALID STATES

44       ALL - apart from T_UNINIT.
45

ERRORS

47       On failure, t_errno is set to one of the following:
48
49       TBADF        The specified file descriptor does not refer to  a  trans‐
50                    port endpoint.
51
52
53       TBUFOVFLW    The  number  of  bytes  allocated for an incoming argument
54                    (maxlen) is greater than  0 but not  sufficient  to  store
55                    the value of that argument.
56
57
58       TPROTO       This error indicates that a communication problem has been
59                    detected between XTI and the transport provider for  which
60                    there is no other suitable XTI error (t_errno).
61
62
63       TSYSERR      A system error has occurred during execution of this func‐
64                    tion.
65
66

TLI COMPATIBILITY

68       In the TLI interface definition, no counterpart  of  this  routine  was
69       defined.
70

ATTRIBUTES

72       See attributes(5)  for descriptions of the following attributes:
73
74
75
76
77       ┌─────────────────────────────┬─────────────────────────────┐
78       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
79       ├─────────────────────────────┼─────────────────────────────┤
80       │MT Level                     │Safe                         │
81       └─────────────────────────────┴─────────────────────────────┘
82