libvsmsocket
This C library provides a way to remotely exchange simple signals with a VSM instance via a TCP socket.
Building
To generate the Makefile using Autotools:
./autogen.sh
./configure
Then it's make as usual.
Using
First, initialise an instance to listen on a port and accept incoming
connections with vsm_socket_init(). Then wait for an incoming VSM client
connection with vsm_socket_accept().
The main loop is typically run in separate threads to read and write signals
with vsm_socket_receive() and vsm_socket_send() and its variants for each
primitive type.
Then call vsm_socket_close() to close a client connection, and finally
vsm_socket_free() to dispose of the vsm_socket instance.
Signals are exchanged in plain text using this standard format:
"signal=value\n"
To open a client connection from the VSM instance, use the ipc.SocketIPC
class with the hostname and port number of where the socket is listening.
Sample app: vsmsocket
A sample application vsmsocket is also provided and built along the
libvsmsocket.a static library to illustrate how to use it and for debugging
purposes. While it can be used with a regular VSM client, netcat or nc is a
good way of showing what it does or testing the library. For example, with one
shell for the server vsmsocket and another one for the client nc:
$ ./build/vsmsocket -p12345
$ nc localhost 12345
Signals entered on the server shell will be sent to the client, and the other way round when using the client shell.
White spaces are stripped around the signal and values, but there needs to be one equal sign. These signal strings are valid:
mySignal=123
hello = good-bye
However, these ones aren't valid and will raise an error:
hello
otherSignal someValue