NAME

RPC::Serialized::Server::UCSPI::IPC - RPC server managed by ucspi-ipc

VERSION

version 1.123630

SYNOPSIS

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

DESCRIPTION

This module provides an extension to RPC::Serialized which enhances support for the ucspi-ipc network services system, produced by SuperScript Technology, Inc..

In ucspi-land, servers communicate using Standard Input and Standard Output, so things are very simple. The services system takes care of setting up a listening network socket, and forking off child handlers. Those child handlers are simple setup scripts just like that shown in the "SYNOPSIS" above.

Within the examples directory of this distribution, there is an example tcpserver startup script which can be easily adapted to use this module.

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

This module provides support for using the IPCREMOTEINFO environment variable in the call authorization phase of RPC::Serialized. Although not well documented, this is fully working and there are example scripts in this distribution.

THANKS

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.

AUTHOR

Oliver Gorwits <oliver@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by University of Oxford.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.