t_getprotaddr(3N)t_getprotaddr(3N)NAMEt_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 ALSOt_bind(3N)DIAGNOSTICSt_getprotaddr returns 0 on success and -1 on failure and t_errno is set
to indicate the error.
Page 1
