summaryrefslogtreecommitdiffstats
path: root/man/systemd.xml (follow)
Commit message (Collapse)AuthorAgeFilesLines
* man: asorted fixesYu Watanabe2024-11-231-5/+5
| | | | Closes #35307.
* man: link up D-Bus API docs from daemon man pagesLennart Poettering2024-11-051-0/+1
| | | | | | | | | | Let's systematically make sure that we link up the D-Bus interfaces from the daemon man pages once in prose and once in short form at the bottom ("See Also"), for all daemons. Also, add reverse links at the bottom of the D-Bus API docs. Fixes: #34996
* man: consolidate list of active unit states into a shared tableLuca Boccassi2024-10-041-10/+5
| | | | | | Avoids the need to maintain the same list over and over again, and link it to the defition table in the implementation as a reminder too
* man: document ShowStatus and SetShowStatus()Jason Yundt2024-09-181-2/+10
| | | | | | | | | | | SetShowStatus() was added in order to fix #11447. Recently, I ran into the exact same problem that OP was experiencing in #11447. I wasn’t able to figure out how to deal with the problem until I found #11447, and it took me a while to find #11447. This commit takes what I learned from reading #11447 and adds it to the documentation. Hopefully, this will make it easier for other people who run into the same problem in the future.
* core: do BindMount/MountImage operations in async control processLuca Boccassi2024-08-291-20/+14
| | | | | | | | | | | | | | | | | | These operations might require slow I/O, and thus might block PID1's main loop for an undeterminated amount of time. Instead of performing them inline, fork a worker process and stash away the D-Bus message, and reply once we get a SIGCHILD indicating they have completed. That way we don't break compatibility and callers can continue to rely on the fact that when they get the method reply the operation either succeeded or failed. To keep backward compatibility, unlike reload control processes, these are ran inside init.scope and not the target cgroup. Unlike ExecReload, this is under our control and is not defined by the unit. This is necessary because previously the operation also wasn't ran from the target cgroup, so suddenly forking a copy-on-write copy of pid1 into the target cgroup will make memory usage spike, and if there is a MemoryMax= or MemoryHigh= set and the cgroup is already close to the limit, it will cause an OOM kill, where previously it would have worked fine.
* crash-handler: Drop 10s sleep before we spawn the crash shellDaan De Meyer2024-08-071-3/+2
| | | | | It pointlessly delays getting to the crash shell so let's drop the 10s sleep.
* man: describe setting of the clock by systemd and systemd-timesyncdZbigniew Jędrzejewski-Szmek2024-06-151-1/+43
| | | | | | | | | | | | | | | | | | | The setting of systemd clock is important and deserves an accurate description, see for example: https://discussion.fedoraproject.org/t/f38-to-f39-40-dnf-system-upgrade-can-fail-on-raspberry-pi/92403 https://bugzilla.redhat.com/show_bug.cgi?id=2242759 The meat of the description was in systemd-timesyncd.service(8), but actually it's systemd that sets the clock. In particular, systemd-timesyncd doesn't know anything about /usr/lib/clock-epoch, and since systemd sets the clock to the epoch when initializing, systemd-timesyncd would only get to advance the clock to the epoch under special circumstances. Also, systemd-timesyncd is an optional component, so we can't even rely on its man page being installed in all circumstances. The description needs to be moved to systemd(1). The description is updated to describe the changes that were made in previous commits.
* man/systemd: reorder content a bitZbigniew Jędrzejewski-Szmek2024-06-051-25/+24
| | | | | | | | | | | | | | Section "Description" didn't actually say what systemd does. And we had a giant "Concepts" section that actually described units types and other details about them. So let's move the basic description of functionality to "Description" and rename the following section to "Units". The link to the Original Design Document is moved to "See Also", it is of historical interest mostly at this point. The only actual change is that when talking about API filesystems, /dev is also mentioned. (I think /sys+/proc+/dev are the canonical set and should be always listed on one breath.)
* core: Add systemd.crash_action= kernel command line argumentDaan De Meyer2024-04-291-12/+15
| | | | | | Required for integration tests to power off on PID 1 crashes. We deprecate systemd.crash_reboot and related options by removing them from the documentation but still parsing them.
* shutdown: send an sd_notify() message on shutdown with the shutdown reason ↵Lennart Poettering2024-04-231-0/+13
| | | | | | | and boot param This is kinda nice in containers, to exfiltrate a string from the container on shutdown.
* man: fix incorrect XML in man pageSam Leonard2024-04-151-1/+1
|
* Document new vsock literalsDaan De Meyer2024-03-191-1/+3
| | | | Fixes #31849
* docs: document new sd_notify() extensionsLennart Poettering2024-03-141-11/+93
|
* man: use same version in public and system ident.David Tardon2023-12-251-1/+1
|
* man: use <simplelist> for 'See also' sectionsDavid Tardon2023-12-231-17/+17
| | | | | This is just a slight markup improvement; there should be no difference in rendering.
* man: update version informationAbderrahim Kitouni2023-09-191-10/+26
| | | | | | | | As I noticed a lot of missing information when trying to implement checking for missing info. I reimplemented the version information script to be more robust, and here is the result. Follow up to ec07c3c80b2b1bfa6788500202006ff85f5ae4f4
* man: add version infoAbderrahim Kitouni2023-08-291-27/+89
| | | | | | | | This tries to add information about when each option was added. It goes back to version 183. The version info is included from a separate file to allow generating it, which would allow more control on the formatting of the final output.
* man/systemd: avoid duplicate variable nameMike Yuan2023-08-051-1/+1
|
* Deprecate efivar SystemdOptionsZbigniew Jędrzejewski-Szmek2023-07-181-2/+5
| | | | | | | | As mentioned in the NEWS entry, it seems to see very little use, but adds complexity in our code. It was added mainly with the goal of making it easier for people using grub2 to modify their boot configuration, but grub2 is gaining support for BLS snippets. On the systemd side, we now have credentials. So let's deprecate this, and if there's no outcry, remove it in a few releases.
* import-creds: add support for binary credentials specified on the kernel cmdlineLennart Poettering2023-07-041-2/+5
|
* man: document where PID 1 imports credentials fromLennart Poettering2023-07-041-1/+34
|
* core: consult credentials for machine ID to use for hostLennart Poettering2023-07-041-0/+10
| | | | | | | | Let's hook up one more thing with credentials: the machine ID to use when none is initialized yet. This requires some reordering of initialization steps in PID 1: we need to import credentials first, and only then initialize the machine ID.
* man: make sure credentials properly show up in directives indexLennart Poettering2023-07-041-1/+1
|
* man: document vmm.notify_socket credential in systemd(1) man pageLennart Poettering2023-06-291-0/+24
| | | | | | Let's move the long explanation to the man page of the component that interprets the credential, and keep only a brief summary in systemd.system-credentials(7).
* tree-wide: use https for the 0pointer.de doc linksFrantisek Sumsal2023-06-231-1/+1
|
* creds: Add ImportCredential=Daan De Meyer2023-06-081-1/+1
| | | | | | ImportCredential= takes a credential name and searches for a matching credential in all the credential stores we know about it. It supports globs which are expanded so that all matching credentials are loaded.
* man: document the soft reboot operationLennart Poettering2023-06-021-0/+15
|
* log: Add knob to disable kmsg ratelimitingDaan De Meyer2023-04-201-3/+11
| | | | | This allows us to disable kmsg ratelimiting in the integration tests and mkosi for easier debugging.
* 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
|
generated by cgit v1.2.3 (git 2.39.1) at 2025-01-30 09:52:56 +0100