# 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-06-01 06:28+0200\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 #, no-wrap msgid "SYSTEMD-REPART" msgstr "" #. type: TH #: archlinux fedora-40 mageia-cauldron #, no-wrap msgid "systemd 255" msgstr "" #. type: TH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron #, no-wrap msgid "systemd-repart" msgstr "" #. ----------------------------------------------------------------- #. * MAIN CONTENT STARTS HERE * #. ----------------------------------------------------------------- #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "systemd-repart, systemd-repart.service - Automatically grow and add " "partitions" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B [OPTIONS...] [I<[BLOCKDEVICE]>...]" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "systemd-repart\\&.service" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "B grows and adds partitions to a partition table, based on " "the configuration files described in B(5)\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "If invoked with no arguments, it operates on the block device backing the " "root file system partition of the running OS, thus growing and adding " "partitions of the booted OS image itself\\&. If I<--image=> is used it will " "operate on the specified image file\\&. When called in the initrd it " "operates on the block device backing /sysroot/ instead, i\\&.e\\&. on the " "block device the system will soon transition into\\&. The systemd-repart\\&." "service service is generally run at boot in the initrd, in order to augment " "the partition table of the OS before its partitions are mounted\\&. " "B (mostly) operates in a purely incremental mode: it only " "grows existing and adds new partitions; it does not shrink, delete or move " "existing partitions\\&. The service is intended to be run on every boot, but " "when it detects that the partition table already matches the installed " "repart\\&.d/*\\&.conf configuration files, it executes no operation\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "B is intended to be used when deploying OS images, to " "automatically adjust them to the system they are running on, during first " "boot\\&. This way the deployed image can be minimal in size and may be " "augmented automatically at boot when needed, taking possession of disk space " "available but not yet used\\&. Specifically the following use cases are " "among those covered:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "The root partition may be grown to cover the whole available disk space\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "A /home/, swap or /srv/ partition can be added\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "A second (or third, \\&...) root partition may be added, to cover A/B style " "setups where a second version of the root file system is alternatingly used " "for implementing update schemes\\&. The deployed image would carry only a " "single partition (\"A\") but on first boot a second partition (\"B\") for " "this purpose is automatically created\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "The algorithm executed by B is roughly as follows:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "The repart\\&.d/*\\&.conf configuration files are loaded and parsed, and " "ordered by filename (without the directory prefix)\\&. For each " "configuration file, drop-in files are looked for in directories with same " "name as the configuration file with a suffix \"\\&.d\" added\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "The partition table already existing on the block device is loaded and " "parsed\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "The existing partitions in the partition table are matched up with the " "repart\\&.d/*\\&.conf files by GPT partition type UUID\\&. The first " "existing partition of a specific type is assigned the first configuration " "file declaring the same type\\&. The second existing partition of a specific " "type is then assigned the second configuration file declaring the same type, " "and so on\\&. After this iterative assigning is complete any left-over " "existing partitions that have no matching configuration file are considered " "\"foreign\" and left as they are\\&. And any configuration files for which " "no partition currently exists are understood as a request to create such a " "partition\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Partitions that shall be created are now allocated on the disk, taking the " "size constraints and weights declared in the configuration files into " "account\\&. Free space is used within the limits set by size and padding " "requests\\&. In addition, existing partitions that should be grown are " "grown\\&. New partitions are always appended to the end of the partition " "table, taking the first partition table slot whose index is greater than the " "indexes of all existing partitions\\&. Partitions are never reordered and " "thus partition numbers remain stable\\&. When partitions are created, they " "are placed in the smallest area of free space that is large enough to " "satisfy the size and padding limits\\&. This means that partitions might " "have different order on disk than in the partition table\\&. Note that this " "allocation happens in memory only, the partition table on disk is not " "updated yet\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "All existing partitions for which configuration files exist and which " "currently have no GPT partition label set will be assigned a label, either " "explicitly configured in the configuration or \\(em if that\\*(Aqs missing " "\\(em derived automatically from the partition type\\&. The same is done for " "all partitions that are newly created\\&. These assignments are done in " "memory only, too, the disk is not updated yet\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Similarly, all existing partitions for which configuration files exist and " "which currently have an all-zero identifying UUID will be assigned a new " "UUID\\&. This UUID is cryptographically hashed from a common seed value " "together with the partition type UUID (and a counter in case multiple " "partitions of the same type are defined), see below\\&. The same is done for " "all partitions that are created anew\\&. These assignments are done in " "memory only, too, the disk is not updated yet\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Similarly, if the disk\\*(Aqs volume UUID is all zeroes it is also " "initialized, also cryptographically hashed from the same common seed " "value\\&. This is done in memory only too\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "The disk space assigned to new partitions (i\\&.e\\&. what was previously " "free space) is now erased\\&. Specifically, all file system signatures are " "removed, and if the device supports it, the B I/O control " "command is issued to inform the hardware that the space is now empty\\&. In " "addition any \"padding\" between partitions and at the end of the device is " "similarly erased\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "The new partition table is finally written to disk\\&. The kernel is asked " "to reread the partition table\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "As exception to the normally strictly incremental operation, when called in " "a special \"factory reset\" mode, B may also be used to " "erase existing partitions to reset an installation back to vendor " "defaults\\&. This mode of operation is used when either the B<--factory-" "reset=yes> switch is passed on the tool\\*(Aqs command line, or the " "B option specified on the kernel command line, " "or the I EFI variable (vendor UUID " "B<8cf2644b-4b0b-428f-9387-6d876050dc67>) is set to \"yes\"\\&. It alters the " "algorithm above slightly: between the 3rd and the 4th step above any " "partition marked explicitly via the I boolean is deleted, and " "the algorithm restarted, thus immediately re-creating these partitions anew " "empty\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "Note that B by default only changes partition tables, it " "does not create or resize any file systems within these partitions, unless " "the I configuration option is specified\\&. Also note that there " "are also separate mechanisms available for this purpose, for example " "B(8) and B\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "The UUIDs identifying the new partitions created (or assigned to existing " "partitions that have no UUID yet), as well as the disk as a whole are hashed " "cryptographically from a common seed value\\&. This seed value is usually " "the B(5) of the system, so that the machine ID reproducibly " "determines the UUIDs assigned to all partitions\\&. If the machine ID cannot " "be read (or the user passes B<--seed=random>, see below) the seed is " "generated randomly instead, so that the partition UUIDs are also effectively " "random\\&. The seed value may also be set explicitly, formatted as UUID via " "the B<--seed=> option\\&. By hashing these UUIDs from a common seed images " "prepared with this tool become reproducible and the result of the algorithm " "above deterministic\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "The positional argument should specify the block device to operate on\\&. " "Instead of a block device node path a regular file may be specified too, in " "which case the command operates on it like it would if a loopback block " "device node was specified with the file attached\\&. If B<--empty=create> is " "specified the specified path is created as regular file, which is useful for " "generating disk images from scratch\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron #, no-wrap msgid "OPTIONS" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "The following options are understood:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--dry-run=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes a boolean\\&. If this switch is not specified B<--dry-run=yes> is the " "implied default\\&. Controls whether systemd-repart executes the requested " "re-partition operations or whether it should only show what it would do\\&. " "Unless B<--dry-run=no> is specified systemd-repart will not actually touch " "the device\\*(Aqs partition table\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 245\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--empty=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes one of \"refuse\", \"allow\", \"require\", \"force\" or \"create\"\\&. " "Controls how to operate on block devices that are entirely empty, i\\&.e\\&. " "carry no partition table/disk label yet\\&. If this switch is not specified " "the implied default is \"refuse\"\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "If \"refuse\" B requires that the block device it shall " "operate on already carries a partition table and refuses operation if none " "is found\\&. If \"allow\" the command will extend an existing partition " "table or create a new one if none exists\\&. If \"require\" the command will " "create a new partition table if none exists so far, and refuse operation if " "one already exists\\&. If \"force\" it will create a fresh partition table " "unconditionally, erasing the disk fully in effect\\&. If \"force\" no " "existing partitions will be taken into account or survive the operation\\&. " "Hence: use with care, this is a great way to lose all your data\\&. If " "\"create\" a new loopback file is create under the path passed via the " "device node parameter, of the size indicated with B<--size=>, see below\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--discard=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes a boolean\\&. If this switch is not specified B<--discard=yes> is the " "implied default\\&. Controls whether to issue the B I/O control " "command on the space taken up by any added partitions or on the space in " "between them\\&. Usually, it\\*(Aqs a good idea to issue this request since " "it tells the underlying hardware that the covered blocks shall be considered " "empty, improving performance\\&. If operating on a regular file instead of a " "block device node, a sparse file is generated\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--size=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes a size in bytes, using the usual K, M, G, T suffixes, or the special " "value \"auto\"\\&. If used the specified device node path must refer to a " "regular file, which is then grown to the specified size if smaller, before " "any change is made to the partition table\\&. If specified as \"auto\" the " "minimal size for the disk image is automatically determined (i\\&.e\\&. the " "minimal sizes of all partitions are summed up, taking space for additional " "metadata into account)\\&. This switch is not supported if the specified " "node is a block device\\&. This switch has no effect if the file is already " "as large as the specified size or larger\\&. The specified size is " "implicitly rounded up to multiples of 4096\\&. When used with B<--" "empty=create> this specifies the initial size of the loopback file to " "create\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "The B<--size=auto> option takes the sizes of pre-existing partitions into " "account\\&. However, it does not accommodate for partition tables that are " "not tightly packed: the configured partitions might still not fit into the " "backing device if empty space exists between pre-existing partitions (or " "before the first partition) that cannot be fully filled by partitions to " "grow or create\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Also note that the automatic size determination does not take files or " "directories specified with B into account: operation might fail " "if the specified files or directories require more disk space then the " "configured per-partition minimal size limit\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 246\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--factory-reset=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes boolean\\&. If this switch is not specified B<--factory=reset=no> is " "the implied default\\&. Controls whether to operate in \"factory reset\" " "mode, see above\\&. If set to true this will remove all existing partitions " "marked with I set to yes early while executing the re-" "partitioning algorithm\\&. Use with care, this is a great way to lose all " "your data\\&. Note that partition files need to explicitly turn " "I on, as the option defaults to off\\&. If no partitions are " "marked for factory reset this switch has no effect\\&. Note that there are " "two other methods to request factory reset operation: via the kernel command " "line and via an EFI variable, see above\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--can-factory-reset>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "If this switch is specified the disk is not re-partitioned\\&. Instead it is " "determined if any existing partitions are marked with I\\&. " "If there are the tool will exit with exit status zero, otherwise non-" "zero\\&. This switch may be used to quickly determine whether the running " "system supports a factory reset mechanism built on B\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--root=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes a path to a directory to use as root file system when searching for " "repart\\&.d/*\\&.conf files, for the machine ID file to use as seed and for " "the I and I source files and directories\\&. By " "default when invoked on the regular system this defaults to the host\\*(Aqs " "root file system /\\&. If invoked from the initrd this defaults to /" "sysroot/, so that the tool operates on the configuration and machine ID " "stored in the root file system later transitioned into itself\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "See B<--copy-source=> for a more restricted option that only affects " "I\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--image=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes a path to a disk image file or device to mount and use in a similar " "fashion to B<--root=>, see above\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 249\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--image-policy=>I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes an image policy string as argument, as per B(7)\\&. The policy is enforced when operating on the disk image " "specified via B<--image=>, see above\\&. If not specified defaults to the " "\"*\" policy, i\\&.e\\&. all recognized file systems in the image are " "used\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--seed=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes a UUID as argument or the special value B\\&. If a UUID is " "specified the UUIDs to assign to partitions and the partition table itself " "are derived via cryptographic hashing from it\\&. If not specified it is " "attempted to read the machine ID from the host (or more precisely, the root " "directory configured via B<--root=>) and use it as seed instead, falling " "back to a randomized seed otherwise\\&. Use B<--seed=random> to force a " "randomized seed\\&. Explicitly specifying the seed may be used to generated " "strictly reproducible partition tables\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--pretty=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes a boolean argument\\&. If this switch is not specified, it defaults to " "on when called from an interactive terminal and off otherwise\\&. Controls " "whether to show a user friendly table and graphic illustrating the changes " "applied\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--definitions=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes a file system path\\&. If specified the *\\&.conf files are read from " "the specified directory instead of searching in /usr/lib/repart\\&.d/*\\&." "conf, /etc/repart\\&.d/*\\&.conf, /run/repart\\&.d/*\\&.conf\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "This parameter can be specified multiple times\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--key-file=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes a file system path\\&. Configures the encryption key to use when " "setting up LUKS2 volumes configured with the I setting in " "partition files\\&. Should refer to a regular file containing the key, or an " "B stream socket in the file system\\&. In the latter case a " "connection is made to it and the key read from it\\&. If this switch is not " "specified the empty key (i\\&.e\\&. zero length key) is used\\&. This " "behaviour is useful for setting up encrypted partitions during early first " "boot that receive their user-supplied password only in a later setup step\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 247\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--private-key=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes a file system path\\&. Configures the signing key to use when creating " "verity signature partitions with the I setting in " "partition files\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 252\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--certificate=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Takes a file system path\\&. Configures the PEM encoded X\\&.509 certificate " "to use when creating verity signature partitions with the " "I setting in partition files\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--tpm2-device=>, B<--tpm2-pcrs=>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Configures the TPM2 device and list of PCRs to use for LUKS2 volumes " "configured with the I option\\&. These options take the same " "parameters as the identically named options to B(1) " "and have the same effect on partitions where TPM2 enrollment is requested\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 248\\&." msgstr "" #. type: Plain text #: archlinux fedora-40 mageia-cauldron msgid "B<--tpm2-device-key=> [PATH], B<--tpm2-seal-key-handle=> [HANDLE]" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "Configures a TPM2 SRK key to bind encryption to\\&. See B(1) for details on this option\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 255\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm fedora-40 mageia-cauldron msgid "B<--tpm2-public-key=> [PATH], B<--tpm2-public-key-pcrs=> [PCR...]" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Configures a TPM2 signed PCR policy to bind encryption to\\&. See B(1) for details on these two options\\&." msgstr "" #. type: Plain text #: archlinux fedora-40 mageia-cauldron msgid "B<--tpm2-pcrlock=> [PATH]" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "Configures a TPM2 pcrlock policy to bind encryption to\\&. See B(1) for details on this option\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm fedora-40 mageia-cauldron msgid "B<--split=> [BOOL]" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Enables generation of split artifacts from partitions configured with " "I\\&. If enabled, for each partition with I set, a " "separate output file containing just the contents of that partition is " "generated\\&. The output filename consists of the loopback filename suffixed " "with the name configured with I\\&. If the loopback filename " "ends with \"\\&.raw\", the suffix is inserted before the \"\\&.raw\" " "extension instead\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Note that B<--split> is independent from B<--dry-run>\\&. Even if B<--dry-" "run> is enabled, split artifacts will still be generated from an existing " "image if B<--split> is enabled\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm fedora-40 mageia-cauldron msgid "" "B<--include-partitions=> [PARTITION...], B<--exclude-partitions=> " "[PARTITION...]" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "These options specify which partition types B should operate " "on\\&. If B<--include-partitions=> is used, all partitions that aren\\*(Aqt " "specified are excluded\\&. If B<--exclude-partitions=> is used, all " "partitions that are specified are excluded\\&. Both options take a comma " "separated list of GPT partition type UUIDs or identifiers (see I in " "B(5))\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "Added in version 253\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm fedora-40 mageia-cauldron msgid "B<--defer-partitions=> [PARTITION...]" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "This option specifies for which partition types B should " "defer\\&. All partitions that are deferred using this option are still taken " "into account when calculating the sizes and offsets of other partitions, but " "aren\\*(Aqt actually written to the disk image\\&. The net effect of this " "option is that if you run B again without this option, the " "missing partitions will be added as if they had not been deferred the first " "time B was executed\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm fedora-40 mageia-cauldron msgid "B<--sector-size=> [BYTES]" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "This option allows configuring the sector size of the image produced by " "B\\&. It takes a value that is a power of \"2\" between " "\"512\" and \"4096\"\\&. This option is useful when building images for " "disks that use a different sector size as the disk on which the image is " "produced\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm fedora-40 mageia-cauldron msgid "B<--architecture=> [ARCH]" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "This option allows overriding the architecture used for architecture " "specific partition types\\&. For example, if set to \"arm64\" a partition " "type of \"root-x86-64\" referenced in repart\\&.d/ drop-ins will be patched " "dynamically to refer to \"root-arm64\" instead\\&. Takes one of \"alpha\", " "\"arc\", \"arm\", \"arm64\", \"ia64\", \"loongarch64\", \"mips-le\", " "\"mips64-le\", \"parisc\", \"ppc\", \"ppc64\", \"ppc64-le\", \"riscv32\", " "\"riscv64\", \"s390\", \"s390x\", \"tilegx\", \"x86\" or \"x86-64\"\\&." 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 fedora-40 mageia-cauldron msgid "B<--offline=> [BOOL]" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Instructs B to build the image offline\\&. Takes a boolean " "or \"auto\"\\&. Defaults to \"auto\"\\&. If enabled, the image is built " "without using loop devices\\&. This is useful to build images unprivileged " "or when loop devices are not available\\&. If disabled, the image is always " "built using loop devices\\&. If \"auto\", B will build the " "image online if possible and fall back to building the image offline if loop " "devices are not available or cannot be accessed due to missing " "permissions\\&." msgstr "" #. type: Plain text #: archlinux fedora-40 mageia-cauldron msgid "B<--copy-from=> [IMAGE]" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "Instructs B to synthesize partition definitions from the " "partition table in the given image\\&. This option can be specified multiple " "times to synthesize definitions from each of the given images\\&. The " "generated definitions will copy the partitions into the destination " "partition table\\&. The copied partitions will have the same size, metadata " "and contents but might have a different partition number and might be " "located at a different offset in the destination partition table\\&. These " "definitions can be combined with partition definitions read from regular " "partition definition files\\&. The synthesized definitions take precedence " "over the definitions read from partition definition files\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "B<--copy-source=>I, B<-s> I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "Specifies a source directory all I source paths shall be " "considered relative to\\&. This is similar to B<--root=>, but exclusively " "applies to the I setting\\&. If B<--root=> and B<--copy-source=> " "are used in combination the former applies as usual, except for " "I where the latter takes precedence\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "B<--make-ddi=>I" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "Takes one of \"sysext\", \"confext\" or \"portable\"\\&. Generates a " "Discoverable Disk Image (DDI) for a system extension (sysext, see B(8) for details), configuration extension (confext) or " "\\m[blue]B\\m[]\\&\\s-2\\u[1]\\d\\s+2\\&. The generated " "image will consist of a signed Verity \"erofs\" file system as root " "partition\\&. In this mode of operation the partition definitions in /usr/" "lib/repart\\&.d/*\\&.conf and related directories are not read, and B<--" "definitions=> is not supported, as appropriate definitions for the selected " "DDI class will be chosen automatically\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "Must be used in conjunction with B<--copy-source=> to specify the file " "hierarchy to populate the DDI with\\&. The specified directory should " "contain an etc/ subdirectory if \"confext\" is selected\\&. If \"sysext\" is " "selected it should contain either a usr/ or opt/ directory, or both\\&. If " "\"portable\" is used a full OS file hierarchy can be provided\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "This option implies B<--empty=create>, B<--size=auto> and B<--seed=random> " "(the latter two can be overridden)\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "The private key and certificate for signing the DDI must be specified via " "the B<--private-key=> and B<--certificate=> switches\\&." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "B<-S>, B<-C>, B<-P>" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "Shortcuts for B<--make-ddi=sysext>, B<--make-ddi=confext>, B<--make-" "ddi=portable>, respectively\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<-h>, B<--help>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "Print a short help text and exit\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--version>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "Print a short version string and exit\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--no-pager>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "Do not pipe output into a pager\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--no-legend>" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Do not print the legend, i\\&.e\\&. column headers and the footer with " "hints\\&." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "B<--json=>I" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "" "Shows output formatted as JSON\\&. Expects one of \"short\" (for the " "shortest possible output without any redundant whitespace or line breaks), " "\"pretty\" (for a pretty version of the same, with indentation and line " "breaks) or \"off\" (to turn off JSON output, the default)\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron #, no-wrap msgid "EXIT STATUS" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron msgid "On success, 0 is returned, a non-zero failure code otherwise\\&." msgstr "" #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "EXAMPLE" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-rawhide mageia-cauldron msgid "" "The following creates a configuration extension DDI (confext) for an /etc/" "motd update:" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "" "mkdir tree tree/etc tree/etc/extension-release\\&.d\n" "echo \"Hello World\" E tree/etc/motd\n" "cat E tree/etc/extension-release\\&.d/extension-release\\&.my-motd EEEOF\n" "ID=fedora\n" "VERSION_ID=38\n" "IMAGE_ID=my-motd\n" "IMAGE_VERSION=7\n" "EOF\n" "systemd-repart -C --private-key=privkey\\&.pem --certificate=cert\\&.crt -s tree/ /var/lib/confexts/my-motd\\&.confext\\&.raw\n" "systemd-confext refresh\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "The DDI generated that way may be applied to the system with B(1)\\&." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "" "B(1), B(5), B(5), B(1), " "B(1), B(8)" msgstr "" #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "NOTES" msgstr "" #. type: IP #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid " 1." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "portable service" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron msgid "\\%https://systemd.io/PORTABLE_SERVICES" msgstr "" #. type: TH #: debian-bookworm #, no-wrap msgid "systemd 254" msgstr "" #. type: Plain text #: debian-bookworm msgid "" "Note that B only changes partition tables, it does not " "create or resize any file systems within these partitions\\&. A separate " "mechanism should be used for that, for example B(8) and " "B\\&." msgstr "" #. type: Plain text #: debian-bookworm msgid "" "B(1), B(5), B(5), B(1)" msgstr "" #. type: TH #: debian-unstable fedora-rawhide #, no-wrap msgid "systemd 256~rc3" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "B<--private-key-source=>" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "" "Takes one of \"file\", \"engine\" or \"provider\"\\&. In the latter two " "cases, it is followed by the name of a provider or engine, separated by " "colon, that will be passed to OpenSSL\\*(Aqs \"engine\" or \"provider\" " "logic\\&. Configures the signing mechanism to use when creating verity " "signature partitions with the I setting in partition " "files\\&." msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "Added in version 256\\&." msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "B<--tpm2-device-key=>I, B<--tpm2-seal-key-handle=>I" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "" "B<--tpm2-public-key=>I, B<--tpm2-public-key-pcrs=>II<[+PCR\\&.\\&." "\\&.]>" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "B<--tpm2-pcrlock=>I" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "B<--split=>I" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "" "B<--include-partitions=>I, B<--exclude-partitions=>I" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "B<--defer-partitions=>I" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "B<--sector-size=>I" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "B<--architecture=>I" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "B<--offline=>I" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "B<--copy-from=>I" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "B<--generate-fstab=>I" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "" "Specifies a path where to write fstab entries for the mountpoints configured " "with B in the root directory specified with B<--copy-source=> " "or B<--root=> or in the host\\*(Aqs root directory if neither is " "specified\\&. Disabled by default\\&." msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "B<--generate-crypttab=>I" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "" "Specifies a path where to write crypttab entries for the encrypted volumes " "configured with B in the root directory specified with B<--" "copy-source=> or B<--root=> or in the host\\*(Aqs root directory if neither " "is specified\\&. Disabled by default\\&." msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "" "B" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "" "The following creates a system extension DDI (sysext) for an /usr/foo update " "and signs it with a hardware token via PKCS11\\&." msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide #, no-wrap msgid "" "mkdir tree tree/usr tree/usr/lib/extension-release\\&.d\n" "echo \"Hello World\" E tree/usr/foo\n" "cat E tree/usr/lib/extension-release\\&.d/extension-release\\&.my-foo EEEOF\n" "ID=fedora\n" "VERSION_ID=38\n" "IMAGE_ID=my-foo\n" "IMAGE_VERSION=7\n" "EOF\n" "systemd-repart --make-ddi=sysext --private-key-source=engine:pkcs11 --private-key=\"pkcs11:model=PKCS%2315%20emulated;manufacturer=piv_II;serial=0123456789abcdef;token=Some%20Cert\" --certificate=cert\\&.crt -s tree/ /var/lib/extensions/my-foo\\&.sysext\\&.raw\n" "systemd-sysext refresh\n" msgstr "" #. type: Plain text #: debian-unstable fedora-rawhide msgid "" "The DDI generated that way may be applied to the system with B(1)\\&." msgstr "" #. type: Plain text #: fedora-40 msgid "" "The following creates a configuration extension DDI (confext) for an /etc/" "motd update\\&." msgstr ""