summaryrefslogtreecommitdiffstats
path: root/templates/man8/systemd-sysext.8.pot
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--templates/man8/systemd-sysext.8.pot358
1 files changed, 338 insertions, 20 deletions
diff --git a/templates/man8/systemd-sysext.8.pot b/templates/man8/systemd-sysext.8.pot
index f3e9a8c9..ccd7ccc8 100644
--- a/templates/man8/systemd-sysext.8.pot
+++ b/templates/man8/systemd-sysext.8.pot
@@ -7,7 +7,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2024-03-01 17:11+0100\n"
+"POT-Creation-Date: 2024-06-01 06:29+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -24,7 +24,7 @@ msgid "SYSTEMD-SYSEXT"
msgstr ""
#. type: TH
-#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: archlinux fedora-40 mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "systemd 255"
msgstr ""
@@ -68,8 +68,8 @@ msgid "B<systemd-sysext> [OPTIONS...] COMMAND"
msgstr ""
#. type: Plain text
-#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
-#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#: archlinux debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
#, no-wrap
msgid "systemd-sysext\\&.service\n"
msgstr ""
@@ -81,8 +81,8 @@ msgid "B<systemd-confext> [OPTIONS...] COMMAND"
msgstr ""
#. type: Plain text
-#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
-#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#: archlinux debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
#, no-wrap
msgid "systemd-confext\\&.service\n"
msgstr ""
@@ -135,8 +135,8 @@ msgid ""
msgstr ""
#. type: Plain text
-#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
-#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#: archlinux debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
msgid ""
"System extension images are strictly read-only, and the host /usr/ and /opt/ "
"hierarchies become read-only too while they are activated\\&."
@@ -212,6 +212,7 @@ msgstr ""
#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
msgid ""
"During boot OS extension images are activated automatically, if the systemd-"
"sysext\\&.service is enabled\\&. Note that this service runs only after the "
@@ -245,7 +246,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: archlinux debian-unstable fedora-rawhide mageia-cauldron opensuse-tumbleweed
msgid ""
"A simple mechanism for version compatibility is enforced: a system extension "
"image must carry a /usr/lib/extension-release\\&.d/extension-release\\&."
@@ -259,8 +260,8 @@ msgid ""
"B<uname>(2) but the used architecture identifiers are the same as for "
"I<ConditionArchitecture=> described in B<systemd.unit>(5)\\&. "
"I<EXTENSION_RELOAD_MANAGER=> can be set to 1 if the extension requires a "
-"service manager reload after application of the extension\\&. Note that the "
-"for the reasons mentioned earlier: \\m[blue]B<Portable "
+"service manager reload after application of the extension\\&. Note that for "
+"the reasons mentioned earlier: \\m[blue]B<Portable "
"Services>\\m[]\\&\\s-2\\u[2]\\d\\s+2 remain the recommended way to ship "
"system services\\&. System extensions should not ship a /usr/lib/os-release "
"file (as that would be merged into the host /usr/ tree, overriding the host "
@@ -299,6 +300,7 @@ msgstr ""
#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
msgid ""
"Again, just like sysext images, the confext images will contain a /etc/"
"extension-release\\&.d/extension-release\\&.I<NAME> file, which must match "
@@ -348,8 +350,8 @@ msgid ""
msgstr ""
#. type: Plain text
-#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
-#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#: archlinux debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
msgid ""
"For the confext case, the OSConfig project aims to perform runtime "
"reconfiguration of OS services\\&. Sometimes, there is a need to swap "
@@ -393,6 +395,7 @@ msgstr ""
#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
msgid "Added in version 248\\&."
msgstr ""
@@ -550,6 +553,7 @@ msgstr ""
#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
msgid "Added in version 254\\&."
msgstr ""
@@ -569,11 +573,13 @@ msgstr ""
#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
msgid "B<--no-reload>"
msgstr ""
#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
msgid ""
"When used with B<merge>, B<unmerge> or B<refresh>, do not reload daemon "
"after executing the changes even if an extension that is applied requires a "
@@ -582,6 +588,7 @@ msgstr ""
#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
msgid "Added in version 255\\&."
msgstr ""
@@ -648,8 +655,8 @@ msgid "SEE ALSO"
msgstr ""
#. type: Plain text
-#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
-#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#: archlinux debian-bookworm fedora-40 mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
msgid "B<systemd>(1), B<systemd-nspawn>(1), B<systemd-stub>(7)"
msgstr ""
@@ -690,6 +697,7 @@ msgstr ""
#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
msgid "Portable Services"
msgstr ""
@@ -700,13 +708,13 @@ msgid "\\%https://systemd.io/PORTABLE_SERVICES"
msgstr ""
#. type: TH
-#: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed
+#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid "systemd 254"
msgstr ""
#. type: Plain text
-#: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed
+#: debian-bookworm opensuse-leap-15-6
msgid ""
"During boot OS extension images are activated automatically, if the systemd-"
"sysext\\&.service is enabled\\&. Note that this service runs only after the "
@@ -729,7 +737,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed
+#: debian-bookworm opensuse-leap-15-6
msgid ""
"A simple mechanism for version compatibility is enforced: a system extension "
"image must carry a /usr/lib/extension-release\\&.d/extension-release\\&."
@@ -750,7 +758,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed
+#: debian-bookworm opensuse-leap-15-6
msgid ""
"Again, just like sysext images, the confext images will contain a /etc/"
"extension-release\\&.d/extension-release\\&.I<$name> file, which must match "
@@ -761,6 +769,316 @@ msgid ""
msgstr ""
#. type: Plain text
-#: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed
+#: debian-bookworm opensuse-leap-15-6
msgid "Portable Services Documentation"
msgstr ""
+
+#. type: TH
+#: debian-unstable fedora-rawhide
+#, no-wrap
+msgid "systemd 256~rc3"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "systemd-sysext\\&.service"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "systemd-confext\\&.service"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"System extension images are strictly read-only by default\\&. On mutable "
+"host file systems, /usr/ and /opt/ hierarchies become read-only while "
+"extensions are merged, unless mutability is enabled\\&. Mutability may be "
+"enabled via the B<--mutable=> option; see \"Mutability\" below for more "
+"information\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"Just like sysexts, confexts are strictly read-only by default\\&. Merging "
+"confexts on mutable host file systems will result in /etc/ becoming read-"
+"only\\&. As with sysexts, mutability can be enabled via the B<--mutable=> "
+"option\\&. Refer to \"Mutability\" below for more information\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"With systemd-confext one can perform runtime reconfiguration of OS "
+"services\\&. Sometimes, there is a need to swap certain configuration "
+"parameter values or restart only a specific service without deployment of "
+"new code or a complete OS deployment\\&. In other words, we want to be able "
+"to tie the most frequently configured options to runtime updateable flags "
+"that can be changed without a system reboot\\&. This will help reduce "
+"servicing times when there is a need for changing the OS configuration\\&. "
+"It also provides a reliable tool for managing configuration because all old "
+"configuration files disappear when the systemd-confext image is removed\\&."
+msgstr ""
+
+#. type: SH
+#: debian-unstable fedora-rawhide
+#, no-wrap
+msgid "MUTABILITY"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"By default, merging system extensions on mutable host file systems will "
+"render /usr/ and /opt/ hierarchies read-only\\&. Merging configuration "
+"extensions will have the same effect on /etc/\\&. Mutable mode allows writes "
+"to these locations when extensions are merged\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "The following modes are supported:"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"B<disabled>: Force immutable mode even if write routing directories exist "
+"below /var/lib/extensions\\&.mutable/\\&. This is the default\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"B<auto>: Automatic mode\\&. Mutability is disabled by default and only "
+"enabled if a corresponding write routing directory exists below /var/lib/"
+"extensions\\&.mutable/\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"B<enabled>: Force mutable mode and automatically create write routing "
+"directories below /var/lib/extensions\\&.mutable/ when required\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"B<import>: Force immutable mode like B<disabled> above, but merge the "
+"contents of directories below /var/lib/extensions\\&.mutable/ into the host "
+"file system\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"B<ephemeral>: Force mutable mode like B<enabled> above, but instead of using "
+"write routing directory below /var/lib/extensions\\&.mutable/, B<systemd-"
+"sysext> will use empty ephemeral directories\\&. This means that the "
+"modifications made in the merged hierarchies will be gone when the "
+"hierarchies are unmerged\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"B<ephemeral-import>: Force mutable mode like B<ephemeral> above, but instead "
+"of ignoring the contents of write routing directories under /var/lib/"
+"extensions\\&.mutable/, merge them into the host file system, like B<import> "
+"does\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"See \"Options\" below on specifying modes using the B<--mutable=> command "
+"line option\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"With exception of the ephemeral mode, the mutable mode routes writes to "
+"subdirectories in /var/lib/extensions\\&.mutable/\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "Writes to /usr/ are directed to /var/lib/extensions\\&.mutable/usr/"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"writes to /opt/ are directed to /var/lib/extensions\\&.mutable/opt/, and"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "writes to /etc/ land in /var/lib/extensions\\&.mutable/etc/\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"If usr/, opt/, or etc/ in /var/lib/extensions\\&.mutable/ are symlinks, then "
+"writes are directed to the symlinks\\*(Aq targets\\&. Consequently, to "
+"retain mutability of a host file system, create symlinks"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "/var/lib/extensions\\&.mutable/etc/ → /etc/"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "/var/lib/extensions\\&.mutable/usr/ → /usr/"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "/var/lib/extensions\\&.mutable/opt/ → /opt/"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "to route writes back to the original base directory hierarchy\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"Alternatively, a temporary file system may be mounted to /var/lib/"
+"extensions\\&.mutable/, or symlinks in /var/lib/extensions\\&.mutable/ may "
+"point to sub-directories on a temporary file system (e\\&.g\\&. below /tmp/) "
+"to only allow ephemeral changes\\&. Note that this is not the same as "
+"ephemeral mode, because the temporary file system will still exist after "
+"unmerging\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "Added in version 256\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "B<--mutable=>I<BOOL>B<|>I<auto>B<|>I<import>"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "Set mutable mode\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "B<no>"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"force immutable mode even with write routing directories present\\&. This is "
+"the default\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "B<auto>"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"enable mutable mode individually for /usr/, /opt/, and /etc/ if write "
+"routing sub-directories or symlinks are present in /var/lib/extensions\\&."
+"mutable/; disable otherwise\\&. See \"Mutability\" above for more "
+"information on write routing\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "B<yes>"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"force mutable mode\\&. Write routing directories will be created in /var/lib/"
+"extensions\\&.mutable/ if not present\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "B<import>"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"immutable mode, but with contents of write routing directories in /var/lib/"
+"extensions\\&.mutable/ also merged into the host file system\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "B<ephemeral>"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"force mutable mode, but with contents of write routing directories in /var/"
+"lib/extensions\\&.mutable/ being ignored, and modifications of the host file "
+"system being discarded after unmerge\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid "B<ephemeral-import>"
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"force mutable mode, with contents of write routing directories in /var/lib/"
+"extensions\\&.mutable/ being merged into the host file system, but with the "
+"modifications made to the host file system being discarded after unmerge\\&."
+msgstr ""
+
+#. type: Plain text
+#: debian-unstable fedora-rawhide
+msgid ""
+"B<systemd>(1), B<systemd-nspawn>(1), B<systemd-stub>(7), B<importctl>(1)"
+msgstr ""
+
+#. type: Plain text
+#: fedora-40
+msgid ""
+"A simple mechanism for version compatibility is enforced: a system extension "
+"image must carry a /usr/lib/extension-release\\&.d/extension-release\\&."
+"I<NAME> file, which must match its image name, that is compared with the "
+"host os-release file: the contained I<ID=> fields have to match unless "
+"\"_any\" is set for the extension\\&. If the extension I<ID=> is not "
+"\"_any\", the I<SYSEXT_LEVEL=> field (if defined) has to match\\&. If the "
+"latter is not defined, the I<VERSION_ID=> field has to match instead\\&. If "
+"the extension defines the I<ARCHITECTURE=> field and the value is not "
+"\"_any\" it has to match the kernel\\*(Aqs architecture reported by "
+"B<uname>(2) but the used architecture identifiers are the same as for "
+"I<ConditionArchitecture=> described in B<systemd.unit>(5)\\&. "
+"I<EXTENSION_RELOAD_MANAGER=> can be set to 1 if the extension requires a "
+"service manager reload after application of the extension\\&. Note that the "
+"for the reasons mentioned earlier: \\m[blue]B<Portable "
+"Services>\\m[]\\&\\s-2\\u[2]\\d\\s+2 remain the recommended way to ship "
+"system services\\&. System extensions should not ship a /usr/lib/os-release "
+"file (as that would be merged into the host /usr/ tree, overriding the host "
+"OS version data, which is not desirable)\\&. The extension-release file "
+"follows the same format and semantics, and carries the same content, as the "
+"os-release file of the OS, but it describes the resources carried in the "
+"extension image\\&."
+msgstr ""