summaryrefslogtreecommitdiff
path: root/docs
Commit message (Collapse)AuthorAgeFilesLines
* 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-191-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-251-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).
* | CODING_STYLE: note that 'unsigned' form is preferred over 'unsigned int'Dmitry V. Levin2023-03-081-1/+1
| |
* | doc: correct wrong use "'s" contractionsJan Engelhardt2023-03-071-1/+1
| |
* | journal-file: journal-file: extend journal header to always carry offset of ↵Lennart Poettering2023-03-021-2/+7
| | | | | | | | | | | | | | | | | | | | most recent entry This way we can quickly find the most recent entry, without searching or traversing entry array chains. This is relevant later, as it it allows us to quickly determine the most recent timestamps of each journal file, in a roughly atomic way.
* | doc: add document explaining memory pressure handlingLennart Poettering2023-03-011-0/+240
| |
* | docs: document the new HEADER_COMPATIBLE_TAIL_ENTRY_BOOT_ID flagLennart Poettering2023-02-211-5/+27
| |
* | Drop mkosi + clang section from HACKINGDaan De Meyer2023-02-161-77/+0
| | | | | | | | | | We removed a few features that made this work, will be added back in the future when we restructure the way mkosi does build images.
* | Update HACKING for latest mkosiDaan De Meyer2023-02-161-13/+4
| |
* | Merge pull request #26213 from poettering/journal-rework-seqnumLuca Boccassi2023-02-151-2/+2
|\ \ | | | | | | journal sequence number rework
| * | man: document __SEQNUM=/__SEQNUM_ID= journal pseudo fieldsLennart Poettering2023-02-081-2/+2
| | |
* | | treewide: fix a few typos in NEWS, docs and commentsDmitry V. Levin2023-02-153-3/+3
| | |
* | | tree-wide: fix typo and comment style updateYu Watanabe2023-02-151-1/+1
| | |
* | | docs/NETWORK_ONLINE: fix exampleGeert Lorang2023-02-081-0/+2
|/ / | | | | | | | | | | | | Type=oneshot is necessary for systemd to actually wait for the service to return. With RemainAfterExit=yes it won't be started again. Fixes #26342.
* | docs/CODING_STYLE: add sentence about redirection operatorsZbigniew Jędrzejewski-Szmek2023-02-061-2/+5
| |
* | test: drop whitespace after shell redirection operatorsZbigniew Jędrzejewski-Szmek2023-02-061-1/+1
| | | | | | | | | | | | | | | | | | | | (The one case that is left unchanged is '< <(subcommand)'.) This way, the style with no gap was already dominant. This way, the reader immediately knows that ' < ' is a comparison operator and ' << ' is a shift. In a few cases, replace custom EOF replacement by just EOF. There is no point in using someting like "_EOL" unless "EOF" appears in the text.
* | docs: tweak rsync flags for moving existing home dir to systemd-homedwouter bolsterlee2023-02-011-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The documentation on moving an existing homedir into a systemd-homed managed one suggests using rsync(1) with a bunch of flags to preserve as much metadata as possible: permissions, xattrs, timestamps, etc. The previously suggested flags were: rsync -aHAXv --remove-source-files … … which does include mtimes, but not ctimes and atimes, because -a does not include those: --archive, -a archive mode is -rlptgoD (no -A,-X,-U,-N,-H) This change adds the -N and -U flags to preserve even more file timestamps, turning the command into: rsync -aHANUXv --remove-source-files … The new flags are: --crtimes, -N preserve create times (newness) --atimes, -U preserve access (use) times
* | update footer to 2023cake032023-01-291-1/+1
| |
* | docs: Update HACKING.md to mention latest mkosi is neededDaan De Meyer2023-01-241-10/+13
| | | | | | | | | | | | Let's require users to run mkosi from git so we can fix any issues forward instead of trying to keep the configs working with older versions.
* | docs: update instructions for translation stringsLuca Boccassi2023-01-241-1/+1
| |
* | docs: drop manual rc PR warning stepLuca Boccassi2023-01-241-13/+11
| | | | | | | | it is not automated, yay
* | docs, man: consistently use comma after "For example"Dmitry V. Levin2023-01-237-7/+7
| |
* | docs: fix formatting a bitDmitry V. Levin2023-01-232-3/+3
| |
* | docs: fix grammar a bitDmitry V. Levin2023-01-2312-30/+30
| |
View Lorry Controller Status