emo/sysvinit
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Updated documentation to be more relevant to modern (2018)

Browse Source 
systems.
Updated copyright notice.
Fixed start-stop-daemon.c so that it will compile.
Updated install instructions.
Removed references to "obsolete" directory which, fittingly,
no longer exists.
This commit is contained in:
Jesse Smith 2018-02-23 17:34:30 -04:00
parent 3f98f493ff
commit bdd2bc12e3
7 changed files with 75 additions and 64 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
COPYRIGHT
View File

@ -1,4 +1,5 @@
Sysvinit is Copyright (C) 1991-2004 Miquel van Smoorenburg
Updated Copyright (C) 2018 Jesse Smith
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
@ -19,7 +20,7 @@ Public License can be found in `/usr/share/common-licenses/GPL-2'.
Send patches to sysvinit-devel@nongnu.org
The of the start-stop-daemon
Regarding the start-stop-daemon located in the contrib directory:
* A rewrite of the original Debian's start-stop-daemon Perl script
* in C (faster - it is executed many times during system startup).

12
README
View File

@ -1,10 +1,12 @@
contrib Unofficial stuff
doc Documentation, mostly obsolete
man Manual pages, not obsolete
obsolete Really obsolete stuff ;)
contrib Unofficial stuff, add-on programs
doc Documentation
man Manual pages
src Source code
The project home is on https://savannah.nongnu.org/projects/sysvinit .
For instructions on building and installing SysV init, please
see the "doc/Install" file.
The project home is on https://savannah.nongnu.org/projects/sysvinit
Send patches to sysvinit-devel@nongnu.org .

6
contrib/start-stop-daemon.README
View File

@ -1,10 +1,10 @@
Start-stop-daemon is the program that is used by the DEBIAN style init
Start-stop-daemon is the program that is used by the Debian style init
scripts to start and stop services. This program is part of the "dpkg"
package by Ian Jackson. However there is also a seperate C version (the
original is in perl) available written by Marek Michalkiewicz. I'm including
original is in Perl) available written by Marek Michalkiewicz. I am including
it for your convinience.
Note that the latest debian dpkg packages (4.0.18 and later) contain
Note that the latest Debian dpkg packages (4.0.18 and later) contain
a much improved update-rc.d. This code is almost a year old.
The original announcement follows:

45
contrib/start-stop-daemon.c
View File

@ -107,29 +107,28 @@ push(struct pid_list **list, int pid)
static void
do_help(void)
{
printf("\
start-stop-daemon for Debian Linux - small and fast C version written by\n\
Marek Michalkiewicz <marekm@i17linuxb.ists.pwr.wroc.pl>, public domain.\n"
VERSION "\n\
\n\
Usage:
start-stop-daemon -S|--start options ... -- arguments ...\n\
start-stop-daemon -K|--stop options ...\n\
start-stop-daemon -H|--help\n\
start-stop-daemon -V|--version\n\
\n\
Options (at least one of --exec|--pidfile|--user is required):
-x|--exec <executable> program to start/check if it is running\n\
-p|--pidfile <pid-file> pid file to check\n\
-u|--user <username>|<uid> stop this user's processes\n\
-n|--name <process-name> stop processes with this name\n\
-s|--signal <signal> signal to send (default 15)\n\
-a|--startas <pathname> program to start (default <executable>)\n\
-t|--test test mode, don't do anything\n\
-o|--oknodo exit status 0 (not 1) if nothing done\n\
-q|--quiet | -v, --verbose\n\
\n\
Exit status: 0 = done 1 = nothing done (=> 0 if --oknodo) 2 = trouble\n");
printf("start-stop-daemon for Debian Linux - small and fast C version written by\n"
"Marek Michalkiewicz <marekm@i17linuxb.ists.pwr.wroc.pl>, public domain. %s\n"
"\n"
"Usage:\n"
" start-stop-daemon -S|--start options ... -- arguments ...\n"
" start-stop-daemon -K|--stop options ...\n"
" start-stop-daemon -H|--help\n"
" start-stop-daemon -V|--version\n"
"\n"
"Options (at least one of --exec|--pidfile|--user is required):\n"
" -x|--exec <executable> program to start/check if it is running\n"
" -p|--pidfile <pid-file> pid file to check\n"
" -u|--user <username>|<uid> stop this user's processes\n"
" -n|--name <process-name> stop processes with this name\n"
" -s|--signal <signal> signal to send (default 15)\n"
" -a|--startas <pathname> program to start (default <executable>)\n"
" -t|--test test mode, don't do anything\n"
" -o|--oknodo exit status 0 (not 1) if nothing done\n"
" -q|--quiet | -v, --verbose\n"
"\n"
"Exit status: 0 = done 1 = nothing done (=> 0 if --oknodo) 2 = trouble\n",
VERSION);
}

37
doc/Install
View File

@ -1,18 +1,36 @@
README for the System V style init, version 2.86
README for the System V style init, version 2.89
init, shutdown, halt, reboot, wall, last, mesg, runlevel,
killall5, pidof, sulogin.
All programs, files and scripts in this package are covered by
the Gnu Public License, and copyrighted by me.
the GNU General Public License version 2, and copyrighted by
Miquel van Smoorenburg (1991-2004) and, Jesse Smith (2018).
If you are not using Debian and the debianized package,
you will have to install the new init by hand. You should
be able to drop the binaries into a Slackware or Redhat
system, I think.
you may have to install the new init by hand if Debian is
using an init system other than SysV (eg systemd). You should
be able to drop the binaries into a Slackware or Devuan system, I think.
Here is a list of preferred directories to install the progs & manpages:
The SysV init software, core programs and manual pages can be
installed by running the following two commands from the top-level
source directory.
make
sudo make install
If sudo is not installed, the "make install" command may be run as
the root user.
Other than the GNU make utility, SysV init has few dependencies.
SysV can be built on virtually any Linux system featuring
the GNU C library or musl libc. A C compiler, such as the GNU Compiler
Collection (GCC) or Clang is also required.
Here is a list of preferred directories to install the progs & manpages,
this should be done for you automatically when you run "make install"
as the root user, or via sudo, ie "sudo make install".
wall.1, last.1, mesg.1 /usr/man/man1
inittab.5, initscript.5 /usr/man/man5
@ -40,7 +58,7 @@ bootlogd /sbin/bootlogd
utmpdump don't install, it's just a debug thingy.
If you already _have_ a "wall" in /bin (the SLS release had, for example)
do _not_ install this wall. Chances are that the wall you are already
do _not_ install this version of wall. Chances are that the wall you are already
using is linked to /bin/write. Either first _remove_ /bin/wall before
installing the new one, or don't install the new one at all.
@ -48,9 +66,8 @@ You might want to create a file called "/etc/shutdown.allow". Read the
manual page on shutdown to find out more about this.
Running from a read-only file system (CDROM?):
o All communication to init goes through the FIFO /dev/initctl.
* All communication to init goes through the FIFO /run/initctl.
There should be no problem using a read-only root file system
IF you use a Linux kernel > 1.3.66. Older kernels don't allow
writing to a FIFO on a read-only file system.
Miquel van Smoorenburg <miquels@cistron.nl>

26
doc/Propaganda
View File

@ -1,19 +1,19 @@
Propaganda for version 2.58 of sysvinit & utilities
Propaganda for version 2.89 of sysvinit & utilities
==================================================
NOTE: If you use a standard distribution like Slackware, Debian
or Redhat there probably is no need to upgrade. Installing sysvinit
NOTE: If you use a standard distribution like Slackware, Devuan
or Gentoo there probably is no need to upgrade. Installing sysvinit
is only for those that upgrade their system by hand or for people
that create Linux distributions.
Sysvinit is probably the most widely used init package for Linux.
Most distributions use it. sysvinit 2.4 is really a good package,
and it was not the need for bugfixes but the need for more features
SysV init was probably the most widely used init package for Linux.
Most distributions once used it. sysvinit 2.4 was really a good package,
and it was not the need for bug fixes but the need for more features
that made me work on sysvinit again.
Sysvinit is now a debian package. Debian source packages are not
SysV init is now a Debian package. Debian source packages are not
special in any way -- in fact you can just unpack and compile
it on any other Linux distribution.
@ -61,7 +61,7 @@ as in the 2.4 release:
The sysvinit package includes
* a sysv compatible /sbin/init program
* a SysV compatible /sbin/init program
* a telinit program (er, just a link to /sbin/init) to change runlevels
* a featureful shutdown
* halt and reboot to assist shutdown
@ -69,13 +69,7 @@ The sysvinit package includes
* the wall & mesg programs (not installed by default)
* manpages for everything
The new sysv init can be found on:
The new SysV init can be found on:
tsx-11.mit.edu:/pub/linux/sources/sbin as sysvinit-2.58-1.tar.gz
sunsite.unc.edu:/pub/Linux/system/Daemons as sysvinit-2.58-1.tar.gz
It will be moved there in a few days, in the mean time it is
probably in the Incoming directory.
Mike. (02-Jan-1996)
http://download.savannah.nongnu.org/releases/sysvinit/

10
doc/sysvinit-2.86.lsm
View File

@ -1,14 +1,12 @@
Begin3
Title: sysvinit and utilities
Version: 2.86
Entered-Date: 30JUL2004
Version: 2.89
Entered-Date: 24FEB2018
Description: This is the Linux System V init.
This version can be compiled with glibc 2.0.6 and up.
Author: miquels@cistron.nl (Miquel van Smoorenburg)
Primary-Site: ftp.cistron.nl /pub/people/miquels/software
92K sysvinit-2.86.tar.gz
Alternate-Site: sunsite.unc.edu /pub/Linux/system/daemons/init
92K sysvinit-2.86.tar.gz
Primary-Site: http://download.savannah.nongnu.org /releases/sysvinit/
103K sysvinit-2.89.tar.bz2
Copying-Policy: GPL
Keywords: init shutdown halt reboot
End