NAME

       mono-service, mono-service2 - Mono ServiceProcess host

SYNOPSIS

       mono-service [options] program.exe

DESCRIPTION

       The mono-service is a host to run services built with the ServiceProcess assembly.

       Use  mono-service to run services that use the 1.0 assemblies and use mono-service2 to run
       services that use the 2.0 assemblies.

       Services can be paused by sending the SIGUSR1 signal to the process, and execution can  be
       resumed  by  sending  the SIGUSR2 signal.   The service can be cleanly shutdown by sending
       the SIGTERM signal to the process.

       Mono programs started with  mono-service  run  with  the  MONO_DISABLE_SHM  variable  set.
       This means that certain Mono features that depend on it are not available to services.

       The following options can be used to control the service:

       -d:DIRECTORY
              Use  this  option to specify the working directory for the service.  The default is
              the current directory.

       -l:LOCKFILE
              Specifies the file to use for locking, the default is  a  filename  constructed  in
              /tmp based on the name of the program that hosts the service.

       -m:MESSAGE
              Name to show in the syslog.

       -n:NAME
              Use  this  to specify the service to be launched (if the program contains more than
              one service).   The default is to run the first defined service.

       --debug
              Use this option to prevent mono-service  from  redirecting  stdin  and  stdout  and
              prevent the program to be sent to the background.  Equivalent to --no-daemon

       --no-daemon
              Use  this  option  to  prevent  mono-service  from redirecting stdin and stdout and
              prevent the program to be sent to the background.  Equivalent to --debug.

CONTROL

       You can control the service by sending signals to the process, you can use  the  following
       commands:

       Pausing service:
                   kill -USR1 `cat <lock file>`

       Resuming service:
                   kill -USR2 `cat <lock file>`

       Stopping the service:
                   kill `cat <lock file>`

EXAMPLES

       Start the MyService.exe assembly, with a lock in /root/service-lock:

            mono-service -l:/root/service-lock MyService.exe

DEBUGGING

       Messages produced by the service are logged on syslog.

MAILING LISTS

       Visit http://lists.ximian.com/mailman/listinfo/mono-list for details.

WEB SITE

       Visit: http://www.mono-project.com for details

SEE ALSO

       mono(1)

       N:System.ServiceProcess

                                                                                   Mono(Mono 1.0)