path: root/templates/man1/ukify.1.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:12+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-tumbleweed
#, no-wrap
msgid "UKIFY"
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-tumbleweed
#, no-wrap
msgid "ukify"
msgstr ""

#.  -----------------------------------------------------------------
#.  * MAIN CONTENT STARTS HERE *
#.  -----------------------------------------------------------------
#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"ukify - Combine components into a signed Unified Kernel Image for UEFI "
"systems"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "SYNOPSIS"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "B<ukify> [OPTIONS...] build"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "B<ukify> [OPTIONS...] genkey"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "B<ukify> [OPTIONS...] inspect FILE..."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"B<ukify> is a tool whose primary purpose is to combine components (usually a "
"kernel, an initrd, and a UEFI boot stub) to create a \\m[blue]B<Unified "
"Kernel Image (UKI)>\\m[]\\&\\s-2\\u[1]\\d\\s+2 \\(em a PE binary that can be "
"executed by the firmware to start the embedded linux kernel\\&. See "
"B<systemd-stub>(7)  for details about the stub\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "COMMANDS"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "The following commands are understood:"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "build"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"This command creates a Unified Kernel Image\\&. The two primary options that "
"should be specified for the B<build> verb are I<Linux=>/B<--linux=>, and "
"I<Initrd=>/B<--initrd=>\\&.  I<Initrd=> accepts multiple whitespace-"
"separated paths and B<--initrd=> can be specified multiple times\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Additional sections will be inserted into the UKI, either automatically or "
"only if a specific option is provided\\&. See the discussions of I<Cmdline=>/"
"B<--cmdline=>, I<OSRelease=>/B<--os-release=>, I<DeviceTree=>/B<--"
"devicetree=>, I<Splash=>/B<--splash=>, I<PCRPKey=>/B<--pcrpkey=>, I<Uname=>/"
"B<--uname=>, I<SBAT=>/B<--sbat=>, and B<--section=> below\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"B<ukify> can also be used to assemble a PE binary that is not executable but "
"contains auxiliary data, for example additional kernel command line "
"entries\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"If PCR signing keys are provided via the I<PCRPrivateKey=>/B<--pcr-private-"
"key=> and I<PCRPublicKey=>/B<--pcr-public-key=> options, PCR values that "
"will be seen after booting with the given kernel, initrd, and other "
"sections, will be calculated, signed, and embedded in the UKI\\&.  B<systemd-"
"measure>(1)  is used to perform this calculation and signing\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"The calculation of PCR values is done for specific boot phase paths\\&. "
"Those can be specified with the I<Phases=>/B<--phases=> option\\&. If not "
"specified, the default provided by B<systemd-measure> is used\\&. It is also "
"possible to specify the I<PCRPrivateKey=>/B<--pcr-private-key=>, "
"I<PCRPublicKey=>/B<--pcr-public-key=>, and I<Phases=>/B<--phases=> arguments "
"more than once\\&. Signatures will then be performed with each of the "
"specified keys\\&. On the command line, when both B<--phases=> and B<--pcr-"
"private-key=> are used, they must be specified the same number of times, and "
"then the n-th boot phase path set will be signed by the n-th key\\&. This "
"can be used to build different trust policies for different phases of the "
"boot\\&. In the config file, I<PCRPrivateKey=>, I<PCRPublicKey=>, and "
"I<Phases=> are grouped into separate sections, describing separate boot "
"phases\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"If a SecureBoot signing key is provided via the I<SecureBootPrivateKey=>/B<--"
"secureboot-private-key=> option, the resulting PE binary will be signed as a "
"whole, allowing the resulting UKI to be trusted by SecureBoot\\&. Also see "
"the discussion of automatic enrollment in B<systemd-boot>(7)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"If the stub and/or the kernel contain \"\\&.sbat\" sections they will be "
"merged in the UKI so that revocation updates affecting either are considered "
"when the UKI is loaded by Shim\\&. For more information on SBAT see "
"\\m[blue]B<Shim documentation>\\m[]\\&\\s-2\\u[2]\\d\\s+2\\&."
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "genkey"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"This command creates the keys for PCR signing and the key and certificate "
"used for SecureBoot signing\\&. The same configuration options that "
"determine what keys and in which paths will be needed for signing when "
"B<build> is used, here determine which keys will be created\\&. See the "
"discussion of I<PCRPrivateKey=>/B<--pcr-private-key=>, I<PCRPublicKey=>/B<--"
"pcr-public-key=>, and I<SecureBootPrivateKey=>/B<--secureboot-private-key=> "
"below\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "The output files must not exist\\&."
msgstr ""

#. type: SS
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "inspect"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"Display information about the sections in a given binary or binaries\\&. If "
"B<--all> is given, all sections are shown\\&. Otherwise, if B<--section=> "
"option is specified at least once, only those sections are shown\\&. "
"Otherwise, well-known sections that are typically included in an UKI are "
"shown\\&. For each section, its name, size, and sha256-digest is printed\\&. "
"For text sections, the contents are printed\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Also see the description of B<-j>/B<--json=> and B<--section=>\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "CONFIGURATION SETTINGS"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Settings can appear in configuration files (the syntax with "
"I<SomeSetting=>I<value>) and on the command line (the syntax with B<--some-"
"setting=>I<value>)\\&. For some command line parameters, a single-letter "
"shortcut is also allowed\\&. In the configuration files, the setting must be "
"in the appropriate section, so the descriptions are grouped by section "
"below\\&. When the same setting appears in the configuration file and on the "
"command line, generally the command line setting has higher priority and "
"overwrites the config file setting completely\\&. If some setting behaves "
"differently, this is described below\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"If no config file is provided via the option B<--config=>I<PATH>, B<ukify> "
"will try to look for a default configuration file in the following paths in "
"this order: /run/systemd/ukify\\&.conf, /etc/systemd/ukify\\&.conf, /usr/"
"local/lib/systemd/ukify\\&.conf, and /usr/lib/systemd/ukify\\&.conf, and "
"then load the first one found\\&.  B<ukify> will proceed normally if no "
"configuration file is specified and no default one is found\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"The I<LINUX> and I<INITRD> positional arguments, or the equivalent I<Linux=> "
"and I<Initrd=> settings, are optional\\&. If more than one initrd is "
"specified, they will all be combined into a single PE section\\&. This is "
"useful to, for example, prepend microcode before the actual initrd\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "The following options and settings are understood:"
msgstr ""

#. type: SS
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "Command line-only options"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "B<--config=>I<PATH>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"Load configuration from the given config file\\&. In general, settings "
"specified in the config file have lower precedence than the settings "
"specified via options\\&. In cases where the command line option does not "
"fully override the config file setting are explicitly mentioned in the "
"descriptions of individual options\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 254\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "B<--measure>, B<--no-measure>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Enable or disable a call to B<systemd-measure>(1)  to print pre-calculated "
"PCR values\\&. Defaults to false\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 253\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"B<--section=>I<NAME>B<:>I<TEXT>B<|>I<@PATH>, B<--section=>I<NAME>B<:>B<text|"
"binary>B<[@>I<PATH>]"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"For all verbs except B<inspect>, the first syntax is used\\&. Specify an "
"arbitrary additional section \"I<NAME>\"\\&. The argument may be a literal "
"string, or \"@\" followed by a path name\\&. This option may be specified "
"more than once\\&. Any sections specified in this fashion will be inserted "
"(in order) before the \"\\&.linux\" section which is always last\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"For the B<inspect> verb, the second syntax is used\\&. The section I<NAME> "
"will be inspected (if found)\\&. If the second argument is \"text\", the "
"contents will be printed\\&. If the third argument is given, the contents "
"will be saved to file I<PATH>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"Note that the name is used as-is, and if the section name should start with "
"a dot, it must be included in I<NAME>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "B<--tools=>I<DIRS>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Specify one or more directories with helper tools\\&.  B<ukify> will look "
"for helper tools in those directories first, and if not found, try to load "
"them from I<$PATH> in the usual fashion\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "B<--output=>I<FILENAME>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"The output filename\\&. If not specified, the name of the I<LINUX> argument, "
"with the suffix \"\\&.unsigned\\&.efi\" or \"\\&.signed\\&.efi\" will be "
"used, depending on whether signing for SecureBoot was performed\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "B<--summary>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"Print a summary of loaded config and exit\\&. This is useful to check how "
"the options from the configuration file and the command line are combined\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "B<--all>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Print all sections (with B<inspect> verb)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 255\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "B<--json>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Generate JSON output (with B<inspect> verb)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "B<-h>, B<--help>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "Print a short help text and exit\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "B<--version>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "Print a short version string and exit\\&."
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "[UKI] section"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<Linux=>I<LINUX>, B<--linux=>I<LINUX>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "A path to the kernel binary\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<Initrd=>I<INITRD>I<\\&.\\&.\\&.>, B<--initrd=>I<LINUX>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Zero or more initrd paths\\&. In the configuration file, items are separated "
"by whitespace\\&. The initrds are combined in the order of specification, "
"with the initrds specified in the config file first\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<Cmdline=>I<TEXT>I<|>I<@PATH>, B<--cmdline=>I<TEXT>B<|>I<@PATH>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"The kernel command line (the \"\\&.cmdline\" section)\\&. The argument may "
"be a literal string, or \"@\" followed by a path name\\&. If not specified, "
"no command line will be embedded\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<OSRelease=>I<TEXT>I<|>I<@PATH>, B<--os-release=>I<TEXT>B<|>I<@PATH>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"The os-release description (the \"\\&.osrel\" section)\\&. The argument may "
"be a literal string, or \"@\" followed by a path name\\&. If not specified, "
"the B<os-release>(5)  file will be picked up from the host system\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<DeviceTree=>I<PATH>, B<--devicetree=>I<PATH>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"The devicetree description (the \"\\&.dtb\" section)\\&. The argument is a "
"path to a compiled binary DeviceTree file\\&. If not specified, the section "
"will not be present\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<Splash=>I<PATH>, B<--splash=>I<PATH>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"A picture to display during boot (the \"\\&.splash\" section)\\&. The "
"argument is a path to a BMP file\\&. If not specified, the section will not "
"be present\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<PCRPKey=>I<PATH>, B<--pcrpkey=>I<PATH>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"A path to a public key to embed in the \"\\&.pcrpkey\" section\\&. If not "
"specified, and there\\*(Aqs exactly one I<PCRPublicKey=>/B<--pcr-public-"
"key=> argument, that key will be used\\&. Otherwise, the section will not be "
"present\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<Uname=>I<VERSION>, B<--uname=>I<VERSION>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Specify the kernel version (as in B<uname -r>, the \"\\&.uname\" "
"section)\\&. If not specified, an attempt will be made to extract the "
"version string from the kernel image\\&. It is recommended to pass this "
"explicitly if known, because the extraction is based on heuristics and not "
"very reliable\\&. If not specified and extraction fails, the section will "
"not be present\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<PCRBanks=>I<PATH>, B<--pcr-banks=>I<PATH>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"A comma or space-separated list of PCR banks to sign a policy for\\&. If not "
"present, all known banks will be used (\"sha1\", \"sha256\", \"sha384\", "
"\"sha512\"), which will fail if not supported by the system\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<SecureBootSigningTool=>I<SIGNER>, B<--signtool=>I<SIGNER>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Whether to use \"sbsign\" or \"pesign\"\\&. Depending on this choice, "
"different parameters are required in order to sign an image\\&. Defaults to "
"\"sbsign\"\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"I<SecureBootPrivateKey=>I<SB_KEY>, B<--secureboot-private-key=>I<SB_KEY>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"A path to a private key to use for signing of the resulting binary\\&. If "
"the I<SigningEngine=>/B<--signing-engine=> option is used, this may also be "
"an engine-specific designation\\&. This option is required by "
"I<SecureBootSigningTool=sbsign>/B<--signtool=sbsign>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"I<SecureBootCertificate=>I<SB_CERT>, B<--secureboot-certificate=>I<SB_CERT>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"A path to a certificate to use for signing of the resulting binary\\&. If "
"the I<SigningEngine=>/B<--signing-engine=> option is used, this may also be "
"an engine-specific designation\\&. This option is required by "
"I<SecureBootSigningTool=sbsign>/B<--signtool=sbsign>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"I<SecureBootCertificateDir=>I<SB_PATH>, B<--secureboot-certificate-"
"dir=>I<SB_PATH>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"A path to a nss certificate database directory to use for signing of the "
"resulting binary\\&. Takes effect when I<SecureBootSigningTool=pesign>/B<--"
"signtool=pesign> is used\\&. Defaults to /etc/pki/pesign\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"I<SecureBootCertificateName=>I<SB_CERTNAME>, B<--secureboot-certificate-"
"name=>I<SB_CERTNAME>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"The name of the nss certificate database entry to use for signing of the "
"resulting binary\\&. This option is required by "
"I<SecureBootSigningTool=pesign>/B<--signtool=pesign>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"I<SecureBootCertificateValidity=>I<DAYS>, B<--secureboot-certificate-"
"validity=>I<DAYS>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Period of validity (in days) for a certificate created by B<genkey>\\&. "
"Defaults to 3650, i\\&.e\\&. 10 years\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<SigningEngine=>I<ENGINE>, B<--signing-engine=>I<ENGINE>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"An \"engine\" for signing of the resulting binary\\&. This option is "
"currently passed verbatim to the B<--engine=> option of B<sbsign>(1)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<SignKernel=>I<BOOL>, B<--sign-kernel>, B<--no-sign-kernel>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"Override the detection of whether to sign the Linux binary itself before it "
"is embedded in the combined image\\&. If not specified, it will be signed if "
"a SecureBoot signing key is provided via the I<SecureBootPrivateKey=>/B<--"
"secureboot-private-key=> option and the binary has not already been "
"signed\\&. If I<SignKernel=>/B<--sign-kernel> is true, and the binary has "
"already been signed, the signature will be appended anyway\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<SBAT=>I<TEXT>I<|>I<@PATH>, B<--sbat=>I<TEXT>B<|>I<@PATH>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"SBAT metadata associated with the UKI or addon\\&. SBAT policies are useful "
"to revoke whole groups of UKIs or addons with a single, static policy update "
"that does not take space in DBX/MOKX\\&. If not specified manually, a "
"default metadata entry consisting of \"uki,1,UKI,uki,1,https://www\\&."
"freedesktop\\&.org/software/systemd/man/systemd-stub\\&.html\" will be used, "
"to ensure it is always possible to revoke UKIs and addons\\&. For more "
"information on SBAT see \\m[blue]B<Shim "
"documentation>\\m[]\\&\\s-2\\u[2]\\d\\s+2\\&."
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "[PCRSignature:I<NAME>R<] section>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"In the config file, those options are grouped by section\\&. On the command "
"line, they must be specified in the same order\\&. The sections specified in "
"both sources are combined\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<PCRPrivateKey=>I<PATH>, B<--pcr-private-key=>I<PATH>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"A private key to use for signing PCR policies\\&. On the command line, this "
"option may be specified more than once, in which case multiple signatures "
"will be made\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<PCRPublicKey=>I<PATH>, B<--pcr-public-key=>I<PATH>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "A public key to use for signing PCR policies\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"On the command line, this option may be specified more than once, similarly "
"to the B<--pcr-private-key=> option\\&. If not present, the public keys will "
"be extracted from the private keys\\&. On the command line, if present, this "
"option must be specified the same number of times as the B<--pcr-private-"
"key=> option\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "I<Phases=>I<LIST>, B<--phases=>I<LIST>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"A comma or space-separated list of colon-separated phase paths to sign a "
"policy for\\&. Each set of boot phase paths will be signed with the "
"corresponding private key\\&. If not present, the default of B<systemd-"
"measure>(1)  will be used\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"On the command line, when this argument is present, it must appear the same "
"number of times as the B<--pcr-private-key=> option\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "EXAMPLES"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "B<Example\\ \\&1.\\ \\&Minimal invocation>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid ""
"$ ukify build \\e\n"
"      --linux=/lib/modules/6\\&.0\\&.9-300\\&.fc37\\&.x86_64/vmlinuz \\e\n"
"      --initrd=/some/path/initramfs-6\\&.0\\&.9-300\\&.fc37\\&.x86_64\\&.img \\e\n"
"      --cmdline=\\*(Aqquiet rw\\*(Aq\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "This creates an unsigned UKI \\&./vmlinuz\\&.unsigned\\&.efi\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "B<Example\\ \\&2.\\ \\&All the bells and whistles>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid ""
"$ ukify build \\e\n"
"      --linux=/lib/modules/6\\&.0\\&.9-300\\&.fc37\\&.x86_64/vmlinuz \\e\n"
"      --initrd=early_cpio \\e\n"
"      --initrd=/some/path/initramfs-6\\&.0\\&.9-300\\&.fc37\\&.x86_64\\&.img \\e\n"
"      --sbat=\\*(Aqsbat,1,SBAT Version,sbat,1,https://github\\&.com/rhboot/shim/blob/main/SBAT\\&.md\n"
"      uki\\&.author\\&.myimage,1,UKI for System,uki\\&.author\\&.myimage,1,https://www\\&.freedesktop\\&.org/software/systemd/man/systemd-stub\\&.html\\*(Aq \\e\n"
"      --pcr-private-key=pcr-private-initrd-key\\&.pem \\e\n"
"      --pcr-public-key=pcr-public-initrd-key\\&.pem \\e\n"
"      --phases=\\*(Aqenter-initrd\\*(Aq \\e\n"
"      --pcr-private-key=pcr-private-system-key\\&.pem \\e\n"
"      --pcr-public-key=pcr-public-system-key\\&.pem \\e\n"
"      --phases=\\*(Aqenter-initrd:leave-initrd enter-initrd:leave-initrd:sysinit \\e\n"
"                enter-initrd:leave-initrd:sysinit:ready\\*(Aq \\e\n"
"      --pcr-banks=sha384,sha512 \\e\n"
"      --secureboot-private-key=sb\\&.key \\e\n"
"      --secureboot-certificate=sb\\&.cert \\e\n"
"      --sign-kernel \\e\n"
"      --cmdline=\\*(Aqquiet rw rhgb\\*(Aq\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"This creates a signed UKI \\&./vmlinuz\\&.signed\\&.efi\\&. The initrd "
"section contains two concatenated parts, early_cpio and "
"initramfs-6\\&.0\\&.9-300\\&.fc37\\&.x86_64\\&.img\\&. The policy embedded "
"in the \"\\&.pcrsig\" section will be signed for the initrd (the B<enter-"
"initrd> phase) with the key pcr-private-initrd-key\\&.pem, and for the main "
"system (phases B<leave-initrd>, B<sysinit>, B<ready>) with the key pcr-"
"private-system-key\\&.pem\\&. The Linux binary and the resulting combined "
"image will be signed with the SecureBoot key sb\\&.key\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "B<Example\\ \\&3.\\ \\&All the bells and whistles, via a config file>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"This is the same as the previous example, but this time the configuration is "
"stored in a file:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid ""
"$ cat ukify\\&.conf\n"
"[UKI]\n"
"Initrd=early_cpio\n"
"Cmdline=quiet rw rhgb\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid ""
"SecureBootPrivateKey=sb\\&.key\n"
"SecureBootCertificate=sb\\&.cert\n"
"SignKernel=yes\n"
"PCRBanks=sha384,sha512\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid ""
"[PCRSignature:initrd]\n"
"PCRPrivateKey=pcr-private-initrd-key\\&.pem\n"
"PCRPublicKey=pcr-public-initrd-key\\&.pem\n"
"Phases=enter-initrd\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid ""
"[PCRSignature:system]\n"
"PCRPrivateKey=pcr-private-system-key\\&.pem\n"
"PCRPublicKey=pcr-public-system-key\\&.pem\n"
"Phases=enter-initrd:leave-initrd\n"
"       enter-initrd:leave-initrd:sysinit\n"
"       enter-initrd:leave-initrd:sysinit:ready\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid ""
"$ ukify -c ukify\\&.conf build \\e\n"
"        --linux=/lib/modules/6\\&.0\\&.9-300\\&.fc37\\&.x86_64/vmlinuz \\e\n"
"        --initrd=/some/path/initramfs-6\\&.0\\&.9-300\\&.fc37\\&.x86_64\\&.img\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"One \"initrd\" (early_cpio) is specified in the config file, and the other "
"initrd (initramfs-6\\&.0\\&.9-300\\&.fc37\\&.x86_64\\&.img) is specified on "
"the command line\\&. This may be useful for example when the first initrd "
"contains microcode for the CPU and does not need to be updated when the "
"kernel version changes, unlike the actual initrd\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "B<Example\\ \\&4.\\ \\&Kernel command line auxiliary PE>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid ""
"ukify build \\e\n"
"      --secureboot-private-key=sb\\&.key \\e\n"
"      --secureboot-certificate=sb\\&.cert \\e\n"
"      --cmdline=\\*(Aqdebug\\*(Aq \\e\n"
"      --sbat=\\*(Aqsbat,1,SBAT Version,sbat,1,https://github\\&.com/rhboot/shim/blob/main/SBAT\\&.md\n"
"      uki\\&.addon\\&.author,1,UKI Addon for System,uki\\&.addon\\&.author,1,https://www\\&.freedesktop\\&.org/software/systemd/man/systemd-stub\\&.html\\*(Aq\n"
"      --output=debug\\&.cmdline\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"This creates a signed PE binary that contains the additional kernel command "
"line parameter \"debug\" with SBAT metadata referring to the owner of the "
"addon\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"B<Example\\ \\&5.\\ \\&Decide signing policy and create certificate and keys>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"First, let\\*(Aqs create an config file that specifies what signatures shall "
"be made:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid ""
"# cat E<gt>/etc/kernel/uki\\&.conf E<lt>E<lt>EOF\n"
"[UKI]\n"
"SecureBootPrivateKey=/etc/kernel/secure-boot\\&.key\\&.pem\n"
"SecureBootCertificate=/etc/kernel/secure-boot\\&.cert\\&.pem\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid ""
"[PCRSignature:initrd]\n"
"Phases=enter-initrd\n"
"PCRPrivateKey=/etc/kernel/pcr-initrd\\&.key\\&.pem\n"
"PCRPublicKey=/etc/kernel/pcr-initrd\\&.pub\\&.pem\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid ""
"[PCRSignature:system]\n"
"Phases=enter-initrd:leave-initrd enter-initrd:leave-initrd:sysinit\n"
"       enter-initrd:leave-initrd:sysinit:ready\n"
"PCRPrivateKey=/etc/kernel/pcr-system\\&.key\\&.pem\n"
"PCRPublicKey=/etc/kernel/pcr-system\\&.pub\\&.pem\n"
"EOF\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "Next, we can generate the certificate and keys:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid ""
"# ukify genkey --config=/etc/kernel/uki\\&.conf\n"
"Writing SecureBoot private key to /etc/kernel/secure-boot\\&.key\\&.pem\n"
"Writing SecureBoot certificate to /etc/kernel/secure-boot\\&.cert\\&.pem\n"
"Writing private key for PCR signing to /etc/kernel/pcr-initrd\\&.key\\&.pem\n"
"Writing public key for PCR signing to /etc/kernel/pcr-initrd\\&.pub\\&.pem\n"
"Writing private key for PCR signing to /etc/kernel/pcr-system\\&.key\\&.pem\n"
"Writing public key for PCR signing to /etc/kernel/pcr-system\\&.pub\\&.pem\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"(Both operations need to be done as root to allow write access to /etc/"
"kernel/\\&.)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"Subsequent invocations using the config file (B<ukify build --config=/etc/"
"kernel/uki\\&.conf>) will use this certificate and key files\\&. Note that "
"the B<kernel-install>(8)  plugin 60-ukify\\&.install uses /etc/kernel/uki\\&."
"conf by default, so after this file has been created, installations of "
"kernels that create a UKI on the local machine using B<kernel-install> will "
"perform signing using this config\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid ""
"B<systemd>(1), B<systemd-stub>(7), B<systemd-boot>(7), B<systemd-"
"measure>(1), B<systemd-pcrphase.service>(8)"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "NOTES"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid " 1."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "Unified Kernel Image (UKI)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "\\%https://uapi-group.org/specifications/specs/unified_kernel_image/"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid " 2."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Shim documentation"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-tumbleweed
msgid "\\%https://github.com/rhboot/shim/blob/main/SBAT.md"
msgstr ""

#. type: TH
#: debian-bookworm opensuse-tumbleweed
#, no-wrap
msgid "systemd 254"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid "B</usr/lib/systemd/ukify> [OPTIONS...] build"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid ""
"Note: this command is experimental for now\\&. While it is intended to "
"become a regular component of systemd, it might still change in behaviour "
"and interface\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid ""
"If the stub and/or the kernel contain \"\\&.sbat\" sections they will be "
"merged in the UKI so that revocation updates affecting either are considered "
"when the UKI is loaded by Shim\\&. For more information on SBAT see "
"\\m[blue]B<Shim\\*(Aqs documentation\\&.>\\m[]\\&\\s-2\\u[2]\\d\\s+2"
msgstr ""

#. type: SS
#: debian-bookworm opensuse-tumbleweed
#, no-wrap
msgid "Commandline-only options"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid ""
"Load configuration from the given config file\\&. In general, settings "
"specified in the config file have lower precedence than the settings "
"specified via options\\&. In cases where the commandline option does not "
"fully override the config file setting are explicitly mentioned in the "
"descriptions of individual options\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid "B<--section=>I<NAME>B<:>I<TEXT>B<|>I<@PATH>"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid ""
"Specify an arbitrary additional section \"I<NAME>\"\\&. Note that the name "
"is used as-is, and if the section name should start with a dot, it must be "
"included in I<NAME>\\&. The argument may be a literal string, or \"@\" "
"followed by a path name\\&. This option may be specified more than once\\&. "
"Any sections specified in this fashion will be inserted (in order) before "
"the \"\\&.linux\" section which is always last\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid ""
"Print a summary of loaded config and exit\\&. This is useful to check how "
"the options form the configuration file and the commandline are combined\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid ""
"SBAT metadata associated with the UKI or addon\\&. SBAT policies are useful "
"to revoke whole groups of UKIs or addons with a single, static policy update "
"that does not take space in DBX/MOKX\\&. If not specified manually, a "
"default metadata entry consisting of \"uki,1,UKI,uki,1,https://www\\&."
"freedesktop\\&.org/software/systemd/man/systemd-stub\\&.html\" will be used, "
"to ensure it is always possible to revoke UKIs and addons\\&. For more "
"information on SBAT see \\m[blue]B<Shim\\*(Aqs documentation\\&."
">\\m[]\\&\\s-2\\u[2]\\d\\s+2"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid ""
"In the config file, those options are grouped by section\\&. On the "
"commandline, they must be specified in the same order\\&. The sections "
"specified in both sources are combined\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid ""
"A private key to use for signing PCR policies\\&. On the commandline, this "
"option may be specified more than once, in which case multiple signatures "
"will be made\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid ""
"On the commandline, this option may be specified more than once, similarly "
"to the B<--pcr-private-key=> option\\&. If not present, the public keys will "
"be extracted from the private keys\\&. On the commandline, if present, the "
"this option must be specified the same number of times as the B<--pcr-"
"private-key=> option\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid ""
"On the commandline, when this argument is present, it must appear the same "
"number of times as the B<--pcr-private-key=> option\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
#, no-wrap
msgid ""
"$ /usr/lib/systemd/ukify build \\e\n"
"      --linux=/lib/modules/6\\&.0\\&.9-300\\&.fc37\\&.x86_64/vmlinuz \\e\n"
"      --initrd=early_cpio \\e\n"
"      --initrd=/some/path/initramfs-6\\&.0\\&.9-300\\&.fc37\\&.x86_64\\&.img \\e\n"
"      --sbat=\\*(Aqsbat,1,SBAT Version,sbat,1,https://github\\&.com/rhboot/shim/blob/main/SBAT\\&.md\n"
"      uki\\&.author\\&.myimage,1,UKI for System,uki\\&.author\\&.myimage,1,https://www\\&.freedesktop\\&.org/software/systemd/man/systemd-stub\\&.html\\*(Aq \\e\n"
"      --pcr-private-key=pcr-private-initrd-key\\&.pem \\e\n"
"      --pcr-public-key=pcr-public-initrd-key\\&.pem \\e\n"
"      --phases=\\*(Aqenter-initrd\\*(Aq \\e\n"
"      --pcr-private-key=pcr-private-system-key\\&.pem \\e\n"
"      --pcr-public-key=pcr-public-system-key\\&.pem \\e\n"
"      --phases=\\*(Aqenter-initrd:leave-initrd enter-initrd:leave-initrd:sysinit \\e\n"
"                enter-initrd:leave-initrd:sysinit:ready\\*(Aq \\e\n"
"      --pcr-banks=sha384,sha512 \\e\n"
"      --secureboot-private-key=sb\\&.key \\e\n"
"      --secureboot-certificate=sb\\&.cert \\e\n"
"      --sign-kernel \\e\n"
"      --cmdline=\\*(Aqquiet rw rhgb\\*(Aq\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
#, no-wrap
msgid ""
"$ /usr/lib/systemd/ukify -c ukify\\&.conf build \\e\n"
"        --linux=/lib/modules/6\\&.0\\&.9-300\\&.fc37\\&.x86_64/vmlinuz \\e\n"
"        --initrd=/some/path/initramfs-6\\&.0\\&.9-300\\&.fc37\\&.x86_64\\&.img\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid ""
"One \"initrd\" (early_cpio) is specified in the config file, and the other "
"initrd (initramfs-6\\&.0\\&.9-300\\&.fc37\\&.x86_64\\&.img) is specified on "
"the commandline\\&. This may be useful for example when the first initrd "
"contains microcode for the CPU and does not need to be updated when the "
"kernel version changes, unlike the actual initrd\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
#, no-wrap
msgid ""
"# /usr/lib/systemd/ukify genkey --config=/etc/kernel/uki\\&.conf\n"
"Writing SecureBoot private key to /etc/kernel/secure-boot\\&.key\\&.pem\n"
"Writing SecureBoot certificate to /etc/kernel/secure-boot\\&.cert\\&.pem\n"
"Writing private key for PCR signing to /etc/kernel/pcr-initrd\\&.key\\&.pem\n"
"Writing public key for PCR signing to /etc/kernel/pcr-initrd\\&.pub\\&.pem\n"
"Writing private key for PCR signing to /etc/kernel/pcr-system\\&.key\\&.pem\n"
"Writing public key for PCR signing to /etc/kernel/pcr-system\\&.pub\\&.pem\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid ""
"Subsequent invocations of using the config file (B</usr/lib/systemd/ukify "
"build --config=/etc/kernel/uki\\&.conf>) will use this certificate and key "
"files\\&. Note that the B<kernel-install>(8)  plugin 60-ukify\\&.install "
"uses /etc/kernel/uki\\&.conf by default, so after this file has been "
"created, installations of kernels that create a UKI on the local machine "
"using B<kernel-install> would perform signing using this config\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-tumbleweed
msgid "Shim's documentation."
msgstr ""