man/mono-service.1

   1 .\"
   2 .\" mono-service manual page.
   3 .\" (C) 2005 Novell, Inc.
   4 .\" Author:
   5 .\"   Miguel de Icaza (miguel@gnu.org)
   6 .\"
   7 .de Sp \" Vertical space (when we can't use .PP)
   8 .if t .sp .5v
   9 .if n .sp
  10 ..
  11 .TH Mono "mono-service"
  12 .SH NAME
  13 mono-service, mono-service2 \- Mono ServiceProcess host
  14 .SH SYNOPSIS
  15 .PP
  16 .B mono-service [options] program.exe
  17 .SH DESCRIPTION
  18 The \fImono-service\fP is a host to run services built with the
  19 ServiceProcess assembly.
  20 .PP
  21 Use \fImono-service\fP to run services that use the 1.0 assemblies and
  22 use \fImono-service2\fP to run services that use the 2.0 assemblies.
  23 .PP
  24 Services can be paused by sending the SIGUSR1 signal to the process,
  25 and execution can be resumed by sending the SIGUSR2 signal.   The
  26 service can be cleanly shutdown by sending the SIGTERM signal to the
  27 process.
  28 .PP
  29 The following options can be used to control the service:
  30 .TP
  31 .I "-d:DIRECTORY"
  32 Use this option to specify the working directory for the service.  The
  33 default is the current directory.
  34 .TP
  35 .I "-l:LOCKFILE"
  36 Specifies the file to use for locking, the default is a filename
  37 constructed in /tmp based on the name of the program that hosts the
  38 service.
  39 .TP
  40 .I "-m:MESSAGE"
  41 Name to show in the syslog.
  42 .TP
  43 .I "-n:NAME"
  44 Use this to specify the service to be launched (if the program
  45 contains more than one service).   The default is to run the first
  46 defined service.
  47 .TP
  48 .I "--debug"
  49 Use this option to prevent mono-service from redirecting stdin and
  50 stdout and prevent the program to be sent to the background.
  51 Equivalent to --no-daemon
  52 .TP
  53 .I "--no-daemon"
  54 Use this option to prevent mono-service from redirecting stdin and
  55 stdout and prevent the program to be sent to the background.
  56 Equivalent to --debug.
  57 .SH CONTROL
  58 You can control the service by sending signals to the process, you can
  59 use the following commands:
  60 .TP
  61 Pausing service:
  62 .nf
  63         kill -USR1 `cat <lock file>`
  64 .fi
  65 .TP
  66 Resuming service:
  67 .nf
  68         kill -USR2 `cat <lock file>`
  69 .fi
  70 .TP
  71 Stopping the service:
  72 .nf
  73         kill `cat <lock file>`
  74 .fi
  75 .SH EXAMPLES
  76 Start the MyService.exe assembly, with a lock in /root/service-lock:
  77 .nf
  78
  79         mono-service -l:/root/service-lock MyService.exe
  80
  81 .fi
  82 .SH DEBUGGING
  83 Messages produced by the service are logged on syslog.
  84 .SH MAILING LISTS
  85 Visit http://lists.ximian.com/mailman/listinfo/mono-list for details.
  86 .SH WEB SITE
  87 Visit: http://www.mono-project.com for details
  88 .SH SEE ALSO
  89 .BR mono (1)
  90 .PP
  91 .BR N:System.ServiceProcess