win32-service 0.5.2

data/CHANGES

@@ -0,0 +1,174 @@
+== 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 started 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,16 @@
+MANIFEST
+CHANGES
+README
+extconf.rb
+
+doc/daemon.txt
+doc/service.txt
+
+examples/daemon_test.rb
+examples/services_test.rb
+
+lib/win32/service.c
+lib/win32/service.h
+
+test/tc_daemon.rb
+test/tc_service.rb

data/README

@@ -0,0 +1,46 @@
+= What is it?
+An interface to Win32 services.  It also allows you to create an run Ruby
+programs as a Service.
+
+= Installation
+== Gem Install
+   ruby win32-service.gemspec
+   gem install win32-service-X.Y.Z.gem
+== Standard Install
+   ruby extconf.rb
+   nmake
+   cd test; ruby tc_service.rb; ruby tc_daemon.rb (optional)
+   nmake install
+
+= Where are the docs?
+In the 'doc' directory, or you can generate rdoc from the source files.
+
+= 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."
+
+There are a few possibilities, but I'll just mention the ones I can speak of
+from personal experience.  The most likely cause for this error is that there
+is a bug in your Daemon class.  Unfortunately, it isn't stated in the
+error message or the Event log as to what might be wrong.  You'll have to
+debug your class separately somehow.  One approach might be to do
+STDERR.reopen("C:\\errors.txt"), or something similar, at the top of your
+Daemon code, or wrap the whole thing in a begin/rescue clause, and write the
+errors to a file.
+
+The other possibility is that your binary path name is incorrect.  The
+solution in the latter case is to use an absolute path name for the target
+Ruby script.  It might also be a good idea to include the full path name to
+the Ruby interpreter, e.g. 'c:\ruby\bin\ruby' versus just 'ruby'.
+
+= Possible test failures
+The 'test_start_stop' test in the tc_service.rb file may fail.  This will
+happen if your W32Time service isn't running.

data/doc/daemon.txt

@@ -0,0 +1,156 @@
+== Description
+   The Daemon class is a wrapper class that allows you to run your code as a
+   Win32 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 = Daemon.new
+   daemon.mainloop
+    
+== Instance 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.
+   
+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
+   tdaemon.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
+   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.
+    
+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.
+    
+   Not supported on NT 4.
+    
+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.
+    
+   Not supported on NT 4.
+    
+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.
+
+   Not supported on NT 4.
+
+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.
+
+   Not support on NT 4.
+
+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
+CONTINUE_PENDING
+   The service continue is pending.
+
+PAUSE_PENDING
+   The service pause is pending.
+
+PAUSED
+   The service is paused (but not STOPPED).
+
+RUNNING
+   The service is running.
+
+START_PENDING
+   The service is starting (but is not yet in a RUNNING state).
+
+STOP_PENDING
+   The service is stopping (but is not yet in a STOPPED state).
+
+STOPPED
+   The service is not running.
+   
+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 'tdaemon.rb' and 'tdaemon_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
+    
+== Copyright
+   (C) 2003-2006 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,378 @@
+== Description
+   An interface for Win32 Services.
+    
+== Prerequisites
+   Ruby 1.8.0 or later.
+	
+   This package is only supported for the Windows NT family of operating
+   systems, e.g. NT 4, 2000, XP, 2003, etc.  It is NOT supported (and won't
+   work) for any version of DOS or Windows 95/98/ME. It may work on Windows
+   XP Home, but is not officially supported for that platform.
+    
+== Synopsis
+   require "win32/service"
+   include Win32
+    
+   s = Service.new("some_machine")
+    
+   # Create a new service
+   s.create_service{ |s|
+      s.service_name        = "foo"
+      s.binary_path_name    = "C:\\some_dir\\foo.exe"
+      s.display_name        = "My Foo Service"
+      s.service_description = "Greatest Service Ever"
+   }
+    
+   # Configure a service that already exists
+   s.configure_service{ |s|
+      s.display_name = "My Bar Service"
+   }
+    
+   s.close
+    
+   Service.start("foo")
+   Service.pause("foo")
+   Service.resume("foo")
+   Service.stop("foo")
+    
+   Service.delete("foo")
+    
+   Service.getdisplayname("Schedule") # "Task Scheduler"
+   Service.getservicename("ClipBook") # "ClipSrv"
+    
+   s = Service.status("ClipSrv")
+    
+   # Enumerate over all services, inspecting each struct  
+   Service.services{ |s|
+      p s
+      puts
+   }
+    
+== Class Methods
+Service.new(host=nil, desired_access=nil){ ... }
+   Creates and returns a new Win32::Service handle on +host+ with the
+   +desired_access+.  If no host is specified, your local machine is
+   used.  If no desired access is specified, then
+   Service::MANAGER_CREATE_SERVICE is used.
+   
+   If a block is provided the Win32::Service object is yielded to the
+	block and *closed* at the end of the block.
+    
+   See the "Desired Access Constants" section for a list of valid
+   desired access levels and their meanings.
+    
+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.open(service, host=nil, desired_access=nil){ ... }
+   Creates and returns a new Win32::Service handle on +host+ with the
+   +desired_access+ for the given +service+.  If no host is specified
+   then your local machine is used.  If no +desired_access+ is specified,
+   then Service::SERVICE_QUERY_CONFIG is used.
+	
+   If a block is provided the Win32::Service object is yielded to the
+   block and *closed* at the end of the block.
+	
+   Note that you will probably need to change the desired access in
+   order to configure or delete an existing service using the returned object.
+    
+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 Win32ServiceError 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.	
+    
+== Instance Methods
+Service#binary_path_name=(path_to_executable)
+    Sets 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).
+    
+    This option must be set before you can call Service#create_service.
+    
+Service#close
+    Closes the service handle.  This is the polite way to do things, although
+    the service handle should automatically be closed when it goes out of
+    scope.
+    
+Service#configure_service{ |service| ... }
+   Configures the service object.  Valid methods for the service object are
+   as follows:
+	
+   * desired_access= 
+   * service_name=
+   * display_name=
+   * service_description=
+   * service_type=
+   * start_type=
+   * error_control=
+   * tag_id=   
+   * binary_path_name= 
+   * load_order_group= 
+   * start_name= 
+   * password=
+   * dependencies=
+   * failure_action=
+   	
+   See the docs for individual instance methods for more details.
+    
+Service#create_service{ |service| ... }
+   Creates the specified service.  In order for this to work, the
+   'service_name' and 'binary_path_name' attributes must be defined
+   or Win32ServiceError will be raised.
+    
+   See the Service#configure_service method for a list of valid methods to
+   pass to the service object.  See the individual methods for more
+   information, including default values.
+        
+Service#display_name=(name=service_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.
+   
+Service#error_control=(type=nil)
+   Sets the error control for the service.  The default is
+   Service::ERROR_NORMAL.
+    
+   See the "Error Control Contants" section for available options and their
+   meanings.
+    
+Service#load_order_group=(order_group=nil)
+   Sets the load order group, where 'order_group' is a string that names
+   the load ordering group of which this service is a member.  The default
+   is nil.
+    
+Service#machine_name=(name=nil)
+   Sets the name of the machine on which the service will be created.  By
+   default, this is set to nil.  That is, it will be created on your
+   local machine.
+    
+Service#password=(password=nil)
+   Sets the passsword to the account name specified in the '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#service_name=(name)
+   Sets 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#service_type=(type=nil)
+   Sets 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.
+    
+Service#start_name=(name=nil)
+   Sets the name of the account under which the service should run.
+   If 'name' is nil, then the 'LocalSystem' account is used.
+    
+Service#start_type=(type=nil)
+   Sets 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 function.  Not defined with
+    all compilers.
+    
+Service::MANAGER_QUERY_LOCK_STATUS
+    Required to call the QueryServiceLockStatus 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.
+    
+== Future Plans
+   Add Tag_ID support.
+   Add ability to create or modify service failure actions.
+   Use RegisterServiceCtrlHandlerEx().
+    
+== Copyright
+   (C) 2003-2006, 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
+   Daniel J. Berger   
+   Park Heesob