Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
STALEPID(1)		    General Commands Manual		   STALEPID(1)

NAME
       stalepid	-- check for and remove	stale process ID files

SYNOPSIS
       stalepid	[-bdhV]	pidfile	processname

DESCRIPTION
       The stalepid utility was	developed to facilitate	the startup of servers
       that  write their process ID to a file and refuse to start if that file
       exists (e.g. when the process was last terminated by an	unclean	 shut-
       down, or	simply killed, not given the chance to clean up	the process ID
       file).	The  stalepid utility is used to check for and possibly	remove
       those stale process ID files.  Upon its invocation, stalepid checks for
       the following conditions:

       -   the file specified by the pidfile argument exists;

       -   it contains a single	line, and the line contains a single number;

       -   there is no process with the	process	ID specified in	the  file,  or
	   if there is one, it is not named processname.

       If  all	those conditions are met, the stalepid utility will remove the
       file specified by the pidfile argument, thus allowing the next  invoca-
       tion of the server to proceed normally.

       The following options are available:

       -b      Invoke  the  ps(1) utility using	BSD syntax (the	default	behav-
	       ior).

       -d      Display diagnostic information during the course	of operation.

       -h      Display a short help message and	exit.

       -V      Display program version information and exit.

ENVIRONMENT
       Not taken in consideration in the present version.

FILES
       None relevant in	the present version.

HISTORY
       The stalepid utility was	developed by Peter Pentchev in 2003.

AUTHORS
       Peter Pentchev <roam@ringlet.net>.

FreeBSD	ports 15.0	       February	17, 2017		   STALEPID(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=stalepid&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help