summaryrefslogtreecommitdiff
path: root/man/daemon.xml
Commit message (Collapse)AuthorAgeFilesLines
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* man: always document both the ipv4 and the ipv6 sockoptLennart Poettering2020-09-111-30/+20
|
* tree-wide: drop quotes from around [section]Zbigniew Jędrzejewski-Szmek2020-07-061-2/+2
| | | | | | | For users, the square brackets already serve as markup and clearly delineate the section name from surrounding text. Putting additional markup around that only adds clutter. Also, we were very inconsistent in using the quotes. Let's just drop them altogether.
* man: fix a few bogus entries in directives indexZbigniew Jędrzejewski-Szmek2019-11-211-1/+1
| | | | | | When wrong element types are used, directives are sometimes placed in the wrong section. Also, strip part of text starting with "'", which is used in a few places and which is displayed improperly in the index.
* Merge pull request #12002 from keszybz/man-headersLennart Poettering2019-03-141-5/+2
|\ | | | | Man headers
| * man: use same header for all filesZbigniew Jędrzejewski-Szmek2019-03-141-1/+1
| | | | | | | | | | | | | | The "include" files had type "book" for some raeason. I don't think this is meaningful. Let's just use the same everywhere. $ perl -i -0pe 's^..DOCTYPE (book|refentry) PUBLIC "-//OASIS//DTD DocBook XML V4.[25]//EN"\s+"http^<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"\n "http^gms' man/*.xml
| * man: standarize on one-line license headerZbigniew Jędrzejewski-Szmek2019-03-141-4/+1
| | | | | | | | | | | | No need to waste space, and uniformity is good. $ perl -i -0pe 's|\n+<!--\s*SPDX-License-Identifier: LGPL-2.1..\s*-->|\n<!-- SPDX-License-Identifier: LGPL-2.1+ -->|gms' man/*.xml
* | man: mention O_NOCTTY and it's importance in daemon(7)Lennart Poettering2019-03-141-3/+8
|/ | | | Fixes: #9164
* man/daemon.xml: use AM_DISTCHECK_CONFIGURE_FLAGSOliver Smith2018-12-041-1/+1
| | | | | | | | | | | Change the man page to recommend setting AM_DISTCHECK_CONFIGURE_FLAGS instead of DISTCHECK_CONFIGURE_FLAGS. This is the recommended way from the automake manual, as otherwise the flag can't be overridden by the user with something like: DISTCHECK_CONFIGURE_FLAGS=--some-additional-flags make distcheck References: https://www.gnu.org/software/automake/manual/html_node/Checking-the-Distribution.html https://osmocom.org/issues/3718
* man: drop unused <authorgroup> tags from man sourcesZbigniew Jędrzejewski-Szmek2018-06-141-9/+0
| | | | | | | | | | | | Docbook styles required those to be present, even though the templates that we use did not show those names anywhere. But something changed semi-recently (I would suspect docbook templates, but there was only a minor version bump in recent years, and the changelog does not suggest anything related), and builds now work without those entries. Let's drop this dead weight. Tested with F26-F29, debian unstable. $ perl -i -0pe 's/\s*<authorgroup>.*<.authorgroup>//gms' man/*xml
* tree-wide: remove Lennart's copyright linesLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | These lines are generally out-of-date, incomplete and unnecessary. With SPDX and git repository much more accurate and fine grained information about licensing and authorship is available, hence let's drop the per-file copyright notice. Of course, removing copyright lines of others is problematic, hence this commit only removes my own lines and leaves all others untouched. It might be nicer if sooner or later those could go away too, making git the only and accurate source of authorship information.
* tree-wide: drop 'This file is part of systemd' blurbLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | | | | | | This part of the copyright blurb stems from the GPL use recommendations: https://www.gnu.org/licenses/gpl-howto.en.html The concept appears to originate in times where version control was per file, instead of per tree, and was a way to glue the files together. Ultimately, we nowadays don't live in that world anymore, and this information is entirely useless anyway, as people are very welcome to copy these files into any projects they like, and they shouldn't have to change bits that are part of our copyright header for that. hence, let's just get rid of this old cruft, and shorten our codebase a bit.
* tree-wide: drop license boilerplateZbigniew Jędrzejewski-Szmek2018-04-061-13/+0
| | | | | | | | | | Files which are installed as-is (any .service and other unit files, .conf files, .policy files, etc), are left as is. My assumption is that SPDX identifiers are not yet that well known, so it's better to retain the extended header to avoid any doubt. I also kept any copyright lines. We can probably remove them, but it'd nice to obtain explicit acks from all involved authors before doing that.
* man: "systemd" is to be written in all lower-case, even at beginnings of ↵Lennart Poettering2017-12-131-3/+3
| | | | | | sentences This very important commit is very important.
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
* man: don't claim systemd would connect stdout/stderr of daemons with /dev/nullLennart Poettering2016-04-221-8/+6
|
* tree-wide: use mdash instead of a two minusesZbigniew Jędrzejewski-Szmek2016-04-211-1/+1
|
* doc: correct punctuation and improve typography in documentationJan Engelhardt2015-11-061-3/+3
|
* man: revert dynamic paths for split-usr setupsTom Gundersen2015-06-181-4/+1
| | | | | | | | | | | | | | | | | | | | | | | This did not really work out as we had hoped. Trying to do this upstream introduced several problems that probably makes it better suited as a downstream patch after all. At any rate, it is not releaseable in the current state, so we at least need to revert this before the release. * by adjusting the path to binaries, but not do the same thing to the search path we end up with inconsistent man-pages. Adjusting the search path too would be quite messy, and it is not at all obvious that this is worth the effort, but at any rate it would have to be done before we could ship this. * this means that distributed man-pages does not make sense as they depend on config options, and for better or worse we are still distributing man pages, so that is something that definitely needs sorting out before we could ship with this patch. * we have long held that split-usr is only minimally supported in order to boot, and something we hope will eventually go away. So before we start adding even more magic/effort in order to make this work nicely, we should probably question if it makes sense at all.
* man: generate configured paths in manpagesFilipe Brandenburger2015-05-281-1/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In particular, use /lib/systemd instead of /usr/lib/systemd in distributions like Debian which still have not adopted a /usr merge setup. Use XML entities from man/custom-entities.ent to replace configured paths while doing XSLT processing of the original XML files. There was precedent of some files (such as systemd.generator.xml) which were already using this approach. This addresses most of the (manual) fixes from this patch: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/patches/Fix-paths-in-man-pages.patch?h=experimental-220 The idea of using generic XML entities was presented here: http://lists.freedesktop.org/archives/systemd-devel/2015-May/032240.html This patch solves almost all the issues, with the exception of: - Path to /bin/mount and /bin/umount. - Generic statements about preference of /lib over /etc. These will be handled separately by follow up patches. Tested: - With default configure settings, ran "make install" to two separate directories and compared the output to confirm they matched exactly. - Used a set of configure flags including $CONFFLAGS from Debian: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/rules Installed the tree and confirmed the paths use /lib/systemd instead of /usr/lib/systemd and that no other unexpected differences exist. - Confirmed that `make distcheck` still passes.
* Reindent man pages to 2chZbigniew Jędrzejewski-Szmek2015-02-031-894/+702
|
* Use log "level" instead of "priority"Zbigniew Jędrzejewski-Szmek2014-11-011-3/+3
| | | | | | | | | | | | The term "priority" is misleading because higher levels have lower priority. "Level" is clearer and shorter. This commit touches only the textual descriptions, not function and variable names themselves. "Priority" is used in various command-line switches and protocol constants, so completly getting rid of "priority" is hard. I also left "priority" in various places where the clarity suffered when it was removed.
* man: use more markup in daemon(7)Zbigniew Jędrzejewski-Szmek2014-10-031-4/+5
|
* man: add a mapping for external manpagesZbigniew Jędrzejewski-Szmek2014-07-071-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | It is annoying when we have dead links on fd.o. Add project='man-pages|die-net|archlinux' to <citerefentry>-ies. In generated html, add external links to http://man7.org/linux/man-pages/man, http://linux.die.net/man/, https://www.archlinux.org/. By default, pages in sections 2 and 4 go to man7, since Michael Kerrisk is the autorative source on kernel related stuff. The rest of links goes to linux.die.net, because they have the manpages. Except for the pacman stuff, since it seems to be only available from archlinux.org. Poor gummiboot gets no link, because gummitboot(8) ain't to be found on the net. According to common wisdom, that would mean that it does not exist. But I have seen Kay using it, so I know it does, and deserves to be found. Can somebody be nice and put it up somewhere?
* man: daemon - typo fixThomas Hindoe Paaboel Andersen2014-06-301-1/+1
|
* man: drop references to manual StandardError=syslog from daemon(7), we do ↵Lennart Poettering2014-06-301-23/+15
| | | | this implicitly since ages
* man: add a minimized, modernized description of the file system hierarchy ↵Lennart Poettering2014-06-301-1/+10
| | | | systemd suggests
* man: update URL refernce in daemon(7)Lennart Poettering2014-05-221-1/+1
| | | | http://lists.freedesktop.org/archives/systemd-devel/2014-May/019410.html
* man: drop reference to file locking for PID file creation from daemon(7)Lennart Poettering2014-05-221-3/+1
| | | | File locking is usually a bad idea, don't suggest using it.
* doc: write out stdin/stdout file descriptorsJan Engelhardt2014-05-071-2/+2
| | | | | | | | "When refering to code, STDOUT/STDOUT/STDERR are replaced with stdin/stdout/stderr, and in other places they are replaced with normal phrases like standard output, etc." Addendum to commit v209~127.
* man: update link to LSBZbigniew Jędrzejewski-Szmek2014-03-061-2/+2
| | | | https://bugzilla.redhat.com/show_bug.cgi?id=1073402
* Replace /var/run with /run in remaining placesZbigniew Jędrzejewski-Szmek2014-02-251-1/+1
| | | | | /run was already used almost everywhere, fix the remaining places for consistency.
* doc: quote consistently in autoconf codeJan Engelhardt2014-02-171-3/+3
| | | | | | AS_HELP_STRING has been observed to expand such that the surround function complains; play it safe and consistenly quote the example code throughout.
* man: replace STDOUT with standard output, etc.Zbigniew Jędrzejewski-Szmek2014-02-141-10/+11
| | | | | | | | | Actually 'STDOUT' is something that doesn't appear anywhere: in the stdlib we have 'stdin', and there's only the constant STDOUT_FILENO, so there's no reason to use capitals. When refering to code, STDOUT/STDOUT/STDERR are replaced with stdin/stdout/stderr, and in other places they are replaced with normal phrases like standard output, etc.
* man: always place <programlisting> and </programlisting> in a line with ↵Lennart Poettering2014-02-141-2/+1
| | | | actual sources, so that we don't get spurious newlines in the man page output
* man: include autoconf snippet in daemon(7)Michał Górny2013-12-271-6/+14
| | | | https://bugs.freedesktop.org/show_bug.cgi?id=40446
* man: grammar and wording improvementsJan Engelhardt2013-12-251-1/+1
| | | | | | | This is a recurring submission and includes corrections to: - missing words, preposition choice. - change of /lib to /usr/lib, because that is what most distros are using as the system-wide location for systemd/udev files.
* man: more grammar improvementsJan Engelhardt2013-07-031-65/+65
| | | | | | - place commas - expand contractions (this is written prose :) - add some missing words
* man: add more formatting markupZbigniew Jędrzejewski-Szmek2013-07-021-3/+3
|
* man: use <constant> for various constants which look ugly with quotesZbigniew Jędrzejewski-Szmek2013-06-261-2/+2
|
* man: always supply quotes around literalsZbigniew Jędrzejewski-Szmek2013-06-261-1/+1
| | | | | | | | When manpages are displayed on a terminal, <literal>s are indistinguishable from surrounding text. Add quotes everywhere, remove duplicate quotes, and tweak a few lists for consistent formatting. https://bugzilla.redhat.com/show_bug.cgi?id=874631
* Standardize on 'file system' and 'namespace' in man pages.David Strauss2013-05-181-1/+1
| | | | | | This change is based on existing usage in systemd and online. 'File-system' may make sense in adjectival form, but man pages seem to prefer 'file system' even in those situations.
* man: fix some spelling mistakesRamkumar Ramachandra2012-11-301-1/+1
|
* Reword sentences that contain psuedo-English "resp."Andrew Eikum2012-10-161-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | As you likely know, Arch Linux is in the process of moving to systemd. So I was reading through the various systemd docs and quickly became baffled by this new abbreviation "resp.", which I've never seen before in my English-mother-tongue life. Some quick Googling turned up a reference: <http://www.transblawg.eu/index.php?/archives/870-Resp.-and-other-non-existent-English-wordsNicht-existente-englische-Woerter.html> I guess it's a literal translation of the German "Beziehungsweise", but English doesn't work the same way. The word "respectively" is used exclusively to provide an ordering connection between two lists. E.g. "the prefixes k, M, and G refer to kilo-, mega-, and giga-, respectively." It is also never abbreviated to "resp." So the sentence "Sets the default output resp. error output for all services and sockets" makes no sense to a natural English speaker. This patch removes all instances of "resp." in the man pages and replaces them with sentences which are much more clear and, hopefully, grammatically valid. In almost all instances, it was simply replacing "resp." with "or," which the original author (Lennart?) could probably just do in the future. The only other instances of "resp." are in the src/ subtree, which I don't feel privileged to correct. Signed-off-by: Andrew Eikum <aeikum@codeweavers.com>
* man: fix a bunch of typos in docsThomas Hindoe Paaboel Andersen2012-09-131-5/+5
| | | | https://bugs.freedesktop.org/show_bug.cgi?id=54501
* man: reword man page titlesLennart Poettering2012-07-161-1/+1
| | | | | Make sure the man page titles are similar in style and capitalization so that our man page index looks pretty.
* man: move header file man pages from section 7 to 3Lennart Poettering2012-07-131-3/+3
| | | | | This way we can include documentation about minor macros/inline function within the introducionary man page in a sane way.
* man: document the new RPM macros in daemon(7)Lennart Poettering2012-06-211-34/+35
|
* relicense to LGPLv2.1 (with exceptions)Lennart Poettering2012-04-121-4/+4
| | | | | | | | | | | | | | We finally got the OK from all contributors with non-trivial commits to relicense systemd from GPL2+ to LGPL2.1+. Some udev bits continue to be GPL2+ for now, but we are looking into relicensing them too, to allow free copy/paste of all code within systemd. The bits that used to be MIT continue to be MIT. The big benefit of the relicensing is that closed source code may now link against libsystemd-login.so and friends.
* man: don't recommend After=syslog.target anymore since we don't support ↵Lennart Poettering2011-08-311-18/+0
| | | | non-socket-activatable syslogs anymore where that was ncessary
View Lorry Controller Status