win32-service 0.6.1-x86-mswin32-60

data/CHANGES

@@ -0,0 +1,217 @@
+== 0.6.1 - 1-Jan-2008
+* The Service.services method now handles the scenario where a particular
+  service may still exist, but its underlying registry entry has been deleted.
+  In this case, most ServiceInfo struct members are set to nil and a warning
+  is issued.
+* RDoc updates.
+
+== 0.6.0 - 25-Nov-2007
+* The Service control class is now pure Ruby. The Daemon class is still C,
+  however. That may change in the future. This means the windows-pr
+  library is now a prerequisite.
+* The Service.new method has been altered in a way that is not backwards
+  compatible. It is now the same as Service.create.
+* The Service.start method now properly handles arguments to the
+  Daemon#service_main method.
+* The Daemon source code is now separate from the Service control class
+  source code. That means you must require them separately, as needed.
+* The Daemon class should be much more responsive to service events now,
+  especially service_stop. Many thanks go to Kevin Burge for the patch.
+* Added the Daemon.mainloop method as a shortcut for Daemon.new.mainloop.
+* The Daemon class now redirects STDIN, STDOUT and STDERR to the NUL device
+  if they're still associated with a terminal when the service starts. This
+  should help prevent Errno::EBADF errors.
+* The Service.services class method now supports the group parameter for
+  versions of Ruby built with older compilers, i.e. it will now work with
+  the one-click Ruby installer.
+* The Service.getdisplayname method was changed to Service.get_display_name.
+  An alias has been provided for backwards compatibility.
+* The Service.getservicename method was changed to Service.get_service_name.
+  An alias has been provided for backwards compatibility.
+* Added the Service.config_info method.
+* The Service.create and Service.configure methods now allow you to set
+  failure actions, failure commands, and reset/retry periods.
+* Improved test suite.
+* Changed 'tdaemon.rb', 'tdaemon_ctl.rb' and 'service_test.rb' to
+  'demo_daemon.rb', 'demo_daemon_ctl.rb' and 'demo_services.rb', respectively.
+* Some refactoring and updates to the demo daemon and demo daemon controller
+  examples.
+* The Win32Service struct is now ServiceInfo.
+* ServiceError is now Service::Error.
+* DaemonError is now Daemon::Error.
+* Some documentation improvements, corrections and updates.
+
+== 0.5.2 - 25-Nov-2006
+* Fixed a bug in the Daemon class where the service event handling methods
+  (most notably service_stop) did not work properly due to thread blocking
+  issues.  Many thanks go to Patrick Hurley for the patch.
+* Added the Daemon#running? method as helper method for your service_main
+  method.
+* The 'interactive?' struct member is now just 'interactive'.  This was
+  supposed to have been in the last release but was somehow missed.  Sorry.
+* Scrapped the old daemon_test.rb file and split it into two new files -
+  tdaemon.rb and tdaemon_ctl.rb.  In the process a few bugs were fixed.
+* Added a gemspec.
+* Documentation and test suite updates.
+
+== 0.5.1 - 18-Jun-2006
+* Added the Service.open method.
+* The Service.new method now accepts a block, and automatically closes itself
+  at the end of the block.
+* Fixed in a bug in the Service.create method where setting dependencies
+  was not working properly.  Thanks go to Scott Harper for the spot.
+* The 'interactive?' struct member is now just 'interactive' since Ruby no
+  longer supports question marks in struct member names.  UGH.
+* The block for Service#configure_service is no longer optional.
+* Replaced ClipSrv with W32Time for most of the test methods in tc_service.rb
+  because it had a dependency that is disabled on most systems.
+* Added a tweak to the extconf.rb file to help with the test suite.
+* Some documentation updates and corrections.
+
+== 0.5.0 - 26-Nov-2005
+* Added a service_init hook, and (internally) altered the way the service
+  starts.  This was done to deal with services that need to perform any
+  initialization in the Daemon itself before the service starts.  Previously
+  this would result in the service timing out during startup.
+  
+  Thanks go to Jamey Cribbs for spotting the problem.
+  
+* Modified the Daemon example, adding a service_init hook that does about 10
+  seconds worth of initialization before finally starting.  See the comments
+  in examples\daemon_test.rb for more information.
+* Minor test and README changes.
+
+== 0.4.6 - 24-May-2005
+* Fixed an initialization bug that could cause Daemons to fail unless the
+  win32-service package was the last package require'd.
+* Altered the Service.start method.  It now takes any number of arguments
+  (after the service and host name).  These arguments are passed to the
+  service's Service_Main() function.
+* The Service.services method now returns an Array of ServiceStruct's in
+  non-block form.
+* The Service.start, Service.pause, Service.resume, Service.stop and
+  Service.delete methods now return the class (self), not 'true'.
+* Added the ability to add or configure the service description in
+  Service#create_service or Service#configure, respectively.
+* Fixed a bug in the Service.start method where false positives could result.
+* Updated the ServiceStatus struct to include pid and service_flags on Win2k
+  or later.
+* Unicode is now the default setting as far as internal string handling.  It
+  will still work fine with 'regular' text.
+* Added safe string handling for string input values.
+* Added rdoc comments into the C source.
+* Made the service.txt and daemon.txt files rdoc friendly.
+* Removed the service.rd and daemon.rd files.  If you want html documentation,
+  run rdoc over the service.txt and daemon.txt files.
+* The dreaded "code cleanup".
+
+== 0.4.5 - 28-Feb-2005
+* Fixed an accessor bug in Service#create.  Thanks go to Nathaniel Talbott
+  for the spot.
+* Eliminated a warning that appeared starting in Ruby 1.8.2 regarding Struct
+  redefinitions.
+* Moved 'examples' directory to toplevel directory.
+* Deleted the 'test2.rb' example.  This was supplanted by the 'daemon_test.rb'
+  script.
+* Renamed the 'test.rb' file to 'services_test.rb'.
+* Made this document rdoc friendly.
+
+== 0.4.4 - 27-Aug-2004
+* Modified the Service class to use the newer allocation framework.  The
+  Daemon class already used this, hence no major version bump.
+* Fixed in a bug in the create_service() method with regards to the
+  'dependencies' option and null arguments (you no longer need to specify
+  an empty array).
+
+== 0.4.3 - 14-Aug-2004
+* Fixed the Daemon class by adding back the constants it needed in order to
+  run.  I accidentally broke this when I changed the Daemon class from being
+  a subclass of Service to being its own class.
+* Added a separate test suite for the Daemon class, tc_daemon.rb, to help
+  me from making that mistake ever again. :)
+* Updated the daemon_test.rb script a bit to report error messages should
+  any occur.
+* Minor doc updates
+
+== 0.4.2 - 10-Jul-2004
+* The Daemon class is no longer a subclass of Service.
+* Added the 'pid' and 'service_flags' struct members to the Win32Service
+  struct.  These members are only available to folks using Windows 2000 or
+  later and who compile with VC++ 7.0 or later (including the .NET SDK).
+* The Service.services method now accepts a group name as an optional third
+  argument.  Again, you must be using Windows 2000 or later and compile with
+  VC++ 7.0 or later (including the .NET SDK).
+* The deprecated STR2CSTR() functions were replaced with StringValuePtr().
+  This also means that as of this version, win32-service requires Ruby
+  1.8.0 or greater.
+* Moved the sample programs to doc/examples
+* Removed the .html files under /doc.  You can generate that on your own if
+  you like.
+
+== 0.4.1 - 14-Mar-2004
+* Added the exists? class method and corresponding test suite additions.
+* Pushed the ServiceError and DaemonError classes under the Win32 module.
+* Normalized tc_service.rb so that it can be run outside of the test directory
+  more easily.
+
+== 0.4.0 - 9-Feb-2004
+* Changed "worker" method to "service_main" method.
+* Added event hooks for stop, pause, resume, etc.  See the documentation for
+  further details.  (Thanks Park Heesob)
+* Some of the Daemon functions were raising ServiceError.  They have been
+  changed to DaemonError.
+* Updated the daemon_test.rb file to use the new event hooks.
+* Documentation additions and updates.
+
+== 0.3.0 - 31-Jan-2004
+* Added a Daemon subclass.  This allows you to run Ruby programs as a service.
+  Please see the documentation for more details. (Thanks Park Heesob).  This
+  should be considered an ALPHA release.
+* The Win32ServiceError class has been renamed to just ServiceError.  I felt
+  the "Win32" was redundant, given that it's already under the Win32 module.
+* In some cases a bogus error description was being returned because the
+  GetLastError() function was being called too late.  This has been fixed.
+  (Thanks Park Heesob).
+* The explicit garbage collection has been removed because what I thought was
+  a memory leak was not, in fact, a memory leak.  In addition, it was hurting
+  performance badly.
+* The "\r\n" is now automatically stripped from error messages.  This was
+  causing slightly garbled error messages.  (Thanks Park Heesob).
+* Added explicit closing of the Service Control Manager handle in the
+  services() function for those rare cases where it may fail while reading
+  service information.
+* Made some of the error strings a bit more descriptive.
+* Test suite and documentation additions, including a sample daemon program
+  in the test directory called "daemon_test.rb".
+
+== 0.2.2 - 15-Jan-2004
+* Fixed a mistake in the service_init declaration within Init_service().
+* Fixed bug in the service_init function with regards to desired access.
+* Modified service_free() function to explicitly set the hSCManager handle
+  to NULL and modified the service_close() method to test hSCManager handle
+  for NULL value.  This should eliminate accidentally trying to close an
+  already closed handle, which may have happened as the result of a free()
+  call. (Thanks Park Heesob).
+* Added explicit garbage collection in Service.services() method.
+* More explicit about closing open HANDLE's when error conditions arise.
+
+== 0.2.1 - 2-Nov-2003
+* Made the exported less redundant and less verbose, e.g.
+  Service::SERVICE_DISABLED is now just Service::DISABLED.  The same is true
+  for the service control constants, i.e. the 'SC_' has been removed.
+* Corresponding test suite changes.
+
+== 0.2.0 - 16-Oct-2003
+* The constructor has been changed.  It now only takes a machine name and a
+  desired access for arguments.  The keyword arguments are now part of the
+  create_service method() and only in block form.  See the documentation for
+  more details.
+* Added a configure_service() and close() instance methods.
+* Added several new constants to allow finer control over created and
+  configured services.
+* Added Win32ServiceError as an exception.  All failures now raise this
+  error instead of a vanilla StandardError.
+* Moved some common code into the service.h file.
+
+== 0.1.0 - 10-Oct-2003
+- Initial release

data/MANIFEST

@@ -0,0 +1,18 @@
+* MANIFEST
+* CHANGES
+* README
+* Rakefile
+* win32-service.gemspec
+* doc/daemon.txt
+* doc/service.txt
+* ext/extconf.rb
+* ext/win32/daemonc.c
+* examples/demo_daemon.rb
+* examples/demo_daemon_ctl.rb
+* examples/demo_services.rb
+* lib/win32/service.rb
+* test/tc_daemon.rb
+* test/tc_service_create.rb
+* test/tc_service_info.rb
+* test/tc_service_status.rb
+* test/tc_service.rb

data/README

@@ -0,0 +1,44 @@
+= Description
+The win32-service library allows you to control or create MS Windows services.
+
+= Installation
+rake test (optional)
+rake install
+
+= Documentation
+Please see the documentation in the 'doc' directory, or the gem documentation
+that was installed when you installed this library as a gem.
+
+= Possible errors
+* Service.delete causes "Unable to delete: The specified service has
+been marked for deletion."
+ 
+This can be caused by two things.  Either you attempted to delete a running
+service without stopping it first, or you have the Services administrative 
+tool (GUI) open.  The solution is to first stop the service if it's running
+and close the Services GUI admin tool before deleting.
+	
+* Service.start causes, "The service did not respond to the start or control
+request in a timely fashion."
+
+The best way to debug your services is to wrap your entire Daemon subclass
+in a begin/end block and send error messages to a file. That should give a
+good clue as to the nature of the problem. The most probable culprits are:
+
+* You've tried to require a library that's not in your $LOAD_PATH. Make sure
+that your require statements are inside the begin/rescue block so that you can
+easily find those mistakes.
+
+* Your have a bad binary path name. Be sure to use an absolute path name for
+the binary path name, including the full path to the Ruby interpreter, e.g.
+'c:\ruby\bin\ruby' instead of just 'ruby'.
+
+* You've got a syntax error in your code somewhere.
+
+= Possible test failures
+The 'test_service_start_stop' test in the tc_service.rb file may fail. This
+will happen if your W32Time service isn't running.
+
+= Future Plans
+* Pure Ruby Daemon class
+* Add service_session_change hook

data/doc/daemon.txt

@@ -0,0 +1,155 @@
+= Description
+   The Daemon class is a wrapper class that allows you to run your code as a
+   Windows service.
+
+= Synopsis
+   class Daemon
+      def service_main
+         while running?
+            sleep 3
+            File.open("c:\\test.log","a+"){ |f| f.puts "service is running" }
+         end
+      end
+   end
+
+   Daemon.mainloop
+    
+= Class Methods
+Daemon.mainloop
+   This is the method that actually puts your code into a loop and allows it
+   to run as a service. The code that is actually run while in the mainloop
+   is what you defined in the Daemon#service_main method.
+
+= Instance Methods 
+Daemon#running?
+   Returns whether or not the daemon is running. This is just a shortcut
+   for checking if the state is RUNNING, PAUSED or IDLE.
+   
+   This is typically used within your service_main method. See the
+   demo_daemon.rb file in the 'examples' directory for an example of how it's
+   used in practice.
+   
+Daemon#service_init
+   Any code defined defined within this method occurs before service_main is
+   reached. Any initialization code that takes more than two seconds to
+   execute should be placed here. Otherwise, your service may timeout when
+   you try to start it.
+  
+Daemon#service_main(*args)
+   You are expected to define your own service_main() method.  The code
+   defined in this method is the code that will run while running as a
+   service.
+   
+   Any +args+ passed to Service.start are passed to this method.
+    
+Daemon#state
+   Returns the current state of the Daemon. For a list of valid states, see
+   the Constants section below.
+    
+= Signal Event Hooks
+   These methods are called if defined within your Daemon class, and the
+   appropriate signal is received by your service.
+
+Daemon#service_stop
+   Called if the service receives a SERVICE_CONTROL_STOP signal. This is
+   what the Service.stop() method sends.
+
+Daemon#service_pause
+   Called if the service receives a SERVICE_CONTROL_PAUSE signal. This is
+   what the Service.pause() method sends.
+    
+Daemon#service_resume
+   Called if the service receives a SERVICE_CONTROL_CONTINUE signal. This
+   is what the Service.resume() method sends.
+    
+Daemon#service_interrogate
+   Called if the service receives a SERVICE_CONTROL_INTERROGATE signal. This
+   notifies a service that it should report its current status information to
+   the service control manager.
+    
+Daemon#service_shutdown
+   Called if the service receives a SERVICE_CONTROL_SHUTDOWN signal.
+    
+Daemon#service_netbindadd
+   Called if the service receives a SERVICE_CONTROL_NETBINDADD signal. This
+   notifies a network service that there is a new component for binding.
+    
+Daemon#service_netbinddisable
+   Called if the service receives a SERVICE_CONTROL_NETBINDDISABLE signal.
+   This notifies a network service that one of its bindings has been
+   disabled.
+    
+Daemon#service_netbindenable
+   Called if the service receives a SERVICE_CONTROL_NETBINDENABLE signal.
+   This  Notifies a network service that a disabled binding has been enabled.
+
+Daemon#service_netbindremove
+   Called if the service receives a SERVICE_CONTROL_NETBINDREMOVE signal.
+   This notifies a network service that that a component for binding has
+   been removed.
+
+Daemon#service_paramchange
+   Called if the service receives a SERVICE_CONTROL_PARAMCHANGE signal.
+   This notifies a service that its startup parameters have changed.
+
+= Constants
+
+=== Service state constants
+Daemon::CONTINUE_PENDING
+   The service continue is pending.
+
+Daemon::PAUSE_PENDING
+   The service pause is pending.
+
+Daemon::PAUSED
+   The service is paused (but not STOPPED).
+
+Daemon::RUNNING
+   The service is running.
+
+Daemon::START_PENDING
+   The service is starting (but is not yet in a RUNNING state).
+
+Daemon::STOP_PENDING
+   The service is stopping (but is not yet in a STOPPED state).
+
+Daemon::STOPPED
+   The service is not running.
+   
+Daemon::IDLE
+   The service is running, in an idle state. This is a custom state that
+   we added that gets around a thread blocking issue.
+    
+= Notes
+   You must create a service before you can actually run it. Look in the
+   examples directory for the files 'demo_daemon.rb' and 'demodaemon_ctl.rb'.
+   They're small and straightforward examples of how to control, install and
+   setup your own Daemon.
+
+= Known Bugs
+   None known.  Please report any bugs you find on the Bug tracker at
+   http://rubyforge.org/projects/win32utils.
+
+= Future Plans
+   Suggestions welcome. Please log them on the Feature Request tracker at
+   http://rubyforge.org/projects/win32utils
+   
+= Acknowledgements
+   Many thanks go to Patrick Hurley for providing the fix for the thread
+   blocking issue. Thanks also go to Kevin Burge for his patch that solved
+   service responsiveness issues.
+    
+= Copyright
+   (C) 2003-2008 Daniel J. Berger, All Rights Reserved
+
+= License
+   Ruby's
+
+= Warranty
+   This package is provided "as is" and without any express or
+   implied warranties, including, without limitation, the implied
+   warranties of merchantability and fitness for a particular purpose.
+
+= Author(s)
+* Daniel J. Berger
+* Park Heesob

data/doc/service.txt

@@ -0,0 +1,365 @@
+= Description
+   An interface for MS Windows Services.
+    
+= Prerequisites
+   Ruby 1.8.0 or later.
+	
+   This package is only supported for the Windows NT family of operating
+   systems, e.g. 2000, XP, 2003, etc. It is NOT supported (and won't
+   work) for any version of DOS or Windows 95/98/ME. It is also not
+   supported on NT 4, as that platform is defunct.
+   
+   It should work on Windows XP Home, but is not officially supported for
+   that platform.
+    
+= Synopsis
+   require "win32/service"
+   include Win32
+    
+   # Create a new service
+   Service.create('some_service', nil, 
+      :service_type       => Service::WIN32_OWN_PROCESS,
+      :description        => 'A custom service I wrote just for fun'
+      :start_type         => Service::AUTO_START,
+      :error_control      => Service::ERROR_NORMAL,
+      :binary_path_name   => 'C:\path\to\some_service.exe',
+      :load_order_group   => 'Network',
+      :dependencies       => ['W32Time','Schedule']
+      :service_start_name => 'SomeDomain\\User',
+      :password           => 'XXXXXXX',
+      :display_name       => 'This is some service',
+   )
+    
+   # Configure a service that already exists
+   Service.configure(:display_name => "My Bar Service")
+    
+   Service.start("foo")
+   Service.pause("foo")
+   Service.resume("foo")
+   Service.stop("foo")
+    
+   Service.delete("foo")
+    
+   Service.get_display_name("Schedule") # "Task Scheduler"
+   Service.get_service_name("ClipBook") # "ClipSrv"
+   
+   Service.status('W32Time') => <struct Struct::ServiceStatus ...>
+    
+   # Enumerate over all services, inspecting each struct  
+   Service.services{ |s|
+      p s
+      puts
+   }
+    
+= Class Methods
+Service.new(service_name, host=nil, options={})
+   Creates a new service with +service_name+ on +host+, or the local host
+   if no host is specified. The +options+ parameter is a hash that can
+   contain any of the following parameters, and their default values:
+   
+   * display_name       => service_name
+   * desired_access     => Service::ALL_ACCESS
+   * service_type       => Service::WIN32_OWN_PROCESS | Service::INTERACTIVE_PROCESS
+   * start_type         => Service::DEMAND_START
+   * error_control      => Service::ERROR_NORMAL
+   * binary_path_name   => nil
+   * load_order_group   => nil
+   * dependencies       => nil
+   * service_start_name => nil
+   * password           => nil
+   * description        => nil
+
+Service.configure(service_name, host=nil, options={})   
+   Configures the named +service_name+ on +host+, or the local host if no
+   host is specified. The +options+ parameter is a hash that can contain any
+   of the following parameters:
+   
+   * service_type
+   * start_type
+   * error_control
+   * binary_path_name
+   * load_order_group
+   * dependencies
+   * service_start_name
+   * password (used with service_start_name)
+   * display_name
+   * description
+   
+Service.config_info(service, host=nil)
+   Returns a ServiceConfigInfo struct containing the configuration information
+   about +service+ on +host+, or the local host if no host is specified.
+   
+Service.create
+   Alias for Service.new
+    
+Service.delete(service, host=nil)
+   Deletes the specified +service+ on +host+.  If no host is given,
+   then it deletes it on the local machine.
+    
+Service.exists?(service)
+   Returns true if the specified service exists, false otherwise.
+    
+Service.pause(service, host=nil)
+   Pauses the specified +service+ on +host+, or the local machine if
+   no host is provided.
+    
+Service.resume(service, host=nil)
+   Resumes the specified +service+ on +host+, or the local machine if
+   no host is specified.
+    
+Service.services(host=nil, group=nil){ |struct| ... }
+   Enumerates over a list of service types on host, or the local
+   machine if no host is specified, yielding a Win32Service struct for each
+   service.
+	
+   If a 'group' is specified, then only those services that belong to
+   that group are enumerated.  If an empty string is provided, then only
+   services that do not belong to any group are enumerated. If this parameter
+   is nil, group membership is ignored and all services are enumerated.
+	
+   The 'group' option is only available on Windows 2000 or later, and only
+   if compiled with VC++ 7.0 or later, or the .NET SDK.  The Win32Service
+   struct contains the following members:
+	
+   * service_name
+   * display_name
+   * service_type
+   * current_state
+   * controls_accepted
+   * win32_exit_code
+   * service_specific_exit_code
+   * check_point
+   * wait_hint
+   * binary_path_name
+   * start_type
+   * error_control
+   * load_order_group
+   * tag_id
+   * start_name
+   * dependencies
+   * description
+   * interactive?
+   * pid             (Win2k or later)
+   * service_flags   (Win2k or later)
+	
+   Note that the 'pid' and 'service_flags' members are only available on
+   Windows 2000 or later, and only if built with VC++ 7.0 or later (or the
+   .NET SDK).
+	
+Service.start(service, host=nil, *args)
+    Starts the specified +service+ on +host+, or the local machine if no
+    host is specified.  Any +args+ passed here are passed as start parameters
+    to the service.
+    
+Service.status(service)
+    Returns a Win32ServiceStatus struct for the specified service (or
+    raises a Win32::ServiceError if not found).  The Win32ServiceStatus
+    struct contains the following members.
+    
+    * service_type
+    * current_state
+    * controls_accepted
+    * win32_exit_code
+    * service_specific_exit_code
+    * check_point
+    * wait_hint
+    * interactive?
+    
+Service.stop(service, host=nil)
+    Stops the specified +service+ on +host+, or the local machine if no
+    host is specified.	
+    
+= Create and configure options
+binary_path_name
+   The binary to be used for the service. The path must be the fully
+   qualified path name. A path that contains a space must be quoted so that
+   it is correctly interpreted. The path may also include arguments to the
+   service entry point (typically the 'main' function).
+
+dependencies
+   Any dependencies the service has in order to run. This can be a string
+   or an array of strings.
+   
+description
+   A text string describing the service.
+        
+display_name
+   The display name to be used by user interface programs to identify the
+   service. The string has a maximum length of 256 characters. Case
+   sensitivity is preserved.
+    
+   The default is to set the display name to the same string as the
+   service name.
+   
+error_control
+   The error control for the service. The default is Service::ERROR_NORMAL.
+    
+   See the "Error Control Contants" section for available options and their
+   meanings.
+    
+load_order_group
+   The load order group, a string that names the load ordering group of
+   which this service is a member. The default is nil.
+    
+password
+   Sets the passsword to the account name specified in the Service#start_name
+   method.  By default, this value is set to nil, which is appropriate if
+   the account has no password or if the service runs in the
+   'LocalService', 'NetworkService', or 'LocalSystem' account.
+    
+   Note that passwords are ignored for driver services.
+    
+service_name
+   The service name for the service. This value must be set in order
+   to create a service. The string has a maximum length of 256 characters.
+    
+service_type
+   The service type for the service. The default is
+   Service::WIN32_OWN_PROCESS | Service::INTERACTIVE_PROCESS.
+
+   See the "Service Type Contants" section for available options and their
+   meanings.
+    
+start_name
+   Sets the name of the account under which the service should run.
+   By default the 'LocalSystem' account is used.
+    
+start_type
+   The start type for the service. The default is Service::DEMAND_START.
+    
+   See the "Start Type Contants" section for available options and their
+   meanings.
+    
+= Constants
+
+=== Standard Constants
+VERSION
+    The current version number of this package, returned as a string.
+    
+=== Desired Access Constants
+Service::MANAGER_ALL_ACCESS
+    Includes STANDARD_RIGHTS_REQUIRED, in addition to all access rights 
+    in the table.
+    
+Service::MANAGER_CREATE_SERVICE
+    Required to call the CreateService function to create a service object
+    and add it to the database.
+    
+Service::MANAGER_CONNECT
+    Required to connect to the service control manager.
+    
+Service::MANAGER_ENUMERATE_SERVICE
+    Required to call the EnumServicesStatus function to list the services
+    that are in the database.
+    
+Service::MANAGER_LOCK
+    Required to call the LockServiceDatabase function to acquire a lock on the
+    database.
+    
+Service::MANAGER_BOOT_CONFIG
+    Required to call the NotifyBootConfigStatus() (internal) function.  Not
+    defined with all compilers.
+    
+Service::MANAGER_QUERY_LOCK_STATUS
+    Required to call the QueryServiceLockStatus() (internal) function to
+    retrieve the lock status information for the database.
+       
+=== Service Type Constants
+Service::FILE_SYSTEM_DRIVER
+    File system driver service.
+    
+Service::KERNEL_DRIVER
+    Driver service.
+    
+Service::WIN32_OWN_PROCESS
+    Service that runs in its own process.
+    
+Service::WIN32_SHARE_PROCESS
+    Service that shares a process with one or more other services.
+    
+Service::INTERACTIVE_PROCESS
+    The service can interact with the desktop.  This can only be used if
+    either SERVICE_WIN32_OWN_PROCESS or SERVICE_WIN32_SHARE_PROCESS is
+    specified as well, and the service is running in the context of the
+    LocalSystem account (which is the default for this module, btw).
+    
+=== Start Type Constants
+Service::AUTO_START
+    A service started automatically by the service control manager during
+    system startup.
+    
+Service::BOOT_START
+    A device driver started by the system loader.  This value is valid only
+    for driver services.
+    
+Service::DEMAND_START
+    A service started by the service control manager when a process calls
+    the StartService() function.
+    
+Service::DISABLED
+    A service that cannot be started.  Attempts to start the service result
+    in an error.
+    
+Service::SYSTEM_START
+    A device driver started by the IoInitSystem() function.  This value is
+    valid only for driver services.
+    
+=== Error Control Constants
+Service::ERROR_IGNORE
+    The startup program logs the error but continues the startup operation.
+    
+Service::ERROR_NORMAL
+    The startup program logs the error and puts up a message box pop-up but
+    continues the startup operation.
+    
+Service::ERROR_SEVERE
+    The startup program logs the error.  If the last-known-good configuration
+    is being started, the startup operation continues.  Otherwise, the system
+    is restarted with the last-known-good configuration.
+    
+Service::ERROR_CRITICAL
+    The startup program logs the error, if possible.  If the last-known-good
+    configuration is being started the startup operation fails.  Otherwise,
+    the system is restarted with the last-known-good configuration.
+    
+= Notes
+   See the MSDN API with regards to CreateService(), etc at
+   http://www.msdn.com
+    
+   Some API ideas taken (or not) from both Python's win32serviceutil.py and
+   Perl's Win32::Service module.
+   
+   I don't truly understand how to allow a tag_id in the create_service()
+   method, so for now it's set to NULL automatically.  Suggestions welcome.
+    
+= Known Bugs
+   There may be a failure in the test suite if the W32Time dependency is
+   not started.
+
+   If you find any bugs please log them on the bug tracker.  You can find it
+   on the project page at http://www.rubyforge.org/projects/win32utils.
+   
+= Acknowledgements
+   Many thanks go to Patrick Hurley for providing the fix for the thread
+   blocking issue. Thanks also go to Kevin Burge for his patch that solved
+   service responsiveness issues.
+    
+= Future Plans
+   Add Tag_ID support.
+   Add ability to create or modify service failure actions.
+   Use RegisterServiceCtrlHandlerEx().
+    
+= Copyright
+   (C) 2003-2008, Daniel J. Berger, All Rights Reserved
+    
+= License
+   Ruby's
+    
+= Warranty
+   This package is provided "as is" and without any express or
+   implied warranties, including, without limitation, the implied
+   warranties of merchantability and fitness for a particular purpose.
+    
+== Author(s)
+* Daniel J. Berger   
+* Park Heesob