summaryrefslogtreecommitdiffstats
path: root/man/systemd.xml (follow)
Commit message (Collapse)AuthorAgeFilesLines
* man: add cross-links about preset operationsZbigniew Jędrzejewski-Szmek2022-10-011-2/+7
|
* tree-wide: also settle on "initrd" instead of "initial RAM disk"Lennart Poettering2022-09-231-9/+5
| | | | | With this the concept is now called the same way everywhere except where historical info is relevant or where the other names are API.
* man: add "History" sections for removed settingsZbigniew Jędrzejewski-Szmek2022-08-231-0/+13
| | | | | | | | | The general idea is that users should be able to figure out if some option that they see in a config file or on some internet page is something that systemd knows about. Once users know that, yes, this was an option but has been deprecated and removed from the documentation, it's much easier for them to find any docs in old versions if they want to. Or to switch to something different.
* docs: remove documentation about cgroupsv1 settingsLennart Poettering2022-08-231-50/+11
| | | | | it's legacy. We'll continue to support it in code, but let's simplify the docs a bit, and not mention this legacy stuff anymore.
* pid1: import creds from SMBIOS too, not just qemu's fw_cfgLennart Poettering2022-07-151-1/+2
| | | | | | | | | | | | | | | | | | | | | | | | | This imports credentials also via SMBIOS' "OEM vendor string" section, similar to the existing import logic from fw_cfg. Functionality-wise this is very similar to the existing fw_cfg logic, both of which are easily settable on the qemu command line. Pros and cons of each: SMBIOS OEM vendor strings: - pro: fast, because memory mapped - pro: somewhat VMM independent, at least in theory - pro: qemu upstream sees this as the future - pro: no additional kernel module needed - con: strings only, thus binary data is base64 encoded fw_cfg: - pro: has been supported for longer in qemu - pro: supports binary data - con: slow, because IO port based - con: only qemu - con: requires qemu_fw_cfg.ko kernel module - con: qemu upstream sees this as legacy
* tree-wide: link to docs.kernel.org for kernel documentationnl67202022-07-041-3/+3
| | | | | | | https://www.kernel.org/ links to https://docs.kernel.org/ for the documentation. See https://git.kernel.org/pub/scm/docs/kernel/website.git/commit/?id=ebc1c372850f249dd143c6d942e66c88ec610520 These URLs are shorter and nicer looking.
* tree-wide: use html links for kernel docsZbigniew Jędrzejewski-Szmek2022-07-021-1/+1
| | | | Instead of using "*.txt" as reference name, use the actual destination title.
* Use https for freedesktop.orgMichael Biebl2022-06-281-2/+2
| | | | grep -l -r http:// | xargs sed -E -i s'#http://(.*).freedesktop.org#https://\1.freedesktop.org#'
* tree-wide: Update homepage to systemd.ioBenjamin Franzke2022-05-211-1/+1
|
* man: fix typoZbigniew Jędrzejewski-Szmek2022-05-161-1/+1
|
* docs: Clarify where options are read fromDaan De Meyer2022-05-021-7/+8
| | | | | | Let's merge the footnote with the overall explanation of where systemd parses its options from and reword the section a bit to hopefully make things a bit more clear.
* doc: add new markdown docs for credentialsLennart Poettering2022-04-281-1/+4
|
* man: document the new credentials featuresLennart Poettering2022-04-281-0/+20
|
* manager: reexecute on SIGRTMIN+25, user instances onlyFranck Bui2021-07-281-0/+11
| | | | | | | | | | | | | | | | | | | | Before this patch, there was no way to request all running user instances for reexecuting. However this can be useful especially during package updates otherwise user instances are never updated and keep running a potentially very old version of the binaries. Now assuming that we have enough priviledge, it's possible to request reexecution of all user instances: systemctl kill --signal=SIGRTMIN+25 "user@*.service" Note that this request is obviously asynchronous as it relies on a signal. Keeping "systemctl kill" as the only interface should be good enough to make this obvious and that's the reason why another interface, such as "systemctl --global daemon-reexec" has not been considered. PID1 already uses SIGTERM for reexecuting hence sending it SIGRTMIN+25 is a nop.
* Fixed typo (#20187)nassir902021-07-091-2/+2
| | | | | | | | * Fixed typo Before, the file claimed that some systemd units are created "from other configuration". It should have read "from other configuration files". Co-authored-by: Nozz <nozolo90@gmail.com>
* core: add combined status unit formatPaweł Marciniak2021-06-281-3/+5
| | | | | [zjs: actual implementation is stripped out and will be added in subsequent commits.]
* man: update docs on systemd-system.conf logging (LogTime=) (#19846)alexlzhu2021-06-081-1/+1
| | | Updating documentation for systemd to reflect that logging is done in the console.
* man: move two sysv-specific variables to docsZbigniew Jędrzejewski-Szmek2021-03-011-7/+0
| | | | https://github.com/systemd/systemd/pull/18827#discussion_r584807684
* man: move description of $SYSTEMD_SYSVINIT_PATH to the only userZbigniew Jędrzejewski-Szmek2021-03-011-7/+0
|
* man: reuse common-variables in systemd(1)Zbigniew Jędrzejewski-Szmek2021-03-011-18/+22
| | | | | This requires a bit of gimnastics, but I think it's still better than status quo ante, and better than duplicating the text.
* man: rename less-variables→common-variablesZbigniew Jędrzejewski-Szmek2021-03-011-6/+6
| | | | Some are not about less, e.g. $SYSTEMD_URLIFY.
* man: add a description of how manager env block is setZbigniew Jędrzejewski-Szmek2021-02-231-4/+21
|
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* Merge pull request #17270 from keszybz/less-secure-modeLennart Poettering2020-10-141-0/+1
|\ | | | | Use less in "secure" mode when under sudo
| * pager: set $LESSSECURE whenver we invoke a pagerLennart Poettering2020-10-071-0/+1
| | | | | | | | | | | | | | | | | | Some extra safety when invoked via "sudo". With this we address a genuine design flaw of sudo, and we shouldn't need to deal with this. But it's still a good idea to disable this surface given how exotic it is. Prompted by #5666
* | man: use trailing slash on directories in more placesZbigniew Jędrzejewski-Szmek2020-10-051-1/+1
| |
* | man: correct various linksZbigniew Jędrzejewski-Szmek2020-09-301-3/+2
| | | | | | | | As usual, linkchecker ftw!
* | man: assorted small fixesZbigniew Jędrzejewski-Szmek2020-09-301-5/+5
| | | | | | | | This is almost all of #17177.
* | man: refer to the right man page for Environment=Zbigniew Jędrzejewski-Szmek2020-09-301-7/+7
| | | | | | | | For #17177.
* | Merge pull request #17199 from poettering/log-tidZbigniew Jędrzejewski-Szmek2020-09-301-23/+23
|\ \ | | | | | | include thread ID in log output
| * | log: optionally display thread ID in log output to ttyLennart Poettering2020-09-291-23/+23
| |/ | | | | | | | | This is very useful when playing around with threaded tests, but should be useful in other cases too.
* / docs: update old documentation linksnl67202020-09-291-4/+3
|/
* man: fix some manvolnumAnita Zhang2020-07-111-1/+1
|
* tree-wide: fixes for assorted grammar and spelling issuesZbigniew Jędrzejewski-Szmek2020-07-061-11/+10
| | | | Fixes #16363. Also includes some changes where I generalized the pattern.
* 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-04-301-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.