summaryrefslogtreecommitdiff
path: root/man
Commit message (Collapse)AuthorAgeFilesLines
...
| * man/systemd.service: add example for char prefixesZbigniew Jędrzejewski-Szmek2023-04-041-1/+12
| | | | | | | | | | The prefixes can be specified for any part of the command. The docs imply this, but it's not entirely obvious. Let's add an example.
| * man: move description of command line substitution out of ExecStart=Zbigniew Jędrzejewski-Szmek2023-04-041-76/+69
| | | | | | | | | | | | | | | | The description was split — part was under ExecStart= and part in "Command lines". Now the whole generic part is moved to the separate section, and under ExecStart= only the stuff that is specific to that option is described. This just moves the text and removes some repetitions.
* | man: mention -o option for systemd-journal-remoteYu Watanabe2023-04-041-0/+2
| |
* | man/systemd-sysext: minor grammar optimizationsZbigniew Jędrzejewski-Szmek2023-04-031-2/+2
|/
* Merge pull request #27044 from bluca/sysext_recursive_dirLennart Poettering2023-04-031-3/+2
|\ | | | | Ensure sysexts do not contain an os-release file, do not load sysexts from /usr[/local]/lib/extensions/
| * sysext: stop storing under /usr/lib[/local]/extensions/Luca Boccassi2023-03-301-3/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | sysexts are meant to extend /usr. All extension images and directories are opened and merged in a single, read-only overlayfs layer, mounted on /usr. So far, we had fallback storage directories in /usr/lib/extensions and /usr/local/lib/extensions. This is problematic for three reasons. Firstly, technically, for directory-based extensions the kernel will reject creating such an overlay, as there is a recursion problem. It actively validates that a lowerdir is not a child of another lowerdir, and fails with -ELOOP if it is. So having a sysext /usr/lib/extensions/myextdir/ would result in an overlayfs config lowerdir=/usr/lib/extensions/myextdir/usr/:/usr which is not allowed, as indicated by Christian the kernel performs this check: /* * Check if this layer root is a descendant of: * - another layer of this overlayfs instance * - upper/work dir of any overlayfs instance */ <...> /* Walk back ancestors to root (inclusive) looking for traps */ while (!err && parent != next) { if (is_lower && ovl_lookup_trap_inode(sb, parent)) { err = -ELOOP; pr_err("overlapping %s path\n", name); Secondly, there's a confusing aspect to this recursive storage. If you have /usr/lib/extensions/myext.raw which contains /usr/lib/extensions/mynested.raw 'systemd-sysext merge' will only pick up the first one, but both will appear in the merged root under /usr/lib/extensions/. So you have two extension images, both appear in your merged filesystem, but only one is actually in use. Finally, there's a conceptual aspect: the idea behind sysexts and hermetic /usr is that the /usr tree is not modified locally, but owned by the vendor. Dropping extensions in /usr thus goes contrary to this foundational concept.
* | Merge pull request #27086 from keszybz/oomd-on-v1Mike Yuan2023-04-021-5/+14
|\ \ | | | | | | Do not pull in systemd-oomd on v1 to avoid repeated message in logs
| * | man: restore description of ConditionControlGroupController=v1|v2Zbigniew Jędrzejewski-Szmek2023-04-011-5/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | We use ConditionControlGroupController=v2 in systemd-oomd.service, and also this condition makes sense in general, so it should be documented. This reverts a part of 6d48c7cf736ced70c1c2fef1e1f03618911d04bc. Deprecated commandline options and v1 controller names were removed from the description.
* | | firstboot: Add --reset optionDaan De Meyer2023-04-011-0/+10
|/ / | | | | | | | | | | This can be used to prepare an image for firstboot by removing all files that systemd knows about that contain machine specific information.
* | core: always calculate the next restart intervalMike Yuan2023-03-311-3/+3
| | | | | | | | | | | | | | | | | | | | Follow-up for #26902 and #26971 Let's always calculate the next restart interval since that's more useful. For that, we add 1 to s->n_restarts unconditionally, and change RestartUSecCurrent property to RestartUSecNext.
* | man: add example for sd_bus_call_methodLuca Boccassi2023-03-302-0/+64
| |
* | man: further shorten print-unit-path exampleLuca Boccassi2023-03-301-24/+17
| |
* | man: link up new online coredump docs from man pageLennart Poettering2023-03-311-1/+5
|/
* tmpfiles: Try to take a BSD lock on files as wellDaan De Meyer2023-03-302-7/+9
| | | | | | Similar to what we do for directories, just before we remove a file, let's try to take a BSD lock on it. If that fails, skip removing the file.
* Merge pull request #27041 from poettering/fdstore-dumpDaan De Meyer2023-03-304-1/+92
|\ | | | | add ability to show contents of service fdstore + teach systemd-notify passing fds into the fdstore
| * notify: add support for sending fds with notification messagesLennart Poettering2023-03-291-0/+23
| | | | | | | | | | This exposes the fd passing we support via sd_pid_notify_with_fds() also via the command line tool systemd-notify.
| * analyze: add new fdstore verbLennart Poettering2023-03-292-1/+47
| |
| * pid1: add DumpFileDescriptorStore() bus call that returns fdstore content infoLennart Poettering2023-03-291-0/+22
| |
* | man: drop trailing space and mention uki_generator at one more placeYu Watanabe2023-03-301-3/+4
|/ | | | Follow-up for 600362aa11af5af90125aacc8ad7612a5cb80a68.
* man: fix shellcheck warning for html.inLuca Boccassi2023-03-291-1/+5
| | | | SC2015: Note that A && B || C is not if-then-else. C may run when A is true.
* man: correct/tweak text about unit name syntaxLennart Poettering2023-03-281-12/+12
| | | | | | | | Unit names can be 255 characters long, not 256. We first say "name prefix" and then continue with "unit prefix". Confusing. Couldn't figure out which term is better hence settled on "unit name prefix".
* os-release: add 'SYSEXT_' fields for version/idLuca Boccassi2023-03-281-0/+5
| | | | | | | | | | | | | sysext DDI cannot carry an os-release file, but have to carry an extension-release file. But so far, this was only used to match the sysext DDI with the base DDI/rootdir. It is also useful to describe the sysext DDI itself, just like we do in os-release. So document that the same fields used in os-release can also be added to an extension-release, with the 'SYSEXT_' prefix, and in that case they are understood to define the sysext DDI itself, rather than for matching purposes.
* core/dbus-service: add RestartUSecCurrent propertyMike Yuan2023-03-271-0/+6
| | | | | This new property shows how much time we actually waits before restarting.
* core: add RestartSteps= and RestartSecMax= for exponentially increasingMike Yuan2023-03-272-0/+31
| | | | | | | | | | interval between restarts RestartSteps= accepts a positive integer as the number of steps to take to increase the interval between auto-restarts from RestartSec= to RestartSecMax=, or 0 to disable it. Closes #6129
* Define $KERNEL_INSTALL_UKI_GENERATORGertalitec2023-03-261-3/+3
| | | | Define $KERNEL_INSTALL_UKI_GENERATOR in case one wants it to be different from $KERNEL_INSTALL_INITRD_GENERATOR. This can be useful if one wants to use mkinitcpio / Dracut to generate the initrd, but without creating the UKI so this can be left for e.g. ukify or something else. Right now these initrd generators will read /etc/kernel/install.conf and generate the UKI
* Merge pull request #26973 from mrc0mmand/userdbctl-testsYu Watanabe2023-03-261-1/+1
|\ | | | | test: add a couple of tests for userdbctl
| * man: s/io.systemd.Dropin/io.systemd.DropIn/Frantisek Sumsal2023-03-241-1/+1
| |
* | Merge pull request #26960 from poettering/syscall-catchupYu Watanabe2023-03-251-0/+8
|\ \ | | | | | | syscall filter group updates
| * | man: update syscal filter group listLennart Poettering2023-03-241-0/+8
| |/
* | Merge pull request #26920 from medhefgo/ukifyZbigniew Jędrzejewski-Szmek2023-03-241-1/+0
|\ \ | | | | | | ukify: Use pefile to add sections to EFI stub
| * | ukify: Use pefile to add sections to EFI stubJan Janssen2023-03-241-1/+0
| |/
* | Merge pull request #26785 from keszybz/udev-distcheckZbigniew Jędrzejewski-Szmek2023-03-241-0/+1
|\ \ | |/ |/| Implement --help/--version in all udev builtins
| * udev: implement --version in all builtinsZbigniew Jędrzejewski-Szmek2023-03-161-0/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Those are separate binaries, and occasionally people will get a misplaced binary that doesn't match the rest of the installed system and be confused, so it good to be able to check the version. It is also nice to have the same interface in all binaries. Note that we usually use a separate 'enum ARG_VERSION = 0x100' for an option without a short name. We can use a less verbose approach of simply taking any unused letter, which works just as well and even the compiler would warn us if we tried to use the letter in another place. This way we avoid a few lines of boilerplate. The help texts are adjusted to have an empty line between the synopsis and option list, and no empty lines after the option list.
* | Merge pull request #26214 from YHNdnzj/sd-notify-change-notifyaccessMike Yuan2023-03-242-1/+10
|\ \ | | | | | | core: support overriding NOTIFYACCESS= through sd-notify during runtime
| * | core: support overriding NOTIFYACCESS= through sd-notify during runtimeMike Yuan2023-03-222-1/+10
| | | | | | | | | | | | Closes #25963
* | | execute: Add kernel cmdline arguments for tty term, rows and columnsDaan De Meyer2023-03-211-0/+12
|/ / | | | | | | | | | | Let's allow configuring tty term and size using kernel cmdline arguments so that when running in a VM we can communicate the terminal TERM and size from the host via SMBIOS extra kernel cmdline arguments.
* | man/network-generator: replace dracut.kernel reference with dracut.cmdlineAntonio Alvarez Feijoo2023-03-211-1/+1
| | | | | | | | | | | | `dracut.kernel.7` is just a symlink to `dracut.cmdline.7`, so the web reference points to a non-existent URL (https://man7.org/linux/man-pages/man7/dracut.kernel.7.html).
* | man: explicitly list three command syntax at the beginningYu Watanabe2023-03-181-1/+12
| |
* | sleep: fix default values unmatched with manualMike Yuan2023-03-181-1/+1
| |
* | man: fix misspelled executable name (#26858)Addison Snelling2023-03-171-2/+2
| |
* | machinectl: add verb edit and cat to operate on .nspawn filesMike Yuan2023-03-151-0/+15
| | | | | | | | | | | | This allows operating on .nspawn files using machinectl. Closes #26246
* | Merge pull request #26794 from bluca/log_extra_fieldsLennart Poettering2023-03-151-2/+2
|\ \ | | | | | | core: append LogExtraFields= values to log_unit* messages
| * | core: append LogExtraFields= values to log_unit* messagesLuca Boccassi2023-03-141-2/+2
| | | | | | | | | | | | | | | | | | | | | This ensure messages from PID1 regarding a unit also contain those fields. For example, portable services have PORTABLE=<image> as extra fields, which is useful to identify which version of a portable image produced a log message like an error or an oomd kill.
* | | Merge pull request #26815 from keszybz/cgls-no-xattrs-by-defaultLuca Boccassi2023-03-151-2/+5
|\ \ \ | | | | | | | | Do not show xattrs and cgroup ids in cgls by default
| * | | cgls: add -x and -c optionsZbigniew Jędrzejewski-Szmek2023-03-141-2/+5
| | | | | | | | | | | | | | | | | | | | -x is short for --xattrs=yes and -c is short for --cgroup-id=yes.
| * | | cgls: stop showing cgroup ids and xattrs by defaultZbigniew Jędrzejewski-Szmek2023-03-141-2/+2
| |/ / | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Those are rather specialized bits of information, useful mostly for debugging. I use cgls quite often but never had the need to use either of those… But they take up a significant amount of screen real estate, esp. when executed as root: -.slice ├─user.slice (#1683) │ → user.invocation_id: 74b0bd1258c5485eb969016384e0d06a │ → trusted.invocation_id: 74b0bd1258c5485eb969016384e0d06a │ └─user-1000.slice (#6488) │ → user.invocation_id: b0261a14fe74490d9a9d5266c52cceb6 │ → trusted.invocation_id: b0261a14fe74490d9a9d5266c52cceb6 │ ├─user@1000.service … (#6590) │ │ → user.invocation_id: 9e1fb54ad07940d8b92c33c81d169f11 │ │ → user.delegate: 1 │ │ → trusted.invocation_id: 9e1fb54ad07940d8b92c33c81d169f11 │ │ → trusted.delegate: 1 │ │ ├─session.slice (#6874) ... Let's not show them by default, so we can show more cgroups. (Also, on a terminal, we already highlight delegate units via underlining and an ellipsis, so 'user.delegate:1' is redundant.)
* | | Merge pull request #26808 from keszybz/no-controllers-followupLuca Boccassi2023-03-151-15/+17
|\ \ \ | | | | | | | | Docs and dump output follow-up for the case of delegation with no controllers
| * | | man: document "Delegate=" a bit moreZbigniew Jędrzejewski-Szmek2023-03-141-15/+17
| |/ / | | | | | | | | | | | | | | | | | | This case is a bit surprising, even if logical if one understands how the parser works. Let's be more explicit. Follow-up for 7b3693e4e4c9cae50fca65136278a62fae11327e.
* | | systemctl: add option --when for scheduled shutdownMike Yuan2023-03-141-18/+23
|/ / | | | | | | | | | | | | Pass an empty string or "cancel" will cancel the action. Pass "show" will show the scheduled actions. Replaces #17258
* | man: add missing tags in udevadm(8)Yu Watanabe2023-03-131-0/+3
| |
View Lorry Controller Status