xpacmdadd(3) [debian man page]

xpacmdadd(3)							SAORD Documentation						      xpacmdadd(3)

NAME

       XPACmdAdd -  add a command to an XPA command public access point

SYNOPSIS

	 #include <xpa.h>

	 XPACmd XPACmdAdd(XPA xpa, char *name, char *help,
			  int (*send_callback)(),
			  void *send_data, char *send_mode,
			  int (*rec_callback)(),
			  void *rec_data,  char *rec_mode);

DESCRIPTION

       Add a command to an XPA command access point. The XPA argument specifies the XPA struct returned by a call to XPANewCmd(). The name argu-
       ment is the name of the command. The other arguments function identically to the arguments in the XPANew() command, i.e., the send_callback
       and rec_callback routines have identical calling sequences to their XPANew() counterparts, with the exceptions noted below.

       When help is requested for a command access point using:

	 xpaget -h class:name

       all of the command help strings are listed.  To get help for a given command, use:

	 xpaget -h class:name cmd

       Also, the acl keyword in the send_mode and receive_mode strings is global to the access point, not local to the command.  Thus, the value
       for the acl mode should be the same in all send_mode (or receive_mode) strings for each command in a command access point. (The acl for
       send_mode need not be the same as the acl for receive_mode, though).

SEE ALSO

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

version 2.1.14							   June 7, 2012 						      xpacmdadd(3)

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)