2 .\" mono-service manual page.
3 .\" (C) 2005 Novell, Inc.
5 .\" Miguel de Icaza (miguel@gnu.org)
7 .de Sp \" Vertical space (when we can't use .PP)
13 mono-service \- Mono ServiceProcess host
16 .B mono-service [options] program.exe
18 The \fImono-service\fP is a host to run services built with the
19 ServiceProcess assembly.
21 Services can be paused by sending the SIGUSR1 signal to the process,
22 and execution can be resumed by sending the SIGUSR2 signal. The
23 service can be cleanly shutdown by sending the SIGTERM signal to the
26 Mono programs started with mono-service run with the
28 variable set. This means that certain Mono features that depend on
29 it are not available to services.
31 The following options can be used to control the service:
34 Use this option to specify the working directory for the service. The
35 default is the current directory.
38 Specifies the file to use for locking, the default is a filename
39 constructed in /tmp based on the name of the program that hosts the
43 Name to show in the syslog.
46 Use this to specify the service to be launched (if the program
47 contains more than one service). The default is to run the first
51 Use this option to prevent mono-service from redirecting stdin and
52 stdout and prevent the program to be sent to the background.
53 Equivalent to --no-daemon
56 Use this option to prevent mono-service from redirecting stdin and
57 stdout and prevent the program to be sent to the background.
58 Equivalent to --debug.
60 You can control the service by sending signals to the process, you can
61 use the following commands:
65 kill -USR1 `cat <lock file>`
70 kill -USR2 `cat <lock file>`
75 kill `cat <lock file>`
78 Start the MyService.exe assembly, with a lock in /root/service-lock:
81 mono-service -l:/root/service-lock MyService.exe
85 Messages produced by the service are logged on syslog.
87 Visit http://lists.ximian.com/mailman/listinfo/mono-list for details.
89 Visit: http://www.mono-project.com for details
93 .BR N:System.ServiceProcess