xpaopen(3)							SAORD Documentation							xpaopen(3)

NAME

       XPAOpen -  allocate a persistent client handle

SYNOPSIS

	 #include <xpa.h>

	 XPA XPAOpen(char *mode);

DESCRIPTION

       XPAOpen() allocates a persistent XPA struct that can be used with calls to XPAGet(), XPASet(), XPAInfo(), XPAGetFd(), and XPASetFd(). Per-
       sistence means that a connection to an XPA server is not closed when one of the above calls is completed but will be re-used on successive
       calls. Using XPAOpen() therefore saves the time it takes to connect to a server, which could be significant with slow connections or if
       there will be a large number of exchanges with a given access point.  The mode argument currently is ignored ("reserved for future use").

       An XPA struct is returned if XPAOpen() was successful; otherwise NULL is returned. This returned struct can be passed as the first argument
       to XPAGet(), etc.  Those calls will update the list of active XPA connections.  Already connected servers (from a previous call) are left
       connected and new servers also will be connected.  Old servers (from a previous call) that are no longer needed are disconnected.  The con-
       nected servers will remain connected when the next call to XPAGet() is made and connections are once again updated.

       Example -

	#include <xpa.h>

	 XPA xpa;
	 xpa = XPAOpen(NULL);

SEE ALSO

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

version 2.1.14							   June 7, 2012 							xpaopen(3)