Man Linux: Main Page and Category List

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)