t_getprotaddr(3nsl) [opensolaris man page]

t_getprotaddr(3NSL)				       Networking Services Library Functions				       t_getprotaddr(3NSL)

NAME

       t_getprotaddr - get the protocol addresses

SYNOPSIS

       #include <xti.h>

       int t_getprotaddr(int fd, struct t_bind *boundaddr,
	    struct t_bind *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  t_getprotaddr() function returns local and remote protocol addresses currently associated with the transport endpoint 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 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, T_INREL, T_OUTCON or  T_OUTREL 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.  Otherwise, a value of  -1 is returned and t_errno is set to indicate the error.

VALID STATES

       ALL - apart from T_UNINIT.

ERRORS

       On failure, t_errno is 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	0 but not sufficient to store the value of
		    that argument.

       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 error (t_errno).

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

TLI COMPATIBILITY

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

ATTRIBUTES

       See attributes(5)  for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       t_bind(3NSL), attributes(5)

SunOS 5.11							    7 May 1998						       t_getprotaddr(3NSL)

Check Out this Related Man Page

t_unbind(3NSL)					       Networking Services Library Functions					    t_unbind(3NSL)

NAME

       t_unbind - disable a transport endpoint

SYNOPSIS

       #include <xti.h>

       int t_unbind(int fd);

DESCRIPTION

       The  This  routine is part of the XTI interfaces which evolved from the TLI interfaces. XTI represents the future evolution of these inter-
       faces. 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.

       t_unbind() function disables the transport endpoint specified by fd which was previously bound by t_bind(3NSL). On completion of this call,
       no further data or events destined for this transport endpoint will be accepted by the transport provider. An endpoint which is disabled by
       using t_unbind() can be enabled by a subsequent call to t_bind(3NSL).

RETURN VALUES

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

VALID STATES

       T_IDLE.

ERRORS

       On failure, t_errno is set to one of the following:

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

       TLOOK	    An asynchronous event has occurred on this transport endpoint.

       TOUTSTATE    The communications endpoint referenced by  fd is not in one of the states in which a call to this function is valid.

       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 error (t_errno).

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

TLI COMPATIBILITY

       The XTI and TLI interface definitions have common names but use different header files. This, and other semantic  differences  between  the
       two interfaces are described in the subsections below.

   Interface Header
       The XTI interfaces use the header file, xti.h . TLI interfaces should not use this header.  They should use the header:
	 #include <tiuser.h>

   Error Description Values
       The t_errno value that can be set by the XTI interface and cannot be set by the TLI interface is:
	 TPROTO

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       t_bind(3NSL), attributes(5)

SunOS 5.11							    7 May 1998							    t_unbind(3NSL)

Linux and UNIX Man Pages

t_getprotaddr(3nsl) [opensolaris man page]

Check Out this Related Man Page