LICENSE.txt @@ -5,12 +5,12 @@ Gem::Specification.new do |s| s.summary = "A library for implementing daemon management capabilities" s.email = "hongli@phusion.nl" s.homepage = "http://github.com/FooBarWidget/daemon_controller/tree/master" - s.description = "A library for implementing daemon management capabilities." - s.has_rdoc = false + s.description = "A library for robust daemon management." + s.has_rdoc = true s.authors = ["Hongli Lai"] s.files = [ - "README.rdoc", "LICENSE.txt", "daemon_controller.gemspec", + "README.markdown", "LICENSE.txt", "daemon_controller.gemspec", "lib/daemon_controller.rb", "lib/daemon_controller/lock_file.rb", "spec/daemon_controller_spec.rb", daemon_controller.gemspec @@ -1,20 +1,29 @@ -# Basic functionality for a single, local, external daemon: -# - starting daemon -# * must be concurrency-safe! -# * must be able to report startup errors! -# * returns when daemon is fully operational -# - stopping daemon -# * must be concurrency-safe! -# * returns when daemon has exited -# - querying the status of a daemon -# * querying the status of a daemon (i.e. whether it's running) -# - connect to a daemon, and start it if it isn't already running -# * must be a single atomic action +# daemon_controller, library for robust daemon management +# Copyright (c) 2008 Phusion +# +# Permission is hereby granted, free of charge, to any person obtaining a copy +# of this software and associated documentation files (the "Software"), to deal +# in the Software without restriction, including without limitation the rights +# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +# copies of the Software, and to permit persons to whom the Software is +# furnished to do so, subject to the following conditions: +# +# The above copyright notice and this permission notice shall be included in +# all copies or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +# THE SOFTWARE. require 'tempfile' require 'fcntl' require File.expand_path(File.dirname(__FILE__) << '/daemon_controller/lock_file') +# Main daemon controller object. See the README for an introduction and tutorial. class DaemonController ALLOWED_CONNECT_EXCEPTIONS = [Errno::ECONNREFUSED, Errno::ENETUNREACH, Errno::ETIMEDOUT, Errno::ECONNRESET] @@ -88,8 +97,8 @@ class DaemonController # The default value is +nil+. # # [:before_start] - # This may be a Proc. It will be called just before running the start command. - # The before_start proc is not subject to the start timeout. + # This may be a Proc. It will be called just before running the start command. + # The before_start proc is not subject to the start timeout. # # [:start_timeout] # The maximum amount of time, in seconds, that #start may take to start lib/daemon_controller.rb @@ -1,3 +1,24 @@ +# daemon_controller, library for robust daemon management +# Copyright (c) 2008 Phusion +# +# Permission is hereby granted, free of charge, to any person obtaining a copy +# of this software and associated documentation files (the "Software"), to deal +# in the Software without restriction, including without limitation the rights +# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +# copies of the Software, and to permit persons to whom the Software is +# furnished to do so, subject to the following conditions: +# +# The above copyright notice and this permission notice shall be included in +# all copies or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +# THE SOFTWARE. + class DaemonController class LockFile def initialize(filename) lib/daemon_controller/lock_file.rb 288d93d669cd3e125569973bb6a3a4e00d6361c2 Hongli Lai (Phusion) hongli@phusion.nl http://github.com/FooBarWidget/daemon_controller/commit/b6c5eb47582e1acdea84dd9e3bb2b03103e10b6d b6c5eb47582e1acdea84dd9e3bb2b03103e10b6d 2008-08-24T03:07:24-07:00 2008-08-24T03:07:24-07:00 Add license and update API documentation. 86bd8a6f2f0a86125043cb62f40468336bd6365a Hongli Lai (Phusion) hongli@phusion.nl