NAME

RPC::Serialized::Server::STDIO - Run a simple RPC server on STDIN and STDOUT

SYNOPSIS

 use RPC::Serialized::Server::STDIO;
 
 # set up the new server
 my $s = RPC::Serialized::Server::STDIO->new;
 
 # begin a single-process loop handling requests on STDIN and STDOUT
 $s->process;

DESCRIPTION

This module provides a very simple way to run an RPC server. It uses the STDIN and STDOUT filehandles to read and write RPC calls and responses.

One use for this module is for testing; you can run a simple server as shown in the "SYNOPSIS" above, and test handlers by just typing CALLs into STDIN.

The more common use is that this modules serves as a base class from which to derive a more useful interface. The various UCSPI server modules do this.

There is no additional server configuration necessary, although you can of course supply arguments to new() as described in the RPC::Serialized manual page.

To start the server, issue the following command:

 $s->process;

AUTHOR

Oliver Gorwits <oliver.gorwits@oucs.ox.ac.uk>

This module is a derivative of YAML::RPC, written by pod and Ray Miller, at the University of Oxford Computing Services. Without their brilliant creation this system would not exist.

COPYRIGHT & LICENSE

Copyright (c) The University of Oxford 2007. All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA