MAN page from Old RedHat 7.X perl-Server-FastPL-1.0.0-8.i386.rpm

Server::FastPL::Server

Section: User Contributed Perl Documentation (3)
Updated: perl v5.6.0
Index

NAME

Server::FastPL::Server - Add client-server behavior to scripts.

VERSION

This document refers to version 1.00 of Server::FastPL::Server,released April 10, 2000.

SYNOPSIS

   use Server::FastPL::Server

   my $fps = new Server::FastPL::Server(NAME=>"Test",MAX_CHILDS=>5,DEBUG=>1);

   while ($client = $fps->receive_connect()) {      ...   }

DESCRIPTION

Overview

This module adds server behavior to non-server scripts. It works by forking your script into MAX_CHILDS child processes. Unix sockets are used for communicatingbetween the server children and the client script (see Server::FastPL::Client). The model loosely resembles CGI::Fast.

Contructor and initialization

$fps = new Server::FastPL::Server(
# REQUIRED: This is the name of the socket file
NAME => ``Test'',
# Socket files dir. ``/tmp/'' as default.
SOCKET_DIR => ``/tmp/'',
# Number of children to fork, 5 as default.
MAX_CHILDS => 5,
# Debug flag for child processes. 0 as default.
DEBUG => 0 ) || die $!;

Class and object methods

$client = $fps->receive_connect();

This method waits for a connection and returns a FileHandle (a Socket) forinput/output to the server.

ENVIRONMENT

Signals:

This module uses two signals: USR1 and CHLD. Do not use these in yourscript or the server will not work.

Child processes:

The number of running child processes, established by MAX_CHLD, is maintained by the mother process.

DIAGNOSTICS

All error messages are passed to $!. Use it in your script to detect errors.

BUGS

Currently the environment hash (%ENV) is not automatically passed from the client to the server. If you want this functionality you must do this yourself (using this object's socket :) .

FILES

The module creates the folowing files in directory SOCKET_DIR:

NAME The main socket
NAME.x A socket for each child
NAME.fifo Communication between the mother and children processes.

AUTHOR

Daniel Ruoso(danielAATTruoso.com)

COPYRIGHT

This document was created byman2html,using the manual pages.