mikehale-daemons 1.0.12.1

data/lib/daemons/pidfile.rb

@@ -0,0 +1,111 @@
+require 'daemons/pid'
+
+
+module Daemons
+
+  # === What is a Pid-File?
+  # A <i>Pid-File</i> is a file containing the <i>process identification number</i>
+  # (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.
+  #
+  # === How does a Pid-File look like?
+  #
+  # Pid-Files generated by Daemons have to following format:
+  #   <scriptname>.rb<number>.pid
+  # (Note that <tt><number></tt> 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 <tt>6432</tt>).
+  #  
+  # === Where are the Pid-Files stored?
+  # 
+  # Daemons is configurable to store the Pid-Files relative to three different locations:
+  # 1.  in a directory relative to the directory where the script (the one that is supposed to run
+  #     as a daemon) resides (<tt>:script</tt> option for <tt>:dir_mode</tt>)
+  # 2.  in a directory given by <tt>:dir</tt> (<tt>:normal</tt> option for <tt>:dir_mode</tt>)
+  # 3.  in the preconfigured directory <tt>/var/run</tt> (<tt>:system</tt> option for <tt>:dir_mode</tt>)
+  #
+  class PidFile < Pid
+
+    attr_reader :dir, :progname, :multiple, :number
+
+    def PidFile.find_files(dir, progname, delete = false)
+      files = Dir[File.join(dir, "#{progname}*.pid")]
+      
+      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
+    
+      return files
+    end
+    
+    def PidFile.existing(path)
+      new_instance = PidFile.allocate
+      
+      new_instance.instance_variable_set(:@path, path)
+      
+      def new_instance.filename
+        return @path
+      end
+      
+      return new_instance
+    end
+    
+    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) and @number < 1024
+          @number += 1
+        end
+        
+        if @number == 1024
+          raise RuntimeException('cannot run more than 1024 instances of the application')
+        end
+      end
+    end
+    
+    def filename
+      File.join(@dir, "#{@progname}#{ @number or '' }.pid")
+    end
+    
+    def exist?
+      File.exist? filename
+    end
+    
+    def pid=(p)
+      File.open(filename, 'w') {|f|
+        f.puts p   #Process.pid
+      }
+    end
+
+    def cleanup
+      File.delete(filename)
+    end
+
+    def pid
+      File.open(filename) {|f|
+        return f.gets.to_i
+      }
+    end
+
+  end
+  
+end

data/lib/daemons/pidmem.rb

@@ -0,0 +1,10 @@
+require 'daemons/pid'
+
+
+module Daemons
+
+  class PidMem < Pid
+    attr_accessor :pid
+  end
+
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification 
+name: mikehale-daemons
+version: !ruby/object:Gem::Version 
+  version: 1.0.12.1
+platform: ruby
+authors: 
+- Michael Hale
+- Thomas Uehlinger
+- Travis Whitton
+- Chris Kline
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-02-24 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: This is Daemons 1.0.10 with the addition of Chris Kline's fix from http://blog.rapleaf.com/dev/?p=19  Includes ability to change the process uid/gid. Also logdir can be specified seperate from piddir.  Daemons provides an easy way to wrap existing ruby scripts (for example a self-written server) to be run as a daemon and to be controlled by simple start/stop/restart commands.  If you want, you can also use daemons to run blocks of ruby code in a daemon process and to control these processes from the main application.  Besides this basic functionality, daemons offers many advanced features like exception backtracing and logging (in case your ruby script crashes) and monitoring and automatic restarting of your processes if they crash.  Daemons includes the daemonize.rb script written by Travis Whitton to do the daemonization process.
+email: mikehale@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- daemons.gemspec
+- lib/daemons/application.rb
+- lib/daemons/application_group.rb
+- lib/daemons/cmdline.rb
+- lib/daemons/controller.rb
+- lib/daemons/daemonize.rb
+- lib/daemons/exceptions.rb
+- lib/daemons/monitor.rb
+- lib/daemons/pid.rb
+- lib/daemons/pidfile.rb
+- lib/daemons/pidmem.rb
+- lib/daemons/etc_extension.rb
+- lib/daemons/change_privilege.rb
+- lib/daemons.rb
+- LICENSE
+- Rakefile
+- README
+- Releases
+- TODO
+has_rdoc: false
+homepage: http://github.com/mikehale/daemons
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A toolkit to convert your script to a controllable daemon (with Chris Kline's fix)
+test_files: []
+