summaryrefslogtreecommitdiffstats
path: root/man/systemctl.xml (follow)
Commit message (Collapse)AuthorAgeFilesLines
* 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.
* core: introduce a new load state "bad-setting"Lennart Poettering2018-06-111-11/+14
| | | | | | | | | | | | | | | | | | Since bb28e68477a3a39796e4999a6cbc6ac6345a9159 parsing failures of certain unit file settings will result in load failures of units. This introduces a new load state "bad-setting" that is entered in precisely this case. With this addition error messages on bad settings should be a lot more explicit, as we don't have to show some generic "errno" error in that case, but can explicitly say that a bad setting is at fault. Internally this unit load state is entered as soon as any configuration loader call returns ENOEXEC. Hence: config parser calls should return ENOEXEC now for such essential unit file settings. Turns out, they generally already do. Fixes: #9107
* man: don't mention "stub" and "merged" unit load statesLennart Poettering2018-06-111-12/+7
| | | | | | These states should never be visible to the outside, as they are used only internally while loading unit. Hence let's drop them from the documentation.
* systemctl: when removing enablement or mask symlinks, cover both /run and /etcZbigniew Jędrzejewski-Szmek2018-06-011-11/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 'systemctl disable --runtime' would disable a unit, but only if it was enabled with '--runtime', and silently do nothing if the unit was enabled persistently. And similarly 'systemctl disable' would do nothing if the unit was enabled in /run. This just doesn't seem useful. This pathch changes enable/disable and mask/unmask to be asymmetrical. enable and mask create symlinks in /etc or /run, depending on whether --runtime was specified. disable and unmask remove symlinks from both locations. --runtime cannot be specified for the disable and unmask verbs. The advantage is that 'disable' now means that the unit is disabled, period. And similarly for 'unmask', all masks are removed. Similarly for preset and preset-all, they now cannot be called with --runtime, and are asymmetrical: when they enable a unit, symlinks are created in /etc. When they disable a unit, all symlinks are nuked. $ systemctl --root=/ enable bluetooth Created symlink /etc/systemd/system/dbus-org.bluez.service → /usr/lib/systemd/system/bluetooth.service. Created symlink /etc/systemd/system/bluetooth.target.wants/bluetooth.service → /usr/lib/systemd/system/bluetooth.service. $ systemctl --root=/ --runtime enable bluetooth Created symlink /run/systemd/system/dbus-org.bluez.service → /usr/lib/systemd/system/bluetooth.service. Created symlink /run/systemd/system/bluetooth.target.wants/bluetooth.service → /usr/lib/systemd/system/bluetooth.service. $ systemctl --root=/ disable bluetooth Removed /run/systemd/system/bluetooth.target.wants/bluetooth.service. Removed /run/systemd/system/dbus-org.bluez.service. Removed /etc/systemd/system/bluetooth.target.wants/bluetooth.service. Removed /etc/systemd/system/dbus-org.bluez.service. $ systemctl --root=/ disable --runtime bluetooth --runtime cannot be used with disable $ systemctl --root=/ mask --runtime bluetooth Created symlink /run/systemd/system/bluetooth.service → /dev/null. $ systemctl --root=/ mask bluetooth Created symlink /etc/systemd/system/bluetooth.service → /dev/null. $ systemctl --root=/ unmask bluetooth Removed /run/systemd/system/bluetooth.service. Removed /etc/systemd/system/bluetooth.service. $ systemctl --root=/ unmask --runtime bluetooth --runtime cannot be used with unmask $ systemctl --root=/ --runtime enable bluetooth Created symlink /run/systemd/system/dbus-org.bluez.service → /usr/lib/systemd/system/bluetooth.service. Created symlink /run/systemd/system/bluetooth.target.wants/bluetooth.service → /usr/lib/systemd/system/bluetooth.service. $ systemctl --root=/ enable bluetooth Created symlink /etc/systemd/system/dbus-org.bluez.service → /usr/lib/systemd/system/bluetooth.service. Created symlink /etc/systemd/system/bluetooth.target.wants/bluetooth.service → /usr/lib/systemd/system/bluetooth.service. $ systemctl --root=/ preset bluetooth Removed /run/systemd/system/bluetooth.target.wants/bluetooth.service. Removed /run/systemd/system/dbus-org.bluez.service. Removed /etc/systemd/system/bluetooth.target.wants/bluetooth.service. Removed /etc/systemd/system/dbus-org.bluez.service. $ systemctl --root=/ preset --runtime bluetooth --runtime cannot be used with preset $ systemctl preset-all --runtime --runtime cannot be used with preset-all
* man: Fix a minor typo in systemctl(1)Philip Withnall2018-05-111-1/+1
| | | | Signed-off-by: Philip Withnall <withnall@endlessm.com>
* 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: use unicode ellipsis in one more place (#8496)Zbigniew Jędrzejewski-Szmek2018-03-201-1/+1
| | | | | Also add note where it should *not* be used. https://github.com/systemd/systemd/pull/8408#discussion_r175606771
* man: beef up description of systemctl list-unitsZbigniew Jędrzejewski-Szmek2018-03-091-0/+36
| | | | Fixes https://bugs.freedesktop.org/show_bug.cgi?id=88135.
* man: document that link-ed files must be on /Zbigniew Jędrzejewski-Szmek2018-03-011-2/+8
| | | | Fixes #8307.
* systemctl,man: use PROPERTY as the placeholder for a property nameZbigniew Jędrzejewski-Szmek2018-02-221-5/+5
|
* systemctl,man: use UNIT as the placeholder for a unit nameZbigniew Jędrzejewski-Szmek2018-02-221-19/+19
| | | | | | | | NAME is kind of meaningless, because everything has a name. "Unit" makes it more obvious that a name of a unit is necessary. I was always momentarily baffled by "set-property NAME ASSIGNMENT...", where there are two objects (the unit and the property), and it's not clear which of the two "NAME" is supposed to signify.
* Revert "man: mention that systemctl is-active or is-failed do not load units"Lennart Poettering2018-01-251-11/+0
| | | | This reverts commit c7612b20052d9151f60a96623b8743cbac88390d.
* man: mention that systemctl is-active or is-failed do not load unitsYu Watanabe2018-01-161-0/+11
| | | | See the discussion in the issue #7875.
* 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.
* Merge pull request #7154 from keszybz/bootspecLennart Poettering2017-11-201-0/+13
|\ | | | | List bootspec entries in bootctl and use the default for kexec
| * systemctl: add --dry-run argumentZbigniew Jędrzejewski-Szmek2017-11-071-0/+13
| |
* | Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
| |
* | man: write "stop and start" instead of "restart" when explaining the reload ↵Lennart Poettering2017-11-171-14/+9
| | | | | | | | | | | | | | | | | | | | | | fallback operations We already made a similar change when talking about the "restart" command, let's also do this for "systemctl reload" and friends. Follow-up for: 6539dd7c42946d9ba5dc43028b8b5785eb2db3c5 See: #7126
* | man: document the interaction of "systemctl restart" and the FD storeLennart Poettering2017-11-171-3/+11
|/ | | | See: #7126
* man: fix typos (#7029)Jakub Wilk2017-10-101-1/+1
|
* man: document which special "systemctl" commands are synchronous and which ↵Lennart Poettering2017-10-041-72/+74
| | | | | | | | | | asynchronous. This documents the status quo, clarifying when we are synchronous and when asynchronous by default and when --no-block is support to force asynchronous operation. See: #6479
* install: consider non-Alias=/non-DefaultInstance= symlinks as "indirect" ↵Zbigniew Jędrzejewski-Szmek2017-09-221-1/+1
| | | | | | | | | | | | | | | | | enablement I think this matches the spirit of "indirect" well: the unit *might* be active, even though it is not "installed" in the sense of symlinks created based on the [Install] section. The changes to test-install-root touch the same lines as in the previous commit; the change in each case is from assert_se(unit_file_get_state(...) >= 0 && state == UNIT_FILE_ENABLED) to assert_se(unit_file_get_state(...) >= 0 && state == UNIT_FILE_DISABLED) to assert_se(unit_file_get_state(...) >= 0 && state == UNIT_FILE_INDIRECT) in the last two commits.
* install: only consider names in Alias= as "enabling"Zbigniew Jędrzejewski-Szmek2017-09-221-1/+1
| | | | | | | | | | | | | | | | | | | | | When a unit has a symlink that makes an alias in the filesystem, but that name is not specified in [Install], it is confusing is the unit is shown as "enabled". Look only for names specified in Alias=. Fixes #6338. v2: - Fix indentation. - Fix checking for normal enablement, when the symlink name is the same as the unit name. This case wasn't handled properly in v1. v3: - Rework the patch to also handle templates properly: A template templ@.service with DefaultInstance=foo will be considered enabled only when templ@foo.service symlink is found. Symlinks with other instance names do not count, which matches the logic for aliases to normal units. Tests are updated.
* manager: fix job mode when signalled to shutdown etcAlan Jenkins2017-08-311-1/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The irreversible job mode is required to ensure that shutdown is not interrupted by the activation of a unit with a conflict. We already used the correct job mode for `ctrl-alt-del.target`. But not for `exit.target` (SIGINT of user manager). The SIGRT shutdown signals also needed fixing. Also change SIGRTMIN+0 to isolate default.target, instead of starting it. The previous behaviour was documented. However there was no reason given for it, nor can we provide one. The problem that isolate is too aggressive anywhere outside of emergency.target (#2607) is orthogonal. This feature is "accessible by different means and only really a safety net"; it is confusing for it to differ from `systemctl default` without explanation. `AllowIsolate=yes` is retained on poweroff.target etc. for backwards compatibility. `sigpwr.target` is also an obvious candidate for linking to a shutdown target. Unforunately it is also a possible hook for implementing some logic like system V init did, reading `/etc/powerstatus`. If we switched to starting `sigpwr.target` with REPLACE_IRREVERSIBLY, attempts to run `systemctl shutdown` from it would fail, if they had not thought to set `DefaultDependencies=no`. We had provided no examples for `sigpwr`, and the whole idea is cruft to keep legacy people happy. For the moment, I leave `sigpwr` alone, with no risk of disrupting anyone's previously-working, half-working, or untested setup. Fixes #6484. See also #6471
* man: fix note for `systemctl enable --global` (#6592)Alan Jenkins2017-08-301-2/+2
| | | The last sentence in the paragraph described the behaviour of `--global`. But "the last case" we listed was "only this boot", which does not match... This was the fifth case described, but there are only _four_ different option names. Fix it.
* man: fix typos (#6532)Jakub Wilk2017-08-031-1/+1
|
* man: describe which units types are stopped on isolateZbigniew Jędrzejewski-Szmek2017-07-281-3/+5
| | | | Fixes #6455.
* Use "dollar-single-quotes" to escape shell-sensitive stringsZbigniew Jędrzejewski-Szmek2017-06-201-5/+20
| | | | | | | | | | | | | | | | | | | | | | | | | Also called "ANSI-C Quoting" in info:(bash) ANSI-C Quoting. The escaping rules are a POSIX proposal, and are described in http://austingroupbugs.net/view.php?id=249. There's a lot of back-and-forth on the details of escaping of control characters, but we'll be only using a small subset of the syntax that is common to all proposals and is widely supported. Unfortunately dash and fish and maybe some other shells do not support it (see the man page patch for a list). This allows environment variables to be safely exported using show-environment and imported into the shell. Shells which do not support this syntax will have to do something like export $(systemctl show-environment|grep -v '=\$') or whatever is appropriate in their case. I think csh and fish do not support the A=B syntax anyway, so the change is moot for them. Fixes #5536. v2: - also escape newlines (which currently disallowed in shell values, so this doesn't really matter), and tabs (as $'\t'), and ! (as $'!'). This way quoted output can be included directly in both interactive and noninteractive bash.
* man: change /lib to /usr/lib (#5618)Lucas Werkmeister2017-03-211-1/+1
| | | | | | | | Per man:file-hierarchy(7), /lib is just a compatibility symlink; the other manpages also refer to /usr/lib. Found with: git grep -P '(?<!/usr|/var|local)/lib' man/
* man: fix typo (#5468)AsciiWolf2017-02-271-1/+1
|
* man: systemctl list-timers: Provide sample output and document it. (#5463)Mark Stosberg2017-02-271-0/+15
| | | | As with `systemctl list-sockets` and `systemctl status`, we provide a sample output for `systemctl list-timers` and document what the columns mean.
* man: use https:// in URLsAsciiWolf2017-02-211-1/+1
|
* systemctl: restore --failed (#5198)Zbigniew Jędrzejewski-Szmek2017-02-021-4/+8
| | | | | | | | | 'systemctl --failed' is an extremely common operation and it's nice to have a shortcut for it. Revert "man: don't document systemctl --failed" and add the option back to systemctl's help and shell completion scripts. This reverts commit 036359ba8d0aba7db7eac75d10073a849a033fd1.
* man: fix typo (#5093)AsciiWolf2017-01-171-2/+2
|
* man: provide a basic guide to the `systemctl status` output (#4950)Mark Stosberg2017-01-141-0/+50
| | | | | | | | | | | - Show example of all `systemctl status` output and documents what possible "Loaded:", "Active" and "Enabled" values mean. - Documents what different colors of the dot mean. - Documents "gotcha" with load-on-demand behavior which will report units as "loaded" even if they are only loaded to show their status. (From @poettering: https://github.com/systemd/systemd/issues/5063#issuecomment-272115024 )
* Document how restart actions work (#5052)micah2017-01-111-6/+6
| | | When a user is trying to understand what is going on with a restart action, it is useful to explicitly describe how the action is run. It may seem obvious, but it is helpful to be explicit so one knows there isn't a special ExecRestart= or similar option that they could be looking at.
* man: document that "systemctl show" shows low-level propertiesLennart Poettering2016-12-141-11/+15
| | | | Fixes: #4654
* man: use unicode ellipsis in more placesZbigniew Jędrzejewski-Szmek2016-12-111-41/+41
| | | | | | | | | | | | | | As requested in https://github.com/systemd/systemd/pull/4864#pullrequestreview-12372557. docbook will substitute triple dots for the ellipsis in man output, so this has no effect on the troff output, only on HTML, making it infinitesimally nicer. In some places we show output from programs, which use dots, and those places should not be changed. In some tables, the alignment would change if dots were changed to the ellipsis which is only one character. Since docbook replaces the ellipsis automatically, we should leave those be. This patch changes all other places.
* systemctl: show waiting jobs when "systemctl list-jobs --after/--before" is ↵Lennart Poettering2016-11-161-0/+12
| | | | | | | called Let's expose the new bus functions we added in the previous commit in systemctl.
* man: fix two typos (is → are) (#4544)Lucas Werkmeister2016-11-031-2/+2
|
* man: fix typos (#4527)Jakub Wilk2016-10-311-1/+1
|
* man: document that systemctl cat shows file content (#4488)Lucas Werkmeister2016-10-261-1/+5
| | | ... and that that content might be outdated.
* shared, systemctl: teach is-enabled to show installation targetsJan Synacek2016-10-241-0/+3
| | | | | | | | | | | | | It may be desired by users to know what targets a particular service is installed into. Improve user friendliness by teaching the is-enabled command to show such information when used with --full. This patch makes use of the newly added UnitFileFlags and adds UNIT_FILE_DRY_RUN flag into it. Since the API had already been modified, it's now easy to add the new dry-run feature for other commands as well. As a next step, --dry-run could be added to systemctl, which in turn might pave the way for a long requested dry-run feature when running systemctl start.
* man: mention that systemctl --root=/ operates on the fs directlyZbigniew Jędrzejewski-Szmek2016-10-171-2/+4
|
* man: typo fixesThomas Hindoe Paaboel Andersen2016-10-121-2/+2
| | | | A mix of fixes for typos and UK english
* man: avoid using the term "loaded" for units currently in memory, since we ↵Lennart Poettering2016-10-111-19/+15
| | | | | | also have a unit state of that name Fixes: #3971
* man: expand the documentation of $SYSTEMD_PAGER and related environment ↵Lennart Poettering2016-10-111-0/+1
| | | | | | | | variables Document the default pagers used, as well as $SYSTEMD_LESSCHARSET. Fixes: #4143
* systemctl: Add --wait option to wait until started units terminate againMartin Pitt2016-10-011-1/+14
| | | | Fixes #3830
* man: remove duplicate "the" for systemctl --plain (#4230)Alfie John2016-09-281-1/+1
|
* Update systemctl.xml (#4151)kristbaum2016-09-151-2/+2
|
generated by cgit v1.2.3 (git 2.39.1) at 2024-12-02 02:06:11 +0100