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(). Persistence 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 connected 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