path: root/templates/man5/machine-id.5.pot

# 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 ""