diff options
Diffstat (limited to 'templates/man7')
| -rw-r--r-- | templates/man7/systemd.v.7.pot | 340 |
1 files changed, 340 insertions, 0 deletions
diff --git a/templates/man7/systemd.v.7.pot b/templates/man7/systemd.v.7.pot new file mode 100644 index 00000000..28672999 --- /dev/null +++ b/templates/man7/systemd.v.7.pot @@ -0,0 +1,340 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2024-06-15 09:13+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" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: TH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "SYSTEMD\\&.V" +msgstr "" + +#. type: TH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "systemd 256~rc3" +msgstr "" + +#. type: TH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "systemd.v" +msgstr "" + +#. ----------------------------------------------------------------- +#. * MAIN CONTENT STARTS HERE * +#. ----------------------------------------------------------------- +#. type: SH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "systemd.v - Directory with Versioned Resources" +msgstr "" + +#. type: SH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"In various places systemd components accept paths whose trailing components " +"have the \"\\&.v/\" suffix, pointing to a directory\\&. These components " +"will then automatically look for suitable files inside the directory, do a " +"version comparison and open the newest file found (by version)\\&. Available " +"since version v256\\&. Specifically, two expressions are supported:" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"When looking for files with a suffix I<\\&.SUFFIX>, and a path \\&...I<PATH>/" +"I<NAME>I<\\&.SUFFIX>\\&.v/ is specified, then all files \\&...I<PATH>/" +"I<NAME>I<\\&.SUFFIX>\\&.v/I<NAME>_*I<\\&.SUFFIX> are enumerated, filtered, " +"sorted and the newest file used\\&. The primary sorting key is the " +"I<variable part>, here indicated by the wildcard \"*\"\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"When a path \\&...I<PATH>\\&.v/I<NAME>___I<\\&.SUFFIX> is specified (i\\&." +"e\\&. the penultimate component of the path ends in \"\\&.v\" and the final " +"component contains a triple underscore), then all files \\&...I<PATH>\\&.v/" +"I<NAME>_*I<\\&.SUFFIX> are enumerated, filtered, sorted and the newest file " +"used (again, by the I<variable part>, here indicated by the wildcard " +"\"*\")\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"To illustrate this in an example, consider a directory /var/lib/machines/" +"mymachine\\&.raw\\&.v/, which is populated with three files:" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "mymachine_7\\&.5\\&.13\\&.raw" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "mymachine_7\\&.5\\&.14\\&.raw" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "mymachine_7\\&.6\\&.0\\&.raw" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"Invoke a tool such as B<systemd-nspawn>(1) with a command line like the " +"following:" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "# systemd-nspawn --image=/var/lib/machines/mymachine\\&.raw\\&.v --boot\n" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "Then this would automatically be resolved to the equivalent of:" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "# systemd-nspawn --image=/var/lib/machines/mymachine\\&.raw\\&.v/mymachine_7\\&.6\\&.0\\&.raw --boot\n" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"Much of systemd\\*(Aqs functionality that expects a path to a disk image or " +"OS directory hierarchy support the \"\\&.v/\" versioned directory mechanism, " +"for example B<systemd-nspawn>(1), B<systemd-dissect>(1) or the " +"I<RootDirectory=>/I<RootImage=> settings of service files (see B<systemd." +"exec>(5))\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"Use the B<systemd-vpick>(1) tool to resolve \"\\&.v/\" paths from the " +"command line, for example for usage in shell scripts\\&." +msgstr "" + +#. type: SH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "FILTERING AND SORTING" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"The variable part of the filenames in the \"\\&.v/\" directories are " +"filtered and compared primarily with a version comparison, implementing " +"\\m[blue]B<Version Format Specification>\\m[]\\&\\s-2\\u[1]\\d\\s+2\\&. " +"However, additional rules apply:" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"If the variable part is suffixed by one or two integer values (\"tries " +"left\" and \"tries done\") in the formats +I<LEFT> or +I<LEFT>-I<DONE>, then " +"these indicate usage attempt counters\\&. The idea is that each time before " +"a file is attempted to be used, its \"tries left\" counter is decreased, and " +"the \"tries done\" counter increased (simply by renaming the file)\\&. When " +"the file is successfully used (which for example could mean for an OS image: " +"successfully booted) the counters are removed from the file name, indicating " +"that the file has been validated to work correctly\\&. This mechanism " +"mirrors the boot assessment counters defined by \\m[blue]B<Automatic Boot " +"Assessment>\\m[]\\&\\s-2\\u[2]\\d\\s+2\\&. Any filenames with no boot " +"counters or with a non-zero \"tries left\" counter are sorted before " +"filenames with a zero \"tries left\" counter\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"Preceding the use counters (if they are specified), an optional CPU " +"architecture identifier may be specified in the filename (separated from the " +"version with an underscore), as defined in the architecture vocabulary of " +"the I<ConditionArchitecture=> unit file setting, as documented in B<systemd." +"unit>(5)\\&. Files whose name indicates an architecture not supported " +"locally are filtered and not considered for the version comparison\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "The rest of the variable part is the version string\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"Or in other words, the files in the \"\\&.v/\" directories should follow one " +"of these naming structures:" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "I<NAME>_I<VERSION>I<\\&.SUFFIX>" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "I<NAME>_I<VERSION>_I<ARCHITECTURE>I<\\&.SUFFIX>" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "I<NAME>_I<VERSION>+I<LEFT>I<\\&.SUFFIX>" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "I<NAME>_I<VERSION>+I<LEFT>-I<DONE>I<\\&.SUFFIX>" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "I<NAME>_I<VERSION>_I<ARCHITECTURE>+I<LEFT>I<\\&.SUFFIX>" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "I<NAME>_I<VERSION>_I<ARCHITECTURE>+I<LEFT>-I<DONE>I<\\&.SUFFIX>" +msgstr "" + +#. type: SH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "EXAMPLE" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"Here\\*(Aqs a more comprehensive example, further extending the one " +"described above\\&. Consider a directory /var/lib/machines/mymachine\\&." +"raw\\&.v/, which is populated with the following files:" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "mymachine_7\\&.5\\&.14_x86-64\\&.raw" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "mymachine_7\\&.6\\&.0_arm64\\&.raw" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "mymachine_7\\&.7\\&.0_x86-64+0-5\\&.raw" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "Now invoke the following command on an x86-64 machine:" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "$ systemd-vpick --suffix=\\&.raw /var/lib/machines/mymachine\\&.raw\\&.v/\n" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"This would resolve the specified path to /var/lib/machines/mymachine\\&." +"raw\\&.v/mymachine_7\\&.5\\&.14_x86-64\\&.raw\\&. Explanation: even though " +"mymachine_7\\&.7\\&.0_x86-64+0-5\\&.raw has the newest version, it is not " +"preferred because its tries left counter is zero\\&. And even though " +"mymachine_7\\&.6\\&.0_arm64\\&.raw has the second newest version it is also " +"not considered, in this case because we operate on an x86_64 system and the " +"image is intended for arm64 CPUs\\&. Finally, the mymachine_7\\&.5\\&.13\\&." +"raw image is not considered because it is older than " +"mymachine_7\\&.5\\&.14_x86-64\\&.raw\\&." +msgstr "" + +#. type: SH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"B<systemd>(1), B<systemd-vpick>(1), B<systemd-nspawn>(1), B<systemd-" +"dissect>(1), B<systemd.exec>(5), B<systemd-sysupdate>(1)" +msgstr "" + +#. type: SH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: IP +#: debian-unstable fedora-rawhide +#, no-wrap +msgid " 1." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "Version Format Specification" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"\\%https://uapi-group.org/specifications/specs/version_format_specification/" +msgstr "" + +#. type: IP +#: debian-unstable fedora-rawhide +#, no-wrap +msgid " 2." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "Automatic Boot Assessment" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "\\%https://systemd.io/AUTOMATIC_BOOT_ASSESSMENT/" +msgstr "" |