summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-rawhide/man5/repart.d.5
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-rawhide/man5/repart.d.5')
-rw-r--r--upstream/fedora-rawhide/man5/repart.d.580
1 files changed, 70 insertions, 10 deletions
diff --git a/upstream/fedora-rawhide/man5/repart.d.5 b/upstream/fedora-rawhide/man5/repart.d.5
index 17e247f9..c2f5ff87 100644
--- a/upstream/fedora-rawhide/man5/repart.d.5
+++ b/upstream/fedora-rawhide/man5/repart.d.5
@@ -1,5 +1,5 @@
'\" t
-.TH "REPART\&.D" "5" "" "systemd 255" "repart.d"
+.TH "REPART\&.D" "5" "" "systemd 256~rc3" "repart.d"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -23,12 +23,15 @@
repart.d \- Partition Definition Files for Automatic Boot\-Time Repartitioning
.SH "SYNOPSIS"
.PP
-.nf
+.RS 4
/etc/repart\&.d/*\&.conf
+.RE
+.RS 4
/run/repart\&.d/*\&.conf
+.RE
+.RS 4
/usr/lib/repart\&.d/*\&.conf
-
-.fi
+.RE
.SH "DESCRIPTION"
.PP
repart\&.d/*\&.conf
@@ -366,7 +369,7 @@ too\&. The logic is capable of automatically tracking down the backing partition
"CopyBlocks=auto"
is useful for implementing "self\-replicating" systems, i\&.e\&. systems that are their own installer\&.
.sp
-The file specified here must have a size that is a multiple of the basic block size 512 and not be empty\&. If this option is used, the size allocation algorithm is slightly altered: the partition is created as least as big as required to fit the data in, i\&.e\&. the data size is an additional minimum size value taken into consideration for the allocation algorithm, similar to and in addition to the
+The file specified here must have a size that is a multiple of the basic block size 512 and not be empty\&. If this option is used, the size allocation algorithm is slightly altered: the partition is created at least as big as required to fit the data in, i\&.e\&. the data size is an additional minimum size value taken into consideration for the allocation algorithm, similar to and in addition to the
\fISizeMin=\fR
value configured above\&.
.sp
@@ -390,7 +393,7 @@ Takes a file system name, such as
"erofs",
"squashfs"
or the special value
-"swap"\&. If specified and the partition is newly created it is formatted with the specified file system (or as swap device)\&. The file system UUID and label are automatically derived from the partition UUID and label\&. If this option is used, the size allocation algorithm is slightly altered: the partition is created as least as big as required for the minimal file system of the specified type (or 4KiB if the minimal size is not known)\&.
+"swap"\&. If specified and the partition is newly created it is formatted with the specified file system (or as swap device)\&. The file system UUID and label are automatically derived from the partition UUID and label\&. If this option is used, the size allocation algorithm is slightly altered: the partition is created at least as big as required for the minimal file system of the specified type (or 4KiB if the minimal size is not known)\&.
.sp
This option has no effect if the partition already exists\&.
.sp
@@ -539,6 +542,21 @@ Note that due to limitations of
Added in version 255\&.
.RE
.PP
+\fIDefaultSubvolume=\fR
+.RS 4
+Takes an absolute path specifying the default subvolume within the new filesystem\&. Note that this setting does not create the subvolume itself, that can be configured with
+\fISubvolumes=\fR\&.
+.sp
+Note that this option only takes effect if the target filesystem supports subvolumes, such as
+"btrfs"\&.
+.sp
+Note that due to limitations of
+"mkfs\&.btrfs", this option is only supported when running with
+\fB\-\-offline=no\fR\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
\fIEncrypt=\fR
.RS 4
Takes one of
@@ -744,6 +762,41 @@ will have to populate the filesystem twice to guess the minimal required size, s
.sp
Added in version 253\&.
.RE
+.PP
+\fIMountPoint=\fR
+.RS 4
+Specifies where and how the partition should be mounted\&. Takes at least one and at most two fields separated with a colon (":")\&. The first field specifies where the partition should be mounted\&. The second field specifies extra mount options to append to the default mount options\&. These fields correspond to the second and fourth column of the
+\fBfstab\fR(5)
+format\&. This setting may be specified multiple times to mount the partition multiple times\&. This can be used to add mounts for different btrfs subvolumes located on the same btrfs partition\&.
+.sp
+Note that this setting is only taken into account when
+\fB\-\-generate\-fstab=\fR
+is specified on the
+\fBsystemd\-repart\fR
+command line\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
+\fIEncryptedVolume=\fR
+.RS 4
+Specify how the encrypted partition should be set up\&. Takes at least one and at most three fields separated with a colon (":")\&. The first field specifies the encrypted volume name under
+/dev/mapper/\&. If not specified,
+"luks\-UUID"
+will be used where
+"UUID"
+is the LUKS UUID\&. The second field specifies the keyfile to use following the same format as specified in crypttab\&. The third field specifies a comma\-delimited list of crypttab options\&. These fields correspond to the first, third and fourth column of the
+\fBcrypttab\fR(5)
+format\&.
+.sp
+Note that this setting is only taken into account when
+\fB\-\-generate\-crypttab=\fR
+is specified on the
+\fBsystemd\-repart\fR
+command line\&.
+.sp
+Added in version 256\&.
+.RE
.SH "SPECIFIERS"
.PP
Specifiers may be used in the
@@ -947,6 +1000,16 @@ The partition number assigned to the partition
T}
.TE
.sp 1
+.SH "ENVIRONMENT"
+.PP
+Extra filesystem formatting options can be provided using filesystem\-specific environment variables:
+\fI$SYSTEMD_REPART_MKFS_OPTIONS_BTRFS\fR,
+\fI$SYSTEMD_REPART_MKFS_OPTIONS_XFS\fR,
+\fI$SYSTEMD_REPART_MKFS_OPTIONS_VFAT\fR,
+\fI$SYSTEMD_REPART_MKFS_OPTIONS_EROFS\fR, and
+\fI$SYSTEMD_REPART_MKFS_OPTIONS_SQUASHFS\fR\&. Each variable accepts valid
+\fBmkfs\&.\fR\fB\fIfilesystem\fR\fR
+command\-line arguments\&. The content of those variables is passed as\-is to the command, without any verification\&.
.SH "EXAMPLES"
.PP
\fBExample\ \&1.\ \&Grow the root partition to the full disk size at first boot\fR
@@ -1101,10 +1164,7 @@ VerityMatchKey=root
.SH "SEE ALSO"
.PP
-\fBsystemd\fR(1),
-\fBsystemd-repart\fR(8),
-\fBsfdisk\fR(8),
-\fBsystemd-cryptenroll\fR(1)
+\fBsystemd\fR(1), \fBsystemd-repart\fR(8), \fBsfdisk\fR(8), \fBsystemd-cryptenroll\fR(1)
.SH "NOTES"
.IP " 1." 4
Discoverable Partitions Specification