Pid
A Pid-File is a file containing the process identification number (pid) that is stored in a well-defined location of the filesystem thus allowing other programs to find out the pid of a running script.
Daemons needs the pid of the scripts that are currently running in the background to send them so called signals. Daemons uses the TERM signal to tell the script to exit when you issue a stop command.
Pid-Files generated by Daemons have to following format:
<scriptname>.rb<number>.pid
(Note that <number> is omitted if only one instance of the script can run at any time)
Each file just contains one line with the pid as string (for example 6432).
Daemons is configurable to store the Pid-Files relative to three different locations:
in a directory relative to the directory where the script (the one that is supposed to run as a daemon) resides (:script option for :dir_mode)
in a directory given by :dir (:normal option for :dir_mode)
in the preconfigured directory /var/run (:system option for :dir_mode)
# File lib/daemons/pidfile.rb, line 53 def self.existing(path) new_instance = PidFile.allocate new_instance.instance_variable_set(:@path, path) def new_instance.filename @path end new_instance end
# File lib/daemons/pidfile.rb, line 33 def self.find_files(dir, progname, delete = false) files = Dir[File.join(dir, "#{progname}_num*.pid")] files = Dir[File.join(dir, "#{progname}.pid")] if files.size == 0 files.delete_if { |f| not (File.file?(f) and File.readable?(f)) } if delete files.delete_if do |f| pid = File.open(f) { |h| h.read }.to_i rsl = !Pid.running?(pid) if rsl puts "pid-file for killed process #{pid} found (#{f}), deleting." begin; File.unlink(f); rescue ::Exception; end end rsl end end files end
# File lib/daemons/pidfile.rb, line 65 def initialize(dir, progname, multiple = false) @dir = File.expand_path(dir) @progname = progname @multiple = multiple @number = nil @number = 0 if multiple if multiple while File.exist?(filename) && @number < 1024 @number += 1 end if @number >= 1024 fail RuntimeException('cannot run more than 1024 instances of the application') end end end
# File lib/daemons/pidfile.rb, line 98 def cleanup File.delete(filename) if pid == Process.pid end
# File lib/daemons/pidfile.rb, line 87 def exist? File.exist? filename end
# File lib/daemons/pidfile.rb, line 83 def filename File.join(@dir, "#{@progname}#{@number ? '_num' + @number.to_s : '' }.pid") end
# File lib/daemons/pidfile.rb, line 106 def pid begin File.open(filename) do |f| p = f.gets.to_i return nil if p == 0 # Otherwise an invalid pid file becomes pid 0 return p end rescue ::Exception return nil end end
Generated with the Darkfish Rdoc Generator 2.