Net::Server::Daemonize(U3s)er Contributed Perl DocumentatNieotn::Server::Daemonize(3)

NAME
       Net::Server::Daemonize - bdpf 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
         );

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.

EEXXPPOORRTTEEDD FFUUNNCCTTIIOONNSS
       daemonize
           Main routine.  Arguments are user (or userid), group (or group id
           or space delimited list of groups), and pidfile (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.

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

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

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

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

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

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

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

       checkpidfile
           Arguments are pidfile (full path to pidfile).  Checks for
           existance of pidfile.  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.

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

       unlinkpidfile
           Does just that.

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

AUTHORS       Jeremy Howard 

       Program flow, concepts and initial work.

       Paul Seamons 

       Code rework and componentization.  Ongoing maintainer.

LLIICCEENNSSEE
         Copyright (C) 2001, Jeremy Howard
                             j+daemonize@howard.fm

                             Paul T Seamons
                             perl@seamons.com
                             http://seamons.com/

         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.8.8                       2003-11-06         Net::Server::Daemonize(3)