The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

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

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.

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