Networking Services Library Functions         tgetprotaddr(3NSL)



NAME
     tgetprotaddr - get the protocol addresses

SYNOPSIS
     #include 

     int tgetprotaddr(int fd, struct tbind *boundaddr,
          struct tbind *peeraddr);


DESCRIPTION
     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.


     The tgetprotaddr() function returns local and remote proto-
     col  addresses  currently associated with the transport end-
     point specified by fd. In boundaddr and  peeraddr  the  user
     specifies  maxlen,  which  is the maximum size (in bytes) of
     the address buffer, and buf which points to the buffer where
     the  address  is  to  be placed. On return, the buf field of
     boundaddr points to the address, if any, currently bound  to
     fd,  and  the len field specifies the length of the address.
     If the transport endpoint is in the TUNBND state,  zero  is
     returned  in  the  len  field of boundaddr. The buf field of
     peeraddr points to the address, if any, currently  connected
     to  fd,  and  the  len  field  specifies  the  length of the
     address.  If  the  transport  endpoint   is   not   in   the
     TDATAXFER,  TINREL,  TOUTCON or  TOUTREL states, zero is
     returned in the len field of peeraddr. If the  maxlen  field
     of   boundaddr  or  peeraddr  is  set to zero, no address is
     returned.

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

VALID STATES
     AL - apart from TUNINIT.

ERORS
     On failure, terrno is set to one of the following:

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




SunOS 5.11           Last change: 7 May 1998                    1






Networking Services Library Functions         tgetprotaddr(3NSL)



     TBUFOVFLW    The number of bytes allocated for  an  incoming
                  argument  (maxlen)  is  greater than  0 but not
                  sufficient to store the value of that argument.


     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 (terrno).


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


TLI COMPATIBILITY
     In the TLI interface definition, no counterpart of this rou-
     tine was defined.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT Level                     Safe                        
    


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





















SunOS 5.11           Last change: 7 May 1998                    2