t_getprotaddr(3N)

NAME
     t_getprotaddr - get protocol-specific service information

SYNOPSIS
     #ifdef _XOPEN_SOURCE
     #include <xti.h>

     int t_getprotaddr(int fd,
                          struct t_bind *boundaddr, struct t_bind *perraddr)
     #endif

DESCRIPTION
     The t_getprotaddr() function returns local and remote protocol addresses
     currently associated with the transport endpoint specified by fd.  In
     boundaddr and peeraddr the user specified maxlen, which is the maximum
     size 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 T_UNBND
     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 T_DATAXFER state, zero is returned in the len
     field of peeraddr.

     This function resides within the X/Open compliant libxnet Network
     Services library.  Network Services applications which require X/Open
     compliance must link-load with -lxnet.

     On failure, t_errno may be set to one of the following:

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

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

     TSYSERR        A system error has occurred during execution of this
                    function.  TPROTO This error indicates that a
                    communication problem has been detected between XTI and
                    the transport provider for which there is no other
                    suitable XTI (t_errno).

SEE ALSO
     t_bind(3N)

DIAGNOSTICS
     t_getprotaddr returns 0 on success and -1 on failure and t_errno is set
     to indicate the error.