[2019-08-06 18:17] Adam Borowski <kilob...@angband.pl> > Package: sysv-rc > Version: 2.95-4 > Severity: wishlist > > [A different approach to #912651] > > As you decided to drop the example init script from the live dir, could you > please link to appropriate documentation from /etc/init.d/README (aka > /usr/share/doc/sysv-rc/init.d-README). That file talks about LSB headers > but nothing about how to actually write an init script. > > Or alternatively, edit the file to include such a description inline. > > I think it would be nice to discuss both the init-d-script approach and the > traditinal skeleton, too.
Copy-editing is welcome. You may want to take a look on 82441288 on my improvements (I believe) of init-d-script(5). Remove requirements that init.d scripts work sources. They usually don't, and it is not required by Policy since 3.8.1 From 5d6f6d1121ec7882e227e91242f42c752152b0d1 Mon Sep 17 00:00:00 2001 From: Dmitry Bogatov <kact...@debian.org> Date: Wed, 7 Aug 2019 15:06:09 +0000 Subject: [PATCH] Update /etc/init.d/README to current practices Closes: #934065 --- debian/src/sysv-rc/doc/init.d-README | 44 ++-------------------------- 1 file changed, 3 insertions(+), 41 deletions(-) diff --git a/debian/src/sysv-rc/doc/init.d-README b/debian/src/sysv-rc/doc/init.d-README index 9d2d1428..793bbffc 100644 --- a/debian/src/sysv-rc/doc/init.d-README +++ b/debian/src/sysv-rc/doc/init.d-README @@ -17,44 +17,6 @@ installed you can probably read it at file://localhost/usr/share/doc/debian-policy/ -Some more detailed information can also be found in the files in the -/usr/share/doc/sysv-rc directory. - -Debian Policy dictates that scripts in /etc/init.d/ must work properly when -sourced. The following additional rules apply: - -* /etc/init.d/* scripts must not rely for their correct functioning - on their being sourced rather than executed. That is, they must work - properly when executed too. They must include "#!/bin/sh" at the top. - This is useful when running scripts in parallel. - -* /etc/init.d/* scripts must conform to the rules for sh scripts as - spelled out in the Debian policy section entitled "Scripts" (ยง10.4). - -Use the update-rc.d command to create symbolic links in the /etc/rc?.d -as appropriate. See that man page for more details. - -All init.d scripts are expected to have a LSB style header documenting -dependencies and default runlevel settings. The header look like this -(not all fields are required): - -### BEGIN INIT INFO -# Provides: skeleton -# Required-Start: $remote_fs $syslog -# Required-Stop: $remote_fs $syslog -# Should-Start: $portmap -# Should-Stop: $portmap -# X-Start-Before: nis -# X-Stop-After: nis -# Default-Start: 2 3 4 5 -# Default-Stop: 0 1 6 -# X-Interactive: true -# Short-Description: Example initscript -# Description: This file should be used to construct scripts to be -# placed in /etc/init.d. -### END INIT INFO - -More information on the format is available from insserv(8). This -information is used to dynamicaly assign sequence numbers to the -boot scripts and to run the scripts in parallel during the boot. -See also /usr/share/doc/insserv/README.Debian. +Required behaviour and arguments of init script are described in Policy, but +for usual cases it is enough to use init-d-script(5). More information about +LSB headers (mentioned in init-d-script manual) is available in insserv(8). \ No newline at end of file -- Note, that I send and fetch email in batch, once in a few days. Please, mention in body of your reply when you add or remove recepients.