summaryrefslogtreecommitdiff
path: root/man/systemd.xml
Commit message (Collapse)AuthorAgeFilesLines
* man: add description of org.freedesktop.LogControl1Zbigniew Jędrzejewski-Szmek2020-05-051-1/+4
| | | | | | I'm not sure if the LogTarget property is sufficiently general to be made into a property that can be generally implemented. It is very closely tied to the internal systemd logic. The other two seem fine thoough.
* man: sd_notify() race is gone with sd_notify_barrier()Kumar Kartikeya Dwivedi2020-05-011-1/+1
| | | | | | | Add note for change of behaviour in systemd-notify, where parent pid trick is only used when --no-block is passed, and with enough privileges ofcourse. Also, fix a small error in systemd(1).
* man: import org.freedesktop.systemd1(3) from the wikiZbigniew Jędrzejewski-Szmek2020-04-161-0/+4
| | | | | | | As usual, the formatting was fixed and various obvious updates were done, but nothing major. I removed documentation of snapshots and related methods though.
* Merge pull request #13084 from ddstreet/log_timeLennart Poettering2020-03-301-26/+43
|\ | | | | log: add support for prefixing console log messages with current timestamp
| * log: add support for prefixing console log messages with current timestampDan Streetman2020-02-101-3/+20
| |
| * man: remove the '=' from --log-color and --log-location as they are optional argDan Streetman2020-02-101-5/+5
| | | | | | | | | | | | | | These params are optional arg, so remove the '=' from their doc. Also include systemd.log_location in the statement explaining they are set to true if no argument is provided to the parameter.
| * man: sort log parameters in alphabetical orderDan Streetman2020-02-101-26/+26
| | | | | | | | | | This only sorts the --log-* params in order in the man page docs; no text is added or removed or modified.
* | Modified line 197 for readability. (#15071)dolphrundgren2020-03-101-1/+1
| | | | | | | | * Dropped "of some sort" from line 197 of man/systemd.xml
* | man: Add documentation for generator path environment variablesBenjamin Berg2020-03-041-3/+11
| | | | | | | | | | | | | | | | | | This adds documentation for the SYSTEMD_GENERATOR_PATH and SYSTEMD_ENVIRONMENT_GENERATOR_PATH variables to the systemd man page grouped with the existing SYSTEMD_UNIT_PATH. Also added is a description about how these variables work, i.e. that a trailing : can be used to prepend paths to the usual set.
* | pid1: add new mode systemd.show-status=error and use it when 'quiet' is passedZbigniew Jędrzejewski-Szmek2020-03-011-9/+8
| | | | | | | | | | | | | | | | | | | | | | systemd.show-status=error is useful for the case where people care about errors only. If people want to have a quiet boot, they most likely don't want to see all status output even if there is a delay in boot, so make "quiet" imply systemd.show-status=error instead of systemd.show-status=auto. Fixes #14976.
* | pid1: when showing error status, do not switch to status=temporaryZbigniew Jędrzejewski-Szmek2020-03-011-3/+3
|/ | | | | | | | | | | | | | We would flip to status=temporary mode on the first error, and then switch back to status=auto after the initial transaction was done. This isn't very useful, because usually all the messages about successfully started units and not related to the original failure. In fact, all those messages most likely cause the information about the prime error to scroll off screen. And if the user requested quiet boot, there's no reason to think that they care about those success messages. Also, when logging about dependency cycles, treat this similarly to a unit error and show the message even if the status is "soft disabled" (before we wouldn't show it in that case).
* doc: link to html versions of cgroup docsZbigniew Jędrzejewski-Szmek2020-01-091-1/+1
| | | | Also stop linking to some (obsolete) v1 documentation.
* man: change links to container interface doc to https://systemd.io/Lennart Poettering2020-01-061-4/+3
| | | | Now that we converted the documentation we should also link to it.
* Fix several typos in documentationFelipe Sateler2019-12-241-1/+1
| | | | Found by lintian
* man: document all pager variables for systemctl and systemdZbigniew Jędrzejewski-Szmek2019-11-241-2/+5
| | | | | | In those two pages, we need to include individual entries with xi:include to merge the list less-variables.xml with the other entries, which is obviously error prone. All variables are supported in both tools so add them.
* man: significantly downgrade the Options section in systemd(1)Zbigniew Jędrzejewski-Szmek2019-11-151-225/+208
| | | | | | | | | | | | | | | | | | This structure of the man page originates from the time when systemd was installed on top of sysvinit systems, and users had an actual chance to interact with the systemd binary directly. Nowadays it is almost never called directly, so let's properly explain this in the overview. The Options section is moved down below the kernel command line, those options are only needed in special circumstances. Let's refer the reader to the description of the kernel command line options, and not duplicate the descriptions (which makes the text longer than necessary and increases chances for discrepancies). Systemd is also prominently used as the user manager, let's mention that in the Overview. While at it, use "=" only when an argument is required as we nowadays do.
* man: share description of $SYSTEMD_COLORS in other toolsZbigniew Jędrzejewski-Szmek2019-11-151-17/+2
| | | | | | | | | | It was only described in systemd(1), making it hard to discover. Fixes #13561. The same for $SYSTEMD_URLIFY. I think all the tools whose man pages include less-variables.xml support those variables.
* man: document SystemdOptions variableZbigniew Jędrzejewski-Szmek2019-09-161-7/+7
|
* docs: typo in arg name replace-irreversible -> replace-irreversiblyAnita Zhang2019-07-191-6/+6
|
* Add config and kernel commandline option to use short identifiersZbigniew Jędrzejewski-Szmek2019-07-101-0/+10
| | | | | | | No functional change, just docs and configuration and parsing. v2: - change ShortIdentifiers=yes|no to StatusUnitFormat=name|description.
* man: say D-Bus, not dbusLennart Poettering2019-06-251-3/+2
|
* man: improve --test documentationLennart Poettering2019-06-251-6/+7
| | | | | | | Incorporates some suggestions from: https://github.com/systemd/systemd/pull/12868#discussion_r296738370 https://github.com/systemd/systemd/commit/cd69e88ba3a692618048117b26fc9ea339aa1845#commitcomment-34060775
* man: drop references to "syslog" and "syslog+console" from man pageLennart Poettering2019-06-241-2/+0
| | | | | | | | | | | | | | These options are pretty much equivalent to "journal" and "journal+console" anyway, let's simplify things, and drop them from the documentation hence. For compat reasons let's keep them in the code. (Note that they are not 100% identical to 'journal', but I doubt the distinction in behaviour is really relevant to keep this in the docs. And we should probably should drop 'syslog' entirely from our codebase eventually, but it's problematic as long as we semi-support udev on non-systemd systems still.)
* doc: make clear that --system and --user only make sense with --testLennart Poettering2019-06-241-14/+16
| | | | Fixes: #12843
* 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
* tree-wide: fix some trailing whitespaceLennart Poettering2019-01-171-1/+1
| | | | | | | | @bl33pbl0p, please fix your editor (Apparently you never configured the source tree? If you did, then the git pre-commit hook would have been enabled which doesn't allow commiting non-whitespace clean stuff...)
* Add note about transactions being genereated independently of a unit's state.bl33pbl0p2019-01-171-1/+12
| | | | Meanwhile, change dead -> inactive as it is not a unit state.
* man: use <keycombo> moreZbigniew Jędrzejewski-Szmek2018-11-141-10/+9
|
* man: document what "in-memory" units meansLennart Poettering2018-10-301-0/+19
| | | | Fixes: #10338
* Merge pull request #9824 from poettering/login-unit-fixesZbigniew Jędrzejewski-Szmek2018-10-161-1/+1
|\ | | | | many logind improvements
| * man: also use "yes"/"no" rather than "true"/"false" in man pagesLennart Poettering2018-10-131-1/+1
| | | | | | | | | | | | | | | | | | We usually use yes/no in all our unit files, do the same in the man pages. Triggered by: https://github.com/systemd/systemd/pull/9824#issuecomment-420729987
* | man: link two more documents from systemd.io from appropriate man pagesLennart Poettering2018-10-121-0/+3
|/
* man: convert old compile option to meson optionYu Watanabe2018-07-091-2/+2
|
* man: drop mode line in file headersZbigniew Jędrzejewski-Szmek2018-07-031-1/+1
| | | | | This is already included in .dir-locals, so we don't need it in the files themselves.
* 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.
* pid1: preserve current value of log target across re-{load,execution}Franck Bui2018-06-131-11/+12
| | | | | | | | | | | | | To make debugging easier, this patches allows one to change the log target and do reload/reexec without modifying configuration permanently, which makes debugging easier. Indeed if one changed the log target at runtime (via the bus or via signals), the change was lost on the next reload/reexecution. In order to restore back the default value (set via system.conf, environment variables or any other means ), the empty string in the "LogTarget" property is now supported as well as sending SIGTRMIN+26 signal.
* pid1: preserve current value of log level across re-{load,execution}Franck Bui2018-06-131-7/+10
| | | | | | | | | | | | | To make debugging easier, this patches allows one to change the log level and do reload/reexec without modifying configuration permanently, which makes debugging easier. Indeed if one changed the log max level at runtime (via the bus or via signals), the change was lost on the next daemon reload/reexecution. In order to restore the original value back (set via system.conf, environment variables or any other means), the empty string in the "LogLevel" property is now supported as well as sending SIGRTMIN+23 signal.
* core: add --dump-bus-properties option to systemdYu Watanabe2018-05-281-0/+7
| | | | | If systemd is invoked with this option, this dumps all bus properties. This may be useful for shell completion for `systemctl --property`.
* terminal: add internal API to format URLs for display in capable terminalsLennart Poettering2018-04-191-0/+9
| | | | | | | | | | | | | | | | Newer terminals (in particular gnome-terminal) understand special escape sequence for formatting clickable links. Let's support that to make our tool output more clickable where that's appropriate. For details see this: https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda The one big issue is that 'less' currently doesn't grok this, and doesn't ignore sequence like regular terminal implementations do if they don't support it. Hence for now, let's disable URL output if a pager is used. We should revisit that though as soon as less added support for it and enough time passed for it to enter various distributions.
* 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.
* pid1: add option to disable service watchdogsJan Klötzke2018-01-221-0/+22
| | | | | Add a "systemd.service_watchdogs=" option to the command line which disables all service runtime watchdogs and emergency actions.
* man: fix broken kernel document links (#7892)John Lin2018-01-161-1/+1
|
* man: systemd: fix typo (#7746)nulsoh2017-12-271-1/+1
| | | Add missing _r_ for ctl-alt-del.target
* man: Clarify when OnFailure= activates after restarts (#7646)Ken (Bitsko) MacLeod2017-12-151-5/+6
|
* man: "systemd" is to be written in all lower-case, even at beginnings of ↵Lennart Poettering2017-12-131-1/+1
| | | | | | sentences This very important commit is very important.
* man: fix binary path in systemd(1) (#7550)Lennart Poettering2017-12-051-1/+1
| | | | | Otherwise people might assume that systemd was installed in the $PATH, but it is not. Do the same as for systemd-vconsole-setup.service and friends: let's include the full path in the man page.
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
View Lorry Controller Status