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
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.
More information about the Debian-init-diversity
mailing list