Bug#934065: sysv-rc: please include/refer to skeleton in /etc/init.d/README

Dmitry Bogatov KAction at debian.org
Thu Aug 8 21:22:07 BST 2019

[2019-08-06 18:17] Adam Borowski <kilobyte at 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 <KAction at 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
-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):
-# 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.
-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.

More information about the Debian-init-diversity mailing list