Content-type: text/html Man page of t_getprotaddr

t_getprotaddr

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

t_getprotaddr - Gets the protocol address  

LIBRARY

XTI Library (libxti.a)  

SYNOPSIS

#include <xti.h>

int t_getprotaddr(        int fd,
       struct t_bind *boundaddr,
       struct t_bind *peeraddr) ;
 

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

t_getprotaddr: XPG4-UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags.  

PARAMETERS

The following table summarizes the relevance of input and output parameters before and after t_getprotaddr() is called:

ParametersBefore CallAfter Call

fdyn
boundaddr->maxlenyn
boundaddr->addr.lenny
boundaddr->addr.bufo(o)
boundaddr->qlennn
peeraddr->maxlenyn
peeraddr->addr.lenny
peeraddr->addr.bufo(o)
peeraddr->qlennn
Table Notes: This is a meaningful parameter. The content of the object pointed to by y is meaningful. This is a meaningful but optional parameter. The content of the object pointed to by o is meaningful. This is not a meaningful parameter. Specifies a file descriptor returned by the t_open() function that identifies the transport endpoint through which data is sent. Specifies the location to hold the local address, if any, currently bound to fd. It points to a structure of type t_bind, with the following fields The maximum size of the address buffer. Points to the buffer where the address is to be placed. In return, the buf field of boundaddr points to the address, if any, that is currently bound to fd. Specifies the length of the address. If the transport endpoint is in the T_UNBND state, zero is returned in the len field. Specifies the location to hold the remote address, if any, that is currently connected to fd. It points to a structure of the type t_bind, with the following fields: The maximum size of the address buffer. Points to the buffer where the address is to be placed. The buf field of peeraddr points to the address, if any, currently connected to fd. Specifies the length of the address. If the transport endpoint is not in the T_DATAXFER state, zero is returned in this field.  

VALID STATES

The t_getprotaddr() function can be called in all the transport provider states, except T_UNINIT.  

DESCRIPTION

The t_getprotaddr() function returns local and remote protocol addresses currently associated with the transport endpoint specified by fd.  

RETURN VALUES

Upon successful completion, a value of zero is returned. If the transport endpoint is in the T_UNBND state, zero is returned in the len field of boundaddr (boundaddr->addr.len).

If the transport endpoint is not in the T_DATAXFER state, then zero is returned in the len field of peeraddr (peeraddr->addr.len = 0). On failure, a value of -1 is returned and t_errno is set to indicate the error.  

ERRORS

If the t_getprotaddr() function fails, t_errno may be set to one of the following values: The specified file descriptor does note refer to a transport endpoint. The number of bytes allocated for an incoming argument (maxlen) is greater than zero but not sufficient to store the value of that argument. A system error has occurred during execution of this function. 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).  

RELATED INFORMATION

Functions: t_bind delim off


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
PARAMETERS
VALID STATES
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:36 GMT, October 02, 2010