OpenXM/doc/issac2000/openxm-clients.tex - diff

Return to openxm-clients.tex CVS log

Up to [local] / OpenXM / doc / issac2000

Diff for /OpenXM/doc/issac2000/openxm-clients.tex between version 1.9 and 1.12

version 1.9, 2000/01/17 00:48:06

version 1.12, 2000/01/17 07:15:52

Line 1

% $OpenXM: OpenXM/doc/issac2000/openxm-clients.tex,v 1.8 2000/01/16 10:58:19 takayama Exp $

% $OpenXM: OpenXM/doc/issac2000/openxm-clients.tex,v 1.11 2000/01/17 06:10:40 noro Exp $

\section{OpenXM Clients}

\subsection{Risa/Asir}

Risa/Asir provides a launcher to invoke an OpenXM server and to set up the

Risa/Asir provides a launcher {\tt ox\_launch}

communication between the server and itself. As a client,

to invoke an OpenXM server and to set up the

it provides many built-in functions for communication.

communication between the server and itself.

\subsubsection{Setting up servers}

{\tt ox\_launch} is a general purpose launcher. This application

invokes a server and sets up the server-client communication

according to the protocol stated in Section \ref{launcher}, then

itself becomes a control server.

Several facilities related to {{\tt ox\_launch}} are provided

as built-in functions of Risa/Asir: a function to invoke a server

automatically from a give host name and a server name, and a set

of functions to execute the port generation, {\tt bind}, {\tt listen},

{\tt connect} and {\tt accept} operations on sockets individually.

\subsubsection{Manipulating servers}

Fundamental operations on OpenXM servers are

exchange of {\tt OX} data and sending of {\tt SM} commands.

exchange of OX data and sending of stack machine commands.

The following functions

As a client, Asir provides the following functions

are provided to execute these primitive operations:

to execute these primitive operations:

{\tt ox\_push\_cmo()} for pushing data to a server,

{\tt ox\_push\_cmo()} for pushing data,

{\tt ox\_push\_cmd()} for sending an {\tt SM} command to a server

{\tt ox\_push\_cmd()} for sending a stack machine command

and {\tt ox\_get()} for receiving data from a stream.

Some operations including the reset operation are realized by

Some operations including the reset operation are implemented by

combining these primitives. Among them, frequently used ones are

provided as built-in functions. We show several ones.

provided as built-in functions. We show some of them.

\begin{itemize}

\item {\tt ox\_pop\_cmo()}

Line 49 the function. It does not wait the termination of the

Line 36 the function. It does not wait the termination of the

After sending {\tt SM\_control\_reset\_connection} to a control server,

it completes the operations stated in Section \ref{control}.

\end{itemize}

Furthermore {\tt ox\_select()} is provided to detect streams ready for

Furthermore {\tt ox\_select()} is provided to detect if streams are ready for

reading. It is realized by the {\tt select()} system call and is used

reading. It is implemented by the {\tt select()} system call and is used

to avoid blocking on read operations.

\subsection{Mathematica}

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>