diff options
| author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-06-17 10:51:52 +0000 |
|---|---|---|
| committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-06-17 10:51:52 +0000 |
| commit | 4ad94864781f48b1a4b77f9cfb934622bf756ba1 (patch) | |
| tree | 3900955c1886e6d2570fea7125ee1f01bafe876d /upstream/fedora-rawhide/man8 | |
| parent | Adding upstream version 4.22.0. (diff) | |
| download | manpages-l10n-4ad94864781f48b1a4b77f9cfb934622bf756ba1.tar.xz manpages-l10n-4ad94864781f48b1a4b77f9cfb934622bf756ba1.zip | |
Adding upstream version 4.23.0.upstream/4.23.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/fedora-rawhide/man8')
179 files changed, 2915 insertions, 1222 deletions
diff --git a/upstream/fedora-rawhide/man8/atd.8 b/upstream/fedora-rawhide/man8/atd.8 index 78606b89..77367133 100644 --- a/upstream/fedora-rawhide/man8/atd.8 +++ b/upstream/fedora-rawhide/man8/atd.8 @@ -45,6 +45,7 @@ in the foreground. Process the at/batch queue only once. This is primarily of use for compatibility with old versions of .BR at ; +.TP .B \-n Append the hostname of the system to the subject of the e-mails sent by .BR atd . diff --git a/upstream/fedora-rawhide/man8/bridge.8 b/upstream/fedora-rawhide/man8/bridge.8 index a60964bb..eeea4073 100644 --- a/upstream/fedora-rawhide/man8/bridge.8 +++ b/upstream/fedora-rawhide/man8/bridge.8 @@ -188,6 +188,25 @@ bridge \- show / manipulate bridge addresses and devices .IR SRC_VNI " ]" .ti -8 +.B "bridge mdb flush" +.BI dev " DEV " +.RB "[ " port +.IR PORT " ]" +.RB "[ " vid +.IR VID " ]" +.RB "[ " src_vni +.IR SRC_VNI " ]" +.RB "[ " proto +.IR PROTO " ]" +.RB "[ " [no]permanent " ]" +.RB "[ " dst +.IR IPADDR " ]" +.RB "[ " dst_port +.IR DST_PORT " ]" +.RB "[ " vni +.IR VNI " ]" + +.ti -8 .BR "bridge vlan" " { " add " | " del " } " .B dev .I DEV @@ -1172,6 +1191,54 @@ the VLAN ID. Only relevant when the bridge is VLAN-aware. the source VNI Network Identifier. Only relevant when the VXLAN device is in external mode. +.SS bridge mdb flush - flush multicast group database entries. + +This command flushes the matching multicast group database entries. + +.TP +.BI dev " DEV" +the interface where this group address is associated. + +.TP +.BI port " PORT" +the target port for the operation. If the bridge device is specified then only +entries pointing to the bridge itself will be deleted. + +.TP +.BI vid " VID" +the VLAN ID for the operation. Match entries only with the specified VLAN ID. + +.TP +.BI src_vni " SRC_VNI" +the source VNI Network Identifier for the operation. Match entries only with +the specified source VNI. + +.TP +.BI proto " PROTO" +the routing protocol identifier for the operation. Match entries only with the +specified routing protocol. Can be a number or a string from the file +/etc/iproute2/rt_protos. + +.TP +.B [no]permanent +if specified then only permanent entries will be deleted or respectively if +"no" is prepended then only non-permanent (temp) entries will be deleted. + +.TP +.BI dst " IPADDR" +the IP address of the destination VXLAN tunnel endpoint where the multicast +receivers reside. Match entries only with the specified destination IP. + +.TP +.BI dst_port " DST_PORT" +the UDP destination port number to use to connect to the remote VXLAN tunnel +endpoint. Match entries only with the specified destination port number. + +.TP +.BI vni " VNI" +the VXLAN VNI Network Identifier to use to connect to the remote VXLAN tunnel +endpoint. Match entries only with the specified destination VNI. + .SH bridge vlan - VLAN filter list .B vlan diff --git a/upstream/fedora-rawhide/man8/btrfs-balance.8 b/upstream/fedora-rawhide/man8/btrfs-balance.8 index c30684c6..47379bab 100644 --- a/upstream/fedora-rawhide/man8/btrfs-balance.8 +++ b/upstream/fedora-rawhide/man8/btrfs-balance.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-BALANCE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-BALANCE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-balance \- balance block groups on a btrfs filesystem .SH SYNOPSIS @@ -185,7 +185,7 @@ or \fIraid6\fP .INDENT 7.0 .TP .B \-\-background|\-\-bg -run the balance operation asynchronously in the background, uses \fBfork(2)\fP to +run the balance operation asynchronously in the background, uses \fI\%fork(2)\fP to start the process that calls the kernel ioctl .UNINDENT .INDENT 7.0 diff --git a/upstream/fedora-rawhide/man8/btrfs-check.8 b/upstream/fedora-rawhide/man8/btrfs-check.8 index 59d0a764..2bf7ae98 100644 --- a/upstream/fedora-rawhide/man8/btrfs-check.8 +++ b/upstream/fedora-rawhide/man8/btrfs-check.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-CHECK" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-CHECK" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-check \- check or repair a btrfs filesystem .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-convert.8 b/upstream/fedora-rawhide/man8/btrfs-convert.8 index fded5087..56a5b527 100644 --- a/upstream/fedora-rawhide/man8/btrfs-convert.8 +++ b/upstream/fedora-rawhide/man8/btrfs-convert.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-CONVERT" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-CONVERT" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-convert \- convert from ext2/3/4 or reiserfs filesystem to btrfs in-place .SH SYNOPSIS @@ -76,6 +76,16 @@ have a supported data block size (i.e. the same that would be valid for \fBmkfs.btrfs\fP). This is typically the system page size (4KiB on x86_64 machines). .sp +\fBNOTE:\fP +.INDENT 0.0 +.INDENT 3.5 +Always consider if a mkfs and file copy would not be a better option than +the in\-place conversion given what was said above. The conversion depends on +3rd party libraries and the other filesystems could still evolve and add new +features. Not all combinations are covered or tested. +.UNINDENT +.UNINDENT +.sp \fBBEFORE YOU START\fP .sp The source filesystem must be clean, e.g. no journal to replay or no repairs diff --git a/upstream/fedora-rawhide/man8/btrfs-device.8 b/upstream/fedora-rawhide/man8/btrfs-device.8 index 5789f4fa..795dc42b 100644 --- a/upstream/fedora-rawhide/man8/btrfs-device.8 +++ b/upstream/fedora-rawhide/man8/btrfs-device.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-DEVICE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-DEVICE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-device \- manage devices of btrfs filesystems .SH SYNOPSIS @@ -186,9 +186,9 @@ $ btrfs device remove /dev/sda /mnt Add device(s) to the filesystem identified by \fIpath\fP\&. .sp If applicable, a whole device discard (TRIM) operation is performed prior to -adding the device. A device with existing filesystem detected by \fBblkid(8)\fP +adding the device. A device with existing filesystem detected by \fI\%blkid(8)\fP will prevent device addition and has to be forced. Alternatively the filesystem -can be wiped from the device using e.g. the \fBwipefs(8)\fP tool. +can be wiped from the device using e.g. the \fI\%wipefs(8)\fP tool. .sp The operation is instant and does not affect existing data. The operation merely adds the device to the filesystem structures and creates some block groups diff --git a/upstream/fedora-rawhide/man8/btrfs-filesystem.8 b/upstream/fedora-rawhide/man8/btrfs-filesystem.8 index f73467d9..dcf12d42 100644 --- a/upstream/fedora-rawhide/man8/btrfs-filesystem.8 +++ b/upstream/fedora-rawhide/man8/btrfs-filesystem.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-FILESYSTEM" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-FILESYSTEM" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-filesystem \- command group that primarily does work on the whole filesystems .SH SYNOPSIS @@ -292,7 +292,7 @@ Subvolume containing a swapfile cannot be snapshotted and blocks of an activated swapfile cannot be balanced. .sp Swapfile creation can be achieved by standalone commands too. Activation -needs to be done by command \fBswapon(8)\fP\&. See also command +needs to be done by command \fI\%swapon(8)\fP\&. See also command \fBbtrfs inspect\-internal map\-swapfile\fP and the \fI\%Swapfile feature\fP description. .sp @@ -346,12 +346,21 @@ device respecting \fIdevid\fP (remember, devid 1 by default). .sp The resize command does not manipulate the size of underlying partition. If you wish to enlarge/reduce a filesystem, you must make sure you -can expand the partition before enlarging the filesystem and shrink the -partition after reducing the size of the filesystem. This can done using -\fBfdisk(8)\fP or \fBparted(8)\fP to delete the existing partition and recreate +expand the partition before enlarging the filesystem and shrink the +partition after reducing the size of the filesystem. This can be done using +\fI\%fdisk(8)\fP or \fI\%parted(8)\fP to delete the existing partition and recreate it with the new desired size. When recreating the partition make sure to use the same starting partition offset as before. .sp +The size of the portion that the filesystem uses of an underlying device can be +determined via the \fBbtrfs filesystem show \-\-raw\fP command on the +filesystem’s mount point (where it’s given for each \fIdevid\fP after the string +\fIsize\fP or via the \fBbtrfs inspect\-internal dump\-super\fP command on the +specific device (where it’s given as the value of \fIdev_item.total_bytes\fP, which +is not to be confused with \fItotal_bytes\fP). +The value is also the address of the first byte not used by the +filesystem. +.sp Growing is usually instant as it only updates the size. However, shrinking could take a long time if there are data in the device area that\(aqs beyond the new end. Relocation of the data takes time. @@ -411,7 +420,7 @@ show sizes in TiB, or TB with \-\-si .UNINDENT .TP .B sync <path> -Force a sync of the filesystem at \fIpath\fP, similar to the \fBsync(1)\fP command. In +Force a sync of the filesystem at \fIpath\fP, similar to the \fI\%sync(1)\fP command. In addition, it starts cleaning of deleted subvolumes. To wait for the subvolume deletion to complete use the \fBbtrfs subvolume sync\fP command. .TP diff --git a/upstream/fedora-rawhide/man8/btrfs-find-root.8 b/upstream/fedora-rawhide/man8/btrfs-find-root.8 index 4dd6969d..0ff3ba65 100644 --- a/upstream/fedora-rawhide/man8/btrfs-find-root.8 +++ b/upstream/fedora-rawhide/man8/btrfs-find-root.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-FIND-ROOT" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-FIND-ROOT" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-find-root \- filter to find btrfs root .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-image.8 b/upstream/fedora-rawhide/man8/btrfs-image.8 index c369ee4d..2264e673 100644 --- a/upstream/fedora-rawhide/man8/btrfs-image.8 +++ b/upstream/fedora-rawhide/man8/btrfs-image.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-IMAGE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-IMAGE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-image \- create/restore an image of the filesystem .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-inspect-internal.8 b/upstream/fedora-rawhide/man8/btrfs-inspect-internal.8 index 25160caf..7e000ca4 100644 --- a/upstream/fedora-rawhide/man8/btrfs-inspect-internal.8 +++ b/upstream/fedora-rawhide/man8/btrfs-inspect-internal.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-INSPECT-INTERNAL" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-INSPECT-INTERNAL" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-inspect-internal \- query various internal information .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-map-logical.8 b/upstream/fedora-rawhide/man8/btrfs-map-logical.8 index c40866f1..f4d5b242 100644 --- a/upstream/fedora-rawhide/man8/btrfs-map-logical.8 +++ b/upstream/fedora-rawhide/man8/btrfs-map-logical.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-MAP-LOGICAL" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-MAP-LOGICAL" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-map-logical \- map btrfs logical extent to physical extent .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-property.8 b/upstream/fedora-rawhide/man8/btrfs-property.8 index 1d7330d6..6d88335a 100644 --- a/upstream/fedora-rawhide/man8/btrfs-property.8 +++ b/upstream/fedora-rawhide/man8/btrfs-property.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-PROPERTY" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-PROPERTY" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-property \- get/set/list properties for given filesystem object .SH SYNOPSIS @@ -40,8 +40,8 @@ The object can be an inode (file or directory), subvolume or the whole filesystem. .sp \fBbtrfs property\fP provides an unified and user\-friendly method to tune different -btrfs properties instead of using the traditional method like \fBchattr(1)\fP or -\fBlsattr(1)\fP\&. +btrfs properties instead of using the traditional method like \fI\%chattr(1)\fP or +\fI\%lsattr(1)\fP\&. .SS Object types .sp A property might apply to several object types so in some cases it\(aqs necessary @@ -174,7 +174,7 @@ returned in case of failure. .SH SEE ALSO .sp \fI\%mkfs.btrfs(8)\fP, -\fBlsattr(1)\fP, -\fBchattr(1)\fP +\fI\%lsattr(1)\fP, +\fI\%chattr(1)\fP .\" Generated by docutils manpage writer. . diff --git a/upstream/fedora-rawhide/man8/btrfs-qgroup.8 b/upstream/fedora-rawhide/man8/btrfs-qgroup.8 index 71718ce5..b9ad3abe 100644 --- a/upstream/fedora-rawhide/man8/btrfs-qgroup.8 +++ b/upstream/fedora-rawhide/man8/btrfs-qgroup.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-QGROUP" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-QGROUP" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-qgroup \- control the quota group of a btrfs filesystem .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-quota.8 b/upstream/fedora-rawhide/man8/btrfs-quota.8 index e1181252..daf38d0b 100644 --- a/upstream/fedora-rawhide/man8/btrfs-quota.8 +++ b/upstream/fedora-rawhide/man8/btrfs-quota.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-QUOTA" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-QUOTA" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-quota \- control the global quota status of a btrfs filesystem .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-receive.8 b/upstream/fedora-rawhide/man8/btrfs-receive.8 index d206b010..3d8969e3 100644 --- a/upstream/fedora-rawhide/man8/btrfs-receive.8 +++ b/upstream/fedora-rawhide/man8/btrfs-receive.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-RECEIVE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-RECEIVE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-receive \- receive subvolumes from send stream .SH SYNOPSIS @@ -67,7 +67,7 @@ read the stream from \fIFILE\fP instead of stdin, .INDENT 0.0 .TP .B \-C|\-\-chroot -confine the process to \fIpath\fP using \fBchroot(1)\fP +confine the process to \fIpath\fP using \fI\%chroot(1)\fP .UNINDENT .INDENT 0.0 .TP diff --git a/upstream/fedora-rawhide/man8/btrfs-replace.8 b/upstream/fedora-rawhide/man8/btrfs-replace.8 index d5bb007c..c87d0448 100644 --- a/upstream/fedora-rawhide/man8/btrfs-replace.8 +++ b/upstream/fedora-rawhide/man8/btrfs-replace.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-REPLACE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-REPLACE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-replace \- replace devices managed by btrfs with other device .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-rescue.8 b/upstream/fedora-rawhide/man8/btrfs-rescue.8 index 441e07c0..0ae778c3 100644 --- a/upstream/fedora-rawhide/man8/btrfs-rescue.8 +++ b/upstream/fedora-rawhide/man8/btrfs-rescue.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-RESCUE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-RESCUE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-rescue \- recover a damaged btrfs filesystem .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-restore.8 b/upstream/fedora-rawhide/man8/btrfs-restore.8 index 79916614..0c1ee6a5 100644 --- a/upstream/fedora-rawhide/man8/btrfs-restore.8 +++ b/upstream/fedora-rawhide/man8/btrfs-restore.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-RESTORE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-RESTORE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-restore \- try to restore files from a damaged filesystem image .SH SYNOPSIS @@ -106,7 +106,7 @@ dry run (only list files that would be recovered) .INDENT 0.0 .TP .BI \-\-path\-regex \ <regex> -restore only filenames matching a regular expression (\fBregex(7)\fP) +restore only filenames matching a regular expression (\fI\%regex(7)\fP) with a mandatory format .sp \fB^/(|home(|/username(|/Desktop(|/.*))))$\fP diff --git a/upstream/fedora-rawhide/man8/btrfs-scrub.8 b/upstream/fedora-rawhide/man8/btrfs-scrub.8 index e415fac8..5535a7c9 100644 --- a/upstream/fedora-rawhide/man8/btrfs-scrub.8 +++ b/upstream/fedora-rawhide/man8/btrfs-scrub.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-SCRUB" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-SCRUB" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-scrub \- scrub btrfs filesystem, verify block checksums .SH SYNOPSIS @@ -68,13 +68,13 @@ scrub only a selected device. See \fI\%btrfs scrub start\fP for more. \fBNOTE:\fP .INDENT 0.0 .INDENT 3.5 -The \fBionice(1)\fP may not be generally supported by all IO schedulers and +The \fI\%ionice(1)\fP may not be generally supported by all IO schedulers and the options to \fBbtrfs scrub start\fP may not work as expected. .UNINDENT .UNINDENT .sp In the past when the \fI\%CFQ IO scheduler\fP was generally used -the \fBionice(1)\fP syscalls set the priority to \fIidle\fP so the IO would not +the \fI\%ionice(1)\fP syscalls set the priority to \fIidle\fP so the IO would not interfere with regular IO. Since the kernel 5.0 the CFQ is not available. .sp The IO scheduler known to support that is \fI\%BFQ\fP, but first read the @@ -91,7 +91,7 @@ belong to the same accounting group. .sp .nf .ft C -$ systemd\-run \-p \(dqIOBandwidthReadMax=/dev/sdx 10M\(dq btrfs scrub start \-B / +$ systemd\-run \-p \(dqIOReadBandwidthMax=/dev/sdx 10M\(dq btrfs scrub start \-B / .ft P .fi .UNINDENT @@ -226,14 +226,14 @@ necessary .INDENT 7.0 .TP .BI \-c \ <ioprio_class> -set IO priority class (see \fBionice(1)\fP manual page) if the IO +set IO priority class (see \fI\%ionice(1)\fP manual page) if the IO scheduler configured for the device supports ionice. This is only supported by BFQ or Kyber but is \fInot\fP supported by mq\-deadline. Please read the section about \fI\%IO limiting\fP\&. .TP .BI \-n \ <ioprio_classdata> -set IO priority classdata (see \fBionice(1)\fP manpage) +set IO priority classdata (see \fI\%ionice(1)\fP manpage) .TP .B \-q (deprecated) alias for global \fI\-q\fP option diff --git a/upstream/fedora-rawhide/man8/btrfs-select-super.8 b/upstream/fedora-rawhide/man8/btrfs-select-super.8 index cbf1079a..5e839dc2 100644 --- a/upstream/fedora-rawhide/man8/btrfs-select-super.8 +++ b/upstream/fedora-rawhide/man8/btrfs-select-super.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-SELECT-SUPER" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-SELECT-SUPER" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-select-super \- overwrite primary superblock with a backup copy .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-send.8 b/upstream/fedora-rawhide/man8/btrfs-send.8 index 0f0ca7d8..2244a134 100644 --- a/upstream/fedora-rawhide/man8/btrfs-send.8 +++ b/upstream/fedora-rawhide/man8/btrfs-send.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-SEND" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-SEND" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-send \- generate a stream of changes between two subvolume snapshots .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-subvolume.8 b/upstream/fedora-rawhide/man8/btrfs-subvolume.8 index 1ac17e3e..7a888b7d 100644 --- a/upstream/fedora-rawhide/man8/btrfs-subvolume.8 +++ b/upstream/fedora-rawhide/man8/btrfs-subvolume.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-SUBVOLUME" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-SUBVOLUME" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-subvolume \- manage btrfs subvolumes .SH SYNOPSIS @@ -41,7 +41,8 @@ snapshots. A BTRFS subvolume is a part of filesystem with its own independent file/directory hierarchy and inode number namespace. Subvolumes can share file extents. A snapshot is also subvolume, but with a given initial content of the -original subvolume. A subvolume has always inode number 256. +original subvolume. A subvolume has always inode number 256 (see more in +\fI\%Inode numbers (in Subvolumes)\fP). .sp \fBNOTE:\fP .INDENT 0.0 @@ -200,10 +201,28 @@ the 4th column: .UNINDENT .SH INODE NUMBERS .sp -A proper subvolume has always inode number 256. If a subvolume is nested and -then a snapshot is taken, then the cloned directory entry representing the -subvolume becomes empty and the inode has number 2. All other files and -directories in the target snapshot preserve their original inode numbers. +A directory representing a subvolume has always inode number 256 (sometimes +also called a root of the subvolume): +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +$ ls \-lis +total 0 +389111 0 drwxr\-xr\-x 1 user users 0 Jan 20 12:13 dir +389110 0 \-rw\-r\-\-r\-\- 1 user users 0 Jan 20 12:13 file + 256 0 drwxr\-xr\-x 1 user users 0 Jan 20 12:13 snap1 + 256 0 drwxr\-xr\-x 1 user users 0 Jan 20 12:13 subv1 +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +If a subvolume is nested and then a snapshot is taken, then the cloned +directory entry representing the subvolume becomes empty and the inode has +number 2. All other files and directories in the target snapshot preserve their +original inode numbers. .sp \fBNOTE:\fP .INDENT 0.0 @@ -333,16 +352,6 @@ wait for transaction commit after deleting each subvolume. .B \-i|\-\-subvolid <subvolid> subvolume id to be removed instead of the <path> that should point to the filesystem with the subvolume -.UNINDENT -.INDENT 7.0 -.TP -.B \-\-delete\-qgroup -also delete the qgroup 0/subvolid if it exists -.TP -.B \-\-no\-delete\-qgroup -do not delete the 0/subvolid qgroup (default) -.UNINDENT -.INDENT 7.0 .TP .B \-v|\-\-verbose (deprecated) alias for global \fI\-v\fP option @@ -568,6 +577,6 @@ returned in case of failure. \fI\%btrfs\-quota(8)\fP, \fI\%btrfs\-send(8)\fP, \fI\%mkfs.btrfs(8)\fP, -\fBmount(8)\fP +\fI\%mount(8)\fP .\" Generated by docutils manpage writer. . diff --git a/upstream/fedora-rawhide/man8/btrfs.8 b/upstream/fedora-rawhide/man8/btrfs.8 index f20beee4..03238359 100644 --- a/upstream/fedora-rawhide/man8/btrfs.8 +++ b/upstream/fedora-rawhide/man8/btrfs.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs \- a toolbox to manage btrfs filesystems .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfstune.8 b/upstream/fedora-rawhide/man8/btrfstune.8 index 94cc266f..0db3476e 100644 --- a/upstream/fedora-rawhide/man8/btrfstune.8 +++ b/upstream/fedora-rawhide/man8/btrfstune.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFSTUNE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFSTUNE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfstune \- tune various filesystem parameters .SH SYNOPSIS @@ -134,7 +134,7 @@ change operation in case it was interrupted. .BI \-U \ <UUID> Change fsid to \fIUUID\fP in all metadata blocks. .sp -The \fIUUID\fP should be a 36 bytes string in \fBprintf(3)\fP format +The \fIUUID\fP should be a 36 bytes string in \fI\%printf(3)\fP format \fB%08x\-%04x\-%04x\-%04x\-%012x\fP\&. If there is a previous unfinished fsid change, it will continue only if the \fIUUID\fP matches the unfinished one or if you use the option \fI\-u\fP\&. diff --git a/upstream/fedora-rawhide/man8/devlink-rate.8 b/upstream/fedora-rawhide/man8/devlink-rate.8 index bcec3c31..f09ac4ac 100644 --- a/upstream/fedora-rawhide/man8/devlink-rate.8 +++ b/upstream/fedora-rawhide/man8/devlink-rate.8 @@ -149,7 +149,7 @@ These parameter accept integer meaning weight or priority of a node. - set rate object parent to existing node with name \fINODE_NAME\fR or unset parent. Rate limits of the parent node applied to all it's children. Actual behaviour is details of driver's implementation. Setting parent to empty ("") -name due to the kernel logic threated as parent unset. +name due to the kernel logic treated as parent unset. .SS devlink port function rate add - create node rate object with specified parameters. Creates rate object of type node and sets parameters. Parameters same as for the diff --git a/upstream/fedora-rawhide/man8/dnf-builddep.8 b/upstream/fedora-rawhide/man8/dnf4-builddep.8 index be5ddc99..fdd13b99 100644 --- a/upstream/fedora-rawhide/man8/dnf-builddep.8 +++ b/upstream/fedora-rawhide/man8/dnf4-builddep.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-BUILDDEP" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-BUILDDEP" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-builddep \- DNF builddep Plugin +dnf4-builddep \- DNF builddep Plugin .sp Install whatever is needed to build the given .src.rpm, .nosrc.rpm or .spec file. .sp diff --git a/upstream/fedora-rawhide/man8/dnf-changelog.8 b/upstream/fedora-rawhide/man8/dnf4-changelog.8 index f1f1e2c7..b7569796 100644 --- a/upstream/fedora-rawhide/man8/dnf-changelog.8 +++ b/upstream/fedora-rawhide/man8/dnf4-changelog.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-CHANGELOG" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-CHANGELOG" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-changelog \- DNF changelog Plugin +dnf4-changelog \- DNF changelog Plugin .SH DESCRIPTION .sp \fIchangelog\fP is a plugin for viewing package changelogs. diff --git a/upstream/fedora-rawhide/man8/dnf-config-manager.8 b/upstream/fedora-rawhide/man8/dnf4-config-manager.8 index c8e86088..c9b55d1f 100644 --- a/upstream/fedora-rawhide/man8/dnf-config-manager.8 +++ b/upstream/fedora-rawhide/man8/dnf4-config-manager.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-CONFIG-MANAGER" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-CONFIG-MANAGER" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-config-manager \- DNF config-manager Plugin +dnf4-config-manager \- DNF config-manager Plugin .sp Manage main and repository DNF configuration options, toggle which repositories are enabled or disabled, and add new repositories. diff --git a/upstream/fedora-rawhide/man8/dnf-copr.8 b/upstream/fedora-rawhide/man8/dnf4-copr.8 index 39447de6..ef4d5ded 100644 --- a/upstream/fedora-rawhide/man8/dnf-copr.8 +++ b/upstream/fedora-rawhide/man8/dnf4-copr.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-COPR" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-COPR" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-copr \- DNF copr Plugin +dnf4-copr \- DNF copr Plugin .sp Work with Copr & Playground repositories on the local system. .INDENT 0.0 diff --git a/upstream/fedora-rawhide/man8/dnf-debug.8 b/upstream/fedora-rawhide/man8/dnf4-debug.8 index e794ec80..850e5e1d 100644 --- a/upstream/fedora-rawhide/man8/dnf-debug.8 +++ b/upstream/fedora-rawhide/man8/dnf4-debug.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-DEBUG" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-DEBUG" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-debug \- DNF debug Plugin +dnf4-debug \- DNF debug Plugin .SH DESCRIPTION .sp The plugin provides two dnf commands: diff --git a/upstream/fedora-rawhide/man8/dnf-debuginfo-install.8 b/upstream/fedora-rawhide/man8/dnf4-debuginfo-install.8 index 67276b58..9d197322 100644 --- a/upstream/fedora-rawhide/man8/dnf-debuginfo-install.8 +++ b/upstream/fedora-rawhide/man8/dnf4-debuginfo-install.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-DEBUGINFO-INSTALL" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-DEBUGINFO-INSTALL" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-debuginfo-install \- DNF debuginfo-install Plugin +dnf4-debuginfo-install \- DNF debuginfo-install Plugin .sp Install the associated debuginfo packages for a given package specification. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-download.8 b/upstream/fedora-rawhide/man8/dnf4-download.8 index f54a51a5..7fdba0bc 100644 --- a/upstream/fedora-rawhide/man8/dnf-download.8 +++ b/upstream/fedora-rawhide/man8/dnf4-download.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-DOWNLOAD" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-DOWNLOAD" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-download \- DNF download Plugin +dnf4-download \- DNF download Plugin .sp Download binary or source packages. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-generate_completion_cache.8 b/upstream/fedora-rawhide/man8/dnf4-generate_completion_cache.8 index 522247f7..d9550937 100644 --- a/upstream/fedora-rawhide/man8/dnf-generate_completion_cache.8 +++ b/upstream/fedora-rawhide/man8/dnf4-generate_completion_cache.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-GENERATE_COMPLETION_CACHE" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-GENERATE_COMPLETION_CACHE" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-generate_completion_cache \- DNF generate_completion_cache Plugin +dnf4-generate_completion_cache \- DNF generate_completion_cache Plugin .sp Generates data to speed up shell completion for DNF. The user is not supposed to interact with the plugin in any way. .SH AUTHOR diff --git a/upstream/fedora-rawhide/man8/dnf-groups-manager.8 b/upstream/fedora-rawhide/man8/dnf4-groups-manager.8 index 0dcd49d7..9870f83a 100644 --- a/upstream/fedora-rawhide/man8/dnf-groups-manager.8 +++ b/upstream/fedora-rawhide/man8/dnf4-groups-manager.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-GROUPS-MANAGER" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-GROUPS-MANAGER" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-groups-manager \- DNF groups-manager Plugin +dnf4-groups-manager \- DNF groups-manager Plugin .sp Create and edit groups repository metadata files. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-needs-restarting.8 b/upstream/fedora-rawhide/man8/dnf4-needs-restarting.8 index 7a110fd9..b65a0ade 100644 --- a/upstream/fedora-rawhide/man8/dnf-needs-restarting.8 +++ b/upstream/fedora-rawhide/man8/dnf4-needs-restarting.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-NEEDS-RESTARTING" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-NEEDS-RESTARTING" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-needs-restarting \- DNF needs_restarting Plugin +dnf4-needs-restarting \- DNF needs_restarting Plugin .sp Check for running processes that should be restarted. .SH SYNOPSIS @@ -40,6 +40,43 @@ Check for running processes that should be restarted. \fIneeds\-restarting\fP looks through running processes and tries to detect those that use files from packages that have been updated after the given process started. Such processes are reported by this tool. .sp Note that in most cases a process should survive update of its binary and libraries it is using without requiring to be restarted for proper operation. There are however specific cases when this does not apply. Separately, processes often need to be restarted to reflect security updates. +.sp +\fBNOTE:\fP +.INDENT 0.0 +.INDENT 3.5 +Needs\-restarting will try to guess the boot time using three different methods: +.INDENT 0.0 +.TP +.B \fBUnitsLoadStartTimestamp\fP +D\-Bus property on \fB/org/freedesktop/systemd1\fP\&. +Works unless the system was not booted with systemd, +such as in (most) containers. +.TP +.B \fBst_mtime of /proc/1\fP +Reflects the time the first process was run after booting. +This works for all known cases except machines without +a RTC—they awake at the start of the epoch. +.TP +.B \fB/proc/uptime\fP +Seconds field of \fB/proc/uptime\fP subtracted from the current time. +Works for machines without RTC if the current time is reasonably correct. +Does not work on containers which share their kernel with the +host—there, the host kernel uptime is returned. +.UNINDENT +.UNINDENT +.UNINDENT +.sp +\fBWARNING:\fP +.INDENT 0.0 +.INDENT 3.5 +Some systems are configured to read the RTC time in the local time +zone. This mode cannot be fully supported. It will create various problems +with time zone changes and daylight saving time adjustments. The RTC time +is never updated, it relies on external facilities to maintain it. \fBIf at +all possible, use RTC in UTC by calling\fP \fBtimedatectl set\-local\-rtc 0\fP\&. +See \fBman timedatectl\fP for more information. +.UNINDENT +.UNINDENT .SH OPTIONS .sp All general DNF options are accepted, see \fIOptions\fP in \fBdnf(8)\fP for details. diff --git a/upstream/fedora-rawhide/man8/dnf-repoclosure.8 b/upstream/fedora-rawhide/man8/dnf4-repoclosure.8 index ea4522ec..f72c958e 100644 --- a/upstream/fedora-rawhide/man8/dnf-repoclosure.8 +++ b/upstream/fedora-rawhide/man8/dnf4-repoclosure.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-REPOCLOSURE" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-REPOCLOSURE" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-repoclosure \- DNF repoclosure Plugin +dnf4-repoclosure \- DNF repoclosure Plugin .sp Display a list of unresolved dependencies for repositories. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-repodiff.8 b/upstream/fedora-rawhide/man8/dnf4-repodiff.8 index df1c516f..c6ed3cbb 100644 --- a/upstream/fedora-rawhide/man8/dnf-repodiff.8 +++ b/upstream/fedora-rawhide/man8/dnf4-repodiff.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-REPODIFF" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-REPODIFF" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-repodiff \- DNF repodiff Plugin +dnf4-repodiff \- DNF repodiff Plugin .sp Display a list of differences between two or more repositories .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-repograph.8 b/upstream/fedora-rawhide/man8/dnf4-repograph.8 index 1c7b54d7..e9dfdc60 100644 --- a/upstream/fedora-rawhide/man8/dnf-repograph.8 +++ b/upstream/fedora-rawhide/man8/dnf4-repograph.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-REPOGRAPH" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-REPOGRAPH" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-repograph \- DNF repograph Plugin +dnf4-repograph \- DNF repograph Plugin .sp Output a full package dependency graph in dot format. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-repomanage.8 b/upstream/fedora-rawhide/man8/dnf4-repomanage.8 index 76023665..cdd3dc34 100644 --- a/upstream/fedora-rawhide/man8/dnf-repomanage.8 +++ b/upstream/fedora-rawhide/man8/dnf4-repomanage.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-REPOMANAGE" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-REPOMANAGE" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-repomanage \- DNF repomanage Plugin +dnf4-repomanage \- DNF repomanage Plugin .sp Manage a repository or a simple directory of rpm packages. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-reposync.8 b/upstream/fedora-rawhide/man8/dnf4-reposync.8 index 063df921..d81fec33 100644 --- a/upstream/fedora-rawhide/man8/dnf-reposync.8 +++ b/upstream/fedora-rawhide/man8/dnf4-reposync.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-REPOSYNC" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-REPOSYNC" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-reposync \- DNF reposync Plugin +dnf4-reposync \- DNF reposync Plugin .sp Synchronize packages of a remote DNF repository to a local directory. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-system-upgrade.8 b/upstream/fedora-rawhide/man8/dnf4-system-upgrade.8 index 90558dc1..ab6606a4 100644 --- a/upstream/fedora-rawhide/man8/dnf-system-upgrade.8 +++ b/upstream/fedora-rawhide/man8/dnf4-system-upgrade.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-SYSTEM-UPGRADE" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-SYSTEM-UPGRADE" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-system-upgrade \- DNF system-upgrade Plugin +dnf4-system-upgrade \- DNF system-upgrade Plugin .SH DESCRIPTION .sp DNF system\-upgrades plugin provides three commands: \fBsystem\-upgrade\fP, \fBoffline\-upgrade\fP, and diff --git a/upstream/fedora-rawhide/man8/fsck.btrfs.8 b/upstream/fedora-rawhide/man8/fsck.btrfs.8 index 02a04994..ea461241 100644 --- a/upstream/fedora-rawhide/man8/fsck.btrfs.8 +++ b/upstream/fedora-rawhide/man8/fsck.btrfs.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "FSCK.BTRFS" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "FSCK.BTRFS" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME fsck.btrfs \- do nothing, successfully .SH SYNOPSIS @@ -37,7 +37,7 @@ fsck.btrfs \- do nothing, successfully .sp \fBfsck.btrfs\fP is a type of utility that should exist for any filesystem and is called during system setup when the corresponding \fB/etc/fstab\fP entries -contain non\-zero value for \fIfs_passno\fP, see \fBfstab(5)\fP for more. +contain non\-zero value for \fIfs_passno\fP, see \fI\%fstab(5)\fP for more. .sp Traditional filesystems need to run their respective fsck utility in case the filesystem was not unmounted cleanly and the log needs to be replayed before @@ -68,7 +68,7 @@ Operational error, e.g. device does not exist .SH SEE ALSO .sp \fI\%btrfs(8)\fP, -\fBfsck(8)\fP, -\fBfstab(5)\fP +\fI\%fsck(8)\fP, +\fI\%fstab(5)\fP .\" Generated by docutils manpage writer. . diff --git a/upstream/fedora-rawhide/man8/grub2-bios-setup.8 b/upstream/fedora-rawhide/man8/grub2-bios-setup.8 index fa4e5363..f2dd0f7c 100644 --- a/upstream/fedora-rawhide/man8/grub2-bios-setup.8 +++ b/upstream/fedora-rawhide/man8/grub2-bios-setup.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-BIOS-SETUP "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-BIOS-SETUP "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-bios-setup \- set up a device to boot using GRUB .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-install.8 b/upstream/fedora-rawhide/man8/grub2-install.8 index 3a455310..f12f4477 100644 --- a/upstream/fedora-rawhide/man8/grub2-install.8 +++ b/upstream/fedora-rawhide/man8/grub2-install.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-INSTALL "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-INSTALL "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-install \- install GRUB to a device .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-mkconfig.8 b/upstream/fedora-rawhide/man8/grub2-mkconfig.8 index 6c62e799..b9f22b02 100644 --- a/upstream/fedora-rawhide/man8/grub2-mkconfig.8 +++ b/upstream/fedora-rawhide/man8/grub2-mkconfig.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MKCONFIG "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-MKCONFIG "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-mkconfig \- generate a GRUB configuration file .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-probe.8 b/upstream/fedora-rawhide/man8/grub2-probe.8 index eeb328e6..1ea29310 100644 --- a/upstream/fedora-rawhide/man8/grub2-probe.8 +++ b/upstream/fedora-rawhide/man8/grub2-probe.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-PROBE "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-PROBE "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-probe \- probe device information for GRUB .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-reboot.8 b/upstream/fedora-rawhide/man8/grub2-reboot.8 index 46beae18..dba8fe30 100644 --- a/upstream/fedora-rawhide/man8/grub2-reboot.8 +++ b/upstream/fedora-rawhide/man8/grub2-reboot.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-REBOOT "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-REBOOT "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-reboot \- set the default boot entry for GRUB, for the next boot only .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-set-default.8 b/upstream/fedora-rawhide/man8/grub2-set-default.8 index 3a7b0c59..e6b875cb 100644 --- a/upstream/fedora-rawhide/man8/grub2-set-default.8 +++ b/upstream/fedora-rawhide/man8/grub2-set-default.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-SET-DEFAULT "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-SET-DEFAULT "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-set-default \- set the saved default boot entry for GRUB .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-set-password.8 b/upstream/fedora-rawhide/man8/grub2-set-password.8 index b0b26a8e..0d610a53 100644 --- a/upstream/fedora-rawhide/man8/grub2-set-password.8 +++ b/upstream/fedora-rawhide/man8/grub2-set-password.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-SET-PASSWORD "8" "February 2024" "The grub bootloader password may only be set by root." "System Administration Utilities" +.TH GRUB-SET-PASSWORD "8" "May 2024" "The grub bootloader password may only be set by root." "System Administration Utilities" .SH NAME grub-set-password \- generate the user.cfg file containing the hashed grub bootloader password .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-switch-to-blscfg.8 b/upstream/fedora-rawhide/man8/grub2-switch-to-blscfg.8 index c1f3c5a6..42bb9d20 100644 --- a/upstream/fedora-rawhide/man8/grub2-switch-to-blscfg.8 +++ b/upstream/fedora-rawhide/man8/grub2-switch-to-blscfg.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-SWITCH-TO-BLSCFG "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-SWITCH-TO-BLSCFG "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-switch-to-blscfg \- switch to using BLS config files .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/gssd.8 b/upstream/fedora-rawhide/man8/gssd.8 index 2a5384d3..c735eff6 100644 --- a/upstream/fedora-rawhide/man8/gssd.8 +++ b/upstream/fedora-rawhide/man8/gssd.8 @@ -346,6 +346,15 @@ flag. Equivalent to .BR -l . .TP +.B allowed-enctypes +Allows you to restrict +.B rpc.gssd +to using a subset of the encryption types permitted by the kernel and the krb5 +libraries. This is useful if you need to interoperate with an NFS server that +does not have support for the newer SHA2 and Camellia encryption types, for +example. This configuration file option does not have an equivalent +command-line option. +.TP .B context-timeout Equivalent to .BR -t . diff --git a/upstream/fedora-rawhide/man8/iconvconfig.8 b/upstream/fedora-rawhide/man8/iconvconfig.8 index 51c785c3..ab931d77 100644 --- a/upstream/fedora-rawhide/man8/iconvconfig.8 +++ b/upstream/fedora-rawhide/man8/iconvconfig.8 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH iconvconfig 8 2023-10-31 "Linux man-pages 6.06" +.TH iconvconfig 8 2023-10-31 "Linux man-pages 6.7" .SH NAME iconvconfig \- create iconv module configuration cache .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/intro.8 b/upstream/fedora-rawhide/man8/intro.8 index a023443b..c1368eb2 100644 --- a/upstream/fedora-rawhide/man8/intro.8 +++ b/upstream/fedora-rawhide/man8/intro.8 @@ -7,7 +7,7 @@ .\" Modified Sat Jul 24 17:35:48 1993 by Rik Faith (faith@cs.unc.edu) .\" 2007-10-23 mtk: minor rewrites, and added paragraph on exit status .\" -.TH intro 8 2023-10-31 "Linux man-pages 6.06" +.TH intro 8 2023-10-31 "Linux man-pages 6.7" .SH NAME intro \- introduction to administration and privileged commands .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man8/ip-address.8 b/upstream/fedora-rawhide/man8/ip-address.8 index 8e0de0e9..277c5068 100644 --- a/upstream/fedora-rawhide/man8/ip-address.8 +++ b/upstream/fedora-rawhide/man8/ip-address.8 @@ -146,7 +146,8 @@ ip-address \- protocol address management .BR ipvlan " |" .BR lowpan " |" .BR geneve " |" -.BR macsec " ]" +.BR macsec " |" +.BR netkit " ]" .SH "DESCRIPTION" The diff --git a/upstream/fedora-rawhide/man8/ip-l2tp.8 b/upstream/fedora-rawhide/man8/ip-l2tp.8 index 9aba6bec..7109c0a0 100644 --- a/upstream/fedora-rawhide/man8/ip-l2tp.8 +++ b/upstream/fedora-rawhide/man8/ip-l2tp.8 @@ -392,7 +392,7 @@ If L2TP is being used over IPv6, use the IPv6 defrag module. .SH INTEROPERABILITY .PP Unmanaged (static) L2TPv3 tunnels are supported by some network -equipment equipment vendors such as Cisco. +equipment vendors such as Cisco. .PP In Linux, L2TP Hello messages are not supported in unmanaged tunnels. Hello messages are used by L2TP clients and servers to detect diff --git a/upstream/fedora-rawhide/man8/ip-link.8 b/upstream/fedora-rawhide/man8/ip-link.8 index 209ae825..be01f6e5 100644 --- a/upstream/fedora-rawhide/man8/ip-link.8 +++ b/upstream/fedora-rawhide/man8/ip-link.8 @@ -247,6 +247,7 @@ ip-link \- network device configuration .BR macvlan " | " .BR macvtap " | " .BR netdevsim " |" +.BR netkit " |" .BR nlmon " |" .BR rmnet " |" .BR sit " |" @@ -384,6 +385,9 @@ Link types: .BR netdevsim - Interface for netdev API tests .sp +.BR netkit +- BPF-programmable network device +.sp .BR nlmon - Netlink monitoring device .sp @@ -441,6 +445,11 @@ TCP for IPv6 on this device when the size is greater than 65536. specifies the recommended maximum size of a IPv4 Generic Segment Offload packet the new device should accept. This is especially used to enable BIG TCP for IPv4 on this device by setting to a size greater than 65536. +Note that +.B gso_max_size +needs to be set to a size greater than or equal to +.B gso_ipv4_max_size +to really enable BIG TCP for IPv4. .TP .BI gso_max_segs " SEGMENTS " @@ -849,6 +858,46 @@ tunnel. .in -8 .TP +netkit Type Support +For a link of type +.I netkit +the following additional arguments are supported: + +.BI "ip link add " DEVICE +.BR type " netkit " +[ +.BI mode " MODE " +] [ +.I "POLICY " +] [ +.BR peer +[ +.I "POLICY " +] [ +.I "NAME " +] ] + +.in +8 + +.sp +.BI mode " MODE" +- specifies the operation mode of the netkit device with "l3" and "l2" +as possible values. Default option is "l3". + +.sp +.I "POLICY" +- specifies the default device policy when no BPF programs are attached +with "forward" and "blackhole" as possible values. Default option is +"forward". Specifying policy before the peer option refers to the primary +device, after the peer option refers to the peer device. + +.sp +.I "NAME" +- specifies the device name of the peer device. + +.in -8 + +.TP IPIP, SIT Type Support For a link of type .IR IPIP or SIT diff --git a/upstream/fedora-rawhide/man8/ip.8 b/upstream/fedora-rawhide/man8/ip.8 index 72227d44..fdae57c5 100644 --- a/upstream/fedora-rawhide/man8/ip.8 +++ b/upstream/fedora-rawhide/man8/ip.8 @@ -19,10 +19,12 @@ ip \- show / manipulate routing, network devices, interfaces and tunnels .ti -8 .IR OBJECT " := { " -.BR link " | " address " | " addrlabel " | " route " | " rule " | " neigh " | "\ - ntable " | " tunnel " | " tuntap " | " maddress " | " mroute " | " mrule " | "\ - monitor " | " xfrm " | " netns " | " l2tp " | " tcp_metrics " | " token " | "\ - macsec " | " vrf " | " mptcp " | " ioam " | " stats " }" +.BR address " | " addrlabel " | " fou " | " help " | " ila " | " ioam " | "\ + l2tp " | " link " | " macsec " | " maddress " | " monitor " | " mptcp " | "\ + mroute " | " mrule " | " neighbor " | " neighbour " | " netconf " | "\ + netns " | " nexthop " | " ntable " | " ntbl " | " route " | " rule " | "\ + sr " | " tap " | " tcpmetrics " | " token " | " tunnel " | " tuntap " | "\ + vrf " | " xfrm " }" .sp .ti -8 @@ -255,6 +257,14 @@ Request the kernel to send the applied configuration back. - label configuration for protocol address selection. .TP +.B fou +- Foo-over-UDP receive port configuration. + +.TP +.B ila +- manage identifier locator addresses (ILA). + +.TP .B ioam - manage IOAM namespaces and IOAM schemas. @@ -267,6 +277,10 @@ Request the kernel to send the applied configuration back. - network device. .TP +.B macsec +- MACsec device configuration. + +.TP .B maddress - multicast address. @@ -291,10 +305,18 @@ Request the kernel to send the applied configuration back. - manage ARP or NDISC cache entries. .TP +.B netconf +- network configuration monitoring. + +.TP .B netns - manage network namespaces. .TP +.B nexthop +- manage nexthop objects. + +.TP .B ntable - manage the neighbor cache's operation. @@ -307,12 +329,16 @@ Request the kernel to send the applied configuration back. - rule in routing policy database. .TP +.B sr +- manage IPv6 segment routing. + +.TP .B stats - manage and show interface statistics. .TP .B tcp_metrics/tcpmetrics -- manage TCP Metrics +- manage TCP Metrics. .TP .B token @@ -415,19 +441,24 @@ was written by Alexey N. Kuznetsov and added in Linux 2.2. .SH SEE ALSO .BR ip-address (8), .BR ip-addrlabel (8), +.BR ip-fou (8), .BR ip-ioam (8), .BR ip-l2tp (8), .BR ip-link (8), +.BR ip-macsec (8), .BR ip-maddress (8), .BR ip-monitor (8), .BR ip-mptcp (8), .BR ip-mroute (8), .BR ip-neighbour (8), +.BR ip-netconf (8), .BR ip-netns (8), +.BR ip-nexthop (8), .BR ip-ntable (8), .BR ip-route (8), .BR ip-rule (8), -.BR ip-stats (8) +.BR ip-sr (8), +.BR ip-stats (8), .BR ip-tcp_metrics (8), .BR ip-token (8), .BR ip-tunnel (8), diff --git a/upstream/fedora-rawhide/man8/kernel-install.8 b/upstream/fedora-rawhide/man8/kernel-install.8 index 6c8d93d9..06b06a4e 100644 --- a/upstream/fedora-rawhide/man8/kernel-install.8 +++ b/upstream/fedora-rawhide/man8/kernel-install.8 @@ -1,5 +1,5 @@ '\" t -.TH "KERNEL\-INSTALL" "8" "" "systemd 255" "kernel-install" +.TH "KERNEL\-INSTALL" "8" "" "systemd 256~rc3" "kernel-install" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -25,6 +25,8 @@ kernel-install \- Add and remove kernel and initrd images to and from /boot .HP \w'\fBkernel\-install\fR\ 'u \fBkernel\-install\fR [OPTIONS...] add \fIKERNEL\-VERSION\fR \fIKERNEL\-IMAGE\fR [\fIINITRD\-FILE\fR...] .HP \w'\fBkernel\-install\fR\ 'u +\fBkernel\-install\fR [OPTIONS...] add\-all +.HP \w'\fBkernel\-install\fR\ 'u \fBkernel\-install\fR [OPTIONS...] remove \fIKERNEL\-VERSION\fR .HP \w'\fBkernel\-install\fR\ 'u \fBkernel\-install\fR [OPTIONS...] inspect [\fIKERNEL\-VERSION\fR] [\fIKERNEL\-IMAGE\fR] [\fIINITRD\-FILE\fR...] @@ -454,7 +456,7 @@ Print a short version string and exit\&. Do not pipe output into a pager\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Shows output formatted as JSON\&. Expects one of "short" @@ -634,7 +636,14 @@ will be prepended before can be set to override the location of the configuration files read by \fBkernel\-install\fR\&. When set, install\&.conf, -entry\-token, and other files will be read from this directory\&. +entry\-token, and other files will be read from this directory only\&. Note that this path is relative to the host, and in particular +\fIsymlinks in this directory are resolved relative to the host\fR, even if +\fB\-\-root=\fR\fB\fIroot\fR\fR +is used\&. This means that it is generally +\fInot\fR +correct to use this variable to specify a directory underneath +\fIroot\fR +if symlinks are used there\&. .PP \fI$KERNEL_INSTALL_PLUGINS\fR can be set to override the list of plugins executed by @@ -745,7 +754,7 @@ will be used\&. Added in version 198\&. .RE .PP -/etc/kernel/install\&.conf, /usr/lib/kernel/install\&.conf +/etc/kernel/install\&.conf, /run/kernel/install\&.conf, /usr/local/lib/kernel/install\&.conf, /usr/lib/kernel/install\&.conf, /etc/kernel/install\&.conf\&.d/*\&.conf, /run/kernel/install\&.conf\&.d/*\&.conf, /usr/local/lib/kernel/install\&.conf\&.d/*\&.conf, /usr/lib/kernel/install\&.conf\&.d/*\&.conf .RS 4 Configuration file with options for \fBkernel\-install\fR, as a series of @@ -753,7 +762,8 @@ Configuration file with options for assignments, compatible with shell syntax, following the same rules as described in \fBos-release\fR(5)\&. The first of the files that is found will be used\&. \fI$KERNEL_INSTALL_CONF_ROOT\fR -may be used to override the search path; see below for details\&. +may be used to override the search path; see below for details\&. Drop\-in files may also be used to extend the configuration with overrides, see +\fBsystemd.unit\fR(5)\&. .sp Currently, the following keys are supported: \fIMACHINE_ID=\fR, @@ -814,12 +824,7 @@ environment variable is set, it will override the search path\&. The files will from the directory specified by the environment variable\&. When the variable is not set, the listed paths are tried in turn, and the first file that exists is used\&. .SH "SEE ALSO" .PP -\fBmachine-id\fR(5), -\fBos-release\fR(5), -\fBdepmod\fR(8), -\fBsystemd-boot\fR(7), -\fBukify\fR(1), -\m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[2]\d\s+2 +\fBmachine-id\fR(5), \fBos-release\fR(5), \fBdepmod\fR(8), \fBsystemd-boot\fR(7), \fBukify\fR(1), \m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[2]\d\s+2 .SH "NOTES" .IP " 1." 4 Nowadays actually CPIO archives used as an "initramfs", rather than "initrd". See diff --git a/upstream/fedora-rawhide/man8/ld.so.8 b/upstream/fedora-rawhide/man8/ld.so.8 index 39ca874f..8767b501 100644 --- a/upstream/fedora-rawhide/man8/ld.so.8 +++ b/upstream/fedora-rawhide/man8/ld.so.8 @@ -4,7 +4,7 @@ .\" Various parts: .\" Copyright (C) 2007-9, 2013, 2016 Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH ld.so 8 2024-02-12 "Linux man-pages 6.06" +.TH ld.so 8 2024-02-12 "Linux man-pages 6.7" .SH NAME ld.so, ld\-linux.so \- dynamic linker/loader .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/ldconfig.8 b/upstream/fedora-rawhide/man8/ldconfig.8 index 7efb67fa..1b517421 100644 --- a/upstream/fedora-rawhide/man8/ldconfig.8 +++ b/upstream/fedora-rawhide/man8/ldconfig.8 @@ -5,7 +5,7 @@ .\" .\" Modified, 6 May 2002, Michael Kerrisk, <mtk.manpages@gmail.com> .\" Change listed order of /usr/lib and /lib -.TH ldconfig 8 2023-10-31 "Linux man-pages 6.06" +.TH ldconfig 8 2023-10-31 "Linux man-pages 6.7" .SH NAME ldconfig \- configure dynamic linker run-time bindings .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/lspci.8 b/upstream/fedora-rawhide/man8/lspci.8 index 4bfd1a7b..e541de04 100644 --- a/upstream/fedora-rawhide/man8/lspci.8 +++ b/upstream/fedora-rawhide/man8/lspci.8 @@ -1,4 +1,4 @@ -.TH lspci 8 "25 February 2024" "pciutils-3.11.1" "The PCI Utilities" +.TH lspci 8 "05 April 2024" "pciutils-3.12.0" "The PCI Utilities" .SH NAME lspci \- list all PCI devices .SH SYNOPSIS @@ -116,7 +116,7 @@ Show PCI vendor and device codes as both numbers and names. Use DNS to query the central PCI ID database if a device is not found in the local .B pci.ids file. If the DNS query succeeds, the result is cached in -.B ~/.pciids-cache +.B $XDG_CACHE_HOME/pci-ids and it is recognized in subsequent runs even if .B -q is not given any more. Please use this switch inside automated scripts only @@ -345,7 +345,7 @@ utility to download the most recent version. .B /usr/share/hwdata/pci.ids.gz If lspci is compiled with support for compression, this file is tried before pci.ids. .TP -.B ~/.pciids-cache +.B $XDG_CACHE_HOME/pci-ids All ID's found in the DNS query mode are cached in this file. .SH BUGS diff --git a/upstream/fedora-rawhide/man8/makepkg.8 b/upstream/fedora-rawhide/man8/makepkg.8 index 997369c2..7294cbfb 100644 --- a/upstream/fedora-rawhide/man8/makepkg.8 +++ b/upstream/fedora-rawhide/man8/makepkg.8 @@ -2,12 +2,12 @@ .\" Title: makepkg .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "MAKEPKG" "8" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "MAKEPKG" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -101,7 +101,7 @@ PKGDEST .PP \fB\-g, \-\-geninteg\fR .RS 4 -For each source file in the source array of PKGBUILD, download the file if required and generate integrity checks\&. The integrity checks generated are determined by the checks present in the PKGBUILD, falling back to the value of the INTEGRITY_CHECK array in makepkg\&.conf(5) if these are absent This output can be redirected into your PKGBUILD for source validation using "makepkg \-g >> PKGBUILD"\&. +For each source file in the source array of PKGBUILD, download the file if required and generate integrity checks\&. The integrity checks generated are determined by the checks present in the PKGBUILD, falling back to the value of the INTEGRITY_CHECK array in makepkg\&.conf(5) if these are absent\&. This output can be redirected into your PKGBUILD for source validation using "makepkg \-g >> PKGBUILD"\&. .RE .PP \fB\-\-skipinteg\fR @@ -198,6 +198,11 @@ Display version information\&. Remove the $srcdir before building the package\&. .RE .PP +\fB\-D\fR <dir>, \fB\-\-dir\fR <dir> +.RS 4 +Change to directory <dir> before reading the PKGBUILD or doing anything else\&. +.RE +.PP \fB\-\-allsource\fR .RS 4 Do not actually build the package, but build a source\-only tarball that includes all sources, including those that are normally downloaded via makepkg\&. This is useful for passing a single tarball to another program such as a chroot or remote builder\&. It will also satisfy requirements of the GPL when distributing binary packages\&. @@ -224,6 +229,11 @@ Do not run the check() function in the PKGBUILD or handle the checkdepends\&. Do not run the prepare() function in the PKGBUILD\&. .RE .PP +\fB\-\-noverify\fR +.RS 4 +Do not run the verify() function in the PKGBUILD\&. +.RE +.PP \fB\-\-sign\fR .RS 4 Sign the resulting package with gpg, overriding the setting in @@ -286,6 +296,11 @@ makepkg is designed to be compatible with Reproducible Builds\&. If the \fBSOURC If the \fBSOURCE_DATE_EPOCH\fR environment variable is not set, makepkg will use its own start date for internal use, but will not unify source file timestamps before building\&. .SH "ENVIRONMENT VARIABLES" .PP +\fBMAKEPKG_LIBRARY\fR="/path/to/directory" +.RS 4 +Use an alternative libmakepkg path instead of the /usr/share/makepkg default\&. +.RE +.PP \fBPACMAN\fR .RS 4 The command that will be used to check for missing dependencies and to install and remove packages\&. Pacman\(cqs @@ -382,6 +397,11 @@ The version of the \fI$BUILDTOOL\fR used\&. .RE +.PP +\fBGITFLAGS\fR +.RS 4 +The options to pass when checking out git sources, replacing the default "\-\-mirror"\&. +.RE .SH "CONFIGURATION" .sp See \fBmakepkg.conf\fR(5) for more details on configuring makepkg using the \fImakepkg\&.conf\fR file\&. @@ -515,17 +535,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -608,4 +617,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/mkfs.btrfs.8 b/upstream/fedora-rawhide/man8/mkfs.btrfs.8 index d3a88275..46c87996 100644 --- a/upstream/fedora-rawhide/man8/mkfs.btrfs.8 +++ b/upstream/fedora-rawhide/man8/mkfs.btrfs.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "MKFS.BTRFS" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "MKFS.BTRFS" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME mkfs.btrfs \- create a btrfs filesystem .SH SYNOPSIS @@ -422,14 +422,23 @@ conversion is not possible. .INDENT 0.0 .TP .B raid\-stripe\-tree -(kernel support since 6.7) +(kernel support since 6.7, CONFIG_BTRFS_DEBUG) .sp -New tree for logical file extent mapping where the physical mapping -may not match on multiple devices. this is now used in zoned mode to +Separate tree for logical file extent mapping where the physical mapping +may not match on multiple devices. This is now used in zoned mode to implement RAID0/RAID1* profiles, but can be used in non\-zoned mode as well. The support for RAID56 is in development and will eventually fix the problems with the current implementation. This is a backward incompatible feature and has to be enabled at mkfs time. +.sp +\fBNOTE:\fP +.INDENT 7.0 +.INDENT 3.5 +Due to the status of implementation it is enabled only in +builds with CONFIG_BTRFS_DEBUG. Support by the kernel module +can be found in the sysfs feature list. +.UNINDENT +.UNINDENT .TP .B squota (kernel support since 6.7) @@ -1009,6 +1018,6 @@ than can fit into the filesystem. \fI\%btrfs(5)\fP, \fI\%btrfs(8)\fP, \fI\%btrfs\-balance(8)\fP, -\fBwipefs(8)\fP +\fI\%wipefs(8)\fP .\" Generated by docutils manpage writer. . diff --git a/upstream/fedora-rawhide/man8/mkfs.xfs.8 b/upstream/fedora-rawhide/man8/mkfs.xfs.8 index 891570d0..e4852572 100644 --- a/upstream/fedora-rawhide/man8/mkfs.xfs.8 +++ b/upstream/fedora-rawhide/man8/mkfs.xfs.8 @@ -504,6 +504,33 @@ directories. By default, .B mkfs.xfs will not enable DAX mode. +.TP +.BI concurrency= value +Create enough allocation groups to handle the desired level of concurrency. +The goal of this calculation scheme is to set the number of allocation groups +to an integer multiple of the number of writer threads desired, to minimize +contention of AG locks. +This scheme will neither create fewer AGs than would be created by the default +configuration, nor will it create AGs smaller than 4GB. +This option is not compatible with the +.B agcount +or +.B agsize +options. +The magic value +.I nr_cpus +or +.I 1 +or no value at all will set this parameter to the number of active processors +in the system. +If the kernel advertises that the data device is a non-mechanical storage +device, +.B mkfs.xfs +will use this new geometry calculation scheme. +The magic value of +.I 0 +forces use of the older AG geometry calculations that is used for mechanical +storage. .RE .TP .B \-f @@ -768,6 +795,25 @@ if you want to disable this feature for older kernels which don't support it. .IP This option is only tunable on the deprecated V4 format. +.TP +.BI concurrency= value +Allocate a log that is estimated to be large enough to handle the desired level +of concurrency without userspace program threads contending for log space. +This scheme will neither create a log smaller than the minimum required, +nor create a log larger than the maximum possible. +This option is only valid for internal logs and is not compatible with the +size option. +This option is not compatible with the +.B logdev +or +.B size +options. +The magic value +.I nr_cpus +or +.I 1 +or no value at all will set this parameter to the number of active processors +in the system. .RE .PP .PD 0 diff --git a/upstream/fedora-rawhide/man8/nscd.8 b/upstream/fedora-rawhide/man8/nscd.8 index 7f505e0f..3d2204e1 100644 --- a/upstream/fedora-rawhide/man8/nscd.8 +++ b/upstream/fedora-rawhide/man8/nscd.8 @@ -6,7 +6,7 @@ .\" 2008-12-05 Petr Baudis <pasky@suse.cz> .\" Rewrite the NOTES section to reflect modern reality .\" -.TH nscd 8 2023-10-31 "Linux man-pages 6.06" +.TH nscd 8 2023-10-31 "Linux man-pages 6.7" .SH NAME nscd \- name service cache daemon .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man8/nss-myhostname.8 b/upstream/fedora-rawhide/man8/nss-myhostname.8 index d2e92b58..0b9fab58 100644 --- a/upstream/fedora-rawhide/man8/nss-myhostname.8 +++ b/upstream/fedora-rawhide/man8/nss-myhostname.8 @@ -1,5 +1,5 @@ '\" t -.TH "NSS\-MYHOSTNAME" "8" "" "systemd 255" "nss-myhostname" +.TH "NSS\-MYHOSTNAME" "8" "" "systemd 256~rc3" "nss-myhostname" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -173,9 +173,4 @@ In this case, the local hostname is \fIomega\fR\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBnss-systemd\fR(8), -\fBnss-resolve\fR(8), -\fBnss-mymachines\fR(8), -\fBnsswitch.conf\fR(5), -\fBgetent\fR(1) +\fBsystemd\fR(1), \fBnss-systemd\fR(8), \fBnss-resolve\fR(8), \fBnss-mymachines\fR(8), \fBnsswitch.conf\fR(5), \fBgetent\fR(1) diff --git a/upstream/fedora-rawhide/man8/nss-mymachines.8 b/upstream/fedora-rawhide/man8/nss-mymachines.8 index 60a2b3a7..9a540e9c 100644 --- a/upstream/fedora-rawhide/man8/nss-mymachines.8 +++ b/upstream/fedora-rawhide/man8/nss-mymachines.8 @@ -1,5 +1,5 @@ '\" t -.TH "NSS\-MYMACHINES" "8" "" "systemd 255" "nss-mymachines" +.TH "NSS\-MYMACHINES" "8" "" "systemd 256~rc3" "nss-mymachines" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -130,11 +130,4 @@ Connection to machine rawhide terminated\&. .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-machined.service\fR(8), -\fBmachinectl\fR(1), -\fBnss-systemd\fR(8), -\fBnss-resolve\fR(8), -\fBnss-myhostname\fR(8), -\fBnsswitch.conf\fR(5), -\fBgetent\fR(1) +\fBsystemd\fR(1), \fBsystemd-machined.service\fR(8), \fBmachinectl\fR(1), \fBnss-systemd\fR(8), \fBnss-resolve\fR(8), \fBnss-myhostname\fR(8), \fBnsswitch.conf\fR(5), \fBgetent\fR(1) diff --git a/upstream/fedora-rawhide/man8/nss-resolve.8 b/upstream/fedora-rawhide/man8/nss-resolve.8 index 5c12c8d4..f63ec532 100644 --- a/upstream/fedora-rawhide/man8/nss-resolve.8 +++ b/upstream/fedora-rawhide/man8/nss-resolve.8 @@ -1,5 +1,5 @@ '\" t -.TH "NSS\-RESOLVE" "8" "" "systemd 255" "nss-resolve" +.TH "NSS\-RESOLVE" "8" "" "systemd 256~rc3" "nss-resolve" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -165,10 +165,4 @@ netgroup: nis .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-resolved\fR(8), -\fBnss-systemd\fR(8), -\fBnss-myhostname\fR(8), -\fBnss-mymachines\fR(8), -\fBnsswitch.conf\fR(5), -\fBsystemd.syntax\fR(5) +\fBsystemd\fR(1), \fBsystemd-resolved\fR(8), \fBnss-systemd\fR(8), \fBnss-myhostname\fR(8), \fBnss-mymachines\fR(8), \fBnsswitch.conf\fR(5), \fBsystemd.syntax\fR(5) diff --git a/upstream/fedora-rawhide/man8/nss-systemd.8 b/upstream/fedora-rawhide/man8/nss-systemd.8 index 31d5b1ba..07517bbd 100644 --- a/upstream/fedora-rawhide/man8/nss-systemd.8 +++ b/upstream/fedora-rawhide/man8/nss-systemd.8 @@ -1,5 +1,5 @@ '\" t -.TH "NSS\-SYSTEMD" "8" "" "systemd 255" "nss-systemd" +.TH "NSS\-SYSTEMD" "8" "" "systemd 256~rc3" "nss-systemd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -206,16 +206,7 @@ vu\-rawhide\-1000 1637 pts/8 \-zsh .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.exec\fR(5), -\fBnss-resolve\fR(8), -\fBnss-myhostname\fR(8), -\fBnss-mymachines\fR(8), -\fBsystemd-userdbd.service\fR(8), -\fBsystemd-homed.service\fR(8), -\fBsystemd-machined.service\fR(8), -\fBnsswitch.conf\fR(5), -\fBgetent\fR(1) +\fBsystemd\fR(1), \fBsystemd.exec\fR(5), \fBnss-resolve\fR(8), \fBnss-myhostname\fR(8), \fBnss-mymachines\fR(8), \fBsystemd-userdbd.service\fR(8), \fBsystemd-homed.service\fR(8), \fBsystemd-machined.service\fR(8), \fBnsswitch.conf\fR(5), \fBgetent\fR(1) .SH "NOTES" .IP " 1." 4 User/Group Record Lookup API via Varlink diff --git a/upstream/fedora-rawhide/man8/pacman-conf.8 b/upstream/fedora-rawhide/man8/pacman-conf.8 index 4b632ea4..0aff475b 100644 --- a/upstream/fedora-rawhide/man8/pacman-conf.8 +++ b/upstream/fedora-rawhide/man8/pacman-conf.8 @@ -2,12 +2,12 @@ .\" Title: pacman-conf .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "PACMAN\-CONF" "8" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "PACMAN\-CONF" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -52,7 +52,7 @@ Specify an alternate installation root (default is /)\&. .RE .PP -\fB\-r, \-\-repo\fR <remote> +\fB\-r, \-\-repo\fR <repository> .RS 4 Query options for a specific repository\&. .RE @@ -129,17 +129,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -222,4 +211,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/pacman-db-upgrade.8 b/upstream/fedora-rawhide/man8/pacman-db-upgrade.8 new file mode 100644 index 00000000..2b9420b3 --- /dev/null +++ b/upstream/fedora-rawhide/man8/pacman-db-upgrade.8 @@ -0,0 +1,197 @@ +'\" t +.\" Title: pacman-db-upgrade +.\" Author: [see the "Authors" section] +.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> +.\" Date: 2024-04-14 +.\" Manual: Pacman Manual +.\" Source: Pacman 6.1.0 +.\" Language: English +.\" +.TH "PACMAN\-DB\-UPGRADE" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +pacman-db-upgrade \- upgrade the local pacman database to a newer format +.SH "SYNOPSIS" +.sp +\fIpacman\-db\-upgrade\fR [options] +.SH "DESCRIPTION" +.sp +\fIpacman\-db\-upgrade\fR is a script that upgrades the local database used by \fBpacman\fR(8) to a newer format\&. +.sp +Options +.sp +.if n \{\ +.RS 4 +.\} +.nf +*\-h, \e\-\-help*:: +Show the built\-in help message and exit\&. +*\-V, \e\-\-version*:: +Show version information and exit\&. +*\-d, \e\-\-dbpath* <path>:: +Set an alternate database location\&. +*\-r, \e\-\-root* <path>:: +Set an alternate installation root\&. +*\e\-\-config* <path>:: +Set an alternate configuration file\&. +*\e\-\-nocolor*:: +Remove color from output\&. + +See Also +.fi +.if n \{\ +.RE +.\} +.sp +\fBpacman\fR(8) +.sp +See the pacman website at https://archlinux\&.org/pacman/ for current information on pacman and its related tools\&. +.SH "BUGS" +.sp +Bugs? You must be kidding; there are no bugs in this software\&. But if we happen to be wrong, submit a bug report with as much detail as possible at the Arch Linux Bug Tracker in the Pacman section\&. +.SH "AUTHORS" +.sp +Current maintainers: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Allan McRae <allan@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Morgan Adamiec <morganamilo@archlinux\&.org> +.RE +.sp +Past major contributors: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Judd Vinet <jvinet@zeroflux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Aurelien Foret <aurelien@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Aaron Griffin <aaron@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Dan McGee <dan@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Xavier Chantry <shiningxc@gmail\&.com> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Dave Reisner <dreisner@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp +For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/pacman-key.8 b/upstream/fedora-rawhide/man8/pacman-key.8 index a1403f6e..b06a57b6 100644 --- a/upstream/fedora-rawhide/man8/pacman-key.8 +++ b/upstream/fedora-rawhide/man8/pacman-key.8 @@ -2,12 +2,12 @@ .\" Title: pacman-key .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "PACMAN\-KEY" "8" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "PACMAN\-KEY" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -225,17 +225,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -318,4 +307,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/pacman.8 b/upstream/fedora-rawhide/man8/pacman.8 index aed1dc32..6d9f8879 100644 --- a/upstream/fedora-rawhide/man8/pacman.8 +++ b/upstream/fedora-rawhide/man8/pacman.8 @@ -2,12 +2,12 @@ .\" Title: pacman .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "PACMAN" "8" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "PACMAN" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -250,7 +250,8 @@ Disable defaults for low speed limit and timeout on downloads\&. Use this if you .PP \fB\-\-sysroot\fR <dir> .RS 4 -Specify an alternative system root\&. Pacman will chroot and chdir into the system root prior to running\&. This allows mounted guest systems to be properly operated on\&. Any other paths given will be interpreted as relative to the system root\&. Requires root privileges\&. +Specify an alternative system root\&. This path will be prepended to all other configuration directories and any repository servers beginning with +file://\&. Any paths or URLs passed as targets will not be modified\&. This allows mounted guest systems to be properly operated on\&. .RE .SH "TRANSACTION OPTIONS (APPLY TO \FI\-S\FR, \FI\-R\FR AND \FI\-U\FR)" .PP @@ -261,7 +262,7 @@ Skips dependency version checks\&. Package names are still checked\&. Normally, .PP \fB\-\-assume\-installed\fR <package=version> .RS 4 -Add a virtual package "package" with version "version" to the transaction to satisfy dependencies\&. This allows to disable specific dependency checks without affecting all dependency checks\&. To disable all dependency checking, see the +Add a virtual package "package" with version "version" to the transaction to satisfy dependencies\&. This allows disabling the specific dependency checks without affecting all dependency checks\&. To disable all dependency checking, see the \fI\-\-nodeps\fR option\&. .RE @@ -295,7 +296,7 @@ to specify how targets are displayed\&. The default format string is "%l", which .RS 4 Specify a printf\-like format to control the output of the \fI\-\-print\fR -operation\&. The possible attributes are: "%n" for pkgname, "%v" for pkgver, "%l" for location, "%r" for repository, and "%s" for size\&. Implies +operation\&. The possible attributes are: "%a" for arch, "%b" for builddate, "%d" for description, "%e" for pkgbase, "%f" for filename, "%g" for base64 encoded PGP signature, "%h" for sha256sum, "%m" for md5sum, "%n" for pkgname, "%p" for packager, "%v" for pkgver, "%l" for location, "%r" for repository, "%s" for size, "%C" for checkdepends, "%D" for depends, "%G" for groups, "%H" for conflicts, "%L" for licenses, "%M" for makedepends, "%O" for optional depends, "%P" for provides and "%R" for replaces\&. Implies \fI\-\-print\fR\&. .RE .SH "UPGRADE OPTIONS (APPLY TO \FI\-S\FR AND \FI\-U\FR)" @@ -518,7 +519,9 @@ will do a system upgrade and install/upgrade the "foo" package in the same opera .PP \fB\-y, \-\-refresh\fR .RS 4 -Download a fresh copy of the master package database from the server(s) defined in +Download a fresh copy of the master package databases +\fI(repo\&.db)\fR +from the server(s) defined in \fBpacman.conf\fR(5)\&. This should typically be used each time you use \fI\-\-sysupgrade\fR or @@ -553,7 +556,9 @@ Suppress messages on successful completion of database operations\&. .PP \fB\-y, \-\-refresh\fR .RS 4 -Download fresh package databases from the server\&. Use twice to force a refresh even if databases are up to date\&. +Download fresh package file databases +\fI(repo\&.files)\fR +from the server\&. Use twice to force a refresh even if databases are up to date\&. .RE .PP \fB\-l, \-\-list\fR @@ -691,17 +696,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -784,4 +778,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/pam_systemd.8 b/upstream/fedora-rawhide/man8/pam_systemd.8 index 21a69f0e..07843595 100644 --- a/upstream/fedora-rawhide/man8/pam_systemd.8 +++ b/upstream/fedora-rawhide/man8/pam_systemd.8 @@ -1,5 +1,5 @@ '\" t -.TH "PAM_SYSTEMD" "8" "" "systemd 255" "pam_systemd" +.TH "PAM_SYSTEMD" "8" "" "systemd 256~rc3" "pam_systemd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -136,15 +136,80 @@ The following options are understood: .RS 4 Takes a string argument which sets the session class\&. The \fIXDG_SESSION_CLASS\fR -environment variable (see below) takes precedence\&. One of -"user", -"greeter", -"lock\-screen" -or -"background"\&. See +environment variable (see below) takes precedence\&. See \fBsd_session_get_class\fR(3) -for details about the session class\&. +for a way to query the class of a session\&. The following session classes are defined: .sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.B Table\ \&1.\ \&Session Classes +.TS +allbox tab(:); +lB lB. +T{ +Name +T}:T{ +Explanation +T} +.T& +l l +l l +l l +l l +l l +l l +l l +l l +l l. +T{ +\fBuser\fR +T}:T{ +A regular interactive user session\&. This is the default class for sessions for which a TTY or X display is known at session registration time\&. +T} +T{ +\fBuser\-early\fR +T}:T{ +Similar to "user" but sessions of this class are not ordered after systemd\-user\-sessions\&.service, i\&.e\&. may be started before regular sessions are allowed to be established\&. This session class is the default for sessions of the root user that would otherwise qualify for the \fBuser\fR class, see above\&. (Added in v256\&.) +T} +T{ +\fBuser\-incomplete\fR +T}:T{ +Similar to "user" but for sessions which are not fully set up yet, i\&.e\&. have no home directory mounted or similar\&. This is used by \fBsystemd-homed.service\fR(8) to allow users to log in via \fBssh\fR before their home directory is mounted, delaying the mount until the user provided the unlock password\&. Sessions of this class are upgraded to the regular \fBuser\fR class once the home directory is activated\&. +T} +T{ +\fBgreeter\fR +T}:T{ +Similar to "user" but for sessions that are spawned by a display manager ephemerally and which prompt the user for login credentials\&. +T} +T{ +\fBlock\-screen\fR +T}:T{ +Similar to "user" but for sessions that are spawned by a display manager ephemerally and which show a lock screen that can be used to unlock locked user accounts or sessions\&. +T} +T{ +\fBbackground\fR +T}:T{ +Used for background sessions, such as those invoked by \fBcron\fR and similar tools\&. This is the default class for sessions for which no TTY or X display is known at session registration time\&. +T} +T{ +\fBbackground\-light\fR +T}:T{ +Similar to \fBbackground\fR, but sessions of this class will not pull in the user@\&.service of the user, and thus possibly have no services of the user running\&. (Added in v256\&.) +T} +T{ +\fBmanager\fR +T}:T{ +The user@\&.service service of the user is registered under this session class\&. (Added in v256\&.) +T} +T{ +\fBmanager\-early\fR +T}:T{ +Similar to \fBmanager\fR, but for the root user\&. Compare with the \fBuser\fR vs\&. \fBuser\-early\fR situation\&. (Added in v256\&.) +T} +.TE +.sp 1 Added in version 197\&. .RE .PP @@ -397,18 +462,7 @@ session required pam_unix\&.so .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-logind.service\fR(8), -\fBlogind.conf\fR(5), -\fBloginctl\fR(1), -\fBpam_systemd_home\fR(8), -\fBpam.conf\fR(5), -\fBpam.d\fR(5), -\fBpam\fR(8), -\fBpam_loginuid\fR(8), -\fBsystemd.scope\fR(5), -\fBsystemd.slice\fR(5), -\fBsystemd.service\fR(5) +\fBsystemd\fR(1), \fBsystemd-logind.service\fR(8), \fBlogind.conf\fR(5), \fBloginctl\fR(1), \fBpam_systemd_home\fR(8), \fBpam.conf\fR(5), \fBpam.d\fR(5), \fBpam\fR(8), \fBpam_loginuid\fR(8), \fBsystemd.scope\fR(5), \fBsystemd.slice\fR(5), \fBsystemd.service\fR(5) .SH "NOTES" .IP " 1." 4 JSON User Records diff --git a/upstream/fedora-rawhide/man8/pam_systemd_home.8 b/upstream/fedora-rawhide/man8/pam_systemd_home.8 index 866cecd2..d67b0fe4 100644 --- a/upstream/fedora-rawhide/man8/pam_systemd_home.8 +++ b/upstream/fedora-rawhide/man8/pam_systemd_home.8 @@ -1,5 +1,5 @@ '\" t -.TH "PAM_SYSTEMD_HOME" "8" "" "systemd 255" "pam_systemd_home" +.TH "PAM_SYSTEMD_HOME" "8" "" "systemd 256~rc3" "pam_systemd_home" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -134,14 +134,7 @@ session required pam_unix\&.so .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-homed.service\fR(8), -\fBhomed.conf\fR(5), -\fBhomectl\fR(1), -\fBpam_systemd\fR(8), -\fBpam.conf\fR(5), -\fBpam.d\fR(5), -\fBpam\fR(8) +\fBsystemd\fR(1), \fBsystemd-homed.service\fR(8), \fBhomed.conf\fR(5), \fBhomectl\fR(1), \fBpam_systemd\fR(8), \fBpam.conf\fR(5), \fBpam.d\fR(5), \fBpam\fR(8) .SH "NOTES" .IP " 1." 4 JSON user record diff --git a/upstream/fedora-rawhide/man8/pam_systemd_loadkey.8 b/upstream/fedora-rawhide/man8/pam_systemd_loadkey.8 index 679dfd2e..7de8ce75 100644 --- a/upstream/fedora-rawhide/man8/pam_systemd_loadkey.8 +++ b/upstream/fedora-rawhide/man8/pam_systemd_loadkey.8 @@ -1,5 +1,5 @@ '\" t -.TH "PAM_SYSTEMD_LOADKEY" "8" "" "systemd 255" "pam_systemd_loadkey" +.TH "PAM_SYSTEMD_LOADKEY" "8" "" "systemd 256~rc3" "pam_systemd_loadkey" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -44,10 +44,53 @@ The following options are understood: \fIkeyname=\fR .RS 4 Takes a string argument which sets the keyname to read\&. The default is -"cryptsetup", which is used by +"cryptsetup"\&. During boot, \fBsystemd-cryptsetup@.service\fR(8) -to store LUKS passphrase during boot\&. +stores a passphrase or PIN in the keyring\&. The LUKS2 volume key can also be used, via the +\fBlink\-volume\-key\fR +option in +\fBcrypttab\fR(5)\&. .sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.B Table\ \&1.\ \& Possible values for \fIkeyname\fR\&. +.TS +allbox tab(:); +lB lB. +T{ +Value +T}:T{ +Description +T} +.T& +l l +l l +l l +l l. +T{ +cryptsetup +T}:T{ +Passphrase or recovery key +T} +T{ +fido2\-pin +T}:T{ +Security token PIN +T} +T{ +luks2\-pin +T}:T{ +LUKS2 token PIN +T} +T{ +tpm2\-pin +T}:T{ +TPM2 PIN +T} +.TE +.sp 1 Added in version 255\&. .RE .PP @@ -71,6 +114,7 @@ sddm\-autologin): .\} .nf \-auth optional pam_systemd_loadkey\&.so +\-auth optional pam_gnome_keyring\&.so \-session optional pam_gnome_keyring\&.so auto_start \-session optional pam_kwallet5\&.so auto_start diff --git a/upstream/fedora-rawhide/man8/poweroff.8 b/upstream/fedora-rawhide/man8/poweroff.8 index 92c73aa8..d49ad72e 100644 --- a/upstream/fedora-rawhide/man8/poweroff.8 +++ b/upstream/fedora-rawhide/man8/poweroff.8 @@ -1,5 +1,5 @@ '\" t -.TH "POWEROFF" "8" "" "systemd 255" "poweroff" +.TH "POWEROFF" "8" "" "systemd 256~rc3" "poweroff" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -41,7 +41,7 @@ The following options are understood: \fB\-\-help\fR .RS 4 Print a short help text and exit\&. -.PP +.sp Added in version 253\&. .RE .PP @@ -133,7 +133,4 @@ results in halting the machine only (leaving power on), and is required to actually power it off\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBshutdown\fR(8), -\fBwall\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBshutdown\fR(8), \fBwall\fR(1) diff --git a/upstream/fedora-rawhide/man8/repo-add.8 b/upstream/fedora-rawhide/man8/repo-add.8 index dc4ddb43..e821d3a7 100644 --- a/upstream/fedora-rawhide/man8/repo-add.8 +++ b/upstream/fedora-rawhide/man8/repo-add.8 @@ -2,12 +2,12 @@ .\" Title: repo-add .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "REPO\-ADD" "8" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "REPO\-ADD" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -88,6 +88,11 @@ Only add packages that are not already in the database\&. Warnings will be print .RS 4 Remove old package files from the disk when updating their entry in the database\&. .RE +.PP +\fB\-\-include\-sigs\fR +.RS 4 +Include package PGP signatures in the repository database (if available) +.RE .SH "EXAMPLE" .sp \fIrepo\-add\fR foo\&.db\&.tar\&.xz <pkg1> [<pkg2> \&...] @@ -135,17 +140,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -228,4 +222,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/runlevel.8 b/upstream/fedora-rawhide/man8/runlevel.8 index edbabfde..c19e02fc 100644 --- a/upstream/fedora-rawhide/man8/runlevel.8 +++ b/upstream/fedora-rawhide/man8/runlevel.8 @@ -1,5 +1,5 @@ '\" t -.TH "RUNLEVEL" "8" "" "systemd 255" "runlevel" +.TH "RUNLEVEL" "8" "" "systemd 256~rc3" "runlevel" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -125,6 +125,4 @@ Added in version 237\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.target\fR(5), -\fBsystemctl\fR(1) +\fBsystemd\fR(1), \fBsystemd.target\fR(5), \fBsystemctl\fR(1) diff --git a/upstream/fedora-rawhide/man8/setpci.8 b/upstream/fedora-rawhide/man8/setpci.8 index d32e779c..915ce275 100644 --- a/upstream/fedora-rawhide/man8/setpci.8 +++ b/upstream/fedora-rawhide/man8/setpci.8 @@ -1,4 +1,4 @@ -.TH setpci 8 "25 February 2024" "pciutils-3.11.1" "The PCI Utilities" +.TH setpci 8 "05 April 2024" "pciutils-3.12.0" "The PCI Utilities" .SH NAME setpci \- configure PCI devices .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/shutdown.8 b/upstream/fedora-rawhide/man8/shutdown.8 index fa4aafcf..9830273b 100644 --- a/upstream/fedora-rawhide/man8/shutdown.8 +++ b/upstream/fedora-rawhide/man8/shutdown.8 @@ -1,5 +1,5 @@ '\" t -.TH "SHUTDOWN" "8" "" "systemd 255" "shutdown" +.TH "SHUTDOWN" "8" "" "systemd 256~rc3" "shutdown" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -120,7 +120,4 @@ command in previous init systems (including sysvinit) defaulted to single\-user instead\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBhalt\fR(8), -\fBwall\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBhalt\fR(8), \fBwall\fR(1) diff --git a/upstream/fedora-rawhide/man8/sln.8 b/upstream/fedora-rawhide/man8/sln.8 index 30d5177f..29d960b1 100644 --- a/upstream/fedora-rawhide/man8/sln.8 +++ b/upstream/fedora-rawhide/man8/sln.8 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sln 8 2023-10-31 "Linux man-pages 6.06" +.TH sln 8 2023-10-31 "Linux man-pages 6.7" .SH NAME sln \- create symbolic links .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/ss.8 b/upstream/fedora-rawhide/man8/ss.8 index 073e9f03..4ece41fa 100644 --- a/upstream/fedora-rawhide/man8/ss.8 +++ b/upstream/fedora-rawhide/man8/ss.8 @@ -40,6 +40,10 @@ established connections) sockets. .B \-l, \-\-listening Display only listening sockets (these are omitted by default). .TP +.B \-B, \-\-bound-inactive +Display only TCP bound but inactive (not listening, connecting, etc.) sockets +(these are omitted by default). +.TP .B \-o, \-\-options Show timer information. For TCP protocol, the output format is: .RS @@ -456,6 +460,9 @@ states except for - opposite to .B bucket +.B bound-inactive +- bound but otherwise inactive sockets (not listening, connecting, etc.) + .SH EXPRESSION .B EXPRESSION diff --git a/upstream/fedora-rawhide/man8/systemd-ask-password-console.service.8 b/upstream/fedora-rawhide/man8/systemd-ask-password-console.service.8 index fa9566e6..11623084 100644 --- a/upstream/fedora-rawhide/man8/systemd-ask-password-console.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-ask-password-console.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-ASK\-PASSWORD\-CONSOLE\&.SERVICE" "8" "" "systemd 255" "systemd-ask-password-console.service" +.TH "SYSTEMD\-ASK\-PASSWORD\-CONSOLE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-ask-password-console.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,13 +23,18 @@ systemd-ask-password-console.service, systemd-ask-password-console.path, systemd-ask-password-wall.service, systemd-ask-password-wall.path \- Query the user for system passwords on the console and via wall .SH "SYNOPSIS" .PP +.RS 4 systemd\-ask\-password\-console\&.service -.PP +.RE +.RS 4 systemd\-ask\-password\-console\&.path -.PP +.RE +.RS 4 systemd\-ask\-password\-wall\&.service -.PP +.RE +.RS 4 systemd\-ask\-password\-wall\&.path +.RE .SH "DESCRIPTION" .PP systemd\-ask\-password\-console\&.service @@ -51,9 +56,7 @@ or command line parameters\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-tty-ask-password-agent\fR(1), -\fBwall\fR(1) +\fBsystemd\fR(1), \fBsystemd-tty-ask-password-agent\fR(1), \fBwall\fR(1) .SH "NOTES" .IP " 1." 4 developer documentation diff --git a/upstream/fedora-rawhide/man8/systemd-backlight@.service.8 b/upstream/fedora-rawhide/man8/systemd-backlight@.service.8 index 8d42dc12..24d20739 100644 --- a/upstream/fedora-rawhide/man8/systemd-backlight@.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-backlight@.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BACKLIGHT@\&.SERVICE" "8" "" "systemd 255" "systemd-backlight@.service" +.TH "SYSTEMD\-BACKLIGHT@\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-backlight@.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -33,13 +33,22 @@ load [backlight|leds]:DEVICE .SH "DESCRIPTION" .PP systemd\-backlight@\&.service -is a service that restores the display backlight brightness at early boot and saves it at shutdown\&. On disk, the backlight brightness is stored in -/var/lib/systemd/backlight/\&. During loading, if the udev property -\fBID_BACKLIGHT_CLAMP\fR -is not set to false, the brightness is clamped to a value of at least 1 or 5% of maximum brightness, whichever is greater\&. The percentage can be adjusted by specifying a percentage (needs to be suffixed with +is a service that restores the brightness of a display backlight or LED (e\&.g\&. keyboard backlight) device at early boot, and saves it at shutdown\&. The brightness is stored in +/var/lib/systemd/backlight/\&. +.PP +On restoring brightness of a display backlight device, +\fBsystemd\-backlight\fR +reads +\fIID_BACKLIGHT_CLAMP\fR +udev property, that takes a boolean value or a percentage (needs to be suffixed with "%", e\&.g\&. -"30%") to the property -\fBID_BACKLIGHT_CLAMP\fR\&. +"30%")\&. When a percentage is specified, the saved brightness is clamped to a value of at least 1 or the specified percentage of the maximum brightness, whichever is greater\&. When unset or set to true, the brightness is clamped in the same way with percentage 5%\&. When false, the saved brightness will not be clamped, and loaded as is\&. +.PP +On restoring brightness of a LED device, +\fBsystemd\-backlight\fR +reads +\fIID_LEDS_CLAMP\fR +udev property, that also takes a boolean value or a percentage\&. When a percentage is specified, the saved brightness is clamped to the specified percentage of the maximum brightness\&. When set to true, the brightness is clamped in the same way with percentage 5%\&. When unset or set to false, the saved brightness will not be clamped, and loaded as is\&. .SH "KERNEL COMMAND LINE" .PP systemd\-backlight diff --git a/upstream/fedora-rawhide/man8/systemd-battery-check.service.8 b/upstream/fedora-rawhide/man8/systemd-battery-check.service.8 index 3dcd7676..b40e8b1e 100644 --- a/upstream/fedora-rawhide/man8/systemd-battery-check.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-battery-check.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BATTERY\-CHECK\&.SERVICE" "8" "" "systemd 255" "systemd-battery-check" +.TH "SYSTEMD\-BATTERY\-CHECK\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-battery-check" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -53,7 +53,7 @@ On success (running on AC power or battery capacity greater than 5%), 0 is retur .PP The following variables are understood: .PP -\fIsystemd\&.battery\-check=\fR\fI\fIBOOL\fR\fR +\fIsystemd\&.battery_check=\fR\fI\fIBOOL\fR\fR .RS 4 Takes a boolean\&. If specified with false, \fBsystemd\-battery\-check\fR diff --git a/upstream/fedora-rawhide/man8/systemd-binfmt.service.8 b/upstream/fedora-rawhide/man8/systemd-binfmt.service.8 index da878c7a..66522aa7 100644 --- a/upstream/fedora-rawhide/man8/systemd-binfmt.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-binfmt.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BINFMT\&.SERVICE" "8" "" "systemd 255" "systemd-binfmt.service" +.TH "SYSTEMD\-BINFMT\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-binfmt.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -69,6 +69,4 @@ Print a short version string and exit\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBbinfmt.d\fR(5), -\fBwine\fR(8) +\fBsystemd\fR(1), \fBbinfmt.d\fR(5), \fBwine\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-bless-boot-generator.8 b/upstream/fedora-rawhide/man8/systemd-bless-boot-generator.8 index 462e7d90..25324133 100644 --- a/upstream/fedora-rawhide/man8/systemd-bless-boot-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-bless-boot-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BLESS\-BOOT\-GENERATOR" "8" "" "systemd 255" "systemd-bless-boot-generator" +.TH "SYSTEMD\-BLESS\-BOOT\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-bless-boot-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -37,6 +37,4 @@ implements \fBsystemd.generator\fR(7)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-bless-boot.service\fR(8), -\fBsystemd-boot\fR(7) +\fBsystemd\fR(1), \fBsystemd-bless-boot.service\fR(8), \fBsystemd-boot\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-bless-boot.service.8 b/upstream/fedora-rawhide/man8/systemd-bless-boot.service.8 index fc71f4cb..e2f12124 100644 --- a/upstream/fedora-rawhide/man8/systemd-bless-boot.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-bless-boot.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BLESS\-BOOT\&.SERVICE" "8" "" "systemd 255" "systemd-bless-boot.service" +.TH "SYSTEMD\-BLESS\-BOOT\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-bless-boot.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -38,7 +38,7 @@ style boot counting is used\&. Internally, the service operates based on the \fILoaderBootCountPath\fR EFI variable (of the vendor UUID -\fB4a67b082\-0a4c\-41cf\-b6c7\-440b29bb8c4\fR), which is passed from the boot loader to the OS\&. It contains a file system path (relative to the EFI system partition) of the +\fB4a67b082\-0a4c\-41cf\-b6c7\-440b29bb8c4f\fR), which is passed from the boot loader to the OS\&. It contains a file system path (relative to the EFI system partition) of the \m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[1]\d\s+2 compliant boot loader entry file or unified kernel image file that was used to boot up the system\&. \fBsystemd\-bless\-boot\&.service\fR @@ -108,9 +108,7 @@ Print a short version string and exit\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-boot\fR(7), -\fBsystemd.special\fR(7) +\fBsystemd\fR(1), \fBsystemd-boot\fR(7), \fBsystemd.special\fR(7) .SH "NOTES" .IP " 1." 4 Boot Loader Specification diff --git a/upstream/fedora-rawhide/man8/systemd-boot-check-no-failures.service.8 b/upstream/fedora-rawhide/man8/systemd-boot-check-no-failures.service.8 index d3edc66b..4a5705c4 100644 --- a/upstream/fedora-rawhide/man8/systemd-boot-check-no-failures.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-boot-check-no-failures.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BOOT\-CHECK\-NO\-FAILURES\&.SERVICE" "8" "" "systemd 255" "systemd-boot-check-no-failures.service" +.TH "SYSTEMD\-BOOT\-CHECK\-NO\-FAILURES\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-boot-check-no-failures.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -36,5 +36,4 @@ Note that due the simple nature of this check this service is probably not suita boot\-complete\&.target\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.special\fR(7) +\fBsystemd\fR(1), \fBsystemd.special\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-boot-random-seed.service.8 b/upstream/fedora-rawhide/man8/systemd-boot-random-seed.service.8 index 8fb4d033..a33c8f0d 100644 --- a/upstream/fedora-rawhide/man8/systemd-boot-random-seed.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-boot-random-seed.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BOOT\-RANDOM\-SEED\&.SERVICE" "8" "" "systemd 255" "systemd-boot-random-seed.service" +.TH "SYSTEMD\-BOOT\-RANDOM\-SEED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-boot-random-seed.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -100,12 +100,7 @@ service updates the boot loader random seed with a new value derived from the ke This logic should ensure that the kernel\*(Aqs entropy pool is seeded during earliest bool already, if possible, but the highest quality entropy is propagated back to both on\-disk seeds\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBrandom\fR(4), -\fBbootctl\fR(1), -\fBsystemd-boot\fR(7), -\fBsystemd-stub\fR(7), -\fBsystemd-random-seed.service\fR(8) +\fBsystemd\fR(1), \fBrandom\fR(4), \fBbootctl\fR(1), \fBsystemd-boot\fR(7), \fBsystemd-stub\fR(7), \fBsystemd-random-seed.service\fR(8) .SH "NOTES" .IP " 1." 4 Boot Loader Interface diff --git a/upstream/fedora-rawhide/man8/systemd-bsod.service.8 b/upstream/fedora-rawhide/man8/systemd-bsod.service.8 index 0c1fc877..781f8f6f 100644 --- a/upstream/fedora-rawhide/man8/systemd-bsod.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-bsod.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BSOD\&.SERVICE" "8" "" "systemd 255" "systemd-bsod" +.TH "SYSTEMD\-BSOD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-bsod" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,12 +20,12 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -systemd-bsod.service, systemd-bsod \- Displays boot\-time emergency log message in full screen\&. +systemd-bsod.service, systemd-bsod \- Displays boot\-time emergency log message in full screen .SH "SYNOPSIS" .PP systemd\-bsod\&.service -.HP \w'\fBsystemd\-bsod\fR\ 'u -\fBsystemd\-bsod\fR [OPTIONS...] +.HP \w'\fB/usr/lib/systemd/systemd\-bsod\fR\ 'u +\fB/usr/lib/systemd/systemd\-bsod\fR [OPTIONS...] .SH "DESCRIPTION" .PP systemd\-bsod\&.service @@ -53,6 +53,17 @@ waits continuously for changes in the journal if it doesn\*(Aqt find any emergen .sp Added in version 255\&. .RE +.PP +\fB\-\-tty=\fR\fB\fR +.RS 4 +Specify the TTY to output to\&. By default +\fBsystemd\-bsod\fR +will automatically find a free VT to display the message on\&. If this option is specified a TTY may be selected explicitly\&. Use +\fB\-\-tty=/dev/tty\fR +to direct output to the terminal the command is invoked on\&. +.sp +Added in version 256\&. +.RE .SH "EXIT STATUS" .PP On success (displaying the journal message successfully), 0 is returned, a non\-zero failure code otherwise\&. diff --git a/upstream/fedora-rawhide/man8/systemd-coredump.8 b/upstream/fedora-rawhide/man8/systemd-coredump.8 index 842c5fc9..9167d1d9 100644 --- a/upstream/fedora-rawhide/man8/systemd-coredump.8 +++ b/upstream/fedora-rawhide/man8/systemd-coredump.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-COREDUMP" "8" "" "systemd 255" "systemd-coredump" +.TH "SYSTEMD\-COREDUMP" "8" "" "systemd 256~rc3" "systemd-coredump" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -464,14 +464,7 @@ user\&.coredump\&.exe="/usr/lib64/firefox/firefox" .sp .SH "SEE ALSO" .PP -\fBcoredump.conf\fR(5), -\fBcoredumpctl\fR(1), -\fBsystemd-journald.service\fR(8), -\fBsystemd-tmpfiles\fR(8), -\fBcore\fR(5), -\fBsysctl.d\fR(5), -\fBsystemd-sysctl.service\fR(8), -\m[blue]\fBsystemd Coredump Handling\fR\m[]\&\s-2\u[1]\d\s+2 +\fBcoredump.conf\fR(5), \fBcoredumpctl\fR(1), \fBsystemd-journald.service\fR(8), \fBsystemd-tmpfiles\fR(8), \fBcore\fR(5), \fBsysctl.d\fR(5), \fBsystemd-sysctl.service\fR(8), \m[blue]\fBsystemd Coredump Handling\fR\m[]\&\s-2\u[1]\d\s+2 .SH "NOTES" .IP " 1." 4 systemd Coredump Handling diff --git a/upstream/fedora-rawhide/man8/systemd-cryptsetup-generator.8 b/upstream/fedora-rawhide/man8/systemd-cryptsetup-generator.8 index fda1024a..6ef0e12d 100644 --- a/upstream/fedora-rawhide/man8/systemd-cryptsetup-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-cryptsetup-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-CRYPTSETUP\-GENERATOR" "8" "" "systemd 255" "systemd-cryptsetup-generator" +.TH "SYSTEMD\-CRYPTSETUP\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-cryptsetup-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -223,9 +223,4 @@ Added in version 208\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBcrypttab\fR(5), -\fBsystemd-cryptsetup@.service\fR(8), -\fBsystemd-cryptenroll\fR(1), -\fBcryptsetup\fR(8), -\fBsystemd-fstab-generator\fR(8) +\fBsystemd\fR(1), \fBcrypttab\fR(5), \fBsystemd-cryptsetup@.service\fR(8), \fBsystemd-cryptenroll\fR(1), \fBcryptsetup\fR(8), \fBsystemd-fstab-generator\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-cryptsetup.8 b/upstream/fedora-rawhide/man8/systemd-cryptsetup.8 index cfa85bc0..3af52b7e 100644 --- a/upstream/fedora-rawhide/man8/systemd-cryptsetup.8 +++ b/upstream/fedora-rawhide/man8/systemd-cryptsetup.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-CRYPTSETUP" "8" "" "systemd 255" "systemd-cryptsetup" +.TH "SYSTEMD\-CRYPTSETUP" "8" "" "systemd 256~rc3" "systemd-cryptsetup" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -37,9 +37,9 @@ is used to set up (with \fBattach\fR) and tear down (with \fBdetach\fR) access to an encrypted block device\&. It is primarily used via systemd\-cryptsetup@\&.service -during early boot, but may also be be called manually\&. The positional arguments +during early boot, but may also be called manually\&. The positional arguments \fIVOLUME\fR, -\fISOURCEDEVICE\fR, +\fISOURCE\-DEVICE\fR, \fIKEY\-FILE\fR, and \fICRYPTTAB\-OPTIONS\fR have the same meaning as the fields in @@ -136,14 +136,55 @@ option is set\&. .RE .PP If no suitable key may be acquired via any of the mechanisms describes above, volume activation fails\&. +.SH "CREDENTIALS" +.PP +\fBsystemd\-cryptsetup\fR +supports the service credentials logic as implemented by +\fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR +(see +\fBsystemd.exec\fR(5) +for details)\&. The following credentials are used by +"systemd\-crypsetup@root\&.service" +(generated by +\fBsystemd\-gpt\-auto\-generator\fR) when passed in: +.PP +\fIcryptsetup\&.passphrase\fR +.RS 4 +This credential specifies the passphrase of the LUKS volume\&. +.sp +Added in version 256\&. +.RE +.PP +\fIcryptsetup\&.tpm2\-pin\fR +.RS 4 +This credential specifies the TPM pin\&. +.sp +Added in version 256\&. +.RE +.PP +\fIcryptsetup\&.fido2\-pin\fR +.RS 4 +This credential specifies the FIDO2 token pin\&. +.sp +Added in version 256\&. +.RE +.PP +\fIcryptsetup\&.pkcs11\-pin\fR +.RS 4 +This credential specifies the PKCS11 token pin\&. +.sp +Added in version 256\&. +.RE +.PP +\fIcryptsetup\&.luks2\-pin\fR +.RS 4 +This credential specifies the PIN requested by generic LUKS2 token modules\&. +.sp +Added in version 256\&. +.RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-cryptsetup-generator\fR(8), -\fBcrypttab\fR(5), -\fBsystemd-cryptenroll\fR(1), -\fBcryptsetup\fR(8), -\m[blue]\fBTPM2 PCR Measurements Made by systemd\fR\m[]\&\s-2\u[2]\d\s+2 +\fBsystemd\fR(1), \fBsystemd-cryptsetup-generator\fR(8), \fBcrypttab\fR(5), \fBsystemd-cryptenroll\fR(1), \fBcryptsetup\fR(8), \m[blue]\fBTPM2 PCR Measurements Made by systemd\fR\m[]\&\s-2\u[2]\d\s+2 .SH "NOTES" .IP " 1." 4 password agent logic diff --git a/upstream/fedora-rawhide/man8/systemd-debug-generator.8 b/upstream/fedora-rawhide/man8/systemd-debug-generator.8 index 7aa1b11a..1c6e5844 100644 --- a/upstream/fedora-rawhide/man8/systemd-debug-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-debug-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-DEBUG\-GENERATOR" "8" "" "systemd 255" "systemd-debug-generator" +.TH "SYSTEMD\-DEBUG\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-debug-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -60,13 +60,17 @@ option is specified, the debug shell service "debug\-shell\&.service" is pulled into the boot transaction and a debug shell will be spawned during early boot\&. By default, /dev/tty9 -is used, but a specific tty can also be set, either with or without the +is used, but a specific tty can also be specified, either with or without the +/dev/ +prefix\&. To set the tty to use without enabling the debug shell, the +\fBsystemd\&.default_debug_tty=\fR +option can be used which also takes a tty with or without the /dev/ prefix\&. Note that the shell may also be turned on persistently by enabling it with \fBsystemctl\fR(1)\*(Aqs \fBenable\fR command\&. -\fBrd\&.systemd\&.debug_shell=\fR +\fBrd\&.systemd\&.debug_shell\fR is honored only by initial RAM disk (initrd) while \fBsystemd\&.debug_shell\fR is honored only in the main system\&. @@ -74,8 +78,31 @@ is honored only in the main system\&. systemd\-debug\-generator implements \fBsystemd.generator\fR(7)\&. +.SH "SYSTEM CREDENTIALS" +.PP +\fIsystemd\&.extra\-unit\&.*\fR +.RS 4 +Credentials prefixed with +"systemd\&.extra\-unit\&." +specify additional units to add to the final system\&. Note that these additional units are added to both the initrd and the final system\&. +\fIConditionPathExists=!/etc/initrd\-release\fR +can be used to make sure the unit is conditioned out in the initrd\&. Note that this can also be used to mask units, by simply specifying an empty value\&. +.sp +Added in version 256\&. +.RE +.PP +\fIsystemd\&.unit\-dropin\&.*\fR +.RS 4 +Credentials prefixed with +"systemd\&.unit\-dropin\&." +add drop\-ins for the corresponding units in the final system\&. Each credential must be suffixed with the full unit name including the unit extension\&. Its contents must be a valid unit drop\-in file\&. Optionally, the unit name may be followed with +"~", followed by the drop\-in name without the +"\&.conf" +suffix\&. If not specified, the name of the generated drop\-in will be +"50\-credential\&.conf"\&. Note that these additional drop\-ins are added to both the initrd and the final system\&. +.sp +Added in version 256\&. +.RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBkernel-command-line\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBkernel-command-line\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-environment-d-generator.8 b/upstream/fedora-rawhide/man8/systemd-environment-d-generator.8 index 2e7e31ab..7afa56cf 100644 --- a/upstream/fedora-rawhide/man8/systemd-environment-d-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-environment-d-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-ENVIRONMENT\-D\-GENERATOR" "8" "" "systemd 255" "systemd-environment-d-generator" +.TH "SYSTEMD\-ENVIRONMENT\-D\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-environment-d-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -36,7 +36,4 @@ configuration files and passes it to the user manager instance\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.environment-generator\fR(7), -\fBsystemd.generator\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.environment-generator\fR(7), \fBsystemd.generator\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-fsck@.service.8 b/upstream/fedora-rawhide/man8/systemd-fsck@.service.8 index 5c1cbe90..18d40eb1 100644 --- a/upstream/fedora-rawhide/man8/systemd-fsck@.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-fsck@.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-FSCK@\&.SERVICE" "8" "" "systemd 255" "systemd-fsck@.service" +.TH "SYSTEMD\-FSCK@\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-fsck@.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,13 +23,18 @@ systemd-fsck@.service, systemd-fsck-root.service, systemd-fsck-usr.service, systemd-fsck \- File system checker logic .SH "SYNOPSIS" .PP +.RS 4 systemd\-fsck@\&.service -.PP +.RE +.RS 4 systemd\-fsck\-root\&.service -.PP +.RE +.RS 4 systemd\-fsck\-usr\&.service -.PP +.RE +.RS 4 /usr/lib/systemd/systemd\-fsck +.RE .SH "DESCRIPTION" .PP systemd\-fsck@\&.service, @@ -116,14 +121,4 @@ Added in version 213\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBfsck\fR(8), -\fBsystemd-quotacheck.service\fR(8), -\fBfsck.btrfs\fR(8), -\fBfsck.cramfs\fR(8), -\fBfsck.ext4\fR(8), -\fBfsck.fat\fR(8), -\fBfsck.hfsplus\fR(8), -\fBfsck.minix\fR(8), -\fBfsck.ntfs\fR(8), -\fBfsck.xfs\fR(8) +\fBsystemd\fR(1), \fBfsck\fR(8), \fBsystemd-quotacheck.service\fR(8), \fBfsck.btrfs\fR(8), \fBfsck.cramfs\fR(8), \fBfsck.ext4\fR(8), \fBfsck.fat\fR(8), \fBfsck.hfsplus\fR(8), \fBfsck.minix\fR(8), \fBfsck.ntfs\fR(8), \fBfsck.xfs\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-fstab-generator.8 b/upstream/fedora-rawhide/man8/systemd-fstab-generator.8 index 3b6f3d17..61d06d09 100644 --- a/upstream/fedora-rawhide/man8/systemd-fstab-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-fstab-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-FSTAB\-GENERATOR" "8" "" "systemd 255" "systemd-fstab-generator" +.TH "SYSTEMD\-FSTAB\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-fstab-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -356,14 +356,7 @@ Added in version 254\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBfstab\fR(5), -\fBsystemd.mount\fR(5), -\fBsystemd.swap\fR(5), -\fBsystemd-cryptsetup-generator\fR(8), -\fBsystemd-gpt-auto-generator\fR(8), -\fBkernel-command-line\fR(7), -\m[blue]\fBKnown Environment Variables\fR\m[]\&\s-2\u[1]\d\s+2 +\fBsystemd\fR(1), \fBfstab\fR(5), \fBsystemd.mount\fR(5), \fBsystemd.swap\fR(5), \fBsystemd-cryptsetup-generator\fR(8), \fBsystemd-gpt-auto-generator\fR(8), \fBkernel-command-line\fR(7), \m[blue]\fBKnown Environment Variables\fR\m[]\&\s-2\u[1]\d\s+2 .SH "NOTES" .IP " 1." 4 Known Environment Variables diff --git a/upstream/fedora-rawhide/man8/systemd-getty-generator.8 b/upstream/fedora-rawhide/man8/systemd-getty-generator.8 index a14b9abc..e57b7a32 100644 --- a/upstream/fedora-rawhide/man8/systemd-getty-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-getty-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-GETTY\-GENERATOR" "8" "" "systemd 255" "systemd-getty-generator" +.TH "SYSTEMD\-GETTY\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-getty-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -88,10 +88,7 @@ Added in version 254\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBkernel-command-line\fR(7), -\fBsystemd.system-credentials\fR(7), -\fBagetty\fR(8) +\fBsystemd\fR(1), \fBkernel-command-line\fR(7), \fBsystemd.system-credentials\fR(7), \fBagetty\fR(8) .SH "NOTES" .IP " 1." 4 Container diff --git a/upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 b/upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 index 2282d2fe..2a4a5416 100644 --- a/upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-GPT\-AUTO\-GENERATOR" "8" "" "systemd 255" "systemd-gpt-auto-generator" +.TH "SYSTEMD\-GPT\-AUTO\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-gpt-auto-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -31,12 +31,19 @@ is a unit generator that automatically discovers the root partition, /home/, /srv/, /var/, -/var/tmp/, the EFI System Partition, the Extended Boot Loader Partition, and swap partitions and creates mount and swap units for them, based on the partition type GUIDs of GUID partition tables (GPT)\&. See +/var/tmp/, the EFI System Partition (ESP), the Extended Boot Loader Partition (XBOOTLDR), and swap partitions and creates mount and swap units for them, based on the partition type GUIDs of GUID partition tables (GPT)\&. See \m[blue]\fBUEFI Specification\fR\m[]\&\s-2\u[1]\d\s+2, chapter 5 for more details\&. It implements the \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[2]\d\s+2\&. .PP Note that this generator has no effect on non\-GPT systems\&. It will also not create mount point configuration for directories which already contain files or if the mount point is explicitly configured in -\fBfstab\fR(5)\&. If the units this generator creates are overridden, for example by units in directories with higher precedence, drop\-ins and additional dependencies created by this generator might still be used\&. +\fBfstab\fR(5)\&. Additionally no unit will be created for the ESP or the XBOOTLDR partition if mount entries are found in the +/boot/ +or +/efi/ +hierarchies in +\fBfstab\fR(5)\&. +.PP +If the units this generator creates are overridden, for example by units in directories with higher precedence, drop\-ins and additional dependencies created by this generator might still be used\&. .PP This generator will only look for the root partition on the same physical disk where the EFI System Partition (ESP) is located\&. Note that support from the boot loader is required: the EFI variable \fILoaderDevicePartUUID\fR @@ -62,9 +69,11 @@ This generator looks for the partitions based on their partition type GUID\&. Th .B Table\ \&1.\ \&Partition Type GUIDs .TS allbox tab(:); -lB lB lB lB. +lB lB lB lB lB. T{ -Partition Type GUID +Partition Type +T}:T{ +GUID T}:T{ Name T}:T{ @@ -73,90 +82,108 @@ T}:T{ Explanation T} .T& -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l. +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l. T{ -\fBSD_GPT_ROOT_X86_64\fR \fB4f68bce3\-e8cd\-4db1\-96e7\-fbcaf984b709\fR +\fBSD_GPT_ROOT_X86_64\fR +T}:T{ +\fB4f68bce3\-e8cd\-4db1\-96e7\-fbcaf984b709\fR T}:T{ Root Partition (x86\-64) T}:T{ / T}:T{ -The first partition with this type UUID, located on the same disk as the ESP, is used as the root file system / on AMD64 / 64\-bit x86 systems\&. +The first partition with this type UUID, located on the same disk as the ESP used for booting, is used as the root file system / on AMD64 / 64\-bit x86 systems\&. T} T{ -\fBSD_GPT_ROOT_ARM64\fR \fBb921b045\-1df0\-41c3\-af44\-4c6f280d3fae\fR +\fBSD_GPT_ROOT_ARM64\fR +T}:T{ +\fBb921b045\-1df0\-41c3\-af44\-4c6f280d3fae\fR T}:T{ Root Partition (64\-bit ARM) T}:T{ / T}:T{ -The first partition with this type UUID, located on the same disk as the ESP, is used as the root file system / on AArch64 / 64\-bit ARM systems\&. +The first partition with this type UUID, located on the same disk as the ESP used for booting, is used as the root file system / on AArch64 / 64\-bit ARM systems\&. T} T{ \fBSD_GPT_ROOT_ALPHA\fR \fBSD_GPT_ROOT_ARC\fR \fBSD_GPT_ROOT_ARM\fR \fBSD_GPT_ROOT_ARM64\fR \fBSD_GPT_ROOT_IA64\fR \fBSD_GPT_ROOT_LOONGARCH64\fR \fBSD_GPT_ROOT_MIPS\fR \fBSD_GPT_ROOT_MIPS64\fR \fBSD_GPT_ROOT_MIPS_LE\fR \fBSD_GPT_ROOT_MIPS64_LE\fR \fBSD_GPT_ROOT_PARISC\fR \fBSD_GPT_ROOT_PPC\fR \fBSD_GPT_ROOT_PPC64\fR \fBSD_GPT_ROOT_PPC64_LE\fR \fBSD_GPT_ROOT_RISCV32\fR \fBSD_GPT_ROOT_RISCV64\fR \fBSD_GPT_ROOT_S390\fR \fBSD_GPT_ROOT_S390X\fR \fBSD_GPT_ROOT_TILEGX\fR \fBSD_GPT_ROOT_X86\fR \fBSD_GPT_ROOT_X86_64\fR \fBSD_GPT_USR_ALPHA\fR \fBSD_GPT_USR_ARC\fR \fBSD_GPT_USR_ARM\fR \fBSD_GPT_USR_IA64\fR \fBSD_GPT_USR_LOONGARCH64\fR \fBSD_GPT_USR_MIPS_LE\fR \fBSD_GPT_USR_MIPS64_LE\fR \fBSD_GPT_USR_PARISC\fR \fBSD_GPT_USR_PPC\fR \fBSD_GPT_USR_PPC64\fR \fBSD_GPT_USR_PPC64_LE\fR \fBSD_GPT_USR_RISCV32\fR \fBSD_GPT_USR_RISCV64\fR \fBSD_GPT_USR_S390\fR \fBSD_GPT_USR_S390X\fR \fBSD_GPT_USR_TILEGX\fR \fBSD_GPT_USR_X86\fR T}:T{ -root partitions for other architectures +\&... +T}:T{ +Root partitions for other architectures T}:T{ / T}:T{ -The first partition with the type UUID matching the architecture, located on the same disk as the ESP, is used as the root file system /\&. For the full list and constant values, see \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[2]\d\s+2\&. +The first partition with the type UUID matching the architecture, located on the same disk as the ESP used for booting, is used as the root file system /\&. For the full list and constant values, see \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[2]\d\s+2\&. T} T{ -\fBSD_GPT_HOME\fR \fB933ac7e1\-2eb4\-4f13\-b844\-0e14e2aef915\fR +\fBSD_GPT_HOME\fR +T}:T{ +\fB933ac7e1\-2eb4\-4f13\-b844\-0e14e2aef915\fR T}:T{ Home Partition T}:T{ /home/ T}:T{ -The first partition with this type UUID on the same disk as the ESP is mounted to /home/\&. +The first partition with this type UUID on the same disk as the root partition is mounted to /home/\&. T} T{ -\fBSD_GPT_SRV\fR \fB3b8f8425\-20e0\-4f3b\-907f\-1a25a76f98e8\fR +\fBSD_GPT_SRV\fR +T}:T{ +\fB3b8f8425\-20e0\-4f3b\-907f\-1a25a76f98e8\fR T}:T{ Server Data Partition T}:T{ /srv/ T}:T{ -The first partition with this type UUID on the same disk as the ESP is mounted to /srv/\&. +The first partition with this type UUID on the same disk as the root partition is mounted to /srv/\&. T} T{ -\fBSD_GPT_VAR\fR \fB4d21b016\-b534\-45c2\-a9fb\-5c16e091fd2d\fR +\fBSD_GPT_VAR\fR +T}:T{ +\fB4d21b016\-b534\-45c2\-a9fb\-5c16e091fd2d\fR T}:T{ Variable Data Partition T}:T{ /var/ T}:T{ -The first partition with this type UUID on the same disk as the ESP is mounted to /var/ \(em under the condition its partition UUID matches the first 128 bit of the HMAC\-SHA256 of the GPT type uuid of this partition keyed by the machine ID of the installation stored in \fBmachine-id\fR(5)\&. +The first partition with this type UUID on the same disk as the root partition is mounted to /var/ \(em under the condition its partition UUID matches the first 128 bit of the HMAC\-SHA256 of the GPT type uuid of this partition keyed by the machine ID of the installation stored in \fBmachine-id\fR(5)\&. T} T{ -\fBSD_GPT_TMP\fR \fB7ec6f557\-3bc5\-4aca\-b293\-16ef5df639d1\fR +\fBSD_GPT_TMP\fR +T}:T{ +\fB7ec6f557\-3bc5\-4aca\-b293\-16ef5df639d1\fR T}:T{ Temporary Data Partition T}:T{ /var/tmp/ T}:T{ -The first partition with this type UUID on the same disk as the ESP is mounted to /var/tmp/\&. +The first partition with this type UUID on the same disk as the root partition is mounted to /var/tmp/\&. T} T{ -\fBSD_GPT_SWAP\fR \fB0657fd6d\-a4ab\-43c4\-84e5\-0933c84b4f4f\fR +\fBSD_GPT_SWAP\fR +T}:T{ +\fB0657fd6d\-a4ab\-43c4\-84e5\-0933c84b4f4f\fR T}:T{ Swap T}:T{ n/a T}:T{ -All partitions with this type UUID on the same disk as the ESP are used as swap\&. +All partitions with this type UUID on the same disk as the root partition are used as swap\&. T} T{ -\fBSD_GPT_ESP\fR \fBc12a7328\-f81f\-11d2\-ba4b\-00a0c93ec93b\fR +\fBSD_GPT_ESP\fR +T}:T{ +\fBc12a7328\-f81f\-11d2\-ba4b\-00a0c93ec93b\fR T}:T{ EFI System Partition (ESP) T}:T{ @@ -165,7 +192,9 @@ T}:T{ The first partition with this type UUID located on the same disk as the root partition is mounted to /boot/ or /efi/, see below\&. T} T{ -\fBSD_GPT_XBOOTLDR\fR \fBbc13c2ff\-59e6\-4262\-a352\-b275fd6f7172\fR +\fBSD_GPT_XBOOTLDR\fR +T}:T{ +\fBbc13c2ff\-59e6\-4262\-a352\-b275fd6f7172\fR T}:T{ Extended Boot Loader Partition T}:T{ @@ -185,34 +214,42 @@ This generator understands the following attribute flags for partitions: .B Table\ \&2.\ \&Partition Attribute Flags .TS allbox tab(:); -lB lB lB. +lB lB lB lB. T{ Flag T}:T{ +Value +T}:T{ Applicable to T}:T{ Explanation T} .T& -l l l -l l l -l l l. +l l l l +l l l l +l l l l. T{ -\fBSD_GPT_FLAG_READ_ONLY\fR \fB0x1000000000000000\fR +\fBSD_GPT_FLAG_READ_ONLY\fR +T}:T{ +\fB0x1000000000000000\fR T}:T{ /, /home/, /srv/, /var/, /var/tmp/, Extended Boot Loader Partition T}:T{ Partition is mounted read\-only T} T{ -\fBSD_GPT_FLAG_NO_AUTO\fR \fB0x8000000000000000\fR +\fBSD_GPT_FLAG_NO_AUTO\fR +T}:T{ +\fB0x8000000000000000\fR T}:T{ /, /home/, /srv/, /var/, /var/tmp/, Extended Boot Loader Partition T}:T{ Partition is not mounted automatically T} T{ -\fBSD_GPT_FLAG_NO_BLOCK_IO_PROTOCOL\fR \fB0x0000000000000002\fR +\fBSD_GPT_FLAG_NO_BLOCK_IO_PROTOCOL\fR +T}:T{ +\fB0x0000000000000002\fR T}:T{ EFI System Partition (ESP) T}:T{ @@ -334,16 +371,7 @@ Added in version 254\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.mount\fR(5), -\fBsystemd.swap\fR(5), -\fBsystemd-fstab-generator\fR(8), -\fBsystemd-cryptsetup@.service\fR(8), -\fBsystemd-pcrfs@.service\fR(8), -\fBmachine-id\fR(5), -\fBcryptsetup\fR(8), -\fBfstab\fR(5), -\fBbtrfs\fR(8) +\fBsystemd\fR(1), \fBsystemd.mount\fR(5), \fBsystemd.swap\fR(5), \fBsystemd-fstab-generator\fR(8), \fBsystemd-cryptsetup@.service\fR(8), \fBsystemd-pcrfs@.service\fR(8), \fBmachine-id\fR(5), \fBcryptsetup\fR(8), \fBfstab\fR(5), \fBbtrfs\fR(8) .SH "NOTES" .IP " 1." 4 UEFI Specification diff --git a/upstream/fedora-rawhide/man8/systemd-hibernate-resume-generator.8 b/upstream/fedora-rawhide/man8/systemd-hibernate-resume-generator.8 index 21c57e3f..1f05f4d8 100644 --- a/upstream/fedora-rawhide/man8/systemd-hibernate-resume-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-hibernate-resume-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-HIBERNATE\-RESUME\-GENERATOR" "8" "" "systemd 255" "systemd-hibernate-resume-generator" +.TH "SYSTEMD\-HIBERNATE\-RESUME\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-hibernate-resume-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -27,12 +27,13 @@ systemd-hibernate-resume-generator \- Unit generator for resume= kernel paramete .SH "DESCRIPTION" .PP \fBsystemd\-hibernate\-resume\-generator\fR -is a generator that initiates the procedure to resume the system from hibernation\&. It creates the -\fBsystemd-hibernate-resume.service\fR(8) -unit according to the value of +is a generator that initiates the procedure to resume the system from hibernation\&. When \fBresume=\fR -parameter specified on the kernel command line, or the value of EFI variable -\fIHibernateLocation\fR, which will instruct the kernel to resume the system from the hibernation image on that device\&. +kernel command line option or +\fIHibernateLocation\fR +EFI variable is detected, it enables the +\fBsystemd-hibernate-resume.service\fR(8) +unit, which will instruct the kernel to resume the system from the hibernation image\&. .SH "KERNEL COMMAND LINE" .PP systemd\-hibernate\-resume\-generator @@ -77,6 +78,4 @@ Added in version 240\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-hibernate-resume.service\fR(8), -\fBkernel-command-line\fR(7) +\fBsystemd\fR(1), \fBsystemd-hibernate-resume.service\fR(8), \fBkernel-command-line\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-hibernate-resume.service.8 b/upstream/fedora-rawhide/man8/systemd-hibernate-resume.service.8 index 9117af69..d5109aca 100644 --- a/upstream/fedora-rawhide/man8/systemd-hibernate-resume.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-hibernate-resume.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-HIBERNATE\-RESUME\&.SERVICE" "8" "" "systemd 255" "systemd-hibernate-resume.service" +.TH "SYSTEMD\-HIBERNATE\-RESUME\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-hibernate-resume.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,11 +20,13 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -systemd-hibernate-resume.service, systemd-hibernate-resume \- Resume from hibernation +systemd-hibernate-resume.service, systemd-hibernate-clear.service, systemd-hibernate-resume \- Resume from hibernation .SH "SYNOPSIS" .PP systemd\-hibernate\-resume\&.service .PP +systemd\-hibernate\-clear\&.service +.PP /usr/lib/systemd/systemd\-hibernate\-resume .SH "DESCRIPTION" .PP @@ -33,14 +35,20 @@ initiates the resume from hibernation\&. .PP \fBsystemd\-hibernate\-resume\fR only supports the in\-kernel hibernation implementation, see -\m[blue]\fBSwap suspend\fR\m[]\&\s-2\u[1]\d\s+2\&. Internally, it works by writing the major:minor of specified device node to +\m[blue]\fBSwap suspend\fR\m[]\&\s-2\u[1]\d\s+2\&. Internally, it works by writing the major:minor of selected device node to /sys/power/resume, along with the offset in memory pages (/sys/power/resume_offset) if supported\&. .PP +The resume device node is either passed directly through arguments, or automatically acquired from kernel command line options and/or +\fIHibernateLocation\fR +EFI variable\&. The latter will normally be cleared by +systemd\-hibernate\-resume\&.service +on resumption\&. If a stale variable is detected, it would be cleared by +systemd\-hibernate\-clear\&.service\&. +.PP Failing to initiate a resume is not an error condition\&. It may mean that there was no resume image (e\&. g\&. if the system has been simply powered off and not hibernated)\&. In such cases, the boot is ordinarily continued\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-hibernate-resume-generator\fR(8) +\fBsystemd\fR(1), \fBsystemd-hibernate-resume-generator\fR(8) .SH "NOTES" .IP " 1." 4 Swap suspend diff --git a/upstream/fedora-rawhide/man8/systemd-homed.service.8 b/upstream/fedora-rawhide/man8/systemd-homed.service.8 index b9f44fb1..6ddaf443 100644 --- a/upstream/fedora-rawhide/man8/systemd-homed.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-homed.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-HOMED\&.SERVICE" "8" "" "systemd 255" "systemd-homed.service" +.TH "SYSTEMD\-HOMED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-homed.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -46,6 +46,11 @@ systemd\-homed\&.service synthesizes a local user and group\&. These are made available to the system using the \m[blue]\fBUser/Group Record Lookup API via Varlink\fR\m[]\&\s-2\u[2]\d\s+2, and thus may be browsed with \fBuserdbctl\fR(1)\&. +.PP +systemd\-homed\&.service +also manages blob directories for each home directory it manages\&. See +\m[blue]\fBUser Record Blob Directories\fR\m[]\&\s-2\u[3]\d\s+2 +for more details\&. .SH "KEY MANAGEMENT" .PP User records are cryptographically signed with a public/private key pair (the signature is part of the JSON record itself)\&. For a user to be permitted to log in locally the public key matching the signature of their user record must be installed\&. For a user record to be modified locally the private key matching the signature must be installed locally, too\&. The keys are stored in the @@ -97,12 +102,7 @@ to "quux", and placed under the identical paths there, as currently only a single private key is supported per host\&. Note of course that the latter means that user records generated/signed before the key pair is copied in, lose their validity\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBhomed.conf\fR(5), -\fBhomectl\fR(1), -\fBpam_systemd_home\fR(8), -\fBuserdbctl\fR(1), -\fBorg.freedesktop.home1\fR(5) +\fBsystemd\fR(1), \fBhomed.conf\fR(5), \fBhomectl\fR(1), \fBpam_systemd_home\fR(8), \fBuserdbctl\fR(1), \fBorg.freedesktop.home1\fR(5) .SH "NOTES" .IP " 1." 4 Home Directories @@ -114,3 +114,8 @@ User/Group Record Lookup API via Varlink .RS 4 \%https://systemd.io/USER_GROUP_API .RE +.IP " 3." 4 +User Record Blob Directories +.RS 4 +\%https://systemd.io/USER_RECORD_BLOB_DIRS +.RE diff --git a/upstream/fedora-rawhide/man8/systemd-hostnamed.service.8 b/upstream/fedora-rawhide/man8/systemd-hostnamed.service.8 index af2fd26a..d9355215 100644 --- a/upstream/fedora-rawhide/man8/systemd-hostnamed.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-hostnamed.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-HOSTNAMED\&.SERVICE" "8" "" "systemd 255" "systemd-hostnamed.service" +.TH "SYSTEMD\-HOSTNAMED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-hostnamed.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -111,8 +111,4 @@ and for a description of the D\-Bus API\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBhostname\fR(5), -\fBmachine-info\fR(5), -\fBhostnamectl\fR(1), -\fBsethostname\fR(2) +\fBsystemd\fR(1), \fBhostname\fR(5), \fBmachine-info\fR(5), \fBhostnamectl\fR(1), \fBsethostname\fR(2) diff --git a/upstream/fedora-rawhide/man8/systemd-hwdb.8 b/upstream/fedora-rawhide/man8/systemd-hwdb.8 index 193b99ef..805f6405 100644 --- a/upstream/fedora-rawhide/man8/systemd-hwdb.8 +++ b/upstream/fedora-rawhide/man8/systemd-hwdb.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-HWDB" "8" "" "systemd 255" "systemd-hwdb" +.TH "SYSTEMD\-HWDB" "8" "" "systemd 256~rc3" "systemd-hwdb" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -60,7 +60,7 @@ Print a short help text and exit\&. .SS "systemd\-hwdb [\fIoptions\fR] update" .PP Update the binary database\&. -.SS "systemd\-hwdb [\fIoptions\fR] query [\fIMODALIAS\fR]" +.SS "systemd\-hwdb [\fIoptions\fR] query \fIMODALIAS\fR" .PP Query database and print result\&. .SH "SEE ALSO" diff --git a/upstream/fedora-rawhide/man8/systemd-importd.service.8 b/upstream/fedora-rawhide/man8/systemd-importd.service.8 index a9bdd93f..307d9b6e 100644 --- a/upstream/fedora-rawhide/man8/systemd-importd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-importd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-IMPORTD\&.SERVICE" "8" "" "systemd 255" "systemd-importd.service" +.TH "SYSTEMD\-IMPORTD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-importd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -29,9 +29,8 @@ systemd\-importd\&.service .SH "DESCRIPTION" .PP \fBsystemd\-importd\fR -is a system service that allows importing, exporting and downloading of system images suitable for running as VM or containers\&. It is a companion service for -\fBsystemd-machined.service\fR(8), and provides the implementation for -\fBmachinectl\fR(1)\*(Aqs +is a system service that allows importing, exporting and downloading of disk images\&. It provides the implementation for +\fBimportctl\fR(1)\*(Aqs \fBpull\-raw\fR, \fBpull\-tar\fR, \fBimport\-raw\fR, @@ -48,7 +47,4 @@ and for a description of the D\-Bus API\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBmachinectl\fR(1), -\fBsystemd-machined.service\fR(8), -\fBsystemd-nspawn\fR(1) +\fBsystemd\fR(1), \fBimportctl\fR(1), \fBsystemd-machined.service\fR(8), \fBsystemd-nspawn\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-initctl.service.8 b/upstream/fedora-rawhide/man8/systemd-initctl.service.8 index b88bead9..f6194bd2 100644 --- a/upstream/fedora-rawhide/man8/systemd-initctl.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-initctl.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-INITCTL\&.SERVICE" "8" "" "systemd 255" "systemd-initctl.service" +.TH "SYSTEMD\-INITCTL\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-initctl.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man8/systemd-integritysetup-generator.8 b/upstream/fedora-rawhide/man8/systemd-integritysetup-generator.8 index 67bc9462..c1ecc500 100644 --- a/upstream/fedora-rawhide/man8/systemd-integritysetup-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-integritysetup-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-INTEGRITYSETUP\-GENERATOR" "8" "" "systemd 255" "systemd-integritysetup-generator" +.TH "SYSTEMD\-INTEGRITYSETUP\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-integritysetup-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -38,6 +38,4 @@ implements \fBsystemd.generator\fR(7)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-integritysetup@.service\fR(8), -\fBintegritysetup\fR(8) +\fBsystemd\fR(1), \fBsystemd-integritysetup@.service\fR(8), \fBintegritysetup\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-integritysetup@.service.8 b/upstream/fedora-rawhide/man8/systemd-integritysetup@.service.8 index badc9c26..d0359743 100644 --- a/upstream/fedora-rawhide/man8/systemd-integritysetup@.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-integritysetup@.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-INTEGRITYSETUP@\&.SERVICE" "8" "" "systemd 255" "systemd-integritysetup@.service" +.TH "SYSTEMD\-INTEGRITYSETUP@\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-integritysetup@.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -76,10 +76,7 @@ Added in version 250\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBintegritytab\fR(5), -\fBsystemd-integritysetup-generator\fR(8), -\fBintegritysetup\fR(8) +\fBsystemd\fR(1), \fBintegritytab\fR(5), \fBsystemd-integritysetup-generator\fR(8), \fBintegritysetup\fR(8) .SH "NOTES" .IP " 1." 4 Kernel dm-integrity diff --git a/upstream/fedora-rawhide/man8/systemd-journal-gatewayd.service.8 b/upstream/fedora-rawhide/man8/systemd-journal-gatewayd.service.8 index 5ab1dd0b..9d25e9a7 100644 --- a/upstream/fedora-rawhide/man8/systemd-journal-gatewayd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-journal-gatewayd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-JOURNAL\-GATEWAYD\&.SERVICE" "8" "" "systemd 255" "systemd-journal-gatewayd.service" +.TH "SYSTEMD\-JOURNAL\-GATEWAYD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-journal-gatewayd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -237,9 +237,15 @@ Added in version 197\&. .PP \fBRange: entries=\fR\fB\fIcursor\fR\fR\fB[[:\fR\fB\fInum_skip\fR\fR\fB]:\fR\fB\fInum_entries\fR\fR\fB]\fR .PP +\fBRange: realtime=[\fR\fB\fIsince\fR\fR\fB]:[\fR\fB\fIuntil\fR\fR\fB][[:\fR\fB\fInum_skip\fR\fR\fB]:\fR\fB\fInum_entries\fR\fR\fB]\fR +.PP where \fIcursor\fR is a cursor string, +\fIsince\fR +and +\fIuntil\fR +are timestamps (seconds since 1970\-01\-01 00:00:00 UTC), \fInum_skip\fR is an integer, \fInum_entries\fR @@ -309,12 +315,7 @@ curl \*(Aqhttp://localhost:19531/entries?follow&MESSAGE_ID=fc2e22bc6ee647b6b9072 .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBjournalctl\fR(1), -\fBsystemd.journal-fields\fR(7), -\fBsystemd-journald.service\fR(8), -\fBsystemd-journal-remote.service\fR(8), -\fBsystemd-journal-upload.service\fR(8) +\fBsystemd\fR(1), \fBjournalctl\fR(1), \fBsystemd.journal-fields\fR(7), \fBsystemd-journald.service\fR(8), \fBsystemd-journal-remote.service\fR(8), \fBsystemd-journal-upload.service\fR(8) .SH "NOTES" .IP " 1." 4 Journal JSON Format diff --git a/upstream/fedora-rawhide/man8/systemd-journal-remote.service.8 b/upstream/fedora-rawhide/man8/systemd-journal-remote.service.8 index 32c6bb3d..3b2d93ab 100644 --- a/upstream/fedora-rawhide/man8/systemd-journal-remote.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-journal-remote.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-JOURNAL\-REMOTE\&.SERVICE" "8" "" "systemd 255" "systemd-journal-remote.service" +.TH "SYSTEMD\-JOURNAL\-REMOTE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-journal-remote.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -60,7 +60,7 @@ will exit\&. .PP Active sources can be specified in the following ways: .PP -[SOURCES...] +[SOURCES] .RS 4 When \fB\-\fR @@ -81,7 +81,7 @@ instance, e\&.g\&. http://some\&.host:19531/ or https://some\&.host:19531/\&. Added in version 239\&. .RE .PP -\fB\-\-getter=\*(Aq\fR\fB\fIPROG\fR\fR\fB \fR\fB[OPTIONS...]\fR\fB\*(Aq\fR +\fB\-\-getter=\*(Aq\fR\fB\fIPROG\fR\fR\fB \fR\fB[OPTIONS]\fR\fB\*(Aq\fR .RS 4 Program to invoke to retrieve data\&. The journal event stream must be generated on standard output\&. .sp @@ -340,11 +340,7 @@ systemd\-journal\-remote \-\-url http://some\&.host:19531/entries?boot&follow .sp .SH "SEE ALSO" .PP -\fBjournal-remote.conf\fR(5), -\fBjournalctl\fR(1), -\fBsystemd-journal-gatewayd.service\fR(8), -\fBsystemd-journal-upload.service\fR(8), -\fBsystemd-journald.service\fR(8) +\fBjournal-remote.conf\fR(5), \fBjournalctl\fR(1), \fBsystemd-journal-gatewayd.service\fR(8), \fBsystemd-journal-upload.service\fR(8), \fBsystemd-journald.service\fR(8) .SH "NOTES" .IP " 1." 4 Journal Export Format diff --git a/upstream/fedora-rawhide/man8/systemd-journal-upload.service.8 b/upstream/fedora-rawhide/man8/systemd-journal-upload.service.8 index d74e313e..b08c3eb8 100644 --- a/upstream/fedora-rawhide/man8/systemd-journal-upload.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-journal-upload.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-JOURNAL\-UPLOAD\&.SERVICE" "8" "" "systemd 255" "systemd-journal-upload.service" +.TH "SYSTEMD\-JOURNAL\-UPLOAD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-journal-upload.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -281,8 +281,4 @@ and \fBsystemd\-journal\-upload \-\-help\fR\&. .SH "SEE ALSO" .PP -\fBjournal-upload.conf\fR(5), -\fBsystemd-journal-remote.service\fR(8), -\fBjournalctl\fR(1), -\fBsystemd-journald.service\fR(8), -\fBsystemd-journal-gatewayd.service\fR(8) +\fBjournal-upload.conf\fR(5), \fBsystemd-journal-remote.service\fR(8), \fBjournalctl\fR(1), \fBsystemd-journald.service\fR(8), \fBsystemd-journal-gatewayd.service\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-journald.service.8 b/upstream/fedora-rawhide/man8/systemd-journald.service.8 index 029e419d..e6844501 100644 --- a/upstream/fedora-rawhide/man8/systemd-journald.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-journald.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-JOURNALD\&.SERVICE" "8" "" "systemd 255" "systemd-journald.service" +.TH "SYSTEMD\-JOURNALD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-journald.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,21 +23,30 @@ systemd-journald.service, systemd-journald.socket, systemd-journald-dev-log.socket, systemd-journald-audit.socket, systemd-journald@.service, systemd-journald@.socket, systemd-journald-varlink@.socket, systemd-journald \- Journal service .SH "SYNOPSIS" .PP +.RS 4 systemd\-journald\&.service -.PP +.RE +.RS 4 systemd\-journald\&.socket -.PP +.RE +.RS 4 systemd\-journald\-dev\-log\&.socket -.PP +.RE +.RS 4 systemd\-journald\-audit\&.socket -.PP +.RE +.RS 4 systemd\-journald@\&.service -.PP +.RE +.RS 4 systemd\-journald@\&.socket -.PP +.RE +.RS 4 systemd\-journald\-varlink@\&.socket -.PP +.RE +.RS 4 /usr/lib/systemd/systemd\-journald +.RE .SH "DESCRIPTION" .PP systemd\-journald @@ -268,6 +277,34 @@ command to trigger journal synchronization, and wait for the operation to comple .sp Added in version 228\&. .RE +.SH "CREDENTIALS" +.PP +\fBsystemd\-journald\fR +supports the service credentials logic as implemented by +\fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR +(see +\fBsystemd.exec\fR(5) +for details)\&. The following credentials are used when passed in: +.PP +\fIjournal\&.forward_to_socket\fR +.RS 4 +May contain a socket address to which logs should be forwarded\&. See +\fIForwardToSocket=\fR +in +\fBjournald.conf\fR(5)\&. +.sp +Added in version 256\&. +.RE +.PP +\fIjournal\&.storage\fR +.RS 4 +May be used to specify where journal files should be stored\&. See +\fIStorage=\fR +in +\fBjournald.conf\fR(5)\&. +.sp +Added in version 256\&. +.RE .SH "KERNEL COMMAND LINE" .PP A few configuration parameters from @@ -285,6 +322,15 @@ for information about these settings\&. Added in version 186\&. .RE .PP +\fIsystemd\&.journald\&.max_level_store=\fR, \fIsystemd\&.journald\&.max_level_syslog=\fR, \fIsystemd\&.journald\&.max_level_kmsg=\fR, \fIsystemd\&.journald\&.max_level_console=\fR, \fIsystemd\&.journald\&.max_level_wall=\fR, \fIsystemd\&.journald\&.max_level_socket=\fR +.RS 4 +Controls the maximum log level of messages that are stored in the journal, forwarded to syslog, kmsg, the console, the wall, or a socket\&. This kernel command line options override the settings of the same names in the +\fBjournald.conf\fR(5) +file\&. +.sp +Added in version 232\&. +.RE +.PP Note that these kernel command line options are only honoured by the default namespace, see above\&. .SH "ACCESS CONTROL" .PP @@ -390,15 +436,7 @@ Added in version 228\&. If journal namespacing is used these paths are slightly altered to include a namespace identifier, see above\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBjournalctl\fR(1), -\fBjournald.conf\fR(5), -\fBsystemd.journal-fields\fR(7), -\fBsd-journal\fR(3), -\fBsystemd-coredump\fR(8), -\fBsetfacl\fR(1), -\fBsd_journal_print\fR(3), -\fBpydoc systemd\&.journal\fR +\fBsystemd\fR(1), \fBjournalctl\fR(1), \fBjournald.conf\fR(5), \fBsystemd.journal-fields\fR(7), \fBsd-journal\fR(3), \fBsystemd-coredump\fR(8), \fBsetfacl\fR(1), \fBsd_journal_print\fR(3), \fBpydoc systemd\&.journal\fR .SH "NOTES" .IP " 1." 4 Native Journal Protocol diff --git a/upstream/fedora-rawhide/man8/systemd-localed.service.8 b/upstream/fedora-rawhide/man8/systemd-localed.service.8 index eabe5304..55495b4e 100644 --- a/upstream/fedora-rawhide/man8/systemd-localed.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-localed.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-LOCALED\&.SERVICE" "8" "" "systemd 255" "systemd-localed.service" +.TH "SYSTEMD\-LOCALED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-localed.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -44,8 +44,4 @@ and for a description of the D\-Bus API\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBlocale.conf\fR(5), -\fBvconsole.conf\fR(5), -\fBlocalectl\fR(1), -\fBloadkeys\fR(1) +\fBsystemd\fR(1), \fBlocale.conf\fR(5), \fBvconsole.conf\fR(5), \fBlocalectl\fR(1), \fBloadkeys\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-logind.service.8 b/upstream/fedora-rawhide/man8/systemd-logind.service.8 index f1bf34d2..251b67c2 100644 --- a/upstream/fedora-rawhide/man8/systemd-logind.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-logind.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-LOGIND\&.SERVICE" "8" "" "systemd 255" "systemd-logind.service" +.TH "SYSTEMD\-LOGIND\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-logind.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -184,12 +184,7 @@ If you are interested in writing a display manager that makes use of logind, ple \m[blue]\fBWriting Desktop Environments\fR\m[]\&\s-2\u[4]\d\s+2\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-user-sessions.service\fR(8), -\fBloginctl\fR(1), -\fBlogind.conf\fR(5), -\fBpam_systemd\fR(8), -\fBsd-login\fR(3) +\fBsystemd\fR(1), \fBsystemd-user-sessions.service\fR(8), \fBloginctl\fR(1), \fBlogind.conf\fR(5), \fBpam_systemd\fR(8), \fBsd-login\fR(3) .SH "NOTES" .IP " 1." 4 polkit diff --git a/upstream/fedora-rawhide/man8/systemd-machine-id-commit.service.8 b/upstream/fedora-rawhide/man8/systemd-machine-id-commit.service.8 index c76834db..c7b5ec00 100644 --- a/upstream/fedora-rawhide/man8/systemd-machine-id-commit.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-machine-id-commit.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-MACHINE\-ID\-COMMIT\&.SERVICE" "8" "" "systemd 255" "systemd-machine-id-commit.service" +.TH "SYSTEMD\-MACHINE\-ID\-COMMIT\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-machine-id-commit.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -53,7 +53,4 @@ is read\-only and initially not initialized\&. In this case, the system manager has been remounted writable and the ID may thus be committed to disk to make it permanent\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-machine-id-setup\fR(1), -\fBmachine-id\fR(5), -\fBsystemd-firstboot\fR(1) +\fBsystemd\fR(1), \fBsystemd-machine-id-setup\fR(1), \fBmachine-id\fR(5), \fBsystemd-firstboot\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-machined.service.8 b/upstream/fedora-rawhide/man8/systemd-machined.service.8 index 37940727..9b5dab9c 100644 --- a/upstream/fedora-rawhide/man8/systemd-machined.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-machined.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-MACHINED\&.SERVICE" "8" "" "systemd 255" "systemd-machined.service" +.TH "SYSTEMD\-MACHINED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-machined.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -178,11 +178,7 @@ that employs user namespacing, users/groups are synthesized for the used UIDs/GI or the usual glibc NSS calls\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBmachinectl\fR(1), -\fBsystemd-nspawn\fR(1), -\fBnss-mymachines\fR(8), -\fBsystemd.special\fR(7) +\fBsystemd\fR(1), \fBmachinectl\fR(1), \fBsystemd-nspawn\fR(1), \fBnss-mymachines\fR(8), \fBsystemd.special\fR(7) .SH "NOTES" .IP " 1." 4 gnome-system-monitor diff --git a/upstream/fedora-rawhide/man8/systemd-makefs@.service.8 b/upstream/fedora-rawhide/man8/systemd-makefs@.service.8 index b1f51d1b..903a5921 100644 --- a/upstream/fedora-rawhide/man8/systemd-makefs@.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-makefs@.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-MAKEFS@\&.SERVICE" "8" "" "systemd 255" "systemd-makefs@.service" +.TH "SYSTEMD\-MAKEFS@\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-makefs@.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -70,15 +70,4 @@ and dm\-crypt partitions (see If the creation of a file system or swap device fails, the mount point or swap is failed too\&. If the growing of a file system fails, a warning is emitted\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.mount\fR(8), -\fBsystemd-fstab-generator\fR(8), -\fBsystemd-repart\fR(8), -\fBmkfs.btrfs\fR(8), -\fBmkfs.cramfs\fR(8), -\fBmkfs.ext4\fR(8), -\fBmkfs.fat\fR(8), -\fBmkfs.hfsplus\fR(8), -\fBmkfs.minix\fR(8), -\fBmkfs.ntfs\fR(8), -\fBmkfs.xfs\fR(8) +\fBsystemd\fR(1), \fBsystemd.mount\fR(8), \fBsystemd-fstab-generator\fR(8), \fBsystemd-repart\fR(8), \fBmkfs.btrfs\fR(8), \fBmkfs.cramfs\fR(8), \fBmkfs.ext4\fR(8), \fBmkfs.fat\fR(8), \fBmkfs.hfsplus\fR(8), \fBmkfs.minix\fR(8), \fBmkfs.ntfs\fR(8), \fBmkfs.xfs\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-modules-load.service.8 b/upstream/fedora-rawhide/man8/systemd-modules-load.service.8 index 4aa80ef1..24da2da7 100644 --- a/upstream/fedora-rawhide/man8/systemd-modules-load.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-modules-load.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-MODULES\-LOAD\&.SERVICE" "8" "" "systemd 255" "systemd-modules-load.service" +.TH "SYSTEMD\-MODULES\-LOAD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-modules-load.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -54,5 +54,4 @@ Added in version 187\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBmodules-load.d\fR(5), +\fBsystemd\fR(1), \fBmodules-load.d\fR(5) diff --git a/upstream/fedora-rawhide/man8/systemd-mountfsd.service.8 b/upstream/fedora-rawhide/man8/systemd-mountfsd.service.8 new file mode 100644 index 00000000..907537c7 --- /dev/null +++ b/upstream/fedora-rawhide/man8/systemd-mountfsd.service.8 @@ -0,0 +1,96 @@ +'\" t +.TH "SYSTEMD\-MOUNTFSD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-mountfsd.service" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +systemd-mountfsd.service, systemd-mountfsd \- Disk Image File System Mount Service +.SH "SYNOPSIS" +.PP +systemd\-mountfsd\&.service +.PP +/usr/lib/systemd/systemd\-mountfsd +.SH "DESCRIPTION" +.PP +\fBsystemd\-mountfsd\fR +is a system service that dissects disk images, and returns mount file descriptors for the file systems contained therein to clients, via a Varlink IPC API\&. +.PP +The disk images provided must contain a raw file system image or must follow the +\m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2\&. Before mounting any file systems authenticity of the disk image is established in one or a combination of the following ways: +.sp +.RS 4 +.ie n \{\ +\h'-04' 1.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 1." 4.2 +.\} +If the disk image is located in a regular file in one of the directories +/var/lib/machines/, +/var/lib/portables/, +/var/lib/extensions/, +/var/lib/confexts/ +or their counterparts in the +/etc/, +/run/, +/usr/lib/ +it is assumed to be trusted\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 2.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 2." 4.2 +.\} +If the disk image contains a Verity enabled disk image, along with a signature partition with a key in the kernel keyring or in +/etc/verity\&.d/ +(and related directories) the disk image is considered trusted\&. +.RE +.PP +This service provides one +\m[blue]\fBVarlink\fR\m[]\&\s-2\u[2]\d\s+2 +service: +\fBio\&.systemd\&.MountFileSystem\fR +which accepts a file descriptor to a regular file or block device, and returns a number of file descriptors referring to an +\fBfsmount()\fR +file descriptor the client may then attach to a path of their choice\&. +.PP +The returned mounts are automatically allowlisted in the per\-user\-namespace allowlist maintained by +\fBsystemd-nsresourced.service\fR(8)\&. +.PP +The file systems are automatically fsck\*(Aqed before mounting\&. +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), +\fBsystemd-nsresourced.service\fR(8) +.SH "NOTES" +.IP " 1." 4 +Discoverable Partitions Specification +.RS 4 +\%https://uapi-group.org/specifications/specs/discoverable_partitions_specification/ +.RE +.IP " 2." 4 +Varlink +.RS 4 +\%https://varlink.org/ +.RE diff --git a/upstream/fedora-rawhide/man8/systemd-network-generator.service.8 b/upstream/fedora-rawhide/man8/systemd-network-generator.service.8 index e2d012e7..5a39caa3 100644 --- a/upstream/fedora-rawhide/man8/systemd-network-generator.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-network-generator.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-NETWORK\-GENERATOR\&.SERVICE" "8" "" "systemd 255" "systemd-network-generator.service" +.TH "SYSTEMD\-NETWORK\-GENERATOR\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-network-generator.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -68,7 +68,7 @@ option accepts the special value Added in version 245\&. .RE .PP -\fIifname=\fR, \fInet\&.ifname\-policy=\fR +\fIifname=\fR, \fInet\&.ifname_policy=\fR .RS 4 Translated into \fBsystemd.link\fR(5) @@ -91,8 +91,36 @@ See and \fBsystemd-udevd.service\fR(8) for option syntax and details\&. +.SH "CREDENTIALS" +.PP +\fBsystemd\-network\-generator\fR +supports the service credentials logic as implemented by +\fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR +(see +\fBsystemd.exec\fR(5) +for details)\&. The following credentials are used when passed in: +.PP +\fInetwork\&.conf\&.*\fR, \fInetwork\&.link\&.*\fR, \fInetwork\&.netdev\&.*\fR, \fInetwork\&.network\&.*\fR +.RS 4 +These credentials should contain valid +\fBnetworkd.conf\fR(5), +\fBsystemd.link\fR(5), +\fBsystemd.netdev\fR(5), +\fBsystemd.network\fR(5) +configuration data\&. From each matching credential a separate file is created\&. Example: a passed credential +network\&.link\&.50\-foobar +will be copied into a configuration file +50\-foobar\&.link\&. +.sp +Note that the resulting files are created world\-readable, it\*(Aqs hence recommended to not include secrets in these credentials, but supply them via separate credentials directly to +systemd\-networkd\&.service\&. +.sp +Added in version 256\&. +.RE +.PP +Note that by default the +systemd\-network\-generator\&.service +unit file is set up to inherit the these credentials from the service manager\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-networkd.service\fR(8), -\fBdracut\fR(8) +\fBsystemd\fR(1), \fBsystemd-networkd.service\fR(8), \fBdracut\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-networkd-wait-online.service.8 b/upstream/fedora-rawhide/man8/systemd-networkd-wait-online.service.8 index a1eafa54..b66b5374 100644 --- a/upstream/fedora-rawhide/man8/systemd-networkd-wait-online.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-networkd-wait-online.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-NETWORKD\-WAIT\-ONLINE\&.SERVICE" "8" "" "systemd 255" "systemd-networkd-wait-online.service" +.TH "SYSTEMD\-NETWORKD\-WAIT\-ONLINE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-networkd-wait-online.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -62,7 +62,7 @@ and online\&. .PP The following options are understood: .PP -\fB\-i\fR \fIINTERFACE\fR[:\fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR]], \fB\-\-interface=\fR\fIINTERFACE\fR[:\fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR]] +\fB\-i\fR \fIINTERFACE\fR[:\fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR]], \fB\-\-interface=\fR\fB\fIINTERFACE\fR\fR\fB[:\fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR]]\fR .RS 4 Network interface to wait for before deciding if the system is online\&. This is useful when a system has several interfaces which will be configured, but a particular one is necessary to access some network resources\&. When used, all other interfaces are ignored\&. This option may be used more than once to wait for multiple network interfaces\&. When this option is specified multiple times, then \fBsystemd\-networkd\-wait\-online\fR @@ -80,14 +80,14 @@ otherwise\&. Added in version 213\&. .RE .PP -\fB\-\-ignore=\fR\fIINTERFACE\fR +\fB\-\-ignore=\fR\fB\fIINTERFACE\fR\fR .RS 4 Network interfaces to be ignored when deciding if the system is online\&. By default, only the loopback interface is ignored\&. This option may be used more than once to ignore multiple network interfaces\&. .sp Added in version 219\&. .RE .PP -\fB\-o\fR \fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR], \fB\-\-operational\-state=\fR\fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR] +\fB\-o\fR \fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR], \fB\-\-operational\-state=\fR\fB\fIMIN_OPERSTATE\fR\fR\fB[:\fIMAX_OPERSTATE\fR]\fR .RS 4 Takes a minimum operational state and an optional maximum operational state\&. Please see \fBnetworkctl\fR(1) @@ -160,7 +160,7 @@ waits for one of the specified interfaces to be online\&. This option is useful Added in version 242\&. .RE .PP -\fB\-\-timeout=\fR\fISECS\fR +\fB\-\-timeout=\fR\fB\fISECS\fR\fR .RS 4 Fail the service if the network is not online by the time the timeout elapses\&. A timeout of 0 disables the timeout\&. Defaults to 120 seconds\&. .sp @@ -185,7 +185,4 @@ Print a short version string and exit\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.service\fR(5), -\fBsystemd-networkd.service\fR(8), -\fBnetworkctl\fR(1) +\fBsystemd\fR(1), \fBsystemd.service\fR(5), \fBsystemd-networkd.service\fR(8), \fBnetworkctl\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-networkd.service.8 b/upstream/fedora-rawhide/man8/systemd-networkd.service.8 index f421a6a1..a3f62609 100644 --- a/upstream/fedora-rawhide/man8/systemd-networkd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-networkd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-NETWORKD\&.SERVICE" "8" "" "systemd 255" "systemd-networkd.service" +.TH "SYSTEMD\-NETWORKD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-networkd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -78,10 +78,4 @@ files, see \fBsystemd.netdev\fR(5)\&. .SH "SEE ALSO" .PP -\fBnetworkctl\fR(1), -\fBsystemd\fR(1), -\fBsystemd.link\fR(5), -\fBsystemd.network\fR(5), -\fBsystemd.netdev\fR(5), -\fBsystemd-networkd-wait-online.service\fR(8), -\fBsystemd-network-generator.service\fR(8) +\fBnetworkctl\fR(1), \fBsystemd\fR(1), \fBsystemd.link\fR(5), \fBsystemd.network\fR(5), \fBsystemd.netdev\fR(5), \fBsystemd-networkd-wait-online.service\fR(8), \fBsystemd-network-generator.service\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-nsresourced.service.8 b/upstream/fedora-rawhide/man8/systemd-nsresourced.service.8 new file mode 100644 index 00000000..c4c80865 --- /dev/null +++ b/upstream/fedora-rawhide/man8/systemd-nsresourced.service.8 @@ -0,0 +1,78 @@ +'\" t +.TH "SYSTEMD\-NSRESOURCED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-nsresourced.service" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +systemd-nsresourced.service, systemd-nsresourced \- User Namespace Resource Delegation Service +.SH "SYNOPSIS" +.PP +systemd\-nsresourced\&.service +.PP +/usr/lib/systemd/systemd\-nsresourced +.SH "DESCRIPTION" +.PP +\fBsystemd\-nsresourced\fR +is a system service that permits transient delegation of a a UID/GID range to a user namespace (see +\fBuser_namespaces\fR(7)) allocated by a client, via a Varlink IPC API\&. +.PP +Unprivileged clients may allocate a user namespace, and then request a UID/GID range to be assigned to it via this service\&. The user namespace may then be used to run containers and other sandboxes, and/or apply it to an id\-mapped mount\&. +.PP +Allocations of UIDs/GIDs this way are transient: when a user namespace goes away, its UID/GID range is returned to the pool of available ranges\&. In order to ensure that clients cannot gain persistency in their transient UID/GID range a BPF\-LSM based policy is enforced that ensures that user namespaces set up this way can only write to file systems they allocate themselves or that are explicitly allowlisted via +\fBsystemd\-nsresourced\fR\&. +.PP +\fBsystemd\-nsresourced\fR +automatically ensures that any registered UID ranges show up in the system\*(Aqs NSS database via the +\m[blue]\fBUser/Group Record Lookup API via Varlink\fR\m[]\&\s-2\u[1]\d\s+2\&. +.PP +Currently, only UID/GID ranges consisting of either exactly 1 or exactly 65536 UIDs/GIDs can be registered with this service\&. Moreover, UIDs and GIDs are always allocated together, and symmetrically\&. +.PP +The service provides API calls to allowlist mounts (referenced via their mount file descriptors as per Linux +\fBfsmount()\fR +API), to pass ownership of a cgroup subtree to the user namespace and to delegate a virtual Ethernet device pair to the user namespace\&. When used in combination this is sufficient to implement fully unprivileged container environments, as implemented by +\fBsystemd-nspawn\fR(1), fully unprivileged +\fIRootImage=\fR +(see +\fBsystemd.exec\fR(5)) or fully unprivileged disk image tools such as +\fBsystemd-dissect\fR(1)\&. +.PP +This service provides one +\m[blue]\fBVarlink\fR\m[]\&\s-2\u[2]\d\s+2 +service: +\fBio\&.systemd\&.NamespaceResource\fR +allows registering user namespaces, and assign mounts, cgroups and network interfaces to it\&. +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), +\fBsystemd-mountfsd.service\fR(8), +\fBsystemd-nspawn\fR(1), +\fBsystemd.exec\fR(5), +\fBsystemd-dissect\fR(1), +\fBuser_namespaces\fR(7) +.SH "NOTES" +.IP " 1." 4 +User/Group Record Lookup API via Varlink +.RS 4 +\%https://systemd.io/USER_GROUP_API +.RE +.IP " 2." 4 +Varlink +.RS 4 +\%https://varlink.org/ +.RE diff --git a/upstream/fedora-rawhide/man8/systemd-oomd.service.8 b/upstream/fedora-rawhide/man8/systemd-oomd.service.8 index b29c880d..f39f1704 100644 --- a/upstream/fedora-rawhide/man8/systemd-oomd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-oomd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-OOMD\&.SERVICE" "8" "" "systemd 255" "systemd-oomd.service" +.TH "SYSTEMD\-OOMD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-oomd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -133,11 +133,7 @@ Print a short version string and exit\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-system.conf\fR(5), -\fBsystemd.resource-control\fR(5), -\fBoomd.conf\fR(5), -\fBoomctl\fR(1) +\fBsystemd\fR(1), \fBsystemd-system.conf\fR(5), \fBsystemd.resource-control\fR(5), \fBoomd.conf\fR(5), \fBoomctl\fR(1) .SH "NOTES" .IP " 1." 4 "In defence of swap: common misconceptions" diff --git a/upstream/fedora-rawhide/man8/systemd-pcrlock.8 b/upstream/fedora-rawhide/man8/systemd-pcrlock.8 index b3206f6b..004515d3 100644 --- a/upstream/fedora-rawhide/man8/systemd-pcrlock.8 +++ b/upstream/fedora-rawhide/man8/systemd-pcrlock.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-PCRLOCK" "8" "" "systemd 255" "systemd-pcrlock" +.TH "SYSTEMD\-PCRLOCK" "8" "" "systemd 256~rc3" "systemd-pcrlock" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -22,8 +22,8 @@ .SH "NAME" systemd-pcrlock, systemd-pcrlock-file-system.service, systemd-pcrlock-firmware-code.service, systemd-pcrlock-firmware-config.service, systemd-pcrlock-machine-id.service, systemd-pcrlock-make-policy.service, systemd-pcrlock-secureboot-authority.service, systemd-pcrlock-secureboot-policy.service \- Analyze and predict TPM2 PCR states and generate an access policy from the prediction .SH "SYNOPSIS" -.HP \w'\fB/usr/lib/systemd/systemd\-pcrlock\ \fR\fB[OPTIONS...]\fR\ 'u -\fB/usr/lib/systemd/systemd\-pcrlock \fR\fB[OPTIONS...]\fR +.HP \w'\fB/usr/lib/systemd/systemd\-pcrlock\fR\ 'u +\fB/usr/lib/systemd/systemd\-pcrlock\fR [OPTIONS...] .SH "DESCRIPTION" .PP Note: this command is experimental for now\&. While it is likely to become a regular component of systemd, it might still change in behaviour and interface\&. @@ -80,7 +80,7 @@ The current PCR state of the TPM2 chip\&. Boot component definition files (*\&.pcrlock and *\&.pcrlock\&.d/*\&.pcrlock, see -\fBsystemd.pcrlock\fR(5)) that each define expected measurements for one component of the boot process, permitting alternative variants for each\&. (Variants may be used used to bless multiple kernel versions or boot loader versions at the same time\&.) +\fBsystemd.pcrlock\fR(5)) that each define expected measurements for one component of the boot process, permitting alternative variants for each\&. (Variants may be used to bless multiple kernel versions or boot loader versions at the same time\&.) .RE .PP It uses these inputs to generate a combined event log, validating it against the PCR states\&. It then attempts to recognize event log records and matches them against the defined components\&. For each PCR where this can be done comprehensively (i\&.e\&. where all listed records and all defined components have been matched) this may then be used to predict future PCR measurements, taking the alternative variants defined for each component into account\&. This prediction may then be converted into a TPM2 access policy (consisting of TPM2 @@ -120,7 +120,7 @@ Added in version 255\&. \fBcel\fR .RS 4 This reads the combined TPM2 event log and writes it to STDOUT in -\m[blue]\fBTCG Common Event Log Format (CEL\-JSON)\fR\m[]\&\s-2\u[1]\d\s+2 +\m[blue]\fBTCG Canonical Event Log Format (CEL\-JSON)\fR\m[]\&\s-2\u[1]\d\s+2 format\&. .sp Added in version 255\&. @@ -163,6 +163,20 @@ If the new prediction matches the old this command terminates quickly and execut \fB\-\-force\fR is specified, see below\&.) .sp +Starting with v256, a copy of the +/var/lib/systemd/pcrlock\&.json +policy file is encoded in a credential (see +\fBsystemd-creds\fR(1) +for details) and written to the EFI System Partition or XBOOTLDR partition, in the +/loader/credentials/ +subdirectory\&. There it is picked up at boot by +\fBsystemd-stub\fR(7) +and passed to the invoked initrd, where it can be used to unlock the root file system (which typically contains +/var/, which is where the primary copy of the policy is located, which hence cannot be used to unlock the root file system)\&. The credential file is named after the boot entry token of the installation (see +\fBbootctl\fR(1)), which is configurable via the +\fB\-\-entry\-token=\fR +switch, see below\&. +.sp Added in version 255\&. .RE .PP @@ -372,7 +386,7 @@ Generates/removes a \&.pcrlock file based on raw binary data\&. The data is either read from the specified file or from STDIN (if none is specified)\&. This requires that \fB\-\-pcrs=\fR -is specified\&. The generated pcrlock file is written to the file specified via +is specified\&. The generated \&.pcrlock file is written to the file specified via \fB\-\-pcrlock=\fR or to STDOUT (if none is specified)\&. .sp @@ -410,7 +424,7 @@ Added in version 255\&. .PP \fB\-\-nv\-index=\fR .RS 4 -Specifies to NV index to store the policy in\&. Honoured by +Specifies the NV index to store the policy in\&. Honoured by \fBmake\-policy\fR\&. If not specified the command will automatically pick a free NV index\&. .sp Added in version 255\&. @@ -462,8 +476,20 @@ Added in version 255\&. .PP \fB\-\-recovery\-pin=\fR .RS 4 -Takes a boolean\&. Defaults to false\&. Honoured by -\fBmake\-policy\fR\&. If true, will query the user for a PIN to unlock the TPM2 NV index with\&. If no policy was created before this PIN is used to protect the newly allocated NV index\&. If a policy has been created before the PIN is used to unlock write access to the NV index\&. If this option is not used a PIN is automatically generated\&. Regardless if user supplied or automatically generated, it is stored in encrypted form in the policy metadata file\&. The recovery PIN may be used to regain write access to an NV index in case the access policy became out of date\&. +Takes one of +"hide", +"show" +or +"query"\&. Defaults to +"hide"\&. Honoured by +\fBmake\-policy\fR\&. If +"query", will query the user for a PIN to unlock the TPM2 NV index with\&. If no policy was created before, this PIN is used to protect the newly allocated NV index\&. If a policy has been created before, the PIN is used to unlock write access to the NV index\&. If either +"hide" +or +"show" +is used, a PIN is automatically generated, and \(em only in case of +"show" +\(em displayed on screen\&. Regardless if user supplied or automatically generated, it is stored in encrypted form in the policy metadata file\&. The recovery PIN may be used to regain write access to an NV index in case the access policy became out of date\&. .sp Added in version 255\&. .RE @@ -493,7 +519,18 @@ If specified with Added in version 255\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-entry\-token=\fR +.RS 4 +Sets the boot entry token to use for the file name for the pcrlock policy credential in the EFI System Partition or XBOOTLDR partition\&. See the +\fBbootctl\fR(1) +option of the same regarding expected values\&. This switch has an effect on the +\fBmake\-policy\fR +command only\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Shows output formatted as JSON\&. Expects one of "short" @@ -523,15 +560,10 @@ Print a short version string and exit\&. On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.pcrlock\fR(5), -\fBsystemd-cryptenroll\fR(1), -\fBsystemd-cryptsetup@.service\fR(8), -\fBsystemd-repart\fR(8), -\fBsystemd-pcrmachine.service\fR(8) +\fBsystemd\fR(1), \fBsystemd.pcrlock\fR(5), \fBsystemd-cryptenroll\fR(1), \fBsystemd-cryptsetup@.service\fR(8), \fBsystemd-repart\fR(8), \fBsystemd-pcrmachine.service\fR(8), \fBsystemd-creds\fR(1), \fBsystemd-stub\fR(7), \fBbootctl\fR(1) .SH "NOTES" .IP " 1." 4 -TCG Common Event Log Format (CEL-JSON) +TCG Canonical Event Log Format (CEL-JSON) .RS 4 \%https://trustedcomputinggroup.org/resource/canonical-event-log-format/ .RE diff --git a/upstream/fedora-rawhide/man8/systemd-pcrphase.service.8 b/upstream/fedora-rawhide/man8/systemd-pcrphase.service.8 index 38f7e40c..5236243d 100644 --- a/upstream/fedora-rawhide/man8/systemd-pcrphase.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-pcrphase.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-PCRPHASE\&.SERVICE" "8" "" "systemd 255" "systemd-pcrphase.service" +.TH "SYSTEMD\-PCRPHASE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-pcrphase.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -204,7 +204,7 @@ are specified defaults to 15, otherwise defaults to 11\&. Added in version 255\&. .RE .PP -\fB\-\-tpm2\-device=\fR\fIPATH\fR +\fB\-\-tpm2\-device=\fR\fB\fIPATH\fR\fR .RS 4 Controls which TPM2 device to use\&. Expects a device node path referring to the TPM2 chip (e\&.g\&. /dev/tpmrm0)\&. Alternatively the special value @@ -254,7 +254,7 @@ Measurements are logged into an event log file maintained in /run/log/systemd/tpm2\-measure\&.log, which contains a \m[blue]\fBJSON\-SEQ\fR\m[]\&\s-2\u[1]\d\s+2 series of objects that follow the general structure of the -\m[blue]\fBTCG Common Event Log Format (CEL\-JSON)\fR\m[]\&\s-2\u[2]\d\s+2 +\m[blue]\fBTCG Canonical Event Log Format (CEL\-JSON)\fR\m[]\&\s-2\u[2]\d\s+2 event objects (but lack the "recnum" field)\&. @@ -269,12 +269,7 @@ Added in version 252\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-stub\fR(7), -\fBsystemd-measure\fR(1), -\fBsystemd-gpt-auto-generator\fR(8), -\fBsystemd-fstab-generator\fR(8), -\m[blue]\fBTPM2 PCR Measurements Made by systemd\fR\m[]\&\s-2\u[3]\d\s+2 +\fBsystemd\fR(1), \fBsystemd-stub\fR(7), \fBsystemd-measure\fR(1), \fBsystemd-gpt-auto-generator\fR(8), \fBsystemd-fstab-generator\fR(8), \m[blue]\fBTPM2 PCR Measurements Made by systemd\fR\m[]\&\s-2\u[3]\d\s+2 .SH "NOTES" .IP " 1." 4 JSON-SEQ @@ -282,7 +277,7 @@ JSON-SEQ \%https://www.rfc-editor.org/rfc/rfc7464.html .RE .IP " 2." 4 -TCG Common Event Log Format (CEL-JSON) +TCG Canonical Event Log Format (CEL-JSON) .RS 4 \%https://trustedcomputinggroup.org/resource/canonical-event-log-format/ .RE diff --git a/upstream/fedora-rawhide/man8/systemd-portabled.service.8 b/upstream/fedora-rawhide/man8/systemd-portabled.service.8 index e3b40f6e..36a58bb2 100644 --- a/upstream/fedora-rawhide/man8/systemd-portabled.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-portabled.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-PORTABLED\&.SERVICE" "8" "" "systemd 255" "systemd-portabled.service" +.TH "SYSTEMD\-PORTABLED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-portabled.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -41,9 +41,7 @@ See the page for details about the concepts this service implements\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBportablectl\fR(1), -\fBorg.freedesktop.portable1\fR(5) +\fBsystemd\fR(1), \fBportablectl\fR(1), \fBorg.freedesktop.portable1\fR(5) .SH "NOTES" .IP " 1." 4 Portable Services diff --git a/upstream/fedora-rawhide/man8/systemd-poweroff.service.8 b/upstream/fedora-rawhide/man8/systemd-poweroff.service.8 index b7a3d813..9aecb49d 100644 --- a/upstream/fedora-rawhide/man8/systemd-poweroff.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-poweroff.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-POWEROFF\&.SERVICE" "8" "" "systemd 255" "systemd-poweroff.service" +.TH "SYSTEMD\-POWEROFF\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-poweroff.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -68,7 +68,7 @@ and pass one arguments to them: either "reboot", or "kexec", depending on the chosen action\&. All executables in this directory are executed in parallel, and execution of the action is not continued before all executables finished\&. Note that these executables are run \fIafter\fR -all services have been shut down, and after most mounts have been detached (the root file system as well as +all services have been shut down, and after most mounts have been unmounted (the root file system as well as /run/ and various API file systems are still around though)\&. This means any programs dropped into this directory must be prepared to run in such a limited execution environment and not rely on external services or hierarchies such as /var/ @@ -84,10 +84,4 @@ Another form of shutdown is provided by the functionality\&. It reboots only the OS userspace, leaving the kernel, firmware, and hardware as it is\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.special\fR(7), -\fBreboot\fR(2), -\fBsystemd-suspend.service\fR(8), -\fBsystemd-soft-reboot.service\fR(8), -\fBbootup\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.special\fR(7), \fBreboot\fR(2), \fBsystemd-suspend.service\fR(8), \fBsystemd-soft-reboot.service\fR(8), \fBbootup\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-pstore.service.8 b/upstream/fedora-rawhide/man8/systemd-pstore.service.8 index 3eb96dec..ebf9b0ff 100644 --- a/upstream/fedora-rawhide/man8/systemd-pstore.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-pstore.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-PSTORE\&.SERVICE" "8" "" "systemd 255" "systemd-pstore.service" +.TH "SYSTEMD\-PSTORE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-pstore.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man8/systemd-quotacheck.service.8 b/upstream/fedora-rawhide/man8/systemd-quotacheck.service.8 index 5a4d5e34..17ddbaff 100644 --- a/upstream/fedora-rawhide/man8/systemd-quotacheck.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-quotacheck.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-QUOTACHECK\&.SERVICE" "8" "" "systemd 255" "systemd-quotacheck.service" +.TH "SYSTEMD\-QUOTACHECK\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-quotacheck.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -51,6 +51,4 @@ Added in version 186\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBquotacheck\fR(8), -\fBsystemd-fsck@.service\fR(8) +\fBsystemd\fR(1), \fBquotacheck\fR(8), \fBsystemd-fsck@.service\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-random-seed.service.8 b/upstream/fedora-rawhide/man8/systemd-random-seed.service.8 index d8cbd444..4c069fc1 100644 --- a/upstream/fedora-rawhide/man8/systemd-random-seed.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-random-seed.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-RANDOM\-SEED\&.SERVICE" "8" "" "systemd 255" "systemd-random-seed.service" +.TH "SYSTEMD\-RANDOM\-SEED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-random-seed.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -67,12 +67,7 @@ Added in version 243\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBrandom\fR(4), -\fBsystemd-boot\fR(7), -\fBsystemd-stub\fR(7), -\fBbootctl\fR(4), -\fBsystemd-boot-random-seed.service\fR(8) +\fBsystemd\fR(1), \fBrandom\fR(4), \fBsystemd-boot\fR(7), \fBsystemd-stub\fR(7), \fBbootctl\fR(4), \fBsystemd-boot-random-seed.service\fR(8) .SH "NOTES" .IP " 1." 4 Safely Building Images diff --git a/upstream/fedora-rawhide/man8/systemd-rc-local-generator.8 b/upstream/fedora-rawhide/man8/systemd-rc-local-generator.8 index 81d97fed..ad732c74 100644 --- a/upstream/fedora-rawhide/man8/systemd-rc-local-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-rc-local-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-RC\-LOCAL\-GENERATOR" "8" "" "systemd 255" "systemd-rc-local-generator" +.TH "SYSTEMD\-RC\-LOCAL\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-rc-local-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -63,12 +63,14 @@ After=network\-online\&.target .PP Support for /etc/rc\&.d/rc\&.local -is provided for compatibility with specific System V systems only\&. However, it is strongly recommended to avoid making use of this script today, and instead provide proper unit files with appropriate dependencies for any scripts to run during the boot process\&. Note that the path to the script is set at compile time and varies between distributions\&. +is provided for compatibility with specific System\ \&V systems only\&. However, it is strongly recommended to avoid using this script today, and instead provide proper unit files with appropriate dependencies for any scripts to run during the boot process\&. Note that the path to the script is set at compile time and varies between distributions\&. .PP systemd\-rc\-local\-generator implements \fBsystemd.generator\fR(7)\&. +.SH "NOTES" +.PP +On systems with SELinux, when creating the file, make sure to set the appropriate context, e\&.g\&. with "\fBsudo restorecon \-v /etc/rc\&.d/rc\&.local\fR"\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-remount-fs.service.8 b/upstream/fedora-rawhide/man8/systemd-remount-fs.service.8 index b9afacff..b58e012f 100644 --- a/upstream/fedora-rawhide/man8/systemd-remount-fs.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-remount-fs.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-REMOUNT\-FS\&.SERVICE" "8" "" "systemd 255" "systemd-remount-fs.service" +.TH "SYSTEMD\-REMOUNT\-FS\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-remount-fs.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -58,11 +58,7 @@ is usually pulled in by and other options\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBfstab\fR(5), -\fBmount\fR(8), -\fBsystemd-fstab-generator\fR(8), -\fBsystemd-gpt-auto-generator\fR(8) +\fBsystemd\fR(1), \fBfstab\fR(5), \fBmount\fR(8), \fBsystemd-fstab-generator\fR(8), \fBsystemd-gpt-auto-generator\fR(8) .SH "NOTES" .IP " 1." 4 API File Systems diff --git a/upstream/fedora-rawhide/man8/systemd-repart.8 b/upstream/fedora-rawhide/man8/systemd-repart.8 index b873a9f5..58006473 100644 --- a/upstream/fedora-rawhide/man8/systemd-repart.8 +++ b/upstream/fedora-rawhide/man8/systemd-repart.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-REPART" "8" "" "systemd 255" "systemd-repart" +.TH "SYSTEMD\-REPART" "8" "" "systemd 256~rc3" "systemd-repart" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -415,6 +415,19 @@ setting in partition files\&. Added in version 252\&. .RE .PP +\fB\-\-private\-key\-source=\fR +.RS 4 +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 +\fIVerity=signature\fR +setting in partition files\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-\-certificate=\fR .RS 4 Takes a file system path\&. Configures the PEM encoded X\&.509 certificate to use when creating verity signature partitions with the @@ -435,7 +448,7 @@ and have the same effect on partitions where TPM2 enrollment is requested\&. Added in version 248\&. .RE .PP -\fB\-\-tpm2\-device\-key=\fR [PATH], \fB\-\-tpm2\-seal\-key\-handle=\fR [HANDLE] +\fB\-\-tpm2\-device\-key=\fR\fB\fIPATH\fR\fR, \fB\-\-tpm2\-seal\-key\-handle=\fR\fB\fIHANDLE\fR\fR .RS 4 Configures a TPM2 SRK key to bind encryption to\&. See \fBsystemd-cryptenroll\fR(1) @@ -444,7 +457,7 @@ for details on this option\&. Added in version 255\&. .RE .PP -\fB\-\-tpm2\-public\-key=\fR [PATH], \fB\-\-tpm2\-public\-key\-pcrs=\fR [PCR...] +\fB\-\-tpm2\-public\-key=\fR\fB\fIPATH\fR\fR, \fB\-\-tpm2\-public\-key\-pcrs=\fR\fB\fIPCR\fR\fI[+PCR\&.\&.\&.]\fR\fR .RS 4 Configures a TPM2 signed PCR policy to bind encryption to\&. See \fBsystemd-cryptenroll\fR(1) @@ -453,7 +466,7 @@ for details on these two options\&. Added in version 252\&. .RE .PP -\fB\-\-tpm2\-pcrlock=\fR [PATH] +\fB\-\-tpm2\-pcrlock=\fR\fB\fIPATH\fR\fR .RS 4 Configures a TPM2 pcrlock policy to bind encryption to\&. See \fBsystemd-cryptenroll\fR(1) @@ -462,7 +475,7 @@ for details on this option\&. Added in version 255\&. .RE .PP -\fB\-\-split=\fR [BOOL] +\fB\-\-split=\fR\fB\fIBOOL\fR\fR .RS 4 Enables generation of split artifacts from partitions configured with \fISplitName=\fR\&. If enabled, for each partition with @@ -485,7 +498,7 @@ is enabled\&. Added in version 252\&. .RE .PP -\fB\-\-include\-partitions=\fR [PARTITION...], \fB\-\-exclude\-partitions=\fR [PARTITION...] +\fB\-\-include\-partitions=\fR\fB\fIPARTITIONS\fR\fR, \fB\-\-exclude\-partitions=\fR\fB\fIPARTITIONS\fR\fR .RS 4 These options specify which partition types \fBsystemd\-repart\fR @@ -501,7 +514,7 @@ in Added in version 253\&. .RE .PP -\fB\-\-defer\-partitions=\fR [PARTITION...] +\fB\-\-defer\-partitions=\fR\fB\fIPARTITIONS\fR\fR .RS 4 This option specifies for which partition types \fBsystemd\-repart\fR @@ -514,7 +527,7 @@ was executed\&. Added in version 253\&. .RE .PP -\fB\-\-sector\-size=\fR [BYTES] +\fB\-\-sector\-size=\fR\fB\fIBYTES\fR\fR .RS 4 This option allows configuring the sector size of the image produced by \fBsystemd\-repart\fR\&. It takes a value that is a power of @@ -527,7 +540,7 @@ and Added in version 253\&. .RE .PP -\fB\-\-architecture=\fR [ARCH] +\fB\-\-architecture=\fR\fB\fIARCH\fR\fR .RS 4 This option allows overriding the architecture used for architecture specific partition types\&. For example, if set to "arm64" @@ -562,7 +575,7 @@ or Added in version 254\&. .RE .PP -\fB\-\-offline=\fR [BOOL] +\fB\-\-offline=\fR\fB\fIBOOL\fR\fR .RS 4 Instructs \fBsystemd\-repart\fR @@ -576,7 +589,7 @@ will build the image online if possible and fall back to building the image offl Added in version 254\&. .RE .PP -\fB\-\-copy\-from=\fR [IMAGE] +\fB\-\-copy\-from=\fR\fB\fIIMAGE\fR\fR .RS 4 Instructs \fBsystemd\-repart\fR @@ -585,7 +598,7 @@ to synthesize partition definitions from the partition table in the given image\ Added in version 255\&. .RE .PP -\fB\-\-copy\-source=\fR\fIPATH\fR, \fB\-s\fR \fIPATH\fR +\fB\-\-copy\-source=\fR\fB\fIPATH\fR\fR, \fB\-s\fR \fIPATH\fR .RS 4 Specifies a source directory all \fICopyFiles=\fR @@ -603,7 +616,7 @@ where the latter takes precedence\&. Added in version 255\&. .RE .PP -\fB\-\-make\-ddi=\fR\fITYPE\fR +\fB\-\-make\-ddi=\fR\fB\fITYPE\fR\fR .RS 4 Takes one of "sysext", @@ -662,6 +675,32 @@ Shortcuts for Added in version 255\&. .RE .PP +\fB\-\-generate\-fstab=\fR\fB\fIPATH\fR\fR +.RS 4 +Specifies a path where to write fstab entries for the mountpoints configured with +\fBMountPoint=\fR +in the root directory specified with +\fB\-\-copy\-source=\fR +or +\fB\-\-root=\fR +or in the host\*(Aqs root directory if neither is specified\&. Disabled by default\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-generate\-crypttab=\fR\fB\fIPATH\fR\fR +.RS 4 +Specifies a path where to write crypttab entries for the encrypted volumes configured with +\fBEncryptedVolume=\fR +in the root directory specified with +\fB\-\-copy\-source=\fR +or +\fB\-\-root=\fR +or in the host\*(Aqs root directory if neither is specified\&. Disabled by default\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-h\fR, \fB\-\-help\fR .RS 4 Print a short help text and exit\&. @@ -682,7 +721,7 @@ Do not pipe output into a pager\&. Do not print the legend, i\&.e\&. column headers and the footer with hints\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Shows output formatted as JSON\&. Expects one of "short" @@ -701,7 +740,7 @@ On success, 0 is returned, a non\-zero failure code otherwise\&. .PP The following creates a configuration extension DDI (confext) for an /etc/motd -update\&. +update: .sp .if n \{\ .RS 4 @@ -724,14 +763,37 @@ systemd\-confext refresh .PP The DDI generated that way may be applied to the system with \fBsystemd-confext\fR(1)\&. +.PP +\fBExample\ \&2.\ \&Generate a system extension image and sign it via PKCS11\fR +.PP +The following creates a system extension DDI (sysext) for an +/usr/foo +update and signs it with a hardware token via PKCS11\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +mkdir tree tree/usr tree/usr/lib/extension\-release\&.d +echo "Hello World" > tree/usr/foo +cat > tree/usr/lib/extension\-release\&.d/extension\-release\&.my\-foo <<EOF +ID=fedora +VERSION_ID=38 +IMAGE_ID=my\-foo +IMAGE_VERSION=7 +EOF +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 +systemd\-sysext refresh +.fi +.if n \{\ +.RE +.\} +.PP +The DDI generated that way may be applied to the system with +\fBsystemd-sysext\fR(1)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBrepart.d\fR(5), -\fBmachine-id\fR(5), -\fBsystemd-cryptenroll\fR(1), -\fBportablectl\fR(1), -\fBsystemd-sysext\fR(8) +\fBsystemd\fR(1), \fBrepart.d\fR(5), \fBmachine-id\fR(5), \fBsystemd-cryptenroll\fR(1), \fBportablectl\fR(1), \fBsystemd-sysext\fR(8) .SH "NOTES" .IP " 1." 4 portable service diff --git a/upstream/fedora-rawhide/man8/systemd-resolved.service.8 b/upstream/fedora-rawhide/man8/systemd-resolved.service.8 index 86ed8074..00e8257a 100644 --- a/upstream/fedora-rawhide/man8/systemd-resolved.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-resolved.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-RESOLVED\&.SERVICE" "8" "" "systemd 255" "systemd-resolved.service" +.TH "SYSTEMD\-RESOLVED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-resolved.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -41,7 +41,7 @@ is a system service that provides network name resolution to local applications\ .\} The native, fully\-featured API \fBsystemd\-resolved\fR -exposes on the bus, see +exposes via D\-Bus, see \fBorg.freedesktop.resolve1\fR(5) and \fBorg.freedesktop.LogControl1\fR(5) @@ -56,6 +56,21 @@ for details\&. Usage of this API is generally recommended to clients as it is as .sp -1 .IP \(bu 2.3 .\} +The native API +\fBsystemd\-resolved\fR +exposes via Varlink on the +/run/systemd/resolve/io\&.systemd\&.Resolve +AF_UNIX socket\&. This provides similar functionality as the D\-Bus interface, but is available during the entire runtime, without requiring a running D\-Bus system bus broker service\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} The glibc \fBgetaddrinfo\fR(3) API as defined by @@ -657,6 +672,17 @@ command, however the latter is recommended since it operates in a synchronous wa .sp Added in version 235\&. .RE +.PP +\fBSIGHUP\fR +.RS 4 +Upon reception of the +\fBSIGHUP\fR +process signal +\fBsystemd\-resolved\fR +will flush all caches it maintains, drop all open TCP connections (if any), and reload its configuration files\&. +.sp +Added in version 256\&. +.RE .SH "CREDENTIALS" .PP \fBsystemd\-resolved\fR @@ -737,15 +763,7 @@ Port 5355 on all local addresses, both IPv4 and IP6 (0\&.0\&.0\&.0 and ::0), for .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBresolved.conf\fR(5), -\fBdnssec-trust-anchors.d\fR(5), -\fBnss-resolve\fR(8), -\fBresolvectl\fR(1), -\fBresolv.conf\fR(5), -\fBhosts\fR(5), -\fBsystemd.network\fR(5), -\fBsystemd-networkd.service\fR(8) +\fBsystemd\fR(1), \fBresolved.conf\fR(5), \fBdnssec-trust-anchors.d\fR(5), \fBnss-resolve\fR(8), \fBresolvectl\fR(1), \fBresolv.conf\fR(5), \fBhosts\fR(5), \fBsystemd.network\fR(5), \fBsystemd-networkd.service\fR(8) .SH "NOTES" .IP " 1." 4 RFC3493 diff --git a/upstream/fedora-rawhide/man8/systemd-rfkill.service.8 b/upstream/fedora-rawhide/man8/systemd-rfkill.service.8 index 17a091d7..387cd524 100644 --- a/upstream/fedora-rawhide/man8/systemd-rfkill.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-rfkill.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-RFKILL\&.SERVICE" "8" "" "systemd 255" "systemd-rfkill.service" +.TH "SYSTEMD\-RFKILL\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-rfkill.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man8/systemd-run-generator.8 b/upstream/fedora-rawhide/man8/systemd-run-generator.8 index 759d7647..97551fdc 100644 --- a/upstream/fedora-rawhide/man8/systemd-run-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-run-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-RUN\-GENERATOR" "8" "" "systemd 255" "systemd-run-generator" +.TH "SYSTEMD\-RUN\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-run-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -81,9 +81,4 @@ Use a command like the following to add a user to the user database inside a con end up in the generated unit file together and are neither split apart by the command shell nor by the generator\&.) .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBkernel-command-line\fR(7), -\fBsystemd-nspawn\fR(7), -\fBsystemd.unit\fR(5), -\fBsystemd.service\fR(5) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBkernel-command-line\fR(7), \fBsystemd-nspawn\fR(7), \fBsystemd.unit\fR(5), \fBsystemd.service\fR(5) diff --git a/upstream/fedora-rawhide/man8/systemd-socket-proxyd.8 b/upstream/fedora-rawhide/man8/systemd-socket-proxyd.8 index ef77126a..6ca6077c 100644 --- a/upstream/fedora-rawhide/man8/systemd-socket-proxyd.8 +++ b/upstream/fedora-rawhide/man8/systemd-socket-proxyd.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SOCKET\-PROXYD" "8" "" "systemd 255" "systemd-socket-proxyd" +.TH "SYSTEMD\-SOCKET\-PROXYD" "8" "" "systemd 256~rc3" "systemd-socket-proxyd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -39,6 +39,18 @@ This utility\*(Aqs behavior is similar to are support for socket activation with "Accept=no" and an event\-driven design that scales better with the number of connections\&. +.PP +Note that +\fBsystemd\-socket\-proxyd\fR +will not forward socket side channel information, i\&.e\&. will not forward +\fBSCM_RIGHTS\fR, +\fBSCM_CREDENTIALS\fR, +\fBSCM_SECURITY\fR, +\fBSO_PEERCRED\fR, +\fBSO_PEERPIDFD\fR, +\fBSO_PEERSEC\fR, +\fBSO_PEERGROUPS\fR +and similar\&. .SH "OPTIONS" .PP The following options are understood: @@ -229,10 +241,4 @@ $ curl http://localhost:80/ .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.socket\fR(5), -\fBsystemd.service\fR(5), -\fBsystemctl\fR(1), -\fBsocat\fR(1), -\fBnginx\fR(1), -\fBcurl\fR(1) +\fBsystemd\fR(1), \fBsystemd.socket\fR(5), \fBsystemd.service\fR(5), \fBsystemctl\fR(1), \fBsocat\fR(1), \fBnginx\fR(1), \fBcurl\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-soft-reboot.service.8 b/upstream/fedora-rawhide/man8/systemd-soft-reboot.service.8 index 33b4ff5f..7ede2ef7 100644 --- a/upstream/fedora-rawhide/man8/systemd-soft-reboot.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-soft-reboot.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SOFT\-REBOOT\&.SERVICE" "8" "" "systemd 255" "systemd-soft-reboot.service" +.TH "SYSTEMD\-SOFT\-REBOOT\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-soft-reboot.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -216,35 +216,24 @@ via \fISurviveFinalKillSignal=yes\fR, and also be configured to avoid being stopped on isolate via \fIIgnoreOnIsolate=yes\fR\&. They also have to be configured to be stopped on normal shutdown, reboot and maintenance mode\&. Finally, they have to be ordered after \fBbasic\&.target\fR -to ensure correct ordeering on boot\&. Note that in case any new or custom units are used to isolate to, or that implement an equivalent shutdown functionality, they will also have to be configured manually for correct ordering and conflicting\&. For example: +to ensure correct ordering on boot\&. Note that in case any new or custom units are used to isolate to, or that implement an equivalent shutdown functionality, they will also have to be configured manually for correct ordering and conflicting\&. For example: .sp .if n \{\ .RS 4 .\} .nf [Unit] -Description=My surviving service +Description=My Surviving Service SurviveFinalKillSignal=yes IgnoreOnIsolate=yes DefaultDependencies=no After=basic\&.target -Conflicts=reboot\&.target -Before=reboot\&.target -Conflicts=kexec\&.target -Before=kexec\&.target -Conflicts=poweroff\&.target -Before=poweroff\&.target -Conflicts=halt\&.target -Before=halt\&.target -Conflicts=rescue\&.target -Before=rescue\&.target -Conflicts=emergency\&.target -Before=emergency\&.target +Conflicts=reboot\&.target kexec\&.target poweroff\&.target halt\&.target rescue\&.target emergency\&.target +Before=shutdown\&.target rescue\&.target emergency\&.target [Service] Type=oneshot ExecStart=sleep infinity - .fi .if n \{\ .RE @@ -263,6 +252,301 @@ File system mounts may remain mounted during the transition, and complex storage \fIDefaultDependencies=no\fR, and by avoiding \fIConflicts=umount\&.target\fR) .RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If the unit publishes a service over D\-Bus, the connection needs to be re\-established after soft\-reboot as the D\-Bus broker will be stopped and then started again\&. When using the sd\-bus library this can be achieved by adapting the following example\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +/* SPDX\-License\-Identifier: MIT\-0 */ + +/* A D\-Bus service that automatically reconnects when the system bus is + * restarted\&. + * + * Compile with \*(Aqcc sd_bus_service_reconnect\&.c $(pkg\-config \-\-libs \-\-cflags libsystemd)\*(Aq + * + * To allow the program to take ownership of the name \*(Aqorg\&.freedesktop\&.ReconnectExample\*(Aq, + * add the following as /etc/dbus\-1/system\&.d/org\&.freedesktop\&.ReconnectExample\&.conf + * and then reload the broker with \*(Aqsystemctl reload dbus\*(Aq: + +<?xml version="1\&.0"?> <!\-\-*\-nxml\-*\-\-> +<!DOCTYPE busconfig PUBLIC "\-//freedesktop//DTD D\-BUS Bus Configuration 1\&.0//EN" + "http://www\&.freedesktop\&.org/standards/dbus/1\&.0/busconfig\&.dtd"> +<busconfig> + <policy user="root"> + <allow own="org\&.freedesktop\&.ReconnectExample"/> + <allow send_destination="org\&.freedesktop\&.ReconnectExample"/> + <allow receive_sender="org\&.freedesktop\&.ReconnectExample"/> + </policy> + + <policy context="default"> + <allow send_destination="org\&.freedesktop\&.ReconnectExample"/> + <allow receive_sender="org\&.freedesktop\&.ReconnectExample"/> + </policy> +</busconfig> + + * + * To get the property via busctl: + * + * $ busctl \-\-user get\-property org\&.freedesktop\&.ReconnectExample \e + * /org/freedesktop/ReconnectExample \e + * org\&.freedesktop\&.ReconnectExample \e + * Example + * s "example" + */ + +#include <errno\&.h> +#include <stdio\&.h> +#include <stdlib\&.h> +#include <systemd/sd\-bus\&.h> + +#define _cleanup_(f) __attribute__((cleanup(f))) + +static int log_error(int r, const char *str) { + fprintf(stderr, "%s failed: %s\en", str, strerror(\-r)); + return r; +} + +typedef struct object { + const char *example; + sd_bus **bus; + sd_event **event; +} object; + +static int property_get( + sd_bus *bus, + const char *path, + const char *interface, + const char *property, + sd_bus_message *reply, + void *userdata, + sd_bus_error *error) { + + object *o = userdata; + + if (strcmp(property, "Example") == 0) + return sd_bus_message_append(reply, "s", o\->example); + + return sd_bus_error_setf(error, + SD_BUS_ERROR_UNKNOWN_PROPERTY, + "Unknown property \*(Aq%s\*(Aq", + property); +} + +/* https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_add_object\&.html */ +static const sd_bus_vtable vtable[] = { + SD_BUS_VTABLE_START(0), + SD_BUS_PROPERTY( + "Example", "s", + property_get, + 0, + SD_BUS_VTABLE_PROPERTY_CONST), + SD_BUS_VTABLE_END +}; + +static int setup(object *o); + +static int on_disconnect(sd_bus_message *message, void *userdata, sd_bus_error *ret_error) { + int r; + + r = setup((object *)userdata); + if (r < 0) { + object *o = userdata; + r = sd_event_exit(*o\->event, r); + if (r < 0) + return log_error(r, "sd_event_exit()"); + } + + return 1; +} + +/* Ensure the event loop exits with a clear error if acquiring the well\-known + * service name fails */ +static int request_name_callback(sd_bus_message *m, void *userdata, sd_bus_error *ret_error) { + int r; + + if (!sd_bus_message_is_method_error(m, NULL)) + return 1; + + const sd_bus_error *error = sd_bus_message_get_error(m); + + if (sd_bus_error_has_names(error, SD_BUS_ERROR_TIMEOUT, SD_BUS_ERROR_NO_REPLY)) + return 1; /* The bus is not available, try again later */ + + fprintf(stderr, "Failed to request name: %s\en", error\->message); + object *o = userdata; + r = sd_event_exit(*o\->event, \-sd_bus_error_get_errno(error)); + if (r < 0) + return log_error(r, "sd_event_exit()"); + + return 1; +} + +static int setup(object *o) { + int r; + + /* If we are reconnecting, then the bus object needs to be closed, detached + * from the event loop and recreated\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_detach_event\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_close_unref\&.html + */ + if (*o\->bus) { + r = sd_bus_detach_event(*o\->bus); + if (r < 0) + return log_error(r, "sd_bus_detach_event()"); + *o\->bus = sd_bus_close_unref(*o\->bus); + } + + /* Set up a new bus object for the system bus, configure it to wait for D\-Bus + * to be available instead of failing if it is not, and start it\&. All the + * following operations are asynchronous and will not block waiting for D\-Bus + * to be available\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_new\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_set_address\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_set_bus_client\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_negotiate_creds\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_set_watch_bind\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_set_connected_signal\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_start\&.html + */ + r = sd_bus_new(o\->bus); + if (r < 0) + return log_error(r, "sd_bus_new()"); + r = sd_bus_set_address(*o\->bus, "unix:path=/run/dbus/system_bus_socket"); + if (r < 0) + return log_error(r, "sd_bus_set_address()"); + r = sd_bus_set_bus_client(*o\->bus, 1); + if (r < 0) + return log_error(r, "sd_bus_set_bus_client()"); + r = sd_bus_negotiate_creds(*o\->bus, 1, SD_BUS_CREDS_UID|SD_BUS_CREDS_EUID|SD_BUS_CREDS_EFFECTIVE_CAPS); + if (r < 0) + return log_error(r, "sd_bus_negotiate_creds()"); + r = sd_bus_set_watch_bind(*o\->bus, 1); + if (r < 0) + return log_error(r, "sd_bus_set_watch_bind()"); + r = sd_bus_start(*o\->bus); + if (r < 0) + return log_error(r, "sd_bus_start()"); + + /* Publish an interface on the bus, specifying our well\-known object access + * path and public interface name\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_add_object\&.html + * https://dbus\&.freedesktop\&.org/doc/dbus\-tutorial\&.html + */ + r = sd_bus_add_object_vtable(*o\->bus, + NULL, + "/org/freedesktop/ReconnectExample", + "org\&.freedesktop\&.ReconnectExample", + vtable, + o); + if (r < 0) + return log_error(r, "sd_bus_add_object_vtable()"); + /* By default the service is only assigned an ephemeral name\&. Also add a + * well\-known one, so that clients know whom to call\&. This needs to be + * asynchronous, as D\-Bus might not be yet available\&. The callback will check + * whether the error is expected or not, in case it fails\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_request_name\&.html + */ + r = sd_bus_request_name_async(*o\->bus, + NULL, + "org\&.freedesktop\&.ReconnectExample", + 0, + request_name_callback, + o); + if (r < 0) + return log_error(r, "sd_bus_request_name_async()"); + /* When D\-Bus is disconnected this callback will be invoked, which will set up + * the connection again\&. This needs to be asynchronous, as D\-Bus might not yet + * be available\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_match_signal_async\&.html + */ + r = sd_bus_match_signal_async(*o\->bus, + NULL, + "org\&.freedesktop\&.DBus\&.Local", + NULL, + "org\&.freedesktop\&.DBus\&.Local", + "Disconnected", + on_disconnect, + NULL, + o); + if (r < 0) + return log_error(r, "sd_bus_match_signal_async()"); + /* Attach the bus object to the event loop so that calls and signals are + * processed\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_attach_event\&.html + */ + r = sd_bus_attach_event(*o\->bus, *o\->event, 0); + if (r < 0) + return log_error(r, "sd_bus_attach_event()"); + + return 0; +} + +int main(int argc, char **argv) { + /* The bus should be relinquished before the program terminates\&. The cleanup + * attribute allows us to do it nicely and cleanly whenever we exit the block\&. + */ + _cleanup_(sd_bus_flush_close_unrefp) sd_bus *bus = NULL; + _cleanup_(sd_event_unrefp) sd_event *event = NULL; + object o = { + \&.example = "example", + \&.bus = &bus, + \&.event = &event, + }; + int r; + + /* Create an event loop data structure, with default parameters\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_event_default\&.html + */ + r = sd_event_default(&event); + if (r < 0) + return log_error(r, "sd_event_default()"); + + /* By default the event loop will terminate when all sources have disappeared, + * so we have to keep it \*(Aqoccupied\*(Aq\&. Register signal handling to do so\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_event_add_signal\&.html + */ + r = sd_event_add_signal(event, NULL, SIGINT|SD_EVENT_SIGNAL_PROCMASK, NULL, NULL); + if (r < 0) + return log_error(r, "sd_event_add_signal(SIGINT)"); + + r = sd_event_add_signal(event, NULL, SIGTERM|SD_EVENT_SIGNAL_PROCMASK, NULL, NULL); + if (r < 0) + return log_error(r, "sd_event_add_signal(SIGTERM)"); + + r = setup(&o); + if (r < 0) + return EXIT_FAILURE; + + /* Enter the main loop, it will exit only on sigint/sigterm\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_event_loop\&.html + */ + r = sd_event_loop(event); + if (r < 0) + return log_error(r, "sd_event_loop()"); + + /* https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_release_name\&.html */ + r = sd_bus_release_name(bus, "org\&.freedesktop\&.ReconnectExample"); + if (r < 0) + return log_error(r, "sd_bus_release_name()"); + + return 0; +} +.fi +.if n \{\ +.RE +.\} +.sp +.RE .PP Even though passing resources from one soft reboot cycle to the next is possible this way, we strongly suggest to use this functionality sparingly only, as it creates a more fragile system as resources from different versions of the OS and applications might be mixed with unforeseen consequences\&. In particular it\*(Aqs recommended to \fIavoid\fR @@ -291,12 +575,7 @@ will be performed when the command is invoked\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.special\fR(7), -\fBsystemd-poweroff.service\fR(8), -\fBsystemd-suspend.service\fR(8), -\fBbootup\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.special\fR(7), \fBsystemd-poweroff.service\fR(8), \fBsystemd-suspend.service\fR(8), \fBbootup\fR(7) .SH "NOTES" .IP " 1." 4 Portable Services diff --git a/upstream/fedora-rawhide/man8/systemd-ssh-generator.8 b/upstream/fedora-rawhide/man8/systemd-ssh-generator.8 new file mode 100644 index 00000000..cb8151c7 --- /dev/null +++ b/upstream/fedora-rawhide/man8/systemd-ssh-generator.8 @@ -0,0 +1,183 @@ +'\" t +.TH "SYSTEMD\-SSH\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-ssh-generator" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +systemd-ssh-generator \- Generator for binding a socket\-activated SSH server to local \fBAF_VSOCK\fR and \fBAF_UNIX\fR sockets +.SH "SYNOPSIS" +.PP +/usr/lib/systemd/system\-generators/systemd\-ssh\-generator +.SH "DESCRIPTION" +.PP +\fBsystemd\-ssh\-generator\fR +binds a socket\-activated SSH server to local +\fBAF_VSOCK\fR +and +\fBAF_UNIX\fR +sockets under certain conditions\&. It only has an effect if the +\fBsshd\fR(8) +binary is installed\&. Specifically, it does the following: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If invoked in a VM with +\fBAF_VSOCK\fR +support, a socket\-activated SSH per\-connection service is bound to +\fBAF_VSOCK\fR +port 22\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If invoked in a container environment with a writable directory +/run/host/unix\-export/ +pre\-mounted it binds SSH to an +\fBAF_UNIX\fR +socket +/run/host/unix\-export/ssh\&. The assumption is that this directory is bind mounted to the host side as well, and can be used to connect to the container from there\&. See +\m[blue]\fBContainer Interface\fR\m[]\&\s-2\u[1]\d\s+2 +for more information about this interface\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +A local +\fBAF_UNIX\fR +socket +/run/ssh\-unix\-local/socket +is also bound, unconditionally\&. This may be used for SSH communication from the host to itself, without involving networking, for example to traverse security boundaries safely and with secure authentication\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Additional +\fBAF_UNIX\fR +and +\fBAF_VSOCK\fR +sockets are optionally bound, based on the +\fIsystemd\&.ssh_listen=\fR +kernel command line option or the +ssh\&.listen +system credential (see below)\&. +.RE +.PP +See +\fBsystemd-ssh-proxy\fR(1) +for details on how to connect to these sockets via the +\fBssh\fR +client\&. +.PP +The +\fIssh\&.authorized_keys\&.root\fR +credential can be used to allow specific public keys to log in over SSH\&. See +\fBsystemd.systemd-credentials\fR(7) +for more information\&. +.PP +The generator will use a packaged +sshd@\&.service +service template file if one exists, and otherwise generate a suitable service template file\&. +.PP +systemd\-ssh\-generator +implements +\fBsystemd.generator\fR(7)\&. +.SH "KERNEL COMMAND LINE" +.PP +systemd\-ssh\-generator +understands the following +\fBkernel-command-line\fR(7) +parameters: +.PP +\fIsystemd\&.ssh_auto=\fR +.RS 4 +This option takes an optional boolean argument, and defaults to yes\&. If enabled, the automatic binding to the +\fBAF_VSOCK\fR +and +\fBAF_UNIX\fR +sockets listed above is done\&. If disable, this is not done, except for those explicitly requested via +\fIsystemd\&.ssh_listen=\fR +on the kernel command line or via the +\fIssh\&.listen\fR +system credential\&. +.sp +Added in version 256\&. +.RE +.PP +\fIsystemd\&.ssh_listen=\fR +.RS 4 +This option configures an additional socket to bind SSH to\&. It may be used multiple times to bind multiple sockets\&. The syntax should follow the one of +\fIListenStream=\fR, see +\fBsystemd.socket\fR(5) +for details\&. This functionality supports all socket families systemd supports, including +\fBAF_INET\fR +and +\fBAF_INET6\fR\&. +.sp +Added in version 256\&. +.RE +.SH "CREDENTIALS" +.PP +\fBsystemd\-ssh\-generator\fR +supports the system credentials logic\&. The following credentials are used when passed in: +.PP +\fIssh\&.listen\fR +.RS 4 +This credential should be a text file, with each line referencing one additional socket to bind SSH to\&. The syntax should follow the one of +\fIListenStream=\fR, see +\fBsystemd.socket\fR(5) +for details\&. This functionality supports all socket families systemd supports, including +\fBAF_INET\fR +and +\fBAF_INET6\fR\&. +.sp +Added in version 256\&. +.RE +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), \fBkernel-command-line\fR(7), \fBsystemd.system-credentials\fR(7), \fBvsock\fR(7), \fBunix\fR(7), \fBssh\fR(1), \fBsshd\fR(8) +.SH "NOTES" +.IP " 1." 4 +Container Interface +.RS 4 +\%https://systemd.io/CONTAINER_INTERFACE +.RE diff --git a/upstream/fedora-rawhide/man8/systemd-storagetm.service.8 b/upstream/fedora-rawhide/man8/systemd-storagetm.service.8 index 2f67cdb1..852271d5 100644 --- a/upstream/fedora-rawhide/man8/systemd-storagetm.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-storagetm.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-STORAGETM\&.SERVICE" "8" "" "systemd 255" "systemd-storagetm.service" +.TH "SYSTEMD\-STORAGETM\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-storagetm.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -32,8 +32,22 @@ systemd\-storagetm\&.service is a service that exposes all local block devices as NVMe\-TCP mass storage devices\&. Its primary use\-case is to be invoked by the storage\-target\-mode\&.target unit that can be booted into\&. +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBWarning\fR +.ps -1 +.br .PP -Warning: the NVMe disks are currently exposed without authentication or encryption, in read/write mode\&. This means network peers may read from and write to the device without any restrictions\&. This functionality should hence only be used in a local setup\&. +The NVMe disks are currently exposed without authentication or encryption, in read/write mode\&. This means network peers may read from and write to the device without any restrictions\&. This functionality should hence only be used in a local setup\&. +.sp .5v +.RE .PP Note that to function properly networking must be configured too\&. The recommended mechanism to boot into a storage target mode is by adding "rd\&.systemd\&.unit=storage\-target\-mode\&.target ip=link\-local" @@ -54,7 +68,7 @@ The following options are understood: \fB\-\-nqn=\fR .RS 4 Takes a string\&. If specified configures the NVMe Qualified Name to use for the exposed NVMe\-TCP mass storage devices\&. The NQN should follow the syntax described in -\m[blue]\fBNVM Express Base Specification 2\&.0c\fR\m[]\&\s-2\u[1]\d\s+2, section 4\&.5 "NVMe Qualified Names"\&. Note that the NQN specified here will be suffixed with a dot and the the block device name before it is exposed on the NVMe target\&. If not specified defaults to +\m[blue]\fBNVM Express Base Specification 2\&.0c\fR\m[]\&\s-2\u[1]\d\s+2, section 4\&.5 "NVMe Qualified Names"\&. Note that the NQN specified here will be suffixed with a dot and the block device name before it is exposed on the NVMe target\&. If not specified defaults to "nqn\&.2023\-10\&.io\&.systemd:storagetm\&.\fIID\fR", where ID is replaced by a 128bit ID derived from \fBmachine-id\fR(5)\&. .sp @@ -79,8 +93,7 @@ Print a short version string and exit\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.special\fR(7) +\fBsystemd\fR(1), \fBsystemd.special\fR(7) .SH "NOTES" .IP " 1." 4 NVM Express Base Specification 2.0c diff --git a/upstream/fedora-rawhide/man8/systemd-suspend.service.8 b/upstream/fedora-rawhide/man8/systemd-suspend.service.8 index 1e7b7069..f431b34b 100644 --- a/upstream/fedora-rawhide/man8/systemd-suspend.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-suspend.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SUSPEND\&.SERVICE" "8" "" "systemd 255" "systemd-suspend.service" +.TH "SYSTEMD\-SUSPEND\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-suspend.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,15 +23,21 @@ systemd-suspend.service, systemd-hibernate.service, systemd-hybrid-sleep.service, systemd-suspend-then-hibernate.service, systemd-sleep \- System sleep state logic .SH "SYNOPSIS" .PP +.RS 4 systemd\-suspend\&.service -.PP +.RE +.RS 4 systemd\-hibernate\&.service -.PP +.RE +.RS 4 systemd\-hybrid\-sleep\&.service -.PP +.RE +.RS 4 systemd\-suspend\-then\-hibernate\&.service -.PP +.RE +.RS 4 /usr/lib/systemd/system\-sleep +.RE .SH "DESCRIPTION" .PP systemd\-suspend\&.service @@ -68,7 +74,9 @@ where the value of the variable will be "hibernate", or "suspend\-after\-failed\-hibernate" in cases where hibernation has failed\&. Immediately after leaving system suspend and/or hibernation the same executables are run, but the first argument is now -"post"\&. All executables in this directory are executed in parallel, and execution of the action is not continued until all executables have finished\&. +"post"\&. All executables in this directory are executed in parallel, and execution of the action is not continued until all executables have finished\&. Note that +user\&.slice +will be frozen while the executables are running, so they should not attempt to communicate with any user services expecting a reply\&. .PP Note that scripts or binaries dropped in /usr/lib/systemd/system\-sleep/ @@ -94,6 +102,11 @@ or a sleep\&.conf\&.d file\&. See \fBsystemd-sleep.conf\fR(5)\&. +.PP +Note that by default these services freeze +user\&.slice +while they run\&. This prevents the execution of any process in any of the user sessions while the system is entering into and resuming from sleep\&. Thus, this prevents the hooks in +/usr/lib/systemd/system\-sleep/, or any other process for that matter, from communicating with any user session process during sleep\&. .SH "OPTIONS" .PP \fBsystemd\-sleep\fR @@ -117,11 +130,7 @@ Added in version 203\&. .RE .SH "SEE ALSO" .PP -\fBsystemd-sleep.conf\fR(5), -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.special\fR(7), -\fBsystemd-halt.service\fR(8) +\fBsystemd-sleep.conf\fR(5), \fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.special\fR(7), \fBsystemd-halt.service\fR(8) .SH "NOTES" .IP " 1." 4 Inhibitor interface diff --git a/upstream/fedora-rawhide/man8/systemd-sysctl.service.8 b/upstream/fedora-rawhide/man8/systemd-sysctl.service.8 index 35eeee7c..c039400a 100644 --- a/upstream/fedora-rawhide/man8/systemd-sysctl.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-sysctl.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSCTL\&.SERVICE" "8" "" "systemd 255" "systemd-sysctl.service" +.TH "SYSTEMD\-SYSCTL\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-sysctl.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -179,6 +179,4 @@ See for various ways to directly apply sysctl settings\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsysctl.d\fR(5), -\fBsysctl\fR(8) +\fBsystemd\fR(1), \fBsysctl.d\fR(5), \fBsysctl\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-sysext.8 b/upstream/fedora-rawhide/man8/systemd-sysext.8 index 949afe88..f60d4cae 100644 --- a/upstream/fedora-rawhide/man8/systemd-sysext.8 +++ b/upstream/fedora-rawhide/man8/systemd-sysext.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSEXT" "8" "" "systemd 255" "systemd-sysext" +.TH "SYSTEMD\-SYSEXT" "8" "" "systemd 256~rc3" "systemd-sysext" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -25,15 +25,11 @@ systemd-sysext, systemd-sysext.service, systemd-confext, systemd-confext.service .HP \w'\fBsystemd\-sysext\fR\ 'u \fBsystemd\-sysext\fR [OPTIONS...] COMMAND .PP -.nf systemd\-sysext\&.service -.fi .HP \w'\fBsystemd\-confext\fR\ 'u \fBsystemd\-confext\fR [OPTIONS...] COMMAND .PP -.nf systemd\-confext\&.service -.fi .SH "DESCRIPTION" .PP \fBsystemd\-sysext\fR @@ -77,11 +73,13 @@ included in a system extension image will \fInot\fR appear in the respective hierarchies after activation\&. .PP -System extension images are strictly read\-only, and the host +System extension images are strictly read\-only by default\&. On mutable host file systems, /usr/ and /opt/ -hierarchies become read\-only too while they are activated\&. +hierarchies become read\-only while extensions are merged, unless mutability is enabled\&. Mutability may be enabled via the +\fB\-\-mutable=\fR +option; see "Mutability" below for more information\&. .PP System extensions are supposed to be purely additive, i\&.e\&. they are supposed to include only files that do not exist in the underlying basic OS image\&. However, the underlying mechanism (overlayfs) also allows overlaying or removing files, but it is recommended not to make use of this\&. .PP @@ -189,7 +187,7 @@ but the used architecture identifiers are the same as for described in \fBsystemd.unit\fR(5)\&. \fIEXTENSION_RELOAD_MANAGER=\fR -can be set to 1 if the extension requires a service manager reload after application of the extension\&. Note that the for the reasons mentioned earlier: +can be set to 1 if the extension requires a service manager reload after application of the extension\&. Note that for the reasons mentioned earlier: \m[blue]\fBPortable Services\fR\m[]\&\s-2\u[2]\d\s+2 remain the recommended way to ship system services\&. System extensions should not ship a /usr/lib/os\-release @@ -221,6 +219,12 @@ and (if not disabled via \fB\-\-noexec=false\fR) "noexec"\&. .PP +Just like sysexts, confexts are strictly read\-only by default\&. Merging confexts on mutable host file systems will result in +/etc/ +becoming read\-only\&. As with sysexts, mutability can be enabled via the +\fB\-\-mutable=\fR +option\&. Refer to "Mutability" below for more information\&. +.PP Confexts are looked for in the directories /run/confexts/, /var/lib/confexts/, @@ -254,7 +258,143 @@ as if it was installed in the OS image itself\&.) This case works regardless if /usr/ is managed as immutable disk image or is a traditional package manager controlled (i\&.e\&. writable) tree\&. .PP -For the confext case, the OSConfig project aims to perform runtime reconfiguration of OS services\&. Sometimes, there is a need to swap certain configuration parameter values or restart only a specific service without deployment of new code or a complete OS deployment\&. In other words, we want to be able to tie the most frequently configured options to runtime updateable flags that can be changed without a system reboot\&. This will help reduce servicing times when there is a need for changing the OS configuration\&. +With systemd\-confext one can perform runtime reconfiguration of OS services\&. Sometimes, there is a need to swap certain configuration parameter values or restart only a specific service without deployment of new code or a complete OS deployment\&. In other words, we want to be able to tie the most frequently configured options to runtime updateable flags that can be changed without a system reboot\&. This will help reduce servicing times when there is a need for changing the OS configuration\&. It also provides a reliable tool for managing configuration because all old configuration files disappear when the systemd\-confext image is removed\&. +.SH "MUTABILITY" +.PP +By default, merging system extensions on mutable host file systems will render +/usr/ +and +/opt/ +hierarchies read\-only\&. Merging configuration extensions will have the same effect on +/etc/\&. Mutable mode allows writes to these locations when extensions are merged\&. +.PP +The following modes are supported: +.sp +.RS 4 +.ie n \{\ +\h'-04' 1.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 1." 4.2 +.\} +\fBdisabled\fR: Force immutable mode even if write routing directories exist below +/var/lib/extensions\&.mutable/\&. This is the default\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 2.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 2." 4.2 +.\} +\fBauto\fR: Automatic mode\&. Mutability is disabled by default and only enabled if a corresponding write routing directory exists below +/var/lib/extensions\&.mutable/\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 3.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 3." 4.2 +.\} +\fBenabled\fR: Force mutable mode and automatically create write routing directories below +/var/lib/extensions\&.mutable/ +when required\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 4.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 4." 4.2 +.\} +\fBimport\fR: Force immutable mode like +\fBdisabled\fR +above, but merge the contents of directories below +/var/lib/extensions\&.mutable/ +into the host file system\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 5.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 5." 4.2 +.\} +\fBephemeral\fR: Force mutable mode like +\fBenabled\fR +above, but instead of using write routing directory below +/var/lib/extensions\&.mutable/, +\fBsystemd\-sysext\fR +will use empty ephemeral directories\&. This means that the modifications made in the merged hierarchies will be gone when the hierarchies are unmerged\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 6.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 6." 4.2 +.\} +\fBephemeral\-import\fR: Force mutable mode like +\fBephemeral\fR +above, but instead of ignoring the contents of write routing directories under +/var/lib/extensions\&.mutable/, merge them into the host file system, like +\fBimport\fR +does\&. +.RE +.sp +See "Options" below on specifying modes using the +\fB\-\-mutable=\fR +command line option\&. +.PP +With exception of the ephemeral mode, the mutable mode routes writes to subdirectories in +/var/lib/extensions\&.mutable/\&. +.RS 4 +Writes to /usr/ are directed to /var/lib/extensions\&.mutable/usr/ +.RE +.RS 4 +writes to /opt/ are directed to /var/lib/extensions\&.mutable/opt/, and +.RE +.RS 4 +writes to /etc/ land in /var/lib/extensions\&.mutable/etc/\&. +.RE +.PP +If +usr/, +opt/, or +etc/ +in +/var/lib/extensions\&.mutable/ +are symlinks, then writes are directed to the symlinks\*(Aq targets\&. Consequently, to retain mutability of a host file system, create symlinks +.RS 4 +/var/lib/extensions\&.mutable/etc/ → /etc/ +.RE +.RS 4 +/var/lib/extensions\&.mutable/usr/ → /usr/ +.RE +.RS 4 +/var/lib/extensions\&.mutable/opt/ → /opt/ +.RE +to route writes back to the original base directory hierarchy\&. +.PP +Alternatively, a temporary file system may be mounted to +/var/lib/extensions\&.mutable/, or symlinks in +/var/lib/extensions\&.mutable/ +may point to sub\-directories on a temporary file system (e\&.g\&. below +/tmp/) to only allow ephemeral changes\&. Note that this is not the same as ephemeral mode, because the temporary file system will still exist after unmerging\&. +.PP +Added in version 256\&. .SH "COMMANDS" .PP The following commands are understood by both the sysext and confext concepts: @@ -386,7 +526,69 @@ directory a slightly stricter policy is used by default: Added in version 254\&. .RE .PP -\fB\-\-noexec=\fR\fIBOOL\fR +\fB\-\-mutable=\fR\fB\fIBOOL\fR\fR\fB|\fR\fB\fIauto\fR\fR\fB|\fR\fB\fIimport\fR\fR +.RS 4 +Set mutable mode\&. +.PP +\fBno\fR +.RS 4 +force immutable mode even with write routing directories present\&. This is the default\&. +.sp +Added in version 256\&. +.RE +.PP +\fBauto\fR +.RS 4 +enable mutable mode individually for +/usr/, +/opt/, and +/etc/ +if write routing sub\-directories or symlinks are present in +/var/lib/extensions\&.mutable/; disable otherwise\&. See "Mutability" above for more information on write routing\&. +.sp +Added in version 256\&. +.RE +.PP +\fByes\fR +.RS 4 +force mutable mode\&. Write routing directories will be created in +/var/lib/extensions\&.mutable/ +if not present\&. +.sp +Added in version 256\&. +.RE +.PP +\fBimport\fR +.RS 4 +immutable mode, but with contents of write routing directories in +/var/lib/extensions\&.mutable/ +also merged into the host file system\&. +.sp +Added in version 256\&. +.RE +.PP +\fBephemeral\fR +.RS 4 +force mutable mode, but with contents of write routing directories in +/var/lib/extensions\&.mutable/ +being ignored, and modifications of the host file system being discarded after unmerge\&. +.sp +Added in version 256\&. +.RE +.PP +\fBephemeral\-import\fR +.RS 4 +force mutable mode, with contents of write routing directories in +/var/lib/extensions\&.mutable/ +being merged into the host file system, but with the modifications made to the host file system being discarded after unmerge\&. +.sp +Added in version 256\&. +.RE +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-noexec=\fR\fB\fIBOOL\fR\fR .RS 4 When merging configuration extensions into /etc/ @@ -420,7 +622,7 @@ Do not pipe output into a pager\&. Do not print the legend, i\&.e\&. column headers and the footer with hints\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Shows output formatted as JSON\&. Expects one of "short" @@ -435,9 +637,7 @@ Shows output formatted as JSON\&. Expects one of On success, 0 is returned\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-nspawn\fR(1), -\fBsystemd-stub\fR(7) +\fBsystemd\fR(1), \fBsystemd-nspawn\fR(1), \fBsystemd-stub\fR(7), \fBimportctl\fR(1) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man8/systemd-system-update-generator.8 b/upstream/fedora-rawhide/man8/systemd-system-update-generator.8 index 47e3b738..99cbbdb9 100644 --- a/upstream/fedora-rawhide/man8/systemd-system-update-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-system-update-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSTEM\-UPDATE\-GENERATOR" "8" "" "systemd 255" "systemd-system-update-generator" +.TH "SYSTEMD\-SYSTEM\-UPDATE\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-system-update-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -40,5 +40,4 @@ implements \fBsystemd.generator\fR(7)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.special\fR(7) +\fBsystemd\fR(1), \fBsystemd.special\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-sysupdate.8 b/upstream/fedora-rawhide/man8/systemd-sysupdate.8 index 99d876fa..c8a12e09 100644 --- a/upstream/fedora-rawhide/man8/systemd-sysupdate.8 +++ b/upstream/fedora-rawhide/man8/systemd-sysupdate.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSUPDATE" "8" "" "systemd 255" "systemd-sysupdate" +.TH "SYSTEMD\-SYSUPDATE" "8" "" "systemd 256~rc3" "systemd-sysupdate" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -272,7 +272,7 @@ Do not pipe output into a pager\&. Do not print the legend, i\&.e\&. column headers and the footer with hints\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Shows output formatted as JSON\&. Expects one of "short" @@ -287,6 +287,4 @@ Shows output formatted as JSON\&. Expects one of On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsysupdate.d\fR(5), -\fBsystemd-repart\fR(8) +\fBsystemd\fR(1), \fBsysupdate.d\fR(5), \fBsystemd-repart\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-sysusers.8 b/upstream/fedora-rawhide/man8/systemd-sysusers.8 index 5d5726a1..f8858843 100644 --- a/upstream/fedora-rawhide/man8/systemd-sysusers.8 +++ b/upstream/fedora-rawhide/man8/systemd-sysusers.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSUSERS" "8" "" "systemd 255" "systemd-sysusers" +.TH "SYSTEMD\-SYSUSERS" "8" "" "systemd 256~rc3" "systemd-sysusers" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -32,15 +32,13 @@ systemd\-sysusers\&.service creates system users and groups, based on files in the format described in \fBsysusers.d\fR(5)\&. .PP -If invoked with no arguments, it applies all directives from all files found in the directories specified by +If invoked with no arguments, directives from the configuration files found in the directories specified by \fBsysusers.d\fR(5)\&. When invoked with positional arguments, if option \fB\-\-replace=\fR\fB\fIPATH\fR\fR is specified, arguments specified on the command line are used instead of the configuration file -\fIPATH\fR\&. Otherwise, just the configuration specified by the command line arguments is executed\&. The string +\fIPATH\fR\&. Otherwise, just the configuration specified by the command line arguments is executed\&. If the string "\-" -may be specified instead of a filename to instruct -\fBsystemd\-sysusers\fR -to read the configuration from standard input\&. If the argument is a relative path, all configuration directories are searched for a matching file and the file found that has the highest priority is executed\&. If the argument is an absolute path, that file is used directly without searching of the configuration directories\&. +is specified instead of a filename, the configuration is read from standard input\&. If the argument is a file name (without any slashes), all configuration directories are searched for a matching file and the file found that has the highest priority is executed\&. If the argument is a path, that file is used directly without searching the configuration directories for any other matching file\&. .SH "OPTIONS" .PP The following options are understood: @@ -152,7 +150,7 @@ Print a short version string and exit\&. supports the service credentials logic as implemented by \fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR (see -\fBsystemd.exec\fR(1) +\fBsystemd.exec\fR(5) for details)\&. The following credentials are used when passed in: .PP \fIpasswd\&.hashed\-password\&.\fR\fI\fIuser\fR\fR @@ -225,11 +223,7 @@ for generating UNIX password hashes from the command line\&. On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsysusers.d\fR(5), -\m[blue]\fBUsers, Groups, UIDs and GIDs on systemd systems\fR\m[]\&\s-2\u[2]\d\s+2, -\fBsystemd.exec\fR(1), -\fBmkpasswd\fR(1) +\fBsystemd\fR(1), \fBsysusers.d\fR(5), \m[blue]\fBUsers, Groups, UIDs and GIDs on systemd systems\fR\m[]\&\s-2\u[2]\d\s+2, \fBsystemd.exec\fR(5), \fBmkpasswd\fR(1) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man8/systemd-sysv-generator.8 b/upstream/fedora-rawhide/man8/systemd-sysv-generator.8 index 80b51288..198a8a19 100644 --- a/upstream/fedora-rawhide/man8/systemd-sysv-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-sysv-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSV\-GENERATOR" "8" "" "systemd 255" "systemd-sysv-generator" +.TH "SYSTEMD\-SYSV\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-sysv-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -62,9 +62,7 @@ implements \fBsystemd.generator\fR(7)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.service\fR(5), -\fBsystemd.target\fR(5) +\fBsystemd\fR(1), \fBsystemd.service\fR(5), \fBsystemd.target\fR(5) .SH "NOTES" .IP " 1." 4 System V init diff --git a/upstream/fedora-rawhide/man8/systemd-time-wait-sync.service.8 b/upstream/fedora-rawhide/man8/systemd-time-wait-sync.service.8 index d6849abe..1f7653e3 100644 --- a/upstream/fedora-rawhide/man8/systemd-time-wait-sync.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-time-wait-sync.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-TIME\-WAIT\-SYNC\&.SERVICE" "8" "" "systemd 255" "systemd-time-wait-sync.service" +.TH "SYSTEMD\-TIME\-WAIT\-SYNC\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-time-wait-sync.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -52,6 +52,4 @@ Added in version 239\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.special\fR(7), -\fBsystemd-timesyncd.service\fR(8), +\fBsystemd\fR(1), \fBsystemd.special\fR(7), \fBsystemd-timesyncd.service\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-timedated.service.8 b/upstream/fedora-rawhide/man8/systemd-timedated.service.8 index a221cf9e..59bf9310 100644 --- a/upstream/fedora-rawhide/man8/systemd-timedated.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-timedated.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-TIMEDATED\&.SERVICE" "8" "" "systemd 255" "systemd-timedated.service" +.TH "SYSTEMD\-TIMEDATED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-timedated.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -91,7 +91,7 @@ and for information about the D\-Bus API\&. .SH "LIST OF NETWORK TIME SYNCHRONIZATION SERVICES" .PP -\fBsystemd\-timesyncd\fR +\fBsystemd\-timedated\fR will look for files with a "\&.list" extension in @@ -131,7 +131,7 @@ systemd\-timesyncd\&.service If the environment variable \fI$SYSTEMD_TIMEDATED_NTP_SERVICES\fR is set, -\fBsystemd\-timesyncd\fR +\fBsystemd\-timedated\fR will parse the contents of that variable as a colon\-separated list of unit names\&. When set, this variable overrides the file\-based list described above\&. .PP \fBExample\ \&2.\ \&An override that specifies that chronyd should be used if available\fR @@ -147,8 +147,4 @@ SYSTEMD_TIMEDATED_NTP_SERVICES=chronyd\&.service:systemd\-timesyncd\&.service .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBtimedatectl\fR(1), -\fBlocaltime\fR(5), -\fBhwclock\fR(8), -\fBsystemd-timesyncd\fR(8) +\fBsystemd\fR(1), \fBtimedatectl\fR(1), \fBlocaltime\fR(5), \fBhwclock\fR(8), \fBsystemd-timesyncd\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-timesyncd.service.8 b/upstream/fedora-rawhide/man8/systemd-timesyncd.service.8 index 96ec2c88..fcce657b 100644 --- a/upstream/fedora-rawhide/man8/systemd-timesyncd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-timesyncd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-TIMESYNCD\&.SERVICE" "8" "" "systemd 255" "systemd-timesyncd.service" +.TH "SYSTEMD\-TIMESYNCD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-timesyncd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -100,12 +100,4 @@ Added in version 239\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBtimesyncd.conf\fR(5), -\fBsystemd.network\fR(5), -\fBsystemd-networkd.service\fR(8), -\fBsystemd-time-wait-sync.service\fR(8), -\fBsystemd.special\fR(7), -\fBtimedatectl\fR(1), -\fBlocaltime\fR(5), -\fBhwclock\fR(8) +\fBsystemd\fR(1), \fBtimesyncd.conf\fR(5), \fBsystemd.network\fR(5), \fBsystemd-networkd.service\fR(8), \fBsystemd-time-wait-sync.service\fR(8), \fBsystemd.special\fR(7), \fBtimedatectl\fR(1), \fBlocaltime\fR(5), \fBhwclock\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-tmpfiles.8 b/upstream/fedora-rawhide/man8/systemd-tmpfiles.8 index cc6228af..c4302e94 100644 --- a/upstream/fedora-rawhide/man8/systemd-tmpfiles.8 +++ b/upstream/fedora-rawhide/man8/systemd-tmpfiles.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-TMPFILES" "8" "" "systemd 255" "systemd-tmpfiles" +.TH "SYSTEMD\-TMPFILES" "8" "" "systemd 256~rc3" "systemd-tmpfiles" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,44 +20,54 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -systemd-tmpfiles, systemd-tmpfiles-setup.service, systemd-tmpfiles-setup-dev-early.service, systemd-tmpfiles-setup-dev.service, systemd-tmpfiles-clean.service, systemd-tmpfiles-clean.timer \- Creates, deletes and cleans up volatile and temporary files and directories +systemd-tmpfiles, systemd-tmpfiles-setup.service, systemd-tmpfiles-setup-dev-early.service, systemd-tmpfiles-setup-dev.service, systemd-tmpfiles-clean.service, systemd-tmpfiles-clean.timer \- Create, delete, and clean up files and directories .SH "SYNOPSIS" .HP \w'\fBsystemd\-tmpfiles\fR\ 'u \fBsystemd\-tmpfiles\fR [OPTIONS...] [\fICONFIGFILE\fR...] .PP System units: -.sp -.nf +.RS 4 systemd\-tmpfiles\-setup\&.service +.RE +.RS 4 systemd\-tmpfiles\-setup\-dev\-early\&.service +.RE +.RS 4 systemd\-tmpfiles\-setup\-dev\&.service +.RE +.RS 4 systemd\-tmpfiles\-clean\&.service +.RE +.RS 4 systemd\-tmpfiles\-clean\&.timer -.fi +.RE .PP User units: -.sp -.nf +.RS 4 systemd\-tmpfiles\-setup\&.service +.RE +.RS 4 systemd\-tmpfiles\-clean\&.service +.RE +.RS 4 systemd\-tmpfiles\-clean\&.timer -.fi +.RE .SH "DESCRIPTION" .PP \fBsystemd\-tmpfiles\fR creates, deletes, and cleans up volatile and temporary files and directories, using the configuration file format and location specified in -\fBtmpfiles.d\fR(5)\&. It must be invoked with one or more options +\fBtmpfiles.d\fR(5)\&. It must be invoked with one or more commands \fB\-\-create\fR, \fB\-\-remove\fR, and \fB\-\-clean\fR, to select the respective subset of operations\&. .PP -By default, directives from all configuration files are applied\&. When invoked with -\fB\-\-replace=\fR\fB\fIPATH\fR\fR, arguments specified on the command line are used instead of the configuration file -\fIPATH\fR\&. Otherwise, if one or more absolute filenames are passed on the command line, only the directives in these files are applied\&. If +If invoked with no arguments, directives from the configuration files found in the directories specified by +\fBtmpfiles.d\fR(5)\&. When invoked with positional arguments, if option +\fB\-\-replace=\fR\fB\fIPATH\fR\fR +is specified, arguments specified on the command line are used instead of the configuration file +\fIPATH\fR\&. Otherwise, just the configuration specified by the command line arguments is executed\&. If the string "\-" -is specified instead of a filename, directives are read from standard input\&. If only the basename of a configuration file is specified, all configuration directories as specified in -\fBtmpfiles.d\fR(5) -are searched for a matching file and the file found that has the highest priority is executed\&. +is specified instead of a filename, the configuration is read from standard input\&. If the argument is a file name (without any slashes), all configuration directories are searched for a matching file and the file found that has the highest priority is executed\&. If the argument is a path, that file is used directly without searching the configuration directories for any other matching file\&. .PP System services (systemd\-tmpfiles\-setup\&.service, systemd\-tmpfiles\-setup\-dev\-early\&.service, @@ -81,13 +91,13 @@ systemd\-tmpfiles\-clean\&.service, which will apply any settings which can be s \fBsystemd\-tmpfiles\fR, it may be useful to invoke it directly from the command line with increased log level (see \fI$SYSTEMD_LOG_LEVEL\fR below)\&. -.SH "OPTIONS" +.SH "COMMANDS AND OPTIONS" .PP -The following options are understood: +The following commands are understood: .PP \fB\-\-create\fR .RS 4 -If this option is passed, all files and directories marked with +If this command is passed, all files and directories marked with \fIf\fR, \fIF\fR, \fIw\fR, @@ -111,12 +121,12 @@ have their ownership, access mode and security labels set\&. .PP \fB\-\-clean\fR .RS 4 -If this option is passed, all files and directories with an age parameter configured will be cleaned up\&. +If this command is passed, all files and directories with an age parameter configured will be cleaned up\&. .RE .PP \fB\-\-remove\fR .RS 4 -If this option is passed, the contents of directories marked with +If this command is passed, the contents of directories marked with \fID\fR or \fIR\fR, and files or directories themselves marked with @@ -127,6 +137,15 @@ are removed unless an exclusive or shared BSD lock is taken on them (see \fBflock\fR(2))\&. .RE .PP +\fB\-\-purge\fR +.RS 4 +If this option is passed, all files and directories created by a +tmpfiles\&.d/ +entry will be deleted\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-\-user\fR .RS 4 Execute "user" configuration, i\&.e\&. @@ -155,6 +174,13 @@ Ignore configuration lines pertaining to unknown users or groups\&. This option Added in version 254\&. .RE .PP +\fB\-\-dry\-run\fR +.RS 4 +Process the configuration and print what operations would be performed, but don\*(Aqt actually change anything in the file system\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-\-prefix=\fR\fB\fIpath\fR\fR .RS 4 Only apply rules with paths that start with the specified prefix\&. This option can be specified multiple times\&. @@ -299,7 +325,7 @@ credential from the service manager\&. .PP \fI$SYSTEMD_LOG_LEVEL\fR .RS 4 -The maximum log level of emitted messages (messages with a higher log level, i\&.e\&. less important ones, will be suppressed)\&. Either one of (in order of decreasing importance) +The maximum log level of emitted messages (messages with a higher log level, i\&.e\&. less important ones, will be suppressed)\&. Takes a comma\-separated list of values\&. A value may be either one of (in order of decreasing importance) \fBemerg\fR, \fBalert\fR, \fBcrit\fR, @@ -309,7 +335,15 @@ The maximum log level of emitted messages (messages with a higher log level, i\& \fBinfo\fR, \fBdebug\fR, or an integer in the range 0\&...7\&. See \fBsyslog\fR(3) -for more information\&. +for more information\&. Each value may optionally be prefixed with one of +\fBconsole\fR, +\fBsyslog\fR, +\fBkmsg\fR +or +\fBjournal\fR +followed by a colon to set the maximum log level for that specific log target (e\&.g\&. +\fBSYSTEMD_LOG_LEVEL=debug,console:info\fR +specifies to log at debug level except when logging to the console which should be at info level)\&. Note that the global maximum log level takes priority over any per target maximum log levels\&. .RE .PP \fI$SYSTEMD_LOG_COLOR\fR @@ -415,6 +449,12 @@ will be ignored by the executable, and needs to be handled by the pager\&. This option instructs the pager to not send termcap initialization and deinitialization strings to the terminal\&. It is set by default to allow command output to remain visible in the terminal even after the pager exits\&. Nevertheless, this prevents some pager functionality from working, in particular paged output cannot be scrolled with the mouse\&. .RE .sp +Note that setting the regular +\fI$LESS\fR +environment variable has no effect for +\fBless\fR +invocations by systemd tools\&. +.sp See \fBless\fR(1) for more discussion\&. @@ -426,6 +466,12 @@ Override the charset passed to \fBless\fR (by default "utf\-8", if the invoking terminal is determined to be UTF\-8 compatible)\&. +.sp +Note that setting the regular +\fI$LESSCHARSET\fR +environment variable has no effect for +\fBless\fR +invocations by systemd tools\&. .RE .PP \fI$SYSTEMD_PAGERSECURE\fR @@ -507,8 +553,7 @@ Note: when creating items, if the target already exists, but is of the wrong typ "+", a message is emitted, but the failure is otherwise ignored\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBtmpfiles.d\fR(5) +\fBsystemd\fR(1), \fBtmpfiles.d\fR(5) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man8/systemd-tpm2-generator.8 b/upstream/fedora-rawhide/man8/systemd-tpm2-generator.8 new file mode 100644 index 00000000..c7b522fe --- /dev/null +++ b/upstream/fedora-rawhide/man8/systemd-tpm2-generator.8 @@ -0,0 +1,53 @@ +'\" t +.TH "SYSTEMD\-TPM2\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-tpm2-generator" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +systemd-tpm2-generator \- Generator for inserting TPM2 synchronization point in the boot process +.SH "SYNOPSIS" +.PP +/usr/lib/systemd/system\-generators/systemd\-tpm2\-generator +.SH "DESCRIPTION" +.PP +systemd\-tpm2\-generator +is a generator that adds a +\fIWants=\fR +dependency from +sysinit\&.target +to +tpm2\&.target +when it detects that the firmware discovered a TPM2 device but the OS kernel so far did not\&. +tpm2\&.target +is supposed to act as synchronization point for all services that require TPM2 device access\&. See +\fBsystemd.special\fR(7) +for details\&. +.PP +The +\fBsystemd\&.tpm2_wait=\fR +kernel command line option may be used to override behaviour of the generator\&. It accepts a boolean value: if true then +tpm2\&.target +will be added as synchronization point even if the firmware has not detected a TPM2 device\&. If false, the target will not be inserted even if firmware reported a device but the OS kernel doesn\*(Aqt expose a device for it yet\&. The latter might be useful in environments where a suitable TPM2 driver for the available hardware is not available\&. +.PP +systemd\-tpm2\-generator +implements +\fBsystemd.generator\fR(7)\&. +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), \fBsystemd.special\fR(7), \fBkernel-command-line\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-tpm2-setup.service.8 b/upstream/fedora-rawhide/man8/systemd-tpm2-setup.service.8 index bccb5479..4a302641 100644 --- a/upstream/fedora-rawhide/man8/systemd-tpm2-setup.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-tpm2-setup.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-TPM2\-SETUP\&.SERVICE" "8" "" "systemd 255" "systemd-tpm2-setup.service" +.TH "SYSTEMD\-TPM2\-SETUP\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-tpm2-setup.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -36,7 +36,7 @@ are services that generate the Storage Root Key (SRK) if it hasn\*(Aqt been gene The services will store the public key of the SRK key pair in a PEM file in /run/systemd/tpm2\-srk\-public\-key\&.pem and -/var/lib/systemd/tpm2\-srk\-public\-key\&.pem\&. It will also store it in TPM2B_PUBLIC format in +/var/lib/systemd/tpm2\-srk\-public\-key\&.pem\&. They will also store it in TPM2B_PUBLIC format in /run/systemd/tpm2\-srk\-public\-key\&.tpm2_public and /var/lib/systemd/tpm2\-srk\-public\-key\&.tpm2b_public\&. diff --git a/upstream/fedora-rawhide/man8/systemd-udev-settle.service.8 b/upstream/fedora-rawhide/man8/systemd-udev-settle.service.8 index d045f09e..e22bd6a0 100644 --- a/upstream/fedora-rawhide/man8/systemd-udev-settle.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-udev-settle.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-UDEV\-SETTLE\&.SERVICE" "8" "" "systemd 255" "systemd-udev-settle.service" +.TH "SYSTEMD\-UDEV\-SETTLE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-udev-settle.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -38,5 +38,4 @@ systemd\-udev\-settle\&.service usually slows boot significantly, because it means waiting for all unrelated events too\&. .SH "SEE ALSO" .PP -\fBudev\fR(7), -\fBudevadm\fR(8) +\fBudev\fR(7), \fBudevadm\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-udevd.service.8 b/upstream/fedora-rawhide/man8/systemd-udevd.service.8 index 5ca6437b..d0216520 100644 --- a/upstream/fedora-rawhide/man8/systemd-udevd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-udevd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-UDEVD\&.SERVICE" "8" "" "systemd 255" "systemd-udevd.service" +.TH "SYSTEMD\-UDEVD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-udevd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -176,7 +176,7 @@ Network interfaces are renamed to give them predictable names when possible\&. I Added in version 199\&. .RE .PP -\fInet\&.naming\-scheme=\fR +\fInet\&.naming_scheme=\fR .RS 4 Network interfaces are renamed to give them predictable names when possible (unless \fInet\&.ifnames=0\fR @@ -193,7 +193,7 @@ is checking might appear, which affects older name derivation algorithms, too\&. Added in version 240\&. .RE .PP -\fInet\&.ifname\-policy=\fR\fI\fIpolicy1\fR\fR\fI[,\fR\fI\fIpolicy2\fR\fR\fI,\&...][,\fR\fI\fIMAC\fR\fR\fI]\fR +\fInet\&.ifname_policy=\fR\fI\fIpolicy1\fR\fR\fI[,\fR\fI\fIpolicy2\fR\fR\fI,\&...][,\fR\fI\fIMAC\fR\fR\fI]\fR .RS 4 Specifies naming policies applied when renaming network interfaces\&. Takes a list of policies and an optional MAC address separated with comma\&. Each policy value must be one of the policies understood by the \fINamePolicy=\fR @@ -216,8 +216,8 @@ Example: .RS 4 .\} .nf -net\&.ifname\-policy=keep,kernel,path,slot,onboard,01:23:45:67:89:ab -net\&.ifname\-policy=keep,kernel,path,slot,onboard,mac +net\&.ifname_policy=keep,kernel,path,slot,onboard,01:23:45:67:89:ab +net\&.ifname_policy=keep,kernel,path,slot,onboard,mac .fi .if n \{\ .RE @@ -263,6 +263,4 @@ Added in version 250\&. .RE .SH "SEE ALSO" .PP -\fBudev.conf\fR(5), -\fBudev\fR(7), -\fBudevadm\fR(8) +\fBudev.conf\fR(5), \fBudev\fR(7), \fBudevadm\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-update-done.service.8 b/upstream/fedora-rawhide/man8/systemd-update-done.service.8 index 22332dc8..84becd01 100644 --- a/upstream/fedora-rawhide/man8/systemd-update-done.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-update-done.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-UPDATE\-DONE\&.SERVICE" "8" "" "systemd 255" "systemd-update-done.service" +.TH "SYSTEMD\-UPDATE\-DONE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-update-done.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -68,7 +68,7 @@ are always followed by an update of the modification time of on it\&. .PP Note that if the -\fIsystemd\&.condition\-needs\-update=\fR +\fIsystemd\&.condition_needs_update=\fR kernel command line option is used it overrides the \fIConditionNeedsUpdate=\fR unit condition checks\&. In that case @@ -76,6 +76,4 @@ systemd\-update\-done\&.service will not reset the condition state until a follow\-up reboot where the kernel switch is not specified anymore\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.unit\fR(5), -\fBtouch\fR(1) +\fBsystemd\fR(1), \fBsystemd.unit\fR(5), \fBtouch\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-update-utmp.service.8 b/upstream/fedora-rawhide/man8/systemd-update-utmp.service.8 index b7c6e013..32babd63 100644 --- a/upstream/fedora-rawhide/man8/systemd-update-utmp.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-update-utmp.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-UPDATE\-UTMP\&.SERVICE" "8" "" "systemd 255" "systemd-update-utmp.service" +.TH "SYSTEMD\-UPDATE\-UTMP\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-update-utmp.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -36,6 +36,4 @@ systemd\-update\-utmp\&.service does the same for system reboots and shutdown requests\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fButmp\fR(5), -\fBauditd\fR(8) +\fBsystemd\fR(1), \fButmp\fR(5), \fBauditd\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-user-sessions.service.8 b/upstream/fedora-rawhide/man8/systemd-user-sessions.service.8 index c6be118b..eb24a0f7 100644 --- a/upstream/fedora-rawhide/man8/systemd-user-sessions.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-user-sessions.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-USER\-SESSIONS\&.SERVICE" "8" "" "systemd 255" "systemd-user-sessions.service" +.TH "SYSTEMD\-USER\-SESSIONS\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-user-sessions.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -35,6 +35,4 @@ is a service that controls user logins through /run/nologin, thus prohibiting further logins\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-logind.service\fR(8), -\fBpam_nologin\fR(8) +\fBsystemd\fR(1), \fBsystemd-logind.service\fR(8), \fBpam_nologin\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-userdbd.service.8 b/upstream/fedora-rawhide/man8/systemd-userdbd.service.8 index 62831c5d..af9109e6 100644 --- a/upstream/fedora-rawhide/man8/systemd-userdbd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-userdbd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-USERDBD\&.SERVICE" "8" "" "systemd 255" "systemd-userdbd.service" +.TH "SYSTEMD\-USERDBD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-userdbd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -68,10 +68,7 @@ to JSON user/group records, thus hiding the differences between the services as makes JSON user/group records from the aforementioned drop\-in directories available\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBnss-systemd\fR(8), -\fBuserdbctl\fR(1), -\fBsystemd-homed.service\fR(8) +\fBsystemd\fR(1), \fBnss-systemd\fR(8), \fBuserdbctl\fR(1), \fBsystemd-homed.service\fR(8) .SH "NOTES" .IP " 1." 4 JSON User Records diff --git a/upstream/fedora-rawhide/man8/systemd-vconsole-setup.service.8 b/upstream/fedora-rawhide/man8/systemd-vconsole-setup.service.8 index 46a2f5bc..f835126a 100644 --- a/upstream/fedora-rawhide/man8/systemd-vconsole-setup.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-vconsole-setup.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-VCONSOLE\-SETUP\&.SERVICE" "8" "" "systemd 255" "systemd-vconsole-setup.service" +.TH "SYSTEMD\-VCONSOLE\-SETUP\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-vconsole-setup.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -92,8 +92,4 @@ Added in version 253\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBvconsole.conf\fR(5), -\fBloadkeys\fR(1), -\fBsetfont\fR(8), -\fBsystemd-localed.service\fR(8) +\fBsystemd\fR(1), \fBvconsole.conf\fR(5), \fBloadkeys\fR(1), \fBsetfont\fR(8), \fBsystemd-localed.service\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-veritysetup-generator.8 b/upstream/fedora-rawhide/man8/systemd-veritysetup-generator.8 index 7f3c0453..b5df221f 100644 --- a/upstream/fedora-rawhide/man8/systemd-veritysetup-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-veritysetup-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-VERITYSETUP\-GENERATOR" "8" "" "systemd 255" "systemd-veritysetup-generator" +.TH "SYSTEMD\-VERITYSETUP\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-veritysetup-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -113,7 +113,4 @@ Added in version 250\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-veritysetup@.service\fR(8), -\fBveritysetup\fR(8), -\fBsystemd-fstab-generator\fR(8) +\fBsystemd\fR(1), \fBsystemd-veritysetup@.service\fR(8), \fBveritysetup\fR(8), \fBsystemd-fstab-generator\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-veritysetup@.service.8 b/upstream/fedora-rawhide/man8/systemd-veritysetup@.service.8 index f12ba36f..47410e5f 100644 --- a/upstream/fedora-rawhide/man8/systemd-veritysetup@.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-veritysetup@.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-VERITYSETUP@\&.SERVICE" "8" "" "systemd 255" "systemd-veritysetup@.service" +.TH "SYSTEMD\-VERITYSETUP@\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-veritysetup@.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -78,9 +78,7 @@ Added in version 250\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-veritysetup-generator\fR(8), -\fBveritysetup\fR(8) +\fBsystemd\fR(1), \fBsystemd-veritysetup-generator\fR(8), \fBveritysetup\fR(8) .SH "NOTES" .IP " 1." 4 Kernel dm-verity diff --git a/upstream/fedora-rawhide/man8/systemd-volatile-root.service.8 b/upstream/fedora-rawhide/man8/systemd-volatile-root.service.8 index 4e8c59bc..a13b4ac4 100644 --- a/upstream/fedora-rawhide/man8/systemd-volatile-root.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-volatile-root.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-VOLATILE\-ROOT\&.SERVICE" "8" "" "systemd 255" "systemd-volatile-root.service" +.TH "SYSTEMD\-VOLATILE\-ROOT\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-volatile-root.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -45,6 +45,4 @@ on the kernel command line\&. This service runs only in the initrd, before the s is used, as in that mode the root directory is non\-volatile\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-fstab-generator\fR(8), -\fBkernel-command-line\fR(7) +\fBsystemd\fR(1), \fBsystemd-fstab-generator\fR(8), \fBkernel-command-line\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-xdg-autostart-generator.8 b/upstream/fedora-rawhide/man8/systemd-xdg-autostart-generator.8 index 4d0787cc..ebc2347f 100644 --- a/upstream/fedora-rawhide/man8/systemd-xdg-autostart-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-xdg-autostart-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-XDG\-AUTOSTART\-GENERATOR" "8" "" "systemd 255" "systemd-xdg-autostart-generator" +.TH "SYSTEMD\-XDG\-AUTOSTART\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-xdg-autostart-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -108,9 +108,7 @@ implements \fBsystemd.generator\fR(7)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.service\fR(5), -\fBsystemd.target\fR(5) +\fBsystemd\fR(1), \fBsystemd.service\fR(5), \fBsystemd.target\fR(5) .SH "NOTES" .IP " 1." 4 XDG autostart diff --git a/upstream/fedora-rawhide/man8/telinit.8 b/upstream/fedora-rawhide/man8/telinit.8 index 750c2242..98b4a670 100644 --- a/upstream/fedora-rawhide/man8/telinit.8 +++ b/upstream/fedora-rawhide/man8/telinit.8 @@ -1,5 +1,5 @@ '\" t -.TH "TELINIT" "8" "" "systemd 255" "telinit" +.TH "TELINIT" "8" "" "systemd 256~rc3" "telinit" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -22,8 +22,8 @@ .SH "NAME" telinit \- Change SysV runlevel .SH "SYNOPSIS" -.HP \w'\fBtelinit\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB{COMMAND}\fR\ 'u -\fBtelinit \fR\fB[OPTIONS...]\fR\fB \fR\fB{COMMAND}\fR +.HP \w'\fBtelinit\fR\ 'u +\fBtelinit\fR [OPTIONS...] {COMMAND} .SH "DESCRIPTION" .PP \fBtelinit\fR @@ -96,6 +96,4 @@ On success, 0 is returned, a non\-zero failure code otherwise\&. This is a legacy command available for compatibility only\&. It should not be used anymore, as the concept of runlevels is obsolete\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBwall\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBwall\fR(1) diff --git a/upstream/fedora-rawhide/man8/testpkg.8 b/upstream/fedora-rawhide/man8/testpkg.8 new file mode 100644 index 00000000..f92379f8 --- /dev/null +++ b/upstream/fedora-rawhide/man8/testpkg.8 @@ -0,0 +1,173 @@ +'\" t +.\" Title: testpkg +.\" Author: [see the "Authors" section] +.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> +.\" Date: 2024-04-14 +.\" Manual: Pacman Manual +.\" Source: Pacman 6.1.0 +.\" Language: English +.\" +.TH "TESTPKG" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +testpkg \- test a pacman package for validity +.SH "SYNOPSIS" +.sp +\fItestpkg\fR <package file> +.SH "DESCRIPTION" +.sp +\fItestpkg\fR is a script used to make sure that a pacman package is valid\&. +.SH "SEE ALSO" +.sp +\fBpacman\fR(8) +.sp +See the pacman website at https://archlinux\&.org/pacman/ for current information on pacman and its related tools\&. +.SH "BUGS" +.sp +Bugs? You must be kidding; there are no bugs in this software\&. But if we happen to be wrong, submit a bug report with as much detail as possible at the Arch Linux Bug Tracker in the Pacman section\&. +.SH "AUTHORS" +.sp +Current maintainers: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Allan McRae <allan@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Morgan Adamiec <morganamilo@archlinux\&.org> +.RE +.sp +Past major contributors: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Judd Vinet <jvinet@zeroflux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Aurelien Foret <aurelien@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Aaron Griffin <aaron@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Dan McGee <dan@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Xavier Chantry <shiningxc@gmail\&.com> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Dave Reisner <dreisner@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp +For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/tipc-nametable.8 b/upstream/fedora-rawhide/man8/tipc-nametable.8 index b187d25e..f7c51f19 100644 --- a/upstream/fedora-rawhide/man8/tipc-nametable.8 +++ b/upstream/fedora-rawhide/man8/tipc-nametable.8 @@ -49,13 +49,13 @@ provided by a port. .B Lower .br The lower bound of the 32-bit instance field of the port name. -The instance field is often used as as a sub-class indicator. +The instance field is often used as a sub-class indicator. .TP .B Upper .br The upper bound of the 32-bit instance field of the port name. -The instance field is often used as as a sub-class indicator. +The instance field is often used as a sub-class indicator. A difference in .BR "lower " "and " upper means the socket is bound to the port name range [lower,upper] diff --git a/upstream/fedora-rawhide/man8/tzselect.8 b/upstream/fedora-rawhide/man8/tzselect.8 index 9b9049f7..ee031614 100644 --- a/upstream/fedora-rawhide/man8/tzselect.8 +++ b/upstream/fedora-rawhide/man8/tzselect.8 @@ -36,7 +36,7 @@ The program asks the user for information about the current location, and outputs the resulting timezone to standard output. The output is suitable as a value for the TZ environment variable. -.P +.PP All interaction with the user is done via standard input and standard error. .SH OPTIONS .TP @@ -95,7 +95,7 @@ Output version information and exit. .SH "ENVIRONMENT VARIABLES" .TP \f3AWK\fP -Name of a Posix-compliant +Name of a POSIX-compliant .B awk program (default: .BR awk ). diff --git a/upstream/fedora-rawhide/man8/udevadm.8 b/upstream/fedora-rawhide/man8/udevadm.8 index 234da89e..13c69e52 100644 --- a/upstream/fedora-rawhide/man8/udevadm.8 +++ b/upstream/fedora-rawhide/man8/udevadm.8 @@ -1,5 +1,5 @@ '\" t -.TH "UDEVADM" "8" "" "systemd 255" "udevadm" +.TH "UDEVADM" "8" "" "systemd 256~rc3" "udevadm" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -64,7 +64,7 @@ commands\&. .RS 4 Print a short help text and exit\&. .RE -.SS "udevadm info [\fIoptions\fR] [\fIdevpath\fR|\fIfile\fR|\fIunit\fR...]" +.SS "udevadm info [\fIoptions\fR] [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]" .PP Query the udev database for device information\&. .PP @@ -260,7 +260,7 @@ When used with Added in version 255\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Shows output formatted as JSON\&. Expects one of "short" @@ -504,8 +504,18 @@ is specified, trigger events for devices that are not initialized by yet, and skip devices that are already initialized\&. .sp Typically, it is essential that applications which intend to use such a match, make sure a suitable udev rule is installed that sets at least one property on devices that shall be matched\&. See also Initialized Devices section below for more details\&. +.if n \{\ .sp -WARNING: +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBWarning\fR +.ps -1 +.br \fB\-\-initialized\-nomatch\fR can potentially save a significant amount of time compared to re\-triggering all devices in the system and e\&.g\&. can be used to optimize boot time\&. However, this is not safe to be used in a boot sequence in general\&. Especially, when udev rules for a device depend on its parent devices (e\&.g\&. "ATTRS" @@ -514,7 +524,8 @@ or keys, see \fBudev\fR(7) for more details), the final state of the device becomes easily unstable with this option\&. -.sp +.sp .5v +.RE Added in version 251\&. .RE .PP @@ -640,7 +651,7 @@ Signal systemd\-udevd to reload the rules files and other databases like the ker Set a global property for all events\&. .RE .PP -\fB\-m\fR, \fB\-\-children\-max=\fR\fIvalue\fR +\fB\-m\fR, \fB\-\-children\-max=\fR\fB\fIvalue\fR\fR .RS 4 Set the maximum number of events, systemd\-udevd will handle at the same time\&. When 0 is specified, then the maximum is determined based on the system resources\&. .RE @@ -652,11 +663,53 @@ Send a ping message to systemd\-udevd and wait for the reply\&. This may be usef Added in version 241\&. .RE .PP -\fB\-t\fR, \fB\-\-timeout=\fR\fIseconds\fR +\fB\-t\fR, \fB\-\-timeout=\fR\fB\fIseconds\fR\fR .RS 4 The maximum number of seconds to wait for a reply from systemd\-udevd\&. .RE .PP +\fB\-\-load\-credentials\fR +.RS 4 +When specified, the following credentials are used when passed in: +.PP +\fIudev\&.conf\&.*\fR +.RS 4 +These credentials should contain valid +\fBudev.conf\fR(5) +configuration data\&. From each matching credential a separate file is created\&. Example: a passed credential +udev\&.conf\&.50\-foobar +will be copied into a configuration file +/run/udev/udev\&.conf\&.d/50\-foobar\&.conf\&. +.sp +Added in version 256\&. +.RE +.PP +\fIudev\&.rules\&.*\fR +.RS 4 +These credentials should contain valid +\fBudev\fR(7) +rules\&. From each matching credential a separate file is created\&. Example: a passed credential +udev\&.rules\&.50\-foobar +will be copied into a configuration file +/run/udev/rules\&.d/50\-foobar\&.rules\&. +.sp +Added in version 256\&. +.RE +.sp +Note, this +\fIdoes not\fR +imply +\fB\-\-reload\fR +option\&. So, if +\fBsystemd\-udevd\fR +is already running, please consider to also specify +\fB\-reload\fR +to make the copied udev rules files used by +\fBsystemd\-udevd\fR\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-h\fR, \fB\-\-help\fR .RS 4 Print a short help text and exit\&. @@ -729,7 +782,7 @@ Added in version 209\&. .RS 4 Print a short help text and exit\&. .RE -.SS "udevadm test\-builtin [\fIoptions\fR] [\fIcommand\fR] [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]" +.SS "udevadm test\-builtin [\fIoptions\fR] \fIcommand\fR [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]" .PP Run a built\-in command \fICOMMAND\fR @@ -763,7 +816,7 @@ Print a short help text and exit\&. .RS 4 Print a short version string and exit\&. .RE -.SS "udevadm verify [\fIoptions\fR] [\fIfile\fR...] \&..." +.SS "udevadm verify [\fIoptions\fR] [\fIfile\fR] \&..." .PP Verify syntactic, semantic, and stylistic correctness of udev rules files\&. .PP @@ -984,8 +1037,7 @@ doesn\*(Aqt probe or announce the new superblock before it is fully written: .\} .SH "SEE ALSO" .PP -\fBudev\fR(7), -\fBsystemd-udevd.service\fR(8) +\fBudev\fR(7), \fBsystemd-udevd.service\fR(8) .SH "NOTES" .IP " 1." 4 Locking Block Device Access diff --git a/upstream/fedora-rawhide/man8/update-pciids.8 b/upstream/fedora-rawhide/man8/update-pciids.8 index ca01c279..b48fdabf 100644 --- a/upstream/fedora-rawhide/man8/update-pciids.8 +++ b/upstream/fedora-rawhide/man8/update-pciids.8 @@ -1,4 +1,4 @@ -.TH update-pciids 8 "25 February 2024" "pciutils-3.11.1" "The PCI Utilities" +.TH update-pciids 8 "05 April 2024" "pciutils-3.12.0" "The PCI Utilities" .SH NAME update-pciids \- download new version of the PCI ID list diff --git a/upstream/fedora-rawhide/man8/updatedb.8 b/upstream/fedora-rawhide/man8/updatedb.8 deleted file mode 100644 index 45a1a633..00000000 --- a/upstream/fedora-rawhide/man8/updatedb.8 +++ /dev/null @@ -1,205 +0,0 @@ -.\" A man page for updatedb(8). -*- nroff -*- -.\" -.\" Copyright (C) 2005, 2007, 2008 Red Hat, Inc. All rights reserved. -.\" -.\" This copyrighted material is made available to anyone wishing to use, -.\" modify, copy, or redistribute it subject to the terms and conditions of the -.\" GNU General Public License v.2. -.\" -.\" This program is distributed in the hope that it will be useful, but WITHOUT -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for -.\" more details. -.\" -.\" You should have received a copy of the GNU General Public License along -.\" with this program; if not, write to the Free Software Foundation, Inc., -.\" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. -.\" -.\" Author: Miloslav Trmac <mitr@redhat.com> -.TH updatedb 8 "Jun 2008" mlocate - -.SH NAME -updatedb \- update a database for mlocate - -.SH SYNOPSIS - -\fBupdatedb\fR [\fIOPTION\fR]... - -.SH DESCRIPTION -.B updatedb -creates or updates a database used by -.BR locate (1). -If the database already exists, -its data is reused -to avoid rereading directories that have not changed. - -.B updatedb -is usually run daily by -.BR cron (8) -to update the default database. - -.SH EXIT STATUS -.B updatedb -returns with exit status 0 on success, 1 on error. - -.SH OPTIONS -The \fBPRUNE_BIND_MOUNTS\fR, \fBPRUNEFS\fR, -.B PRUNENAMES -and -.B PRUNEPATHS -variables, which are modified by some of the options, are documented in detail -in -.BR updatedb.conf (5). - -.TP -\fB\-f\fR, \fB\-\-add-prunefs\fB \fIFS\fR -Add entries in white-space-separated list \fIFS\fR to \fBPRUNEFS\fR. - -.TP -\fB\-n\fR, \fB\-\-add-prunenames\fB \fINAMES\fR -Add entries in white-space-separated list \fINAMES\fR to \fBPRUNENAMES\fR. - -.TP -\fB\-e\fR, \fB\-\-add-prunepaths\fB \fIPATHS\fR -Add entries in white-space-separated list \fIPATHS\fR to \fBPRUNEPATHS\fR. - -.TP -\fB\-U\fR, \fB\-\-database\-root\fR \fIPATH\fR -Store only results of scanning the file system subtree rooted at \fIPATH\fR to -the generated database. -The whole file system is scanned by default. - -.BR locate (1) -outputs entries as absolute path names which don't contain symbolic links, -regardless of the form of \fIPATH\fR. - -.TP -\fB\-\-debug\-pruning\fR -Write debugging information about pruning decisions to standard error output. - -.TP -\fB\-h\fR, \fB\-\-help\fR -Write a summary of the available options to standard output -and exit successfully. - -.TP -\fB\-o\fR, \fB\-\-output\fR \fIFILE\fR -Write the database to -.I FILE -instead of using the default database. - -.TP -\fB\-\-prune\-bind\-mounts\fR \fIFLAG\fR -Set -.B PRUNE_BIND_MOUNTS -to \fIFLAG\fR, overriding the configuration file. - -.TP -\fB\-\-prunefs\fR \fIFS\fR -Set \fBPRUNEFS\fR to \fIFS\fR, overriding the configuration file. - -.TP -\fB\-\-prunenames\fR \fINAMES\fR -Set \fBPRUNENAMES\fR to \fINAMES\fR, overriding the configuration file. - -.TP -\fB\-\-prunepaths\fR \fIPATHS\fR -Set \fBPRUNEPATHS\fR to \fIPATHS\fR, overriding the configuration file. - -.TP -\fB\-l\fR, \fB\-\-require\-visibility\fR \fIFLAG\fR -Set the \*(lqrequire file visibility before reporting it\*(rq flag in the -generated database to \fIFLAG\fR. - -If -.I FLAG -is -.B 0 -or \fBno\fR, -or if the database file is readable by "others" -or it is not owned by \fBslocate\fR, -.BR locate (1) -outputs the database entries even if the user running -.BR locate (1) -could not have read the directory necessary to find out the file described -by the database entry. - -If -.I FLAG -is -.B 1 -or -.B yes -(the default), -.BR locate (1) -checks the permissions of parent directories of each entry -before reporting it to the invoking user. -To make the file existence truly hidden from other users, the database -group is set to -.B slocate -and the database permissions prohibit reading the database by users using -other means than -.BR locate (1), -which is set-gid \fBslocate\fR. - -Note that the visibility flag is checked only if the database is owned by -.B slocate -and it is not readable by "others". - -.TP -\fB\-v\fR, \fB\-\-verbose\fR -Output path names of files to standard output, as soon as they are found. - -.TP -\fB\-V\fR, \fB\-\-version\fR -Write information about the version and license of -.B locate -on standard output and exit successfully. - -.SH EXAMPLES -To create a private mlocate database as an user other than \fBroot\fR, -run -.RS -.B updatedb -l 0 \-o -.I db_file -.B \-U -.I source_directory -.RE -Note that all users that can read -.I db_file -can get the complete list of files in the subtree of \fIsource_directory\fR. - -.SH FILES -.TP -\fB/etc/updatedb.conf\fR -A configuration file. See -.BR updatedb.conf (5). - -.TP -\fB/var/lib/mlocate/mlocate.db\fR -The database updated by default. - -.SH SECURITY -Databases built with -.B \-\-require\-visibility no -allow users to find names of files and directories of other users, -which they would not otherwise be able to do. - -.SH NOTES -The accompanying -.BR locate (1) -utility was designed to be compatible to -.B slocate -and attempts to be compatible to -.SM GNU -.B locate -where possible. -This is not the case for \fBupdatedb\fR. - -.SH AUTHOR -Miloslav Trmac <mitr@redhat.com> - -.SH SEE ALSO -.BR locate (1), -.BR mlocate.db (5), -.BR updatedb.conf (5) diff --git a/upstream/fedora-rawhide/man8/vercmp.8 b/upstream/fedora-rawhide/man8/vercmp.8 index b429a862..6e38436c 100644 --- a/upstream/fedora-rawhide/man8/vercmp.8 +++ b/upstream/fedora-rawhide/man8/vercmp.8 @@ -2,12 +2,12 @@ .\" Title: vercmp .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "VERCMP" "8" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "VERCMP" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -191,17 +191,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -284,4 +273,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/xfs_db.8 b/upstream/fedora-rawhide/man8/xfs_db.8 index f53ddd67..a7f6d55e 100644 --- a/upstream/fedora-rawhide/man8/xfs_db.8 +++ b/upstream/fedora-rawhide/man8/xfs_db.8 @@ -388,6 +388,29 @@ and options are used to select the attribute or data area of the inode, if neither option is given then both areas are shown. .TP +.BI "bmapinflate [\-d " dirty_bytes "] [-e] [\-n " nr "] +Duplicates the first data fork mapping this many times, as if the mapping had +been repeatedly reflinked. +This is an expert-mode command for exercising high-refcount filesystems only. +Existing data fork mappings will be forgotten and the refcount btree will not +be updated. +This command leaves at least the refcount btree and the inode inconsistent; +.B xfs_repair +must be run afterwards. +.RS 1.0i +.TP 0.4i +.B \-d +Constrain the memory consumption of new dirty btree blocks to this quantity. +Defaults to 60MiB. +.TP 0.4i +.B \-e +Estimate the number of blocks and height of the new data fork mapping +structure and exit without changing anything. +.TP 0.4i +.B \-n +Create this many copies of the first mapping. +.RE +.TP .B btdump [-a] [-i] If the cursor points to a btree node, dump the btree from that block downward. If instead the cursor points to an inode, dump the data fork block mapping btree if there is one. diff --git a/upstream/fedora-rawhide/man8/yum-copr.8 b/upstream/fedora-rawhide/man8/yum-copr.8 index 6f7a9310..f09693ff 100644 --- a/upstream/fedora-rawhide/man8/yum-copr.8 +++ b/upstream/fedora-rawhide/man8/yum-copr.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "YUM-COPR" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "YUM-COPR" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME yum-copr \- redirecting to DNF copr Plugin .sp diff --git a/upstream/fedora-rawhide/man8/zdump.8 b/upstream/fedora-rawhide/man8/zdump.8 index a248d297..c3f0bba6 100644 --- a/upstream/fedora-rawhide/man8/zdump.8 +++ b/upstream/fedora-rawhide/man8/zdump.8 @@ -110,7 +110,7 @@ zero or more following lines .q "\fIdate time interval\fP", one line for each transition time and following interval. Fields are separated by single tabs. -.P +.PP Dates are in .IR yyyy - mm - dd format and times are in 24-hour @@ -126,7 +126,7 @@ double-quoted strings unless they consist of one or more alphabetic characters. An isdst flag is omitted for standard time, and otherwise is a decimal integer that is unsigned and positive (typically 1) for daylight saving time and negative for unknown. -.P +.PP In times and in UT offsets with absolute value less than 100 hours, the seconds are omitted if they are zero, and the minutes are also omitted if they are also zero. Positive UT @@ -137,14 +137,14 @@ abbreviation begins with .q "\*-" or is .q "zzz". -.P +.PP In double-quoted strings, escape sequences represent unusual characters. The escape sequences are \es for space, and \e", \e\e, \ef, \en, \er, \et, and \ev with their usual meaning in the C programming language. E.g., the double-quoted string \*(lq"CET\es\e"\e\e"\*(rq represents the character sequence \*(lqCET "\e\*(rq.\"" -.P +.PP .ne 9 Here is an example of the output, with the leading empty line omitted. (This example is shown with tab stops set far enough apart so that the @@ -152,10 +152,9 @@ tabbed columns line up.) .nf .sp .if \n(.g .ft CR -.if t .in +.5i -.if n .in +2 +.in +2 .nr w \w'1896-01-13 'u+\n(.i -.ta \w'1896-01-13 'u +\w'12:01:26 'u +\w'-103126 'u +\w'HWT 'u +.ta \w'1896-01-13\0\0'u +\w'12:01:26\0\0'u +\w'-103126\0\0'u +\w'HWT\0\0'u TZ="Pacific/Honolulu" - - -103126 LMT 1896-01-13 12:01:26 -1030 HST @@ -179,7 +178,7 @@ abbreviated HST. Immediately after the second transition, the date is Immediately after the last transition the date is 1947-06-08 and the time is 02:30:00, and the following time interval is 10 hours west of UT, a standard time abbreviated HST. -.P +.PP .ne 10 Here are excerpts from another example: .nf @@ -209,7 +208,7 @@ Time discontinuities are found by sampling the results returned by at twelve-hour intervals. This works in all real-world cases; one can construct artificial time zones for which this fails. -.P +.PP In the .B \*-v and diff --git a/upstream/fedora-rawhide/man8/zic.8 b/upstream/fedora-rawhide/man8/zic.8 index 557ccd28..0ad373a2 100644 --- a/upstream/fedora-rawhide/man8/zic.8 +++ b/upstream/fedora-rawhide/man8/zic.8 @@ -95,7 +95,7 @@ as local time. .B zic will act as if the input contained a link line of the form .sp -.ti +.5i +.ti +2 .ta \w'Link\0\0'u +\w'\fItimezone\fP\0\0'u Link \fItimezone\fP localtime .sp @@ -118,9 +118,15 @@ TZ strings like "EET\*-2EEST" that lack transition rules. .B zic will act as if the input contained a link line of the form .sp -.ti +.5i +.ti +2 Link \fItimezone\fP posixrules .sp +If +.I timezone +is +.q "\*-" +(the default), any already-existing link is removed. +.sp Unless .I timezone is .q "\*-" , @@ -131,12 +137,6 @@ and it should not be combined with if .IR timezone 's transitions are at standard time or Universal Time (UT) instead of local time. -.sp -If -.I timezone -is -.BR \*- , -any already-existing link is removed. .TP .BR "\*-r " "[\fB@\fP\fIlo\fP][\fB/@\fP\fIhi\fP]" Limit the applicability of output files @@ -171,7 +171,7 @@ boundaries, particularly if causes a TZif file to contain explicit entries for .RI pre- hi transitions rather than concisely representing them -with an extended POSIX TZ string. +with an extended POSIX.1-2017 TZ string. Also see the .B "\*-b slim" option for another way to shrink output size. @@ -181,10 +181,10 @@ Generate redundant trailing explicit transitions for timestamps that occur less than .I hi seconds since the Epoch, even though the transitions could be -more concisely represented via the extended POSIX TZ string. +more concisely represented via the extended POSIX.1-2017 TZ string. This option does not affect the represented timestamps. Although it accommodates nonstandard TZif readers -that ignore the extended POSIX TZ string, +that ignore the extended POSIX.1-2017 TZ string, it increases the size of the altered output files. .TP .BI "\*-t " file @@ -194,37 +194,37 @@ the named file rather than in the standard location. .B \*-v Be more verbose, and complain about the following situations: .RS -.P +.PP The input specifies a link to a link, something not supported by some older parsers, including .B zic itself through release 2022e. -.P +.PP A year that appears in a data file is outside the range of representable years. -.P +.PP A time of 24:00 or more appears in the input. Pre-1998 versions of .B zic prohibit 24:00, and pre-2007 versions prohibit times greater than 24:00. -.P +.PP A rule goes past the start or end of the month. Pre-2004 versions of .B zic prohibit this. -.P +.PP A time zone abbreviation uses a .B %z format. Pre-2015 versions of .B zic do not support this. -.P +.PP A timestamp contains fractional seconds. Pre-2018 versions of .B zic do not support this. -.P +.PP The input contains abbreviations that are mishandled by pre-2018 versions of .B zic due to a longstanding coding bug. @@ -242,20 +242,20 @@ and .q Su for .q Sun . -.P +.PP The output file does not contain all the information about the long-term future of a timezone, because the future cannot be summarized as -an extended POSIX TZ string. For example, as of 2023 this problem +an extended POSIX.1-2017 TZ string. For example, as of 2023 this problem occurs for Morocco's daylight-saving rules, as these rules are based on predictions for when Ramadan will be observed, something that -an extended POSIX TZ string cannot represent. -.P +an extended POSIX.1-2017 TZ string cannot represent. +.PP The output contains data that may not be handled properly by client code designed for older .B zic output formats. These compatibility issues affect only timestamps before 1970 or after the start of 2038. -.P +.PP The output contains a truncated leap second table, which can cause some older TZif readers to misbehave. This can occur if the @@ -264,17 +264,17 @@ option is used, and either an Expires line is present or the .B "\*-r" option is also used. -.P +.PP The output file contains more than 1200 transitions, which may be mishandled by some clients. The current reference client supports at most 2000 transitions; pre-2014 versions of the reference client support at most 1200 transitions. -.P +.PP A time zone abbreviation has fewer than 3 or more than 6 characters. POSIX requires at least 3, and requires implementations to support at least 6. -.P +.PP An output file name contains a byte that is not an ASCII letter, .q "\*-" , .q "/" , @@ -288,7 +288,7 @@ or that starts with Input files use the format described in this section; output files use .BR tzfile (5) format. -.P +.PP Input files should be text files, that is, they should be a series of zero or more lines, each ending in a newline byte and containing at most 2048 bytes counting the newline, and without any NUL bytes. @@ -303,7 +303,7 @@ nearly any character, other software will work better if these are limited to the restricted syntax described under the .B \*-v option. -.P +.PP Input lines are made up of fields. Fields are separated from one another by one or more white space characters. The white space characters are space, form feed, carriage return, newline, @@ -316,7 +316,7 @@ White space characters and sharp characters may be enclosed in double quotes Any line that is blank (after comment stripping) is ignored. Nonblank lines are expected to be of one of three types: rule lines, zone lines, and link lines. -.P +.PP Names must be in English and are case insensitive. They appear in several contexts, and include month and weekday names and keywords such as @@ -327,22 +327,22 @@ and .BR "Zone" . A name can be abbreviated by omitting all but an initial prefix; any abbreviation must be unambiguous in context. -.P +.PP A rule line has the form .nf -.ti +.5i +.ti +2 .ta \w'Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'\*-\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00w\0\0'u +\w'1:00d\0\0'u .sp Rule NAME FROM TO \*- IN ON AT SAVE LETTER/S .sp For example: -.ti +.5i +.ti +2 .sp Rule US 1967 1973 \*- Apr lastSun 2:00w 1:00d D .sp .fi The fields that make up a rule line are: -.TP "\w'LETTER/S'u" +.TP .B NAME Gives the name of the rule set that contains this line. The name must start with a character that is neither @@ -360,24 +360,15 @@ an unquoted name should not contain characters from the set Gives the first year in which the rule applies. Any signed integer year can be supplied; the proleptic Gregorian calendar is assumed, with year 0 preceding year 1. -The word -.B minimum -(or an abbreviation) means the indefinite past. -The word -.B maximum -(or an abbreviation) means the indefinite future. Rules can describe times that are not representable as time values, with the unrepresentable times ignored; this allows rules to be portable among hosts with differing time value types. .TP .B TO Gives the final year in which the rule applies. -In addition to -.B minimum -and +The word .B maximum -(as above), -the word +(or an abbreviation) means the indefinite future, and the word .B only (or an abbreviation) may be used to repeat the value of the @@ -404,7 +395,7 @@ Month names may be abbreviated. Gives the day on which the rule takes effect. Recognized forms include: .nf -.in +.5i +.in +2 .sp .ta \w'Sun<=25\0\0'u 5 the fifth of the month @@ -413,7 +404,7 @@ lastMon the last Monday in the month Sun>=8 first Sunday on or after the eighth Sun<=25 last Sunday on or before the 25th .fi -.in -.5i +.in .sp A weekday name (e.g., .BR "Sunday" ) @@ -440,7 +431,7 @@ Gives the time of day at which the rule takes effect, relative to 00:00, the start of a calendar day. Recognized forms include: .nf -.in +.5i +.in +2 .sp .ta \w'00:19:32.13\0\0'u 2 time in hours @@ -454,7 +445,7 @@ Recognized forms include: \*-2:30 2.5 hours before 00:00 \*- equivalent to 0 .fi -.in -.5i +.in .sp Although .B zic @@ -528,22 +519,22 @@ of time zone abbreviations to be used when this rule is in effect. If this field is .q \*- , the variable part is null. -.P +.PP A zone line has the form .sp .nf -.ti +.5i +.ti +2 .ta \w'Zone\0\0'u +\w'Asia/Amman\0\0'u +\w'STDOFF\0\0'u +\w'Jordan\0\0'u +\w'FORMAT\0\0'u Zone NAME STDOFF RULES FORMAT [UNTIL] .sp For example: .sp -.ti +.5i +.ti +2 Zone Asia/Amman 2:00 Jordan EE%sT 2017 Oct 27 01:00 .sp .fi The fields that make up a zone line are: -.TP "\w'STDOFF'u" +.TP .B NAME The name of the timezone. This is the name used in creating the time conversion information file for the @@ -632,7 +623,7 @@ Continuation lines may contain .q "until" information, just as zone lines do, indicating that the next line is a further continuation. -.P +.PP If a zone changes at the same instant that a rule would otherwise take effect in the earlier zone or continuation line, the rule is ignored. A zone or continuation line @@ -647,7 +638,7 @@ earliest rule use the rule in effect after first transition into standard time. In a single zone it is an error if two rules take effect at the same instant, or if two zone changes take effect at the same instant. -.P +.PP If a continuation line subtracts .I N seconds from the UT offset after a transition that would be @@ -663,15 +654,15 @@ For example: .br .ne 7 .nf -.in +2m +.in +2 .ta \w'# Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'2006\0\0'u +\w'\*-\0\0'u +\w'Oct\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u .sp # Rule NAME FROM TO \*- IN ON AT SAVE LETTER/S Rule US 1967 2006 - Oct lastSun 2:00 0 S Rule US 1967 1973 - Apr lastSun 2:00 1:00 D -.ta \w'Zone\0\0America/Menominee\0\0'u +\w'STDOFF\0\0'u +\w'RULES\0\0'u +\w'FORMAT\0\0'u -# Zone\0\0NAME STDOFF RULES FORMAT [UNTIL] -Zone\0\0America/Menominee \*-5:00 \*- EST 1973 Apr 29 2:00 +.ta \w'# Zone\0\0'u +\w'America/Menominee\0\0'u +\w'STDOFF\0\0'u +\w'RULES\0\0'u +\w'FORMAT\0\0'u +# Zone NAME STDOFF RULES FORMAT [UNTIL] +Zone America/Menominee \*-5:00 \*- EST 1973 Apr 29 2:00 \*-6:00 US C%sT .sp .in @@ -683,17 +674,17 @@ However, .B zic interprets this more sensibly as a single transition from 02:00 CST (\*-05) to 02:00 CDT (\*-05). -.P +.PP A link line has the form .sp .nf -.ti +.5i +.ti +2 .ta \w'Link\0\0'u +\w'Europe/Istanbul\0\0'u Link TARGET LINK-NAME .sp For example: .sp -.ti +.5i +.ti +2 Link Europe/Istanbul Asia/Istanbul .sp .fi @@ -717,7 +708,7 @@ For example: .sp .ne 3 .nf -.in +2m +.in +2 .ta \w'Zone\0\0'u +\w'Greenwich\0\0'u Link Greenwich G_M_T Link Etc/GMT Greenwich @@ -727,23 +718,23 @@ Zone Etc/GMT\0\00\0\0\*-\0\0GMT .fi The two links are chained together, and G_M_T, Greenwich, and Etc/GMT all name the same zone. -.P +.PP Except for continuation lines, lines may appear in any order in the input. However, the behavior is unspecified if multiple zone or link lines define the same name. -.P +.PP The file that describes leap seconds can have leap lines and an expiration line. Leap lines have the following form: .nf -.ti +.5i +.ti +2 .ta \w'Leap\0\0'u +\w'YEAR\0\0'u +\w'MONTH\0\0'u +\w'DAY\0\0'u +\w'HH:MM:SS\0\0'u +\w'CORR\0\0'u .sp Leap YEAR MONTH DAY HH:MM:SS CORR R/S .sp For example: -.ti +.5i +.ti +2 .sp Leap 2016 Dec 31 23:59:60 + S .sp @@ -775,7 +766,7 @@ or .q "Rolling" if the leap second time given by the other fields should be interpreted as local (wall clock) time. -.P +.PP Rolling leap seconds were implemented back when it was not clear whether common practice was rolling or stationary, with concerns that one would see @@ -788,16 +779,16 @@ which means rolling leap seconds are not used in practice; also, they are not supported if the .B \*-r option is used. -.P +.PP The expiration line, if present, has the form: .nf -.ti +.5i +.ti +2 .ta \w'Expires\0\0'u +\w'YEAR\0\0'u +\w'MONTH\0\0'u +\w'DAY\0\0'u .sp Expires YEAR MONTH DAY HH:MM:SS .sp For example: -.ti +.5i +.ti +2 .sp Expires 2020 Dec 28 00:00:00 .sp @@ -816,7 +807,7 @@ Here is an extended example of .B zic input, intended to illustrate many of its features. .nf -.in +2m +.in +2 .ta \w'# Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'\*-\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u .sp # Rule NAME FROM TO \*- IN ON AT SAVE LETTER/S @@ -856,7 +847,7 @@ and Swiss daylight saving rules (defined with lines beginning with .q "Rule Swiss") apply. From 1981 to the present, EU daylight saving rules have applied, and the UTC offset has remained at one hour. -.P +.PP In 1941 and 1942, daylight saving time applied from the first Monday in May at 01:00 to the first Monday in October at 02:00. The pre-1981 EU daylight-saving rules have no effect @@ -864,7 +855,7 @@ here, but are included for completeness. Since 1981, daylight saving has begun on the last Sunday in March at 01:00 UTC. Until 1995 it ended the last Sunday in September at 01:00 UTC, but this changed to the last Sunday in October starting in 1996. -.P +.PP For purposes of display, .q "LMT" and @@ -886,7 +877,7 @@ you may need to use local standard time in the .B AT field of the earliest transition time's rule to ensure that the earliest transition time recorded in the compiled file is correct. -.P +.PP If, for a particular timezone, a clock advance caused by the start of daylight saving |