ac9ab099c8
- clean up kernel section of minix/com.h somewhat - remove ALLOCMEM and VM_ALLOCMEM calls - remove non-safecopy and minix-vmd support from Inet - remove SYS_VIRVCOPY and SYS_PHYSVCOPY calls - remove obsolete segment encoding in SYS_SAFECOPY* - remove DEVCTL call, svrctl(FSDEVUNMAP), map_driverX - remove declarations of unimplemented svrctl requests - remove everything related to swapping to disk - remove floppysetup.sh - remove traces of rescue device - update DESCRIBE.sh with new devices - some other small changes
49 lines
1.9 KiB
Groff
49 lines
1.9 KiB
Groff
.TH SERVICE 8
|
|
.SH NAME
|
|
service \- Start or stop an operating system server or device driver.
|
|
.SH SYNOPSIS
|
|
.PP
|
|
\fBservice up\fR \fI<service>\fR [\fB-args\fR \fIargs\fR]
|
|
[\fB-dev\fR \fIspecial\fR] [\fB-period\fR \fIticks\fR]
|
|
.PP
|
|
\fBservice down\fR \fI<pid>\fR
|
|
.PP
|
|
\fBservice refresh\fR \fI<pid>\fR
|
|
.PP
|
|
\fBservice shutdown\fR
|
|
.br
|
|
.de FL
|
|
.TP
|
|
\\fB\\$1\\fR
|
|
\\$2
|
|
..
|
|
.de EX
|
|
.TP
|
|
\\fB\\$1\\fR
|
|
\\$2
|
|
..
|
|
.SH DESCRIPTION
|
|
.PP
|
|
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 absolute 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. The clean way to restart a process is using the refresh option of the service utility.
|
|
.PP
|
|
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
|
|
sequence.
|
|
.SH EXAMPLES
|
|
.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
|
|
.SH "SEE ALSO"
|
|
.PP
|
|
.BR boot (8),
|
|
.BR monitor (8)
|
|
|