net::server::daemonize(3) [osx man page]

Net::Server::Daemonize(3)				User Contributed Perl Documentation				 Net::Server::Daemonize(3)

NAME

       Net::Server::Daemonize - Safe fork and daemonization utilities

SYNOPSIS

	   use Net::Server::Daemonize qw(daemonize);

	   daemonize(
	     'nobody',		       # User
	     'nobody',		       # Group
	     '/var/state/mydaemon.pid' # Path to PID file - optional
	   );

DESCRIPTION

       This module is intended to let you simply and safely daemonize your server on systems supporting the POSIX module. This means that your
       Perl script runs in the background, and it's process ID is stored in a file so you can easily stop it later.

EXPORTED FUNCTIONS

       daemonize
	   Main routine.  Arguments are user (or userid), group (or group id or space delimited list of groups), and pid_file (path to file).
	   This routine will check on the pid file, safely fork, create the pid file (storing the pid in the file), become another user and group,
	   close STDIN, STDOUT and STDERR, separate from the process group (become session leader), and install $SIG{INT} to remove the pid file.
	   In otherwords - daemonize.  All errors result in a die.  As of version 0.89 the pid_file is optional.

       safe_fork
	   Block SIGINT during fork.  No arguments.  Returns pid of forked child.  All errors result in a die.

       set_user
	   Become another user and group.  Arguments are user (or userid) and group (or group id or space delimited list of groups).

       set_uid
	   Become another user.  Argument is user (or userid).	All errors die.

       set_gid
	   Become another group.  Arguments are groups (or group ids or space delimited list of groups or group ids).  All errors die.

       get_uid
	   Find the uid.  Argument is user (userid returns userid).  Returns userid.  All errors die.

       get_gid
	   Find the gids.  Arguments are groups or space delimited list of groups.  All errors die.

       is_root_user
	   Determine if the process is running as root.  Returns 1 or undef.

       check_pid_file
	   Arguments are pid_file (full path to pid_file).  Checks for existance of pid_file.  If file exists, open it and determine if the
	   process that created it is still running.  This is done first by checking for a /proc file system and second using a "ps" command (BSD
	   syntax).  (If neither of these options exist it assumed that the process has ended) If the process is still running, it aborts.
	   Otherwise, returns true.  All errors die.

       create_pid_file.
	   Arguments are pid_file (full path to pid_file).  Calls check_pid_file.  If it is successful (no pid_file exists), creates a pid file
	   and stores $$ in the file.

       unlink_pid_file
	   Does just that.

SEE ALSO

       Net::Server.  Net::Daemon, The Perl Cookbook Recipe 17.15.

AUTHORS

       Jeremy Howard <j+daemonize@howard.fm>

       Program flow, concepts and initial work.

       Paul Seamons <paul@seamons.com>

       Code rework and componentization.  Ongoing maintainer.

LICENSE

	 This package may be distributed under the terms of either the
	 GNU General Public License
	   or the
	 Perl Artistic License

	 All rights reserved.

perl v5.16.2							    2012-05-29						 Net::Server::Daemonize(3)

Check Out this Related Man Page

Net::Server::MultiType(3)				User Contributed Perl Documentation				 Net::Server::MultiType(3)

NAME

       Net::Server::MultiType - Net::Server personality

SYNOPSIS

	 use Net::Server::MultiType;
	 @ISA = qw(Net::Server::MultiType);

	 sub process_request {
	    #...code...
	 }

	 my @types = qw(PreFork Fork Single);

	 Net::Server::MultiType->run(server_type=>@types);

DESCRIPTION

       Please read the pod on Net::Server first.  This module is a personality, or extension, or sub class, of the Net::Server module.

       This personality is intended to allow for easy use of multiple Net::Server personalities.  Given a list of server types,
       Net::Server::MultiType will require one at a time until it finds one that is installed on the system.  It then adds that package to its
       @ISA, thus inheriting the methods of that personality.

ARGUMENTS

       In addition to the command line arguments of the Net::Server base class, Net::Server::MultiType contains one other configurable parameter.

	 Key		   Value	    Default
	 server_type	   'server_type'    'Single'

       server_type
	   May be called many times to build up an array or possible server_types.  At execution, Net::Server::MultiType will find the first
	   available one and then inherit the methods of that personality

CONFIGURATION FILE

       "Net::Server::MultiType" allows for the use of a configuration file to read in server parameters.  The format of this conf file is simple
       key value pairs.  Comments and white space are ignored.

	 #-------------- file test.conf --------------

	 ### multi type info
	 ### try PreFork first, then go to Single
	 server_type PreFork
	 server_type Single

	 ### server information
	 min_servers   20
	 max_servers   80
	 spare_servers 10

	 max_requests  1000

	 ### user and group to become
	 user	     somebody
	 group	     everybody

	 ### logging ?
	 log_file    /var/log/server.log
	 log_level   3
	 pid_file    /tmp/server.pid

	 ### access control
	 allow	     .+.(net|com)
	 allow	     domain.com
	 deny	     a.+

	 ### background the process?
	 background  1

	 ### ports to bind
	 host	     127.0.0.1
	 port	     localhost:20204
	 port	     20205

	 ### reverse lookups ?
	 # reverse_lookups on

	 #-------------- file test.conf --------------

PROCESS FLOW

       See Net::Server

HOOKS

       There are no additional hooks in Net::Server::MultiType.

TO DO

       See Net::Server

AUTHOR

       Paul T. Seamons paul@seamons.com

SEE ALSO

       Please see also Net::Server::Fork, Net::Server::INET, Net::Server::PreFork, Net::Server::MultiType, Net::Server::Single

perl v5.12.1							    2007-02-02						 Net::Server::MultiType(3)

Linux and UNIX Man Pages

net::server::daemonize(3) [osx man page]

Check Out this Related Man Page