t_getprotaddr(3N)					     t_getprotaddr(3N)

NAME    [Toc]    [Back]

     t_getprotaddr - get protocol-specific service information

SYNOPSIS    [Toc]    [Back]

     #ifdef _XOPEN_SOURCE
     #include <xti.h>

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

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     t_bind(3N)

DIAGNOSTICS    [Toc]    [Back]

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


									PPPPaaaaggggeeee 1111