summaryrefslogtreecommitdiffstats
path: root/docs (follow)
Commit message (Collapse)AuthorAgeFilesLines
* docs/NETWORK_ONLINE: Use `until` instead of `while !`Gioele Barabucci2023-08-141-1/+1
| | | | | `until` is the standard POSIX shell builtin to be used when waiting for a condition to appear.
* docs/NETWORK_ONLINE: Move `Type=`, `RemainAfterExit=` to `[Service]`Gioele Barabucci2023-08-141-2/+2
| | | | | | `Type=` and `RemainAfterExit=` belong in `[Service]`, not `[Unit]`. Fixes #28826
* docs: update link to RHEL/CentOS Stream trackerJan Macku2023-08-111-1/+1
| | | | Also update link to systemd downstream GitHub repo.
* docs: fix typoYu Watanabe2023-08-011-1/+1
|
* docs: note that Github Pages configuration has to be updated after a releaseLuca Boccassi2023-07-291-0/+1
|
* Drop split-usr and unmerged-usr supportLuca Boccassi2023-07-281-1/+0
| | | | | | | | | | As previously announced, execute order 66: https://lists.freedesktop.org/archives/systemd-devel/2022-September/048352.html The meson options split-usr, rootlibdir and rootprefix become no-ops that print a warning if they are set to anything other than the default values. We can remove them in a future release.
* docs: fix orderDavid Tardon2023-07-131-2/+2
|
* docs: cleanups to ROOT_STORAGE_DAEMONSMicah Abbott2023-07-121-22/+20
| | | | | | There were a couple spelling/grammatical errors in the docs that made it hard to read and understand parts of this doc. I cleaned up those errors and reflowed the line breaks to keep to the 80 char limit.
* tree-wide: fix typos reported by Fossies Codespell reportYu Watanabe2023-07-121-1/+1
|
* treewide: fix "an" before consonant U soundsJoerg Behrmann2023-07-062-2/+2
| | | | | | The article "a" goes before consonant sounds and "an" goes before vowel sounds. This commit changes an to a for UKI, UDP, UTF-8, URL, UUID, U-Label, UI and USB, since they start with the sound /ˌjuː/.
* import-creds: add support for binary credentials specified on the kernel cmdlineLennart Poettering2023-07-041-4/+5
|
* doc: document inird credentials + and how to consume credentials in generatorsLennart Poettering2023-07-041-25/+73
| | | | (as well as various other fixes)
* tree-wide: "<n>bit" → "<n>-bit"Zbigniew Jędrzejewski-Szmek2023-07-0210-61/+61
| | | | In some places, "<n> bits" is used when more appropriate.
* mkosi: Enable Incremental= mode by defaultDaan De Meyer2023-06-291-6/+1
| | | | | | Since mkosi is now smart enough to drop the caches when the list of packages changes, let's enable Incremental= mode by default to ensure a good experience for anyone new to hacking on systemd with mkosi.
* journalctl: read env vars that override compiled catalog database and source ↵Lennart Poettering2023-06-271-1/+8
| | | | | | | files This makes it a bit easier to test catalog files without installing systemd.
* tree-wide: use https for the 0pointer.de doc linksFrantisek Sumsal2023-06-235-8/+8
|
* docs: document threading situation in coding styleLennart Poettering2023-06-231-0/+29
|
* docs: describe $TESTFUNCS brieflyLennart Poettering2023-06-221-0/+4
| | | | Follow-up for f1a83e41ae985bd17056b3a9fe285cc196358183
* docs/CREDENTIALS: fix confusion of i.e. and e.g.Zbigniew Jędrzejewski-Szmek2023-06-191-1/+1
|
* creds: Add ImportCredential=Daan De Meyer2023-06-082-14/+19
| | | | | | 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.
* sd-boot,sd-stub: also print version after the addressZbigniew Jędrzejewski-Szmek2023-05-231-18/+11
| | | | | | | | | | The kernel, systemd, and many other things print their version during boot. sd-boot and sd-stub are also important, so let's print the version if EFI_DEBUG. (If !EFI_DEBUG, continue to be quiet.) When updating the docs, I saw that that the text in HACKING.md was out of date. Instead of trying to update the instructions there, make it shorter and refer the reader to tools/debug-sd-boot.sh for details.
* shared/condition: add envvar override for the check for first-bootZbigniew Jędrzejewski-Szmek2023-05-231-0/+3
| | | | | | | Before 7cd43e34c5a302ff323c013f437092d2ff5ccbbf, it was possible to use SYSTEMD_PROC_CMDLINE=systemd.condition-first-boot to override autodetection. But now this doesn't work anymore, and it's useful to be able to do that for testing.
* docs: list all public headers in stability promiseZbigniew Jędrzejewski-Szmek2023-05-161-2/+9
| | | | | | | We provide the same stability for all the headers that are public. Also, mark id128 as portable to other systems. There is really nothing in the code that would make it hard. It would probably work out-of-the-box.
* mkosi: Package a erofs usr partition with signed verityDaan De Meyer2023-05-131-3/+5
| | | | | | | | | | | | | | Let's start moving towards a more involved partitioning setup to test our stuff more when using mkosi. The root partition is generated on boot with systemd-repart. CentOS supports neither erofs nor btrfs so we use squashfs and xfs instead. We also enable SecureBoot= locally for additional coverage. This and the use of verity means users need to run `mkosi genkey` once to generate the keys necessary to do secure boot and verity.
* docs: add correct `pacman` command (#27486)Klaus2023-05-021-1/+1
| | | | The `pacman` command in order to install packages on Arch in the documentation is invalid. This PR fixes the command.
* core: add DelegateSubgroup= settingLennart Poettering2023-04-271-1/+3
| | | | | | | | | | | | | | | This implements a minimal subset of #24961, but in a lot more restrictive way: we only allow one level of subcgroup (as that's enough to address the no-processes in inner cgroups rule), and does not change anything about threaded cgroup logic or similar, or make any of this new behaviour mandatory. All this does is this: all non-control processes we invoke for a unit we'll invoke in a subgroup by the specified name. We'll later port all our current services that use cgroup delegation over to this, i.e. user@.service, systemd-nspawn@.service and systemd-udevd.service.
* docs: fix LoadCredentialEncrypted example (#27387)Lawrence Thorpe2023-04-251-1/+1
| | | | Embedded credential name 'ciphertext.cred' does not match filename 'foobar', refusing.
* doc: say in CODING_STYLE that AT_EMPTY_PATH should be implied on openat() ↵Lennart Poettering2023-04-251-0/+9
| | | | | | | | style APIs (and NULL path is OK) As discussed here: https://github.com/systemd/systemd/pull/27397#issuecomment-1521630044
* a colloquial abbreviation 'btw' in TEMPORARY_DIRECTORIES.md (#27365)074162023-04-231-1/+1
| | | * Update TEMPORARY_DIRECTORIES.md
* tree-wide: code spelling fixesFrantisek Sumsal2023-04-202-4/+4
| | | | As reported by Fossies.
* docs: add a missing $ signFrantisek Sumsal2023-04-161-1/+1
| | | | | Addresses https://github.com/systemd/systemd/pull/27283#pullrequestreview-1386816102. Follow-up to 1a127aa02b.
* docs: a couple of typo fixes & formatting tweaksFrantisek Sumsal2023-04-151-3/+3
|
* os-util: make $SYSTEMD_OS_RELEASE prefixed with the root directoryYu Watanabe2023-04-111-2/+1
| | | | | | | | To make it consistent with other env vars, e.g. $SYSTEMD_ESP_PATH or $SYSTEMD_XBOOTLDR_PATH. This is useful when the root is specified by a file descriptor, instead of a path.
* Merge pull request #27126 from yuwata/journal-compressZbigniew Jędrzejewski-Szmek2023-04-071-0/+8
|\ | | | | sd-journal: allow to specify compression algorithm through env
| * sd-journal: allow to specify compression algorithm through envYu Watanabe2023-04-041-0/+8
| | | | | | | | | | | | | | | | | | | | | | Fixes RHBZ#2183546 (https://bugzilla.redhat.com/show_bug.cgi?id=2183546). Previously, journal file is always compressed with the default algorithm set at compile time. So, if a newer algorithm is used, journal files cannot be read by older version of journalctl that does not support the algorithm. Co-authored-by: Colin Walters <walters@verbum.org>
* | confext: documentation and man page updates for confextmaanyagoenka2023-04-051-1/+3
|/
* docs: fix coredump legacy exampleLudwig Nussel2023-03-311-1/+1
|
* docs: add a document with an overview over systemd's coredump handlingLennart Poettering2023-03-301-0/+147
|
* tmpfiles: Try to take a BSD lock on files as wellDaan De Meyer2023-03-301-11/+8
| | | | | | 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.
* mkosi: Update to latestDaan De Meyer2023-03-292-2/+2
| | | | | | | | | | | - Drop Netdev= as it was removed in mkosi - Always install python-psutil in the final image (required for networkd tests) - Always Install python-pytest in the final image (required for ukify tests) - Use the narrow glob for all centos python packages - Drop the networkd mkosi config files (the default image can be used instead) - Use ".conf" as the mkosi config file suffix everywhere - Copy src/ to /root/src in the final image and set gdb substitute path in .gdbinit to make gdb work properly
* portable: add PORTABLE_NAME_AND_VERSION= and other metadata to LogsExtraFields=Luca Boccassi2023-03-281-2/+20
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is useful to identify log messages with metadata from the images they run on. Look for ID/VERSION_ID/IMAGE_ID/IMAGE_VERSION/BUILD_ID, with a SYSEXT_ prefix if we are looking at an extension, and append via LogExtraFields= as respectively PORTABLE_NAME_AND_VERSION= in case of a single image. In case of extensions, append as PORTABLE_ROOT_NAME_AND_VERSION= for the base and one PORTABLE_EXTENSION_AND_VERSION= for each extension. Example with a base and two extensions, with the unit coming from the first extension: [Service] RootImage=/home/bluca/git/systemd/base.raw Environment=PORTABLE=app0.raw BindReadOnlyPaths=/etc/os-release:/run/host/os-release LogExtraFields=PORTABLE=app0.raw Environment=PORTABLE_ROOT=base.raw LogExtraFields=PORTABLE_ROOT=base.raw LogExtraFields=PORTABLE_ROOT_NAME_AND_VERSION=debian_10 ExtensionImages=/home/bluca/git/systemd/app0.raw LogExtraFields=PORTABLE_EXTENSION=app0.raw LogExtraFields=PORTABLE_EXTENSION_NAME_AND_VERSION=app_0 ExtensionImages=/home/bluca/git/systemd/app1.raw LogExtraFields=PORTABLE_EXTENSION=app1.raw LogExtraFields=PORTABLE_EXTENSION_NAME_AND_VERSION=app_1
* portable: include base and extension images in log fieldsLuca Boccassi2023-03-281-0/+21
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | When a portable service uses extensions, we use the 'main' image name (the one where the unit was found in) as PORTABLE=. It is useful to also list all the images actually used at runtime, as they might contain libraries and so on. Use PORTABLE_ROOT= for the image/directory that is used as RootImage= or RootDirectory=, and PORTABLE_EXTENSION= for the image/directory that is used as ExtensionImages= or ExtensionDirectories=. Note that these new fields are only added if extensions are used, there's no change for single-DDI portables. Example with a base and two extensions, with the unit coming from the first extension: [Service] RootImage=/home/bluca/git/systemd/base.raw Environment=PORTABLE=app0.raw BindReadOnlyPaths=/etc/os-release:/run/host/os-release LogExtraFields=PORTABLE=app0.raw LogExtraFields=PORTABLE_ROOT=base.raw ExtensionImages=/home/bluca/git/systemd/app0.raw LogExtraFields=PORTABLE_EXTENSION=app0.raw ExtensionImages=/home/bluca/git/systemd/app1.raw LogExtraFields=PORTABLE_EXTENSION=app1.raw
* docs: s/authorized_key/authorized_keys/Frantisek Sumsal2023-03-241-1/+1
|
* docs: Explicitly tell developers to enable mkosi required meson optionsDaan De Meyer2023-03-231-1/+1
| | | | | We need repart, bootctl, analyze and ukify for mkosi so let's make sure those get built in the HACKING guide.
* docs: Fix vscode debugging section in HACKING.mdDaan De Meyer2023-03-211-12/+13
| | | | | Let's account for the recent changes in mkosi in the debugging with vscode section.
* docs: update unit name for sd-tmpfiles-setupMike Yuan2023-03-181-1/+1
|
* doc: update ELF_PACKAGE_METADATA to use linker flag instead of manual scriptLuca Boccassi2023-03-161-49/+5
| | | | | bfd/gold/mold/lld support this flag, so document it explicitly, and drop the manually written linker script which is no longer necessary
* repart: Add support for reading mkfs options from environmentDaan De Meyer2023-03-101-0/+6
|
* Merge pull request #26038 from ↵Zbigniew Jędrzejewski-Szmek2023-03-091-0/+4
|\ | | | | | | | | lilyinstarlight/fix/fstab-generator-sysroot-without-cmdline fstab-generator: use correct targets when /sysroot is specificied in fstab only
| * fstab-generator: add SYSTEMD_SYSFS_CHECK env varLily Foster2023-01-261-0/+4
| | | | | | | | | | This forces processing of /dev entries in fstab when running in a container is detected (checked as the existence of read-only /sys).