systemd/docs
Luca Boccassi e8114a4f86 portable: add PORTABLE_NAME_AND_VERSION= and other metadata to LogsExtraFields=
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
2023-03-28 12:14:21 +01:00
..
_data docs: beef up entrypoint documentation page 2019-12-11 10:53:14 +01:00
_includes update footer to 2023 2023-01-29 20:26:28 +09:00
_layouts docs: adapt forward layout to systemd.io design 2022-05-21 18:09:50 +02:00
assets docs: add dark mode 2022-05-17 23:00:18 +02:00
fonts docs: make it pretty 2019-12-11 17:04:20 +01:00
sysvinit meson: also allow setting GIT_VERSION via templates 2022-04-05 22:18:31 +02:00
var-log docs: move /var/log/README to a tmpfiles.d symlink 2021-07-21 17:29:06 +02:00
.gitattributes docs: mark spdx headers with the default license to website files 2021-10-18 09:43:18 +02:00
.gitignore gitignore: add jekyll cache directory 2021-06-24 10:20:29 +02:00
_config.yml docs: use https:// for fd.o links 2022-01-12 16:05:59 +01:00
ARCHITECTURE.md docs: fix grammar a bit 2023-01-23 22:52:34 +00:00
AUTOMATIC_BOOT_ASSESSMENT.md docs: fix grammar a bit 2023-01-23 22:52:34 +00:00
BLOCK_DEVICE_LOCKING.md tree-wide: use -EBADF for fd initialization 2022-12-19 15:00:57 +01:00
BOOT_LOADER_INTERFACE.md Merge pull request #25379 from keszybz/update-doc-links 2022-11-22 01:07:13 +01:00
BOOT_LOADER_SPECIFICATION.md docs: DPS and BLS have moved to uapi-group.org 2022-11-02 07:31:18 +09:00
BUILDING_IMAGES.md docs, man: consistently use comma after "For example" 2023-01-23 22:52:34 +00:00
CGROUP_DELEGATION.md docs, man: consistently use comma after "For example" 2023-01-23 22:52:34 +00:00
CODE_OF_CONDUCT.md docs: add spdx tags to all .md files 2021-09-27 09:19:02 +02:00
CODE_QUALITY.md docs: fix formatting a bit 2023-01-23 22:52:34 +00:00
CODING_STYLE.md CODING_STYLE: note that 'unsigned' form is preferred over 'unsigned int' 2023-03-08 21:17:23 +00:00
CONTAINER_INTERFACE.md docs: fix grammar a bit 2023-01-23 22:52:34 +00:00
CONTRIBUTING.md docs: fix formatting a bit 2023-01-23 22:52:34 +00:00
CONVERTING_TO_HOMED.md docs: tweak rsync flags for moving existing home dir to systemd-homed 2023-02-01 20:47:56 +00:00
COREDUMP_PACKAGE_METADATA.md docs: rename COREDUMP_PACKAGE_METADATA → ELF_PACKAGE_METADATA 2022-05-21 18:08:19 +02:00
CREDENTIALS.md treewide: fix a few typos in NEWS, docs and comments 2023-02-15 10:41:03 +00:00
DESKTOP_ENVIRONMENTS.md docs: fix typo in key name and adjust grammar a bit 2022-01-10 13:22:48 +01:00
DISCOVERABLE_PARTITIONS.md docs: DPS and BLS have moved to uapi-group.org 2022-11-02 07:31:18 +09:00
DISTRO_PORTING.md docs: fix grammar a bit 2023-01-23 22:52:34 +00:00
ELF_PACKAGE_METADATA.md doc: update ELF_PACKAGE_METADATA to use linker flag instead of manual script 2023-03-16 08:38:39 +01:00
ENVIRONMENT.md repart: Add support for reading mkfs options from environment 2023-03-10 09:33:39 +01:00
favicon.png docs: make it pretty 2019-12-11 17:04:20 +01:00
favicon.svg docs: mark spdx headers with the default license to website files 2021-10-18 09:43:18 +02:00
GROUP_RECORD.md docs: use relative links 2022-05-18 20:34:10 +02:00
HACKING.md docs: Explicitly tell developers to enable mkosi required meson options 2023-03-23 13:09:09 +00:00
HOME_DIRECTORY.md docs: use relative links 2022-05-18 20:34:10 +02:00
index.md docs: overhaul styling for example log messages on startpage 2022-05-17 23:00:18 +02:00
INITRD_INTERFACE.md tree-wide: use mode=0nnn for mount option 2022-12-14 22:12:44 +01:00
JOURNAL_EXPORT_FORMATS.md man: document __SEQNUM=/__SEQNUM_ID= journal pseudo fields 2023-02-08 13:42:30 +01:00
JOURNAL_FILE_FORMAT.md journal-file: journal-file: extend journal header to always carry offset of most recent entry 2023-03-02 10:03:15 +01:00
JOURNAL_NATIVE_PROTOCOL.md docs: s/straight-forward/straightforward/ 2022-03-15 22:46:09 +00:00
MEMORY_PRESSURE.md doc: add document explaining memory pressure handling 2023-03-01 09:43:24 +01:00
NETWORK_ONLINE.md doc: correct wrong use "'s" contractions 2023-03-07 13:39:31 +01:00
PASSWORD_AGENTS.md Use https for man7.org 2022-06-28 16:05:31 +02:00
PORTABILITY_AND_STABILITY.md docs, man: consistently use comma after "For example" 2023-01-23 22:52:34 +00:00
PORTABLE_SERVICES.md portable: add PORTABLE_NAME_AND_VERSION= and other metadata to LogsExtraFields= 2023-03-28 12:14:21 +01:00
PORTING_TO_NEW_ARCHITECTURES.md docs: fix grammar a bit 2023-01-23 22:52:34 +00:00
PREDICTABLE_INTERFACE_NAMES.md docs: move some stuff into "Networking" section 2022-07-05 11:22:06 +01:00
RANDOM_SEEDS.md docs: fix grammar a bit 2023-01-23 22:52:34 +00:00
RELEASE.md docs: update instructions for translation strings 2023-01-24 13:30:02 +00:00
RESOLVED-VPNS.md docs: avoid multiple first-level headlines 2022-05-17 23:00:18 +02:00
ROOT_STORAGE_DAEMONS.md tree-wide: also settle on "initrd" instead of "initial RAM disk" 2022-09-23 15:12:18 +02:00
SECURITY.md docs: add spdx tags to all .md files 2021-09-27 09:19:02 +02:00
style.css docs: desaturate dark-mode background color 2022-06-10 13:52:31 +02:00
TEMPORARY_DIRECTORIES.md Use https for man7.org 2022-06-28 16:05:31 +02:00
TESTING_WITH_SANITIZERS.md docs: fix grammar a bit 2023-01-23 22:52:34 +00:00
TRANSIENT-SETTINGS.md journal: log filtering options support in PID1 2022-12-15 09:57:39 +00:00
TRANSLATORS.md docs: replace <pre>, <code> and <tt> tags by backticks 2022-05-17 22:35:54 +02:00
UIDS-GIDS.md docs: update unit name for sd-tmpfiles-setup 2023-03-19 01:32:50 +08:00
USER_GROUP_API.md docs, man: consistently use comma after "For example" 2023-01-23 22:52:34 +00:00
USER_NAMES.md docs, man: consistently use comma after "For example" 2023-01-23 22:52:34 +00:00
USER_RECORD.md docs: s/authorized_key/authorized_keys/ 2023-03-24 16:16:50 +01:00
USERDB_AND_DESKTOPS.md docs, man: consistently use comma after "For example" 2023-01-23 22:52:34 +00:00