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 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 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 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 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 * A rewrite of the original Debian's start-stop-daemon Perl script
* in C (faster - it is executed many times during system startup). * in C (faster - it is executed many times during system startup).

12
README
View File

@ -1,10 +1,12 @@
contrib Unofficial stuff contrib Unofficial stuff, add-on programs
doc Documentation, mostly obsolete doc Documentation
man Manual pages, not obsolete man Manual pages
obsolete Really obsolete stuff ;)
src Source code 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 . 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" 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 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. 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. a much improved update-rc.d. This code is almost a year old.
The original announcement follows: 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 static void
do_help(void) do_help(void)
{ {
printf("\ printf("start-stop-daemon for Debian Linux - small and fast C version written by\n"
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"
Marek Michalkiewicz <marekm@i17linuxb.ists.pwr.wroc.pl>, public domain.\n" "\n"
VERSION "\n\ "Usage:\n"
\n\ " start-stop-daemon -S|--start options ... -- arguments ...\n"
Usage: " start-stop-daemon -K|--stop options ...\n"
start-stop-daemon -S|--start options ... -- arguments ...\n\ " start-stop-daemon -H|--help\n"
start-stop-daemon -K|--stop options ...\n\ " start-stop-daemon -V|--version\n"
start-stop-daemon -H|--help\n\ "\n"
start-stop-daemon -V|--version\n\ "Options (at least one of --exec|--pidfile|--user is required):\n"
\n\ " -x|--exec <executable> program to start/check if it is running\n"
Options (at least one of --exec|--pidfile|--user is required): " -p|--pidfile <pid-file> pid file to check\n"
-x|--exec <executable> program to start/check if it is running\n\ " -u|--user <username>|<uid> stop this user's processes\n"
-p|--pidfile <pid-file> pid file to check\n\ " -n|--name <process-name> stop processes with this name\n"
-u|--user <username>|<uid> stop this user's processes\n\ " -s|--signal <signal> signal to send (default 15)\n"
-n|--name <process-name> stop processes with this name\n\ " -a|--startas <pathname> program to start (default <executable>)\n"
-s|--signal <signal> signal to send (default 15)\n\ " -t|--test test mode, don't do anything\n"
-a|--startas <pathname> program to start (default <executable>)\n\ " -o|--oknodo exit status 0 (not 1) if nothing done\n"
-t|--test test mode, don't do anything\n\ " -q|--quiet | -v, --verbose\n"
-o|--oknodo exit status 0 (not 1) if nothing done\n\ "\n"
-q|--quiet | -v, --verbose\n\ "Exit status: 0 = done 1 = nothing done (=> 0 if --oknodo) 2 = trouble\n",
\n\ VERSION);
Exit status: 0 = done 1 = nothing done (=> 0 if --oknodo) 2 = trouble\n");
} }

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, init, shutdown, halt, reboot, wall, last, mesg, runlevel,
killall5, pidof, sulogin. killall5, pidof, sulogin.
All programs, files and scripts in this package are covered by 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, If you are not using Debian and the debianized package,
you will have to install the new init by hand. You should you may have to install the new init by hand if Debian is
be able to drop the binaries into a Slackware or Redhat using an init system other than SysV (eg systemd). You should
system, I think. 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 wall.1, last.1, mesg.1 /usr/man/man1
inittab.5, initscript.5 /usr/man/man5 inittab.5, initscript.5 /usr/man/man5
@ -40,7 +58,7 @@ bootlogd /sbin/bootlogd
utmpdump don't install, it's just a debug thingy. utmpdump don't install, it's just a debug thingy.
If you already _have_ a "wall" in /bin (the SLS release had, for example) 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 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. 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. manual page on shutdown to find out more about this.
Running from a read-only file system (CDROM?): 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 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 IF you use a Linux kernel > 1.3.66. Older kernels don't allow
writing to a FIFO on a read-only file system. 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 NOTE: If you use a standard distribution like Slackware, Devuan
or Redhat there probably is no need to upgrade. Installing sysvinit or Gentoo there probably is no need to upgrade. Installing sysvinit
is only for those that upgrade their system by hand or for people is only for those that upgrade their system by hand or for people
that create Linux distributions. that create Linux distributions.
Sysvinit is probably the most widely used init package for Linux. SysV init was probably the most widely used init package for Linux.
Most distributions use it. sysvinit 2.4 is really a good package, Most distributions once used it. sysvinit 2.4 was really a good package,
and it was not the need for bugfixes but the need for more features and it was not the need for bug fixes but the need for more features
that made me work on sysvinit again. 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 special in any way -- in fact you can just unpack and compile
it on any other Linux distribution. it on any other Linux distribution.
@ -61,7 +61,7 @@ as in the 2.4 release:
The sysvinit package includes 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 telinit program (er, just a link to /sbin/init) to change runlevels
* a featureful shutdown * a featureful shutdown
* halt and reboot to assist shutdown * halt and reboot to assist shutdown
@ -69,13 +69,7 @@ The sysvinit package includes
* the wall & mesg programs (not installed by default) * the wall & mesg programs (not installed by default)
* manpages for everything * 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 http://download.savannah.nongnu.org/releases/sysvinit/
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)

10
doc/sysvinit-2.86.lsm
View File

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