--- Begin Message ---
- To: Debian Bug Tracking System <submit@bugs.debian.org>
- Subject: [PROPOSAL] better initscript definition, and adding 'restart-if-running'
- From: Henrique M Holschuh <hmh@debian.org>
- Date: Wed, 28 Feb 2001 12:24:25 -0300
- Message-id: <20010228122425.A6112@godzillah>
Package: debian-policy
Version: 3.5.2.0
Severity: wishlist
This proposal has ties to #76868 (invoke-rc.d), #60979 (what /etc/init.d/xxx
restart does?).
"Action" in the text below is the *first* parameter specified for an init
script (e.g.: in /etc/init.d/foo start, "start" is the action).
The naming for the new 'initscript action' was discussed in #76868, before
it was split from the main proposal of invoke-rc.d.
I propose that a new init script action, 'restart-if-running', defined as:
IFF daemon-is-running-NOW then
stop daemon
start daemon
return OK exit status if daemon started, otherwise return ERROR
else
return OK exit status
to be defined in policy, as *OPTIONAL*.
The main reason for such definition is that we currently lack the
functionality provided by 'restart-if-running', and it cannot be easily (as
in not in an error-prone way) emulated through other methods.
I'd also like us to better define init scripts, by making it forbidden to
have initscripts in Debian that:
1. Act in a non-expected way for any of the actions defined in policy
(e.g.: stopping a daemon in the 'start' action)
2. Misbehaves if given an unknown action
(e.g.: running the 'start' action regardless of what is passed to it as
the first argument -- we have some stuff in rcS.d that has this problem,
and yes, I am offering myself to hunt the offending parties down, fix
them, send patches to the BTS, and NMU if the maintainer is too busy
to apply the patch and upload).
This should be read as: the initscript should return an non-zero status
code if called with an unknown/unsupported action.
-- System Information
Debian Release: testing/unstable
Architecture: i386
Kernel: Linux godzillah.rivendell.sol 2.2.19pre16 #1 Tue Feb 27 21:55:56 BRT 2001 i586
Versions of packages debian-policy depends on:
ii fileutils 4.0.37-1 GNU file management utilities.
--
"One disk to rule them all, One disk to find them. One disk to bring
them all and in the darkness grind them. In the Land of Redmond
where the shadows lie." -- The Silicon Valley Tarot
Henrique Holschuh
--- End Message ---
--- Begin Message ---
Source: debian-policy
Source-Version: 4.0.0.0
We believe that the bug you reported is fixed in the latest version of
debian-policy, which is due to be installed in the Debian FTP archive.
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to 181123@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Russ Allbery <rra@debian.org> (supplier of updated debian-policy package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@ftp-master.debian.org)
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Format: 1.8
Date: Sun, 28 May 2017 12:27:07 -0700
Source: debian-policy
Binary: debian-policy
Architecture: source
Version: 4.0.0.0
Distribution: experimental
Urgency: low
Maintainer: Debian Policy List <debian-policy@lists.debian.org>
Changed-By: Russ Allbery <rra@debian.org>
Description:
debian-policy - Debian Policy Manual and related documents
Closes: 175064 181123 568374 688220 698012 700532 734662 746514 759186 759492 768117 768292 781654 792853 793493 793999 794902 798309 809382 816249 816515 819660 820197 821365 821859 822059 823348 823910 824922 829367 830989 833177 835490 835876 841877 849483 850646 852314
Changes:
debian-policy (4.0.0.0) experimental; urgency=low
.
[ Andreas Barth ]
* Policy: Add the MPLs to /usr/share/common-licenses
Wording: Charles Plessy <plessy@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Andrey Rahmatullin <wrar@debian.org>
Closes: #768292
* Policy: [5.6.12] forbid colons in package version numbers
Wording: Charles Plessy <plessy@debian.org>
Seconded: Didier 'OdyX' Raboud <odyx@debian.org>
Seconded: Sam Hartman <hartmans@debian.org>
Thanks: Jakub Wilk <jwilk@debian.org>
Closes: #792853
* Policy: [4.3] Update config.guess and config.sub during the build
Wording: Bill Allombert <ballombe@debian.org>
Seconded: Niels Thykier <niels@thykier.net>
Seconded: Andreas Barth <aba@ayous.org>
Closes: #746514
* Spelling fixes, thanks to Martin A. Brown. Closes: #820197
.
[ Russ Allbery ]
* Policy: [10.9] Don't contact base-passwd maintainer for dynamic users
Wording: Colin Watson <cjwatson@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Didier 'OdyX' Raboud <odyx@debian.org>
Seconded: gregor herrmann <gregoa@debian.org>
Closes: #841877
* Policy: Document Build-Depends-Arch and Build-Conflicts-Arch
Wording: Johannes Schauer <josch@debian.org>
Seconded: Stuart Prescott <stuart@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Closes: #823910
* Policy: Add nodoc tag to DEB_BUILD_OPTIONS
Wording: Russ Allbery <rra@debian.org>
Seconded: Johannes Schauer <j.schauer@email.de>
Seconded: Charles Plessy <plessy@debian.org>
Seconded: Andrey Rahmatullin <wrar@debian.org>
Closes: #759186
* Policy: Prohibit file conflicts between /bin and /usr/bin
Wording: Ansgar Burchardt <ansgar@debian.org>
Wording: Russ Allbery <rra@debian.org>
Seconded: Raphael Hertzog <hertzog@debian.org>
Seconded: Felipe Sateler <fsateler@debian.org>
Closes: #759492
* Policy: Debug packages don't need a debian/control paragraph
Wording: Tanguy Ortolo <tanguy+debian@ortolo.eu>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Raphael Hertzog <hertzog@debian.org>
Closes: #819660
* Policy: New dpkg-architecture flags
Wording: Guillem Jover <guillem@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Raphael Hertzog <hertzog@debian.org>
Closes: #793493
* Policy: Remove even the fallback to calling /etc/init.d directly
Wording: Ondřej Nový <onovy@debian.org>
Seconded: Michael Stapelberg <stapelberg@debian.org>
Seconded: Andreas Henriksson <andreas@fatal.se>
Closes: #833177
* Policy: Limit strength of dependencies on -doc packages
Wording: Josh Triplett <josh@joshtriplett.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Raphael Hertzog <hertzog@debian.org>
Seconded: Niels Thykier <niels@thykier.net>
Closes: #823348
* Policy: Explicitly allow https form of copyright-format URL
Wording: Russ Allbery <rra@debian.org>
Seconded: Andrey Rahmatullin <wrar@debian.org>
Seconded: gregor herrmann <gregoa@debian.org>
Seconded: Didier 'OdyX' Raboud <odyx@debian.org>
Closes: #850646
* Policy: Recommend libraryname-dev or librarynameAPIVERSION-dev
Wording: Ansgar Burchardt <ansgar@debian.org>
Seconded: Julien Cristau <jcristau@debian.org>
Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
Closes: #568374
* Policy: Add optional try-restart init status, make status recommended
Wording: Andreas Henriksson <andreas@fatal.se>
Seconded: Simon McVittie <smcv@debian.org>
Seconded: Felipe Sateler <fsateler@debian.org>
Seconded: Ondřej Nový <novy@ondrej.org>
Closes: #181123
* Policy: No special dependency now required for /run
Wording: Marc Haber <mh+debian-packages@zugschlus.de>
Seconded: Andreas Henriksson <andreas@fatal.se>
Seconded: Russ Allbery <rra@debian.org>
Closes: #852314
* Policy: Update policy on /dev and device file management
Wording: Russ Allbery <rra@debian.org>
Seconded: Andreas Henriksson <andreas@fatal.se>
Seconded: Simon McVittie <smcv@debian.org>
Closes: #698012
* Policy: Remove integration instructions for upstart
Wording: Ansgar Burchardt <ansgar@debian.org>
Seconded: Michael Biebl <biebl@debian.org>
Seconded: Andrey Rahmatullin <wrar@debian.org>
Seconded: Simon McVittie <smcv@debian.org>
Closes: #835490
* Perl: Update module search path for multiarch support
Wording: Dominic Hargreaves <dom@earth.li>
Seconded: Niko Tyni <ntyni@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Closes: #798309
* virtual-package-names-list: Add adventure
Wording: Ben Finney <ben+debian@benfinney.id.au>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Niels Thykier <niels@thykier.net>
Closes: #821859
* virtual-package-names-list: Add httpd-wsgi3
Wording: Bill Allombert <ballombe@debian.org>
Seconded: Brian May <bam@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Closes: #768117
* virtual-package-names-list: Add virtual-mysql-* packages
Wording: Otto Kekäläinen <otto@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Raphael Hertzog <hertzog@debian.org>
Closes: #829367
* Convert all remaining DebianDoc-SGML source files in the package to
DocBook XML. Many thanks to Osamu Aoki and Guillem Jover for lots of
hard work on the conversion. This was a huge conversion, so there
will probably be some lingering formatting issues, incorrect markup,
and less-than-ideal output. Please report any problems as bugs.
(Closes: #175064, #700532, #809382)
* Additional fixes from Guillem Jover as part of the DocBook conversion:
- Stop distributing the source SGML files as part of the installed
package. There doesn't seem to be any point in doing this.
- Switch to xsltproc and dblatex instead of OpenJade.
- Stop using tidy on the generated files since it generates larger
files and the output from xsltproc is already compliant and fairly
clean.
- Remove unused Build-Depends.
- Use entities instead of literal <, >, and & characters.
- Use <var> instead of escaped angle brackets for metavariables.
- Use <var> instead of <em> inside <tt>.
- Avoid slashes in section IDs.
- Convert a comment about maintenance policy in the Menu Policy
document to a regular paragraph in the document.
- Replace a comment reference to the policy maintenance process with
an actual link to Process.md.
- Remove obsolete SGML comments.
* Move the description of < and > relations to a footnote to make
abundantly clear that they're no longer valid relation operators in
dependencies. (Closes: #816515)
* Clarify informative mentions of debian/tmp in the appendices to
document the now-common use of debian/<pkg> instead as the temporary
staging area. Document that convention, instead of
debian/tmp-something, for multi-binary packages. Thanks, Niels
Thykier. (Closes: #816249)
* Remove lingering wording that implied that build-arch and build-indep
targets are optional. Thanks, Ferenc Wagner, Jakub Wilk, and Charles
Plessy. (Closes: #793999)
* Rather than giving the paths to the installed shlibs and symbols files
and then saying those paths shouldn't be used, just say to use
dpkg-query --control-show. Recommend --control-show instead of
--control-path, since the latter is deprecated. Patch from Salvatore
Bonaccorso. (Closes: #688220)
* Explicitly give Unicode code points in the definition of the syntax of
Debian control files and, where appropriate, show the character.
Patch from Ben Finney. (Closes: #821365)
* Remove obsolete footnote about a versioned dependency on a
liblockfile1 release from 1999. Thanks, Jakub Wilk. (Closes: #794902)
* Fix the long name of the Common Public License in the copyright-format
policy. It is just Common Public License, with no leading "IBM".
Thanks, Stefano Zacchiroli. (Closes: #781654)
* Fix the copyright-format examples to not have duplicate License
paragraphs. Thanks, Stefan <bd@bc-bd.org>. (Closes: #824922)
* Replace reference to dbus-launch in the autopkgtest documentation with
dbus-run-session. Patch from Simon McVittie. (Closes: #835876)
* Add an example of an architecture restriction in a dependency with
multiple architectures separated by spaces. (Closes: #734662)
* Replace use of markdown with MultiMarkdown for the autopkgtest
documentation and convert README and Process to MultiMarkdown, thus
dropping the last org-mode files and the build dependency on Emacs.
Patch from Guillem Jover. (Closes: #849483)
* Add some additional information to the upgrading-checklist entry for
the 3.9.8.0 release.
* Fix debian/changelog and upgrading-checklist dates for the 3.9.8.0
release to match the actual upload. (Closes: #822059)
* Fix duplicated "the" words in 4.4 and 8.6.3.2. Patch from Valentin
Samir. (Closes: #830989)
* Clean up the upgrading checklist a bit:
- Rewrite the introduction to read a bit more smoothly and mention
that the Standards-Version value omits the minor patch number.
- Remove the minor patch number from all the version headings except
for the anomalies that contain normative changes, and note those
explicitly.
- Remove some unhelpful section headings and trailing colons in very
old upgrading checklist entries.
- Standardize the release date format.
* Compress all files with gzip -n to avoid embedding timestamps,
enabling reproducible builds.
* Redo some of the Makefile and debian/rules dependencies to avoid
ambiguous pattern rules and to ensure that make at the top level
rebuilds output files if input files change.
* Switch to https URLs for Vcs-Git and Vcs-Browser.
* Use the same URL for both Vcs-Git and Vcs-Browser, which now works
fine and has some advantages over the gitweb version for Vcs-Browser.
Thanks, Mattia Rizzolo.
* Run wrap-and-sort -ast.
* Tag as Multi-Arch: foreign (mostly to silence the hinter).
.
[ Sean Whitton ]
* Remove references to DebianDoc-SGML from README.md.
* Fix typo & comma splice in Process.md.
Checksums-Sha1:
67549dd71ee43fecadc298baadedb53d66140acd 1586 debian-policy_4.0.0.0.dsc
94c933d5c4b474500185adab753affe6962562df 659440 debian-policy_4.0.0.0.tar.xz
Checksums-Sha256:
5e2ec94dbf584b2889b309ad45fb12d1fd03bc953d90273d8ea0fee402e62ecc 1586 debian-policy_4.0.0.0.dsc
539fe5c192532eb53fb7d5ffe05a241a0a1ead3cc9f39d88f4656f27110ee877 659440 debian-policy_4.0.0.0.tar.xz
Files:
f759af808fe56dbb1b3c0469c755fa48 1586 doc optional debian-policy_4.0.0.0.dsc
9fe33a84526b82d4544e30f604e6523f 659440 doc optional debian-policy_4.0.0.0.tar.xz
-----BEGIN PGP SIGNATURE-----
iQEzBAEBCAAdFiEE1zk0tJZ0z1zNmsJ4fYAxXFc23nUFAlkrM1UACgkQfYAxXFc2
3nWPrgf/X6/Hn4HFhSQk4uX2Rz7SMU9Mo+dVkSNrzPCVhVjR0EfHu5UbBmwGnXTO
3yshmDFJhz2YKcyjHKB63kmC4rYhoJdCWHDDqjCzCPtmaKRqEHUBJ3pPyOkPz3ZB
h637OyUtQEuxXnp1+a6l6aPxBhz/r1mfa/efDNoJAgmXhTREnwOiAi6BXkK6pG81
fqzW9+cyKK0okJdUKNmAu/mgCtKF1iSIWd86oQUzxs9lNXUVEwbUSqLH9hfe0XvJ
4OmO62NCeoQUFuSFSke97ugadrt8LXezgNNSKr+OXRcz5pSRCBQXpBaFFpYHg7OV
IsLauUljsVlA60IDzAV6kamuBqmMJw==
=5fyI
-----END PGP SIGNATURE-----
--- End Message ---