2005-10-03 16:31:28 +02:00
.TH SERVICE 8
.SH NAME
2005-10-20 14:08:25 +02:00
service \- Start or stop an operating system server or device driver.
2005-10-03 16:31:28 +02:00
.SH SYNOPSIS
.PP
2005-10-20 14:08:25 +02:00
\fB service up\fR \fI <service>\fR [\fB -args\fR \fI args\fR ]
[\fB -dev\fR \fI special\fR ] [\fB -period\fR \fI ticks\fR ]
.PP
\fB service down\fR \fI <pid>\fR
.PP
\fB service shutdown\fR
2005-10-03 16:31:28 +02:00
.br
.de FL
.TP
\\ fB\\ $1\\ fR
\\ $2
. .
.de EX
.TP
\\ fB\\ $1\\ fR
\\ $2
. .
.SH DESCRIPTION
.PP
2005-10-20 14:08:25 +02:00
Tells the reincarnation server to start or stop a system service, such as a
server or device driver. The device driver will be automatically restarted when
it unexpectedly exits, e.g., if it is killed because of a bad pointer.
Starting requires an absoluate path to the binary to be executed.
.PP
When an optional period is specified, the reincarnation server sends a status
request to the system service after every period. If there the response does
not arrive in time, the reincarnation server will kill the misbehaving process
and restart a new one. The period must be specified in ticks, but can be
appended with 'HZ' to make it seconds.
.PP
Stopping a system service requires the process id of a running system service.
Issuing a kill command from the shell will not work, since the reincarnation
server interprets this as an unexpected exit and will automatically restart
a fresh copy of the process.
.PP
2005-10-20 14:25:33 +02:00
If the system is to be shutdown, the reincarnation server should know about this event to prevent it from restarting services that are killed during the shutdown
2005-10-20 14:08:25 +02:00
sequence.
2005-10-03 16:31:28 +02:00
.SH EXAMPLES
2005-10-20 14:08:25 +02:00
.EX "service up /sbin/is -period 5HZ" "Start the IS server and check its status every 5 seconds."
.br
.EX "service up /usr/sbin/dp8390 -args DPETH0=pci" "Start the DP8390 ethernet driver, passing one argument."
.br
.EX "service down 117" "Stop the system service with process id 117."
.br
2005-10-03 16:31:28 +02:00
.SH "SEE ALSO"
.PP
.BR boot (8),
.BR monitor (8)