pidfilehack(8) [debian man page]

pidfilehack(8)						      System Manager's Manual						    pidfilehack(8)

NAME

       pidfilehack - work around daemons that always fork

SYNOPSIS

       pidfilehack servicename pidfile command [parameters]

DESCRIPTION

       pidfilehack is used to work around daemons that insist on forking into the background, but that do write a correct pid file.

       pidfilehack  forks  the	actual	service,  then waits for the pidfile to be written. Once it can read the pid from the pidfile it will tell
       minit the real pid and quit.

USAGE

       usually pidfilehack is symlinked as run command of a service.

       servicename
	      the name of the service pidfilehack is installed for.

       pidfile
	      the filename to read the pid from

       command
	      the real command to start

       parameters
	      additional parameters for the command

	      A typical use of this command will look like this:

       /etc/minit/apache

       /etc/minit/apache/params
	      apache
	      /var/run/apache.pid
	      apachectl
	      start

       /etc/minit/apache/run
	      -> /sbin/pidfilehack

AUTHOR

       minit was written by Felix von Leitner and can be downloaded from his page at http://www.fefe.de/minit/

       This manpage was written by Erich Schubert <erich@debian.org> for the Debian GNU/Linux operating system.

SEE ALSO

       msvc(8), pidfilehack(8)

																    pidfilehack(8)

File::Pid(3pm)						User Contributed Perl Documentation					    File::Pid(3pm)

NAME

       File::Pid - Pid File Manipulation

SYNOPSIS

	 use File::Pid;

	 my $pidfile = File::Pid->new({
	   file => '/some/file.pid',
	 });

	 $pidfile->write;

	 if ( my $num = $pidfile->running ) {
	     die "Already running: $num
";
	 }

	 $pidfile->remove;

DESCRIPTION

       This software manages a pid file for you. It will create a pid file, query the process within to discover if it's still running, and remove
       the pid file.

       new

	 my $pidfile = File::Pid->new;

	 my $thisfile = File::Pid->new({
	   file => '/var/run/daemon.pid',
	 });

	 my $thisfileandpid = File::Pid->new({
	   file => '/var/run/daemon.pid',
	   pid	=> '145',
	 });

       This constructor takes two optional paramters.

       "file" - The name of the pid file to work on. If not specified, a pid file located in "File::Spec->tmpdir()" will be created that matches
       "(File::Basename::basename($0))[0] . '.pid'". So, for example, if $0 is ~/bin/sig.pl, the pid file will be /tmp/sig.pl.pid.

       "pid" - The pid to write to a new pidfile. If not specified, $$ is used when the pid file doesn't exist. When the pid file does exist, the
       pid inside it is used.

       file

	 my $pidfile = $pidfile->file;

       Accessor/mutator for the filename used as the pid file.

       pid

	 my $pid = $pidfile->pid;

       Accessor/mutator for the pid being saved to the pid file.

       write

	 my $pid = $pidfile->write;

       Writes the pid file to disk, inserting the pid inside the file.	On success, the pid written is returned. On failure, "undef" is returned.

       running

	 my $pid = $pidfile->running;
	 die "Service already running: $pid
" if $pid;

       Checks to see if the pricess identified in the pid file is still running. If the process is still running, the pid is returned. Otherwise
       "undef" is returned.

       remove

	 $pidfile->remove or warn "Couldn't unlink pid file
";

       Removes the pid file from disk. Returns true on success, false on failure.

       program_name

       This is a utility method that allows you to determine what "File::Pid" thinks the program name is. Internally this is used when no pid file
       is specified.

SEE ALSO

       perl.

AUTHOR

       Casey West, <casey@geeknest.com>.

COPYRIGHT

	 Copyright (c) 2005 Casey West.  All rights reserved.
	 This module is free software; you can redistribute it and/or modify it
	 under the same terms as Perl itself.

perl v5.8.8							    2008-04-05							    File::Pid(3pm)