Class: Daemons::Pid

Inherits:
Object
  • Object
show all
Defined in:
lib/daemons/pid.rb

Direct Known Subclasses

PidFile, PidMem

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initializePid

Initialization method


51
52
# File 'lib/daemons/pid.rb', line 51

def initialize
end

Class Method Details

.dir(dir_mode, dir, script) ⇒ Object

Returns the directory that should be used to write the pid file to depending on the given mode.

Some modes may require an additionaly hint, others may determine the directory automatically.

If no valid directory is found, returns nil.


34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
# File 'lib/daemons/pid.rb', line 34

def self.dir(dir_mode, dir, script)
  # nil script parameter is allowed as long as dir_mode is not :script
  return nil if dir_mode == :script && script.nil?

  case dir_mode
    when :normal
      return File.expand_path(dir)
    when :script
      return File.expand_path(File.join(File.dirname(script), dir))
    when :system
      return '/var/run'
    else
      fail Error.new("pid file mode '#{dir_mode}' not implemented")
  end
end

.running?(pid) ⇒ Boolean

Returns:

  • (Boolean)

5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# File 'lib/daemons/pid.rb', line 5

def self.running?(pid)
  return false unless pid

  # Check if process is in existence
  # The simplest way to do this is to send signal '0'
  # (which is a single system call) that doesn't actually
  # send a signal
  begin
    Process.kill(0, pid)
    return true
  rescue TimeoutError
    raise
  rescue Errno::ESRCH
    return false
  rescue ::Exception   # for example on EPERM (process exists but does not belong to us)
    return true
  # rescue Errno::EPERM
  #  return false
  end
end

Instance Method Details

#cleanupObject

Cleanup method


68
69
# File 'lib/daemons/pid.rb', line 68

def cleanup
end

#exist?Boolean

Exist? method

Returns:

  • (Boolean)

72
73
74
# File 'lib/daemons/pid.rb', line 72

def exist?
  true
end

#pidObject

Get method


55
56
# File 'lib/daemons/pid.rb', line 55

def pid
end

#pid=(p) ⇒ Object

Set method


59
60
# File 'lib/daemons/pid.rb', line 59

def pid=(p)
end

#running?Boolean

Check whether the process is running

Returns:

  • (Boolean)

63
64
65
# File 'lib/daemons/pid.rb', line 63

def running?
  Pid.running?(pid)
end