Risa/Asir

Risa/Asir provides a launcher ox_launch to invoke an OpenXM server and to set up the communication between the server and itself. Fundamental operations on OpenXM servers are exchange of OX data and sending of stack machine commands. As a client, Asir provides the following functions to execute these primitive operations: ox_push_cmo() for pushing data, ox_push_cmd() for sending a stack machine command and ox_get() for receiving data from a stream.

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 some of them.

• ox_pop_cmo()

  It requests a server to send data on the stack to the stream, then it receives the data from the stream.

• ox_cmo_rpc()

  After pushing the name of a function, arguments and the number of the arguments to the stack of a server, it requests the server to execute the function. It does not wait the termination of the function call.

• ox_reset()

  After sending SM_control_reset_connection to a control server, it completes the operations stated in Section 5.3.

Furthermore ox_select() is provided to detect if streams are ready for reading. It is implemented by the select() system call and is used to avoid blocking on read operations.