# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , 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 \n" "Language-Team: LANGUAGE \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 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(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(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(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\\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(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(1) the ID of the machine will be " "established\\&. If I 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, " "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(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(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 may be used " "to override the autodetection logic, see B(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 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 considered the " "first boot\\&. B 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 will be run and B 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\\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(1), B(1), B(3), " "B(5), B(5), B(5), B(3), " "B(3), B(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(1) the ID of the machine will be " "established\\&. If I 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, " "the KVM DMI product_uuid or the devicetree vm,uuid (on KVM systems), and " "finally a randomly generated UUID\\&." msgstr ""