xpamacros(3)							SAORD Documentation						      xpamacros(3)

NAME

       XPAMacros - XPA Server Callback Macros

SYNOPSIS

	 #include <xpa.h>

	 xpa_class, xpa_name, xpa_method, xpa_cmdfd, xpa_datafd,
	 xpa_sendian, xpa_cendian

DESCRIPTION

       Server routines have  access to information about the XPA being called via the following macros (each of which takes the xpa handle as an
       argument):

	 macro		       explanation
	 ------ 	       -----------
	 xpa_class	       class of this xpa
	 xpa_name	       name of this xpa
	 xpa_method	       method string (inet or local connect info)
	 xpa_cmdfd	       fd of command socket
	 xpa_datafd	       fd of data socket
	 xpa_sendian	       endian-ness of server ("little" or "big")
	 xpa_cendian	       endian-ness of client ("little" or "big"

       The argument to these macros is the call_data pointer that is passed to the server procedure.  This pointer should be type case to XPA in
       the server routine:

	 XPA xpa = (XPA)call_data;

       The most important of these macros is xpa_datafd().  A server routine that sets "fillbuf=false" in receive_mode or send_mode can use this
       macro to perform I/O directly to/from the client, rather than using buf.

       The xpa_cendian and xpa_sendian macros can be used together to determine if the data transferred from the client is byte swapped with
       respect to the server. Values for these macros are: "little", "big", or "?".  In order to do a proper conversion, you still need to know
       the format of the data (i.e., byte swapping is dependent on the size of the data element being converted).

SEE ALSO

       See xpa(7) for a list of XPA help pages

version 2.1.14							   June 7, 2012 						      xpamacros(3)