diff options
Diffstat (limited to '')
| -rw-r--r-- | templates/man5/machine-id.5.pot | 442 |
1 files changed, 442 insertions, 0 deletions
diff --git a/templates/man5/machine-id.5.pot b/templates/man5/machine-id.5.pot new file mode 100644 index 00000000..633d54be --- /dev/null +++ b/templates/man5/machine-id.5.pot @@ -0,0 +1,442 @@ +# 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-03-01 17:00+0100\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 +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "MACHINE-ID" +msgstr "" + +#. type: TH +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "systemd 255" +msgstr "" + +#. type: TH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "machine-id" +msgstr "" + +#. ----------------------------------------------------------------- +#. * MAIN CONTENT STARTS HERE * +#. ----------------------------------------------------------------- +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "machine-id - Local machine ID configuration file" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "/etc/machine-id" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The /etc/machine-id file contains the unique machine ID of the local system " +"that is set during installation or boot\\&. The machine ID is a single " +"newline-terminated, hexadecimal, 32-character, lowercase ID\\&. When decoded " +"from hexadecimal, this corresponds to a 16-byte/128-bit value\\&. This ID " +"may not be all zeros\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The machine ID is usually generated from a random source during system " +"installation or first boot and stays constant for all subsequent boots\\&. " +"Optionally, for stateless systems, it is generated during runtime during " +"early boot if necessary\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The machine ID may be set, for example when network booting, with the " +"I<systemd\\&.machine_id=> kernel command line parameter or by passing the " +"option B<--machine-id=> to systemd\\&. An ID specified in this manner has " +"higher priority and will be used instead of the ID stored in /etc/machine-" +"id\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The machine ID does not change based on local or network configuration or " +"when hardware is replaced\\&. Due to this and its greater length, it is a " +"more useful replacement for the B<gethostid>(3) call that POSIX " +"specifies\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This machine ID adheres to the same format and logic as the D-Bus machine " +"ID\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This ID uniquely identifies the host\\&. It should be considered " +"\"confidential\", and must not be exposed in untrusted environments, in " +"particular on the network\\&. If a stable unique identifier that is tied to " +"the machine is needed for some application, the machine ID or any part of it " +"must not be used directly\\&. Instead the machine ID should be hashed with a " +"cryptographic, keyed hash function, using a fixed, application-specific " +"key\\&. That way the ID will be properly unique, and derived in a constant " +"way from the machine ID but there will be no way to retrieve the original " +"machine ID from the application-specific one\\&. The " +"B<sd_id128_get_machine_app_specific>(3) API provides an implementation of " +"such an algorithm\\&." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "INITIALIZATION" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Each machine should have a non-empty ID in normal operation\\&. The ID of " +"each machine should be unique\\&. To achieve those objectives, /etc/machine-" +"id can be initialized in a few different ways\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"For normal operating system installations, where a custom image is created " +"for a specific machine, /etc/machine-id should be populated during " +"installation\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<systemd-machine-id-setup>(1) may be used by installer tools to initialize " +"the machine ID at install time, but /etc/machine-id may also be written " +"using any other means\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"For operating system images which are created once and used on multiple " +"machines, for example for containers or in the cloud, /etc/machine-id should " +"be either missing or an empty file in the generic file system image (the " +"difference between the two options is described under \"First Boot " +"Semantics\" below)\\&. An ID will be generated during boot and saved to this " +"file if possible\\&. Having an empty file in place is useful because it " +"allows a temporary file to be bind-mounted over the real file, in case the " +"image is used read-only\\&. Also see \\m[blue]B<Safely Building " +"Images>\\m[]\\&\\s-2\\u[1]\\d\\s+2\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<systemd-firstboot>(1) may be used to initialize /etc/machine-id on " +"mounted (but not booted) system images\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable mageia-cauldron +msgid "" +"When a machine is booted with B<systemd>(1) the ID of the machine will be " +"established\\&. If I<systemd\\&.machine_id=> or B<--machine-id=> options " +"(see first section) are specified, this value will be used\\&. Otherwise, " +"the value in /etc/machine-id will be used\\&. If this file is empty or " +"missing, systemd will attempt to use the D-Bus machine ID from /var/lib/dbus/" +"machine-id, the value of the kernel command line option I<container_uuid>, " +"the KVM DMI product_uuid or the devicetree vm,uuid (on KVM systems), the Xen " +"hypervisor uuid, and finally a randomly generated UUID\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"After the machine ID is established, B<systemd>(1) will attempt to save it " +"to /etc/machine-id\\&. If this fails, it will attempt to bind-mount a " +"temporary file over /etc/machine-id\\&. It is an error if the file system is " +"read-only and does not contain a (possibly empty) /etc/machine-id file\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<systemd-machine-id-commit.service>(8) will attempt to write the machine " +"ID to the file system if /etc/machine-id or /etc/ are read-only during early " +"boot but become writable later on\\&." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "FIRST BOOT SEMANTICS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"/etc/machine-id is used to decide whether a boot is the first one\\&. The " +"rules are as follows:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The kernel command argument I<systemd\\&.condition-first-boot=> may be used " +"to override the autodetection logic, see B<kernel-command-line>(7)\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Otherwise, if /etc/machine-id does not exist, this is a first boot\\&. " +"During early boot, B<systemd> will write \"uninitialized\\en\" to this file " +"and overmount a temporary file which contains the actual machine ID\\&. " +"Later (after first-boot-complete\\&.target has been reached), the real " +"machine ID will be written to disk\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If /etc/machine-id contains the string \"uninitialized\", a boot is also " +"considered the first boot\\&. The same mechanism as above applies\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If /etc/machine-id exists and is empty, a boot is I<not> considered the " +"first boot\\&. B<systemd> will still bind-mount a file containing the " +"actual machine-id over it and later try to commit it to disk (if /etc/ is " +"writable)\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If /etc/machine-id already contains a valid machine-id, this is not a first " +"boot\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If according to the above rules a first boot is detected, units with " +"I<ConditionFirstBoot=yes> will be run and B<systemd> will perform additional " +"initialization steps, in particular presetting units\\&." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "RELATION TO OSF UUIDS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Note that the machine ID historically is not an OSF UUID as defined by " +"\\m[blue]B<RFC 4122>\\m[]\\&\\s-2\\u[2]\\d\\s+2, nor a Microsoft GUID; " +"however, starting with systemd v30, newly generated machine IDs do qualify " +"as Variant 1 Version 4 UUIDs, as per RFC 4122\\&." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In order to maintain compatibility with existing installations, an " +"application requiring a strictly RFC 4122 compliant UUID should decode the " +"machine ID, and then (non-reversibly) apply the following operations to turn " +"it into a valid RFC 4122 Variant 1 Version 4 UUID\\&. With \"id\" being an " +"unsigned character array:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"/* Set UUID version to 4 --- truly random generation */\n" +"id[6] = (id[6] & 0x0F) | 0x40;\n" +"/* Set the UUID variant to DCE */\n" +"id[8] = (id[8] & 0x3F) | 0x80;\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"(This code is inspired by \"generate_random_uuid()\" of drivers/char/" +"random\\&.c from the Linux kernel sources\\&.)" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "HISTORY" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The simple configuration file format of /etc/machine-id originates in the /" +"var/lib/dbus/machine-id file introduced by D-Bus\\&. In fact, this latter " +"file might be a symlink to /etc/machine-id\\&." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<systemd>(1), B<systemd-machine-id-setup>(1), B<gethostid>(3), " +"B<hostname>(5), B<machine-info>(5), B<os-release>(5), B<sd-id128>(3), " +"B<sd_id128_get_machine>(3), B<systemd-firstboot>(1)" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: IP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid " 1." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Safely Building Images" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "\\%https://systemd.io/BUILDING_IMAGES" +msgstr "" + +#. type: IP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid " 2." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "RFC 4122" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "\\%https://tools.ietf.org/html/rfc4122" +msgstr "" + +#. type: TH +#: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "systemd 254" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"When a machine is booted with B<systemd>(1) the ID of the machine will be " +"established\\&. If I<systemd\\&.machine_id=> or B<--machine-id=> options " +"(see first section) are specified, this value will be used\\&. Otherwise, " +"the value in /etc/machine-id will be used\\&. If this file is empty or " +"missing, systemd will attempt to use the D-Bus machine ID from /var/lib/dbus/" +"machine-id, the value of the kernel command line option I<container_uuid>, " +"the KVM DMI product_uuid or the devicetree vm,uuid (on KVM systems), and " +"finally a randomly generated UUID\\&." +msgstr "" |