commit ec08804d18fdf69b6e972625c8cd99252fb44b6c
parent 1668d1321b9ff0936072833637832675fadf89d9
Author: leitner <leitner>
Date: Thu, 19 Feb 2004 22:47:55 +0000
add some great man pages by Erich Schubert (he wrote them for the Debian project)
do not assume MINITROOT is 10 chars long in msvc (fix also from Erich Schubert)
Diffstat:
8 files changed, 262 insertions(+), 2 deletions(-)
diff --git a/CHANGES b/CHANGES
@@ -2,7 +2,7 @@
add sample script for /etc/minit/ctrlaltdel/run as
control/ctrlaltdel-run (Florian Westphal)
add killall5, needs /proc on Linux though (Florian Westphal)
- add shutdown
+ add shutdown (Bernd Wachter)
add -Wall and -W and kill resulting compiler warnings
several fixes (Bernd Wachter)
add update support - tell minit to execve something else, a newer
@@ -10,6 +10,7 @@
also add minit-update program to download state from old minit and
upload state to new minit after update (Florian Westphal)
#include minit.h and use MINITROOT consistently (Lordy)
+ Don't assume MINITROOT is 10 bytes long (Erich Schubert)
0.9.1:
fix embarassing typo in msvc (Gelu G. Lupas)
diff --git a/hard-reboot.8 b/hard-reboot.8
@@ -0,0 +1,47 @@
+.TH hard-reboot 8
+.SH NAME
+hard-reboot \- reboot your system immedeately
+.SH SYNOPSIS
+.B hard-reboot
+.I RESTART
+.br
+.B hard-reboot
+.I HALT
+.br
+.B hard-reboot
+.I POWER_OFF
+
+.SH DESCRIPTION
+.B hard-reboot
+is used to reboot your system.
+
+It will not shut down services, unmount filesystems or notify
+your users, but expects that this has already been done when it
+is called.
+
+.SH USAGE
+
+To prevent accidential use of this application the parameters have to
+be written in uppercase letters.
+.TP 10
+.I RESTART
+restart (reboot) the system
+.TP
+.I HALT
+halt the kernel
+.TP
+.I POWER_OFF
+power off the system if possible (supported by hardware)
+
+.SH AUTHOR
+minit was written by Felix von Leitner and can be downloaded from
+his page at
+.I http://www.fefe.de/minit/
+
+hard-reboot was contributed by Tommi Virtanen.
+
+This manpage was written by Erich Schubert <[email protected]>
+for the Debian GNU/Linux operating system.
+
+.SH "SEE ALSO"
+minit(8), msvc(8), pidfilehack(8)
diff --git a/minit-list.8 b/minit-list.8
@@ -0,0 +1,30 @@
+.TH minit-list 8
+.SH NAME
+minit-list \- list running services
+.SH SYNOPSIS
+.B minit-list
+
+.SH DESCRIPTION
+.B minit-list
+will scan /etc/minit for services and use msvc to check if the service is
+currently running. It will then print a list of running services.
+
+minit-list was renamed from
+.I listpids
+for the debian package.
+
+.SH USAGE
+minit-list doesn't have any options.
+
+The output is a list of running services.
+
+.SH AUTHOR
+minit was written by Felix von Leitner and can be downloaded from
+his page at
+.I http://www.fefe.de/minit/
+
+This manpage was written by Erich Schubert <[email protected]>
+for the Debian GNU/Linux operating system.
+
+.SH "SEE ALSO"
+msvc(8), pidfilehack(8)
diff --git a/minit-shutdown.8 b/minit-shutdown.8
@@ -0,0 +1,45 @@
+.TH minit-shutdown 8
+.SH NAME
+minit-shutdown \- shutdown the minit init system.
+.SH SYNOPSIS
+.B minit-shutdown -[\fIrhosmn\fR] [-t \fIsecs\fR]
+
+.SH DESCRIPTION
+.B minit-shutdown
+tries to properly shutdown your system with minit.
+
+.SH USAGE
+.TP 9
+-r
+reboot after shutdown
+.TP
+-h
+halt after shutdown
+.TP
+-o
+power-off after shutdown
+.TP
+-s
+single-user console after shutdown
+.TP
+-m
+only shutdown minit-part
+.TP
+-n
+do not shutdown services using minit
+.TP
+-t \fIsecs\fR
+delay between SIGTERM and SIGKILL
+
+.SH AUTHOR
+minit was written by Felix von Leitner and can be downloaded from
+his page at
+.I http://www.fefe.de/minit/
+
+This shutdown was contributed by Bernd Wachter.
+
+This manpage was written by Erich Schubert <[email protected]>
+for the Debian GNU/Linux operating system.
+
+.SH "SEE ALSO"
+msvc(8), pidfilehack(8)
diff --git a/minit-update.8 b/minit-update.8
@@ -0,0 +1,36 @@
+.TH minit-update 8
+.SH NAME
+minit\-update \- replace running minit with a new version
+.SH SYNOPSIS
+.B minit\-update [ \-v [ \-u ] ]
+
+.SH DESCRIPTION
+.B minit\-update
+is used to replace a running minit with a new version.
+
+It tries to retrieve the state information about running services from
+minit, then have minit replace itself with the new version and
+restore the stored state information.
+
+.SH USAGE
+Unless the \-u option is given, minit\-update assumes you are running
+in test mode.
+.TP 4
+\-v
+verbose operation
+.TP
+\-u
+update mode
+
+.SH AUTHOR
+minit was written by Felix von Leitner and can be downloaded from
+his page at
+.I http://www.fefe.de/minit/
+
+minit\-update was contributed by Florian Westphal.
+
+This manpage was written by Erich Schubert <[email protected]>
+for the Debian GNU/Linux operating system.
+
+.SH "SEE ALSO"
+msvc(8), pidfilehack(8)
diff --git a/minit.8 b/minit.8
@@ -0,0 +1,41 @@
+.TH minit 8
+.SH NAME
+minit \- a UNIX process no 1
+.SH SYNOPSIS
+.B minit
+
+.SH DESCRIPTION
+.B minit
+is a possible first process the kernel starts
+
+to use minit as system init, first read available documentation in
+.I /usr/share/doc/minit
+and then add the parameter
+\fIinit=/sbin/minit\fR
+to your kernel command line.
+
+.I lilo
+users need to add it to the \fIappend="something"\fR
+option in \fI/etc/lilo.conf\fR,
+
+.I grub
+users can just append it to their "\fIkernel\fR image options" lines.
+
+.SH USAGE
+minit will by default do nothing except starting the minit service defined
+in
+.I /etc/minit/default
+which usually contains a file named
+.I depends
+specifying which services are to be started at bootup.
+
+.SH AUTHOR
+minit was written by Felix von Leitner and can be downloaded from
+his page at
+.I http://www.fefe.de/minit/
+
+This manpage was written by Erich Schubert <[email protected]>
+for the Debian GNU/Linux operating system.
+
+.SH "SEE ALSO"
+msvc(8), pidfilehack(8)
diff --git a/msvc.c b/msvc.c
@@ -17,7 +17,7 @@ static char buf[1500];
void addservice(char* service) {
char* x;
if (str_start(service,MINITROOT "/"))
- service+=11;
+ service+=sizeof(MINITROOT "/") -1;
x=service+str_len(service)-1;
while (x>service && *x=='/') { *x=0; --x; }
strncpy(buf+1,service,1400);
diff --git a/pidfilehack.8 b/pidfilehack.8
@@ -0,0 +1,60 @@
+.TH pidfilehack 8
+.SH NAME
+pidfilehack \- work around daemons that always fork
+.SH SYNOPSIS
+.B pidfilehack
+.I servicename
+.I pidfile
+.I command
+.I [parameters]
+
+.SH DESCRIPTION
+.B pidfilehack
+is used to work around daemons that insist on forking into the background,
+but that do write a correct pid file.
+
+pidfilehack forks the actual service, then waits for the pidfile to
+be written. Once it can read the pid from the pidfile it will tell
+minit the real pid and quit.
+
+.SH USAGE
+usually pidfilehack is symlinked as \fIrun\fR command of a service.
+.TP
+servicename
+the name of the service pidfilehack is installed for.
+.TP
+pidfile
+the filename to read the pid from
+.TP
+command
+the real command to start
+.TP
+parameters
+additional parameters for the command
+
+A typical use of this command will look like this:
+.TP
+/etc/minit/apache
+.TP
+/etc/minit/apache/params
+apache
+.br
+/var/run/apache.pid
+.br
+apachectl
+.br
+start
+.TP
+/etc/minit/apache/run
+-> /sbin/pidfilehack
+
+.SH AUTHOR
+minit was written by Felix von Leitner and can be downloaded from
+his page at
+.I http://www.fefe.de/minit/
+
+This manpage was written by Erich Schubert <[email protected]>
+for the Debian GNU/Linux operating system.
+
+.SH "SEE ALSO"
+msvc(8), pidfilehack(8)
