Questions tagged [mono-service]

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: cat <lock file> | xargs kill -USR1
• Resuming service: cat <lock file> | xargs kill -USR2
• Stopping the service: cat <lock file> | xargs kill

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

Taken from Ubuntu manpages. Modified from original due to wiki restrictions