xpaxt(7) [debian man page]

xpaxt(7)							SAORD Documentation							  xpaxt(7)

NAME

       XPAXt -	the XPA Interface to Xt (X Windows)

SYNOPSIS

       Describes how XPA access points can be added to X Toolkit (Xt) programs.

DESCRIPTION

       XPA supports Xt programs: you can call XPANew(), XPACmdNew(), or XPAInfoNew() within any C routine to add XPA server callbacks to an Xt
       program.  Since an Xt program has its own event loop call (i.e., XtAppMainLoop()), it therefore does not need or want to use the XPA even
       loop.  Thus, in order to add XPA access points to the standard Xt event loop, the following routine should be called before entering the
       loop:

	 int XPAXtAddInput(XtAppContext app, XPA xpa)

       The XPAAddAddInput() routine will add XPA access points to the Xt event loop by making calls to the standard XtAppAddInput() routine. (If
       the XtAppContext argument is NULL, then the alternate XtAddInput() routine is used instead.)  If the xpa argument is NULL, then all active
       XPA access points are added to the loop.  If xpa is not NULL, then only the specified access point is added.  The latter type of call is
       used to add new access points from within a callback, after the program has entered the XtAppMainLoop() even loop.

SEE ALSO

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

version 2.1.14							   June 7, 2012 							  xpaxt(7)

xpaclient(3)							SAORD Documentation						      xpaclient(3)

NAME

       XPAClient -  The XPA Client-side Programming Interface

SYNOPSIS

       A description of the XPA client-side programming interface.

DESCRIPTION

       Introduction to XPA Client Programming

       Sending/receiving data to/from an XPA access point is easy: you generally only need to call the XPAGet() or XPASet() subroutines.

	 #include <xpa.h>

	 int XPAGet(XPA xpa,
	     char *template, char *paramlist, char *mode,
	     char **bufs, int *lens, char **names, char **messages, int n);

	 int XPASet(XPA xpa,
	     char *template, char *paramlist, char *mode,
	     char *buf, int len, char **names, char **messages, int n);

	 int XPAInfo(XPA xpa,
	     char *template, char *paramlist, char *mode,
	     char **names, char **messages, int n);

	 int XPAAccess(XPA xpa,
	     char *template, char *paramlist, char *mode,
	     char **names, char **messages, int n);

	 int XPAGetFd(XPA xpa,
	     char *template, char *paramlist, char *mode,
	     int *fds, char **names, char **messages, int n);

	 int XPASetFd(XPA xpa,
	     char *template, char *paramlist, char *mode,
	     int fd, char **names, char **messages, int n);

	 XPA XPAOpen(char *mode);

	 void XPAClose(XPA xpa);

	 int XPANSLookup(XPA xpa,
	     char *template, char *type,
	     char ***classes, char ***names, char ***methods, char ***infos);

       Introduction

       To use the XPA application programming interface, a software developer generally will include the xpa.h definitions file:

	 #include <xpa.h>

       in the software module that defines or accesses an XPA access point and then will link against the libxpa.a library:

	 gcc -o foo foo.c libxpa.a

       XPA has been compiled using both C and C++ compilers.

       Client communication with XPA public access points generally is accomplished using XPAGet() or XPASet() within a program (or xpaget and
       xpaset at the command line).  Both routines require specification of the name of the access point.  If a template is used to specify the
       access point name (e.g., "ds9*"), then communication will take place with all servers matching that template.

SEE ALSO

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

version 2.1.14							   June 7, 2012 						      xpaclient(3)