summaryrefslogtreecommitdiffstats
path: root/man/systemd-repart.xml (follow)
Commit message (Collapse)AuthorAgeFilesLines
* man: asorted fixesYu Watanabe8 days1-6/+7
| | | | Closes #35307.
* man: fix incorrect volume numbers in internal man page referencesŠtěpán Němec2024-11-111-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Some ambiguity (e.g., same-named man pages in multiple volumes) makes it impossible to fully automate this, but the following Python snippet (run inside the man/ directory of the systemd repo) helped to generate the sed command lines (which were subsequently manually reviewed, run and the false positives reverted): from pathlib import Path import lxml from lxml import etree as ET man2vol: dict[str, str] = {} man2citerefs: dict[str, list] = {} for file in Path(".").glob("*.xml"): tree = ET.parse(file, lxml.etree.XMLParser(recover=True)) meta = tree.find("refmeta") if meta is not None: title = meta.findtext("refentrytitle") if title is not None: vol = meta.findtext("manvolnum") if vol is not None: man2vol[title] = vol citerefs = list(tree.iter("citerefentry")) if citerefs: man2citerefs[title] = citerefs for man, refs in man2citerefs.items(): for ref in refs: title = ref.findtext("refentrytitle") if title is not None: has = ref.findtext("manvolnum") try: should_have = man2vol[title] except KeyError: # Non-systemd man page reference? Ignore. continue if has != should_have: print( f"sed -i '\\|<citerefentry><refentrytitle>{title}" f"</refentrytitle><manvolnum>{has}</manvolnum>" f"</citerefentry>|s|<manvolnum>{has}</manvolnum>|" f"<manvolnum>{should_have}</manvolnum>|' {man}.xml" )
* tree-wide: Introduce --certificate-source= optionDaan De Meyer2024-11-071-7/+18
| | | | | | | This allows loading the X.509 certificate from an OpenSSL provider instead of a file system path. This allows loading certficates directly from hardware tokens instead of having to export them to a file on disk first.
* man/systemd-repart: extend description and reword some sentencesZbigniew Jędrzejewski-Szmek2024-07-221-54/+64
| | | | | | | | The page was written when systemd-repart was primarily intended to be used on a running system. But nowadays it's more often used to create images, so extend that part of the description. While at it, fix some whitespace issues and trim some overly complicated sentences.
* repart: add --list-devices switch for listing candidate block devicesLennart Poettering2024-07-011-1/+11
|
* man: fix incorrect XML in man pageSam Leonard2024-04-151-17/+17
|
* man: fix a few issues in manpagecunshunxia2024-03-201-1/+1
| | | | | | fix: #31482 Signed-off-by: cunshunxia <cunshunxia@tencent.com>
* repart: add --private-key-source and drop --private-key-uriLuca Boccassi2024-03-011-5/+7
| | | | | | | | | | | | It turns out it's mostly PKCS11 that supports the URI format, and other engines just take files. For example the tpm2-tss-openssl engine just takes a sealed private key file path as the key input, and the engine needs to be specified separately. Add --private-key-source=file|engine:foo|provider:bar to manually specify how to use the private key parameter. Follow-up for 0a8264080a5d4b5e13e65eed80ac98a476f7fe43
* repart: Add --generate-fstab= and --generate-crypttab= optionsDaan De Meyer2024-02-101-0/+22
| | | | | | | | | | | | These can be used along with two new settings MountPoint= and EncryptedVolume= to write fstab and crypttab entries to the given paths respectively in the root directory that repart is operating on. This is useful to cover scenarios that aren't covered by the Discoverable Partitions Spec. For example when one wants to mount /home as a separate btrfs subvolume. Because multiple btrfs subvolumes can be mounted from the same partition, we allow specifying MountPoint= multiple times to add multiple entries for the same partition.
* repart: support OpenSSL engines/providers for signingLuca Boccassi2024-02-091-0/+31
| | | | | | The provider API which is new requires providers, which are not widely available and don't work very well yet, so also use a fallback with the legacy engine API.
* man: fix markupDavid Tardon2023-12-261-13/+13
| | | | <arg> is not allowed inside <term>.
* man: use same version in public and system ident.David Tardon2023-12-251-1/+1
|
* man: use <simplelist> for 'See also' sectionsDavid Tardon2023-12-231-8/+8
| | | | | This is just a slight markup improvement; there should be no difference in rendering.
* repart: add --tpm2-device-key= to repart, tooLennart Poettering2023-11-091-0/+11
| | | | | | | This adds what was added to systemd-cryptenroll recently to systemd-repart too. Follow-up for: c3a2a681bed77ce4f9218cd28405994ab5263077
* man: document pcrlockLennart Poettering2023-11-031-0/+10
|
* man: fix typoYu Watanabe2023-10-061-1/+1
| | | | Follow-up for a121b331e37682341152b51269cf8ce00e68d755.
* repart: make it easy to generate DDIsLennart Poettering2023-10-051-1/+70
| | | | | | | | | | | This adds --make-ddi=confext, --make-ddi=sysext, --make-ddi=portable, to make it really easiy to generate DDIs of the specified class. It it's ultimately just a fancy wrapper around some defaults and in particular --definitions=. This makes it very easy to generate a confext: $ systemd-repart -C --private-key=privkey.pem --certificate=cert.crt -s mytree/ mytree.confext.raw
* repart: add new --copy-source= switchLennart Poettering2023-10-051-0/+16
| | | | | | | | | | | | | | | This specifies a directory to which CopyFiles= is considered relative. If unset defaults to the --root=/--image= setting, or host / otherwise. This is very similar to --root= but is much more focussed: it is really and exclusively about CopyFiles= (and related settings such as ExcludeFiles=) and does not affect any of the settings, i.e. it doesn't affect CopyBlocks=, the machine ID/seed handling, or where definitions are read from. In fact, --root= and --copy-source= may be combined for example to use the machine ID and similar from one tree, but the copy the files from another.
* man: add version infoAbderrahim Kitouni2023-08-291-23/+69
| | | | | | | | This tries to add information about when each option was added. It goes back to version 183. The version info is included from a separate file to allow generating it, which would allow more control on the formatting of the final output.
* man: systemd-repart can now create filesystems, update manpageLuca Boccassi2023-08-121-3/+4
|
* repart: Allow specifying --copy-from more than onceDaan De Meyer2023-08-111-6/+7
| | | | Definitions will be synthesized from each of the given images.
* repart: Reword --copy-from docsDaan De Meyer2023-08-101-3/+7
|
* repart: Add --copy-from optionDaan De Meyer2023-08-031-0/+8
| | | | | | | | --copy-from synthesizes partition definitions from the given image which are then applied to the repart algorithm. In its most basic form, this allows copying an image to another device but it can also be combined with --definitions to copy + add partitions in the same call to repart.
* Revert "repart: Add --oem and OEM="Daan De Meyer2023-08-011-8/+0
| | | | This reverts commit 47c7805579bd54f2c149c80b22caed6f71ea01a7.
* repart: Add --oem and OEM=Daan De Meyer2023-08-011-0/+8
| | | | | | | --oem can be used to only install OEM partitions (usr, verity, verity-sig, ...). OEM= is used to indicate OEM partitions. If unset, defaults to !FactoryReset. We also add a credential repart.oem to allow configuring --oem via a credential.
* Merge pull request #27926 from DaanDeMeyer/repart-offlineLuca Boccassi2023-06-051-0/+12
|\ | | | | repart: Add --offline argument
| * repart: Add --offline argumentDaan De Meyer2023-06-051-0/+12
| | | | | | | | | | This allows the user to explicit configure whether loop devices should be used to build the image or not.
* | man: parition → partition typo fixLennart Poettering2023-06-051-1/+1
|/ | | | Follow-up for: #27848
* Merge pull request #27844 from DaanDeMeyer/repart-archDaan De Meyer2023-05-311-0/+28
|\ | | | | repart: Add --architecture option
| * repart: Add --architecture optionDaan De Meyer2023-05-311-0/+28
| | | | | | | | | | | | | | This option allows overriding the architecture that's used for the architecture specific partition types. This is useful to allow reusing the same repart configuration to produce the same image for different architectures.
* | man/repart: document partition creation orderZbigniew Jędrzejewski-Szmek2023-05-301-9/+11
|/ | | | | | | | Fixes #22974. The text is reworded a bit too. In particular, it's "partitions" that are not reordered, not "partition table slots". If we were reordering things, we'd move the partitions between slots. The slots themselves are not moveable.
* man: fixes for assorted issues reported by the manpage-l10n projectZbigniew Jędrzejewski-Szmek2023-05-171-3/+3
| | | | Fixes #26761.
* man: document image policy syntax and semantics, and the hooks in the ↵Lennart Poettering2023-04-051-0/+2
| | | | various components
* repart: Allow configuring sector sizeDaan De Meyer2023-01-171-0/+9
| | | | | | Let's allow users to configure the (logical) sector size of their image. This is required when building images for a 4k sector size disk on a 512b sector size host or vice-versa.
* repart: Use "defer" in docs instead of "skip"Daan De Meyer2022-12-151-5/+5
|
* repart: Rename --skip-partitions to --defer-partitionsDaan De Meyer2022-12-141-1/+1
| | | | | Defer is better because it indicates that we still intend to populate these partitions later.
* repart: Add --skip-partitions=Daan De Meyer2022-11-251-5/+12
| | | | | | | | | | | | | | | | | | | --include-partitions and --exclude-partitions now fully exclude partitions from repart. Whenever a partition type is excluded, we don't take any partitions of that type into account at all when running systemd-repart. --skip-partitions= is introduced to do what --exclude-partitions did previously. Any skipped partitions are taken into acount when doing size calculations, but are not yet populated. Why do we need both concepts? Exclusion is needed so that we can use shared repart definitions to generate bootable and non-bootable images. When generating a non-bootable image, we use --exclude-partitions to exclude the ESP partition. Skipping is needed so that we can populate the root partition while skipping the ESP partition, get the roothash of the root partition, use that to generate a UKI, and finally populate the ESP partition with the UKI included.
* repart: Add --include/--exclude-partitionsDaan De Meyer2022-11-151-0/+17
| | | | | | | | | Let's allow filtering the partitions to operate on by partition type UUID. This is necessary when building bootable images with a verity protected root/usr partition as we can only build the UKI image when we have the verity roothash which means we cannot populate the EFI partition yet when we run repart initially to determine the verity roothash.
* Document two systemd-repart options in man pagePyfisch2022-10-141-0/+16
| | | | | | | Note --private-key and --certificate options for configuring verity signature partitions in the listing of options. Adjust one error message referring to the --certificate option.
* repart: Add --split option to generate split artifactsDaan De Meyer2022-09-221-0/+15
| | | | | | | | | | | | | | For use with sysupdate or other systemd tooling, it's useful to be able to generate split artifacts from disk images, where each partition is written to a separate file. Let's support this with a --split switch for repart and a SplitName= configuration option. --split enables split artifacts generation, and SplitName= configures for which partition to generate split artifacts, and which suffix to add to the split artifact name. For SplitName=, we add support for some extra specifiers, more specifically the partition Type UUID and the partition UUID.
* man: "the initial RAM disk" → "the initrd"Zbigniew Jędrzejewski-Szmek2022-09-201-28/+28
| | | | | | | | | | | | | | | In many places we spelled out the phrase behind "initrd" in full, but this isn't terribly useful. In fact, no "RAM disk" is used, so emphasizing this is just confusing to the reader. Let's just say "initrd" everywhere, people understand what this refers to, and that it's in fact an initramfs image. Also, s/i.e./e.g./ where appropriate. Also, don't say "in RAM", when in fact it's virtual memory, whose pages may or may not be loaded in page frames in RAM, and we have no control over this. Also, add <filename></filename> and other minor cleanups.
* repart: hook up new TPM2 signed policies with repartLennart Poettering2022-09-081-0/+9
|
* man: document support for drop-in files in systemd-repartRichard Phibel2022-08-121-1/+3
|
* man: document support for list of definitions directories in systemd-repartRichard Phibel2022-08-121-1/+3
|
* repart: add --image= switchLennart Poettering2021-04-191-12/+21
| | | | | | | | | | | This is similar to the --image= switch in the other tools, like systemd-sysusers or systemd-tmpfiles, i.e. it apply the configuration from the image to the image. This is particularly useful for downloading minimized GPT image, and then extending it to the desired size via: # systemd-repart --image=foo.image --size=5G
* man: share a common explanation for --json=Lennart Poettering2021-01-211-9/+1
|
* repart: port to table_print_with_pager()Lennart Poettering2021-01-211-0/+2
| | | | | This adds support for showing a pager, turning of the legend, like in the other tools.
* man: document new featuresLennart Poettering2020-12-171-7/+25
|
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* tree-wide: fix typos found by codespellFrantisek Sumsal2020-09-141-1/+1
| | | | Reported by Fossies.org