diff options
Diffstat (limited to 'upstream/fedora-rawhide/man1')
468 files changed, 5522 insertions, 4131 deletions
diff --git a/upstream/fedora-rawhide/man1/addr2line.1 b/upstream/fedora-rawhide/man1/addr2line.1 index 1e175335..ce86f2bd 100644 --- a/upstream/fedora-rawhide/man1/addr2line.1 +++ b/upstream/fedora-rawhide/man1/addr2line.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ADDR2LINE 1" -.TH ADDR2LINE 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH ADDR2LINE 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/airscan-discover.1 b/upstream/fedora-rawhide/man1/airscan-discover.1 index 3ea3beea..5580e8aa 100644 --- a/upstream/fedora-rawhide/man1/airscan-discover.1 +++ b/upstream/fedora-rawhide/man1/airscan-discover.1 @@ -1,49 +1,40 @@ -.\" generated with Ronn/v0.7.3 -.\" http://github.com/rtomayko/ronn/tree/0.7.3 -. -.TH "AIRSCAN\-DISCOVER" "1" "May 2020" "" "SANE Scanner Access Now Easy" -. +.\" generated with Ronn-NG/v0.9.1 +.\" http://github.com/apjanke/ronn-ng/tree/0.9.1 +.TH "AIRSCAN\-DISCOVER" "1" "January 2024" "" "SANE Scanner Access Now Easy" .SH "NAME" \fBairscan\-discover\fR \- Discover sane\-airscan compatible scanners -. .SH "SYNOPSIS" -\fBairscan\-discover [\-h] [\-d] [\-t]\fR -. +\fBairscan\-discover [options]\fR .SH "DESCRIPTION" \fBairscan\-discover\fR is a command\-line tool to find eSCL and WSD scanners on a local network -. .P It uses Avahi to discover DNS\-SD devices and its own implementation of WS\-Discovery to discover WSD devices\. -. .P On success, it outputs a fragment of sane\-airscan configuration file, that can be directly added to \fB/etc/sane\.d/airscan\.conf\fR -. .SH "OPTIONS" -. .TP -\fB\-h\fR -Print help screen -. +\fB\-test\-fast\fR or \fB\-\-test\-fast\fR +Fast discovery mode (see ane\-airscan(5) for details) +.TP +\fB\-test\-auto\fR or \fB\-\-test\-auto\fR +Automatic protocol selection (see ane\-airscan(5) for details) .TP \fB\-d\fR Print debug messages to console -. .TP \fB\-t\fR Write a very detailed protocol trace to \fBairscan\-discover\-zeroconf\.log\fR and \fBairscan\-discover\-zeroconf\.tar\fR -. +.TP +\fB\-h\fR +Print help screen .SH "FILES" -. .TP \fBairscan\-discover\-zeroconf\.log\fR Protocol trace -. .TP \fBairscan\-discover\-zeroconf\.tar\fR Non\-textual messages, if any, saved here\. Textual (i\.e\., XML) messages included directly into the \.log file -. .SH "SEE ALSO" -sane(7), sane\-airscan(5) -. +\fBsane(7), sane\-airscan(5)\fR .SH "AUTHOR" Alexander Pevzner <pzz@apevzner\.com> diff --git a/upstream/fedora-rawhide/man1/ar.1 b/upstream/fedora-rawhide/man1/ar.1 index c6d8e294..e9f24abe 100644 --- a/upstream/fedora-rawhide/man1/ar.1 +++ b/upstream/fedora-rawhide/man1/ar.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "AR 1" -.TH AR 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH AR 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/arch.1 b/upstream/fedora-rawhide/man1/arch.1 index c416a09c..3d017562 100644 --- a/upstream/fedora-rawhide/man1/arch.1 +++ b/upstream/fedora-rawhide/man1/arch.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH ARCH "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH ARCH "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME arch \- print machine hardware name (same as uname -m) .SH SYNOPSIS @@ -22,7 +22,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/as.1 b/upstream/fedora-rawhide/man1/as.1 index 704aa535..4b184e3e 100644 --- a/upstream/fedora-rawhide/man1/as.1 +++ b/upstream/fedora-rawhide/man1/as.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "AS 1" -.TH AS 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH AS 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -337,6 +337,10 @@ as [\fB\-a\fR[\fBcdghilns\fR][=\fIfile\fR]] [\fB\-m31\fR|\fB\-m64\fR] [\fB\-mesa\fR|\fB\-mzarch\fR] [\fB\-march\fR=\fICPU\fR] [\fB\-mregnames\fR|\fB\-mno\-regnames\fR] [\fB\-mwarn\-areg\-zero\fR] + [\fB\-mwarn\-regtype\-mismatch=strict\fR + \fB\-mwarn\-regtype\-mismatch=relaxed\fR + \fB\-mwarn\-regtype\-mismatch=no\fR + \fB\-mno\-warn\-regtype\-mismatch\fR] .PP \&\fITarget SCORE options:\fR [\fB\-EB\fR][\fB\-EL\fR][\fB\-FIXDD\fR][\fB\-NWARN\fR] @@ -1538,10 +1542,29 @@ generated. .Sp Valid \fICPU\fR values are identical to the processor list of \&\fB\-march=\fR\fICPU\fR. +.IP \fB\-moperand\-check=\fR\fInone\fR 4 +.IX Item "-moperand-check=none" +.PD 0 +.IP \fB\-moperand\-check=\fR\fIwarning\fR 4 +.IX Item "-moperand-check=warning" +.IP \fB\-moperand\-check=\fR\fIerror\fR 4 +.IX Item "-moperand-check=error" +.PD +These options control if the assembler should check certain instruction +operands or operand combinations. An example instructions where operand size +cannot be inferred from its operands and also hasn't been specified by way of +an instruction suffix. +\&\fB\-moperand\-check=\fR\fInone\fR will make the assembler not perform +these checks. \fB\-moperand\-check=\fR\fIwarning\fR will make the assembler +issue a warning when respective checks fail, which is the default. +\&\fB\-moperand\-check=\fR\fIerror\fR will make the assembler issue an error +when respective checks fail. .IP \fB\-msse2avx\fR 4 .IX Item "-msse2avx" This option specifies that the assembler should encode SSE instructions -with VEX prefix. +with VEX prefix, requiring AVX to be available. SSE instructions using +extended GPRs will be encoded with EVEX prefix, requiring AVX512 or AVX10 to +be available. .IP \fB\-muse\-unaligned\-vector\-move\fR 4 .IX Item "-muse-unaligned-vector-move" This option specifies that the assembler should encode aligned vector @@ -2791,6 +2814,28 @@ Allow or disallow symbolic names for registers. .IX Item "-mwarn-areg-zero" Warn whenever the operand for a base or index register has been specified but evaluates to zero. +.IP \fB\-mwarn\-regtype\-mismatch=strict\fR 4 +.IX Item "-mwarn-regtype-mismatch=strict" +.PD 0 +.IP \fB\-mwarn\-regtype\-mismatch=relaxed\fR 4 +.IX Item "-mwarn-regtype-mismatch=relaxed" +.IP \fB\-mwarn\-regtype\-mismatch=no\fR 4 +.IX Item "-mwarn-regtype-mismatch=no" +.IP \fB\-mno\-warn\-regtype\-mismatch\fR 4 +.IX Item "-mno-warn-regtype-mismatch" +.PD +Controls whether the assembler performs register name type checks and generates +a warning message in case of a mismatch with the operand register type. +The default (which can be restored by using the \fBrelaxed\fR argument) is +to perform relaxed register name type checks, which allow floating point +register (FPR) names \f(CW%f0\fR to \f(CW%f15\fR to be specified as argument to vector register +(VR) operands and vector register (VR) names \f(CW%v0\fR to \f(CW%v15\fR to be specified as +argument to floating point register (FPR) operands. This is acceptable as the +FPR are embedded into the lower half of the VR. +Using the \fBstrict\fR argument strict register name type checks are +performed. +The \fBno\fR argument, which is equivalent to +\&\fB\-mno\-warn\-regtype\-mismatch\fR, disables any register name type checks. .PP The following options are available when as is configured for a TMS320C6000 processor. diff --git a/upstream/fedora-rawhide/man1/autopoint.1 b/upstream/fedora-rawhide/man1/autopoint.1 index 47a0700b..5daff008 100644 --- a/upstream/fedora-rawhide/man1/autopoint.1 +++ b/upstream/fedora-rawhide/man1/autopoint.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH AUTOPOINT "1" "November 2023" "GNU gettext-tools 0.22.4" "User Commands" +.TH AUTOPOINT "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME autopoint \- copies standard gettext infrastructure .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/b2sum.1 b/upstream/fedora-rawhide/man1/b2sum.1 index 3f0366c5..8ca44448 100644 --- a/upstream/fedora-rawhide/man1/b2sum.1 +++ b/upstream/fedora-rawhide/man1/b2sum.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH B2SUM "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH B2SUM "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME b2sum \- compute and check BLAKE2 message digest .SH SYNOPSIS @@ -62,7 +62,7 @@ The default mode is to print a line with: checksum, a space, a character indicating input mode ('*' for binary, ' ' for text or where binary is insignificant), and name for each FILE. .PP -Note: There is no difference between binary mode and text mode on GNU systems. +There is no difference between binary mode and text mode on GNU systems. .SH AUTHOR Written by Padraig Brady and Samuel Neves. .SH "REPORTING BUGS" @@ -70,7 +70,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/banner.1 b/upstream/fedora-rawhide/man1/banner.1 index 7235053a..53841f58 100644 --- a/upstream/fedora-rawhide/man1/banner.1 +++ b/upstream/fedora-rawhide/man1/banner.1 @@ -12,7 +12,7 @@ .\" # Purpose : Manpage for the banner program .\" # .\" # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # -.TH banner "1" "Oct 2020" "Banner" "Kenneth J. Pronovici" +.TH banner "1" "Mar 2024" "Banner" "Kenneth J. Pronovici" .SH NAME banner \- prints a short string to the console in very large letters .SH SYNOPSIS @@ -89,12 +89,10 @@ use an alternative program such as figlet. I am always happy to accept patches, and I promise to integrate patches promptly if provided. So far, no one who's complained has bothered to provide any patches, so the behavior remains the same. -.SH BUGS -Report bugs to <support@cedar\-solutions.com>. .SH AUTHOR Written by Kenneth J. Pronovici <pronovic@ieee.org>. .SH COPYRIGHT -Copyright (c) 2000\-2004.2007,2013,2014 Kenneth J. Pronovici. +Copyright (c) 2000\-2004,2007,2013,2014,2020,2024 Kenneth J. Pronovici .br This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR diff --git a/upstream/fedora-rawhide/man1/base32.1 b/upstream/fedora-rawhide/man1/base32.1 index 3635b4c3..5223335a 100644 --- a/upstream/fedora-rawhide/man1/base32.1 +++ b/upstream/fedora-rawhide/man1/base32.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH BASE32 "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH BASE32 "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME base32 \- base32 encode/decode data and print to standard output .SH SYNOPSIS @@ -41,7 +41,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/base64.1 b/upstream/fedora-rawhide/man1/base64.1 index c3f68531..75682220 100644 --- a/upstream/fedora-rawhide/man1/base64.1 +++ b/upstream/fedora-rawhide/man1/base64.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH BASE64 "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH BASE64 "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME base64 \- base64 encode/decode data and print to standard output .SH SYNOPSIS @@ -41,7 +41,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/basename.1 b/upstream/fedora-rawhide/man1/basename.1 index 81f3f61f..77f0c454 100644 --- a/upstream/fedora-rawhide/man1/basename.1 +++ b/upstream/fedora-rawhide/man1/basename.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH BASENAME "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH BASENAME "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME basename \- strip directory and suffix from filenames .SH SYNOPSIS @@ -50,7 +50,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/basenc.1 b/upstream/fedora-rawhide/man1/basenc.1 index 1634d39e..c0bb8a78 100644 --- a/upstream/fedora-rawhide/man1/basenc.1 +++ b/upstream/fedora-rawhide/man1/basenc.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH BASENC "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH BASENC "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME basenc \- Encode/decode data and print to standard output .SH SYNOPSIS @@ -95,7 +95,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/bootctl.1 b/upstream/fedora-rawhide/man1/bootctl.1 index 945a1a98..5e91cd6e 100644 --- a/upstream/fedora-rawhide/man1/bootctl.1 +++ b/upstream/fedora-rawhide/man1/bootctl.1 @@ -1,5 +1,5 @@ '\" t -.TH "BOOTCTL" "1" "" "systemd 255" "bootctl" +.TH "BOOTCTL" "1" "" "systemd 256~rc3" "bootctl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -322,7 +322,7 @@ Boot Loader Specification Type #1 entries should generally be placed in the dire "$(bootctl \-x)/EFI/Linux/"\&. .sp Note that this option (similarly to the -\fB\-\-print\-boot\-path\fR +\fB\-\-print\-esp\-path\fR option mentioned above), is available independently from the boot loader used, i\&.e\&. also without \fBsystemd\-boot\fR being installed\&. @@ -488,7 +488,7 @@ Added in version 253\&. 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" @@ -655,10 +655,7 @@ specifies the entry that will be used by default, and specifies the entry that was selected the last time (i\&.e\&. is currently running)\&. .SH "SEE ALSO" .PP -\fBsystemd-boot\fR(7), -\m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[1]\d\s+2, -\m[blue]\fBBoot Loader Interface\fR\m[]\&\s-2\u[2]\d\s+2, -\fBsystemd-boot-random-seed.service\fR(8) +\fBsystemd-boot\fR(7), \m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[1]\d\s+2, \m[blue]\fBBoot Loader Interface\fR\m[]\&\s-2\u[2]\d\s+2, \fBsystemd-boot-random-seed.service\fR(8) .SH "NOTES" .IP " 1." 4 Boot Loader Specification diff --git a/upstream/fedora-rawhide/man1/busctl.1 b/upstream/fedora-rawhide/man1/busctl.1 index ed53281e..533eb8d2 100644 --- a/upstream/fedora-rawhide/man1/busctl.1 +++ b/upstream/fedora-rawhide/man1/busctl.1 @@ -1,5 +1,5 @@ '\" t -.TH "BUSCTL" "1" "" "systemd 255" "busctl" +.TH "BUSCTL" "1" "" "systemd 256~rc3" "busctl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -236,7 +236,7 @@ call instead of the normal output\&. Added in version 243\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 When used with the \fBcall\fR @@ -261,7 +261,7 @@ when invoked interactively from a terminal\&. Otherwise equivalent to Added in version 240\&. .RE .PP -\fB\-\-expect\-reply=\fR\fIBOOL\fR +\fB\-\-expect\-reply=\fR\fB\fIBOOL\fR\fR .RS 4 When used with the \fBcall\fR @@ -276,7 +276,7 @@ above\&. Defaults to Added in version 218\&. .RE .PP -\fB\-\-auto\-start=\fR\fIBOOL\fR +\fB\-\-auto\-start=\fR\fB\fIBOOL\fR\fR .RS 4 When used with the \fBcall\fR @@ -288,7 +288,7 @@ command, specifies whether the method call should implicitly activate the called Added in version 218\&. .RE .PP -\fB\-\-allow\-interactive\-authorization=\fR\fIBOOL\fR +\fB\-\-allow\-interactive\-authorization=\fR\fB\fIBOOL\fR\fR .RS 4 When used with the \fBcall\fR @@ -298,7 +298,7 @@ command, specifies whether the services may enforce interactive authorization wh Added in version 218\&. .RE .PP -\fB\-\-timeout=\fR\fISECS\fR +\fB\-\-timeout=\fR\fB\fISECS\fR\fR .RS 4 When used with the \fBcall\fR @@ -311,7 +311,7 @@ is assumed\&. Added in version 218\&. .RE .PP -\fB\-\-augment\-creds=\fR\fIBOOL\fR +\fB\-\-augment\-creds=\fR\fB\fIBOOL\fR\fR .RS 4 Controls whether credential data reported by \fBlist\fR @@ -326,7 +326,7 @@ might be more recent than the rest of the credential information\&. Defaults to Added in version 218\&. .RE .PP -\fB\-\-watch\-bind=\fR\fIBOOL\fR +\fB\-\-watch\-bind=\fR\fB\fIBOOL\fR\fR .RS 4 Controls whether to wait for the specified \fBAF_UNIX\fR @@ -335,7 +335,7 @@ bus socket to appear in the file system before connecting to it\&. Defaults to o Added in version 237\&. .RE .PP -\fB\-\-destination=\fR\fISERVICE\fR +\fB\-\-destination=\fR\fB\fISERVICE\fR\fR .RS 4 Takes a service name\&. When used with the \fBemit\fR @@ -379,6 +379,13 @@ syntax is used either the left hand side or the right hand side may be omitted ( are implied\&. .RE .PP +\fB\-C\fR, \fB\-\-capsule=\fR +.RS 4 +Execute operation on a capsule\&. Specify a capsule name to connect to\&. See +\fBcapsule@.service\fR(5) +for details about capsules\&. +.RE +.PP \fB\-l\fR, \fB\-\-full\fR .RS 4 Do not ellipsize the output in @@ -558,13 +565,7 @@ o "/org/freedesktop/systemd1/job/42684" .\} .SH "SEE ALSO" .PP -\fBdbus-daemon\fR(1), -\m[blue]\fBD\-Bus\fR\m[]\&\s-2\u[3]\d\s+2, -\fBsd-bus\fR(3), -\fBvarlinkctl\fR(1), -\fBsystemd\fR(1), -\fBmachinectl\fR(1), -\fBwireshark\fR(1) +\fBdbus-daemon\fR(1), \m[blue]\fBD\-Bus\fR\m[]\&\s-2\u[3]\d\s+2, \fBsd-bus\fR(3), \fBvarlinkctl\fR(1), \fBsystemd\fR(1), \fBmachinectl\fR(1), \fBwireshark\fR(1) .SH "NOTES" .IP " 1." 4 PCAP Next Generation (pcapng) Capture File Format diff --git a/upstream/fedora-rawhide/man1/c++filt.1 b/upstream/fedora-rawhide/man1/c++filt.1 index c44be9d5..6bf4f67c 100644 --- a/upstream/fedora-rawhide/man1/c++filt.1 +++ b/upstream/fedora-rawhide/man1/c++filt.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "C++FILT 1" -.TH C++FILT 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH C++FILT 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/cat.1 b/upstream/fedora-rawhide/man1/cat.1 index d5d83585..9eda1043 100644 --- a/upstream/fedora-rawhide/man1/cat.1 +++ b/upstream/fedora-rawhide/man1/cat.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH CAT "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH CAT "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME cat \- concatenate files and print on the standard output .SH SYNOPSIS @@ -61,7 +61,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/chcon.1 b/upstream/fedora-rawhide/man1/chcon.1 index af89d954..9b37fb8c 100644 --- a/upstream/fedora-rawhide/man1/chcon.1 +++ b/upstream/fedora-rawhide/man1/chcon.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH CHCON "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH CHCON "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME chcon \- change file security context .SH SYNOPSIS @@ -81,7 +81,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/chgrp.1 b/upstream/fedora-rawhide/man1/chgrp.1 index 8ab8f0d7..884adc73 100644 --- a/upstream/fedora-rawhide/man1/chgrp.1 +++ b/upstream/fedora-rawhide/man1/chgrp.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH CHGRP "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH CHGRP "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME chgrp \- change group ownership .SH SYNOPSIS @@ -32,6 +32,12 @@ affect symbolic links instead of any referenced file (useful only on systems that can change the ownership of a symlink) .TP +\fB\-\-from\fR=\fI\,CURRENT_OWNER\/\fR:CURRENT_GROUP +change the ownership of each file only if +its current owner and/or group match those specified +here. Either may be omitted, in which case a match +is not required for the omitted attribute +.TP \fB\-\-no\-preserve\-root\fR do not treat '/' specially (the default) .TP @@ -39,7 +45,7 @@ do not treat '/' specially (the default) fail to operate recursively on '/' .TP \fB\-\-reference\fR=\fI\,RFILE\/\fR -use RFILE's group rather than specifying a GROUP. +use RFILE's ownership rather than specifying values RFILE is always dereferenced if a symbolic link. .TP \fB\-R\fR, \fB\-\-recursive\fR @@ -47,7 +53,7 @@ operate on files and directories recursively .PP The following options modify how a hierarchy is traversed when the \fB\-R\fR option is also specified. If more than one is specified, only the final -one takes effect. +one takes effect. '\-P' is the default. .TP \fB\-H\fR if a command line argument is a symbolic link @@ -58,7 +64,7 @@ traverse every symbolic link to a directory encountered .TP \fB\-P\fR -do not traverse any symbolic links (default) +do not traverse any symbolic links .TP \fB\-\-help\fR display this help and exit @@ -79,7 +85,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/chmod.1 b/upstream/fedora-rawhide/man1/chmod.1 index c0869f14..14aa4375 100644 --- a/upstream/fedora-rawhide/man1/chmod.1 +++ b/upstream/fedora-rawhide/man1/chmod.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH CHMOD "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH CHMOD "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME chmod \- change file mode bits .SH SYNOPSIS @@ -66,17 +66,19 @@ file's group, with the same values; and the fourth for other users not in the file's group, with the same values. .PP .B chmod -never changes the permissions of symbolic links; the +doesn't change the permissions of symbolic links; the .B chmod -system call cannot change their permissions. This is not a problem -since the permissions of symbolic links are never used. +system call cannot change their permissions on most systems, +and most systems ignore permissions of symbolic links. However, for each symbolic link listed on the command line, .B chmod changes the permissions of the pointed-to file. In contrast, .B chmod ignores symbolic links encountered during recursive directory -traversals. +traversals. Options that modify this behavior are described in the +.B OPTIONS +section. .SH "SETUID AND SETGID BITS" .B chmod clears the set-group-ID bit of a @@ -133,6 +135,13 @@ suppress most error messages \fB\-v\fR, \fB\-\-verbose\fR output a diagnostic for every file processed .TP +\fB\-\-dereference\fR +affect the referent of each symbolic link, +rather than the symbolic link itself +.TP +\fB\-h\fR, \fB\-\-no\-dereference\fR +affect each symbolic link, rather than the referent +.TP \fB\-\-no\-preserve\-root\fR do not treat '/' specially (the default) .TP @@ -145,6 +154,21 @@ RFILE is always dereferenced if a symbolic link. .TP \fB\-R\fR, \fB\-\-recursive\fR change files and directories recursively +.PP +The following options modify how a hierarchy is traversed when the \fB\-R\fR +option is also specified. If more than one is specified, only the final +one takes effect. '\-H' is the default. +.TP +\fB\-H\fR +if a command line argument is a symbolic link +to a directory, traverse it +.TP +\fB\-L\fR +traverse every symbolic link to a directory +encountered +.TP +\fB\-P\fR +do not traverse any symbolic links .TP \fB\-\-help\fR display this help and exit @@ -160,7 +184,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/chown.1 b/upstream/fedora-rawhide/man1/chown.1 index aa12977a..ae14bb3e 100644 --- a/upstream/fedora-rawhide/man1/chown.1 +++ b/upstream/fedora-rawhide/man1/chown.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH CHOWN "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH CHOWN "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME chown \- change file owner and group .SH SYNOPSIS @@ -52,9 +52,9 @@ affect symbolic links instead of any referenced file ownership of a symlink) .TP \fB\-\-from\fR=\fI\,CURRENT_OWNER\/\fR:CURRENT_GROUP -change the owner and/or group of each file only if +change the ownership of each file only if its current owner and/or group match those specified -here. Either may be omitted, in which case a match +here. Either may be omitted, in which case a match is not required for the omitted attribute .TP \fB\-\-no\-preserve\-root\fR @@ -64,15 +64,15 @@ do not treat '/' specially (the default) fail to operate recursively on '/' .TP \fB\-\-reference\fR=\fI\,RFILE\/\fR -use RFILE's owner and group rather than specifying -OWNER:GROUP values. RFILE is always dereferenced. +use RFILE's ownership rather than specifying values +RFILE is always dereferenced if a symbolic link. .TP \fB\-R\fR, \fB\-\-recursive\fR operate on files and directories recursively .PP The following options modify how a hierarchy is traversed when the \fB\-R\fR option is also specified. If more than one is specified, only the final -one takes effect. +one takes effect. '\-P' is the default. .TP \fB\-H\fR if a command line argument is a symbolic link @@ -83,7 +83,7 @@ traverse every symbolic link to a directory encountered .TP \fB\-P\fR -do not traverse any symbolic links (default) +do not traverse any symbolic links .TP \fB\-\-help\fR display this help and exit @@ -111,7 +111,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/chroot.1 b/upstream/fedora-rawhide/man1/chroot.1 index d8484db4..2f871150 100644 --- a/upstream/fedora-rawhide/man1/chroot.1 +++ b/upstream/fedora-rawhide/man1/chroot.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH CHROOT "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH CHROOT "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME chroot \- run command or interactive shell with special root directory .SH SYNOPSIS @@ -49,7 +49,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/cksum.1 b/upstream/fedora-rawhide/man1/cksum.1 index 2cd81cc2..bb4e9b2e 100644 --- a/upstream/fedora-rawhide/man1/cksum.1 +++ b/upstream/fedora-rawhide/man1/cksum.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH CKSUM "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH CKSUM "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME cksum \- compute and verify file checksums .SH SYNOPSIS @@ -109,7 +109,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/comm.1 b/upstream/fedora-rawhide/man1/comm.1 index 92d485ad..a49d7a4c 100644 --- a/upstream/fedora-rawhide/man1/comm.1 +++ b/upstream/fedora-rawhide/man1/comm.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH COMM "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH COMM "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME comm \- compare two sorted files line by line .SH SYNOPSIS @@ -47,7 +47,7 @@ display this help and exit \fB\-\-version\fR output version information and exit .PP -Note, comparisons honor the rules specified by 'LC_COLLATE'. +Comparisons honor the rules specified by 'LC_COLLATE'. .SH EXAMPLES .TP comm \-12 file1 file2 @@ -62,7 +62,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/coredumpctl.1 b/upstream/fedora-rawhide/man1/coredumpctl.1 index fc6d03da..2bce6177 100644 --- a/upstream/fedora-rawhide/man1/coredumpctl.1 +++ b/upstream/fedora-rawhide/man1/coredumpctl.1 @@ -1,5 +1,5 @@ '\" t -.TH "COREDUMPCTL" "1" "" "systemd 255" "coredumpctl" +.TH "COREDUMPCTL" "1" "" "systemd 256~rc3" "coredumpctl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -156,7 +156,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" @@ -203,14 +203,14 @@ Reverse output so that the newest entries are displayed first\&. Added in version 233\&. .RE .PP -\fB\-F\fR \fIFIELD\fR, \fB\-\-field=\fR\fIFIELD\fR +\fB\-F\fR \fIFIELD\fR, \fB\-\-field=\fR\fB\fIFIELD\fR\fR .RS 4 Print all possible data values the specified field takes in matching core dump entries of the journal\&. .sp Added in version 215\&. .RE .PP -\fB\-o\fR \fIFILE\fR, \fB\-\-output=\fR\fIFILE\fR +\fB\-o\fR \fIFILE\fR, \fB\-\-output=\fR\fB\fIFILE\fR\fR .RS 4 Write the core to \fBFILE\fR\&. @@ -218,7 +218,7 @@ Write the core to Added in version 215\&. .RE .PP -\fB\-\-debugger=\fR\fIDEBUGGER\fR +\fB\-\-debugger=\fR\fB\fIDEBUGGER\fR\fR .RS 4 Use the given debugger for the \fBdebug\fR @@ -231,7 +231,7 @@ will be used\&. Added in version 239\&. .RE .PP -\fB\-A\fR \fIARGS\fR, \fB\-\-debugger\-arguments=\fR\fIARGS\fR +\fB\-A\fR \fIARGS\fR, \fB\-\-debugger\-arguments=\fR\fB\fIARGS\fR\fR .RS 4 Pass the given \fIARGS\fR @@ -251,7 +251,7 @@ instead of the default runtime and system journal paths\&. May be specified mult Added in version 246\&. .RE .PP -\fB\-D\fR \fIDIR\fR, \fB\-\-directory=\fR\fIDIR\fR +\fB\-D\fR \fIDIR\fR, \fB\-\-directory=\fR\fB\fIDIR\fR\fR .RS 4 Use the journal files in the specified \fBDIR\fR\&. @@ -455,10 +455,7 @@ $ coredumpctl \-o bar\&.coredump dump /usr/bin/bar .\} .SH "SEE ALSO" .PP -\fBsystemd-coredump\fR(8), -\fBcoredump.conf\fR(5), -\fBsystemd-journald.service\fR(8), -\fBgdb\fR(1) +\fBsystemd-coredump\fR(8), \fBcoredump.conf\fR(5), \fBsystemd-journald.service\fR(8), \fBgdb\fR(1) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man1/cp.1 b/upstream/fedora-rawhide/man1/cp.1 index 0d15e57d..420b59c2 100644 --- a/upstream/fedora-rawhide/man1/cp.1 +++ b/upstream/fedora-rawhide/man1/cp.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH CP "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH CP "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME cp \- copy files and directories .SH SYNOPSIS @@ -58,8 +58,8 @@ hard link files instead of copying always follow symbolic links in SOURCE .TP \fB\-n\fR, \fB\-\-no\-clobber\fR -do not overwrite an existing file (overrides a -\fB\-u\fR or previous \fB\-i\fR option). See also \fB\-\-update\fR +(deprecated) silently skip existing files. +See also \fB\-\-update\fR .TP \fB\-P\fR, \fB\-\-no\-dereference\fR never follow symbolic links in SOURCE @@ -107,14 +107,17 @@ treat DEST as a normal file .TP \fB\-\-update\fR[=\fI\,UPDATE\/\fR] control which existing files are updated; -UPDATE={all,none,older(default)}. See below +UPDATE={all,none,none\-fail,older(default)}. .TP \fB\-u\fR -equivalent to \fB\-\-update\fR[=\fI\,older\/\fR] +equivalent to \fB\-\-update\fR[=\fI\,older\/\fR]. See below .TP \fB\-v\fR, \fB\-\-verbose\fR explain what is being done .TP +\fB\-\-keep\-directory\-symlink\fR +follow existing symlinks to directories +.TP \fB\-x\fR, \fB\-\-one\-file\-system\fR stay on this file system .TP @@ -147,8 +150,10 @@ Use \fB\-\-sparse\fR=\fI\,never\/\fR to inhibit creation of sparse files. UPDATE controls which existing files in the destination are replaced. \&'all' is the default operation when an \fB\-\-update\fR option is not specified, and results in all existing files in the destination being replaced. -\&'none' is similar to the \fB\-\-no\-clobber\fR option, in that no files in the -destination are replaced, but also skipped files do not induce a failure. +\&'none' is like the \fB\-\-no\-clobber\fR option, in that no files in the +destination are replaced, and skipped files do not induce a failure. +\&'none\-fail' also ensures no files are replaced in the destination, +but any skipped files are diagnosed and induce a failure. \&'older' is the default operation when \fB\-\-update\fR is specified, and results in files being replaced if they're older than the corresponding source file. .PP @@ -183,7 +188,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/csplit.1 b/upstream/fedora-rawhide/man1/csplit.1 index 6f00320f..629cf94c 100644 --- a/upstream/fedora-rawhide/man1/csplit.1 +++ b/upstream/fedora-rawhide/man1/csplit.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH CSPLIT "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH CSPLIT "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME csplit \- split a file into sections determined by context lines .SH SYNOPSIS @@ -66,7 +66,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/cut.1 b/upstream/fedora-rawhide/man1/cut.1 index d82378ea..6b1a5867 100644 --- a/upstream/fedora-rawhide/man1/cut.1 +++ b/upstream/fedora-rawhide/man1/cut.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH CUT "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH CUT "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME cut \- remove sections from each line of files .SH SYNOPSIS @@ -74,7 +74,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/date.1 b/upstream/fedora-rawhide/man1/date.1 index 8081bac0..1c6c553a 100644 --- a/upstream/fedora-rawhide/man1/date.1 +++ b/upstream/fedora-rawhide/man1/date.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH DATE "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH DATE "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME date \- print or set the system date and time .SH SYNOPSIS @@ -258,7 +258,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/dd.1 b/upstream/fedora-rawhide/man1/dd.1 index 295b2eaf..648f3b8d 100644 --- a/upstream/fedora-rawhide/man1/dd.1 +++ b/upstream/fedora-rawhide/man1/dd.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH DD "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH DD "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME dd \- convert and copy a file .SH SYNOPSIS @@ -165,7 +165,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/debuginfo-install.1 b/upstream/fedora-rawhide/man1/debuginfo-install.1 index 5acd789d..3b08c659 100644 --- a/upstream/fedora-rawhide/man1/debuginfo-install.1 +++ b/upstream/fedora-rawhide/man1/debuginfo-install.1 @@ -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 "DEBUGINFO-INSTALL" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DEBUGINFO-INSTALL" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME debuginfo-install \- redirecting to DNF debuginfo-install Plugin .sp diff --git a/upstream/fedora-rawhide/man1/df.1 b/upstream/fedora-rawhide/man1/df.1 index 693e3073..3cd513f6 100644 --- a/upstream/fedora-rawhide/man1/df.1 +++ b/upstream/fedora-rawhide/man1/df.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH DF "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH DF "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME df \- report file system space usage .SH SYNOPSIS @@ -112,7 +112,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/dir.1 b/upstream/fedora-rawhide/man1/dir.1 index 7bea68ae..8188ed0a 100644 --- a/upstream/fedora-rawhide/man1/dir.1 +++ b/upstream/fedora-rawhide/man1/dir.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH DIR "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH DIR "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME dir \- list directory contents .SH SYNOPSIS @@ -51,7 +51,7 @@ list directories themselves, not their contents generate output designed for Emacs' dired mode .TP \fB\-f\fR -list all entries in directory order +do not sort, enable \fB\-aU\fR, disable \fB\-ls\fR \fB\-\-color\fR .TP \fB\-F\fR, \fB\-\-classify\fR[=\fI\,WHEN\/\fR] append indicator (one of */=>@|) to entries WHEN @@ -254,7 +254,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/dircolors.1 b/upstream/fedora-rawhide/man1/dircolors.1 index 214c6490..c95dcec4 100644 --- a/upstream/fedora-rawhide/man1/dircolors.1 +++ b/upstream/fedora-rawhide/man1/dircolors.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH DIRCOLORS "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH DIRCOLORS "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME dircolors \- color setup for ls .SH SYNOPSIS @@ -39,7 +39,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/dirname.1 b/upstream/fedora-rawhide/man1/dirname.1 index 458da15f..ae9322ae 100644 --- a/upstream/fedora-rawhide/man1/dirname.1 +++ b/upstream/fedora-rawhide/man1/dirname.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH DIRNAME "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH DIRNAME "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME dirname \- strip last component from file name .SH SYNOPSIS @@ -36,7 +36,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/dnf-utils.1 b/upstream/fedora-rawhide/man1/dnf-utils.1 index aa2c1467..1c23007c 100644 --- a/upstream/fedora-rawhide/man1/dnf-utils.1 +++ b/upstream/fedora-rawhide/man1/dnf-utils.1 @@ -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 "DNF-UTILS" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF-UTILS" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME dnf-utils \- classic YUM utilities implemented as CLI shims on top of DNF .sp diff --git a/upstream/fedora-rawhide/man1/du.1 b/upstream/fedora-rawhide/man1/du.1 index 34ff3647..31a70a80 100644 --- a/upstream/fedora-rawhide/man1/du.1 +++ b/upstream/fedora-rawhide/man1/du.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH DU "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH DU "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME du \- estimate file space usage .SH SYNOPSIS @@ -152,7 +152,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/echo.1 b/upstream/fedora-rawhide/man1/echo.1 index d4a06725..69e0f658 100644 --- a/upstream/fedora-rawhide/man1/echo.1 +++ b/upstream/fedora-rawhide/man1/echo.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH ECHO "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH ECHO "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME echo \- display a line of text .SH SYNOPSIS @@ -66,12 +66,12 @@ byte with octal value NNN (1 to 3 digits) \exHH byte with hexadecimal value HH (1 to 2 digits) .PP -NOTE: your shell may have its own version of echo, which usually supersedes +Your shell may have its own version of echo, which usually supersedes the version described here. Please refer to your shell's documentation for details about the options it supports. .PP -NOTE: \fBprintf\fP(1) is a preferred alternative, -which does not have issues outputting option\-like strings. +Consider using the 'printf' command instead, +as it avoids problems when outputting option\-like strings. .SH AUTHOR Written by Brian Fox and Chet Ramey. .SH "REPORTING BUGS" @@ -79,7 +79,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/ed.1 b/upstream/fedora-rawhide/man1/ed.1 index dcff01ce..ad371a8d 100644 --- a/upstream/fedora-rawhide/man1/ed.1 +++ b/upstream/fedora-rawhide/man1/ed.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.2. -.TH ED "1" "February 2024" "GNU ed 1.20.1" "User Commands" +.TH ED "1" "April 2024" "GNU ed 1.20.2" "User Commands" .SH NAME ed \- line-oriented text editor .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/elfedit.1 b/upstream/fedora-rawhide/man1/elfedit.1 index ff1a75cb..8914d0a9 100644 --- a/upstream/fedora-rawhide/man1/elfedit.1 +++ b/upstream/fedora-rawhide/man1/elfedit.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ELFEDIT 1" -.TH ELFEDIT 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH ELFEDIT 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/env.1 b/upstream/fedora-rawhide/man1/env.1 index eb6f3194..5ccae3a5 100644 --- a/upstream/fedora-rawhide/man1/env.1 +++ b/upstream/fedora-rawhide/man1/env.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH ENV "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH ENV "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME env \- run a program in a modified environment .SH SYNOPSIS @@ -12,6 +12,9 @@ Set each NAME to VALUE in the environment and run COMMAND. .PP Mandatory arguments to long options are mandatory for short options too. .TP +\fB\-a\fR, \fB\-\-argv0\fR=\fI\,ARG\/\fR +pass ARG as the zeroth argument of COMMAND +.TP \fB\-i\fR, \fB\-\-ignore\-environment\fR start with an empty environment .TP @@ -128,7 +131,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/expand.1 b/upstream/fedora-rawhide/man1/expand.1 index 09ab207c..4b0b14cc 100644 --- a/upstream/fedora-rawhide/man1/expand.1 +++ b/upstream/fedora-rawhide/man1/expand.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH EXPAND "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH EXPAND "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME expand \- convert tabs to spaces .SH SYNOPSIS @@ -40,7 +40,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/expr.1 b/upstream/fedora-rawhide/man1/expr.1 index 81acdfc1..41846b84 100644 --- a/upstream/fedora-rawhide/man1/expr.1 +++ b/upstream/fedora-rawhide/man1/expr.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH EXPR "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH EXPR "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME expr \- evaluate expressions .SH SYNOPSIS @@ -96,7 +96,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/factor.1 b/upstream/fedora-rawhide/man1/factor.1 index 8269dd99..4f45dcd8 100644 --- a/upstream/fedora-rawhide/man1/factor.1 +++ b/upstream/fedora-rawhide/man1/factor.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH FACTOR "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH FACTOR "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME factor \- factor numbers .SH SYNOPSIS @@ -26,7 +26,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/false.1 b/upstream/fedora-rawhide/man1/false.1 index 86e83d05..9063ddb7 100644 --- a/upstream/fedora-rawhide/man1/false.1 +++ b/upstream/fedora-rawhide/man1/false.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH FALSE "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH FALSE "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME false \- do nothing, unsuccessfully .SH SYNOPSIS @@ -19,7 +19,7 @@ display this help and exit \fB\-\-version\fR output version information and exit .PP -NOTE: your shell may have its own version of false, which usually supersedes +Your shell may have its own version of false, which usually supersedes the version described here. Please refer to your shell's documentation for details about the options it supports. .SH AUTHOR @@ -29,7 +29,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/fmt.1 b/upstream/fedora-rawhide/man1/fmt.1 index b17df353..d82a7e41 100644 --- a/upstream/fedora-rawhide/man1/fmt.1 +++ b/upstream/fedora-rawhide/man1/fmt.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH FMT "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH FMT "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME fmt \- simple optimal text formatter .SH SYNOPSIS @@ -49,7 +49,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/fold.1 b/upstream/fedora-rawhide/man1/fold.1 index 43b52612..9a3ad185 100644 --- a/upstream/fedora-rawhide/man1/fold.1 +++ b/upstream/fedora-rawhide/man1/fold.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH FOLD "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH FOLD "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME fold \- wrap each input line to fit in specified width .SH SYNOPSIS @@ -38,7 +38,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/gcore.1 b/upstream/fedora-rawhide/man1/gcore.1 index 7310f3ac..b5909db5 100644 --- a/upstream/fedora-rawhide/man1/gcore.1 +++ b/upstream/fedora-rawhide/man1/gcore.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "GCORE 1" -.TH GCORE 1 2024-01-29 gdb-14.1-8.fc40 "GNU Development Tools" +.TH GCORE 1 2024-04-30 gdb-14.2-7.fc41 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/getent.1 b/upstream/fedora-rawhide/man1/getent.1 index 6639bfd8..d1cd5a92 100644 --- a/upstream/fedora-rawhide/man1/getent.1 +++ b/upstream/fedora-rawhide/man1/getent.1 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH getent 1 2023-11-01 "Linux man-pages 6.06" +.TH getent 1 2023-11-01 "Linux man-pages 6.7" .SH NAME getent \- get entries from Name Service Switch libraries .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/gettext.1 b/upstream/fedora-rawhide/man1/gettext.1 index 3a993b68..bce8e550 100644 --- a/upstream/fedora-rawhide/man1/gettext.1 +++ b/upstream/fedora-rawhide/man1/gettext.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH GETTEXT "1" "September 2023" "GNU gettext-runtime 0.22.2" "User Commands" +.TH GETTEXT "1" "February 2024" "GNU gettext-runtime 0.22.5" "User Commands" .SH NAME gettext \- translate message .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/gettextize.1 b/upstream/fedora-rawhide/man1/gettextize.1 index 51ccfa18..d81f4cf8 100644 --- a/upstream/fedora-rawhide/man1/gettextize.1 +++ b/upstream/fedora-rawhide/man1/gettextize.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH GETTEXTIZE "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH GETTEXTIZE "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME gettextize \- install or upgrade gettext infrastructure .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/gprof.1 b/upstream/fedora-rawhide/man1/gprof.1 index e4ca1289..741d1aa7 100644 --- a/upstream/fedora-rawhide/man1/gprof.1 +++ b/upstream/fedora-rawhide/man1/gprof.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "GPROF 1" -.TH GPROF 1 2024-02-22 binutils-2.42.50 GNU +.TH GPROF 1 2024-05-13 binutils-2.42.50 GNU .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/groups.1 b/upstream/fedora-rawhide/man1/groups.1 index 661e4ebc..7dc4914a 100644 --- a/upstream/fedora-rawhide/man1/groups.1 +++ b/upstream/fedora-rawhide/man1/groups.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH GROUPS "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH GROUPS "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME groups \- print the groups a user is in .SH SYNOPSIS @@ -23,7 +23,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/grub2-editenv.1 b/upstream/fedora-rawhide/man1/grub2-editenv.1 index 159975a7..655b3c24 100644 --- a/upstream/fedora-rawhide/man1/grub2-editenv.1 +++ b/upstream/fedora-rawhide/man1/grub2-editenv.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-EDITENV "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-EDITENV "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-editenv \- edit GRUB environment block .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-emu.1 b/upstream/fedora-rawhide/man1/grub2-emu.1 index 58e1ad8d..401921fb 100644 --- a/upstream/fedora-rawhide/man1/grub2-emu.1 +++ b/upstream/fedora-rawhide/man1/grub2-emu.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-EMU "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-EMU "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-emu \- GRUB emulator .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-file.1 b/upstream/fedora-rawhide/man1/grub2-file.1 index 3aeb9805..0c5939bd 100644 --- a/upstream/fedora-rawhide/man1/grub2-file.1 +++ b/upstream/fedora-rawhide/man1/grub2-file.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-FILE "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-FILE "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-file \- check file type .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-fstest.1 b/upstream/fedora-rawhide/man1/grub2-fstest.1 index 1c4d2833..f81ccf8a 100644 --- a/upstream/fedora-rawhide/man1/grub2-fstest.1 +++ b/upstream/fedora-rawhide/man1/grub2-fstest.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-FSTEST "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-FSTEST "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-fstest \- debug tool for GRUB filesystem drivers .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-kbdcomp.1 b/upstream/fedora-rawhide/man1/grub2-kbdcomp.1 index 730e20d3..44175812 100644 --- a/upstream/fedora-rawhide/man1/grub2-kbdcomp.1 +++ b/upstream/fedora-rawhide/man1/grub2-kbdcomp.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-KBDCOMP "1" "February 2024" "grub-kbdcomp ()" "User Commands" +.TH GRUB-KBDCOMP "1" "May 2024" "grub-kbdcomp ()" "User Commands" .SH NAME grub-kbdcomp \- generate a GRUB keyboard layout file .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-menulst2cfg.1 b/upstream/fedora-rawhide/man1/grub2-menulst2cfg.1 index 3acf6992..435dbd61 100644 --- a/upstream/fedora-rawhide/man1/grub2-menulst2cfg.1 +++ b/upstream/fedora-rawhide/man1/grub2-menulst2cfg.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MENULST2CFG "1" "February 2024" "Usage: grub-menulst2cfg [INFILE [OUTFILE]]" "User Commands" +.TH GRUB-MENULST2CFG "1" "May 2024" "Usage: grub-menulst2cfg [INFILE [OUTFILE]]" "User Commands" .SH NAME grub-menulst2cfg \- transform legacy menu.lst into grub.cfg .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-mkfont.1 b/upstream/fedora-rawhide/man1/grub2-mkfont.1 index ae257ef0..895f17c5 100644 --- a/upstream/fedora-rawhide/man1/grub2-mkfont.1 +++ b/upstream/fedora-rawhide/man1/grub2-mkfont.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MKFONT "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-MKFONT "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-mkfont \- make GRUB font files .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-mkimage.1 b/upstream/fedora-rawhide/man1/grub2-mkimage.1 index ecd21425..9d484edd 100644 --- a/upstream/fedora-rawhide/man1/grub2-mkimage.1 +++ b/upstream/fedora-rawhide/man1/grub2-mkimage.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MKIMAGE "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-MKIMAGE "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-mkimage \- make a bootable image of GRUB .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-mklayout.1 b/upstream/fedora-rawhide/man1/grub2-mklayout.1 index 33f2061c..30558088 100644 --- a/upstream/fedora-rawhide/man1/grub2-mklayout.1 +++ b/upstream/fedora-rawhide/man1/grub2-mklayout.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MKLAYOUT "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-MKLAYOUT "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-mklayout \- generate a GRUB keyboard layout file .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-mknetdir.1 b/upstream/fedora-rawhide/man1/grub2-mknetdir.1 index 58a2e334..861556f5 100644 --- a/upstream/fedora-rawhide/man1/grub2-mknetdir.1 +++ b/upstream/fedora-rawhide/man1/grub2-mknetdir.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MKNETDIR "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-MKNETDIR "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-mknetdir \- prepare a GRUB netboot directory. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-mkpasswd-pbkdf2.1 b/upstream/fedora-rawhide/man1/grub2-mkpasswd-pbkdf2.1 index d0fc16f2..76db90b7 100644 --- a/upstream/fedora-rawhide/man1/grub2-mkpasswd-pbkdf2.1 +++ b/upstream/fedora-rawhide/man1/grub2-mkpasswd-pbkdf2.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MKPASSWD-PBKDF2 "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-MKPASSWD-PBKDF2 "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-mkpasswd-pbkdf2 \- generate hashed password for GRUB .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-mkrelpath.1 b/upstream/fedora-rawhide/man1/grub2-mkrelpath.1 index ce199813..8d1874f0 100644 --- a/upstream/fedora-rawhide/man1/grub2-mkrelpath.1 +++ b/upstream/fedora-rawhide/man1/grub2-mkrelpath.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MKRELPATH "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-MKRELPATH "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-mkrelpath \- make a system path relative to its root .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-mkrescue.1 b/upstream/fedora-rawhide/man1/grub2-mkrescue.1 index 05c83d19..19948ff7 100644 --- a/upstream/fedora-rawhide/man1/grub2-mkrescue.1 +++ b/upstream/fedora-rawhide/man1/grub2-mkrescue.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MKRESCUE "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-MKRESCUE "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-mkrescue \- make a GRUB rescue image .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-mkstandalone.1 b/upstream/fedora-rawhide/man1/grub2-mkstandalone.1 index eac65dc0..47f6264a 100644 --- a/upstream/fedora-rawhide/man1/grub2-mkstandalone.1 +++ b/upstream/fedora-rawhide/man1/grub2-mkstandalone.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MKSTANDALONE "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-MKSTANDALONE "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-mkstandalone \- make a memdisk-based GRUB image .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-mount.1 b/upstream/fedora-rawhide/man1/grub2-mount.1 index c091092b..a57f5f3e 100644 --- a/upstream/fedora-rawhide/man1/grub2-mount.1 +++ b/upstream/fedora-rawhide/man1/grub2-mount.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MOUNT "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-MOUNT "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-mount \- export GRUB filesystem with FUSE .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-script-check.1 b/upstream/fedora-rawhide/man1/grub2-script-check.1 index d079772e..421de42e 100644 --- a/upstream/fedora-rawhide/man1/grub2-script-check.1 +++ b/upstream/fedora-rawhide/man1/grub2-script-check.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-SCRIPT-CHECK "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-SCRIPT-CHECK "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-script-check \- check grub.cfg for syntax errors .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-set-bootflag.1 b/upstream/fedora-rawhide/man1/grub2-set-bootflag.1 index 9d0cd683..0e2572d4 100644 --- a/upstream/fedora-rawhide/man1/grub2-set-bootflag.1 +++ b/upstream/fedora-rawhide/man1/grub2-set-bootflag.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-SET-BOOTFLAG "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-SET-BOOTFLAG "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-set-bootflag \- set a bootflag in the GRUB environment block .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/grub2-syslinux2cfg.1 b/upstream/fedora-rawhide/man1/grub2-syslinux2cfg.1 index a84bf688..d0432259 100644 --- a/upstream/fedora-rawhide/man1/grub2-syslinux2cfg.1 +++ b/upstream/fedora-rawhide/man1/grub2-syslinux2cfg.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-SYSLINUX2CFG "1" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-SYSLINUX2CFG "1" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-syslinux2cfg \- transform syslinux config into grub.cfg .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/gs.1 b/upstream/fedora-rawhide/man1/gs.1 index c3897406..8ef395ce 100644 --- a/upstream/fedora-rawhide/man1/gs.1 +++ b/upstream/fedora-rawhide/man1/gs.1 @@ -1,4 +1,4 @@ -.TH GS 1 "01 November 2023" 10.02.1 Ghostscript \" -*- nroff -*- +.TH GS 1 "06 May 2024" 10.03.1 Ghostscript \" -*- nroff -*- .SH NAME gs \- Ghostscript (PostScript and PDF language interpreter and previewer) .SH SYNOPSIS @@ -423,7 +423,7 @@ The various Ghostscript document files (above), especially \fBUse.htm\fR. See http://bugs.ghostscript.com/ and the Usenet news group comp.lang.postscript. .SH VERSION -This document was last revised for Ghostscript version 10.02.1. +This document was last revised for Ghostscript version 10.03.1. .SH AUTHOR Artifex Software, Inc. are the primary maintainers of Ghostscript. diff --git a/upstream/fedora-rawhide/man1/gsnd.1 b/upstream/fedora-rawhide/man1/gsnd.1 index 2711357c..721af68d 100644 --- a/upstream/fedora-rawhide/man1/gsnd.1 +++ b/upstream/fedora-rawhide/man1/gsnd.1 @@ -1,4 +1,4 @@ -.TH GSND 1 "01 November 2023" 10.02.1 Ghostscript \" -*- nroff -*- +.TH GSND 1 "06 May 2024" 10.03.1 Ghostscript \" -*- nroff -*- .SH NAME gsnd \- Run ghostscript (PostScript and PDF engine) without display .SH SYNOPSIS @@ -12,7 +12,7 @@ flag, followed by any other arguments from the command-line. .SH SEE ALSO gs(1) .SH VERSION -This document was last revised for Ghostscript version 10.02.1. +This document was last revised for Ghostscript version 10.03.1. .SH AUTHOR Artifex Software, Inc. are the primary maintainers of Ghostscript. diff --git a/upstream/fedora-rawhide/man1/head.1 b/upstream/fedora-rawhide/man1/head.1 index 35c138e0..6d1f830a 100644 --- a/upstream/fedora-rawhide/man1/head.1 +++ b/upstream/fedora-rawhide/man1/head.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH HEAD "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH HEAD "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME head \- output the first part of files .SH SYNOPSIS @@ -51,7 +51,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/homectl.1 b/upstream/fedora-rawhide/man1/homectl.1 index db58c946..6cbbbac1 100644 --- a/upstream/fedora-rawhide/man1/homectl.1 +++ b/upstream/fedora-rawhide/man1/homectl.1 @@ -1,5 +1,5 @@ '\" t -.TH "HOMECTL" "1" "" "systemd 255" "homectl" +.TH "HOMECTL" "1" "" "systemd 256~rc3" "homectl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,7 +20,7 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -homectl \- Create, remove, change or inspect home directories +homectl, systemd-homed-firstboot.service \- Create, remove, change or inspect home directories .SH "SYNOPSIS" .HP \w'\fBhomectl\fR\ 'u \fBhomectl\fR [OPTIONS...] {COMMAND} [NAME...] @@ -151,7 +151,7 @@ The following general options are understood (further options that control the v systemd\-homed\&.service are documented further down): .PP -\fB\-\-identity=\fR\fIFILE\fR +\fB\-\-identity=\fR\fB\fIFILE\fR\fR .RS 4 Read the user\*(Aqs JSON record from the specified file\&. If passed as "\-" @@ -165,7 +165,7 @@ commands (see below), where it allows configuring the user record in JSON as\-is Added in version 245\&. .RE .PP -\fB\-\-json=\fR\fIFORMAT\fR, \fB\-j\fR +\fB\-\-json=\fR\fB\fIFORMAT\fR\fR, \fB\-j\fR .RS 4 Controls whether to output the user record in JSON format, if the \fBinspect\fR @@ -190,7 +190,7 @@ otherwise\&. Added in version 245\&. .RE .PP -\fB\-\-export\-format=\fR\fIFORMAT\fR, \fB\-E\fR, \fB\-EE\fR +\fB\-\-export\-format=\fR\fB\fIFORMAT\fR\fR, \fB\-E\fR, \fB\-EE\fR .RS 4 When used with the \fBinspect\fR @@ -217,6 +217,13 @@ mode, the signature is removed during the replication and thus the record will b Added in version 245\&. .RE .PP +\fB\-\-offline\fR +.RS 4 +Do not attempt to update the copy of the user record and blob directory that is embedded inside of the home area\&. This allows for operation on home areas that are absent, or without needing to authenticate as the user being modified\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-H\fR, \fB\-\-host=\fR .RS 4 Execute the operation remotely\&. Specify a hostname, or a username and hostname separated by @@ -276,21 +283,21 @@ and \fBupdate\fR commands for configuring various aspects of the home directory and the user account: .PP -\fB\-\-real\-name=\fR\fINAME\fR, \fB\-c\fR \fINAME\fR +\fB\-\-real\-name=\fR\fB\fINAME\fR\fR, \fB\-c\fR \fINAME\fR .RS 4 The real name for the user\&. This corresponds with the GECOS field on classic UNIX NSS records\&. .sp Added in version 245\&. .RE .PP -\fB\-\-realm=\fR\fIREALM\fR +\fB\-\-realm=\fR\fB\fIREALM\fR\fR .RS 4 The realm for the user\&. The realm associates a user with a specific organization or installation, and allows distinguishing users of the same name defined in different contexts\&. The realm can be any string that also qualifies as valid DNS domain name, and it is recommended to use the organization\*(Aqs or installation\*(Aqs domain name for this purpose, but this is not enforced nor required\&. On each system only a single user of the same name may exist, and if a user with the same name and realm is seen it is assumed to refer to the same user while a user with the same name but different realm is considered a different user\&. Note that this means that two users sharing the same name but with distinct realms are not allowed on the same system\&. Assigning a realm to a user is optional\&. .sp Added in version 245\&. .RE .PP -\fB\-\-email\-address=\fR\fIEMAIL\fR +\fB\-\-email\-address=\fR\fB\fIEMAIL\fR\fR .RS 4 Takes an electronic mail address to associate with the user\&. On log\-in the \fI$EMAIL\fR @@ -299,7 +306,7 @@ environment variable is initialized from this value\&. Added in version 245\&. .RE .PP -\fB\-\-location=\fR\fITEXT\fR +\fB\-\-location=\fR\fB\fITEXT\fR\fR .RS 4 Takes location specification for this user\&. This is free\-form text, which might or might not be usable by geo\-location applications\&. Example: \fB\-\-location="Berlin, Germany"\fR @@ -309,7 +316,7 @@ or Added in version 245\&. .RE .PP -\fB\-\-icon\-name=\fR\fIICON\fR +\fB\-\-icon\-name=\fR\fB\fIICON\fR\fR .RS 4 Takes an icon name to associate with the user, following the scheme defined by the \m[blue]\fBIcon Naming Specification\fR\m[]\&\s-2\u[2]\d\s+2\&. @@ -317,7 +324,7 @@ Takes an icon name to associate with the user, following the scheme defined by t Added in version 245\&. .RE .PP -\fB\-\-home\-dir=\fR\fIPATH\fR, \fB\-d\fR\fIPATH\fR +\fB\-\-home\-dir=\fR\fB\fIPATH\fR\fR, \fB\-d\fR\fB\fIPATH\fR\fR .RS 4 Takes a path to use as home directory for the user\&. Note that this is the directory the user\*(Aqs home directory is mounted to while the user is logged in\&. This is not where the user\*(Aqs data is actually stored, see \fB\-\-image\-path=\fR @@ -327,7 +334,7 @@ for that\&. If not specified defaults to Added in version 245\&. .RE .PP -\fB\-\-uid=\fR\fIUID\fR +\fB\-\-uid=\fR\fB\fIUID\fR\fR .RS 4 Takes a preferred numeric UNIX UID to assign this user\&. If a user is to be created with the specified UID and it is already taken by a different user on the local system then creation of the home directory is refused\&. Note though, if after creating the home directory it is used on a different system and the configured UID is taken by another user there, then \fBsystemd\-homed\fR @@ -343,7 +350,7 @@ always have a matching group associated with the same name as well as a GID matc Added in version 245\&. .RE .PP -\fB\-\-member\-of=\fR\fIGROUP\fR, \fB\-G\fR \fIGROUP\fR +\fB\-\-member\-of=\fR\fB\fIGROUP\fR\fR, \fB\-G\fR \fIGROUP\fR .RS 4 Takes a comma\-separated list of auxiliary UNIX groups this user shall belong to\&. Example: \fB\-\-member\-of=wheel\fR @@ -355,7 +362,7 @@ does not manage any groups besides a group matching the user in name and numeric Added in version 245\&. .RE .PP -\fB\-\-capability\-bounding\-set=\fR\fICAPABILITIES\fR, \fB\-\-capability\-ambient\-set=\fR\fICAPABILITIES\fR +\fB\-\-capability\-bounding\-set=\fR\fB\fICAPABILITIES\fR\fR, \fB\-\-capability\-ambient\-set=\fR\fB\fICAPABILITIES\fR\fR .RS 4 These options take a space separated list of process capabilities (e\&.g\&. \fBCAP_WAKE_ALARM\fR, @@ -368,7 +375,7 @@ character the effect is inverted: the specified capability is dropped from the s Added in version 254\&. .RE .PP -\fB\-\-skel=\fR\fIPATH\fR +\fB\-\-skel=\fR\fB\fIPATH\fR\fR .RS 4 Takes a file system path to a directory\&. Specifies the skeleton directory to initialize the home directory with\&. All files and directories in the specified path are copied into any newly create home directory\&. If not specified defaults to /etc/skel/\&. @@ -376,7 +383,7 @@ Takes a file system path to a directory\&. Specifies the skeleton directory to i Added in version 245\&. .RE .PP -\fB\-\-shell=\fR\fISHELL\fR +\fB\-\-shell=\fR\fB\fISHELL\fR\fR .RS 4 Takes a file system path\&. Specifies the shell binary to execute on terminal logins\&. If not specified defaults to /bin/bash\&. @@ -384,7 +391,7 @@ Takes a file system path\&. Specifies the shell binary to execute on terminal lo Added in version 245\&. .RE .PP -\fB\-\-setenv=\fR\fIVARIABLE\fR[=\fIVALUE\fR] +\fB\-\-setenv=\fR\fB\fIVARIABLE\fR\fR\fB[=\fR\fB\fIVALUE\fR\fR\fB]\fR .RS 4 Takes an environment variable assignment to set for all user processes\&. May be used multiple times to set multiple environment variables\&. When "=" @@ -401,7 +408,7 @@ and Added in version 245\&. .RE .PP -\fB\-\-timezone=\fR\fITIMEZONE\fR +\fB\-\-timezone=\fR\fB\fITIMEZONE\fR\fR .RS 4 Takes a time zone location name that sets the timezone for the specified user\&. When the user logs in the \fI$TZ\fR @@ -415,17 +422,19 @@ is used intentionally as part of the timezone specification, see Added in version 245\&. .RE .PP -\fB\-\-language=\fR\fILANG\fR +\fB\-\-language=\fR\fB\fILANG\fR\fR .RS 4 -Takes a specifier indicating the preferred language of the user\&. The +Takes a comma\- or colon\-separated list of languages preferred by the user, ordered by descending priority\&. The \fI$LANG\fR -environment variable is initialized from this value on login, and thus a value suitable for this environment variable is accepted here, for example -\fB\-\-language=de_DE\&.UTF8\fR\&. +and +\fI$LANGUAGE\fR +environment variables are initialized from this value on login, and thus values suitible for these environment variables are accepted here, for example +\fB\-\-language=de_DE\&.UTF\-8\fR\&. This option may be used more than once, in which case the language lists are concatenated\&. .sp Added in version 245\&. .RE .PP -\fB\-\-ssh\-authorized\-keys=\fR\fIKEYS\fR +\fB\-\-ssh\-authorized\-keys=\fR\fB\fIKEYS\fR\fR .RS 4 Either takes a SSH authorized key line to associate with the user record or a "@" @@ -434,7 +443,7 @@ character followed by a path to a file to read one or more such lines from\&. SS Added in version 245\&. .RE .PP -\fB\-\-pkcs11\-token\-uri=\fR\fIURI\fR +\fB\-\-pkcs11\-token\-uri=\fR\fB\fIURI\fR\fR .RS 4 Takes an RFC 7512 PKCS#11 URI referencing a security token (e\&.g\&. YubiKey or PIV smartcard) that shall be able to unlock the user account\&. The security token URI should reference a security token with exactly one pair of X\&.509 certificate and private key\&. A random secret key is then generated, encrypted with the public key of the X\&.509 certificate, and stored as part of the user record\&. At login time it is decrypted with the PKCS#11 module and then used to unlock the account and associated resources\&. See below for an example how to set up authentication with a security token\&. .sp @@ -457,7 +466,7 @@ option below\&. Both mechanisms are similarly powerful, though FIDO2 is the more Added in version 245\&. .RE .PP -\fB\-\-fido2\-credential\-algorithm=\fR\fISTRING\fR +\fB\-\-fido2\-credential\-algorithm=\fR\fB\fISTRING\fR\fR .RS 4 Specify COSE algorithm used in credential generation\&. The default value is "es256"\&. Supported values are @@ -473,12 +482,12 @@ denotes 2048\-bit RSA with PKCS#1\&.5 padding and SHA\-256\&. "eddsa" denotes EDDSA over Curve25519 with SHA\-512\&. .sp -Note that your authenticator may not support some algorithms\&. +Note that your authenticator may choose not to support some algorithms\&. .sp Added in version 251\&. .RE .PP -\fB\-\-fido2\-device=\fR\fIPATH\fR +\fB\-\-fido2\-device=\fR\fB\fIPATH\fR\fR .RS 4 Takes a path to a Linux "hidraw" @@ -514,7 +523,7 @@ or Added in version 246\&. .RE .PP -\fB\-\-fido2\-with\-client\-pin=\fR\fIBOOL\fR +\fB\-\-fido2\-with\-client\-pin=\fR\fB\fIBOOL\fR\fR .RS 4 When enrolling a FIDO2 security token, controls whether to require the user to enter a PIN when unlocking the account (the FIDO2 "clientPin" @@ -526,7 +535,7 @@ feature at all, or does not allow enabling or disabling it\&.) Added in version 249\&. .RE .PP -\fB\-\-fido2\-with\-user\-presence=\fR\fIBOOL\fR +\fB\-\-fido2\-with\-user\-presence=\fR\fB\fIBOOL\fR\fR .RS 4 When enrolling a FIDO2 security token, controls whether to require the user to verify presence (tap the token, the FIDO2 "up" @@ -538,7 +547,7 @@ feature at all, or does not allow enabling or disabling it\&.) Added in version 249\&. .RE .PP -\fB\-\-fido2\-with\-user\-verification=\fR\fIBOOL\fR +\fB\-\-fido2\-with\-user\-verification=\fR\fB\fIBOOL\fR\fR .RS 4 When enrolling a FIDO2 security token, controls whether to require user verification when unlocking the account (the FIDO2 "uv" @@ -550,21 +559,40 @@ feature at all, or does not allow enabling or disabling it\&.) Added in version 249\&. .RE .PP -\fB\-\-recovery\-key=\fR\fIBOOL\fR +\fB\-\-recovery\-key=\fR\fB\fIBOOL\fR\fR .RS 4 Accepts a boolean argument\&. If enabled a recovery key is configured for the account\&. A recovery key is a computer generated access key that may be used to regain access to an account if the password has been forgotten or the authentication token lost\&. The key is generated and shown on screen, and should be printed or otherwise transferred to a secure location\&. A recovery key may be entered instead of a regular password to unlock the account\&. .sp Added in version 247\&. .RE .PP -\fB\-\-locked=\fR\fIBOOLEAN\fR +\fB\-\-blob=\fR\fB\fIPATH\fR\fR, \fB\-b\fR \fIPATH\fR, \fB\-\-blob=\fR\fB\fIFILENAME\fR\fR\fB=\fR\fB\fIPATH\fR\fR, \fB\-b\fR \fIFILENAME\fR=\fIPATH\fR +.RS 4 +Accepts either a directory path, or a file name followed by a file path\&. If just a directory path is specified, then the user\*(Aqs entire blob directory is replaced the specified path\&. Note that this replacement is performed before per\-file manipulations are applied, which means these per\-file manipulations will be applied on top of the specified directory\&. If a filename and file path are specified, then the single specified blob file will be overwritten with the specified path\&. If completely blank, the entire blob directory is emptied out (which also resets all previous blob\-related flags up to this point)\&. If a filename is specified but the corresponding path is blank, that single file will be deleted from the blob directory\&. All changes are performed in temporary copies of the specified files in directories, which means that the originals specified on the command line are not modified\&. See +\m[blue]\fBUser Record Blob Directories\fR\m[]\&\s-2\u[3]\d\s+2 +for more information about blob directories\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-avatar=\fR\fB\fIPATH\fR\fR, \fB\-\-login\-background=\fR\fB\fIPATH\fR\fR +.RS 4 +Accept a file path\&. If set, the specified file is used to overwrite the corresponding file in the user\*(Aqs blob directory\&. If blank, the corresponding file is deleted from the blob directory\&. Essentially, these options are shortcuts to +\fB\-\-blob=\fR\fB\fIFILENAME\fR\fR\fB=\fR\fB\fIPATH\fR\fR +for the known filenames defined in +\m[blue]\fBUser Record Blob Directories\fR\m[]\&\s-2\u[3]\d\s+2\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-locked=\fR\fB\fIBOOLEAN\fR\fR .RS 4 Takes a boolean argument\&. Specifies whether this user account shall be locked\&. If true logins into this account are prohibited, if false (the default) they are permitted (of course, only if authorization otherwise succeeds)\&. .sp Added in version 245\&. .RE .PP -\fB\-\-not\-before=\fR\fITIMESTAMP\fR, \fB\-\-not\-after=\fR\fITIMESTAMP\fR +\fB\-\-not\-before=\fR\fB\fITIMESTAMP\fR\fR, \fB\-\-not\-after=\fR\fB\fITIMESTAMP\fR\fR .RS 4 These options take a timestamp string, in the format documented in \fBsystemd.time\fR(7) @@ -573,14 +601,14 @@ and configures points in time before and after logins into this account are not Added in version 245\&. .RE .PP -\fB\-\-rate\-limit\-interval=\fR\fISECS\fR, \fB\-\-rate\-limit\-burst=\fR\fINUMBER\fR +\fB\-\-rate\-limit\-interval=\fR\fB\fISECS\fR\fR, \fB\-\-rate\-limit\-burst=\fR\fB\fINUMBER\fR\fR .RS 4 Configures a rate limit on authentication attempts for this user\&. If the user attempts to authenticate more often than the specified number, on a specific system, within the specified time interval authentication is refused until the time interval passes\&. Defaults to 10 times per 1min\&. .sp Added in version 245\&. .RE .PP -\fB\-\-password\-hint=\fR\fITEXT\fR +\fB\-\-password\-hint=\fR\fB\fITEXT\fR\fR .RS 4 Takes a password hint to store alongside the user record\&. This string is stored accessible only to privileged users and the user itself and may not be queried by other users\&. Example: \fB\-\-password\-hint="My first pet\*(Aqs name"\fR\&. @@ -588,7 +616,7 @@ Takes a password hint to store alongside the user record\&. This string is store Added in version 245\&. .RE .PP -\fB\-\-enforce\-password\-policy=\fR\fIBOOL\fR, \fB\-P\fR +\fB\-\-enforce\-password\-policy=\fR\fB\fIBOOL\fR\fR, \fB\-P\fR .RS 4 Takes a boolean argument\&. Configures whether to enforce the system\*(Aqs password policy for this user, regarding quality and strength of selected passwords\&. Defaults to on\&. \fB\-P\fR @@ -598,14 +626,14 @@ is short for Added in version 245\&. .RE .PP -\fB\-\-password\-change\-now=\fR\fIBOOL\fR +\fB\-\-password\-change\-now=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean argument\&. If true the user is asked to change their password on next login\&. .sp Added in version 245\&. .RE .PP -\fB\-\-password\-change\-min=\fR\fITIME\fR, \fB\-\-password\-change\-max=\fR\fITIME\fR, \fB\-\-password\-change\-warn=\fR\fITIME\fR, \fB\-\-password\-change\-inactive=\fR\fITIME\fR +\fB\-\-password\-change\-min=\fR\fB\fITIME\fR\fR, \fB\-\-password\-change\-max=\fR\fB\fITIME\fR\fR, \fB\-\-password\-change\-warn=\fR\fB\fITIME\fR\fR, \fB\-\-password\-change\-inactive=\fR\fB\fITIME\fR\fR .RS 4 Each of these options takes a time span specification as argument (in the syntax documented in \fBsystemd.time\fR(7)) and configures various aspects of the user\*(Aqs password expiration policy\&. Specifically, @@ -623,7 +651,7 @@ configures the time which has to pass after the password as expired until the us Added in version 245\&. .RE .PP -\fB\-\-disk\-size=\fR\fIBYTES\fR +\fB\-\-disk\-size=\fR\fB\fIBYTES\fR\fR .RS 4 Either takes a size in bytes as argument (possibly using the usual K, M, G, \&... suffixes for 1024 base values), a percentage value, or the special strings "min" @@ -638,7 +666,7 @@ assigns the maximum disk space available\&. If the LUKS2 backend is used this co Added in version 245\&. .RE .PP -\fB\-\-access\-mode=\fR\fIMODE\fR +\fB\-\-access\-mode=\fR\fB\fIMODE\fR\fR .RS 4 Takes a UNIX file access mode written in octal\&. Configures the access mode of the home directory itself\&. Note that this is only used when the directory is first created, and the user may change this any time afterwards\&. Example: \fB\-\-access\-mode=0700\fR @@ -646,21 +674,21 @@ Takes a UNIX file access mode written in octal\&. Configures the access mode of Added in version 245\&. .RE .PP -\fB\-\-umask=\fR\fIMASK\fR +\fB\-\-umask=\fR\fB\fIMASK\fR\fR .RS 4 Takes the access mode mask (in octal syntax) to apply to newly created files and directories of the user ("umask")\&. If set this controls the initial umask set for all login sessions of the user, possibly overriding the system\*(Aqs defaults\&. .sp Added in version 245\&. .RE .PP -\fB\-\-nice=\fR\fINICE\fR +\fB\-\-nice=\fR\fB\fINICE\fR\fR .RS 4 Takes the numeric scheduling priority ("nice level") to apply to the processes of the user at login time\&. Takes a numeric value in the range \-20 (highest priority) to 19 (lowest priority)\&. .sp Added in version 245\&. .RE .PP -\fB\-\-rlimit=\fR\fILIMIT\fR=\fIVALUE\fR[:\fIVALUE\fR] +\fB\-\-rlimit=\fR\fB\fILIMIT\fR\fR\fB=\fR\fB\fIVALUE\fR\fR\fB[:\fIVALUE\fR]\fR .RS 4 Allows configuration of resource limits for processes of this user, see \fBgetrlimit\fR(2) @@ -670,7 +698,7 @@ for details\&. Takes a resource limit name (e\&.g\&. Added in version 245\&. .RE .PP -\fB\-\-tasks\-max=\fR\fITASKS\fR +\fB\-\-tasks\-max=\fR\fB\fITASKS\fR\fR .RS 4 Takes a non\-zero unsigned integer as argument\&. Configures the maximum number of tasks (i\&.e\&. threads, where each process is at least one thread) the user may have at any given time\&. This limit applies to all tasks forked off the user\*(Aqs sessions, even if they change user identity via \fBsu\fR(1) @@ -686,7 +714,7 @@ for further details\&. Added in version 245\&. .RE .PP -\fB\-\-memory\-high=\fR\fIBYTES\fR, \fB\-\-memory\-max=\fR\fIBYTES\fR +\fB\-\-memory\-high=\fR\fB\fIBYTES\fR\fR, \fB\-\-memory\-max=\fR\fB\fIBYTES\fR\fR .RS 4 Set a limit on the memory a user may take up on a system at any given time in bytes (the usual K, M, G, \&... suffixes are supported, to the base of 1024)\&. This includes all memory used by the user itself and all processes they forked off that changed user credentials\&. This controls the \fIMemoryHigh=\fR @@ -700,7 +728,7 @@ for further details\&. Added in version 245\&. .RE .PP -\fB\-\-cpu\-weight=\fR\fIWEIGHT\fR, \fB\-\-io\-weight=\fR\fIWEIGHT\fR +\fB\-\-cpu\-weight=\fR\fB\fIWEIGHT\fR\fR, \fB\-\-io\-weight=\fR\fB\fIWEIGHT\fR\fR .RS 4 Set CPU and IO scheduling weights of the processes of the user, including those of processes forked off by the user that changed user credentials\&. Takes a numeric value in the range 1\&...10000\&. This controls the \fICPUWeight=\fR @@ -714,7 +742,7 @@ for further details\&. Added in version 245\&. .RE .PP -\fB\-\-storage=\fR\fISTORAGE\fR +\fB\-\-storage=\fR\fB\fISTORAGE\fR\fR .RS 4 Selects the storage mechanism to use for this home directory\&. Takes one of "luks", @@ -728,7 +756,7 @@ defines which default storage to use\&. Added in version 245\&. .RE .PP -\fB\-\-image\-path=\fR\fIPATH\fR +\fB\-\-image\-path=\fR\fB\fIPATH\fR\fR .RS 4 Takes a file system path\&. Configures where to place the user\*(Aqs home directory\&. When LUKS2 storage is used refers to the path to the loopback file, otherwise to the path to the home directory (which may be in /home/ @@ -743,14 +771,14 @@ storage mechanism\&. To use LUKS2 storage on a regular block device (for example Added in version 245\&. .RE .PP -\fB\-\-drop\-caches=\fR\fIBOOL\fR +\fB\-\-drop\-caches=\fR\fB\fIBOOL\fR\fR .RS 4 Automatically flush OS file system caches on logout\&. This is useful in combination with the fscrypt storage backend to ensure the OS does not keep decrypted versions of the files and directories in memory (and accessible) after logout\&. This option is also supported on other backends, but should not bring any benefit there\&. Defaults to off, except if the selected storage backend is fscrypt, where it defaults to on\&. Note that flushing OS caches will negatively influence performance of the OS shortly after logout\&. .sp Added in version 250\&. .RE .PP -\fB\-\-fs\-type=\fR\fITYPE\fR +\fB\-\-fs\-type=\fR\fB\fITYPE\fR\fR .RS 4 When LUKS2 storage is used configures the file system type to use inside the home directory LUKS2 container\&. One of "btrfs", @@ -764,7 +792,7 @@ is not recommended as its support for file system resizing is too limited\&. Added in version 245\&. .RE .PP -\fB\-\-luks\-discard=\fR\fIBOOL\fR +\fB\-\-luks\-discard=\fR\fB\fIBOOL\fR\fR .RS 4 When LUKS2 storage is used configures whether to enable the "discard" @@ -773,7 +801,7 @@ feature of the file system\&. If enabled the file system on top of the LUKS2 vol Added in version 245\&. .RE .PP -\fB\-\-luks\-offline\-discard=\fR\fIBOOL\fR +\fB\-\-luks\-offline\-discard=\fR\fB\fIBOOL\fR\fR .RS 4 Similar to \fB\-\-luks\-discard=\fR, controls the trimming of the file system\&. However, while @@ -785,14 +813,14 @@ controls what happens when it becomes inactive, i\&.e\&. whether to trim/allocat Added in version 246\&. .RE .PP -\fB\-\-luks\-extra\-mount\-options=\fR\fIOPTIONS\fR +\fB\-\-luks\-extra\-mount\-options=\fR\fB\fIOPTIONS\fR\fR .RS 4 Takes a string containing additional mount options to use when mounting the LUKS volume\&. If specified, this string will be appended to the default, built\-in mount options\&. .sp Added in version 250\&. .RE .PP -\fB\-\-luks\-cipher=\fR\fICIPHER\fR, \fB\-\-luks\-cipher\-mode=\fR\fIMODE\fR, \fB\-\-luks\-volume\-key\-size=\fR\fIBYTES\fR, \fB\-\-luks\-pbkdf\-type=\fR\fITYPE\fR, \fB\-\-luks\-pbkdf\-hash\-algorithm=\fR\fIALGORITHM\fR, \fB\-\-luks\-pbkdf\-force\-iterations=\fR\fIITERATIONS\fR, \fB\-\-luks\-pbkdf\-time\-cost=\fR\fISECONDS\fR, \fB\-\-luks\-pbkdf\-memory\-cost=\fR\fIBYTES\fR, \fB\-\-luks\-pbkdf\-parallel\-threads=\fR\fITHREADS\fR, \fB\-\-luks\-sector\-size=\fR\fIBYTES\fR +\fB\-\-luks\-cipher=\fR\fB\fICIPHER\fR\fR, \fB\-\-luks\-cipher\-mode=\fR\fB\fIMODE\fR\fR, \fB\-\-luks\-volume\-key\-size=\fR\fB\fIBYTES\fR\fR, \fB\-\-luks\-pbkdf\-type=\fR\fB\fITYPE\fR\fR, \fB\-\-luks\-pbkdf\-hash\-algorithm=\fR\fB\fIALGORITHM\fR\fR, \fB\-\-luks\-pbkdf\-force\-iterations=\fR\fB\fIITERATIONS\fR\fR, \fB\-\-luks\-pbkdf\-time\-cost=\fR\fB\fISECONDS\fR\fR, \fB\-\-luks\-pbkdf\-memory\-cost=\fR\fB\fIBYTES\fR\fR, \fB\-\-luks\-pbkdf\-parallel\-threads=\fR\fB\fITHREADS\fR\fR, \fB\-\-luks\-sector\-size=\fR\fB\fIBYTES\fR\fR .RS 4 Configures various cryptographic parameters for the LUKS2 storage mechanism\&. See \fBcryptsetup\fR(8) @@ -841,7 +869,7 @@ with an empty parameter\&. Added in version 250\&. .RE .PP -\fB\-\-nosuid=\fR\fIBOOL\fR, \fB\-\-nodev=\fR\fIBOOL\fR, \fB\-\-noexec=\fR\fIBOOL\fR +\fB\-\-nosuid=\fR\fB\fIBOOL\fR\fR, \fB\-\-nodev=\fR\fB\fIBOOL\fR\fR, \fB\-\-noexec=\fR\fB\fIBOOL\fR\fR .RS 4 Configures the "nosuid", @@ -860,7 +888,7 @@ is off\&. For details about these mount options see Added in version 245\&. .RE .PP -\fB\-\-cifs\-domain=\fR\fIDOMAIN\fR, \fB\-\-cifs\-user\-name=\fR\fIUSER\fR, \fB\-\-cifs\-service=\fR\fISERVICE\fR, \fB\-\-cifs\-extra\-mount\-options=\fR\fIOPTIONS\fR +\fB\-\-cifs\-domain=\fR\fB\fIDOMAIN\fR\fR, \fB\-\-cifs\-user\-name=\fR\fB\fIUSER\fR\fR, \fB\-\-cifs\-service=\fR\fB\fISERVICE\fR\fR, \fB\-\-cifs\-extra\-mount\-options=\fR\fB\fIOPTIONS\fR\fR .RS 4 Configures the Windows File Sharing (CIFS) domain and user to associate with the home directory/user account, as well as the file share ("service") to mount as directory\&. The latter is used when "cifs" @@ -874,7 +902,7 @@ for details\&. Added in version 245\&. .RE .PP -\fB\-\-stop\-delay=\fR\fISECS\fR +\fB\-\-stop\-delay=\fR\fB\fISECS\fR\fR .RS 4 Configures the time the per\-user service manager shall continue to run after the all sessions of the user ended\&. The default is configured in \fBlogind.conf\fR(5) @@ -883,7 +911,7 @@ Configures the time the per\-user service manager shall continue to run after th Added in version 245\&. .RE .PP -\fB\-\-kill\-processes=\fR\fIBOOL\fR +\fB\-\-kill\-processes=\fR\fB\fIBOOL\fR\fR .RS 4 Configures whether to kill all processes of the user on logout\&. The default is configured in \fBlogind.conf\fR(5)\&. @@ -891,12 +919,34 @@ Configures whether to kill all processes of the user on logout\&. The default is Added in version 245\&. .RE .PP -\fB\-\-auto\-login=\fR\fIBOOL\fR +\fB\-\-auto\-login=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean argument\&. Configures whether the graphical UI of the system should automatically log this user in if possible\&. Defaults to off\&. If less or more than one user is marked this way automatic login is disabled\&. .sp Added in version 245\&. .RE +.PP +\fB\-\-session\-launcher=\fR\fB\fILAUNCHER\fR\fR +.RS 4 +Takes a string argument\&. Configures the user\*(Aqs preferred session launcher \&.desktop entry file (i\&.e\&. +"gnome", +"plasma", or other names that appear in +/usr/share/xesssions/ +or +/usr/share/wayland\-sessions)\&. This is read by the display manager to pick the default session that is launched when the user logs in\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-session\-type=\fR\fB\fITYPE\fR\fR +.RS 4 +Takes a string argument\&. Configures the user\*(Aqs preferred session type (i\&.e\&. +"x11", +"wayland", and other values accepted by +\fI$XDG_SESSION_TYPE\fR)\&. This is read by the display manage to pick the default session type the user is logged into\&. +.sp +Added in version 256\&. +.RE .SH "COMMANDS" .PP The following commands are understood: @@ -947,12 +997,12 @@ Validate authentication credentials of a home directory\&. This queries the call Added in version 245\&. .RE .PP -\fBcreate\fR \fIUSER\fR, \fBcreate\fR \fB\-\-identity=\fR\fIPATH\fR [\fIUSER\fR] +\fBcreate\fR \fIUSER\fR, \fBcreate\fR \fB\-\-identity=\fR\fB\fIPATH\fR\fR [\fIUSER\fR] .RS 4 Create a new home directory/user account of the specified name\&. Use the various user record property options (as documented above) to control various aspects of the home directory and its user accounts\&. .sp The specified user name should follow the strict syntax described on -\m[blue]\fBUser/Group Name Syntax\fR\m[]\&\s-2\u[3]\d\s+2\&. +\m[blue]\fBUser/Group Name Syntax\fR\m[]\&\s-2\u[4]\d\s+2\&. .sp Added in version 245\&. .RE @@ -964,7 +1014,7 @@ Remove a home directory/user account\&. This will remove both the home directory Added in version 245\&. .RE .PP -\fBupdate\fR \fIUSER\fR, \fBupdate\fR \fB\-\-identity=\fR\fIPATH\fR [\fIUSER\fR] +\fBupdate\fR \fIUSER\fR, \fBupdate\fR \fB\-\-identity=\fR\fB\fIPATH\fR\fR [\fIUSER\fR] .RS 4 Update a home directory/user account\&. Use the various user record property options (as documented above) to make changes to the account, or alternatively provide a full, updated JSON user record via the \fB\-\-identity=\fR @@ -1063,6 +1113,49 @@ above\&. This executes no operation unless there\*(Aqs at least one active LUKS2 .sp Added in version 250\&. .RE +.PP +\fBfirstboot\fR +.RS 4 +This command is supposed to be invoked during the initial boot of the system\&. It checks whether any regular home area exists so far, and if not queries the user interactively on the console for user name and password and creates one\&. Alternatively, if one or more service credentials whose name starts with +"home\&.create\&." +are passed to the command (containing a user record in JSON format) these users are automatically created at boot\&. +.sp +This command is invoked by the +systemd\-homed\-firstboot\&.service +service unit\&. +.sp +Added in version 256\&. +.RE +.SH "CREDENTIALS" +.PP +When invoked with the +\fBfirstboot\fR +command, +\fBhomectl\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 +\fIhome\&.create\&.*\fR +.RS 4 +If one or more credentials whose names begin with +"home\&.create\&.", followed by a valid UNIX username are passed, a new home area is created, one for each specified user record\&. +.sp +Added in version 256\&. +.RE +.SH "KERNEL COMMAND LINE" +.PP +\fIsystemd\&.firstboot=\fR +.RS 4 +This boolean will disable the effect of +\fBhomectl firstboot\fR +command\&. It\*(Aqs primarily interpreted by +\fBsystemd-firstboot\fR(1)\&. +.sp +Added in version 256\&. +.RE .SH "EXIT STATUS" .PP On success, 0 is returned, a non\-zero failure code otherwise\&. @@ -1077,7 +1170,7 @@ finishes successfully\&. .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, @@ -1087,7 +1180,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 @@ -1206,6 +1307,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\&. @@ -1217,6 +1324,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 @@ -1347,12 +1460,7 @@ homectl update nihilbaxter \-\-fido2\-device=auto .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-homed.service\fR(8), -\fBhomed.conf\fR(5), -\fBuserdbctl\fR(1), -\fBuseradd\fR(8), -\fBcryptsetup\fR(8) +\fBsystemd\fR(1), \fBsystemd-homed.service\fR(8), \fBhomed.conf\fR(5), \fBuserdbctl\fR(1), \fBuseradd\fR(8), \fBcryptsetup\fR(8) .SH "NOTES" .IP " 1." 4 JSON User Records @@ -1365,6 +1473,11 @@ Icon Naming Specification \%https://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html .RE .IP " 3." 4 +User Record Blob Directories +.RS 4 +\%https://systemd.io/USER_RECORD_BLOB_DIRS +.RE +.IP " 4." 4 User/Group Name Syntax .RS 4 \%https://systemd.io/USER_NAMES diff --git a/upstream/fedora-rawhide/man1/hostid.1 b/upstream/fedora-rawhide/man1/hostid.1 index 994d0c4b..c4293a3d 100644 --- a/upstream/fedora-rawhide/man1/hostid.1 +++ b/upstream/fedora-rawhide/man1/hostid.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH HOSTID "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH HOSTID "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME hostid \- print the numeric identifier for the current host .SH SYNOPSIS @@ -22,7 +22,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/hostnamectl.1 b/upstream/fedora-rawhide/man1/hostnamectl.1 index bba45a7e..77d4116b 100644 --- a/upstream/fedora-rawhide/man1/hostnamectl.1 +++ b/upstream/fedora-rawhide/man1/hostnamectl.1 @@ -1,5 +1,5 @@ '\" t -.TH "HOSTNAMECTL" "1" "" "systemd 255" "hostnamectl" +.TH "HOSTNAMECTL" "1" "" "systemd 256~rc3" "hostnamectl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -187,7 +187,7 @@ Print a short help text and exit\&. Print a short version string and exit\&. .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" @@ -197,18 +197,21 @@ Shows output formatted as JSON\&. Expects one of "off" (to turn off JSON output, the default)\&. .RE +.PP +\fB\-j\fR +.RS 4 +Equivalent to +\fB\-\-json=pretty\fR +if running on a terminal, and +\fB\-\-json=short\fR +otherwise\&. +.RE .SH "EXIT STATUS" .PP On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBhostname\fR(1), -\fBhostname\fR(5), -\fBmachine-info\fR(5), -\fBsystemctl\fR(1), -\fBsystemd-hostnamed.service\fR(8), -\fBsystemd-firstboot\fR(1) +\fBsystemd\fR(1), \fBhostname\fR(1), \fBhostname\fR(5), \fBmachine-info\fR(5), \fBsystemctl\fR(1), \fBsystemd-hostnamed.service\fR(8), \fBsystemd-firstboot\fR(1) .SH "NOTES" .IP " 1." 4 Icon Naming Specification diff --git a/upstream/fedora-rawhide/man1/icehelp.1 b/upstream/fedora-rawhide/man1/icehelp.1 index 32ec235b..bd7574c6 100644 --- a/upstream/fedora-rawhide/man1/icehelp.1 +++ b/upstream/fedora-rawhide/man1/icehelp.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEHELP 1" -.TH ICEHELP 1 2024-01-24 "icewm\ 3.4.5" "User Commands" +.TH ICEHELP 1 2024-05-20 "icewm\ 3.5.0" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/icesh.1 b/upstream/fedora-rawhide/man1/icesh.1 index 9ad67659..c1093760 100644 --- a/upstream/fedora-rawhide/man1/icesh.1 +++ b/upstream/fedora-rawhide/man1/icesh.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICESH 1" -.TH ICESH 1 2024-01-24 "icewm\ 3.4.5" "User Commands" +.TH ICESH 1 2024-05-20 "icewm\ 3.5.0" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -339,7 +339,7 @@ Maximize the window only vertically. Minimize the window. .IP \fBrestore\fR 4 .IX Item "restore" -Restore the window to normal. +Restore the window to normal and clear urgency. .IP \fBhide\fR 4 .IX Item "hide" Hide the window. @@ -360,7 +360,7 @@ Show the window on all workspaces. Show the window on just one workspace. .IP \fBurgent\fR 4 .IX Item "urgent" -Set the urgent flag to flash the task button. +Set the urgency flag to flash the task button. .IP "\fBresize\fR \fIWIDTH\fR \fIHEIGHT\fR" 4 .IX Item "resize WIDTH HEIGHT" Resize window to \fIWIDTH\fR by \fIHEIGHT\fR window units. For text based @@ -664,6 +664,7 @@ Let icewm execute the \f(CW\*(C`HibernateCommand\*(C'\fR. .IP \fBwinoptions\fR 4 .IX Item "winoptions" Let icewm reload the \f(CW\*(C`winoptions\*(C'\fR. +This only affects new windows. .IP \fBkeys\fR 4 .IX Item "keys" Let icewm reload the \f(CW\*(C`keys\*(C'\fR file. diff --git a/upstream/fedora-rawhide/man1/icesound.1 b/upstream/fedora-rawhide/man1/icesound.1 index 928a7460..5657c7f2 100644 --- a/upstream/fedora-rawhide/man1/icesound.1 +++ b/upstream/fedora-rawhide/man1/icesound.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICESOUND 1" -.TH ICESOUND 1 2024-01-24 "icewm\ 3.4.5" "User Commands" +.TH ICESOUND 1 2024-05-20 "icewm\ 3.5.0" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/icewm-menu-fdo.1 b/upstream/fedora-rawhide/man1/icewm-menu-fdo.1 index aad397d6..94d98394 100644 --- a/upstream/fedora-rawhide/man1/icewm-menu-fdo.1 +++ b/upstream/fedora-rawhide/man1/icewm-menu-fdo.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-MENU-FDO 1" -.TH ICEWM-MENU-FDO 1 2024-01-24 "icewm\ 3.4.5" "User Commands" +.TH ICEWM-MENU-FDO 1 2024-05-20 "icewm\ 3.5.0" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -169,8 +169,9 @@ is configured with the \fB\-\-enable\-menus\-fdo\fR option, which requires the \&\fBglib2\-dev\fR package dependency. .SS "SEE ALSO" .IX Subsection "SEE ALSO" -"Desktop Entry Specification", -"Desktop Menu Specification", +Base Directory Specification, +Desktop Entry Specification, +Desktop Menu Specification, \&\fBicewm\fR\|(1), \&\fBicewm\-menu\fR\|(5), \&\fBicewm\-preferences\fR\|(5), diff --git a/upstream/fedora-rawhide/man1/icewm-menu-xrandr.1 b/upstream/fedora-rawhide/man1/icewm-menu-xrandr.1 index d588ac90..3d620607 100644 --- a/upstream/fedora-rawhide/man1/icewm-menu-xrandr.1 +++ b/upstream/fedora-rawhide/man1/icewm-menu-xrandr.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-MENU-XRANDR 1" -.TH ICEWM-MENU-XRANDR 1 2024-01-24 "icewm\ 3.4.5" "User Commands" +.TH ICEWM-MENU-XRANDR 1 2024-05-20 "icewm\ 3.5.0" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/icewm-session.1 b/upstream/fedora-rawhide/man1/icewm-session.1 index ea9023c2..d0f352d1 100644 --- a/upstream/fedora-rawhide/man1/icewm-session.1 +++ b/upstream/fedora-rawhide/man1/icewm-session.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-SESSION 1" -.TH ICEWM-SESSION 1 2024-01-24 "icewm\ 3.4.5" "User Commands" +.TH ICEWM-SESSION 1 2024-05-20 "icewm\ 3.5.0" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/icewm-set-gnomewm.1 b/upstream/fedora-rawhide/man1/icewm-set-gnomewm.1 index b0059a6f..43dc4c79 100644 --- a/upstream/fedora-rawhide/man1/icewm-set-gnomewm.1 +++ b/upstream/fedora-rawhide/man1/icewm-set-gnomewm.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-SET-GNOMEWM 1" -.TH ICEWM-SET-GNOMEWM 1 2024-01-24 "icewm\ 3.4.5" "User Commands" +.TH ICEWM-SET-GNOMEWM 1 2024-05-20 "icewm\ 3.5.0" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/icewm.1 b/upstream/fedora-rawhide/man1/icewm.1 index 67ee974f..804c030d 100644 --- a/upstream/fedora-rawhide/man1/icewm.1 +++ b/upstream/fedora-rawhide/man1/icewm.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM 1" -.TH ICEWM 1 2024-01-24 "icewm\ 3.4.5" "User Commands" +.TH ICEWM 1 2024-05-20 "icewm\ 3.5.0" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -210,6 +210,10 @@ it to search for configuration files. .IX Item "-l, --list-themes" \&\fBicewm\fR will search all the configuration directories for theme files and print a list of all found themes. +.IP "\fB\-i\fR, \fB\-\-install\fR=\fITHEME\fR" 4 +.IX Item "-i, --install=THEME" +Install \fITHEME\fR from icewm-extra and exit. When \fITHEME\fR is \fIlist\fR, +print a listing of available themes to install. .IP "\fB\-p\fR, \fB\-\-postpreferences\fR" 4 .IX Item "-p, --postpreferences" This gives a long list of all the internal \fBicewm\fR options with their @@ -507,19 +511,72 @@ When edge switching is enabled, the current workspace can also be changed by bringing the drag icon to the screen edge. .SS "ADDRESS BAR" .IX Subsection "ADDRESS BAR" -If \fBEnableAddressBar\fR=1 then \fBKeySysAddressBar\fR=\f(CW\*(C`Alt+Ctrl+Space\*(C'\fR -activates the address bar in the task bar. -If \fBShowAddressBar\fR=1 it is always shown. This is a command-line in -the task bar where a shell command can be typed. -Pressing \f(CW\*(C`Enter\*(C'\fR will execute the command. -\&\fBAddressBarCommand\fR=\f(CW\*(C`/bin/sh\*(C'\fR will be used to execute the command. -On \f(CW\*(C`Control+Enter\*(C'\fR the command is executed in a terminal +The task bar contains a command-line prompt called the address bar, +if \fBEnableAddressBar\fR=1. It is always shown when \fBShowAddressBar\fR=1, +otherwise it is activated by \fBKeySysAddressBar\fR=\f(CW\*(C`Alt+Ctrl+Space\*(C'\fR. +In it a shell command can be typed, which is executed by the +\&\fBAddressBarCommand\fR=\f(CW\*(C`/bin/sh\*(C'\fR when pressing \f(CW\*(C`Enter\*(C'\fR. +On \f(CW\*(C`Control+Enter\*(C'\fR this command is executed in a new terminal as given by \fBTerminalCommand\fR. -The address bar maintains a history that is navigable by the \fIUp\fR -and \fIDown\fR keys. -It supports command completion using \f(CW\*(C`Tab\*(C'\fR or \f(CW\*(C`Ctrl+I\*(C'\fR. -A rich set of editing operations is supported, -including cut\-/copy\-/paste\-operations. +.PP +Commands are executed relative to the working directory of icewm. +This can be shown by executing \f(CW\*(C`pwd\*(C'\fR. It can be changed using the \f(CW\*(C`cd\*(C'\fR +command. Without argument it defaults to the home directory. With one +argument it is changed. This argument is expanded when it starts with a +dollar or tilde. When it is equal to \f(CW\*(C`\-\*(C'\fR, it reverts to the previous +directory. +.PP +The address bar has a history that is navigable by \fIUp\fR and \fIDown\fR. +It supports file completion using \f(CW\*(C`Tab\*(C'\fR or \f(CW\*(C`Ctrl+I\*(C'\fR, cut/copy/paste +and these editing operations: +.IP "Ctrl+a: select all" 4 +.IX Item "Ctrl+a: select all" +.PD 0 +.IP "Ctrl+backslash: deselect all" 4 +.IX Item "Ctrl+backslash: deselect all" +.IP "Ctrl+u: delete selected or to line start" 4 +.IX Item "Ctrl+u: delete selected or to line start" +.IP "Ctrl+v: paste selected" 4 +.IX Item "Ctrl+v: paste selected" +.IP "Ctrl+w: delete selected or previous word" 4 +.IX Item "Ctrl+w: delete selected or previous word" +.IP "Ctrl+x: cut selection" 4 +.IX Item "Ctrl+x: cut selection" +.IP "Ctrl+c: copy selection" 4 +.IX Item "Ctrl+c: copy selection" +.IP "Ctrl+i: completion" 4 +.IX Item "Ctrl+i: completion" +.IP "Ctrl+Left: back a word" 4 +.IX Item "Ctrl+Left: back a word" +.IP "Ctrl+Right: forward a word" 4 +.IX Item "Ctrl+Right: forward a word" +.IP "Ctrl+Shift+Backspace: delete to beginning" 4 +.IX Item "Ctrl+Shift+Backspace: delete to beginning" +.IP "Ctrl+Shift+Delete: delete to end" 4 +.IX Item "Ctrl+Shift+Delete: delete to end" +.IP "Ctrl+Delete: delete word" 4 +.IX Item "Ctrl+Delete: delete word" +.IP "Ctrl+Backspace: delete previous word" 4 +.IX Item "Ctrl+Backspace: delete previous word" +.IP "Shift+Delete: cut selection" 4 +.IX Item "Shift+Delete: cut selection" +.IP "Shift+Insert: paste selected" 4 +.IX Item "Shift+Insert: paste selected" +.IP "Tab: completion" 4 +.IX Item "Tab: completion" +.IP "Left: move cursor left" 4 +.IX Item "Left: move cursor left" +.IP "Right: move cursor right" 4 +.IX Item "Right: move cursor right" +.IP "Home: move cursor to line start" 4 +.IX Item "Home: move cursor to line start" +.IP "End: move cursor to line end" 4 +.IX Item "End: move cursor to line end" +.IP "Delete: delete next character" 4 +.IX Item "Delete: delete next character" +.IP "Backspace: delete previous character" 4 +.IX Item "Backspace: delete previous character" +.PD .SS "WINDOW LIST" .IX Subsection "WINDOW LIST" The window list window shows a list of all workspaces. For each @@ -639,7 +696,7 @@ the option \fBKeyboardLayouts\fR to a comma-separated list of your preferred keyboard layouts. For example: .PP .Vb 1 -\& KeyboardLayouts="de","fr","jp" +\& KeyboardLayouts = "de", "fr", "jp" .Ve .PP A keyboard layout can simply be a name. Usually this is a two-letter @@ -1300,14 +1357,13 @@ two are the \fIx\-hotspot\fR and the \fIy\-hotspot\fR. These define which point in the XPM image is the sensitive point for the mouse pointer. .IP \fIicons\fR 4 .IX Item "icons" -Contains icons that are used to identify applications. Usually these -files are in the XPM format, but the PNG and SVG image formats are also -supported. The names of icon files may follow a specific naming -pattern, like \fIapp_32x32.xpm\fR. They start with a base name, usually -this is just a single word. Then follows an underscore, followed by a -size specification in the format \f(CW\*(C`SIZExSIZE\*(C'\fR. This is followed by a -dot and the file extension, where the extension denotes the icon image -format. Common sizes are 16, 32 and 48 for small, large and huge icons. +Contains icons for applications and keyboard layouts. These can be in +XPM, PNG or SVG format. The filename of an \fIapplication icon\fR may +follow a specific naming pattern, like \fIapp_32x32.xpm\fR. They start +with a base name, which usually is just a single word. Then follows +an underscore, followed by a size specification, as in \f(CW\*(C`SIZExSIZE\*(C'\fR. +This is followed by a dot and the file extension, where the extension +denotes the icon image format. Common sizes are 16, 32 and 48. This depends on the respective \f(CW\*(C`IconSize\*(C'\fR preferences options. .IP \fIledclock\fR 4 .IX Item "ledclock" diff --git a/upstream/fedora-rawhide/man1/icewmbg.1 b/upstream/fedora-rawhide/man1/icewmbg.1 index 8cfafc70..06396ac4 100644 --- a/upstream/fedora-rawhide/man1/icewmbg.1 +++ b/upstream/fedora-rawhide/man1/icewmbg.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWMBG 1" -.TH ICEWMBG 1 2024-01-24 "icewm\ 3.4.5" "User Commands" +.TH ICEWMBG 1 2024-05-20 "icewm\ 3.5.0" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -63,7 +63,7 @@ .SS NAME .IX Subsection "NAME" .Vb 1 -\& icewmbg \- a background settings manager for the IceWM window manager +\& icewmbg \- a desktop background image manager for IceWM .Ve .SS SYNOPSIS .IX Subsection "SYNOPSIS" @@ -76,8 +76,7 @@ its own background. .PP When the background image changes, \fBicewmbg\fR can be notified to update the background. When switching workspaces, it checks the image -file modification time. If the file has changed, it reloads the -image from file. +file modification time. If it has changed, it reloads the image. .PP \&\fBicewmbg\fR supports semitransparency. Semitransparent background images and colours can be configured. @@ -175,6 +174,9 @@ A leading tilde or environment variable is expanded. .IP \fB\-\-postpreferences\fR 4 .IX Item "--postpreferences" Print a list of all preference values that \fBicewmbg\fR will use. +.IP \fB\-\-verbose\fR 4 +.IX Item "--verbose" +Print a log of actions and some events. .SS "GENERAL OPTIONS" .IX Subsection "GENERAL OPTIONS" .IP "\fB\-d\fR, \fB\-\-display\fR=\fIDISPLAY\fR" 4 diff --git a/upstream/fedora-rawhide/man1/icewmhint.1 b/upstream/fedora-rawhide/man1/icewmhint.1 index ef5387ae..36bea19f 100644 --- a/upstream/fedora-rawhide/man1/icewmhint.1 +++ b/upstream/fedora-rawhide/man1/icewmhint.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWMHINT 1" -.TH ICEWMHINT 1 2024-01-24 "icewm\ 3.4.5" "User Commands" +.TH ICEWMHINT 1 2024-05-20 "icewm\ 3.5.0" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/iconv.1 b/upstream/fedora-rawhide/man1/iconv.1 index ffa84516..d1e10f83 100644 --- a/upstream/fedora-rawhide/man1/iconv.1 +++ b/upstream/fedora-rawhide/man1/iconv.1 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH iconv 1 2024-01-28 "Linux man-pages 6.06" +.TH iconv 1 2024-01-28 "Linux man-pages 6.7" .SH NAME iconv \- convert text from one character encoding to another .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/id.1 b/upstream/fedora-rawhide/man1/id.1 index 0d2fcbe0..8ab91dd7 100644 --- a/upstream/fedora-rawhide/man1/id.1 +++ b/upstream/fedora-rawhide/man1/id.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH ID "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH ID "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME id \- print real and effective user and group IDs .SH SYNOPSIS @@ -51,7 +51,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/importctl.1 b/upstream/fedora-rawhide/man1/importctl.1 new file mode 100644 index 00000000..584af873 --- /dev/null +++ b/upstream/fedora-rawhide/man1/importctl.1 @@ -0,0 +1,749 @@ +'\" t +.TH "IMPORTCTL" "1" "" "systemd 256~rc3" "importctl" +.\" ----------------------------------------------------------------- +.\" * 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" +importctl \- Download, import or export disk images +.SH "SYNOPSIS" +.HP \w'\fBimportctl\fR\ 'u +\fBimportctl\fR [OPTIONS...] {COMMAND} [NAME...] +.SH "DESCRIPTION" +.PP +\fBimportctl\fR +may be used to download, import, and export disk images via +\fBsystemd-importd.service\fR(8)\&. +.PP +\fBimportctl\fR +operates both on block\-level disk images (such as DDIs) as well as file\-system\-level images (tarballs)\&. It supports disk images are one of the four following classes: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +VM images or full OS container images, that may be run via +\fBsystemd-vmspawn\fR(1) +or +\fBsystemd-nspawn\fR(1), and managed via +\fBmachinectl\fR(1)\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Portable service images, that may be attached an managed via +\fBportablectl\fR(1)\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +System extension (sysext) images, that may be activated via +\fBsystemd-sysext\fR(8)\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Configuration extension (confext) images, that may be activated via +\fBsystemd-confext\fR(8)\&. +.RE +.PP +When images are downloaded or imported they are placed in the following directories, depending on the +\fB\-\-class=\fR +parameter: +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.B Table\ \&1.\ \&Classes and Directories +.TS +allbox tab(:); +lB lB. +T{ +Class +T}:T{ +Directory +T} +.T& +l l +l l +l l +l l. +T{ +"machine" +T}:T{ +/var/lib/machines/ +T} +T{ +"portable" +T}:T{ +/var/lib/portables/ +T} +T{ +"sysext" +T}:T{ +/var/lib/extensions/ +T} +T{ +"confext" +T}:T{ +/var/lib/confexts/ +T} +.TE +.sp 1 +.SH "COMMANDS" +.PP +The following commands are understood: +.PP +\fBpull\-tar\fR \fIURL\fR [\fINAME\fR] +.RS 4 +Downloads a +\&.tar +image from the specified URL, and makes it available under the specified local name in the image directory for the selected +\fB\-\-class=\fR\&. The URL must be of type +"http://" +or +"https://", and must refer to a +\&.tar, +\&.tar\&.gz, +\&.tar\&.xz +or +\&.tar\&.bz2 +archive file\&. If the local image name is omitted, it is automatically derived from the last component of the URL, with its suffix removed\&. +.sp +The image is verified before it is made available, unless +\fB\-\-verify=no\fR +is specified\&. Verification is done either via an inline signed file with the name of the image and the suffix +\&.sha256 +or via separate +SHA256SUMS +and +SHA256SUMS\&.gpg +files\&. The signature files need to be made available on the same web server, under the same URL as the +\&.tar +file\&. With +\fB\-\-verify=checksum\fR, only the SHA256 checksum for the file is verified, based on the +\&.sha256 +suffixed file or the +SHA256SUMS +file\&. With +\fB\-\-verify=signature\fR, the sha checksum file is first verified with the inline signature in the +\&.sha256 +file or the detached GPG signature file +SHA256SUMS\&.gpg\&. The public key for this verification step needs to be available in +/usr/lib/systemd/import\-pubring\&.gpg +or +/etc/systemd/import\-pubring\&.gpg\&. +.sp +If +\fB\-keep\-download=yes\fR +is specified the image will be downloaded and stored in a read\-only subvolume/directory in the image directory that is named after the specified URL and its HTTP etag\&. A writable snapshot is then taken from this subvolume, and named after the specified local name\&. This behavior ensures that creating multiple instances of the same URL is efficient, as multiple downloads are not necessary\&. In order to create only the read\-only image, and avoid creating its writable snapshot, specify +"\-" +as local name\&. +.sp +Note that pressing C\-c during execution of this command will not abort the download\&. Use +\fBcancel\-transfer\fR, described below\&. +.sp +Added in version 256\&. +.RE +.PP +\fBpull\-raw\fR \fIURL\fR [\fINAME\fR] +.RS 4 +Downloads a +\&.raw +disk image from the specified URL, and makes it available under the specified local name in the image directory for the selected +\fB\-\-class=\fR\&. The URL must be of type +"http://" +or +"https://"\&. The image must either be a +\&.qcow2 +or raw disk image, optionally compressed as +\&.gz, +\&.xz, or +\&.bz2\&. If the local name is omitted, it is automatically derived from the last component of the URL, with its suffix removed\&. +.sp +Image verification is identical for raw and tar images (see above)\&. +.sp +If the downloaded image is in +\&.qcow2 +format it is converted into a raw image file before it is made available\&. +.sp +If +\fB\-keep\-download=yes\fR +is specified the image will be downloaded and stored in a read\-only file in the image directory that is named after the specified URL and its HTTP etag\&. A writable copy is then made from this file, and named after the specified local name\&. This behavior ensures that creating multiple instances of the same URL is efficient, as multiple downloads are not necessary\&. In order to create only the read\-only image, and avoid creating its writable copy, specify +"\-" +as local name\&. +.sp +Note that pressing C\-c during execution of this command will not abort the download\&. Use +\fBcancel\-transfer\fR, described below\&. +.sp +Added in version 256\&. +.RE +.PP +\fBimport\-tar\fR \fIFILE\fR [\fINAME\fR], \fBimport\-raw\fR \fIFILE\fR [\fINAME\fR] +.RS 4 +Imports a TAR or RAW image, and places it under the specified name in the image directory for the image class selected via +\fB\-\-class=\fR\&. When +\fBimport\-tar\fR +is used, the file specified as the first argument should be a tar archive, possibly compressed with xz, gzip or bzip2\&. It will then be unpacked into its own subvolume/directory\&. When +\fBimport\-raw\fR +is used, the file should be a qcow2 or raw disk image, possibly compressed with xz, gzip or bzip2\&. If the second argument (the resulting image name) is not specified, it is automatically derived from the file name\&. If the filename is passed as +"\-", the image is read from standard input, in which case the second argument is mandatory\&. +.sp +No cryptographic validation is done when importing the images\&. +.sp +Much like image downloads, ongoing imports may be listed with +\fBlist\fR +and aborted with +\fBcancel\-transfer\fR\&. +.sp +Added in version 256\&. +.RE +.PP +\fBimport\-fs\fR \fIDIRECTORY\fR [\fINAME\fR] +.RS 4 +Imports an image stored in a local directory into the image directory for the image class selected via +\fB\-\-class=\fR +and operates similarly to +\fBimport\-tar\fR +or +\fBimport\-raw\fR, but the first argument is the source directory\&. If supported, this command will create a btrfs snapshot or subvolume for the new image\&. +.sp +Added in version 256\&. +.RE +.PP +\fBexport\-tar\fR \fINAME\fR [\fIFILE\fR], \fBexport\-raw\fR \fINAME\fR [\fIFILE\fR] +.RS 4 +Exports a TAR or RAW image and stores it in the specified file\&. The first parameter should be an image name\&. The second parameter should be a file path the TAR or RAW image is written to\&. If the path ends in +"\&.gz", the file is compressed with gzip, if it ends in +"\&.xz", with xz, and if it ends in +"\&.bz2", with bzip2\&. If the path ends in neither, the file is left uncompressed\&. If the second argument is missing, the image is written to standard output\&. The compression may also be explicitly selected with the +\fB\-\-format=\fR +switch\&. This is in particular useful if the second parameter is left unspecified\&. +.sp +Much like image downloads and imports, ongoing exports may be listed with +\fBlist\fR +and aborted with +\fBcancel\-transfer\fR\&. +.sp +Note that, currently, only directory and subvolume images may be exported as TAR images, and only raw disk images as RAW images\&. +.sp +Added in version 256\&. +.RE +.PP +\fBlist\-transfer\fR +.RS 4 +Shows a list of image downloads, imports and exports that are currently in progress\&. +.sp +Added in version 256\&. +.RE +.PP +\fBcancel\-transfer\fR \fIID\fR\&... +.RS 4 +Aborts a download, import or export of the image with the specified ID\&. To list ongoing transfers and their IDs, use +\fBlist\fR\&. +.sp +Added in version 256\&. +.RE +.PP +\fBlist\-images\fR +.RS 4 +Shows a list of already downloaded/imported images\&. +.sp +Added in version 256\&. +.RE +.SH "OPTIONS" +.PP +The following options are understood: +.PP +\fB\-\-read\-only\fR +.RS 4 +When used with +\fBpull\-raw\fR, +\fBpull\-tar\fR, +\fBimport\-raw\fR, +\fBimport\-tar\fR +or +\fBimport\-fs\fR +a read\-only image is created\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-verify=\fR +.RS 4 +When downloading an image, specify whether the image shall be verified before it is made available\&. Takes one of +"no", +"checksum" +and +"signature"\&. If +"no", no verification is done\&. If +"checksum" +is specified, the download is checked for integrity after the transfer is complete, but no signatures are verified\&. If +"signature" +is specified, the checksum is verified and the image\*(Aqs signature is checked against a local keyring of trustable vendors\&. It is strongly recommended to set this option to +"signature" +if the server and protocol support this\&. Defaults to +"signature"\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-force\fR +.RS 4 +When downloading an image, and a local copy by the specified local name already exists, delete it first and replace it by the newly downloaded image\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-format=\fR +.RS 4 +When used with the +\fBexport\-tar\fR +or +\fBexport\-raw\fR +commands, specifies the compression format to use for the resulting file\&. Takes one of +"uncompressed", +"xz", +"gzip", +"bzip2"\&. By default, the format is determined automatically from the output image file name passed\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-q\fR, \fB\-\-quiet\fR +.RS 4 +Suppresses additional informational output while running\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-H\fR, \fB\-\-host=\fR +.RS 4 +Execute the operation remotely\&. Specify a hostname, or a username and hostname separated by +"@", to connect to\&. The hostname may optionally be suffixed by a port ssh is listening on, separated by +":", and then a container name, separated by +"/", which connects directly to a specific container on the specified host\&. This will use SSH to talk to the remote machine manager instance\&. Container names may be enumerated with +\fBmachinectl \-H \fR\fB\fIHOST\fR\fR\&. Put IPv6 addresses in brackets\&. +.RE +.PP +\fB\-M\fR, \fB\-\-machine=\fR +.RS 4 +Connect to +\fBsystemd-import.service\fR(8) +running in a local container, to perform the specified operation within the container\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-class=\fR, \fB\-m\fR, \fB\-P\fR, \fB\-S\fR, \fB\-C\fR +.RS 4 +Selects the image class for the downloaded images\&. This primarily selects the directory to download into\&. The +\fB\-\-class=\fR +switch takes +"machine", +"portable", +"sysext" +or +"confext" +as argument\&. The short options +\fB\-m\fR, +\fB\-P\fR, +\fB\-S\fR, +\fB\-C\fR +are shortcuts for +\fB\-\-class=machine\fR, +\fB\-\-class=portable\fR, +\fB\-\-class=sysext\fR, +\fB\-\-class=confext\fR\&. +.sp +Note that +\fB\-\-keep\-download=\fR +defaults to true for +\fB\-\-class=machine\fR +and false otherwise, see below\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-keep\-download=\fR, \fB\-N\fR +.RS 4 +Takes a boolean argument\&. When specified with +\fBpull\-raw\fR +or +\fBpull\-tar\fR, selects whether to download directly into the specified local image name, or whether to download into a read\-only copy first of which to make a writable copy after the download is completed\&. Defaults to true for +\fB\-\-class=machine\fR, false otherwise\&. +.sp +The +\fB\-N\fR +switch is a shortcut for +\fB\-\-keep\-download=no\fR\&. +.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" +(for the shortest possible output without any redundant whitespace or line breaks), +"pretty" +(for a pretty version of the same, with indentation and line breaks) or +"off" +(to turn off JSON output, the default)\&. +.RE +.PP +\fB\-j\fR +.RS 4 +Equivalent to +\fB\-\-json=pretty\fR +if running on a terminal, and +\fB\-\-json=short\fR +otherwise\&. +.RE +.PP +\fB\-\-no\-pager\fR +.RS 4 +Do not pipe output into a pager\&. +.RE +.PP +\fB\-\-no\-legend\fR +.RS 4 +Do not print the legend, i\&.e\&. column headers and the footer with hints\&. +.RE +.PP +\fB\-\-no\-ask\-password\fR +.RS 4 +Do not query the user for authentication for privileged operations\&. +.RE +.PP +\fB\-h\fR, \fB\-\-help\fR +.RS 4 +Print a short help text and exit\&. +.RE +.PP +\fB\-\-version\fR +.RS 4 +Print a short version string and exit\&. +.RE +.SH "EXAMPLES" +.PP +\fBExample\ \&1.\ \&Download an Ubuntu TAR image and open a shell in it\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +# importctl pull\-tar \-mN https://cloud\-images\&.ubuntu\&.com/jammy/current/jammy\-server\-cloudimg\-amd64\-root\&.tar\&.xz +# systemd\-nspawn \-M jammy\-server\-cloudimg\-amd64\-root +.fi +.if n \{\ +.RE +.\} +.PP +This downloads and verifies the specified +\&.tar +image, and then uses +\fBsystemd-nspawn\fR(1) +to open a shell in it\&. +.PP +\fBExample\ \&2.\ \&Download an Ubuntu RAW image, set a root password in it, start it as a service\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +# importctl pull\-raw \-mN \e + https://cloud\-images\&.ubuntu\&.com/jammy/current/jammy\-server\-cloudimg\-amd64\-disk\-kvm\&.img \e + jammy +# systemd\-firstboot \-\-image=/var/lib/machines/jammy\&.raw \-\-prompt\-root\-password \-\-force +# machinectl start jammy +# machinectl login jammy +.fi +.if n \{\ +.RE +.\} +.PP +This downloads the specified +\&.raw +image and makes it available under the local name +"jammy"\&. Then, a root password is set with +\fBsystemd-firstboot\fR(1)\&. Afterwards the machine is started as system service\&. With the last command a login prompt into the container is requested\&. +.PP +\fBExample\ \&3.\ \&Exports a container image as tar file\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +# importctl export\-tar \-m fedora myfedora\&.tar\&.xz +.fi +.if n \{\ +.RE +.\} +.PP +Exports the container +"fedora" +as an xz\-compressed tar file +myfedora\&.tar\&.xz +into the current directory\&. +.SH "EXIT STATUS" +.PP +On success, 0 is returned, a non\-zero failure code otherwise\&. +.SH "ENVIRONMENT" +.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)\&. 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, +\fBerr\fR, +\fBwarning\fR, +\fBnotice\fR, +\fBinfo\fR, +\fBdebug\fR, or an integer in the range 0\&...7\&. See +\fBsyslog\fR(3) +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 +.RS 4 +A boolean\&. If true, messages written to the tty will be colored according to priority\&. +.sp +This setting is only useful when messages are written directly to the terminal, because +\fBjournalctl\fR(1) +and other tools that display logs will color messages based on the log level on their own\&. +.RE +.PP +\fI$SYSTEMD_LOG_TIME\fR +.RS 4 +A boolean\&. If true, console log messages will be prefixed with a timestamp\&. +.sp +This setting is only useful when messages are written directly to the terminal or a file, because +\fBjournalctl\fR(1) +and other tools that display logs will attach timestamps based on the entry metadata on their own\&. +.RE +.PP +\fI$SYSTEMD_LOG_LOCATION\fR +.RS 4 +A boolean\&. If true, messages will be prefixed with a filename and line number in the source code where the message originates\&. +.sp +Note that the log location is often attached as metadata to journal entries anyway\&. Including it directly in the message text can nevertheless be convenient when debugging programs\&. +.RE +.PP +\fI$SYSTEMD_LOG_TID\fR +.RS 4 +A boolean\&. If true, messages will be prefixed with the current numerical thread ID (TID)\&. +.sp +Note that the this information is attached as metadata to journal entries anyway\&. Including it directly in the message text can nevertheless be convenient when debugging programs\&. +.RE +.PP +\fI$SYSTEMD_LOG_TARGET\fR +.RS 4 +The destination for log messages\&. One of +\fBconsole\fR +(log to the attached tty), +\fBconsole\-prefixed\fR +(log to the attached tty but with prefixes encoding the log level and "facility", see +\fBsyslog\fR(3), +\fBkmsg\fR +(log to the kernel circular log buffer), +\fBjournal\fR +(log to the journal), +\fBjournal\-or\-kmsg\fR +(log to the journal if available, and to kmsg otherwise), +\fBauto\fR +(determine the appropriate log target automatically, the default), +\fBnull\fR +(disable log output)\&. +.RE +.PP +\fI$SYSTEMD_LOG_RATELIMIT_KMSG\fR +.RS 4 +Whether to ratelimit kmsg or not\&. Takes a boolean\&. Defaults to +"true"\&. If disabled, systemd will not ratelimit messages written to kmsg\&. +.RE +.PP +\fI$SYSTEMD_PAGER\fR +.RS 4 +Pager to use when +\fB\-\-no\-pager\fR +is not given; overrides +\fI$PAGER\fR\&. If neither +\fI$SYSTEMD_PAGER\fR +nor +\fI$PAGER\fR +are set, a set of well\-known pager implementations are tried in turn, including +\fBless\fR(1) +and +\fBmore\fR(1), until one is found\&. If no pager implementation is discovered no pager is invoked\&. Setting this environment variable to an empty string or the value +"cat" +is equivalent to passing +\fB\-\-no\-pager\fR\&. +.sp +Note: if +\fI$SYSTEMD_PAGERSECURE\fR +is not set, +\fI$SYSTEMD_PAGER\fR +(as well as +\fI$PAGER\fR) will be silently ignored\&. +.RE +.PP +\fI$SYSTEMD_LESS\fR +.RS 4 +Override the options passed to +\fBless\fR +(by default +"FRSXMK")\&. +.sp +Users might want to change two options in particular: +.PP +\fBK\fR +.RS 4 +This option instructs the pager to exit immediately when +Ctrl+C +is pressed\&. To allow +\fBless\fR +to handle +Ctrl+C +itself to switch back to the pager command prompt, unset this option\&. +.sp +If the value of +\fI$SYSTEMD_LESS\fR +does not include +"K", and the pager that is invoked is +\fBless\fR, +Ctrl+C +will be ignored by the executable, and needs to be handled by the pager\&. +.RE +.PP +\fBX\fR +.RS 4 +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\&. +.RE +.PP +\fI$SYSTEMD_LESSCHARSET\fR +.RS 4 +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 +.RS 4 +Takes a boolean argument\&. When true, the "secure" mode of the pager is enabled; if false, disabled\&. If +\fI$SYSTEMD_PAGERSECURE\fR +is not set at all, secure mode is enabled if the effective UID is not the same as the owner of the login session, see +\fBgeteuid\fR(2) +and +\fBsd_pid_get_owner_uid\fR(3)\&. In secure mode, +\fBLESSSECURE=1\fR +will be set when invoking the pager, and the pager shall disable commands that open or create new files or start new subprocesses\&. When +\fI$SYSTEMD_PAGERSECURE\fR +is not set at all, pagers which are not known to implement secure mode will not be used\&. (Currently only +\fBless\fR(1) +implements secure mode\&.) +.sp +Note: when commands are invoked with elevated privileges, for example under +\fBsudo\fR(8) +or +\fBpkexec\fR(1), care must be taken to ensure that unintended interactive features are not enabled\&. "Secure" mode for the pager may be enabled automatically as describe above\&. Setting +\fISYSTEMD_PAGERSECURE=0\fR +or not removing it from the inherited environment allows the user to invoke arbitrary commands\&. Note that if the +\fI$SYSTEMD_PAGER\fR +or +\fI$PAGER\fR +variables are to be honoured, +\fI$SYSTEMD_PAGERSECURE\fR +must be set too\&. It might be reasonable to completely disable the pager using +\fB\-\-no\-pager\fR +instead\&. +.RE +.PP +\fI$SYSTEMD_COLORS\fR +.RS 4 +Takes a boolean argument\&. When true, +\fBsystemd\fR +and related utilities will use colors in their output, otherwise the output will be monochrome\&. Additionally, the variable can take one of the following special values: +"16", +"256" +to restrict the use of colors to the base 16 or 256 ANSI colors, respectively\&. This can be specified to override the automatic decision based on +\fI$TERM\fR +and what the console is connected to\&. +.RE +.PP +\fI$SYSTEMD_URLIFY\fR +.RS 4 +The value must be a boolean\&. Controls whether clickable links should be generated in the output for terminal emulators supporting this\&. This can be specified to override the decision that +\fBsystemd\fR +makes based on +\fI$TERM\fR +and other conditions\&. +.RE +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), \fBsystemd-importd.service\fR(8), \fBsystemd-nspawn\fR(1), \fBsystemd-vmspawn\fR(1), \fBmachinectl\fR(1), \fBportablectl\fR(1), \fBsystemd-sysext\fR(8), \fBsystemd-confext\fR(8), \fBtar\fR(1), \fBxz\fR(1), \fBgzip\fR(1), \fBbzip2\fR(1) diff --git a/upstream/fedora-rawhide/man1/install.1 b/upstream/fedora-rawhide/man1/install.1 index 9a24e8e0..35d87063 100644 --- a/upstream/fedora-rawhide/man1/install.1 +++ b/upstream/fedora-rawhide/man1/install.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH INSTALL "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH INSTALL "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME install \- copy files and set attributes .SH SYNOPSIS @@ -124,7 +124,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/intro.1 b/upstream/fedora-rawhide/man1/intro.1 index 38dd27ed..bf8a1fe6 100644 --- a/upstream/fedora-rawhide/man1/intro.1 +++ b/upstream/fedora-rawhide/man1/intro.1 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH intro 1 2023-10-31 "Linux man-pages 6.06" +.TH intro 1 2023-10-31 "Linux man-pages 6.7" .SH NAME intro \- introduction to user commands .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man1/join.1 b/upstream/fedora-rawhide/man1/join.1 index 76e2b159..146d299d 100644 --- a/upstream/fedora-rawhide/man1/join.1 +++ b/upstream/fedora-rawhide/man1/join.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH JOIN "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH JOIN "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME join \- join lines of two files on a common field .SH SYNOPSIS @@ -73,7 +73,7 @@ line of each file determines the number of fields output for each line. Important: FILE1 and FILE2 must be sorted on the join fields. E.g., use "sort \fB\-k\fR 1b,1" if 'join' has no options, or use "join \fB\-t\fR ''" if 'sort' has no options. -Note, comparisons honor the rules specified by 'LC_COLLATE'. +Comparisons honor the rules specified by 'LC_COLLATE'. If the input is not sorted and some lines cannot be joined, a warning message will be given. .SH AUTHOR @@ -83,7 +83,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/journalctl.1 b/upstream/fedora-rawhide/man1/journalctl.1 index 16dd0e82..89b3a8bc 100644 --- a/upstream/fedora-rawhide/man1/journalctl.1 +++ b/upstream/fedora-rawhide/man1/journalctl.1 @@ -1,5 +1,5 @@ '\" t -.TH "JOURNALCTL" "1" "" "systemd 255" "journalctl" +.TH "JOURNALCTL" "1" "" "systemd 256~rc3" "journalctl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -63,8 +63,8 @@ being shown\&. The set of journal files which will be used can be modified using the \fB\-\-user\fR, \fB\-\-system\fR, -\fB\-\-directory\fR, and -\fB\-\-file\fR +\fB\-\-directory=\fR, and +\fB\-\-file=\fR options, see below\&. .PP All users are granted access to their private per\-user journals\&. However, by default, only root and users who are members of a few special groups are granted access to the system journal and the journals of other users\&. Members of the groups @@ -139,7 +139,7 @@ instead of the default runtime and system journal paths\&. Added in version 187\&. .RE .PP -\fB\-\-file=\fR\fB\fIGLOB\fR\fR +\fB\-i \fR\fB\fIGLOB\fR\fR, \fB\-\-file=\fR\fB\fIGLOB\fR\fR .RS 4 Takes a file glob as an argument\&. If specified, journalctl will operate on the specified journal files matching \fIGLOB\fR @@ -278,7 +278,7 @@ the boot before last, and so on\&. An empty \fIoffset\fR is equivalent to specifying \fB\-0\fR, except when the current boot is not the last boot (e\&.g\&. because -\fB\-\-directory\fR +\fB\-\-directory=\fR was specified to look at logs from a different machine)\&. .sp If the 32\-character @@ -349,6 +349,16 @@ This parameter can be specified multiple times\&. Added in version 217\&. .RE .PP +\fB\-T\fR, \fB\-\-exclude\-identifier=\fR\fB\fISYSLOG_IDENTIFIER\fR\fR +.RS 4 +Exclude messages for the specified syslog identifier +\fISYSLOG_IDENTIFIER\fR\&. +.sp +This parameter can be specified multiple times\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-p\fR, \fB\-\-priority=\fR .RS 4 Filter output by message priorities or priority ranges\&. Takes either a single numeric or textual log level (i\&.e\&. between 0/"emerg" @@ -789,7 +799,7 @@ Added in version 206\&. .RE .SH "COMMANDS" .PP -The following commands are understood\&. If none is specified the default is to display journal records\&. +The following commands are understood\&. If none is specified the default is to display journal records: .PP \fB\-N\fR, \fB\-\-fields\fR .RS 4 @@ -807,7 +817,13 @@ Added in version 195\&. .PP \fB\-\-list\-boots\fR .RS 4 -Show a tabular list of boot numbers (relative to the current boot), their IDs, and the timestamps of the first and last message pertaining to the boot\&. +Show a tabular list of boot numbers (relative to the current boot), their IDs, and the timestamps of the first and last message pertaining to the boot\&. When specified with +\fB\-n/\-\-lines=\fR\fB[+]\fR\fB\fIN\fR\fR +option, only the first (when the number prefixed with +"+") or the last (without prefix) +\fIN\fR +entries will be shown\&. When specified with +\fB\-r/\-\-reverse\fR, the list will be shown in the reverse order\&. .sp Added in version 209\&. .RE @@ -1003,7 +1019,7 @@ On success, 0 is returned; otherwise, a non\-zero failure code is returned\&. .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, @@ -1013,7 +1029,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 @@ -1132,6 +1156,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\&. @@ -1143,6 +1173,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 @@ -1326,16 +1362,7 @@ journalctl \-f \-u apache .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-cat\fR(1), -\fBsystemd-journald.service\fR(8), -\fBsystemctl\fR(1), -\fBcoredumpctl\fR(1), -\fBsystemd.journal-fields\fR(7), -\fBjournald.conf\fR(5), -\fBsystemd.time\fR(7), -\fBsystemd-journal-remote.service\fR(8), -\fBsystemd-journal-upload.service\fR(8) +\fBsystemd\fR(1), \fBsystemd-cat\fR(1), \fBsystemd-journald.service\fR(8), \fBsystemctl\fR(1), \fBcoredumpctl\fR(1), \fBsystemd.journal-fields\fR(7), \fBjournald.conf\fR(5), \fBsystemd.time\fR(7), \fBsystemd-journal-remote.service\fR(8), \fBsystemd-journal-upload.service\fR(8) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man1/ld.1 b/upstream/fedora-rawhide/man1/ld.1 index eae5f105..70f22945 100644 --- a/upstream/fedora-rawhide/man1/ld.1 +++ b/upstream/fedora-rawhide/man1/ld.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "LD 1" -.TH LD 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH LD 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -934,12 +934,22 @@ a linker bug report. .PD Use \fIscriptfile\fR as the linker script. This script replaces \&\fBld\fR's default linker script (rather than adding to it), -unless the script contains \f(CW\*(C`INSERT\*(C'\fR, so -\&\fIcommandfile\fR must specify everything necessary to describe the -output file. If \fIscriptfile\fR does not exist in -the current directory, \f(CW\*(C`ld\*(C'\fR looks for it in the directories -specified by any preceding \fB\-L\fR options. Multiple \fB\-T\fR -options accumulate. +unless the script contains \f(CW\*(C`INSERT\*(C'\fR, so \fIcommandfile\fR must +specify everything necessary to describe the output file. +.Sp +If \fIscriptfile\fR does not exist in the current directory, \f(CW\*(C`ld\*(C'\fR +looks for it in the directories specified by any preceding \fB\-L\fR +options. +.Sp +Command line options that appear before the \fB\-T\fR option can +affect the script, but command line options that appear after it do +not. +.Sp +Multiple \fB\-T\fR options will accumulate if they are augmenting the +current script, otherwise the last, non-augmenting, \fB\-T\fR option +will be used. +.Sp +There are other ways of specifying linker scripts. See .IP "\fB\-dT\fR \fIscriptfile\fR" 4 .IX Item "-dT scriptfile" .PD 0 @@ -2089,12 +2099,13 @@ the i386 PE and ELF targetted ports of the linker. .IP \fB\-\-pic\-executable\fR 4 .IX Item "--pic-executable" .PD -Create a position independent executable. This is currently only supported on -ELF platforms. Position independent executables are similar to shared -libraries in that they are relocated by the dynamic linker to the virtual -address the OS chooses for them (which can vary between invocations). Like -normal dynamically linked executables they can be executed and symbols -defined in the executable cannot be overridden by shared libraries. +Create a position independent executable. This is currently only +supported on ELF platforms. Position independent executables are +relocated by the dynamic linker to the virtual address the OS chooses +for them, which can vary between invocations. They are marked ET_DYN +in the ELF file header, but differ from shared libraries in a number +of ways. In particular, defined symbols in a PIE by default can not +be overridden by another object as they can be in a shared library. .IP \fB\-no\-pie\fR 4 .IX Item "-no-pie" Create a position dependent executable. This is the default. @@ -2180,11 +2191,11 @@ of the input files. When the linker encounters such a dependency when doing a non-shared, non-relocatable link, it will automatically try to locate the required shared library and include it in the link, if it is not included -explicitly. In such a case, the \fB\-rpath\-link\fR option -specifies the first set of directories to search. The -\&\fB\-rpath\-link\fR option may specify a sequence of directory names -either by specifying a list of names separated by colons, or by -appearing multiple times. +explicitly. In such a case, several directories are searched as +described below. The \fB\-rpath\-link\fR option specifies the first +set of directories to search. This option may specify a sequence of +directory names either by providing a list of names separated by +colons, or by appearing multiple times. .Sp The tokens \fR\f(CI$ORIGIN\fR\fI\fR and \fI\fR\f(CI$LIB\fR\fI\fR can appear in these search directories. They will be replaced by the full path to the directory @@ -2196,13 +2207,18 @@ The alternative form of these tokens \- \fI${ORIGIN}\fR and \&\fI${LIB}\fR can also be used. The token \fR\f(CI$PLATFORM\fR\fI\fR is not supported. .Sp -This option should be used with caution as it overrides the search path -that may have been hard compiled into a shared library. In such a case it -is possible to use unintentionally a different search path than the -runtime linker would do. -.Sp -The linker uses the following search paths to locate required shared -libraries: +The \fB\-\-rpath\-link\fR option should be used with caution as it +overrides the search path that may have been hard compiled into a +shared library. In such a case it is possible to unintentionally use +a different search path than the runtime linker would have used. +.Sp +When additional shared libraries are required, the linker will search +directories in the order listed below in order to find them. Note +however that this only applies to additional libraries needed to +satisfy already included shared libraries. It does \fInot\fR +apply to libraries that are included via the \fB\-l\fR command line +option. Searches for \fB\-l\fR libraries are only conducted in +directories specified by the \fB\-L\fR option .RS 4 .IP 1. 4 Any directories specified by \fB\-rpath\-link\fR options. @@ -2266,6 +2282,49 @@ of the first. If the required shared library is not found, the linker will issue a warning and continue with the link. .RE +.IP \fB\-\-section\-ordering\-file=\fR\fIscript\fR 4 +.IX Item "--section-ordering-file=script" +This option is used to augment the current linker script with +additional mapping of input sections to output sections. This file +must use the same syntax for \f(CW\*(C`SECTIONS\*(C'\fR as is used in normal +linker scripts, but it should not do anything other than place input +sections into output sections. \f(CW@pxref\fR{SECTIONS} +.Sp +A second constraint on the section ordering script is that it can only +reference output sections that are already defined by whichever linker +script is currently in use. (Ie the default linker script or a script +specified on the command line). The benefit of the section ordering +script however is that the input sections are mapped to the start of +the output sections, so that they can ensure the ordering of sections +in the output section. For example, imagine that the default linker +script looks like this: +.Sp +.Vb 4 +\& SECTIONS { +\& .text : { *(.text.hot) ; *(.text .text.*) } +\& .data : { *(.data.big) ; *(.data .data.*) } +\& } +.Ve +.Sp +Then if a section ordering file like this is used: +.Sp +.Vb 2 +\& .text : { *(.text.first) ; *(.text.z*) } +\& .data : { foo.o(.data.first) ; *(.data.small) } +.Ve +.Sp +This would be equivalent to a linker script like this: +.Sp +.Vb 4 +\& SECTIONS { +\& .text : { *(.text.first) ; *(.text.z*) ; *(.text.hot) ; *(.text .text.*) } +\& .data : { foo.o(.data.first) ; *(.data.small) ; *(.data.big) ; *(.data .data.*) } +\& } +.Ve +.Sp +The advantage of the section ordering file is that it can be used to +order those sections that matter to the user without having to worry +about any other sections, or memory regions, or anything else. .IP \fB\-shared\fR 4 .IX Item "-shared" .PD 0 diff --git a/upstream/fedora-rawhide/man1/ldd.1 b/upstream/fedora-rawhide/man1/ldd.1 index 54391aaa..7375d99e 100644 --- a/upstream/fedora-rawhide/man1/ldd.1 +++ b/upstream/fedora-rawhide/man1/ldd.1 @@ -8,7 +8,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH ldd 1 2023-10-31 "Linux man-pages 6.06" +.TH ldd 1 2023-10-31 "Linux man-pages 6.7" .SH NAME ldd \- print shared object dependencies .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/link.1 b/upstream/fedora-rawhide/man1/link.1 index 29021822..2a7feffd 100644 --- a/upstream/fedora-rawhide/man1/link.1 +++ b/upstream/fedora-rawhide/man1/link.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH LINK "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH LINK "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME link \- call the link function to create a link to a file .SH SYNOPSIS @@ -25,7 +25,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/ln.1 b/upstream/fedora-rawhide/man1/ln.1 index 046105dd..dd77ca74 100644 --- a/upstream/fedora-rawhide/man1/ln.1 +++ b/upstream/fedora-rawhide/man1/ln.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH LN "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH LN "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME ln \- make links between files .SH SYNOPSIS @@ -36,7 +36,7 @@ like \fB\-\-backup\fR but does not accept an argument .TP \fB\-d\fR, \fB\-F\fR, \fB\-\-directory\fR allow the superuser to attempt to hard link -directories (note: will probably fail due to +directories (this will probably fail due to system restrictions, even for the superuser) .TP \fB\-f\fR, \fB\-\-force\fR @@ -105,7 +105,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/locale.1 b/upstream/fedora-rawhide/man1/locale.1 index 9b7384c4..2e71e68d 100644 --- a/upstream/fedora-rawhide/man1/locale.1 +++ b/upstream/fedora-rawhide/man1/locale.1 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH locale 1 2023-10-31 "Linux man-pages 6.06" +.TH locale 1 2023-10-31 "Linux man-pages 6.7" .SH NAME locale \- get locale-specific information .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/localectl.1 b/upstream/fedora-rawhide/man1/localectl.1 index f4bdf58c..147d68af 100644 --- a/upstream/fedora-rawhide/man1/localectl.1 +++ b/upstream/fedora-rawhide/man1/localectl.1 @@ -1,5 +1,5 @@ '\" t -.TH "LOCALECTL" "1" "" "systemd 255" "localectl" +.TH "LOCALECTL" "1" "" "systemd 256~rc3" "localectl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -39,8 +39,7 @@ The system locale controls the language settings of system services and of the U The keyboard settings control the keyboard layout used on the text console and of the graphical UI before the user logs in, such as the display manager, as well as the default for users after login\&. .PP Note that the changes performed using this tool might require the initrd to be rebuilt to take effect during early system boot\&. The initrd is not rebuilt automatically by -localectl, this task has to be performed manually, usually using a tool like -\fBdracut\fR(8)\&. +localectl, this task has to be performed manually, usually by reinstalling the distribution\*(Aqs kernel package\&. .PP Note that \fBsystemd-firstboot\fR(1) @@ -190,7 +189,7 @@ On success, 0 is returned, a non\-zero failure code otherwise\&. .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, @@ -200,7 +199,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 @@ -319,6 +326,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\&. @@ -330,6 +343,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 @@ -385,17 +404,7 @@ and other conditions\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBlocale\fR(7), -\fBlocale.conf\fR(5), -\fBvconsole.conf\fR(5), -\fBloadkeys\fR(1), -\fBkbd\fR(4), -\m[blue]\fBThe XKB Configuration Guide\fR\m[]\&\s-2\u[1]\d\s+2, -\fBsystemctl\fR(1), -\fBsystemd-localed.service\fR(8), -\fBsystemd-firstboot\fR(1), -\fBdracut\fR(8) +\fBsystemd\fR(1), \fBlocale\fR(7), \fBlocale.conf\fR(5), \fBvconsole.conf\fR(5), \fBloadkeys\fR(1), \fBkbd\fR(4), \m[blue]\fBThe XKB Configuration Guide\fR\m[]\&\s-2\u[1]\d\s+2, \fBsystemctl\fR(1), \fBsystemd-localed.service\fR(8), \fBsystemd-firstboot\fR(1) .SH "NOTES" .IP " 1." 4 The XKB Configuration Guide diff --git a/upstream/fedora-rawhide/man1/localedef.1 b/upstream/fedora-rawhide/man1/localedef.1 index de63c617..8326b928 100644 --- a/upstream/fedora-rawhide/man1/localedef.1 +++ b/upstream/fedora-rawhide/man1/localedef.1 @@ -12,7 +12,7 @@ .\" Lars Wirzenius to document new functionality (as of GNU .\" C library 2.3.5). .\" -.TH localedef 1 2023-10-31 "Linux man-pages 6.06" +.TH localedef 1 2023-10-31 "Linux man-pages 6.7" .SH NAME localedef \- compile locale definition files .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/locate.1 b/upstream/fedora-rawhide/man1/locate.1 deleted file mode 100644 index ef9ccf2d..00000000 --- a/upstream/fedora-rawhide/man1/locate.1 +++ /dev/null @@ -1,270 +0,0 @@ -.\" A man page for locate(1). -*- nroff -*- -.\" -.\" Copyright (C) 2012 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 locate 1 "Sep 2012" mlocate - -.SH NAME -locate \- find files by name - -.SH SYNOPSIS - -\fBlocate\fR [\fIOPTION\fR]... \fIPATTERN\fR... - -.SH DESCRIPTION -.B locate -reads one or more databases prepared by -.BR updatedb (8) -and writes file names matching at least one of the \fIPATTERN\fRs to standard -output, one per line. - -If -.B \-\-regex -is not specified, -\fIPATTERN\fRs can contain globbing characters. -If any -.I PATTERN -contains no globbing characters, -.B locate -behaves as if the pattern were \fB*\fIPATTERN\fB*\fR. - -By default, -.B locate -does not check whether files found in database still exist -(but it does require all parent directories to exist -if the database was built with \fB\-\-require\-visibility no\fR). -.B locate -can never report files created after the most recent update of the relevant -database. - -.SH EXIT STATUS -.B locate -exits with status 0 if any match was found or if -.B locate -was invoked with one of the \fB\-\-limit 0\fR, \fB\-\-help\fR, -.B \-\-statistics -or -.B \-\-version -options. -If no match was found or a fatal error was encountered, -.B locate -exits with status 1. - -Errors encountered while reading a database are not fatal, -search continues in other specified databases, if any. - -.SH OPTIONS -.TP -\fB\-A\fR, \fB\-\-all\fR -Print only entries that match all \fIPATTERN\fRs -instead of requiring only one of them to match. - -.TP -\fB\-b\fR, \fB\-\-basename\fR -Match only the base name against the specified patterns. -This is the opposite of \fB\-\-wholename\fR. - -.TP -\fB\-c\fR, \fB\-\-count\fR -Instead of writing file names on standard output, -write the number of matching entries only. - -.TP -\fB\-d, \fB\-\-database\fR \fIDBPATH\fR -Replace the default database with \fIDBPATH\fR. -.I DBPATH -is a \fB:\fR-separated list of database file names. -If more than one -.B \-\-database -option is specified, -the resulting path is a concatenation of the separate paths. - -An empty database file name is replaced by the default database. -A database file name -.B \- -refers to the standard input. -Note that a database can be read from the standard input only once. - -.TP -\fB\-e\fR, \fB\-\-existing\fR -Print only entries that refer to files existing at the time -.B locate -is run. - -.TP -\fB\-L\fR, \fB\-\-follow\fR -When checking whether files exist (if the -.B \-\-existing -option is specified), -follow trailing symbolic links. -This causes broken symbolic links to be omitted from the output. - -This is the default behavior. -The opposite can be specified using \fB\-\-nofollow\fR. - -.TP -\fB\-h\fR, \fB\-\-help\fR -Write a summary of the available options to standard output -and exit successfully. - -.TP -\fB\-i\fR, \fB\-\-ignore\-case\fR -Ignore case distinctions when matching patterns. - -.TP -\fB\-l\fR, \fB\-\-limit\fR, \fB\-n\fR \fILIMIT\fR -Exit successfully after finding -.I LIMIT -entries. -If the -.B \-\-count -option is specified, -the resulting count is also limited to \fILIMIT\fR. - -.TP -\fB\-m\fR, \fB\-\-mmap\fR -Ignored, for compatibility with -.SM BSD -and -.SM GNU -\fBlocate\fR. - -.TP -\fB\-P\fR, \fB\-\-nofollow\fR, \fB\-H\fR -When checking whether files exist (if the -.B \-\-existing -option is specified), -do not follow trailing symbolic links. -This causes broken symbolic links to be reported like other files. - -This is the opposite of \fB\-\-follow\fR. - -.TP -\fB\-0\fR, \fB\-\-null\fR -Separate the entries on output using the -.SM ASCII NUL -character instead of -writing each entry on a separate line. -This option is designed for interoperability with the -.B \-\-null -option of -.SM GNU -.BR xargs (1). - -.TP -\fB\-S\fR, \fB\-\-statistics\fR -Write statistics about each read database to standard output instead of -searching for files -and exit successfully. - -.TP -\fB\-q\fR, \fB\-\-quiet\fR -Write no messages about errors encountered while reading and processing -databases. - -.TP -\fB\-r\fR, \fB\-\-regexp\fR \fIREGEXP\fR -Search for a basic regexp \fIREGEXP\fR. -No \fIPATTERN\fRs are allowed if this option is used, -but this option can be specified multiple times. - -.TP -\fB\-\-regex\fR -Interpret all \fIPATTERN\fRs as extended regexps. - -.TP -\fB\-s\fR, \fB\-\-stdio\fR -Ignored, for compatibility with -.SM BSD -and -.SM GNU -\fBlocate\fR. - -.TP -\fB\-V\fR, \fB\-\-version\fR -Write information about the version and license of -.B locate -on standard output and exit successfully. - -.TP -\fB\-w\fR, \fB\-\-wholename\fR -Match only the whole path name against the specified patterns. - -This is the default behavior. -The opposite can be specified using \fB\-\-basename\fR. - -.SH EXAMPLES -To search for a file named exactly -.I NAME -(not \fB*\fINAME\fB*\fR), use -.RS -.B locate -b -\fB'\\\fINAME\fB'\fR -.RE -Because \fB\\\fR is a globbing character, -this disables the implicit replacement of -.I NAME -by \fB*\fINAME\fB*\fR. - -.SH FILES -.TP -\fB/var/lib/mlocate/mlocate.db\fR -The database searched by default. - -.SH ENVIRONMENT -.TP -\fBLOCATE_PATH\fR -Path to additional databases, -added after the default database or the databases specified using the -.B \-\-database -option. - -.SH NOTES -The order in which the requested databases are processed is unspecified, -which allows -.B locate -to reorder the database path for security reasons. - -.B locate -attempts to be compatible to -.B slocate -(without the options used for creating databases) and -.SM GNU -\fBlocate\fR, in that order. -This is the reason for the impractical default \fB\-\-follow\fR option -and for the confusing set of \fB\-\-regex\fR and \fB\-\-regexp\fR options. - -The short spelling of the \fB\-r\fR option is incompatible to -.SM GNU -\fBlocate\fR, -where it corresponds to the \fB\-\-regex\fR option. -Use the long option names to avoid confusion. - -The -.B LOCATE_PATH -environment variable replaces the default database in -.SM BSD -and -.SM GNU -\fBlocate\fR, -but it is added to other databases in this implementation and \fBslocate\fR. - -.SH AUTHOR -Miloslav Trmac <mitr@redhat.com> - -.SH SEE ALSO -.BR updatedb (8) diff --git a/upstream/fedora-rawhide/man1/loginctl.1 b/upstream/fedora-rawhide/man1/loginctl.1 index 1670c1ba..fca4dd32 100644 --- a/upstream/fedora-rawhide/man1/loginctl.1 +++ b/upstream/fedora-rawhide/man1/loginctl.1 @@ -1,5 +1,5 @@ '\" t -.TH "LOGINCTL" "1" "" "systemd 255" "loginctl" +.TH "LOGINCTL" "1" "" "systemd 256~rc3" "loginctl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -38,7 +38,11 @@ The following commands are understood: .PP \fBlist\-sessions\fR .RS 4 -List current sessions\&. +List current sessions\&. The JSON format output can be toggled using +\fB\-\-json=\fR +or +\fB\-j\fR +option\&. .RE .PP \fBsession\-status\fR [\fIID\fR\&...] @@ -110,7 +114,11 @@ Added in version 233\&. .PP \fBlist\-users\fR .RS 4 -List currently logged in users\&. +List currently logged in users\&. The JSON format output can be toggled using +\fB\-\-json=\fR +or +\fB\-j\fR +option\&. .RE .PP \fBuser\-status\fR [\fIUSER\fR\&...] @@ -165,7 +173,11 @@ Added in version 233\&. .PP \fBlist\-seats\fR .RS 4 -List currently available seats on the local system\&. +List currently available seats on the local system\&. The JSON format output can be toggled using +\fB\-\-json=\fR +or +\fB\-j\fR +option\&. .RE .PP \fBseat\-status\fR [\fINAME\fR\&...] @@ -339,6 +351,26 @@ 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\fB\fIMODE\fR\fR +.RS 4 +Shows output formatted as JSON\&. Expects one of +"short" +(for the shortest possible output without any redundant whitespace or line breaks), +"pretty" +(for a pretty version of the same, with indentation and line breaks) or +"off" +(to turn off JSON output, the default)\&. +.RE +.PP +\fB\-j\fR +.RS 4 +Equivalent to +\fB\-\-json=pretty\fR +if running on a terminal, and +\fB\-\-json=short\fR +otherwise\&. +.RE +.PP \fB\-h\fR, \fB\-\-help\fR .RS 4 Print a short help text and exit\&. @@ -386,7 +418,7 @@ There are two sessions, 3 and 5\&. Session 3 is a graphical session, marked with .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, @@ -396,7 +428,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 @@ -515,6 +555,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\&. @@ -526,6 +572,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 @@ -581,7 +633,4 @@ and other conditions\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd-logind.service\fR(8), -\fBlogind.conf\fR(5) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-logind.service\fR(8), \fBlogind.conf\fR(5) diff --git a/upstream/fedora-rawhide/man1/logname.1 b/upstream/fedora-rawhide/man1/logname.1 index e58ce0c8..06d13b31 100644 --- a/upstream/fedora-rawhide/man1/logname.1 +++ b/upstream/fedora-rawhide/man1/logname.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH LOGNAME "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH LOGNAME "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME logname \- print user\'s login name .SH SYNOPSIS @@ -22,7 +22,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/ls.1 b/upstream/fedora-rawhide/man1/ls.1 index 55caafad..21579502 100644 --- a/upstream/fedora-rawhide/man1/ls.1 +++ b/upstream/fedora-rawhide/man1/ls.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH LS "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH LS "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME ls \- list directory contents .SH SYNOPSIS @@ -51,7 +51,7 @@ list directories themselves, not their contents generate output designed for Emacs' dired mode .TP \fB\-f\fR -list all entries in directory order +do not sort, enable \fB\-aU\fR, disable \fB\-ls\fR \fB\-\-color\fR .TP \fB\-F\fR, \fB\-\-classify\fR[=\fI\,WHEN\/\fR] append indicator (one of */=>@|) to entries WHEN @@ -254,7 +254,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/lynx.1 b/upstream/fedora-rawhide/man1/lynx.1 index 464078d2..ae704a3c 100644 --- a/upstream/fedora-rawhide/man1/lynx.1 +++ b/upstream/fedora-rawhide/man1/lynx.1 @@ -1,6 +1,6 @@ -.\" $LynxId: lynx.man,v 1.147 2024/01/14 20:53:14 tom Exp $ +.\" $LynxId: lynx.man,v 1.160 2024/04/15 20:53:51 tom Exp $ .\" ************************************************************************** -.TH LYNX 1 2024-01-14 "Lynx 2.9.0" "Lynx \(en the \fItext\fP web browser" +.TH LYNX 1 2024-04-15 "Lynx 2.9.1" "Lynx \(en the \fItext\fP web browser" . .ie \n(.g \{\ .ds `` \(lq @@ -836,7 +836,7 @@ URL may be given as \*(``proxy.example.com\*('', \*(``proxy.example.com:1080\*('', \*(``192.168.0.1\*('', or \*(``192.168.0.1:1080\*('' (and IPv6 notation if so supported). A SOCKS5 proxy may also be specified via the environment variable -.B SOCKS5_PROXY. +.BR SOCKS5_PROXY . This option controls the builtin SOCKS5 support, which is unrelated to the option \fB\-nosocks\fP. .TP diff --git a/upstream/fedora-rawhide/man1/machinectl.1 b/upstream/fedora-rawhide/man1/machinectl.1 index 0fdde67e..d7de1edb 100644 --- a/upstream/fedora-rawhide/man1/machinectl.1 +++ b/upstream/fedora-rawhide/man1/machinectl.1 @@ -1,5 +1,5 @@ '\" t -.TH "MACHINECTL" "1" "" "systemd 255" "machinectl" +.TH "MACHINECTL" "1" "" "systemd 256~rc3" "machinectl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -128,6 +128,10 @@ Similarly, block devices containing MBR or GPT partition tables and file systems .\} The file system tree of the host OS itself\&. .RE +.PP +Images may be downloaded, imported and exported via the +\fBimportctl\fR(1) +tool\&. .SH "COMMANDS" .PP The following commands are understood: @@ -299,7 +303,10 @@ Added in version 212\&. .PP \fBreboot\fR \fINAME\fR\&... .RS 4 -Reboot one or more containers\&. This will trigger a reboot by sending SIGINT to the container\*(Aqs init process, which is roughly equivalent to pressing Ctrl+Alt+Del on a non\-containerized system, and is compatible with containers running any system manager\&. +Reboot one or more containers\&. This will trigger a reboot by sending SIGINT to the container\*(Aqs init process, which is roughly equivalent to pressing Ctrl+Alt+Del on a non\-containerized system, and is compatible with containers running any system manager\&. Use +\fBrestart\fR +as alias for +\fBreboot\fR\&. .sp Added in version 209\&. .RE @@ -470,191 +477,47 @@ switch removes all images, not just hidden ones\&. This command effectively empt /var/lib/machines/\&. .sp Note that commands such as -\fBmachinectl pull\-tar\fR +\fBimportctl pull\-tar\fR or -\fBmachinectl pull\-raw\fR +\fBimportctl pull\-raw\fR usually create hidden, read\-only, unmodified machine images from the downloaded image first, before cloning a writable working copy of it, in order to avoid duplicate downloads in case of images that are reused multiple times\&. Use \fBmachinectl clean\fR to remove old, hidden images created this way\&. .sp Added in version 230\&. .RE -.SS "Image Transfer Commands" -.PP -\fBpull\-tar\fR \fIURL\fR [\fINAME\fR] -.RS 4 -Downloads a -\&.tar -container image from the specified URL, and makes it available under the specified local machine name\&. The URL must be of type -"http://" -or -"https://", and must refer to a -\&.tar, -\&.tar\&.gz, -\&.tar\&.xz -or -\&.tar\&.bz2 -archive file\&. If the local machine name is omitted, it is automatically derived from the last component of the URL, with its suffix removed\&. -.sp -The image is verified before it is made available, unless -\fB\-\-verify=no\fR -is specified\&. Verification is done either via an inline signed file with the name of the image and the suffix -\&.sha256 -or via separate -SHA256SUMS -and -SHA256SUMS\&.gpg -files\&. The signature files need to be made available on the same web server, under the same URL as the -\&.tar -file\&. With -\fB\-\-verify=checksum\fR, only the SHA256 checksum for the file is verified, based on the -\&.sha256 -suffixed file or the -SHA256SUMS -file\&. With -\fB\-\-verify=signature\fR, the sha checksum file is first verified with the inline signature in the -\&.sha256 -file or the detached GPG signature file -SHA256SUMS\&.gpg\&. The public key for this verification step needs to be available in -/usr/lib/systemd/import\-pubring\&.gpg -or -/etc/systemd/import\-pubring\&.gpg\&. -.sp -The container image will be downloaded and stored in a read\-only subvolume in -/var/lib/machines/ -that is named after the specified URL and its HTTP etag\&. A writable snapshot is then taken from this subvolume, and named after the specified local name\&. This behavior ensures that creating multiple container instances of the same URL is efficient, as multiple downloads are not necessary\&. In order to create only the read\-only image, and avoid creating its writable snapshot, specify -"\-" -as local machine name\&. -.sp -Note that the read\-only subvolume is prefixed with -\&.tar\-, and is thus not shown by -\fBlist\-images\fR, unless -\fB\-\-all\fR -is passed\&. -.sp -Note that pressing C\-c during execution of this command will not abort the download\&. Use -\fBcancel\-transfer\fR, described below\&. -.sp -Added in version 219\&. -.RE -.PP -\fBpull\-raw\fR \fIURL\fR [\fINAME\fR] -.RS 4 -Downloads a -\&.raw -container or VM disk image from the specified URL, and makes it available under the specified local machine name\&. The URL must be of type -"http://" -or -"https://"\&. The container image must either be a -\&.qcow2 -or raw disk image, optionally compressed as -\&.gz, -\&.xz, or -\&.bz2\&. If the local machine name is omitted, it is automatically derived from the last component of the URL, with its suffix removed\&. -.sp -Image verification is identical for raw and tar images (see above)\&. -.sp -If the downloaded image is in -\&.qcow2 -format it is converted into a raw image file before it is made available\&. -.sp -Downloaded images of this type will be placed as read\-only -\&.raw -file in -/var/lib/machines/\&. A local, writable (reflinked) copy is then made under the specified local machine name\&. To omit creation of the local, writable copy pass -"\-" -as local machine name\&. -.sp -Similarly to the behavior of -\fBpull\-tar\fR, the read\-only image is prefixed with -\&.raw\-, and thus not shown by -\fBlist\-images\fR, unless -\fB\-\-all\fR -is passed\&. -.sp -Note that pressing C\-c during execution of this command will not abort the download\&. Use -\fBcancel\-transfer\fR, described below\&. -.sp -Added in version 219\&. -.RE -.PP -\fBimport\-tar\fR \fIFILE\fR [\fINAME\fR], \fBimport\-raw\fR \fIFILE\fR [\fINAME\fR] -.RS 4 -Imports a TAR or RAW container or VM image, and places it under the specified name in -/var/lib/machines/\&. When -\fBimport\-tar\fR -is used, the file specified as the first argument should be a tar archive, possibly compressed with xz, gzip or bzip2\&. It will then be unpacked into its own subvolume in -/var/lib/machines/\&. When -\fBimport\-raw\fR -is used, the file should be a qcow2 or raw disk image, possibly compressed with xz, gzip or bzip2\&. If the second argument (the resulting image name) is not specified, it is automatically derived from the file name\&. If the filename is passed as -"\-", the image is read from standard input, in which case the second argument is mandatory\&. -.sp -Optionally, the -\fB\-\-read\-only\fR -switch may be used to create a read\-only container or VM image\&. No cryptographic validation is done when importing the images\&. -.sp -Much like image downloads, ongoing imports may be listed with -\fBlist\-transfers\fR -and aborted with -\fBcancel\-transfer\fR\&. -.sp -Added in version 220\&. -.RE -.PP -\fBimport\-fs\fR \fIDIRECTORY\fR [\fINAME\fR] -.RS 4 -Imports a container image stored in a local directory into -/var/lib/machines/, operates similarly to -\fBimport\-tar\fR -or -\fBimport\-raw\fR, but the first argument is the source directory\&. If supported, this command will create a btrfs snapshot or subvolume for the new image\&. -.sp -Added in version 240\&. -.RE +.SH "OPTIONS" .PP -\fBexport\-tar\fR \fINAME\fR [\fIFILE\fR], \fBexport\-raw\fR \fINAME\fR [\fIFILE\fR] -.RS 4 -Exports a TAR or RAW container or VM image and stores it in the specified file\&. The first parameter should be a VM or container image name\&. The second parameter should be a file path the TAR or RAW image is written to\&. If the path ends in -"\&.gz", the file is compressed with gzip, if it ends in -"\&.xz", with xz, and if it ends in -"\&.bz2", with bzip2\&. If the path ends in neither, the file is left uncompressed\&. If the second argument is missing, the image is written to standard output\&. The compression may also be explicitly selected with the -\fB\-\-format=\fR -switch\&. This is in particular useful if the second parameter is left unspecified\&. -.sp -Much like image downloads and imports, ongoing exports may be listed with -\fBlist\-transfers\fR -and aborted with -\fBcancel\-transfer\fR\&. -.sp -Note that, currently, only directory and subvolume images may be exported as TAR images, and only raw disk images as RAW images\&. -.sp -Added in version 220\&. -.RE +The following options are understood: .PP -\fBlist\-transfers\fR +\fB\-p\fR, \fB\-\-property=\fR .RS 4 -Shows a list of container or VM image downloads, imports and exports that are currently in progress\&. +When showing machine or image properties, limit the output to certain properties as specified by the argument\&. If not specified, all set properties are shown\&. The argument should be a property name, such as +"Name"\&. If specified more than once, all properties with the specified names are shown\&. .sp -Added in version 219\&. +Added in version 206\&. .RE .PP -\fBcancel\-transfer\fR \fIID\fR\&... +\fB\-\-value\fR .RS 4 -Aborts a download, import or export of the container or VM image with the specified ID\&. To list ongoing transfers and their IDs, use -\fBlist\-transfers\fR\&. +When printing properties with +\fBshow\fR, only print the value, and skip the property name and +"="\&. .sp -Added in version 219\&. +Added in version 230\&. .RE -.SH "OPTIONS" -.PP -The following options are understood: .PP -\fB\-p\fR, \fB\-\-property=\fR +\fB\-P\fR .RS 4 -When showing machine or image properties, limit the output to certain properties as specified by the argument\&. If not specified, all set properties are shown\&. The argument should be a property name, such as -"Name"\&. If specified more than once, all properties with the specified names are shown\&. +Equivalent to +\fB\-\-value\fR +\fB\-\-property=\fR, i\&.e\&. shows the value of the property without the property name or +"="\&. Note that using +\fB\-P\fR +once will also affect all properties listed with +\fB\-p\fR/\fB\-\-property=\fR\&. .sp -Added in version 206\&. +Added in version 256\&. .RE .PP \fB\-a\fR, \fB\-\-all\fR @@ -668,15 +531,6 @@ When cleaning VM or container images, remove all images, not just hidden ones\&. Added in version 206\&. .RE .PP -\fB\-\-value\fR -.RS 4 -When printing properties with -\fBshow\fR, only print the value, and skip the property name and -"="\&. -.sp -Added in version 230\&. -.RE -.PP \fB\-l\fR, \fB\-\-full\fR .RS 4 Do not ellipsize process tree entries or table\&. This implies @@ -760,10 +614,7 @@ When used with \fBbind\fR, creates a read\-only bind mount\&. .sp When used with -\fBclone\fR, -\fBimport\-raw\fR -or -\fBimport\-tar\fR +\fBclone\fR a read\-only container or VM image is created\&. .sp Added in version 219\&. @@ -787,23 +638,25 @@ When used with Added in version 219\&. .RE .PP -\fB\-\-verify=\fR +\fB\-\-runner=\fR\fBnspawn\fR|\fBvmspawn\fR .RS 4 -When downloading a container or VM image, specify whether the image shall be verified before it is made available\&. Takes one of -"no", -"checksum" -and -"signature"\&. If -"no", no verification is done\&. If -"checksum" -is specified, the download is checked for integrity after the transfer is complete, but no signatures are verified\&. If -"signature" -is specified, the checksum is verified and the image\*(Aqs signature is checked against a local keyring of trustable vendors\&. It is strongly recommended to set this option to -"signature" -if the server and protocol support this\&. Defaults to -"signature"\&. +When operating on machines choose whether to use +\fBsystemd-nspawn\fR(1) +or +\fBsystemd-vmspawn\fR(1)\&. By default +\fBsystemd-nspawn\fR(1) +is used\&. .sp -Added in version 219\&. +Added in version 256\&. +.RE +.PP +\fB\-V\fR +.RS 4 +\fB\-V\fR +is a shorthand for +\fB\-\-runner=vmspawn\fR\&. +.sp +Added in version 256\&. .RE .PP \fB\-\-now\fR @@ -818,26 +671,11 @@ Added in version 253\&. .PP \fB\-\-force\fR .RS 4 -When downloading a container or VM image, and a local copy by the specified local machine name already exists, delete it first and replace it by the newly downloaded image\&. +Replace target file when copying files\&. .sp Added in version 219\&. .RE .PP -\fB\-\-format=\fR -.RS 4 -When used with the -\fBexport\-tar\fR -or -\fBexport\-raw\fR -commands, specifies the compression format to use for the resulting file\&. Takes one of -"uncompressed", -"xz", -"gzip", -"bzip2"\&. By default, the format is determined automatically from the image file name passed\&. -.sp -Added in version 220\&. -.RE -.PP \fB\-\-max\-addresses=\fR .RS 4 When used with the @@ -990,39 +828,18 @@ and options\&. .SH "EXAMPLES" .PP -\fBExample\ \&1.\ \&Download a Ubuntu image and open a shell in it\fR +\fBExample\ \&1.\ \&Download an Ubuntu RAW image, set a root password in it, start it as a service\fR .sp .if n \{\ .RS 4 .\} .nf -# machinectl pull\-tar https://cloud\-images\&.ubuntu\&.com/trusty/current/trusty\-server\-cloudimg\-amd64\-root\&.tar\&.gz -# systemd\-nspawn \-M trusty\-server\-cloudimg\-amd64\-root -.fi -.if n \{\ -.RE -.\} -.PP -This downloads and verifies the specified -\&.tar -image, and then uses -\fBsystemd-nspawn\fR(1) -to open a shell in it\&. -.PP -\fBExample\ \&2.\ \&Download a Fedora image, set a root password in it, start it as a service\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -# machinectl pull\-raw \-\-verify=no \e - https://download\&.fedoraproject\&.org/pub/fedora/linux/releases/38/Cloud/x86_64/images/Fedora\-Cloud\-Base\-38\-1\&.6\&.x86_64\&.raw\&.xz \e - Fedora\-Cloud\-Base\-38\-1\&.6\&.x86\-64 -# systemd\-nspawn \-M Fedora\-Cloud\-Base\-38\-1\&.6\&.x86\-64 -# passwd -# exit -# machinectl start Fedora\-Cloud\-Base\-38\-1\&.6\&.x86\-64 -# machinectl login Fedora\-Cloud\-Base\-38\-1\&.6\&.x86\-64 +# importctl pull\-raw \-mN \e + https://cloud\-images\&.ubuntu\&.com/jammy/current/jammy\-server\-cloudimg\-amd64\-disk\-kvm\&.img \e + jammy +# systemd\-firstboot \-\-image=/var/lib/machines/jammy\&.raw \-\-prompt\-root\-password \-\-force +# machinectl start jammy +# machinectl login jammy .fi .if n \{\ .RE @@ -1030,41 +847,9 @@ to open a shell in it\&. .PP This downloads the specified \&.raw -image with verification disabled\&. Then, a shell is opened in it and a root password is set\&. Afterwards the shell is left, and the machine started as system service\&. With the last command a login prompt into the container is requested\&. -.PP -\fBExample\ \&3.\ \&Exports a container image as tar file\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -# machinectl export\-tar fedora myfedora\&.tar\&.xz -.fi -.if n \{\ -.RE -.\} -.PP -Exports the container -"fedora" -as an xz\-compressed tar file -myfedora\&.tar\&.xz -into the current directory\&. -.PP -\fBExample\ \&4.\ \&Create a new shell session\fR -.sp -.if n \{\ -.RS 4 -.\} -.nf -# machinectl shell \-\-uid=lennart -.fi -.if n \{\ -.RE -.\} -.PP -This creates a new shell session on the local host for the user ID -"lennart", in a -\fBsu\fR(1)\-like fashion\&. +image and makes it available under the local name +"jammy"\&. Then, a root password is set with +\fBsystemd-firstboot\fR(1)\&. Afterwards the machine is started as system service\&. With the last command a login prompt into the container is requested\&. .SH "EXIT STATUS" .PP On success, 0 is returned, a non\-zero failure code otherwise\&. @@ -1072,7 +857,7 @@ On success, 0 is returned, a non\-zero failure code otherwise\&. .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, @@ -1082,7 +867,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 @@ -1201,6 +994,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\&. @@ -1212,6 +1011,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 @@ -1267,11 +1072,4 @@ and other conditions\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-machined.service\fR(8), -\fBsystemd-nspawn\fR(1), -\fBsystemd.special\fR(7), -\fBtar\fR(1), -\fBxz\fR(1), -\fBgzip\fR(1), -\fBbzip2\fR(1) +\fBsystemd\fR(1), \fBsystemd-machined.service\fR(8), \fBsystemd-nspawn\fR(1), \fBsystemd.special\fR(7), \fBimportctl\fR(1), \fBtar\fR(1), \fBxz\fR(1), \fBgzip\fR(1), \fBbzip2\fR(1) diff --git a/upstream/fedora-rawhide/man1/makepkg-template.1 b/upstream/fedora-rawhide/man1/makepkg-template.1 index 42051d83..e73b58bb 100644 --- a/upstream/fedora-rawhide/man1/makepkg-template.1 +++ b/upstream/fedora-rawhide/man1/makepkg-template.1 @@ -2,12 +2,12 @@ .\" Title: makepkg-template .\" 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\-TEMPLATE" "1" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "MAKEPKG\-TEMPLATE" "1" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -130,7 +130,7 @@ arch=(\*(Aqany\*(Aq) license=(\*(AqPerlArtistic\*(Aq \*(AqGPL\*(Aq) depends=(\*(Aqperl\*(Aq) source=("http://search\&.cpan\&.org/CPAN/authors/id/S/SH/SHERZODR/Config\-Simple\-${pkgver}\&.tar\&.gz") -md5sums=(\*(Aqf014aec54f0a1e2e880d317180fce502\*(Aq) +sha256sums=(\*(Aqdd9995706f0f9384a15ccffe116c3b6e22f42ba2e58d8f24ed03c4a0e386edb4\*(Aq) _distname="Config\-Simple" .fi .if n \{\ @@ -232,17 +232,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 @@ -325,4 +314,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/man1/md5sum.1 b/upstream/fedora-rawhide/man1/md5sum.1 index 3257d0ad..e2de7e4c 100644 --- a/upstream/fedora-rawhide/man1/md5sum.1 +++ b/upstream/fedora-rawhide/man1/md5sum.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH MD5SUM "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH MD5SUM "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME md5sum \- compute and check MD5 message digest .SH SYNOPSIS @@ -56,7 +56,7 @@ The default mode is to print a line with: checksum, a space, a character indicating input mode ('*' for binary, ' ' for text or where binary is insignificant), and name for each FILE. .PP -Note: There is no difference between binary mode and text mode on GNU systems. +There is no difference between binary mode and text mode on GNU systems. .SH BUGS Do not use the MD5 algorithm for security related purposes. Instead, use an SHA\-2 algorithm, implemented in the programs @@ -69,7 +69,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/memusage.1 b/upstream/fedora-rawhide/man1/memusage.1 index cc21b83e..fa64544a 100644 --- a/upstream/fedora-rawhide/man1/memusage.1 +++ b/upstream/fedora-rawhide/man1/memusage.1 @@ -2,7 +2,7 @@ .\" and Copyright (C) 2014, Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH memusage 1 2023-10-31 "Linux man-pages 6.06" +.TH memusage 1 2023-10-31 "Linux man-pages 6.7" .SH NAME memusage \- profile memory usage of a program .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/memusagestat.1 b/upstream/fedora-rawhide/man1/memusagestat.1 index 09d23659..d1a76fbc 100644 --- a/upstream/fedora-rawhide/man1/memusagestat.1 +++ b/upstream/fedora-rawhide/man1/memusagestat.1 @@ -1,7 +1,7 @@ .\" Copyright (c) 2013, Peter Schiffer <pschiffe@redhat.com> .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH memusagestat 1 2023-10-31 "Linux man-pages 6.06" +.TH memusagestat 1 2023-10-31 "Linux man-pages 6.7" .SH NAME memusagestat \- generate graphic from memory profiling data .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/mkdir.1 b/upstream/fedora-rawhide/man1/mkdir.1 index 3fd37c78..7bf8052d 100644 --- a/upstream/fedora-rawhide/man1/mkdir.1 +++ b/upstream/fedora-rawhide/man1/mkdir.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH MKDIR "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH MKDIR "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME mkdir \- make directories .SH SYNOPSIS @@ -42,7 +42,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/mkfifo.1 b/upstream/fedora-rawhide/man1/mkfifo.1 index 1e363ec2..52960484 100644 --- a/upstream/fedora-rawhide/man1/mkfifo.1 +++ b/upstream/fedora-rawhide/man1/mkfifo.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH MKFIFO "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH MKFIFO "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME mkfifo \- make FIFOs (named pipes) .SH SYNOPSIS @@ -34,7 +34,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/mknod.1 b/upstream/fedora-rawhide/man1/mknod.1 index 2b8a695f..21c9521b 100644 --- a/upstream/fedora-rawhide/man1/mknod.1 +++ b/upstream/fedora-rawhide/man1/mknod.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH MKNOD "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH MKNOD "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME mknod \- make block or character special files .SH SYNOPSIS @@ -42,7 +42,7 @@ create a character (unbuffered) special file p create a FIFO .PP -NOTE: your shell may have its own version of mknod, which usually supersedes +Your shell may have its own version of mknod, which usually supersedes the version described here. Please refer to your shell's documentation for details about the options it supports. .SH AUTHOR @@ -52,7 +52,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/mkosi.1 b/upstream/fedora-rawhide/man1/mkosi.1 deleted file mode 100644 index e32d7ccb..00000000 --- a/upstream/fedora-rawhide/man1/mkosi.1 +++ /dev/null @@ -1,1852 +0,0 @@ -.\" Automatically generated by Pandoc 2.14.0.3 -.\" -.TH "mkosi" "1" "2016-" "" "" -.hy -.SH NAME -.PP -mkosi \[em] Build Bespoke OS Images -.SH SYNOPSIS -.PP -\f[C]mkosi [options\&...] build\f[R] -.PP -\f[C]mkosi [options\&...] clean\f[R] -.PP -\f[C]mkosi [options\&...] summary\f[R] -.PP -\f[C]mkosi [options\&...] shell [command line\&...]\f[R] -.PP -\f[C]mkosi [options\&...] boot [nspawn settings\&...]\f[R] -.PP -\f[C]mkosi [options\&...] qemu\f[R] -.PP -\f[C]mkosi [options\&...] ssh\f[R] -.PP -\f[C]mkosi [options\&...] serve\f[R] -.PP -\f[C]mkosi [options\&...] bump\f[R] -.PP -\f[C]mkosi [options\&...] genkey\f[R] -.PP -\f[C]mkosi [options\&...] help\f[R] -.SH DESCRIPTION -.PP -\f[C]mkosi\f[R] is a tool for easily building customized OS images. -It\[cq]s a fancy wrapper around \f[C]dnf --installroot\f[R], -\f[C]debootstrap\f[R], \f[C]pacstrap\f[R] and \f[C]zypper\f[R] that may -generate disk images with a number of bells and whistles. -.SS Command Line Verbs -.PP -The following command line verbs are known: -.TP -\f[B]\f[CB]build\f[B]\f[R] -This builds the image, based on the settings passed in on the command -line or read from a \f[C]mkosi.default\f[R] file. -This verb is the default if no verb is explicitly specified. -This command must be executed as \f[C]root\f[R]. -Any arguments passed after \f[C]build\f[R] are passed as arguments to -the build script (if there is one). -.TP -\f[B]\f[CB]clean\f[B]\f[R] -Remove build artifacts generated on a previous build. -If combined with \f[C]-f\f[R], also removes incremental build cache -images. -If \f[C]-f\f[R] is specified twice, also removes any package cache. -.TP -\f[B]\f[CB]summary\f[B]\f[R] -Outputs a human-readable summary of all options used for building an -image. -This will parse the command line and \f[C]mkosi.default\f[R] file as it -would do on \f[C]build\f[R], but only output what it is configured for -and not actually build anything.\[ga] -.TP -\f[B]\f[CB]shell\f[B]\f[R] -This builds the image if it is not built yet, and then invokes -\f[C]systemd-nspawn\f[R] to acquire an interactive shell prompt in it. -If this verb is used an optional command line may be specified which is -then invoked in place of the shell in the container. -Combine this with \f[C]-f\f[R] in order to rebuild the image -unconditionally before acquiring the shell, see below. -This command must be executed as \f[C]root\f[R]. -.TP -\f[B]\f[CB]boot\f[B]\f[R] -Similar to \f[C]shell\f[R] but boots the image up using -\f[C]systemd-nspawn\f[R]. -If this verb is used an optional command line may be specified which is -passed as \[lq]kernel command line\[rq] to the init system in the image. -.TP -\f[B]\f[CB]qemu\f[B]\f[R] -Similar to \f[C]boot\f[R] but uses \f[C]qemu\f[R] to boot up the image, -i.e.\ instead of container virtualization VM virtualization is used. -This verb is only supported on images that contain a boot loader, -i.e.\ those built with \f[C]Bootable=yes\f[R] (see below). -This command must be executed as \f[C]root\f[R] unless the image already -exists and \f[C]-f\f[R] is not specified. -.TP -\f[B]\f[CB]ssh\f[B]\f[R] -When the image is built with the \f[C]Ssh=yes\f[R] option, this command -connects to a booted (\f[C]boot\f[R], \f[C]qemu\f[R] verbs) container/VM -via SSH. -Make sure to run \f[C]mkosi ssh\f[R] with the same config as -\f[C]mkosi build\f[R] was run with so that it has the necessary -information available to connect to the running container/VM via SSH. -.TP -\f[B]\f[CB]serve\f[B]\f[R] -This builds the image if it is not built yet, and then serves the output -directory (i.e.\ usually \f[C]mkosi.output/\f[R], see below) via a small -embedded HTTP server, listening on port 8081. -Combine with \f[C]-f\f[R] in order to rebuild the image unconditionally -before serving it. -This command is useful for testing network based acquisition of OS -images, for example via \f[C]machinectl pull-raw \&...\f[R] and -\f[C]machinectl pull-tar \&...\f[R]. -.TP -\f[B]\f[CB]bump\f[B]\f[R] -Determines the current image version string (as configured with -\f[C]ImageVersion=\f[R]/\f[C]--image-version=\f[R]), increases its last -dot-separated component by one and writes the resulting version string -to \f[C]mkosi.version\f[R]. -This is useful for implementing a simple versioning scheme: each time -this verb is called the version is bumped in preparation for the -subsequent build. -Note that \f[C]--auto-bump\f[R]/\f[C]-B\f[R] may be used to -automatically bump the version after each successful build. -.TP -\f[B]\f[CB]genkey\f[B]\f[R] -Generate a pair of SecureBoot keys for usage with the -\f[C]SecureBootKey=\f[R]/\f[C]--secure-boot-key=\f[R] and -\f[C]SecureBootCertificate=\f[R]/\f[C]--secure-boot-certificate=\f[R] -options. -.TP -\f[B]\f[CB]help\f[B]\f[R] -This verb is equivalent to the \f[C]--help\f[R] switch documented below: -it shows a brief usage explanation. -.SS Execution flow -.PP -Execution flow for \f[C]mkosi build\f[R]. -Columns represent the execution context. -Default values/calls are shown in parentheses. -When building with \f[C]--incremental\f[R] mkosi creates a cache of the -distribution installation for both images if not already existing and -replaces the distribution installation in consecutive runs with data -from the cached one. -.IP -.nf -\f[C] - HOST . BUILD . FINAL - . IMAGE . IMAGE - . . - start . . - | . . - v . . -build script? -------exists-----> copy . - | . skeleton trees . - | . (mkosi.skeleton/) . - none . | . - | . v . - v . install . - skip . distribution, . - build image . packages and . - | . build packages, . - | . run . - | . prepare script . - | . (mkosi.prepare build) . - | . or if incremental . - | . use cached build image . - | . | . - | . v . - | . copy . - | . build sources . - | . (./) . - | . | . - | . v . - | . copy . - | . extra trees . - | . (mkosi.extra/) . - | . | . - | . v . - | . run . - | . postinstall script . - | . (mkosi.postinst build) . - | . | . - | .-------------------------\[aq] . - | | . . - | v . . - | run . . - | finalize script . . - |(mkosi.finalize build). . - | | . . - | \[aq]-------------------------. . - | . | . - | . v . - | . run . - | . build script . - | . (mkosi.build) . - | . | . - \[aq]-----------------------------------+------------------------. - . . | - . . v - . . copy - . . skeleton trees - . . (mkosi.skeleton/) - . . | - . . v - . . install - . . distribution - . . and packages, - . . run - . . prepare script - . . (mkosi.prepare final) - . . or if incremental - . . use cached final image - . . | - . . v - . . copy - . . build results - . . | - . . v - . . copy - . . extra trees - . . (mkosi.extra/) - . . | - . . v - . . run - . . postinstall script - . . (mkosi.postinst final) - . . | - . . v - . . | - . . perform cleanup - . . (remove files, packages, - . . package metadata) - . . | - .--------------------------------------------------\[aq] - | . . - v . . - run . . - finalize script . . - (mkosi.finalize final) . . - | . . - .---------\[aq] . . - | . . - v . . - end . . - . . - HOST . BUILD . FINAL - . IMAGE . IMAGE - . . -\f[R] -.fi -.SS Supported output formats -.PP -The following output formats are supported: -.IP \[bu] 2 -Raw \f[I]GPT\f[R] disk image, with ext4 as root (\f[I]gpt_ext4\f[R]) -.IP \[bu] 2 -Raw \f[I]GPT\f[R] disk image, with xfs as root (\f[I]gpt_xfs\f[R]) -.IP \[bu] 2 -Raw \f[I]GPT\f[R] disk image, with btrfs as root (\f[I]gpt_btrfs\f[R]) -.IP \[bu] 2 -Raw \f[I]GPT\f[R] disk image, with squashfs as read-only root -(\f[I]gpt_squashfs\f[R]) -.IP \[bu] 2 -Plain squashfs image, without partition table, as read-only root -(\f[I]plain_squashfs\f[R]) -.IP \[bu] 2 -Plain directory, containing the OS tree (\f[I]directory\f[R]) -.IP \[bu] 2 -btrfs subvolume, with separate subvolumes for \f[C]/var\f[R], -\f[C]/home\f[R], \f[C]/srv\f[R], \f[C]/var/tmp\f[R] -(\f[I]subvolume\f[R]) -.IP \[bu] 2 -Tar archive (\f[I]tar\f[R]) -.IP \[bu] 2 -CPIO archive (\f[I]cpio\f[R]) in the format appropriate for a kernel -initrd -.PP -When a \f[I]GPT\f[R] disk image is created, the following additional -options are available: -.IP \[bu] 2 -A swap partition may be added in -.IP \[bu] 2 -The image may be made bootable on \f[I]EFI\f[R] and \f[I]BIOS\f[R] -systems -.IP \[bu] 2 -Separate partitions for \f[C]/srv\f[R] and \f[C]/home\f[R] may be added -in -.IP \[bu] 2 -The root, \f[C]/srv\f[R] and \f[C]/home\f[R] partitions may optionally -be encrypted with LUKS. -.IP \[bu] 2 -A dm-verity partition may be added in that adds runtime integrity data -for the root partition -.SS Configuration Settings -.PP -The following settings can be set through configuration files (the -syntax with \f[C]SomeSetting=value\f[R]) and on the command line (the -syntax with \f[C]--some-setting=value\f[R]). -For some command line parameters, a single-letter shortcut is also -allowed. -In the configuration files, the setting must be in the appropriate -section, so the settings are grouped by section below. -.PP -Command line options that take no argument are shown without \[lq]=\[rq] -in their long version. -In the config files, they should be specified with a boolean argument: -either \[lq]1\[rq], \[lq]yes\[rq], or \[lq]true\[rq] to enable, or -\[lq]0\[rq], \[lq]no\[rq], \[lq]false\[rq] to disable. -.SS [Distribution] Section -.TP -\f[B]\f[CB]Distribution=\f[B]\f[R], \f[B]\f[CB]--distribution=\f[B]\f[R], \f[B]\f[CB]-d\f[B]\f[R] -The distribution to install in the image. -Takes one of the following arguments: \f[C]fedora\f[R], -\f[C]debian\f[R], \f[C]ubuntu\f[R], \f[C]arch\f[R], \f[C]opensuse\f[R], -\f[C]mageia\f[R], \f[C]centos\f[R], \f[C]centos_epel\f[R], -\f[C]clear\f[R], \f[C]photon\f[R], \f[C]openmandriva\f[R], -\f[C]rocky\f[R], \f[C]rocky_epel\f[R], \f[C]alma\f[R], -\f[C]alma_epel\f[R]. -If not specified, defaults to the distribution of the host. -.TP -\f[B]\f[CB]Release=\f[B]\f[R], \f[B]\f[CB]--release=\f[B]\f[R], \f[B]\f[CB]-r\f[B]\f[R] -The release of the distribution to install in the image. -The precise syntax of the argument this takes depends on the -distribution used, and is either a numeric string (in case of Fedora -Linux, CentOS, \&..., e.g.\ \f[C]29\f[R]), or a distribution version -name (in case of Debian, Ubuntu, \&..., e.g.\ \f[C]artful\f[R]). -If neither this option, nor \f[C]Distribution=\f[R] is specified, -defaults to the distribution version of the host. -If the distribution is specified, defaults to a recent version of it. -.TP -\f[B]\f[CB]Mirror=\f[B]\f[R], \f[B]\f[CB]--mirror=\f[B]\f[R], \f[B]\f[CB]-m\f[B]\f[R] -The mirror to use for downloading the distribution packages. -Expects a mirror URL as argument. -.TP -\f[B]\f[CB]Repositories=\f[B]\f[R], \f[B]\f[CB]--repositories=\f[B]\f[R] -Additional package repositories to use during installation. -Expects one or more URLs as argument, separated by commas. -This option may be used multiple times, in which case the list of -repositories to use is combined. -Use \[lq]!*\[rq] to remove all repositories from to the list or use -e.g.\ \[lq]!repo-url\[rq] to remove just one specific repository. -For Arch Linux, additional repositories must be passed in the form -\f[C]<name>::<url>\f[R] (e.g.\ \f[C]myrepo::https://myrepo.net\f[R]). -.TP -\f[B]\f[CB]UseHostRepositories=\f[B]\f[R], \f[B]\f[CB]--use-host-repositories\f[B]\f[R] -This option is only applicable for RPM-based distributions: -\f[I]CentOS\f[R], \f[I]Fedora Linux\f[R], \f[I]Mageia\f[R], -\f[I]Photon\f[R], \f[I]Rocky Linux\f[R], \f[I]Alma Linux\f[R] and -\f[I]OpenMandriva\f[R]. -Allows use of the host\[cq]s existing RPM repositories. -By default, a hardcoded set of default RPM repositories is generated and -used. -Use \f[C]--repositories=\f[R] to identify a custom set of repositories -to be enabled and used for the build. -.TP -\f[B]\f[CB]RepositoryDirectory\f[B]\f[R], \f[B]\f[CB]--repository-directory\f[B]\f[R] -This option can (for now) only be used with RPM-based istributions and -Arch Linux. -It identifies a directory containing extra repository definitions that -will be used when installing packages. -The files are passed directly to the corresponding package manager and -should be written in the format expected by the package manager of the -image\[cq]s distro. -.TP -\f[B]\f[CB]Architecture=\f[B]\f[R], \f[B]\f[CB]--architecture=\f[B]\f[R] -The architecture to build the image for. -Note that this currently only works for architectures compatible with -the host\[cq]s architecture. -.SS [Output] Section -.TP -\f[B]\f[CB]Format=\f[B]\f[R], \f[B]\f[CB]--format=\f[B]\f[R], \f[B]\f[CB]-t\f[B]\f[R] -The image format type to generate. -One of \f[C]directory\f[R] (for generating OS images inside a local -directory), \f[C]subvolume\f[R] (similar, but as a btrfs subvolume), -\f[C]tar\f[R] (similar, but a tarball of the image is generated), -\f[C]cpio\f[R] (similar, but a cpio archive is generated), -\f[C]gpt_ext4\f[R] (a block device image with an ext4 file system inside -a GPT partition table), \f[C]gpt_xfs\f[R] (similar, but with an xfs file -system), \f[C]gpt_btrfs\f[R] (similar, but with an btrfs file system), -\f[C]gpt_squashfs\f[R] (similar, but with a squashfs file system), -\f[C]plain_squashfs\f[R] (a plain squashfs file system without a -partition table). -.TP -\f[B]\f[CB]ManifestFormat=\f[B]\f[R], \f[B]\f[CB]--manifest-format=\f[B]\f[R] -The manifest format type or types to generate. -A comma-delimited list consisting of \f[C]json\f[R] (the standard JSON -output format that describes the packages installed), -\f[C]changelog\f[R] (a human-readable text format designed for diffing). -Defaults to \f[C]json\f[R]. -.TP -\f[B]\f[CB]Output=\f[B]\f[R], \f[B]\f[CB]--output=\f[B]\f[R], \f[B]\f[CB]-o\f[B]\f[R] -Path for the output image file to generate. -Takes a relative or absolute path where the generated image will be -placed. -If neither this option nor \f[C]OutputDirectory=\f[R] is used, the image -is generated under the name \f[C]image\f[R], but its name suffixed with -an appropriate file suffix (e.g.\ \f[C]image.raw.xz\f[R] in case -\f[C]gpt_ext4\f[R] is used in combination with \f[C]xz\f[R] -compression). -If the \f[C]ImageId=\f[R] option is configured it is used instead of -\f[C]image\f[R] in the default output name. -If an image version is specified via \f[C]ImageVersion=\f[R], it is -included in the default name, e.g.\ a specified image version of -\f[C]7.8\f[R] might result in an image file name of -\f[C]image_7.8.raw.xz\f[R]. -.TP -\f[B]\f[CB]OutputSplitRoot=\f[B]\f[R], \f[B]\f[CB]--output-split-root=\f[B]\f[R], \f[B]\f[CB]OutputSplitVerify=\f[B]\f[R], \f[B]\f[CB]--output-split-verity=\f[B]\f[R], \f[B]\f[CB]OutputSplitKernel=\f[B]\f[R], \f[B]\f[CB]--output-split-kernel=\f[B]\f[R] -Paths for the split-out output image files, when -\f[C]SplitArtifacts=yes\f[R] is used. -If unspecified, the relevant split artifact files will be named like the -main image, but with \f[C].root\f[R], \f[C].verity\f[R], and -\f[C].efi\f[R] suffixes inserted (and in turn possibly suffixed by -compression suffix, if compression is enabled). -.TP -\f[B]\f[CB]OutputDirectory=\f[B]\f[R], \f[B]\f[CB]--output-dir=\f[B]\f[R], \f[B]\f[CB]-O\f[B]\f[R] -Path to a directory where to place all generated artifacts (i.e.\ the -generated image when an output path is not given, \f[C]SHA256SUMS\f[R] -file, etc.). -If this is not specified and the directory \f[C]mkosi.output/\f[R] -exists in the local directory, it is automatically used for this -purpose. -If the setting is not used and \f[C]mkosi.output/\f[R] does not exist, -all output artifacts are placed adjacent to the output image file. -.TP -\f[B]\f[CB]WorkspaceDirectory=\f[B]\f[R], \f[B]\f[CB]--workspace-dir=\f[B]\f[R] -Path to a directory where to store data required temporarily while -building the image. -This directory should have enough space to store the full OS image, -though in most modes the actually used disk space is smaller. -If not specified, and \f[C]mkosi.workspace/\f[R] exists in the local -directory, it is used for this purpose. -Otherwise, a subdirectory in the temporary storage area is used -(\f[C]$TMPDIR\f[R] if set, \f[C]/var/tmp/\f[R] otherwise). -The data in this directory is removed automatically after each build. -It\[cq]s safe to manually remove the contents of this directory should -an \f[C]mkosi\f[R] invocation be aborted abnormally (for example, due to -reboot/power failure). -If the \f[C]btrfs\f[R] output modes are selected this directory must be -backed by \f[C]btrfs\f[R] too. -.TP -\f[B]\f[CB]Force=\f[B]\f[R], \f[B]\f[CB]--force\f[B]\f[R], \f[B]\f[CB]-f\f[B]\f[R] -Replace the output file if it already exists, when building an image. -By default when building an image and an output artifact already exists -\f[C]mkosi\f[R] will refuse operation. -Specify this option once to delete all build artifacts from a previous -run before re-building the image. -If incremental builds are enabled, specifying this option twice will -ensure the intermediary cache files are removed, too, before the -re-build is initiated. -If a package cache is used (also see the \[lq]Files\[rq] section below), -specifying this option thrice will ensure the package cache is removed -too, before the re-build is initiated. -For the \f[C]clean\f[R] operation this option has a slightly different -effect: by default the verb will only remove build artifacts from a -previous run, when specified once the incremental cache files are -deleted too, and when specified twice the package cache is also removed. -.PP -.TP -\f[B]\f[CB]GPTFirstLBA=\f[B]\f[R], \f[B]\f[CB]--gpt-first-lba=\f[B]\f[R] -Override the first usable LBA (Logical Block Address) within the GPT -header. -This defaults to \f[C]2048\f[R], which is actually the desired value. -However, some tools, e.g.\ the \f[C]prl_disk_tool\f[R] utility from the -Parallels virtualization suite require this to be set to \f[C]34\f[R], -otherwise they might fail to resize the disk image and/or partitions -inside it. -.TP -\f[B]\f[CB]Bootable=\f[B]\f[R], \f[B]\f[CB]--bootable\f[B]\f[R], \f[B]\f[CB]-b\f[B]\f[R] -Generate a bootable image. -By default this will generate an image bootable on UEFI systems. -Use \f[C]BootProtocols=\f[R] to select support for a different boot -protocol. -.TP -\f[B]\f[CB]BootProtocols=\f[B]\f[R], \f[B]\f[CB]--boot-protocols=\f[B]\f[R] -Pick one or more boot protocols to support when generating a bootable -image, as enabled with \f[C]Bootable=\f[R]. -Takes a comma-separated list of \f[C]uefi\f[R] or \f[C]bios\f[R]. -May be specified more than once in which case the specified lists are -merged. -If \f[C]uefi\f[R] is specified the \f[C]sd-boot\f[R] UEFI boot loader is -used, if \f[C]bios\f[R] is specified the GNU Grub boot loader is used. -Use \[lq]!*\[rq] to remove all previously added protocols or -\[lq]!protocol\[rq] to remove one protocol. -.TP -\f[B]\f[CB]KernelCommandLine=\f[B]\f[R], \f[B]\f[CB]--kernel-command-line=\f[B]\f[R] -Use the specified kernel command line when building bootable images. -By default command line arguments get appended. -To remove all arguments from the current list pass \[lq]!*\[rq]. -To remove specific arguments add a space separated list of \[lq]!\[rq] -prefixed arguments. -For example adding \[lq]!* console=ttyS0 rw\[rq] to a -\f[C]mkosi.default\f[R] file or the command line arguments passes -\[lq]console=ttyS0 rw\[rq] to the kernel in any case. -Just adding \[lq]console=ttyS0 rw\[rq] would append these two arguments -to the kernel command line created by lower priority configuration files -or previous \f[C]KernelCommandLine=\f[R] command line arguments. -.TP -\f[B]\f[CB]SecureBoot=\f[B]\f[R], \f[B]\f[CB]--secure-boot\f[B]\f[R] -Sign the resulting kernel/initrd image for UEFI SecureBoot. -.TP -\f[B]\f[CB]SecureBootKey=\f[B]\f[R], \f[B]\f[CB]--secure-boot-key=\f[B]\f[R] -Path to the PEM file containing the secret key for signing the UEFI -kernel image, if \f[C]SecureBoot=\f[R] is used. -.TP -\f[B]\f[CB]SecureBootCertificate=\f[B]\f[R], \f[B]\f[CB]--secure-boot-certificate=\f[B]\f[R] -Path to the X.509 file containing the certificate for the signed UEFI -kernel image, if \f[C]SecureBoot=\f[R] is used. -.TP -\f[B]\f[CB]SecureBootCommonName=\f[B]\f[R], \f[B]\f[CB]--secure-boot-common-name=\f[B]\f[R] -Common name to be used when generating SecureBoot keys via mkosi\[cq]s -\f[C]genkey\f[R] command. -Defaults to \f[C]mkosi of %u\f[R], where \f[C]%u\f[R] expands to the -username of the user invoking mkosi. -.TP -\f[B]\f[CB]SecureBootValidDays=\f[B]\f[R], \f[B]\f[CB]--secure-boot-valid-days=\f[B]\f[R] -Number of days that the keys should remain valid when generating -SecureBoot keys via mkosi\[cq]s \f[C]genkey\f[R] command. -Defaults to two years (730 days). -.TP -\f[B]\f[CB]ReadOnly=\f[B]\f[R], \f[B]\f[CB]--read-only\f[B]\f[R] -Set the read-only flag on the root partition in the partition table. -Only applies to \f[C]gpt_ext4\f[R], \f[C]gpt_xfs\f[R], -\f[C]gpt_btrfs\f[R], \f[C]subvolume\f[R] output formats, and is implied -on \f[C]gpt_squashfs\f[R] and \f[C]plain_squashfs\f[R]. -The read-only flag is essentially a hint to tools using the image (see -https://systemd.io/DISCOVERABLE_PARTITIONS/). -In particular, all systemd tools like \f[C]systemd-nspawn\f[R] and -\f[C]systemd-gpt-auto-generator\f[R] will mount such partitions -read-only, but tools from other project may ignore the flag. -.TP -\f[B]\f[CB]Minimize=\f[B]\f[R], \f[B]\f[CB]--minimize\f[B]\f[R] -Attempt to make the resulting root file system as small as possible by -removing free space from the file system. -Only supported for \f[C]gpt_ext4\f[R] and \f[C]gpt_btrfs\f[R]. -For ext4 this relies on \f[C]resize2fs -M\f[R], which reduces the free -disk space but is not perfect and generally leaves some free space. -For btrfs the results are optimal and no free space is left. -.TP -\f[B]\f[CB]Encrypt=\f[B]\f[R], \f[B]\f[CB]--encrypt\f[B]\f[R] -Encrypt all partitions in the file system or just the root file system. -Takes either \f[C]all\f[R] or \f[C]data\f[R] as argument. -If \f[C]all\f[R], the root, \f[C]/home\f[R] and \f[C]/srv\f[R] file -systems will be encrypted using dm-crypt/LUKS (with its default -settings). -If \f[C]data\f[R], the root file system will be left unencrypted, but -\f[C]/home\f[R] and \f[C]/srv\f[R] will be encrypted. -The passphrase to use is read from the \f[C]mkosi.passphrase\f[R] file -in the current working directory. -Note that the UEFI System Partition (ESP) containing the boot loader and -kernel to boot is never encrypted since it needs to be accessible by the -firmware. -.TP -\f[B]\f[CB]Verity=\f[B]\f[R], \f[B]\f[CB]--verity\f[B]\f[R] -Add a \[lq]Verity\[rq] integrity partition to the image. -Takes a boolean or the special value \f[C]signed\f[R], and defaults to -disabled. -If enabled, the root partition (or \f[C]/usr/\f[R] partition, in case -\f[C]UsrOnly=\f[R] is enabled) is protected with \f[C]dm-verity\f[R] -against offline modification, the verification data is placed in an -additional GPT partition. -Implies \f[C]ReadOnly=yes\f[R]. -If this is enabled, the Verity root hash is written to an output file -with \f[C].roothash\f[R] or \f[C].usrhash\f[R] suffix. -If set to \f[C]signed\f[R], Verity is also enabled, but the resulting -root hash is then also signed (in PKCS#7 format) with the signature key -configured with \f[C]SecureBootKey=\f[R]. -Or in other words: the SecureBoot key pair is then used to both sign the -kernel, if that is enabled, and the root/\f[C]/usr/\f[R] file system. -This signature is then stored in an additional output file with the -\f[C].roothash.p7s\f[R] or \f[C].usrhash.p7s\f[R] suffix in DER format. -It is also written to an additional partition in the image. -The latter allows generating self-contained signed disk images, -implementing the Verity provisions described in the Discoverable -Partitions Specification (https://systemd.io/DISCOVERABLE_PARTITIONS). -.TP -\f[B]\f[CB]CompressFs=\f[B]\f[R], \f[B]\f[CB]--compress-fs=\f[B]\f[R] -Enable or disable internal compression in the file system. -Only applies to output formats with squashfs or btrfs. -Takes one of \f[C]zlib\f[R], \f[C]lzo\f[R], \f[C]zstd\f[R], -\f[C]lz4\f[R], \f[C]xz\f[R] or a boolean value as argument. -If the latter is used compression is enabled/disabled and the default -algorithm is used. -In case of the \f[C]squashfs\f[R] output formats compression is implied, -but this option may be used to select the algorithm. -.TP -\f[B]\f[CB]CompressOutput=\f[B]\f[R], \f[B]\f[CB]--compress-output=\f[B]\f[R] -Configure compression for the resulting image or archive. -The argument can be either a boolean or a compression algorithm -(\f[C]xz\f[R], \f[C]zstd\f[R]). -\f[C]xz\f[R] compression is used by default. -Note that when applied to block device image types this means the image -cannot be started directly but needs to be decompressed first. -This also means that the \f[C]shell\f[R], \f[C]boot\f[R], \f[C]qemu\f[R] -verbs are not available when this option is used. -Implied for \f[C]tar\f[R] and \f[C]cpio\f[R]. -.TP -\f[B]\f[CB]Compress=\f[B]\f[R], \f[B]\f[CB]--compress=\f[B]\f[R] -Enable compression. -Using this option is equivalent to either \f[C]CompressFs=\f[R] or -\f[C]CompressOutput=\f[R]; the appropriate type of compression is -selected automatically. -.TP -\f[B]\f[CB]Mksquashfs=\f[B]\f[R], \f[B]\f[CB]--mksquashfs=\f[B]\f[R] -Set the path to the \f[C]mksquashfs\f[R] executable to use. -This is useful in case the parameters for the tool shall be augmented, -as the tool may be replaced by a script invoking it with the right -parameters, this way. -.TP -\f[B]\f[CB]QCow2=\f[B]\f[R], \f[B]\f[CB]--qcow2\f[B]\f[R] -Encode the resulting image as QEMU QCOW2 image. -This only applies to \f[C]gpt_ext4\f[R], \f[C]gpt_xfs\f[R], -\f[C]gpt_btrfs\f[R], \f[C]gpt_squashfs\f[R]. -QCOW2 images can be read natively by \f[C]qemu\f[R], but not by the -Linux kernel. -This means the \f[C]shell\f[R] and \f[C]boot\f[R] verbs are not -available when this option is used, however \f[C]qemu\f[R] will work. -.TP -\f[B]\f[CB]Hostname=\f[B]\f[R], \f[B]\f[CB]--hostname=\f[B]\f[R] -Set the image\[cq]s hostname to the specified name. -.TP -\f[B]\f[CB]ImageVersion=\f[B]\f[R], \f[B]\f[CB]--image-version=\f[B]\f[R] -Configure the image version. -This accepts any string, but it is recommended to specify a series of -dot separated components. -The version may also be configured in a file \f[C]mkosi.version\f[R] in -which case it may be conveniently managed via the \f[C]bump\f[R] verb or -the \f[C]--auto-bump\f[R] switch. -When specified the image version is included in the default output file -name, i.e.\ instead of \f[C]image.raw\f[R] the default will be -\f[C]image_0.1.raw\f[R] for version \f[C]0.1\f[R] of the image, and -similar. -The version is also passed via the \f[C]$IMAGE_VERSION\f[R] to any build -scripts invoked (which may be useful to patch it into -\f[C]/etc/os-release\f[R] or similar, in particular the -\f[C]IMAGE_VERSION=\f[R] field of it). -.TP -\f[B]\f[CB]ImageId=\f[B]\f[R], \f[B]\f[CB]--image-id=\f[B]\f[R] -Configure the image identifier. -This accepts a freeform string that shall be used to identify the image -with. -If set the default output file will be named after it (possibly suffixed -with the version). -If this option is used the root, \f[C]/usr/\f[R] and Verity partitions -in the image will have their labels set to this (possibly suffixed by -the image version). -The identifier is also passed via the \f[C]$IMAGE_ID\f[R] to any build -scripts invoked (which may be useful to patch it into -\f[C]/etc/os-release\f[R] or similar, in particular the -\f[C]IMAGE_ID=\f[R] field of it). -.TP -\f[B]\f[CB]WithUnifiedKernelImages=\f[B]\f[R], \f[B]\f[CB]--without-unified-kernel-images\f[B]\f[R] -If specified, mkosi does not build unified kernel images and instead -installs kernels with a separate initrd and boot loader config to the -efi or bootloader partition. -.TP -\f[B]\f[CB]HostonlyInitrd=\f[B]\f[R], \f[B]\f[CB]--hostonly-initrd\f[B]\f[R] -If specified, mkosi will run the tool to create the initrd such that a -non-generic initrd is created that will only be able to run on the -system mkosi is run on. -Currently mkosi uses dracut for all supported distributions except Clear -Linux and this option translates to enabling dracut\[cq]s hostonly -option. -.TP -\f[B]\f[CB]UsrOnly=\f[B]\f[R], \f[B]\f[CB]--usr-only\f[B]\f[R] -If specified, \f[C]mkosi\f[R] will only add the \f[C]/usr/\f[R] -directory tree (instead of the whole root file system) to the image. -This is useful for fully stateless systems that come up pristine on -every single boot, where \f[C]/etc/\f[R] and \f[C]/var/\f[R] are -populated by \f[C]systemd-tmpfiles\f[R]/\f[C]systemd-sysusers\f[R] and -related calls, or systems that are originally shipped without a root -file system, but where \f[C]systemd-repart\f[R] adds one on the first -boot. -.TP -\f[B]\f[CB]SplitArtifacts=\f[B]\f[R], \f[B]\f[CB]--split-artifacts\f[B]\f[R] -If specified and building an image with a partition table, also write -out the root file system partition, its Verity partition (if configured) -and the generated unified kernel (if configured) into separate output -files. -This is useful in A/B update scenarios where an existing disk image -shall be augmented with a new version of a root or \f[C]/usr\f[R] -partition along with its Verity partition and unified kernel. -.TP -\f[B]\f[CB]NoChown=\f[B]\f[R], \f[B]\f[CB]--no-chown\f[B]\f[R] -By default, if \f[C]mkosi\f[R] is run inside a \f[C]sudo\f[R] -environment all generated artifacts have their UNIX user/group ownership -changed to the user which invoked \f[C]sudo\f[R]. -With this option this may be turned off and all generated files are -owned by \f[C]root\f[R]. -.TP -\f[B]\f[CB]TarStripSELinuxContext=\f[B]\f[R], \f[B]\f[CB]--tar-strip-selinux-context\f[B]\f[R] -If running on a SELinux-enabled system (Fedora Linux, CentOS, Rocky -Linux, Alma Linux), files inside the container are tagged with SELinux -context extended attributes (\f[C]xattrs\f[R]), which may interfere with -host SELinux rules in building or further container import stages. -This option strips SELinux context attributes from the resulting tar -archive. -.TP -\f[B]\f[CB]MachineID=\f[B]\f[R], \f[B]\f[CB]--machine-id\f[B]\f[R] -Set the machine\[cq]s ID to the specified value. -If unused, a random ID will be used while building the image and the -final image will be shipped without a machine ID. -.SS [Content] Section -.TP -\f[B]\f[CB]BasePackages=\f[B]\f[R], \f[B]\f[CB]--base-packages\f[B]\f[R] -Takes a boolean or the special value \f[C]conditional\f[R]. -If true, automatically install packages to ensure basic functionality, -as appropriate for the given image type. -For example, \f[C]systemd\f[R] is always included, -\f[C]systemd-udev\f[R] and \f[C]dracut\f[R] if the image is bootable, -and so on. -If false, only packages specified with \f[C]Packages=\f[R] will be -installed. -If \f[C]conditional\f[R], the list of packages to install will be -extended with boolean dependencies (c.f. -https://rpm.org/user_doc/boolean_dependencies.html), to install specific -packages when \f[I]other\f[R] packages are in the list. -For example, \f[C]systemd-udev\f[R] may be automatically included if the -image is bootable and \f[C]systemd\f[R] is installed. -With this, various \[lq]base\[rq] packages still need to be specified if -they should be included, but the corresponding \[lq]extension\[rq] -packages will be added automatically when appropriate. -This feature depends on support in the package manager, so it is not -implemented for all distributions. -.TP -\f[B]\f[CB]Packages=\f[B]\f[R], \f[B]\f[CB]--package=\f[B]\f[R], \f[B]\f[CB]-p\f[B]\f[R] -Install the specified distribution packages (i.e.\ RPM, DEB, \&...) in -the image. -Takes a comma separated list of package specifications. -This option may be used multiple times in which case the specified -package lists are combined. -Packages specified this way will be installed both in the development -and the final image. -Use \f[C]BuildPackages=\f[R] to specify packages that shall only be used -for the image generated in the build image, but that shall not appear in -the final image. -The types and syntax of \[lq]package specifications\[rq] that are -allowed depend on the package installer (e.g.\ \f[C]dnf\f[R] or -\f[C]yum\f[R] for \f[C]rpm\f[R]-based distros or \f[C]apt\f[R] for -\f[C]deb\f[R]-based distros), but may include package names, package -names with version and/or architecture, package name globs, paths to -packages in the file system, package groups, and virtual provides, -including file paths. -To remove a package e.g.\ added by a \f[C]mkosi.default\f[R] -configuration file prepend the package name with \f[C]!\f[R]. -For example -p \[lq]!apache2\[rq] would remove the apache2 package. -To replace the apache2 package by the httpd package just add -p -\[lq]!apache2,httpd\[rq] to the command line arguments. -To remove all packages use \[lq]!*\[rq]. -Example: when using an distro that uses \f[C]dnf\f[R], -\f[C]Packages=meson libfdisk-devel.i686 git-* prebuilt/rpms/systemd-249-rc1.local.rpm /usr/bin/ld \[at]development-tools python3dist(mypy)\f[R] -would install the \f[C]meson\f[R] package (in the latest version), the -32-bit version of the \f[C]libfdisk-devel\f[R] package, all available -packages that start with the \f[C]git-\f[R] prefix, a \f[C]systemd\f[R] -rpm from the local file system, one of the packages that provides -\f[C]/usr/bin/ld\f[R], the packages in the \[lq]Development Tools\[rq] -group, and the package that contains the \f[C]mypy\f[R] python module. -.TP -\f[B]\f[CB]WithDocs=\f[B]\f[R], \f[B]\f[CB]--with-docs\f[B]\f[R] -Include documentation in the image built. -By default if the underlying distribution package manager supports it -documentation is not included in the image built. -The \f[C]$WITH_DOCS\f[R] environment variable passed to the -\f[C]mkosi.build\f[R] script indicates whether this option was used or -not. -.TP -\f[B]\f[CB]WithTests=\f[B]\f[R], \f[B]\f[CB]--without-tests\f[B]\f[R], \f[B]\f[CB]-T\f[B]\f[R] -If set to false (or when the command-line option is used), the -\f[C]$WITH_TESTS\f[R] environment variable is set to \f[C]0\f[R] when -the \f[C]mkosi.build\f[R] script is invoked. -This is supposed to be used by the build script to bypass any unit or -integration tests that are normally run during the source build process. -Note that this option has no effect unless the \f[C]mkosi.build\f[R] -build script honors it. -.TP -\f[B]\f[CB]Cache=\f[B]\f[R], \f[B]\f[CB]--cache=\f[B]\f[R] -Takes a path to a directory to use as package cache for the distribution -package manager used. -If this option is not used, but a \f[C]mkosi.cache/\f[R] directory is -found in the local directory it is automatically used for this purpose. -The directory configured this way is mounted into both the development -and the final image while the package manager is running. -.TP -\f[B]\f[CB]SkeletonTree=\f[B]\f[R], \f[B]\f[CB]--skeleton-tree=\f[B]\f[R] -Takes a path to a directory to copy into the OS tree before invoking the -package manager. -Use this to insert files and directories into the OS tree before the -package manager installs any packages. -If this option is not used, but the \f[C]mkosi.skeleton/\f[R] directory -is found in the local directory it is automatically used for this -purpose (also see the \[lq]Files\[rq] section below). -Instead of a directory, a tar file may be provided. -In this case it is unpacked into the OS tree before the package manager -is invoked. -This mode of operation allows setting permissions and file ownership -explicitly, in particular for projects stored in a version control -system such as \f[C]git\f[R] which retain full file ownership and access -mode metadata for committed files. -If the tar file \f[C]mkosi.skeleton.tar\f[R] is found in the local -directory it will be automatically used for this purpose. -.TP -\f[B]\f[CB]ExtraTree=\f[B]\f[R], \f[B]\f[CB]--extra-tree=\f[B]\f[R] -Takes a path to a directory to copy on top of the OS tree the package -manager generated. -Use this to override any default configuration files shipped with the -distribution. -If this option is not used, but the \f[C]mkosi.extra/\f[R] directory is -found in the local directory it is automatically used for this purpose -(also see the \[lq]Files\[rq] section below). -As with the skeleton tree logic above, instead of a directory, a tar -file may be provided too. -\f[C]mkosi.skeleton.tar\f[R] will be automatically used if found in the -local directory. -.TP -\f[B]\f[CB]CleanPackageMetadata=\f[B]\f[R], \f[B]\f[CB]--clean-package-metadata=\f[B]\f[R] -Enable/disable removal of package manager databases, caches, and logs at -the end of installation. -Can be specified as true, false, or \[lq]\f[C]auto\f[R]\[rq] (the -default). -With \[lq]\f[C]auto\f[R]\[rq], files will be removed if the respective -package manager executable is \f[I]not\f[R] present at the end of the -installation. -.TP -\f[B]\f[CB]RemoveFiles=\f[B]\f[R], \f[B]\f[CB]--remove-files=\f[B]\f[R] -Takes a comma-separated list of globs. -Files in the image matching the globs will be purged at the end. -.TP -\f[B]\f[CB]RemovePackages=\f[B]\f[R], \f[B]\f[CB]--remove-package=\f[B]\f[R] -Takes a comma-separated list of package specifications for removal, in -the same format as \f[C]Packages=\f[R]. -The removal will be performed as one of the last steps. -This step is skipped if \f[C]CleanPackageMetadata=no\f[R] is used. -This option is currently only implemented for distributions using -\f[C]dnf\f[R]. -.TP -\f[B]\f[CB]Environment=\f[B]\f[R], \f[B]\f[CB]--environment=\f[B]\f[R] -Adds variables to the environment that the -build/prepare/postinstall/finalize scripts are executed with. -Takes a space-separated list of variable assignments or just variable -names. -In the latter case, the values of those variables will be passed through -from the environment in which \f[C]mkosi\f[R] was invoked. -This option may be specified more than once, in which case all listed -variables will be set. -If the same variable is set twice, the later setting overrides the -earlier one. -.TP -\f[B]\f[CB]BuildSources=\f[B]\f[R], \f[B]\f[CB]--build-sources=\f[B]\f[R] -Takes a path to a source tree to copy into the development image, if the -build script is used. -This only applies if a build script is used, and defaults to the local -directory. -Use \f[C]SourceFileTransfer=\f[R] to configure how the files are -transferred from the host to the container image. -.TP -\f[B]\f[CB]BuildDirectory=\f[B]\f[R], \f[B]\f[CB]--build-dir=\f[B]\f[R] -Takes a path of a directory to use as build directory for build systems -that support out-of-tree builds (such as Meson). -The directory used this way is shared between repeated builds, and -allows the build system to reuse artifacts (such as object files, -executable, \&...) generated on previous invocations. -This directory is mounted into the development image when the build -script is invoked. -The build script can find the path to this directory in the -\f[C]$BUILDDIR\f[R] environment variable. -If this option is not specified, but a directory -\f[C]mkosi.builddir/\f[R] exists in the local directory it is -automatically used for this purpose (also see the \[lq]Files\[rq] -section below). -.TP -\f[B]\f[CB]IncludeDirectory=\f[B]\f[R], \f[B]\f[CB]--include-directory=\f[B]\f[R] -Takes a path of a directory to use as the include directory. -This directory is mounted at \f[C]/usr/include\f[R] when building the -build image and running the build script. -This means all include files installed to \f[C]/usr/include\f[R] will be -stored in this directory. -This is useful to make include files available on the host system for -use by language servers to provide code completion. -If this option is not specified, but a directory -\f[C]mkosi.includedir/\f[R] exists in the local directory, it is -automatically used for this purpose (also see the \[lq]Files\[rq] -section below). -.TP -\f[B]\f[CB]InstallDirectory=\f[B]\f[R], \f[B]\f[CB]--install-directory=\f[B]\f[R] -Takes a path of a directory to use as the install directory. -The directory used this way is shared between builds and allows the -build system to not have to reinstall files that were already installed -by a previous build and didn\[cq]t change. -The build script can find the path to this directory in the -\f[C]$DESTDIR\f[R] environment variable. -If this option is not specified, but a directory -\f[C]mkosi.installdir\f[R] exists in the local directory, it is -automatically used for this purpose (also see the \[lq]Files\[rq] -section below). -.TP -\f[B]\f[CB]BuildPackages=\f[B]\f[R], \f[B]\f[CB]--build-package=\f[B]\f[R] -Similar to \f[C]Packages=\f[R], but configures packages to install only -in the first phase of the build, into the development image. -This option should be used to list packages containing header files, -compilers, build systems, linkers and other build tools the -\f[C]mkosi.build\f[R] script requires to operate. -Note that packages listed here are only included in the image created -during the first phase of the build, and are absent in the final image. -Use \f[C]Packages=\f[R] to list packages that shall be included in both. -Packages are appended to the list. -Packages prefixed with \[lq]!\[rq] are removed from the list. -\[lq]!*\[rq] removes all packages from the list. -.TP -\f[B]\f[CB]Password=\f[B]\f[R], \f[B]\f[CB]--password=\f[B]\f[R] -Set the password of the \f[C]root\f[R] user. -By default the \f[C]root\f[R] account is locked. -If this option is not used, but a file \f[C]mkosi.rootpw\f[R] exists in -the local directory, the root password is automatically read from it. -.TP -\f[B]\f[CB]PasswordIsHashed=\f[B]\f[R], \f[B]\f[CB]--password-is-hashed\f[B]\f[R] -Indicate that the password supplied for the \f[C]root\f[R] user has -already been hashed, so that the string supplied with -\f[C]Password=\f[R] or \f[C]mkosi.rootpw\f[R] will be written to -\f[C]/etc/shadow\f[R] literally. -.TP -\f[B]\f[CB]Autologin=\f[B]\f[R], \f[B]\f[CB]--autologin\f[B]\f[R] -Enable autologin for the \f[C]root\f[R] user on \f[C]/dev/pts/0\f[R] -(nspawn), \f[C]/dev/tty1\f[R] (QEMU) and \f[C]/dev/ttyS0\f[R] (QEMU with -\f[C]QemuHeadless=yes\f[R]) by patching \f[C]/etc/pam.d/login\f[R]. -.TP -\f[B]\f[CB]SkipFinalPhase=\f[B]\f[R], \f[B]\f[CB]--skip-final-phase=\f[B]\f[R] -Causes the (second) final image build stage to be skipped. -This is useful in combination with a build script, for when you care -about the artifacts that were created locally in \f[C]$BUILDDIR\f[R], -but ultimately plan to discard the final image. -.TP -\f[B]\f[CB]BuildScript=\f[B]\f[R], \f[B]\f[CB]--build-script=\f[B]\f[R] -Takes a path to an executable that is used as build script for this -image. -If this option is used the build process will be two-phased instead of -single-phased. -The specified script is copied onto the development image and executed -inside an \f[C]systemd-nspawn\f[R] container environment. -If this option is not used, but the \f[C]mkosi.build\f[R] file found in -the local directory it is automatically used for this purpose (also see -the \[lq]Files\[rq] section below). -Specify an empty value to disable automatic detection. -.TP -\f[B]\f[CB]PrepareScript=\f[B]\f[R], \f[B]\f[CB]--prepare-script=\f[B]\f[R] -Takes a path to an executable that is invoked inside the image right -after installing the software packages. -It is the last step before the image is cached (if incremental mode is -enabled). -This script is invoked inside a \f[C]systemd-nspawn\f[R] container -environment, and thus does not have access to host resources. -If this option is not used, but an executable script -\f[C]mkosi.prepare\f[R] is found in the local directory, it is -automatically used for this purpose. -Specify an empty value to disable automatic detection. -.TP -\f[B]\f[CB]PostInstallationScript=\f[B]\f[R], \f[B]\f[CB]--postinst-script=\f[B]\f[R] -Takes a path to an executable that is invoked inside the final image -right after copying in the build artifacts generated in the first phase -of the build. -This script is invoked inside a \f[C]systemd-nspawn\f[R] container -environment, and thus does not have access to host resources. -If this option is not used, but an executable \f[C]mkosi.postinst\f[R] -is found in the local directory, it is automatically used for this -purpose. -Specify an empty value to disable automatic detection. -.TP -\f[B]\f[CB]FinalizeScript=\f[B]\f[R], \f[B]\f[CB]--finalize-script=\f[B]\f[R] -Takes a path to an executable that is invoked outside the final image -right after copying in the build artifacts generated in the first phase -of the build, and after having executed the \f[C]mkosi.postinst\f[R] -script (see \f[C]PostInstallationScript=\f[R]). -This script is invoked directly in the host environment, and hence has -full access to the host\[cq]s resources. -If this option is not used, but an executable \f[C]mkosi.finalize\f[R] -is found in the local directory, it is automatically used for this -purpose. -Specify an empty value to disable automatic detection. -.TP -\f[B]\f[CB]SourceFileTransfer=\f[B]\f[R], \f[B]\f[CB]--source-file-transfer=\f[B]\f[R] -Configures how the source file tree (as configured with -\f[C]BuildSources=\f[R]) is transferred into the container image during -the first phase of the build. -Takes one of \f[C]copy-all\f[R] (to copy all files from the source -tree), \f[C]copy-git-cached\f[R] (to copy only those files -\f[C]git ls-files --cached\f[R] lists), \f[C]copy-git-others\f[R] (to -copy only those files \f[C]git ls-files --others\f[R] lists), -\f[C]mount\f[R] to bind mount the source tree directly. -Defaults to \f[C]copy-git-cached\f[R] if a \f[C]git\f[R] source tree is -detected, otherwise \f[C]copy-all\f[R]. -When you specify \f[C]copy-git-more\f[R], it is the same as -\f[C]copy-git-cached\f[R], except it also includes the \f[C].git/\f[R] -directory. -.TP -\f[B]\f[CB]SourceFileTransferFinal=\f[B]\f[R], \f[B]\f[CB]--source-file-transfer-final=\f[B]\f[R] -Same as \f[C]SourceFileTransfer=\f[R], but for the final image instead -of the build image. -Takes the same values as \f[C]SourceFileFransfer=\f[R] except -\f[C]mount\f[R]. -By default, sources are not copied into the final image. -.TP -\f[B]\f[CB]SourceResolveSymlinks=\f[B]\f[R], \f[B]\f[CB]--source-resolve-symlinks\f[B]\f[R] -If given, any symbolic links in the source file tree are resolved and -the file contents are copied to the build image. -If not given, they are left as symbolic links. -This only applies if \f[C]SourceFileTransfer=\f[R] is -\f[C]copy-all\f[R]. -Defaults to leaving them as symbolic links. -.TP -\f[B]\f[CB]SourceResolveSymlinksFinal=\f[B]\f[R], \f[B]\f[CB]--source-resolve-symlinks-final\f[B]\f[R] -Same as \f[C]SourceResolveSymlinks=\f[R], but for the final image -instead of the build image. -.TP -\f[B]\f[CB]WithNetwork=\f[B]\f[R], \f[B]\f[CB]--with-network\f[B]\f[R] -When true, enables network connectivity while the build script -\f[C]mkosi.build\f[R] is invoked. -By default, the build script runs with networking turned off. -The \f[C]$WITH_NETWORK\f[R] environment variable is passed to the -\f[C]mkosi.build\f[R] build script indicating whether the build is done -with or without network. -If specified as \f[C]never\f[R], the package manager is instructed not -to contact the network for updating package data. -This provides a minimal level of reproducibility, as long as the package -data cache is already fully populated. -.TP -\f[B]\f[CB]Settings=\f[B]\f[R], \f[B]\f[CB]--settings=\f[B]\f[R] -Specifies a \f[C].nspawn\f[R] settings file for \f[C]systemd-nspawn\f[R] -to use in the \f[C]boot\f[R] and \f[C]shell\f[R] verbs, and to place -next to the generated image file. -This is useful to configure the \f[C]systemd-nspawn\f[R] environment -when the image is run. -If this setting is not used but an \f[C]mkosi.nspawn\f[R] file found in -the local directory it is automatically used for this purpose. -.SS [Partitions] Section -.TP -\f[B]\f[CB]BaseImage=\f[B]\f[R], \f[B]\f[CB]--base-image=\f[B]\f[R] -Use the specified directory or file system image as the base image, and -create the output image that consists only of changes from this base. -The base image is attached as the lower file system in an overlayfs -structure, and the output filesystem becomes the upper layer, initially -empty. -Thus files that are not modified compared to the base image are not -present in the output image. -This option may be used to create systemd \[lq]system extensions\[rq] or -portable services. -See https://systemd.io/PORTABLE_SERVICES/#extension-images for more -information. -.TP -\f[B]\f[CB]RootSize=\f[B]\f[R], \f[B]\f[CB]--root-size=\f[B]\f[R] -Takes a size in bytes for the root file system. -The specified numeric value may be suffixed with \f[C]K\f[R], -\f[C]M\f[R], \f[C]G\f[R] to indicate kilo-, mega- and gigabytes (all to -the base of 1024). -This applies to output formats \f[C]gpt_ext4\f[R], \f[C]gpt_xfs\f[R], -\f[C]gpt_btrfs\f[R]. -Defaults to 3G. -.TP -\f[B]\f[CB]ESPSize=\f[B]\f[R], \f[B]\f[CB]--esp-size=\f[B]\f[R] -Similar to \f[C]RootSize=\f[R], configures the size of the UEFI System -Partition (ESP). -This is only relevant if the \f[C]Bootable=\f[R] option is used to -generate a bootable image. -Defaults to 256 MB. -.TP -\f[B]\f[CB]SwapSize=\f[B]\f[R], \f[B]\f[CB]--swap-size=\f[B]\f[R] -Similar to \f[C]RootSize=\f[R], configures the size of a swap partition -on the image. -If omitted, no swap partition is created. -.TP -\f[B]\f[CB]HomeSize=\f[B]\f[R], \f[B]\f[CB]--home-size=\f[B]\f[R] -Similar to \f[C]RootSize=\f[R], configures the size of the -\f[C]/home\f[R] partition. -If omitted, no separate \f[C]/home\f[R] partition is created. -.TP -\f[B]\f[CB]SrvSize=\f[B]\f[R], \f[B]\f[CB]--srv-size=\f[B]\f[R] -Similar to \f[C]RootSize=\f[R], configures the size of the -\f[C]/srv\f[R] partition. -If omitted, no separate \f[C]/srv\f[R] partition is created. -.SS [Validation] Section -.TP -\f[B]\f[CB]Checksum=\f[B]\f[R], \f[B]\f[CB]--checksum\f[B]\f[R] -Generate a \f[C]SHA256SUMS\f[R] file of all generated artifacts after -the build is complete. -.TP -\f[B]\f[CB]Sign=\f[B]\f[R], \f[B]\f[CB]--sign\f[B]\f[R] -Sign the generated \f[C]SHA256SUMS\f[R] using \f[C]gpg\f[R] after -completion. -.TP -\f[B]\f[CB]Key=\f[B]\f[R], \f[B]\f[CB]--key=\f[B]\f[R] -Select the \f[C]gpg\f[R] key to use for signing \f[C]SHA256SUMS\f[R]. -This key must be already present in the \f[C]gpg\f[R] keyring. -.TP -\f[B]\f[CB]BMap=\f[B]\f[R], \f[B]\f[CB]--bmap\f[B]\f[R] -Generate a \f[C]bmap\f[R] file for usage with \f[C]bmaptool\f[R] from -the generated image file. -.SS [Host] Section -.TP -\f[B]\f[CB]ExtraSearchPaths=\f[B]\f[R], \f[B]\f[CB]--extra-search-paths=\f[B]\f[R] -List of colon-separated paths to look for tools in, before using the -regular \f[C]$PATH\f[R] search path. -.TP -\f[B]\f[CB]QemuHeadless=\f[B]\f[R], \f[B]\f[CB]--qemu-headless=\f[B]\f[R] -When used with the \f[C]build\f[R] verb, this option adds -\f[C]console=ttyS0\f[R] to the image\[cq]s kernel command line and sets -the terminal type of the serial console in the image to the terminal -type of the host (more specifically, the value of the \f[C]$TERM\f[R] -environment variable passed to mkosi). -This makes sure that all terminal features such as colors and shortcuts -still work as expected when connecting to the qemu VM over the serial -console (for example via \f[C]-nographic\f[R]). -When used with the \f[C]qemu\f[R] verb, this option adds the -\f[C]-nographic\f[R] option to \f[C]qemu\f[R]\[cq]s command line so qemu -starts a headless vm and connects to its serial console from the current -terminal instead of launching the VM in a separate window. -.TP -\f[B]\f[CB]QemuSmp=\f[B]\f[R], \f[B]\f[CB]--qemu-smp=\f[B]\f[R] -When used with the \f[C]qemu\f[R] verb, this options sets -\f[C]qemu\f[R]\[cq]s \f[C]-smp\f[R] argument which controls the number -of guest\[cq]s CPUs. -Defaults to \f[C]2\f[R]. -.TP -\f[B]\f[CB]QemuMem=\f[B]\f[R], \f[B]\f[CB]--qemu-mem=\f[B]\f[R] -When used with the \f[C]qemu\f[R] verb, this options sets -\f[C]qemu\f[R]\[cq]s \f[C]-m\f[R] argument which controls the amount of -guest\[cq]s RAM. -Defaults to \f[C]1G\f[R]. -.TP -\f[B]\f[CB]QemuKvm=\f[B]\f[R], \f[B]\f[CB]--qemu-kvm=\f[B]\f[R] -When used with the \f[C]qemu\f[R] verb, this option specifies whether -QEMU should use KVM acceleration. -Defaults to yes if the host machine supports KVM acceleration, no -otherwise. -.TP -\f[B]\f[CB]NspawnKeepUnit=\f[B]\f[R], \f[B]\f[CB]--nspawn-keep-unit\f[B]\f[R] -When used, this option instructs underlying calls of systemd-nspawn to -use the current unit scope, instead of creating a dedicated transcient -scope unit for the containers. -This option should be used when mkosi is run by a service unit. -.TP -\f[B]\f[CB]Netdev=\f[B]\f[R], \f[B]\f[CB]--netdev\f[B]\f[R] -When used with the boot or qemu verbs, this option creates a virtual -ethernet link between the host and the container/VM. -The host interface is automatically picked up by systemd-networkd as -documented in systemd-nspawn\[cq]s man page: -https://www.freedesktop.org/software/systemd/man/systemd-nspawn.html#-n -.TP -\f[B]\f[CB]Ephemeral=\f[B]\f[R], \f[B]\f[CB]--ephemeral\f[B]\f[R] -When used with the \f[C]shell\f[R], \f[C]boot\f[R], or \f[C]qemu\f[R] -verbs, this option runs the specified verb on a temporary snapshot of -the output image that is removed immediately when the container -terminates. -Taking the temporary snapshot is more efficient on file systems that -support subvolume snapshots or `reflinks' natively (\[lq]btrfs\[rq] or -new \[lq]xfs\[rq]) than on more traditional file systems that do not -(\[lq]ext4\[rq]). -.TP -\f[B]\f[CB]Ssh=\f[B]\f[R], \f[B]\f[CB]--ssh\f[B]\f[R] -If specified, installs and enables \f[C]sshd\f[R] in the final image and -generates a SSH keypair and adds the public key to root\[cq]s -\f[C]authorized_keys\f[R] in the final image. -The private key is stored in mkosi\[cq]s output directory. -When building with this option and running the image using -\f[C]mkosi boot\f[R] or \f[C]mkosi qemu\f[R], the \f[C]mkosi ssh\f[R] -command can be used to connect to the container/VM via SSH. -.TP -\f[B]\f[CB]SshKey=\f[B]\f[R], \f[B]\f[CB]--ssh-key=\f[B]\f[R] -If specified, use the given private key when connecting to the guest -machine via \f[C]mkosi ssh\f[R]. -This requires the public key counterpart to be present in the same -location, suffixed with \f[C].pub\f[R] (as done by -\f[C]ssh-keygen\f[R]). -If this option is not present, \f[C]mkosi\f[R] generates a new key pair -automatically. -.TP -\f[B]\f[CB]SshAgent=\f[B]\f[R], \f[B]\f[CB]--ssh-agent=\f[B]\f[R] -If specified as a path, use the given socket to connect to the ssh agent -when building an image and when connecting via \f[C]mkosi ssh\f[R] -instead of hard-coding a key. -If specified as \f[C]true\f[R], \f[C]$SSH_AUTH_SOCK\f[R] will be parsed -instead (hint: use \f[C]sudo\f[R] with \f[C]-E\f[R]). -The keys listed by \f[C]ssh-add -L\f[R] will be installed as authorized -keys in the built image. -The \f[C]ssh\f[R] invocation done by \f[C]mkosi ssh\f[R] will inherit -\f[C]$SSH_AUTH_SOCK\f[R] for authentication purposes. -.TP -\f[B]\f[CB]SshPort=\f[B]\f[R], \f[B]\f[CB]--ssh-port=\f[B]\f[R] -In the image, sshd will be configured to listen on this port. -\f[C]mkosi ssh\f[R] will connect to this port. -.TP -\f[B]\f[CB]SshTimeout=\f[B]\f[R], \f[B]\f[CB]--ssh-timeout=\f[B]\f[R] -When used with the \f[C]ssh\f[R] verb, \f[C]mkosi\f[R] will attempt to -retry the SSH connection up to given timeout (in seconds) in case it -fails. -This option is useful mainly in scripted environments where the -\f[C]qemu\f[R] and \f[C]ssh\f[R] verbs are used in a quick succession -and the virtual device might not get enough time to configure itself. -.SS Commandline-only Options -.PP -Those settings cannot be configured in the configuration files. -.TP -\f[B]\f[CB]--directory=\f[B]\f[R], \f[B]\f[CB]-C\f[B]\f[R] -Takes a path to a directory. -\f[C]mkosi\f[R] switches to this directory before doing anything. -Note that the various \f[C]mkosi.*\f[R] files are searched for only -after changing to this directory, hence using this option is an -effective way to build a project located in a specific directory. -.TP -\f[B]\f[CB]--default=\f[B]\f[R] -Loads additional settings from the specified settings file. -Most command line options may also be configured in a settings file. -See the table below to see which command line options match which -settings file option. -If this option is not used, but a file \f[C]mkosi.default\f[R] is found -in the local directory it is automatically used for this purpose. -If a setting is configured both on the command line and in the settings -file, the command line generally wins, except for options taking lists -in which case both lists are combined. -.TP -\f[B]\f[CB]--all\f[B]\f[R], \f[B]\f[CB]-a\f[B]\f[R] -Iterate through all files \f[C]mkosi.*\f[R] in the -\f[C]mkosi.files/\f[R] subdirectory, and build each as if -\f[C]--default=mkosi.files/mkosi.\&...\f[R] was invoked. -This is a quick way to build a large number of images in one go. -Any additional specified command line arguments override the relevant -options in all files processed this way. -.TP -\f[B]\f[CB]--all-directory=\f[B]\f[R] -If specified, overrides the directory the \f[C]--all\f[R] logic -described above looks for settings files in. -If unspecified, defaults to \f[C]mkosi.files/\f[R] in the current -working directory. -.TP -\f[B]\f[CB]--incremental\f[B]\f[R], \f[B]\f[CB]-i\f[B]\f[R] -Enable incremental build mode. -This only applies if the two-phase \f[C]mkosi.build\f[R] build script -logic is used. -In this mode, a copy of the OS image is created immediately after all OS -packages are unpacked but before the \f[C]mkosi.build\f[R] script is -invoked in the development container. -Similarly, a copy of the final image is created immediately before the -build artifacts from the \f[C]mkosi.build\f[R] script are copied in. -On subsequent invocations of \f[C]mkosi\f[R] with the \f[C]-i\f[R] -switch these cached images may be used to skip the OS package unpacking, -thus drastically speeding up repetitive build times. -Note that when this is used and a pair of cached incremental images -exists they are not automatically regenerated, even if options such as -\f[C]Packages=\f[R] are modified. -In order to force rebuilding of these cached images, combine -\f[C]-i\f[R] with \f[C]-ff\f[R] to ensure cached images are first -removed and then re-created. -.TP -\f[B]\f[CB]--debug=\f[B]\f[R] -Enable additional debugging output. -Takes a comma-separated list of arguments specifying the area of -interest. -Pass any invalid value (e.g.\ empty) to list currently accepted values. -.TP -\f[B]\f[CB]--version\f[B]\f[R] -Show package version. -.TP -\f[B]\f[CB]--help\f[B]\f[R], \f[B]\f[CB]-h\f[B]\f[R] -Show brief usage information. -.TP -\f[B]\f[CB]--auto-bump\f[B]\f[R], \f[B]\f[CB]-B\f[B]\f[R] -If specified, after each successful build the the version is bumped in a -fashion equivalent to the \f[C]bump\f[R] verb, in preparation for the -next build. -This is useful for simple, linear version management: each build in a -series will have a version number one higher then the previous one. -.SS Supported distributions -.PP -Images may be created containing installations of the following -operating systems: -.IP \[bu] 2 -\f[I]Fedora Linux\f[R] -.IP \[bu] 2 -\f[I]Debian\f[R] -.IP \[bu] 2 -\f[I]Ubuntu\f[R] -.IP \[bu] 2 -\f[I]Arch Linux\f[R] -.IP \[bu] 2 -\f[I]openSUSE\f[R] -.IP \[bu] 2 -\f[I]Mageia\f[R] -.IP \[bu] 2 -\f[I]CentOS\f[R] -.IP \[bu] 2 -\f[I]Clear Linux\f[R] -.IP \[bu] 2 -\f[I]Photon\f[R] -.IP \[bu] 2 -\f[I]OpenMandriva\f[R] -.IP \[bu] 2 -\f[I]Rocky Linux\f[R] -.IP \[bu] 2 -\f[I]Alma Linux\f[R] -.IP \[bu] 2 -\f[I]Gentoo\f[R] -.PP -In theory, any distribution may be used on the host for building images -containing any other distribution, as long as the necessary tools are -available. -Specifically, any distribution that packages \f[C]debootstrap\f[R] may -be used to build \f[I]Debian\f[R] or \f[I]Ubuntu\f[R] images. -Any distribution that packages \f[C]dnf\f[R] may be used to build -\f[I]Fedora Linux\f[R], \f[I]Mageia\f[R] or \f[I]OpenMandriva\f[R] -images. -Any distro that packages \f[C]pacstrap\f[R] may be used to build -\f[I]Arch Linux\f[R] images. -Any distribution that packages \f[C]zypper\f[R] may be used to build -\f[I]openSUSE\f[R] images. -Any distribution that packages \f[C]yum\f[R] (or the newer replacement -\f[C]dnf\f[R]) may be used to build \f[I]CentOS\f[R], \f[I]Rocky -Linux\f[R], or \f[I]Alma Linux\f[R] images. -Any distribution that packages \f[C]emerge\f[R] may be used to build -\f[I]Gentoo\f[R] images. -.PP -Currently, \f[I]Fedora Linux\f[R] packages all relevant tools as of -Fedora 28. -.SS Compatibility -.PP -Legacy concepts are avoided: generated images use \f[I]GPT\f[R] disk -labels (and no \f[I]MBR\f[R] labels), and only systemd-based images may -be generated. -.PP -All generated \f[I]GPT\f[R] disk images may be booted in a local -container directly with: -.IP -.nf -\f[C] -systemd-nspawn -bi image.raw -\f[R] -.fi -.PP -Additionally, bootable \f[I]GPT\f[R] disk images (as created with the -\f[C]--bootable\f[R] flag) work when booted directly by \f[I]EFI\f[R] -and \f[I]BIOS\f[R] systems, for example in \f[I]KVM\f[R] via: -.IP -.nf -\f[C] -qemu-kvm -m 512 -smp 2 -bios /usr/share/edk2/ovmf/OVMF_CODE.fd -drive format=raw,file=image.raw -\f[R] -.fi -.PP -\f[I]EFI\f[R] bootable \f[I]GPT\f[R] images are larger than plain -\f[I]GPT\f[R] images, as they additionally carry an \f[I]EFI\f[R] system -partition containing a boot loader, as well as a kernel, kernel modules, -udev and more. -.PP -All directory or btrfs subvolume images may be booted directly with: -.IP -.nf -\f[C] -systemd-nspawn -bD image -\f[R] -.fi -.SH Files -.PP -To make it easy to build images for development versions of your -projects, mkosi can read configuration data from the local directory, -under the assumption that it is invoked from a \f[I]source\f[R] tree. -Specifically, the following files are used if they exist in the local -directory: -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.default\f[B]\f[R] file provides the default -configuration for the image building process. -For example, it may specify the distribution to use (\f[C]fedora\f[R], -\f[C]ubuntu\f[R], \f[C]debian\f[R], \f[C]arch\f[R], \f[C]opensuse\f[R], -\f[C]mageia\f[R], \f[C]openmandriva\f[R], \f[C]gentoo\f[R]) for the -image, or additional distribution packages to install. -Note that all options encoded in this configuration file may also be set -on the command line, and this file is hence little more than a way to -make sure invoking \f[C]mkosi\f[R] without further parameters in your -\f[I]source\f[R] tree is enough to get the right image of your choice -set up. -.RS 2 -.PP -Additionally, if a \f[I]\f[CI]mkosi.default.d/\f[I]\f[R] directory -exists, each file in it is loaded in the same manner adding/overriding -the values specified in \f[C]mkosi.default\f[R]. -If \f[C]mkosi.default.d/\f[R] contains a directory named after the -distribution being built, each file in that directory is also processed. -.PP -The file format is inspired by Windows \f[C].ini\f[R] files and supports -multi-line assignments: any line with initial whitespace is considered a -continuation line of the line before. -Command-line arguments, as shown in the help description, have to be -included in a configuration block (e.g.\ \[lq]\f[C][Content]\f[R]\[rq]) -corresponding to the argument group (e.g.\ \[lq]\f[C]Content\f[R]\[rq]), -and the argument gets converted as follows: -\[lq]\f[C]--with-network\f[R]\[rq] becomes -\[lq]\f[C]WithNetwork=yes\f[R]\[rq]. -For further details see the table above. -.RE -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.skeleton/\f[B]\f[R] directory or -\f[B]\f[CB]mkosi.skeleton.tar\f[B]\f[R] archive may be used to insert -files into the image. -The files are copied \f[I]before\f[R] the distribution packages are -installed into the image. -This allows creation of files that need to be provided early, for -example to configure the package manager or set systemd presets. -.RS 2 -.PP -When using the directory, file ownership is not preserved: all files -copied will be owned by root. -To preserve ownership, use a tar archive. -.RE -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.extra/\f[B]\f[R] directory or -\f[B]\f[CB]mkosi.extra.tar\f[B]\f[R] archive may be used to insert -additional files into the image, on top of what the distribution -includes in its packages. -They are similar to \f[C]mkosi.skeleton/\f[R] and -\f[C]mkosi.skeleton.tar\f[R], but the files are copied into the -directory tree of the image \f[I]after\f[R] the OS was installed. -.RS 2 -.PP -When using the directory, file ownership is not preserved: all files -copied will be owned by root. -To preserve ownership, use a tar archive. -.RE -.IP \[bu] 2 -\f[B]\f[CB]mkosi.build\f[B]\f[R] may be an executable script. -If it exists, the image will be built twice: the first iteration will be -the \f[I]development\f[R] image, the second iteration will be the -\f[I]final\f[R] image. -The \f[I]development\f[R] image is used to build the project in the -current working directory (the \f[I]source\f[R] tree). -For that the whole directory is copied into the image, along with the -\f[C]mkosi.build\f[R] script. -The script is then invoked inside the image (via -\f[C]systemd-nspawn\f[R]), with \f[C]$SRCDIR\f[R] pointing to the -\f[I]source\f[R] tree. -\f[C]$DESTDIR\f[R] points to a directory where the script should place -any files generated it would like to end up in the \f[I]final\f[R] -image. -Note that \f[C]make\f[R]/\f[C]automake\f[R]/\f[C]meson\f[R] based build -systems generally honor \f[C]$DESTDIR\f[R], thus making it very natural -to build \f[I]source\f[R] trees from the build script. -After the \f[I]development\f[R] image was built and the build script ran -inside of it, it is removed again. -After that the \f[I]final\f[R] image is built, without any -\f[I]source\f[R] tree or build script copied in. -However, this time the contents of \f[C]$DESTDIR\f[R] are added into the -image. -.RS 2 -.PP -When the source tree is copied into the \f[I]build\f[R] image, all files -are copied, except for \f[C]mkosi.builddir/\f[R], \f[C]mkosi.cache/\f[R] -and \f[C]mkosi.output/\f[R]. -That said, \f[C].gitignore\f[R] is respected if the source tree is a -\f[C]git\f[R] checkout. -If multiple different images shall be built from the same source tree it -is essential to exclude their output files from this copy operation, as -otherwise a version of an image built earlier might be included in a -later build, which is usually not intended. -An alternative to excluding these built images via \f[C].gitignore\f[R] -entries is to use the \f[C]mkosi.output/\f[R] directory, which is an -easy way to exclude all build artifacts. -.PP -The \f[C]$MKOSI_DEFAULT\f[R] environment variable will be set inside of -this script so that you know which \f[C]mkosi.default\f[R] (if any) was -passed in. -.RE -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.prepare\f[B]\f[R] script is invoked directly after -the software packages are installed, from within the image context, if -it exists. -It is once called for the \f[I]development\f[R] image (if this is -enabled, see above) with the \[lq]build\[rq] command line parameter, -right before copying the extra tree. -It is called a second time for the \f[I]final\f[R] image with the -\[lq]final\[rq] command line parameter. -This script has network access and may be used to install packages from -other sources than the distro\[cq]s package manager -(e.g.\ \f[C]pip\f[R], \f[C]npm\f[R], \&...), after all software packages -are installed but before the image is cached (if incremental mode is -enabled). -This script is executed within \f[C]$SRCDIR\f[R]. -In contrast to a general purpose installation, it is safe to install -packages to the system (\f[C]pip install\f[R], -\f[C]npm install -g\f[R]) instead of in \f[C]$SRCDIR\f[R] itself -because the build image is only used for a single project and can easily -be thrown away and rebuilt so there\[cq]s no risk of conflicting -dependencies and no risk of polluting the host system. -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.postinst\f[B]\f[R] script is invoked as the -penultimate step of preparing an image, from within the image context, -if it exists. -It is called first for the \f[I]development\f[R] image (if this is -enabled, see above) with the \[lq]build\[rq] command line parameter, -right before invoking the build script. -It is called a second time for the \f[I]final\f[R] image with the -\[lq]final\[rq] command line parameter, right before the image is -considered complete. -This script may be used to alter the images without any restrictions, -after all software packages and built sources have been installed. -Note that this script is executed directly in the image context with the -final root directory in place, without any -\f[C]$SRCDIR\f[R]/\f[C]$DESTDIR\f[R] setup. -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.finalize\f[B]\f[R] script, if it exists, is invoked -as last step of preparing an image, from the host system. -It is once called for the \f[I]development\f[R] image (if this is -enabled, see above) with the \[lq]build\[rq] command line parameter, as -the last step before invoking the build script, after the -\f[C]mkosi.postinst\f[R] script is invoked. -It is called the second time with the \[lq]final\[rq] command line -parameter as the last step before the image is considered complete. -The environment variable \f[C]$BUILDROOT\f[R] points to the root -directory of the installation image. -Additional verbs may be added in the future, the script should be -prepared for that. -This script may be used to alter the images without any restrictions, -after all software packages and built sources have been installed. -This script is more flexible than \f[C]mkosi.postinst\f[R] in two -regards: it has access to the host file system so it\[cq]s easier to -copy in additional files or to modify the image based on external -configuration, and the script is run in the host, so it can be used even -without emulation even if the image has a foreign architecture. -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.mksquashfs-tool\f[B]\f[R] script, if it exists, -will be called wherever \f[C]mksquashfs\f[R] would be called. -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.nspawn\f[B]\f[R] nspawn settings file will be -copied into the same place as the output image file, if it exists. -This is useful since nspawn looks for settings files next to image files -it boots, for additional container runtime settings. -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.cache/\f[B]\f[R] directory, if it exists, is -automatically used as package download cache, in order to speed repeated -runs of the tool. -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.builddir/\f[B]\f[R] directory, if it exists, is -automatically used as out-of-tree build directory, if the build commands -in the \f[C]mkosi.build\f[R] script support it. -Specifically, this directory will be mounted into the build container, -and the \f[C]$BUILDDIR\f[R] environment variable will be set to it when -the build script is invoked. -The build script may then use this directory as build directory, for -automake-style or ninja-style out-of-tree builds. -This speeds up builds considerably, in particular when \f[C]mkosi\f[R] -is used in incremental mode (\f[C]-i\f[R]): not only the disk images, -but also the build tree is reused between subsequent invocations. -Note that if this directory does not exist the \f[C]$BUILDDIR\f[R] -environment variable is not set, and it is up to build script to decide -whether to do in in-tree or an out-of-tree build, and which build -directory to use. -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.includedir/\f[B]\f[R] directory, if it exists, is -automatically used as an out-of-tree include directory for header files. -Specifically, it will be mounted in the build container at -\f[C]/usr/include/\f[R] when building the build image and when running -the build script. -After building the (cached) build image, this directory will contain all -the files installed to \f[C]/usr/include\f[R]. -Language servers or other tools can use these files to provide a better -editing experience for developers working on a project. -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.installdir/\f[B]\f[R] directory, if it exists, is -automatically used as the install directory. -Specifically, this directory will be mounted into the container at -\f[C]/root/dest\f[R] when running the build script. -After running the build script, the contents of this directory are -installed into the final image. -This is useful to cache the install step of the build. -If used, subsequent builds will only have to reinstall files that have -changed since the previous build. -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.rootpw\f[B]\f[R] file can be used to provide the -password or hashed password (if \f[C]--password-is-hashed\f[R] is set) -for the root user of the image. -The password may optionally be followed by a newline character which is -implicitly removed. -The file must have an access mode of 0600 or less. -If this file does not exist, the distribution\[cq]s default root -password is set (which usually means access to the root user is -blocked). -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.passphrase\f[B]\f[R] file provides the passphrase -to use when LUKS encryption is selected. -It should contain the passphrase literally, and not end in a newline -character (i.e.\ in the same format as cryptsetup and -\f[C]/etc/crypttab\f[R] expect the passphrase files). -The file must have an access mode of 0600 or less. -If this file does not exist and encryption is requested, the user is -queried instead. -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.secure-boot.crt\f[B]\f[R] and -\f[B]\f[CB]mkosi.secure-boot.key\f[B]\f[R] files contain an X.509 -certificate and PEM private key to use when UEFI SecureBoot support is -enabled. -All EFI binaries included in the image\[cq]s ESP are signed with this -key, as a late step in the build process. -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.output/\f[B]\f[R] directory will be used for all -build artifacts, if the image output path is not configured (i.e.\ no -\f[C]--output=\f[R] setting specified), or configured to a filename -(i.e.\ a path containing no \f[C]/\f[R] character). -This includes the image itself, the root hash file in case Verity is -used, the checksum and its signature if that\[cq]s enabled, and the -nspawn settings file if there is any. -Note that this directory is not used if the image output path contains -at least one slash, and has no effect in that case. -This setting is particularly useful if multiple different images shall -be built from the same working directory, as otherwise the build result -of a preceding run might be copied into a build image as part of the -source tree (see above). -.IP \[bu] 2 -The \f[B]\f[CB]mkosi.reposdir/\f[B]\f[R] directory, if it exists, is -automatically used as the repository directory for extra repository -files. -See the \f[C]RepositoryDirectory\f[R] option for more information. -.PP -All these files are optional. -.PP -Note that the location of all these files may also be configured during -invocation via command line switches, and as settings in -\f[C]mkosi.default\f[R], in case the default settings are not acceptable -for a project. -.SH BUILD PHASES -.PP -If no build script \f[C]mkosi.build\f[R] (see above) is used the build -consists of a single phase only: the final image is generated as the -combination of \f[C]mkosi.skeleton/\f[R] (see above), the unpacked -distribution packages and \f[C]mkosi.extra/\f[R]. -.PP -If a build script \f[C]mkosi.build\f[R] is used the build consists of -two phases: in the the first \f[C]development\f[R] phase an image that -includes necessary build tools (i.e.\ the combination of -\f[C]Packages=\f[R] and \f[C]BuildPackages=\f[R] is installed) is -generated (i.e.\ the combination of \f[C]mkosi.skeleton/\f[R] and -unpacked distribution packages). -Into this image the source tree is copied and \f[C]mkosi.build\f[R] -executed. -The artifacts the \f[C]mkosi.build\f[R] generates are saved. -Then, the second \f[C]final\f[R] phase starts: an image that excludes -the build tools (i.e.\ only \f[C]Packages=\f[R] is installed, -\f[C]BuildPackages=\f[R] is not) is generated. -This time the build artifacts saved from the first phase are copied in, -and \f[C]mkosi.extra\f[R] copied on top, thus generating the final -image. -.PP -The two-phased approach ensures that source tree is executed in a clean -and comprehensive environment, while at the same the final image remains -minimal and contains only those packages necessary at runtime, but -avoiding those necessary at build-time. -.PP -Note that only the package cache \f[C]mkosi.cache/\f[R] is shared -between the two phases. -The distribution package manager is executed exactly once in each phase, -always starting from a directory tree that is populated with -\f[C]mkosi.skeleton\f[R] but nothing else. -.SH CACHING -.PP -\f[C]mkosi\f[R] supports three different caches for speeding up -repetitive re-building of images. -Specifically: -.IP "1." 3 -The package cache of the distribution package manager may be cached -between builds. -This is configured with the \f[C]--cache=\f[R] option or the -\f[C]mkosi.cache/\f[R] directory. -This form of caching relies on the distribution\[cq]s package manager, -and caches distribution packages (RPM, DEB, \&...) after they are -downloaded, but before they are unpacked. -.IP "2." 3 -If an \f[C]mkosi.build\f[R] script is used, by enabling incremental -build mode with \f[C]--incremental\f[R], a cached copy of the -development and final images can be made immediately before the build -sources are copied in (for the development image) or the artifacts -generated by \f[C]mkosi.build\f[R] are copied in (in case of the final -image). -This form of caching allows bypassing the time-consuming package -unpacking step of the distribution package managers, but is only -effective if the list of packages to use remains stable, but the build -sources and its scripts change regularly. -Note that this cache requires manual flushing: whenever the package list -is modified the cached images need to be explicitly removed before the -next re-build, using the \f[C]-f\f[R] switch. -.IP "3." 3 -Finally, between multiple builds the build artifact directory may be -shared, using the \f[C]mkosi.builddir/\f[R] directory. -This directory allows build systems such as Meson to reuse already -compiled sources from a previous built, thus speeding up the build -process of the \f[C]mkosi.build\f[R] build script. -.PP -The package cache (i.e.\ the first item above) is unconditionally -useful. -The latter two caches only apply to uses of \f[C]mkosi\f[R] with a -source tree and build script. -When all three are enabled together turn-around times for complete image -builds are minimal, as only changed source files need to be recompiled: -an OS image rebuilt will be almost as quick to build the source tree -only. -.SH ENVIRONMENT VARIABLES -.PP -The build script \f[C]mkosi.build\f[R] receives the following -environment variables: -.IP \[bu] 2 -\f[C]$SRCDIR\f[R] contains the path to the sources to build. -.IP \[bu] 2 -\f[C]$DESTDIR\f[R] is a directory into which any artifacts generated by -the build script shall be placed. -.IP \[bu] 2 -\f[C]$BUILDDIR\f[R] is only defined if \f[C]mkosi.builddir\f[R] and -points to the build directory to use. -This is useful for all build systems that support out-of-tree builds to -reuse already built artifacts from previous runs. -.IP \[bu] 2 -\f[C]$WITH_DOCS\f[R] is either \f[C]0\f[R] or \f[C]1\f[R] depending on -whether a build without or with installed documentation was requested -(\f[C]WithDocs=yes\f[R]). -The build script should suppress installation of any package -documentation to \f[C]$DESTDIR\f[R] in case \f[C]$WITH_DOCS\f[R] is set -to \f[C]0\f[R]. -.IP \[bu] 2 -\f[C]$WITH_TESTS\f[R] is either \f[C]0\f[R]or \f[C]1\f[R] depending on -whether a build without or with running the test suite was requested -(\f[C]WithTests=no\f[R]). -The build script should avoid running any unit or integration tests in -case \f[C]$WITH_TESTS\f[R] is \f[C]0\f[R]. -.IP \[bu] 2 -\f[C]$WITH_NETWORK\f[R] is either \f[C]0\f[R]or \f[C]1\f[R] depending on -whether a build without or with networking is being executed -(\f[C]WithNetwork=no\f[R]). -The build script should avoid any network communication in case -\f[C]$WITH_NETWORK\f[R] is \f[C]0\f[R]. -.SH EXAMPLES -.PP -Create and run a raw \f[I]GPT\f[R] image with \f[I]ext4\f[R], as -\f[C]image.raw\f[R]: -.IP -.nf -\f[C] -# mkosi --bootable --incremental boot -\f[R] -.fi -.PP -Create and run a bootable btrfs \f[I]GPT\f[R] image, as -\f[C]foobar.raw\f[R]: -.IP -.nf -\f[C] -# mkosi --format gpt_btrfs --bootable -o foobar.raw -# mkosi --output foobar.raw boot -# mkosi --output foobar.raw qemu -\f[R] -.fi -.PP -Create and run a \f[I]Fedora Linux\f[R] image into a plain directory: -.IP -.nf -\f[C] -# mkosi --distribution fedora --format directory boot -\f[R] -.fi -.PP -Create a compressed image \f[C]image.raw.xz\f[R] and add a checksum -file, and install \f[I]SSH\f[R] into it: -.IP -.nf -\f[C] -# mkosi --distribution fedora --format gpt_squashfs --checksum --compress --package=openssh-clients -\f[R] -.fi -.PP -Inside the source directory of an \f[C]automake\f[R]-based project, -configure \f[I]mkosi\f[R] so that simply invoking \f[C]mkosi\f[R] -without any parameters builds an OS image containing a built version of -the project in its current state: -.IP -.nf -\f[C] -# cat >mkosi.default <<EOF -[Distribution] -Distribution=fedora -Release=24 - -[Output] -Format=gpt_btrfs -Bootable=yes - -[Content] -Packages=openssh-clients,httpd -BuildPackages=make,gcc,libcurl-devel -EOF -# cat >mkosi.build <<EOF -#!/bin/sh -cd $SRCDIR -\&./autogen.sh -\&./configure --prefix=/usr -make -j \[ga]nproc\[ga] -make install -EOF -# chmod +x mkosi.build -# mkosi --bootable --incremental boot -# systemd-nspawn -bi image.raw -\f[R] -.fi -.PP -To create a \f[I]Fedora Linux\f[R] image with hostname: -.IP -.nf -\f[C] -# mkosi --distribution fedora --hostname image -\f[R] -.fi -.PP -Also you could set hostname in configuration file: -.IP -.nf -\f[C] -# cat mkosi.default -\&... -[Output] -Hostname=image -\&... -\f[R] -.fi -.SH REQUIREMENTS -.PP -mkosi is packaged for various distributions: Debian, Ubuntu, Arch Linux, -Fedora Linux, OpenMandriva, Gentoo. -It is usually easiest to use the distribution package. -.PP -The current version requires systemd 233 (or actually, systemd-nspawn of -it). -.PP -When not using distribution packages make sure to install the necessary -dependencies. -For example, on \f[I]Fedora Linux\f[R] you need: -.IP -.nf -\f[C] -dnf install arch-install-scripts btrfs-progs debootstrap dosfstools edk2-ovmf e2fsprogs squashfs-tools gnupg python3 tar veritysetup xfsprogs xz zypper sbsigntools -\f[R] -.fi -.PP -On Debian/Ubuntu it might be necessary to install the -\f[C]ubuntu-keyring\f[R], \f[C]ubuntu-archive-keyring\f[R] and/or -\f[C]debian-archive-keyring\f[R] packages explicitly, in addition to -\f[C]debootstrap\f[R], depending on what kind of distribution images you -want to build. -\f[C]debootstrap\f[R] on Debian only pulls in the Debian keyring on its -own, and the version on Ubuntu only the one from Ubuntu. -.PP -Note that the minimum required Python version is 3.7. -.SH REFERENCES -.IP \[bu] 2 -Primary mkosi git repository on -GitHub (https://github.com/systemd/mkosi/) -.IP \[bu] 2 -mkosi \[em] A Tool for Generating OS -Images (http://0pointer.net/blog/mkosi-a-tool-for-generating-os-images.html) -introductory blog post by Lennart Poettering -.IP \[bu] 2 -The mkosi OS generation tool (https://lwn.net/Articles/726655/) story on -LWN -.SH SEE ALSO -.PP -\f[C]systemd-nspawn(1)\f[R], \f[C]dnf(8)\f[R], \f[C]debootstrap(8)\f[R] -.SH AUTHORS -The mkosi Authors. diff --git a/upstream/fedora-rawhide/man1/mktemp.1 b/upstream/fedora-rawhide/man1/mktemp.1 index 98f629d6..84a9ef04 100644 --- a/upstream/fedora-rawhide/man1/mktemp.1 +++ b/upstream/fedora-rawhide/man1/mktemp.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH MKTEMP "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH MKTEMP "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME mktemp \- create a temporary file or directory .SH SYNOPSIS @@ -50,7 +50,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/msgattrib.1 b/upstream/fedora-rawhide/man1/msgattrib.1 index 2e3f46a6..86fa7bb9 100644 --- a/upstream/fedora-rawhide/man1/msgattrib.1 +++ b/upstream/fedora-rawhide/man1/msgattrib.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGATTRIB "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGATTRIB "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msgattrib \- attribute matching and manipulation on message catalog .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msgcat.1 b/upstream/fedora-rawhide/man1/msgcat.1 index fc46da0b..777261b9 100644 --- a/upstream/fedora-rawhide/man1/msgcat.1 +++ b/upstream/fedora-rawhide/man1/msgcat.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGCAT "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGCAT "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msgcat \- combines several message catalogs .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msgcmp.1 b/upstream/fedora-rawhide/man1/msgcmp.1 index 5d501e40..d46d6b86 100644 --- a/upstream/fedora-rawhide/man1/msgcmp.1 +++ b/upstream/fedora-rawhide/man1/msgcmp.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGCMP "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGCMP "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msgcmp \- compare message catalog and template .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msgcomm.1 b/upstream/fedora-rawhide/man1/msgcomm.1 index cdf7afc1..2953274b 100644 --- a/upstream/fedora-rawhide/man1/msgcomm.1 +++ b/upstream/fedora-rawhide/man1/msgcomm.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGCOMM "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGCOMM "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msgcomm \- match two message catalogs .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msgconv.1 b/upstream/fedora-rawhide/man1/msgconv.1 index df92e1d3..f51df90b 100644 --- a/upstream/fedora-rawhide/man1/msgconv.1 +++ b/upstream/fedora-rawhide/man1/msgconv.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGCONV "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGCONV "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msgconv \- character set conversion for message catalog .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msgen.1 b/upstream/fedora-rawhide/man1/msgen.1 index cd48ffdc..9450beaa 100644 --- a/upstream/fedora-rawhide/man1/msgen.1 +++ b/upstream/fedora-rawhide/man1/msgen.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGEN "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGEN "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msgen \- create English message catalog .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msgexec.1 b/upstream/fedora-rawhide/man1/msgexec.1 index 01d8fb61..c07367a4 100644 --- a/upstream/fedora-rawhide/man1/msgexec.1 +++ b/upstream/fedora-rawhide/man1/msgexec.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGEXEC "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGEXEC "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msgexec \- process translations of message catalog .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msgfilter.1 b/upstream/fedora-rawhide/man1/msgfilter.1 index 4f82e93e..869a82c5 100644 --- a/upstream/fedora-rawhide/man1/msgfilter.1 +++ b/upstream/fedora-rawhide/man1/msgfilter.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGFILTER "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGFILTER "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msgfilter \- edit translations of message catalog .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msgfmt.1 b/upstream/fedora-rawhide/man1/msgfmt.1 index 06a1eeef..8844bbe2 100644 --- a/upstream/fedora-rawhide/man1/msgfmt.1 +++ b/upstream/fedora-rawhide/man1/msgfmt.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGFMT "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGFMT "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msgfmt \- compile message catalog to binary format .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msggrep.1 b/upstream/fedora-rawhide/man1/msggrep.1 index 09415872..87ca3250 100644 --- a/upstream/fedora-rawhide/man1/msggrep.1 +++ b/upstream/fedora-rawhide/man1/msggrep.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGGREP "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGGREP "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msggrep \- pattern matching on message catalog .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msginit.1 b/upstream/fedora-rawhide/man1/msginit.1 index ca902fa7..8e80e9d2 100644 --- a/upstream/fedora-rawhide/man1/msginit.1 +++ b/upstream/fedora-rawhide/man1/msginit.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGINIT "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGINIT "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msginit \- initialize a message catalog .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msgmerge.1 b/upstream/fedora-rawhide/man1/msgmerge.1 index 8e0c6b50..afd8adbb 100644 --- a/upstream/fedora-rawhide/man1/msgmerge.1 +++ b/upstream/fedora-rawhide/man1/msgmerge.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGMERGE "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGMERGE "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msgmerge \- merge message catalog and template .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msgunfmt.1 b/upstream/fedora-rawhide/man1/msgunfmt.1 index c9617bba..5bca3278 100644 --- a/upstream/fedora-rawhide/man1/msgunfmt.1 +++ b/upstream/fedora-rawhide/man1/msgunfmt.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGUNFMT "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGUNFMT "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msgunfmt \- uncompile message catalog from binary format .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/msguniq.1 b/upstream/fedora-rawhide/man1/msguniq.1 index 6d6a1d5b..84a1949f 100644 --- a/upstream/fedora-rawhide/man1/msguniq.1 +++ b/upstream/fedora-rawhide/man1/msguniq.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH MSGUNIQ "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH MSGUNIQ "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME msguniq \- unify duplicate translations in message catalog .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/mtrace.1 b/upstream/fedora-rawhide/man1/mtrace.1 index 0483a31b..3ade2ff5 100644 --- a/upstream/fedora-rawhide/man1/mtrace.1 +++ b/upstream/fedora-rawhide/man1/mtrace.1 @@ -1,7 +1,7 @@ .\" Copyright (c) 2013, Peter Schiffer (pschiffe@redhat.com) .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH mtrace 1 2023-10-31 "Linux man-pages 6.06" +.TH mtrace 1 2023-10-31 "Linux man-pages 6.7" .SH NAME mtrace \- interpret the malloc trace log .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/mv.1 b/upstream/fedora-rawhide/man1/mv.1 index e5b9cd10..731c0ecb 100644 --- a/upstream/fedora-rawhide/man1/mv.1 +++ b/upstream/fedora-rawhide/man1/mv.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH MV "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH MV "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME mv \- move (rename) files .SH SYNOPSIS @@ -27,6 +27,9 @@ like \fB\-\-backup\fR but does not accept an argument \fB\-\-debug\fR explain how a file is copied. Implies \fB\-v\fR .TP +\fB\-\-exchange\fR +exchange source and destination +.TP \fB\-f\fR, \fB\-\-force\fR do not prompt before overwriting .TP @@ -56,10 +59,10 @@ treat DEST as a normal file .TP \fB\-\-update\fR[=\fI\,UPDATE\/\fR] control which existing files are updated; -UPDATE={all,none,older(default)}. See below +UPDATE={all,none,none\-fail,older(default)}. .TP \fB\-u\fR -equivalent to \fB\-\-update\fR[=\fI\,older\/\fR] +equivalent to \fB\-\-update\fR[=\fI\,older\/\fR]. See below .TP \fB\-v\fR, \fB\-\-verbose\fR explain what is being done @@ -77,8 +80,10 @@ output version information and exit UPDATE controls which existing files in the destination are replaced. \&'all' is the default operation when an \fB\-\-update\fR option is not specified, and results in all existing files in the destination being replaced. -\&'none' is similar to the \fB\-\-no\-clobber\fR option, in that no files in the -destination are replaced, but also skipped files do not induce a failure. +\&'none' is like the \fB\-\-no\-clobber\fR option, in that no files in the +destination are replaced, and skipped files do not induce a failure. +\&'none\-fail' also ensures no files are replaced in the destination, +but any skipped files are diagnosed and induce a failure. \&'older' is the default operation when \fB\-\-update\fR is specified, and results in files being replaced if they're older than the corresponding source file. .PP @@ -104,7 +109,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/nano.1 b/upstream/fedora-rawhide/man1/nano.1 index 1eb19c5f..8ca854a5 100644 --- a/upstream/fedora-rawhide/man1/nano.1 +++ b/upstream/fedora-rawhide/man1/nano.1 @@ -1,4 +1,4 @@ -.\" Copyright (C) 1999-2011, 2013-2023 Free Software Foundation, Inc. +.\" Copyright (C) 1999-2011, 2013-2024 Free Software Foundation, Inc. .\" .\" This document is dual-licensed. You may distribute and/or modify it .\" under the terms of either of the following licenses: @@ -16,19 +16,40 @@ .\" Documentation License along with this program. If not, see .\" <https://www.gnu.org/licenses/>. .\" -.TH NANO 1 "version 7.2" "January 2023" +.TH NANO 1 "version 8.0" "May 2024" .SH NAME -nano \- Nano's ANOther editor, inspired by Pico +nano \- Nano's ANOther text editor, inspired by Pico .SH SYNOPSIS .B nano .RI [ options "] [[\fB+" line [\fB, column "]] " file ]... .sp -.BR nano " [" \fIoptions "] [[" + [ crCR ]( / | ? ) \fIstring "] " \fIfile ]... +.B nano +.RI [ options "] [" file [\fB: line [\fB: column "]]]..." +.sp +.BR nano " [" \fIoptions "] [[" + [ crCR ]{ / | ? } \fIstring "] " \fIfile ]... + +.SH NOTICE +Since version 8.0, to be newcomer friendly, \fB^F\fR starts a forward search, +\fB^B\fR starts a backward search, \fBM\-F\fR searches the next occurrence +forward, and \fBM\-B\fR searches the next occurrence backward. If you want +those keystrokes to do what they did before version 8.0, add the following +lines at the end of your \fInanorc\fR file: +.sp +.RS 4 +.B bind ^F forward main +.br +.B bind ^B back main +.br +.B bind M\-F formatter main +.br +.B bind M\-B linter main +.RE +.sp .SH DESCRIPTION -\fBnano\fP is a small and friendly editor. It copies the look and feel +\fBnano\fP is a small and friendly text editor. It copies the look and feel of Pico, but is free software, and implements several features that Pico lacks, such as: opening multiple files, scrolling per line, undo/redo, syntax coloring, line numbering, and soft-wrapping overlong lines. @@ -36,7 +57,11 @@ syntax coloring, line numbering, and soft-wrapping overlong lines. When giving a filename on the command line, the cursor can be put on a specific line by adding the line number with a plus sign (\fB+\fR) before the filename, and even in a specific column by adding it with a comma. -(Negative numbers count from the end of the file or line.) +Negative numbers count from the end of the file or line. +The line and column numbers may also be specified by gluing them with colons +after the filename. (When a filename contains a colon followed by digits, +escape the colon by preceding it with a triple backslash.) +.sp The cursor can be put on the first or last occurrence of a specific string by specifying that string after \fB+/\fR or \fB+?\fR before the filename. The string can be made case sensitive and/or caused to be interpreted as a @@ -112,6 +137,7 @@ nanorc file. See \fBnanorc\fR(5). .BR \-E ", " \-\-tabstospaces Convert each typed tab to spaces -- to the number of spaces that a tab at that position would take up. +(Note: pasted tabs are not converted.) .TP .BR \-F ", " \-\-multibuffer Read a file into a new buffer by default. @@ -282,6 +308,7 @@ similar to a chroot. .BR \-p ", " \-\-preserve Preserve the XON and XOFF sequences (\fB^Q\fR and \fB^S\fR) so they will be caught by the terminal. +Note that option \fB\-/\fR (\fB\-\-modernbindings\fR) overrides this. .TP .BR \-q ", " \-\-indicator Display a "scrollbar" on the righthand side of the edit window. @@ -338,7 +365,7 @@ filename in the center of the title bar. .BR \-_ ", " \-\-minibar Suppress the title bar and instead show information about the current buffer at the bottom of the screen, in the space -for the status bar. In this "minibar" the filename is shown +for the status bar. In this "mini bar" the filename is shown on the left, followed by an asterisk if the buffer has been modified. On the right are displayed the current line and column number, the code of the character under the cursor (in Unicode format: U+xxxx), @@ -359,6 +386,19 @@ The status bar appears only when there is a significant message, and disappears after 1.5 seconds or upon the next keystroke. With \fBM\-Z\fR the title bar plus status bar can be toggled. With \fBM\-X\fR the help lines. +.TP +.BR \-/ ", " \-\-modernbindings +Use key bindings similar to the ones that most modern programs use: +\fB^X\fR cuts, \fB^C\fR copies, \fB^V\fR pastes, +\fB^Z\fR undoes, \fB^Y\fR redoes, +\fB^F\fR searches forward, \fB^G\fR searches next, +\fB^S\fR saves, \fB^O\fR opens a file, \fB^Q\fR quits, +and (when the terminal permits) \fB^H\fR shows help. +Furthermore, \fB^A\fR sets the mark, +\fB^R\fR makes replacements, \fB^D\fR searches previous, +\fB^P\fR shows the position, \fB^T\fR goes to a line, +\fB^W\fR writes out a file, and \fB^E\fR executes a command. +Note that this overrides option \fB\-p\fR (\fB\-\-preserve\fR). .SH TOGGLES Several of the above options can be switched on and off also while @@ -391,6 +431,9 @@ Suspension is enabled by default, reachable via \fB^T^Z\fR. (If you want a plain \fB^Z\fR to suspend nano, add \fBbind ^Z suspend main\fR to your nanorc.) .sp +When you want to copy marked text from \fBnano\fR to the system's clipboard, +see one of the examples in the \fBnanorc\fR(5) man page. +.sp If no alternative spell checker command is specified on the command line nor in one of the \fInanorc\fP files, \fBnano\fP will check the \fBSPELL\fP environment variable for one. @@ -404,6 +447,9 @@ that name already exists in the current directory, it will add ".save" plus a number (e.g.\& ".save.1") to the current filename in order to make it unique. In multibuffer mode, \fBnano\fP will write all the open buffers to their respective emergency files. +.sp +If you have any question about how to use \fBnano\fR in some specific +situation, you can ask on \fIhelp-nano@gnu.org\fR. .SH BUGS The recording and playback of keyboard macros works correctly only on a diff --git a/upstream/fedora-rawhide/man1/needs-restarting.1 b/upstream/fedora-rawhide/man1/needs-restarting.1 index d144c3cf..14bbf2f8 100644 --- a/upstream/fedora-rawhide/man1/needs-restarting.1 +++ b/upstream/fedora-rawhide/man1/needs-restarting.1 @@ -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 "NEEDS-RESTARTING" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "NEEDS-RESTARTING" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME needs-restarting \- redirecting to DNF needs-restarting Plugin .sp @@ -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/man1/networkctl.1 b/upstream/fedora-rawhide/man1/networkctl.1 index 7bdbc0e0..907e2548 100644 --- a/upstream/fedora-rawhide/man1/networkctl.1 +++ b/upstream/fedora-rawhide/man1/networkctl.1 @@ -1,5 +1,5 @@ '\" t -.TH "NETWORKCTL" "1" "" "systemd 255" "networkctl" +.TH "NETWORKCTL" "1" "" "systemd 256~rc3" "networkctl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -256,15 +256,15 @@ Produces output similar to: .RS 4 .\} .nf -LINK CHASSIS ID SYSTEM NAME CAPS PORT ID PORT DESCRIPTION -enp0s25 00:e0:4c:00:00:00 GS1900 \&.\&.b\&.\&.\&.\&.\&.\&.\&.\&. 2 Port #2 +LINK SYSTEM\-NAME SYSTEM\-DESCRIPTION CHASSIS\-ID PORT\-ID PORT\-DESCRIPTION CAPS +enp0s25 GS1900 \- 00:e0:4c:00:00:00 2 Port #2 \&.\&.b\&.\&.\&.\&.\&.\&.\&.\&. Capability Flags: o \- Other; p \- Repeater; b \- Bridge; w \- WLAN Access Point; r \- Router; t \- Telephone; d \- DOCSIS cable device; a \- Station; c \- Customer VLAN; s \- Service VLAN, m \- Two\-port MAC Relay (TPMR) -1 neighbors listed\&. +1 neighbor(s) listed\&. .fi .if n \{\ .RE @@ -380,7 +380,11 @@ Edit network configuration files, which include \&.netdev, and \&.link files\&. If no network config file matching the given name is found, a new one will be created under -/etc/\&. Specially, if the name is prefixed by +/etc/ +or +/run/, depending on whether +\fB\-\-runtime\fR +is specified\&. Specially, if the name is prefixed by "@", it will be treated as a network interface, and editing will be performed on the network config files associated with it\&. Additionally, the interface name can be suffixed with ":network" (default) or @@ -406,15 +410,69 @@ for more information\&. Added in version 254\&. .RE .PP -\fBcat\fR \fIFILE\fR|\fI@DEVICE\fR\&... +\fBcat\fR [\fIFILE\fR|\fI@DEVICE\fR\&...] .RS 4 Show network configuration files\&. This command honors the "@" prefix in the same way as -\fBedit\fR\&. +\fBedit\fR\&. When no argument is specified, +\fBnetworkd.conf\fR(5) +and its drop\-in files will be shown\&. .sp Added in version 254\&. .RE +.PP +\fBmask\fR \fIFILE\fR\&... +.RS 4 +Mask network configuration files, which include +\&.network, +\&.netdev, and +\&.link +files\&. A symlink of the given name will be created under +/etc/ +or +/run/, depending on whether +\fB\-\-runtime\fR +is specified, that points to +/dev/null\&. If a non\-empty config file with the specified name exists under the target directory or a directory with higher priority (e\&.g\&. +\fB\-\-runtime\fR +is used while an existing config resides in +/etc/), the operation is aborted\&. +.sp +This command honors +\fB\-\-no\-reload\fR +in the same way as +\fBedit\fR\&. +.sp +Added in version 256\&. +.RE +.PP +\fBunmask\fR \fIFILE\fR\&... +.RS 4 +Unmask network configuration files, i\&.e\&. reverting the effect of +\fBmask\fR\&. Note that this command operates regardless of the scope of the directory, i\&.e\&. +\fB\-\-runtime\fR +is of no effect\&. +.sp +This command honors +\fB\-\-no\-reload\fR +in the same way as +\fBedit\fR +and +\fBmask\fR\&. +.sp +Added in version 256\&. +.RE +.PP +\fBpersistent\-storage\fR \fIBOOL\fR +.RS 4 +Notify +systemd\-networkd\&.service +that the persistent storage for the service is ready\&. This is called by +systemd\-networkd\-persistent\-storage\&.service\&. Usually, this command should not be called manually by users or administrators\&. +.sp +Added in version 256\&. +.RE .SH "OPTIONS" .PP The following options are understood: @@ -450,7 +508,7 @@ When used with Added in version 245\&. .RE .PP -\fB\-\-drop\-in=\fR\fINAME\fR +\fB\-\-drop\-in=\fR\fB\fINAME\fR\fR .RS 4 When used with \fBedit\fR, edit the drop\-in file @@ -464,15 +522,30 @@ Added in version 254\&. .RS 4 When used with \fBedit\fR, +\fBmask\fR, or +\fBunmask\fR, \fBsystemd-networkd.service\fR(8) or \fBsystemd-udevd.service\fR(8) -will not be reloaded after the editing finishes\&. +will not be reloaded after the operation finishes\&. .sp Added in version 254\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-runtime\fR +.RS 4 +When used with +\fBedit\fR +or +\fBmask\fR, operate on the file under +/run/ +instead of +/etc/\&. +.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" @@ -507,10 +580,7 @@ Do not pipe output into a pager\&. On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd-networkd.service\fR(8), -\fBsystemd.network\fR(5), -\fBsystemd.netdev\fR(5), -\fBip\fR(8) +\fBsystemd-networkd.service\fR(8), \fBsystemd.network\fR(5), \fBsystemd.netdev\fR(5), \fBip\fR(8) .SH "NOTES" .IP " 1." 4 RFC 3484 diff --git a/upstream/fedora-rawhide/man1/ngettext.1 b/upstream/fedora-rawhide/man1/ngettext.1 index 88e545b3..ab31d199 100644 --- a/upstream/fedora-rawhide/man1/ngettext.1 +++ b/upstream/fedora-rawhide/man1/ngettext.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH NGETTEXT "1" "September 2023" "GNU gettext-runtime 0.22.2" "User Commands" +.TH NGETTEXT "1" "February 2024" "GNU gettext-runtime 0.22.5" "User Commands" .SH NAME ngettext \- translate message and choose plural form .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/nice.1 b/upstream/fedora-rawhide/man1/nice.1 index 8eff2812..77e69c5e 100644 --- a/upstream/fedora-rawhide/man1/nice.1 +++ b/upstream/fedora-rawhide/man1/nice.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH NICE "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH NICE "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME nice \- run a program with modified scheduling priority .SH SYNOPSIS @@ -23,7 +23,7 @@ display this help and exit \fB\-\-version\fR output version information and exit .PP -NOTE: your shell may have its own version of nice, which usually supersedes +Your shell may have its own version of nice, which usually supersedes the version described here. Please refer to your shell's documentation for details about the options it supports. .SS "Exit status:" @@ -46,7 +46,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/nl.1 b/upstream/fedora-rawhide/man1/nl.1 index 0787ea76..db515c19 100644 --- a/upstream/fedora-rawhide/man1/nl.1 +++ b/upstream/fedora-rawhide/man1/nl.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH NL "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH NL "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME nl \- number lines of files .SH SYNOPSIS @@ -92,7 +92,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/nm.1 b/upstream/fedora-rawhide/man1/nm.1 index 43d3a4e4..6243ba9b 100644 --- a/upstream/fedora-rawhide/man1/nm.1 +++ b/upstream/fedora-rawhide/man1/nm.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "NM 1" -.TH NM 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH NM 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/nohup.1 b/upstream/fedora-rawhide/man1/nohup.1 index 7c740269..c35f81f2 100644 --- a/upstream/fedora-rawhide/man1/nohup.1 +++ b/upstream/fedora-rawhide/man1/nohup.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH NOHUP "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH NOHUP "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME nohup \- run a command immune to hangups, with output to a non-tty .SH SYNOPSIS @@ -25,7 +25,7 @@ If standard output is a terminal, append output to 'nohup.out' if possible, If standard error is a terminal, redirect it to standard output. To save output to FILE, use 'nohup COMMAND > FILE'. .PP -NOTE: your shell may have its own version of nohup, which usually supersedes +Your shell may have its own version of nohup, which usually supersedes the version described here. Please refer to your shell's documentation for details about the options it supports. .SS "Exit status:" @@ -48,7 +48,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/nproc.1 b/upstream/fedora-rawhide/man1/nproc.1 index 9e9c0499..39f7c013 100644 --- a/upstream/fedora-rawhide/man1/nproc.1 +++ b/upstream/fedora-rawhide/man1/nproc.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH NPROC "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH NPROC "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME nproc \- print the number of processing units available .SH SYNOPSIS @@ -29,7 +29,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/numfmt.1 b/upstream/fedora-rawhide/man1/numfmt.1 index d2205663..f6e09a13 100644 --- a/upstream/fedora-rawhide/man1/numfmt.1 +++ b/upstream/fedora-rawhide/man1/numfmt.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH NUMFMT "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH NUMFMT "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME numfmt \- Convert numbers from/to human-readable strings .SH SYNOPSIS @@ -82,7 +82,7 @@ no auto\-scaling is done; suffixes will trigger an error auto accept optional single/two letter suffix: .IP -1K = 1000, +1K = 1000, 1k = 1000, 1Ki = 1024, 1M = 1000000, 1Mi = 1048576, @@ -90,21 +90,21 @@ accept optional single/two letter suffix: si accept optional single letter suffix: .IP -1K = 1000, +1k = 1000, 1K = 1000, 1M = 1000000, \&... .TP iec accept optional single letter suffix: .IP -1K = 1024, +1K = 1024, 1k = 1024, 1M = 1048576, \&... .TP iec\-i accept optional two\-letter suffix: .IP -1Ki = 1024, +1Ki = 1024, 1ki = 1024, 1Mi = 1048576, \&... .SS "FIELDS supports \fBcut\fP(1) style field ranges:" @@ -142,7 +142,7 @@ errors are not diagnosed and the exit status is 0. .IP \f(CW$ numfmt --to=si 1000\fR .IP -\-> "1.0K" +\-> "1.0k" .IP \f(CW$ numfmt --to=iec 2048\fR .IP @@ -174,7 +174,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/objcopy.1 b/upstream/fedora-rawhide/man1/objcopy.1 index f3b6e52c..0611d3d8 100644 --- a/upstream/fedora-rawhide/man1/objcopy.1 +++ b/upstream/fedora-rawhide/man1/objcopy.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "OBJCOPY 1" -.TH OBJCOPY 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH OBJCOPY 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -605,6 +605,10 @@ section address. See the comments under \fB\-\-change\-addresses\fR, above. If \fIsectionpattern\fR does not match any sections in the input file, a warning will be issued, unless \&\fB\-\-no\-change\-warnings\fR is used. +.Sp +Note \- changing the VMA of sections in a fully linked binary can be +dangerous since there may be code that expects the sections to be +located at their old address. .IP \fB\-\-change\-warnings\fR 4 .IX Item "--change-warnings" .PD 0 @@ -642,6 +646,13 @@ SHF_X86_64_LARGE. Set the alignment for any sections matching \fIsectionpattern\fR. \&\fIalign\fR specifies the alignment in bytes and must be a power of two, i.e. 1, 2, 4, 8.... +.Sp +Note \- setting a section's alignment will not automatically align its +LMA or VMA addresses. If those need to be changed as well then the +\&\fB\-\-change\-section\-lma\fR and/or \fB\-\-change\-section\-vma\fR +options should be used. Also note that changing VMAs can cause +problems in fully linked binaries where there may be code that expects +the contents of the sections to be located at their old address. .IP "\fB\-\-add\-section\fR \fIsectionname\fR\fB=\fR\fIfilename\fR" 4 .IX Item "--add-section sectionname=filename" Add a new section named \fIsectionname\fR while copying the file. The @@ -911,8 +922,8 @@ As long as the debug info file has been installed into one of these locations before the debugger is run everything should work correctly. .RE -.IP \fB\-\-keep\-section\-symbils\fR 4 -.IX Item "--keep-section-symbils" +.IP \fB\-\-keep\-section\-symbols\fR 4 +.IX Item "--keep-section-symbols" When stripping a file, perhaps with \fB\-\-strip\-debug\fR or \&\fB\-\-strip\-unneeded\fR, retain any symbols specifying section names, which would otherwise get stripped. @@ -1029,10 +1040,20 @@ for dlls. [This option is specific to PE targets.] .IP "\fB\-\-section\-alignment\fR \fInum\fR" 4 .IX Item "--section-alignment num" -Sets the section alignment field in the PE header. Sections in memory -will always begin at addresses which are a multiple of this number. -Defaults to 0x1000. [This option is specific to PE targets.] +.Sp +Sets the section alignment field in the PE header \- if one is present +in the binary. Sections in memory will always begin at addresses +which are a multiple of this number. Defaults to 0x1000. +.Sp +Note \- this option will also set the alignment field in each section's +flags. +.Sp +Note \- if a section's LMA or VMA addresses are no longer aligned, and +those addresses have not been set via the \fB\-\-set\-section\-lma\fR or +\&\fB\-\-set\-section\-vma\fR options, and the file has been fully +relocated then a warning message will be issued. It will then be up +to the user to decide if the LMA and VMA need updating. .IP "\fB\-\-stack\fR \fIreserve\fR" 4 .IX Item "--stack reserve" .PD 0 diff --git a/upstream/fedora-rawhide/man1/objdump.1 b/upstream/fedora-rawhide/man1/objdump.1 index 716e7dc5..9bbd65e6 100644 --- a/upstream/fedora-rawhide/man1/objdump.1 +++ b/upstream/fedora-rawhide/man1/objdump.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "OBJDUMP 1" -.TH OBJDUMP 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH OBJDUMP 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -1153,6 +1153,15 @@ function at link time. When looking at CTF archives that have been created by a linker that uses the name changer to rename the parent archive member, \fB\-\-ctf\-parent\fR can be used to specify the name used for the parent. +.IP \fB\-\-ctf\-parent\-section=\fR\fIsection\fR 4 +.IX Item "--ctf-parent-section=section" +This option lets you pick a completely different section for the CTF +parent dictionary containing unambiguous types than for the child +dictionaries that contain the ambiguous remainder. The linker does +not emit ELF objects structured like this, but some third-party linkers +may. It's also convenient to inspect CTF written out as multiple raw +files to compose them with objcopy, which can put them in different +ELF sections but not in different members of a single CTF dict. .IP \fB\-\-sframe[=\fR\fIsection\fR\fB]\fR 4 .IX Item "--sframe[=section]" Display the contents of the specified SFrame section. diff --git a/upstream/fedora-rawhide/man1/od.1 b/upstream/fedora-rawhide/man1/od.1 index aed3fa03..36037d07 100644 --- a/upstream/fedora-rawhide/man1/od.1 +++ b/upstream/fedora-rawhide/man1/od.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH OD "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH OD "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME od \- dump files in octal and other formats .SH SYNOPSIS @@ -120,8 +120,9 @@ hexadecimal, SIZE bytes per integer .PP SIZE is a number. For TYPE in [doux], SIZE may also be C for sizeof(char), S for sizeof(short), I for sizeof(int) or L for -sizeof(long). If TYPE is f, SIZE may also be F for sizeof(float), D -for sizeof(double) or L for sizeof(long double). +sizeof(long). If TYPE is f, SIZE may also be B for Brain 16 bit, +H for Half precision float, F for sizeof(float), D for sizeof(double), +or L for sizeof(long double). .PP Adding a z suffix to any type displays printable characters at the end of each output line. @@ -158,7 +159,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/oomctl.1 b/upstream/fedora-rawhide/man1/oomctl.1 index 7c672b24..c9f0ebf3 100644 --- a/upstream/fedora-rawhide/man1/oomctl.1 +++ b/upstream/fedora-rawhide/man1/oomctl.1 @@ -1,5 +1,5 @@ '\" t -.TH "OOMCTL" "1" "" "systemd 255" "oomctl" +.TH "OOMCTL" "1" "" "systemd 256~rc3" "oomctl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -65,6 +65,4 @@ Do not pipe output into a pager\&. On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-oomd.service\fR(8), -\fBoomd.conf\fR(5) +\fBsystemd\fR(1), \fBsystemd-oomd.service\fR(8), \fBoomd.conf\fR(5) diff --git a/upstream/fedora-rawhide/man1/package-cleanup.1 b/upstream/fedora-rawhide/man1/package-cleanup.1 index 259603bf..e6380890 100644 --- a/upstream/fedora-rawhide/man1/package-cleanup.1 +++ b/upstream/fedora-rawhide/man1/package-cleanup.1 @@ -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 "PACKAGE-CLEANUP" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "PACKAGE-CLEANUP" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME package-cleanup \- clean up locally installed, duplicate, or orphaned packages. .sp diff --git a/upstream/fedora-rawhide/man1/paste.1 b/upstream/fedora-rawhide/man1/paste.1 index 10f39968..20506e67 100644 --- a/upstream/fedora-rawhide/man1/paste.1 +++ b/upstream/fedora-rawhide/man1/paste.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH PASTE "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH PASTE "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME paste \- merge lines of files .SH SYNOPSIS @@ -36,7 +36,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/pathchk.1 b/upstream/fedora-rawhide/man1/pathchk.1 index 1d84f166..6d7ff5df 100644 --- a/upstream/fedora-rawhide/man1/pathchk.1 +++ b/upstream/fedora-rawhide/man1/pathchk.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH PATHCHK "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH PATHCHK "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME pathchk \- check whether file names are valid or portable .SH SYNOPSIS @@ -31,7 +31,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/pdf2dsc.1 b/upstream/fedora-rawhide/man1/pdf2dsc.1 index ff73bf90..851540c3 100644 --- a/upstream/fedora-rawhide/man1/pdf2dsc.1 +++ b/upstream/fedora-rawhide/man1/pdf2dsc.1 @@ -1,4 +1,4 @@ -.TH PDF2DSC 1 "01 November 2023" 10.02.1 "Ghostscript Tools" \" -*- nroff -*- +.TH PDF2DSC 1 "06 May 2024" 10.03.1 "Ghostscript Tools" \" -*- nroff -*- .SH NAME pdf2dsc \- generate a PostScript page list of a PDF document .SH SYNOPSIS @@ -28,6 +28,6 @@ Ghostscript since release 3.53. .SH SEE ALSO gs(1), ghostview(1) .SH VERSION -This document was last revised for Ghostscript version 10.02.1. +This document was last revised for Ghostscript version 10.03.1. .SH AUTHOR Yves Arrouye <yves.arrouye@usa.net> and Russell Lang gsview at ghostgum.com.au diff --git a/upstream/fedora-rawhide/man1/pdf2ps.1 b/upstream/fedora-rawhide/man1/pdf2ps.1 index b81c5710..d70f3d42 100644 --- a/upstream/fedora-rawhide/man1/pdf2ps.1 +++ b/upstream/fedora-rawhide/man1/pdf2ps.1 @@ -1,4 +1,4 @@ -.TH PDF2PS 1 "01 November 2023" 10.02.1 "Ghostscript Tools" \" -*- nroff -*- +.TH PDF2PS 1 "06 May 2024" 10.03.1 "Ghostscript Tools" \" -*- nroff -*- .SH NAME pdf2ps \- Ghostscript PDF to PostScript translator .SH SYNOPSIS @@ -14,7 +14,7 @@ LanguageLevel 3 in the output. Run "\fBgs -h\fR" to find the location of Ghostscript documentation on your system, from which you can get more details. .SH VERSION -This document was last revised for Ghostscript version 10.02.1. +This document was last revised for Ghostscript version 10.03.1. .SH AUTHOR Artifex Software, Inc. are the primary maintainers of Ghostscript. diff --git a/upstream/fedora-rawhide/man1/perl.1 b/upstream/fedora-rawhide/man1/perl.1 index 74bd9394..93db96e5 100644 --- a/upstream/fedora-rawhide/man1/perl.1 +++ b/upstream/fedora-rawhide/man1/perl.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL 1" -.TH PERL 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5004delta.1 b/upstream/fedora-rawhide/man1/perl5004delta.1 index 8acb2ee1..ae84e87f 100644 --- a/upstream/fedora-rawhide/man1/perl5004delta.1 +++ b/upstream/fedora-rawhide/man1/perl5004delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5004DELTA 1" -.TH PERL5004DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5004DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5005delta.1 b/upstream/fedora-rawhide/man1/perl5005delta.1 index e7191635..3927f542 100644 --- a/upstream/fedora-rawhide/man1/perl5005delta.1 +++ b/upstream/fedora-rawhide/man1/perl5005delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5005DELTA 1" -.TH PERL5005DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5005DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5100delta.1 b/upstream/fedora-rawhide/man1/perl5100delta.1 index 260f1eab..bb0630b8 100644 --- a/upstream/fedora-rawhide/man1/perl5100delta.1 +++ b/upstream/fedora-rawhide/man1/perl5100delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5100DELTA 1" -.TH PERL5100DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5100DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5101delta.1 b/upstream/fedora-rawhide/man1/perl5101delta.1 index a1156d31..3e5ddab5 100644 --- a/upstream/fedora-rawhide/man1/perl5101delta.1 +++ b/upstream/fedora-rawhide/man1/perl5101delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5101DELTA 1" -.TH PERL5101DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5101DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5120delta.1 b/upstream/fedora-rawhide/man1/perl5120delta.1 index 784ca937..6cbc06c3 100644 --- a/upstream/fedora-rawhide/man1/perl5120delta.1 +++ b/upstream/fedora-rawhide/man1/perl5120delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5120DELTA 1" -.TH PERL5120DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5120DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5121delta.1 b/upstream/fedora-rawhide/man1/perl5121delta.1 index adbd7a49..3702b834 100644 --- a/upstream/fedora-rawhide/man1/perl5121delta.1 +++ b/upstream/fedora-rawhide/man1/perl5121delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5121DELTA 1" -.TH PERL5121DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5121DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5122delta.1 b/upstream/fedora-rawhide/man1/perl5122delta.1 index 1e88b10c..11c7ba2d 100644 --- a/upstream/fedora-rawhide/man1/perl5122delta.1 +++ b/upstream/fedora-rawhide/man1/perl5122delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5122DELTA 1" -.TH PERL5122DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5122DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5123delta.1 b/upstream/fedora-rawhide/man1/perl5123delta.1 index 14418dc2..9c9de417 100644 --- a/upstream/fedora-rawhide/man1/perl5123delta.1 +++ b/upstream/fedora-rawhide/man1/perl5123delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5123DELTA 1" -.TH PERL5123DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5123DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5124delta.1 b/upstream/fedora-rawhide/man1/perl5124delta.1 index 4b041f67..4e80fa43 100644 --- a/upstream/fedora-rawhide/man1/perl5124delta.1 +++ b/upstream/fedora-rawhide/man1/perl5124delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5124DELTA 1" -.TH PERL5124DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5124DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5125delta.1 b/upstream/fedora-rawhide/man1/perl5125delta.1 index f552250d..a6eff47e 100644 --- a/upstream/fedora-rawhide/man1/perl5125delta.1 +++ b/upstream/fedora-rawhide/man1/perl5125delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5125DELTA 1" -.TH PERL5125DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5125DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5140delta.1 b/upstream/fedora-rawhide/man1/perl5140delta.1 index 55ed8f16..d82ce55a 100644 --- a/upstream/fedora-rawhide/man1/perl5140delta.1 +++ b/upstream/fedora-rawhide/man1/perl5140delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5140DELTA 1" -.TH PERL5140DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5140DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5141delta.1 b/upstream/fedora-rawhide/man1/perl5141delta.1 index 0fc77173..77b486b8 100644 --- a/upstream/fedora-rawhide/man1/perl5141delta.1 +++ b/upstream/fedora-rawhide/man1/perl5141delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5141DELTA 1" -.TH PERL5141DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5141DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5142delta.1 b/upstream/fedora-rawhide/man1/perl5142delta.1 index e5cfedaf..2117e0d7 100644 --- a/upstream/fedora-rawhide/man1/perl5142delta.1 +++ b/upstream/fedora-rawhide/man1/perl5142delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5142DELTA 1" -.TH PERL5142DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5142DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5143delta.1 b/upstream/fedora-rawhide/man1/perl5143delta.1 index 91970834..0684569c 100644 --- a/upstream/fedora-rawhide/man1/perl5143delta.1 +++ b/upstream/fedora-rawhide/man1/perl5143delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5143DELTA 1" -.TH PERL5143DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5143DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5144delta.1 b/upstream/fedora-rawhide/man1/perl5144delta.1 index 677da515..89ea04a2 100644 --- a/upstream/fedora-rawhide/man1/perl5144delta.1 +++ b/upstream/fedora-rawhide/man1/perl5144delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5144DELTA 1" -.TH PERL5144DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5144DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5160delta.1 b/upstream/fedora-rawhide/man1/perl5160delta.1 index 2f8a7813..60843a77 100644 --- a/upstream/fedora-rawhide/man1/perl5160delta.1 +++ b/upstream/fedora-rawhide/man1/perl5160delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5160DELTA 1" -.TH PERL5160DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5160DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5161delta.1 b/upstream/fedora-rawhide/man1/perl5161delta.1 index 814371fa..42a56103 100644 --- a/upstream/fedora-rawhide/man1/perl5161delta.1 +++ b/upstream/fedora-rawhide/man1/perl5161delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5161DELTA 1" -.TH PERL5161DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5161DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5162delta.1 b/upstream/fedora-rawhide/man1/perl5162delta.1 index 700afdf2..6777cc99 100644 --- a/upstream/fedora-rawhide/man1/perl5162delta.1 +++ b/upstream/fedora-rawhide/man1/perl5162delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5162DELTA 1" -.TH PERL5162DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5162DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5163delta.1 b/upstream/fedora-rawhide/man1/perl5163delta.1 index 976f0aca..cb16cbdd 100644 --- a/upstream/fedora-rawhide/man1/perl5163delta.1 +++ b/upstream/fedora-rawhide/man1/perl5163delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5163DELTA 1" -.TH PERL5163DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5163DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5180delta.1 b/upstream/fedora-rawhide/man1/perl5180delta.1 index 9b7691cc..50bb263b 100644 --- a/upstream/fedora-rawhide/man1/perl5180delta.1 +++ b/upstream/fedora-rawhide/man1/perl5180delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5180DELTA 1" -.TH PERL5180DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5180DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5181delta.1 b/upstream/fedora-rawhide/man1/perl5181delta.1 index 1a6e9998..040dba66 100644 --- a/upstream/fedora-rawhide/man1/perl5181delta.1 +++ b/upstream/fedora-rawhide/man1/perl5181delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5181DELTA 1" -.TH PERL5181DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5181DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5182delta.1 b/upstream/fedora-rawhide/man1/perl5182delta.1 index 9356f72d..501276a4 100644 --- a/upstream/fedora-rawhide/man1/perl5182delta.1 +++ b/upstream/fedora-rawhide/man1/perl5182delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5182DELTA 1" -.TH PERL5182DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5182DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5184delta.1 b/upstream/fedora-rawhide/man1/perl5184delta.1 index f5c70e6e..3769658c 100644 --- a/upstream/fedora-rawhide/man1/perl5184delta.1 +++ b/upstream/fedora-rawhide/man1/perl5184delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5184DELTA 1" -.TH PERL5184DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5184DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5200delta.1 b/upstream/fedora-rawhide/man1/perl5200delta.1 index b1017b5e..2b4499e3 100644 --- a/upstream/fedora-rawhide/man1/perl5200delta.1 +++ b/upstream/fedora-rawhide/man1/perl5200delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5200DELTA 1" -.TH PERL5200DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5200DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5201delta.1 b/upstream/fedora-rawhide/man1/perl5201delta.1 index 92199833..04cccf91 100644 --- a/upstream/fedora-rawhide/man1/perl5201delta.1 +++ b/upstream/fedora-rawhide/man1/perl5201delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5201DELTA 1" -.TH PERL5201DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5201DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5202delta.1 b/upstream/fedora-rawhide/man1/perl5202delta.1 index 8b342235..d9135fdb 100644 --- a/upstream/fedora-rawhide/man1/perl5202delta.1 +++ b/upstream/fedora-rawhide/man1/perl5202delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5202DELTA 1" -.TH PERL5202DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5202DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5203delta.1 b/upstream/fedora-rawhide/man1/perl5203delta.1 index fa5160e8..dab9b5c2 100644 --- a/upstream/fedora-rawhide/man1/perl5203delta.1 +++ b/upstream/fedora-rawhide/man1/perl5203delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5203DELTA 1" -.TH PERL5203DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5203DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5220delta.1 b/upstream/fedora-rawhide/man1/perl5220delta.1 index cb1a38d5..972e8c65 100644 --- a/upstream/fedora-rawhide/man1/perl5220delta.1 +++ b/upstream/fedora-rawhide/man1/perl5220delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5220DELTA 1" -.TH PERL5220DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5220DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5221delta.1 b/upstream/fedora-rawhide/man1/perl5221delta.1 index bb301080..8378d29a 100644 --- a/upstream/fedora-rawhide/man1/perl5221delta.1 +++ b/upstream/fedora-rawhide/man1/perl5221delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5221DELTA 1" -.TH PERL5221DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5221DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5222delta.1 b/upstream/fedora-rawhide/man1/perl5222delta.1 index 97260a4b..25e67823 100644 --- a/upstream/fedora-rawhide/man1/perl5222delta.1 +++ b/upstream/fedora-rawhide/man1/perl5222delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5222DELTA 1" -.TH PERL5222DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5222DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5223delta.1 b/upstream/fedora-rawhide/man1/perl5223delta.1 index 633b4be4..6371e605 100644 --- a/upstream/fedora-rawhide/man1/perl5223delta.1 +++ b/upstream/fedora-rawhide/man1/perl5223delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5223DELTA 1" -.TH PERL5223DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5223DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5224delta.1 b/upstream/fedora-rawhide/man1/perl5224delta.1 index 22ad720b..cc991eac 100644 --- a/upstream/fedora-rawhide/man1/perl5224delta.1 +++ b/upstream/fedora-rawhide/man1/perl5224delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5224DELTA 1" -.TH PERL5224DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5224DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5240delta.1 b/upstream/fedora-rawhide/man1/perl5240delta.1 index 5600895d..9f0a4b98 100644 --- a/upstream/fedora-rawhide/man1/perl5240delta.1 +++ b/upstream/fedora-rawhide/man1/perl5240delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5240DELTA 1" -.TH PERL5240DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5240DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5241delta.1 b/upstream/fedora-rawhide/man1/perl5241delta.1 index b43ac03e..cd5b5473 100644 --- a/upstream/fedora-rawhide/man1/perl5241delta.1 +++ b/upstream/fedora-rawhide/man1/perl5241delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5241DELTA 1" -.TH PERL5241DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5241DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5242delta.1 b/upstream/fedora-rawhide/man1/perl5242delta.1 index 20511ecd..f17d1499 100644 --- a/upstream/fedora-rawhide/man1/perl5242delta.1 +++ b/upstream/fedora-rawhide/man1/perl5242delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5242DELTA 1" -.TH PERL5242DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5242DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5243delta.1 b/upstream/fedora-rawhide/man1/perl5243delta.1 index 7792b48a..294eb24e 100644 --- a/upstream/fedora-rawhide/man1/perl5243delta.1 +++ b/upstream/fedora-rawhide/man1/perl5243delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5243DELTA 1" -.TH PERL5243DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5243DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5244delta.1 b/upstream/fedora-rawhide/man1/perl5244delta.1 index adbf874d..23c24aeb 100644 --- a/upstream/fedora-rawhide/man1/perl5244delta.1 +++ b/upstream/fedora-rawhide/man1/perl5244delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5244DELTA 1" -.TH PERL5244DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5244DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5260delta.1 b/upstream/fedora-rawhide/man1/perl5260delta.1 index fa771790..adca762a 100644 --- a/upstream/fedora-rawhide/man1/perl5260delta.1 +++ b/upstream/fedora-rawhide/man1/perl5260delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5260DELTA 1" -.TH PERL5260DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5260DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5261delta.1 b/upstream/fedora-rawhide/man1/perl5261delta.1 index 3efbd6b3..74e8a9e9 100644 --- a/upstream/fedora-rawhide/man1/perl5261delta.1 +++ b/upstream/fedora-rawhide/man1/perl5261delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5261DELTA 1" -.TH PERL5261DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5261DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5262delta.1 b/upstream/fedora-rawhide/man1/perl5262delta.1 index 1b8b91fb..4e7a0dfd 100644 --- a/upstream/fedora-rawhide/man1/perl5262delta.1 +++ b/upstream/fedora-rawhide/man1/perl5262delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5262DELTA 1" -.TH PERL5262DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5262DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5263delta.1 b/upstream/fedora-rawhide/man1/perl5263delta.1 index 1028bd10..3a6fe9b0 100644 --- a/upstream/fedora-rawhide/man1/perl5263delta.1 +++ b/upstream/fedora-rawhide/man1/perl5263delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5263DELTA 1" -.TH PERL5263DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5263DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5280delta.1 b/upstream/fedora-rawhide/man1/perl5280delta.1 index fd6a9701..d7aeb341 100644 --- a/upstream/fedora-rawhide/man1/perl5280delta.1 +++ b/upstream/fedora-rawhide/man1/perl5280delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5280DELTA 1" -.TH PERL5280DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5280DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5281delta.1 b/upstream/fedora-rawhide/man1/perl5281delta.1 index 6fddb2bf..16a9050a 100644 --- a/upstream/fedora-rawhide/man1/perl5281delta.1 +++ b/upstream/fedora-rawhide/man1/perl5281delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5281DELTA 1" -.TH PERL5281DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5281DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5282delta.1 b/upstream/fedora-rawhide/man1/perl5282delta.1 index fe9f807a..1bda6088 100644 --- a/upstream/fedora-rawhide/man1/perl5282delta.1 +++ b/upstream/fedora-rawhide/man1/perl5282delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5282DELTA 1" -.TH PERL5282DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5282DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5283delta.1 b/upstream/fedora-rawhide/man1/perl5283delta.1 index 2f7a274a..2126a16c 100644 --- a/upstream/fedora-rawhide/man1/perl5283delta.1 +++ b/upstream/fedora-rawhide/man1/perl5283delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5283DELTA 1" -.TH PERL5283DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5283DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5300delta.1 b/upstream/fedora-rawhide/man1/perl5300delta.1 index 762da3c6..8dcef1a9 100644 --- a/upstream/fedora-rawhide/man1/perl5300delta.1 +++ b/upstream/fedora-rawhide/man1/perl5300delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5300DELTA 1" -.TH PERL5300DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5300DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5301delta.1 b/upstream/fedora-rawhide/man1/perl5301delta.1 index 71d96448..011bb8f7 100644 --- a/upstream/fedora-rawhide/man1/perl5301delta.1 +++ b/upstream/fedora-rawhide/man1/perl5301delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5301DELTA 1" -.TH PERL5301DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5301DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5302delta.1 b/upstream/fedora-rawhide/man1/perl5302delta.1 index 1cd6df7d..89e15dee 100644 --- a/upstream/fedora-rawhide/man1/perl5302delta.1 +++ b/upstream/fedora-rawhide/man1/perl5302delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5302DELTA 1" -.TH PERL5302DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5302DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5303delta.1 b/upstream/fedora-rawhide/man1/perl5303delta.1 index 0106a784..80f2744e 100644 --- a/upstream/fedora-rawhide/man1/perl5303delta.1 +++ b/upstream/fedora-rawhide/man1/perl5303delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5303DELTA 1" -.TH PERL5303DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5303DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5320delta.1 b/upstream/fedora-rawhide/man1/perl5320delta.1 index 0b2db50a..c6d62d57 100644 --- a/upstream/fedora-rawhide/man1/perl5320delta.1 +++ b/upstream/fedora-rawhide/man1/perl5320delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5320DELTA 1" -.TH PERL5320DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5320DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5321delta.1 b/upstream/fedora-rawhide/man1/perl5321delta.1 index 7554cc87..7ea4fdb1 100644 --- a/upstream/fedora-rawhide/man1/perl5321delta.1 +++ b/upstream/fedora-rawhide/man1/perl5321delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5321DELTA 1" -.TH PERL5321DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5321DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5340delta.1 b/upstream/fedora-rawhide/man1/perl5340delta.1 index f98b280d..a22943a6 100644 --- a/upstream/fedora-rawhide/man1/perl5340delta.1 +++ b/upstream/fedora-rawhide/man1/perl5340delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5340DELTA 1" -.TH PERL5340DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5340DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5341delta.1 b/upstream/fedora-rawhide/man1/perl5341delta.1 index 2c2716de..f6adcb1e 100644 --- a/upstream/fedora-rawhide/man1/perl5341delta.1 +++ b/upstream/fedora-rawhide/man1/perl5341delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5341DELTA 1" -.TH PERL5341DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5341DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5342delta.1 b/upstream/fedora-rawhide/man1/perl5342delta.1 index 191269f6..ba4b817b 100644 --- a/upstream/fedora-rawhide/man1/perl5342delta.1 +++ b/upstream/fedora-rawhide/man1/perl5342delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5342DELTA 1" -.TH PERL5342DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5342DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5343delta.1 b/upstream/fedora-rawhide/man1/perl5343delta.1 index 267c8b66..a5e9bcb0 100644 --- a/upstream/fedora-rawhide/man1/perl5343delta.1 +++ b/upstream/fedora-rawhide/man1/perl5343delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5343DELTA 1" -.TH PERL5343DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5343DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5360delta.1 b/upstream/fedora-rawhide/man1/perl5360delta.1 index 3b021a4e..fd4afa28 100644 --- a/upstream/fedora-rawhide/man1/perl5360delta.1 +++ b/upstream/fedora-rawhide/man1/perl5360delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5360DELTA 1" -.TH PERL5360DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5360DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5361delta.1 b/upstream/fedora-rawhide/man1/perl5361delta.1 index a899e864..01a04113 100644 --- a/upstream/fedora-rawhide/man1/perl5361delta.1 +++ b/upstream/fedora-rawhide/man1/perl5361delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5361DELTA 1" -.TH PERL5361DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5361DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5362delta.1 b/upstream/fedora-rawhide/man1/perl5362delta.1 index 465acace..a7c1694f 100644 --- a/upstream/fedora-rawhide/man1/perl5362delta.1 +++ b/upstream/fedora-rawhide/man1/perl5362delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5362DELTA 1" -.TH PERL5362DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5362DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5363delta.1 b/upstream/fedora-rawhide/man1/perl5363delta.1 index 57153564..d59247cd 100644 --- a/upstream/fedora-rawhide/man1/perl5363delta.1 +++ b/upstream/fedora-rawhide/man1/perl5363delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5363DELTA 1" -.TH PERL5363DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5363DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5380delta.1 b/upstream/fedora-rawhide/man1/perl5380delta.1 index 42537496..68cfa26b 100644 --- a/upstream/fedora-rawhide/man1/perl5380delta.1 +++ b/upstream/fedora-rawhide/man1/perl5380delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5380DELTA 1" -.TH PERL5380DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5380DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5381delta.1 b/upstream/fedora-rawhide/man1/perl5381delta.1 index fbc1b1c4..701c3489 100644 --- a/upstream/fedora-rawhide/man1/perl5381delta.1 +++ b/upstream/fedora-rawhide/man1/perl5381delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5381DELTA 1" -.TH PERL5381DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5381DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl5382delta.1 b/upstream/fedora-rawhide/man1/perl5382delta.1 index 709fdae1..565270b8 100644 --- a/upstream/fedora-rawhide/man1/perl5382delta.1 +++ b/upstream/fedora-rawhide/man1/perl5382delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL5382DELTA 1" -.TH PERL5382DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL5382DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl561delta.1 b/upstream/fedora-rawhide/man1/perl561delta.1 index 30251f37..622ac8de 100644 --- a/upstream/fedora-rawhide/man1/perl561delta.1 +++ b/upstream/fedora-rawhide/man1/perl561delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL561DELTA 1" -.TH PERL561DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL561DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl56delta.1 b/upstream/fedora-rawhide/man1/perl56delta.1 index f9bbec81..bb467a4c 100644 --- a/upstream/fedora-rawhide/man1/perl56delta.1 +++ b/upstream/fedora-rawhide/man1/perl56delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL56DELTA 1" -.TH PERL56DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL56DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl581delta.1 b/upstream/fedora-rawhide/man1/perl581delta.1 index c11240ec..7db071f0 100644 --- a/upstream/fedora-rawhide/man1/perl581delta.1 +++ b/upstream/fedora-rawhide/man1/perl581delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL581DELTA 1" -.TH PERL581DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL581DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl582delta.1 b/upstream/fedora-rawhide/man1/perl582delta.1 index 533c9868..b67e6c04 100644 --- a/upstream/fedora-rawhide/man1/perl582delta.1 +++ b/upstream/fedora-rawhide/man1/perl582delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL582DELTA 1" -.TH PERL582DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL582DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl583delta.1 b/upstream/fedora-rawhide/man1/perl583delta.1 index a39fe016..f5528c2b 100644 --- a/upstream/fedora-rawhide/man1/perl583delta.1 +++ b/upstream/fedora-rawhide/man1/perl583delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL583DELTA 1" -.TH PERL583DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL583DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl584delta.1 b/upstream/fedora-rawhide/man1/perl584delta.1 index 083d6c74..8a7801f1 100644 --- a/upstream/fedora-rawhide/man1/perl584delta.1 +++ b/upstream/fedora-rawhide/man1/perl584delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL584DELTA 1" -.TH PERL584DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL584DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl585delta.1 b/upstream/fedora-rawhide/man1/perl585delta.1 index c63eb62c..90c1bb97 100644 --- a/upstream/fedora-rawhide/man1/perl585delta.1 +++ b/upstream/fedora-rawhide/man1/perl585delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL585DELTA 1" -.TH PERL585DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL585DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl586delta.1 b/upstream/fedora-rawhide/man1/perl586delta.1 index 00765bfc..73500a07 100644 --- a/upstream/fedora-rawhide/man1/perl586delta.1 +++ b/upstream/fedora-rawhide/man1/perl586delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL586DELTA 1" -.TH PERL586DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL586DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl587delta.1 b/upstream/fedora-rawhide/man1/perl587delta.1 index d7e1d485..e45fe35d 100644 --- a/upstream/fedora-rawhide/man1/perl587delta.1 +++ b/upstream/fedora-rawhide/man1/perl587delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL587DELTA 1" -.TH PERL587DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL587DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl588delta.1 b/upstream/fedora-rawhide/man1/perl588delta.1 index 3bfc6b87..8b174036 100644 --- a/upstream/fedora-rawhide/man1/perl588delta.1 +++ b/upstream/fedora-rawhide/man1/perl588delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL588DELTA 1" -.TH PERL588DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL588DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl589delta.1 b/upstream/fedora-rawhide/man1/perl589delta.1 index c750a9eb..aed17232 100644 --- a/upstream/fedora-rawhide/man1/perl589delta.1 +++ b/upstream/fedora-rawhide/man1/perl589delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL589DELTA 1" -.TH PERL589DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL589DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perl58delta.1 b/upstream/fedora-rawhide/man1/perl58delta.1 index 7a52cce5..3e342594 100644 --- a/upstream/fedora-rawhide/man1/perl58delta.1 +++ b/upstream/fedora-rawhide/man1/perl58delta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERL58DELTA 1" -.TH PERL58DELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERL58DELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlaix.1 b/upstream/fedora-rawhide/man1/perlaix.1 index b6b36d51..b92c0b01 100644 --- a/upstream/fedora-rawhide/man1/perlaix.1 +++ b/upstream/fedora-rawhide/man1/perlaix.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLAIX 1" -.TH PERLAIX 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLAIX 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlamiga.1 b/upstream/fedora-rawhide/man1/perlamiga.1 index e899e61a..a1169064 100644 --- a/upstream/fedora-rawhide/man1/perlamiga.1 +++ b/upstream/fedora-rawhide/man1/perlamiga.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLAMIGA 1" -.TH PERLAMIGA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLAMIGA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlandroid.1 b/upstream/fedora-rawhide/man1/perlandroid.1 index 77c2b060..d7710674 100644 --- a/upstream/fedora-rawhide/man1/perlandroid.1 +++ b/upstream/fedora-rawhide/man1/perlandroid.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLANDROID 1" -.TH PERLANDROID 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLANDROID 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlapi.1 b/upstream/fedora-rawhide/man1/perlapi.1 index 2fb329dc..fd656902 100644 --- a/upstream/fedora-rawhide/man1/perlapi.1 +++ b/upstream/fedora-rawhide/man1/perlapi.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLAPI 1" -.TH PERLAPI 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLAPI 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlapio.1 b/upstream/fedora-rawhide/man1/perlapio.1 index 0a2c60f4..6b9269f2 100644 --- a/upstream/fedora-rawhide/man1/perlapio.1 +++ b/upstream/fedora-rawhide/man1/perlapio.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLAPIO 1" -.TH PERLAPIO 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLAPIO 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlartistic.1 b/upstream/fedora-rawhide/man1/perlartistic.1 index 28dde25f..98cdbe67 100644 --- a/upstream/fedora-rawhide/man1/perlartistic.1 +++ b/upstream/fedora-rawhide/man1/perlartistic.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLARTISTIC 1" -.TH PERLARTISTIC 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLARTISTIC 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlbook.1 b/upstream/fedora-rawhide/man1/perlbook.1 index 46082080..6c2cda14 100644 --- a/upstream/fedora-rawhide/man1/perlbook.1 +++ b/upstream/fedora-rawhide/man1/perlbook.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLBOOK 1" -.TH PERLBOOK 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLBOOK 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlboot.1 b/upstream/fedora-rawhide/man1/perlboot.1 index e6bc011f..71d68bf7 100644 --- a/upstream/fedora-rawhide/man1/perlboot.1 +++ b/upstream/fedora-rawhide/man1/perlboot.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLBOOT 1" -.TH PERLBOOT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLBOOT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlbot.1 b/upstream/fedora-rawhide/man1/perlbot.1 index cdf9637f..eaf73a12 100644 --- a/upstream/fedora-rawhide/man1/perlbot.1 +++ b/upstream/fedora-rawhide/man1/perlbot.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLBOT 1" -.TH PERLBOT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLBOT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlbs2000.1 b/upstream/fedora-rawhide/man1/perlbs2000.1 index 59165bf1..137d4b14 100644 --- a/upstream/fedora-rawhide/man1/perlbs2000.1 +++ b/upstream/fedora-rawhide/man1/perlbs2000.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLBS2000 1" -.TH PERLBS2000 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLBS2000 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlcall.1 b/upstream/fedora-rawhide/man1/perlcall.1 index 9812e3e7..cc7d6a3d 100644 --- a/upstream/fedora-rawhide/man1/perlcall.1 +++ b/upstream/fedora-rawhide/man1/perlcall.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLCALL 1" -.TH PERLCALL 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLCALL 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlcheat.1 b/upstream/fedora-rawhide/man1/perlcheat.1 index 2c97e084..4bee3d5d 100644 --- a/upstream/fedora-rawhide/man1/perlcheat.1 +++ b/upstream/fedora-rawhide/man1/perlcheat.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLCHEAT 1" -.TH PERLCHEAT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLCHEAT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlclass.1 b/upstream/fedora-rawhide/man1/perlclass.1 index ca41d088..811219c5 100644 --- a/upstream/fedora-rawhide/man1/perlclass.1 +++ b/upstream/fedora-rawhide/man1/perlclass.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLCLASS 1" -.TH PERLCLASS 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLCLASS 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlclassguts.1 b/upstream/fedora-rawhide/man1/perlclassguts.1 index f6c4e730..ffadd19c 100644 --- a/upstream/fedora-rawhide/man1/perlclassguts.1 +++ b/upstream/fedora-rawhide/man1/perlclassguts.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLCLASSGUTS 1" -.TH PERLCLASSGUTS 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLCLASSGUTS 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlclib.1 b/upstream/fedora-rawhide/man1/perlclib.1 index 192f2088..2b1ac90a 100644 --- a/upstream/fedora-rawhide/man1/perlclib.1 +++ b/upstream/fedora-rawhide/man1/perlclib.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLCLIB 1" -.TH PERLCLIB 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLCLIB 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlcn.1 b/upstream/fedora-rawhide/man1/perlcn.1 index 4ec0e104..923332af 100644 --- a/upstream/fedora-rawhide/man1/perlcn.1 +++ b/upstream/fedora-rawhide/man1/perlcn.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLCN 1" -.TH PERLCN 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLCN 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlcommunity.1 b/upstream/fedora-rawhide/man1/perlcommunity.1 index c6aa7c79..5bbd4fba 100644 --- a/upstream/fedora-rawhide/man1/perlcommunity.1 +++ b/upstream/fedora-rawhide/man1/perlcommunity.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLCOMMUNITY 1" -.TH PERLCOMMUNITY 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLCOMMUNITY 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlcygwin.1 b/upstream/fedora-rawhide/man1/perlcygwin.1 index 0774b0d2..8bcf74c8 100644 --- a/upstream/fedora-rawhide/man1/perlcygwin.1 +++ b/upstream/fedora-rawhide/man1/perlcygwin.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLCYGWIN 1" -.TH PERLCYGWIN 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLCYGWIN 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perldata.1 b/upstream/fedora-rawhide/man1/perldata.1 index f4562a7e..a9519304 100644 --- a/upstream/fedora-rawhide/man1/perldata.1 +++ b/upstream/fedora-rawhide/man1/perldata.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLDATA 1" -.TH PERLDATA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLDATA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perldbmfilter.1 b/upstream/fedora-rawhide/man1/perldbmfilter.1 index 2f1054c3..af7419a7 100644 --- a/upstream/fedora-rawhide/man1/perldbmfilter.1 +++ b/upstream/fedora-rawhide/man1/perldbmfilter.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLDBMFILTER 1" -.TH PERLDBMFILTER 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLDBMFILTER 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perldebguts.1 b/upstream/fedora-rawhide/man1/perldebguts.1 index f85a1937..a2389df8 100644 --- a/upstream/fedora-rawhide/man1/perldebguts.1 +++ b/upstream/fedora-rawhide/man1/perldebguts.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLDEBGUTS 1" -.TH PERLDEBGUTS 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLDEBGUTS 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perldebtut.1 b/upstream/fedora-rawhide/man1/perldebtut.1 index 578504ba..2a076a0b 100644 --- a/upstream/fedora-rawhide/man1/perldebtut.1 +++ b/upstream/fedora-rawhide/man1/perldebtut.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLDEBTUT 1" -.TH PERLDEBTUT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLDEBTUT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perldelta.1 b/upstream/fedora-rawhide/man1/perldelta.1 index 6fb15497..8c7b4493 100644 --- a/upstream/fedora-rawhide/man1/perldelta.1 +++ b/upstream/fedora-rawhide/man1/perldelta.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLDELTA 1" -.TH PERLDELTA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLDELTA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perldeprecation.1 b/upstream/fedora-rawhide/man1/perldeprecation.1 index ce6c7bdf..f72191c5 100644 --- a/upstream/fedora-rawhide/man1/perldeprecation.1 +++ b/upstream/fedora-rawhide/man1/perldeprecation.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLDEPRECATION 1" -.TH PERLDEPRECATION 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLDEPRECATION 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perldocstyle.1 b/upstream/fedora-rawhide/man1/perldocstyle.1 index 2d6cf20f..b04a3a41 100644 --- a/upstream/fedora-rawhide/man1/perldocstyle.1 +++ b/upstream/fedora-rawhide/man1/perldocstyle.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLDOCSTYLE 1" -.TH PERLDOCSTYLE 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLDOCSTYLE 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perldsc.1 b/upstream/fedora-rawhide/man1/perldsc.1 index e39a2864..8c44af53 100644 --- a/upstream/fedora-rawhide/man1/perldsc.1 +++ b/upstream/fedora-rawhide/man1/perldsc.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLDSC 1" -.TH PERLDSC 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLDSC 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perldtrace.1 b/upstream/fedora-rawhide/man1/perldtrace.1 index 4b03c295..f67beafa 100644 --- a/upstream/fedora-rawhide/man1/perldtrace.1 +++ b/upstream/fedora-rawhide/man1/perldtrace.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLDTRACE 1" -.TH PERLDTRACE 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLDTRACE 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlebcdic.1 b/upstream/fedora-rawhide/man1/perlebcdic.1 index 6c0053cb..da9202cd 100644 --- a/upstream/fedora-rawhide/man1/perlebcdic.1 +++ b/upstream/fedora-rawhide/man1/perlebcdic.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLEBCDIC 1" -.TH PERLEBCDIC 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLEBCDIC 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlembed.1 b/upstream/fedora-rawhide/man1/perlembed.1 index 61f9d3cb..408dfb02 100644 --- a/upstream/fedora-rawhide/man1/perlembed.1 +++ b/upstream/fedora-rawhide/man1/perlembed.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLEMBED 1" -.TH PERLEMBED 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLEMBED 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlexperiment.1 b/upstream/fedora-rawhide/man1/perlexperiment.1 index 1dc2f817..c6bc326c 100644 --- a/upstream/fedora-rawhide/man1/perlexperiment.1 +++ b/upstream/fedora-rawhide/man1/perlexperiment.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLEXPERIMENT 1" -.TH PERLEXPERIMENT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLEXPERIMENT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlfork.1 b/upstream/fedora-rawhide/man1/perlfork.1 index 7c4e9d4e..5cf5f6da 100644 --- a/upstream/fedora-rawhide/man1/perlfork.1 +++ b/upstream/fedora-rawhide/man1/perlfork.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLFORK 1" -.TH PERLFORK 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLFORK 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlform.1 b/upstream/fedora-rawhide/man1/perlform.1 index 4a643e4a..c65902c1 100644 --- a/upstream/fedora-rawhide/man1/perlform.1 +++ b/upstream/fedora-rawhide/man1/perlform.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLFORM 1" -.TH PERLFORM 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLFORM 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlfreebsd.1 b/upstream/fedora-rawhide/man1/perlfreebsd.1 index d468d8a6..07affc3b 100644 --- a/upstream/fedora-rawhide/man1/perlfreebsd.1 +++ b/upstream/fedora-rawhide/man1/perlfreebsd.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLFREEBSD 1" -.TH PERLFREEBSD 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLFREEBSD 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlfunc.1 b/upstream/fedora-rawhide/man1/perlfunc.1 index 10d8ae2f..21c279e8 100644 --- a/upstream/fedora-rawhide/man1/perlfunc.1 +++ b/upstream/fedora-rawhide/man1/perlfunc.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLFUNC 1" -.TH PERLFUNC 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLFUNC 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlgit.1 b/upstream/fedora-rawhide/man1/perlgit.1 index 3dbc088a..816166f0 100644 --- a/upstream/fedora-rawhide/man1/perlgit.1 +++ b/upstream/fedora-rawhide/man1/perlgit.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLGIT 1" -.TH PERLGIT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLGIT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlgov.1 b/upstream/fedora-rawhide/man1/perlgov.1 index a65653f1..337a472b 100644 --- a/upstream/fedora-rawhide/man1/perlgov.1 +++ b/upstream/fedora-rawhide/man1/perlgov.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLGOV 1" -.TH PERLGOV 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLGOV 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlgpl.1 b/upstream/fedora-rawhide/man1/perlgpl.1 index 143bf270..1fe81dc3 100644 --- a/upstream/fedora-rawhide/man1/perlgpl.1 +++ b/upstream/fedora-rawhide/man1/perlgpl.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLGPL 1" -.TH PERLGPL 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLGPL 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlguts.1 b/upstream/fedora-rawhide/man1/perlguts.1 index fe69a378..6d056ffb 100644 --- a/upstream/fedora-rawhide/man1/perlguts.1 +++ b/upstream/fedora-rawhide/man1/perlguts.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLGUTS 1" -.TH PERLGUTS 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLGUTS 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlhack.1 b/upstream/fedora-rawhide/man1/perlhack.1 index a3361075..e6eb7c6d 100644 --- a/upstream/fedora-rawhide/man1/perlhack.1 +++ b/upstream/fedora-rawhide/man1/perlhack.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLHACK 1" -.TH PERLHACK 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLHACK 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlhacktips.1 b/upstream/fedora-rawhide/man1/perlhacktips.1 index 4f320492..c02176c1 100644 --- a/upstream/fedora-rawhide/man1/perlhacktips.1 +++ b/upstream/fedora-rawhide/man1/perlhacktips.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLHACKTIPS 1" -.TH PERLHACKTIPS 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLHACKTIPS 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlhacktut.1 b/upstream/fedora-rawhide/man1/perlhacktut.1 index 2ea619a5..ada58da5 100644 --- a/upstream/fedora-rawhide/man1/perlhacktut.1 +++ b/upstream/fedora-rawhide/man1/perlhacktut.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLHACKTUT 1" -.TH PERLHACKTUT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLHACKTUT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlhaiku.1 b/upstream/fedora-rawhide/man1/perlhaiku.1 index 318cb477..ec9bcfff 100644 --- a/upstream/fedora-rawhide/man1/perlhaiku.1 +++ b/upstream/fedora-rawhide/man1/perlhaiku.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLHAIKU 1" -.TH PERLHAIKU 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLHAIKU 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlhist.1 b/upstream/fedora-rawhide/man1/perlhist.1 index 791fd9af..603cd686 100644 --- a/upstream/fedora-rawhide/man1/perlhist.1 +++ b/upstream/fedora-rawhide/man1/perlhist.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLHIST 1" -.TH PERLHIST 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLHIST 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlhpux.1 b/upstream/fedora-rawhide/man1/perlhpux.1 index b764955d..984d3e4e 100644 --- a/upstream/fedora-rawhide/man1/perlhpux.1 +++ b/upstream/fedora-rawhide/man1/perlhpux.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLHPUX 1" -.TH PERLHPUX 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLHPUX 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlhurd.1 b/upstream/fedora-rawhide/man1/perlhurd.1 index 9b39bdf7..495cf565 100644 --- a/upstream/fedora-rawhide/man1/perlhurd.1 +++ b/upstream/fedora-rawhide/man1/perlhurd.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLHURD 1" -.TH PERLHURD 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLHURD 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlintern.1 b/upstream/fedora-rawhide/man1/perlintern.1 index d9793509..ddb461aa 100644 --- a/upstream/fedora-rawhide/man1/perlintern.1 +++ b/upstream/fedora-rawhide/man1/perlintern.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLINTERN 1" -.TH PERLINTERN 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLINTERN 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlinterp.1 b/upstream/fedora-rawhide/man1/perlinterp.1 index e69e6d98..2add4cac 100644 --- a/upstream/fedora-rawhide/man1/perlinterp.1 +++ b/upstream/fedora-rawhide/man1/perlinterp.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLINTERP 1" -.TH PERLINTERP 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLINTERP 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlintro.1 b/upstream/fedora-rawhide/man1/perlintro.1 index 48c30806..c42f34d9 100644 --- a/upstream/fedora-rawhide/man1/perlintro.1 +++ b/upstream/fedora-rawhide/man1/perlintro.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLINTRO 1" -.TH PERLINTRO 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLINTRO 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perliol.1 b/upstream/fedora-rawhide/man1/perliol.1 index 1ef5a0ca..4496e147 100644 --- a/upstream/fedora-rawhide/man1/perliol.1 +++ b/upstream/fedora-rawhide/man1/perliol.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLIOL 1" -.TH PERLIOL 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLIOL 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlipc.1 b/upstream/fedora-rawhide/man1/perlipc.1 index 7f4db57b..73f1a902 100644 --- a/upstream/fedora-rawhide/man1/perlipc.1 +++ b/upstream/fedora-rawhide/man1/perlipc.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLIPC 1" -.TH PERLIPC 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLIPC 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlirix.1 b/upstream/fedora-rawhide/man1/perlirix.1 index 2c43328c..cd66f596 100644 --- a/upstream/fedora-rawhide/man1/perlirix.1 +++ b/upstream/fedora-rawhide/man1/perlirix.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLIRIX 1" -.TH PERLIRIX 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLIRIX 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perljp.1 b/upstream/fedora-rawhide/man1/perljp.1 index e156a9b1..5f63395d 100644 --- a/upstream/fedora-rawhide/man1/perljp.1 +++ b/upstream/fedora-rawhide/man1/perljp.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLJP 1" -.TH PERLJP 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLJP 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlko.1 b/upstream/fedora-rawhide/man1/perlko.1 index a5e97835..bc05a1ef 100644 --- a/upstream/fedora-rawhide/man1/perlko.1 +++ b/upstream/fedora-rawhide/man1/perlko.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLKO 1" -.TH PERLKO 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLKO 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perllexwarn.1 b/upstream/fedora-rawhide/man1/perllexwarn.1 index 851685c9..ecf3dc6f 100644 --- a/upstream/fedora-rawhide/man1/perllexwarn.1 +++ b/upstream/fedora-rawhide/man1/perllexwarn.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLLEXWARN 1" -.TH PERLLEXWARN 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLLEXWARN 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perllinux.1 b/upstream/fedora-rawhide/man1/perllinux.1 index 77788a9b..9c0555e0 100644 --- a/upstream/fedora-rawhide/man1/perllinux.1 +++ b/upstream/fedora-rawhide/man1/perllinux.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLLINUX 1" -.TH PERLLINUX 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLLINUX 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perllocale.1 b/upstream/fedora-rawhide/man1/perllocale.1 index df2f07ad..ceba5d74 100644 --- a/upstream/fedora-rawhide/man1/perllocale.1 +++ b/upstream/fedora-rawhide/man1/perllocale.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLLOCALE 1" -.TH PERLLOCALE 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLLOCALE 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perllol.1 b/upstream/fedora-rawhide/man1/perllol.1 index 07c66853..48fad350 100644 --- a/upstream/fedora-rawhide/man1/perllol.1 +++ b/upstream/fedora-rawhide/man1/perllol.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLLOL 1" -.TH PERLLOL 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLLOL 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlmacosx.1 b/upstream/fedora-rawhide/man1/perlmacosx.1 index 95b17718..f0b8c727 100644 --- a/upstream/fedora-rawhide/man1/perlmacosx.1 +++ b/upstream/fedora-rawhide/man1/perlmacosx.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLMACOSX 1" -.TH PERLMACOSX 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLMACOSX 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlmod.1 b/upstream/fedora-rawhide/man1/perlmod.1 index b808e2f9..3f462e30 100644 --- a/upstream/fedora-rawhide/man1/perlmod.1 +++ b/upstream/fedora-rawhide/man1/perlmod.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLMOD 1" -.TH PERLMOD 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLMOD 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlmodinstall.1 b/upstream/fedora-rawhide/man1/perlmodinstall.1 index 5a5c78ce..5bc549b6 100644 --- a/upstream/fedora-rawhide/man1/perlmodinstall.1 +++ b/upstream/fedora-rawhide/man1/perlmodinstall.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLMODINSTALL 1" -.TH PERLMODINSTALL 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLMODINSTALL 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlmodlib.1 b/upstream/fedora-rawhide/man1/perlmodlib.1 index e0f23907..37630986 100644 --- a/upstream/fedora-rawhide/man1/perlmodlib.1 +++ b/upstream/fedora-rawhide/man1/perlmodlib.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLMODLIB 1" -.TH PERLMODLIB 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLMODLIB 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlmodstyle.1 b/upstream/fedora-rawhide/man1/perlmodstyle.1 index 23e58749..8b4a709f 100644 --- a/upstream/fedora-rawhide/man1/perlmodstyle.1 +++ b/upstream/fedora-rawhide/man1/perlmodstyle.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLMODSTYLE 1" -.TH PERLMODSTYLE 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLMODSTYLE 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlmroapi.1 b/upstream/fedora-rawhide/man1/perlmroapi.1 index ada82686..87c8ef3c 100644 --- a/upstream/fedora-rawhide/man1/perlmroapi.1 +++ b/upstream/fedora-rawhide/man1/perlmroapi.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLMROAPI 1" -.TH PERLMROAPI 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLMROAPI 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlnewmod.1 b/upstream/fedora-rawhide/man1/perlnewmod.1 index 8006b3ce..c8c44152 100644 --- a/upstream/fedora-rawhide/man1/perlnewmod.1 +++ b/upstream/fedora-rawhide/man1/perlnewmod.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLNEWMOD 1" -.TH PERLNEWMOD 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLNEWMOD 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlnumber.1 b/upstream/fedora-rawhide/man1/perlnumber.1 index 20993b34..c48cfa54 100644 --- a/upstream/fedora-rawhide/man1/perlnumber.1 +++ b/upstream/fedora-rawhide/man1/perlnumber.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLNUMBER 1" -.TH PERLNUMBER 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLNUMBER 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlobj.1 b/upstream/fedora-rawhide/man1/perlobj.1 index c4b9ae23..48671199 100644 --- a/upstream/fedora-rawhide/man1/perlobj.1 +++ b/upstream/fedora-rawhide/man1/perlobj.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLOBJ 1" -.TH PERLOBJ 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLOBJ 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlootut.1 b/upstream/fedora-rawhide/man1/perlootut.1 index 23dbebe7..45f30f28 100644 --- a/upstream/fedora-rawhide/man1/perlootut.1 +++ b/upstream/fedora-rawhide/man1/perlootut.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLOOTUT 1" -.TH PERLOOTUT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLOOTUT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlop.1 b/upstream/fedora-rawhide/man1/perlop.1 index 78d54829..45128b55 100644 --- a/upstream/fedora-rawhide/man1/perlop.1 +++ b/upstream/fedora-rawhide/man1/perlop.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLOP 1" -.TH PERLOP 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLOP 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlopenbsd.1 b/upstream/fedora-rawhide/man1/perlopenbsd.1 index 5f9eeae8..46ef9688 100644 --- a/upstream/fedora-rawhide/man1/perlopenbsd.1 +++ b/upstream/fedora-rawhide/man1/perlopenbsd.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLOPENBSD 1" -.TH PERLOPENBSD 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLOPENBSD 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlopentut.1 b/upstream/fedora-rawhide/man1/perlopentut.1 index ffc4f051..48c6e1ad 100644 --- a/upstream/fedora-rawhide/man1/perlopentut.1 +++ b/upstream/fedora-rawhide/man1/perlopentut.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLOPENTUT 1" -.TH PERLOPENTUT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLOPENTUT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlos2.1 b/upstream/fedora-rawhide/man1/perlos2.1 index 48fd59f9..8772b848 100644 --- a/upstream/fedora-rawhide/man1/perlos2.1 +++ b/upstream/fedora-rawhide/man1/perlos2.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLOS2 1" -.TH PERLOS2 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLOS2 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlos390.1 b/upstream/fedora-rawhide/man1/perlos390.1 index b12afb32..93740650 100644 --- a/upstream/fedora-rawhide/man1/perlos390.1 +++ b/upstream/fedora-rawhide/man1/perlos390.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLOS390 1" -.TH PERLOS390 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLOS390 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlos400.1 b/upstream/fedora-rawhide/man1/perlos400.1 index 021ef913..4c4f5022 100644 --- a/upstream/fedora-rawhide/man1/perlos400.1 +++ b/upstream/fedora-rawhide/man1/perlos400.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLOS400 1" -.TH PERLOS400 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLOS400 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlpacktut.1 b/upstream/fedora-rawhide/man1/perlpacktut.1 index 7ae087e5..3e30028c 100644 --- a/upstream/fedora-rawhide/man1/perlpacktut.1 +++ b/upstream/fedora-rawhide/man1/perlpacktut.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLPACKTUT 1" -.TH PERLPACKTUT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLPACKTUT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlperf.1 b/upstream/fedora-rawhide/man1/perlperf.1 index ec602ed3..6e613526 100644 --- a/upstream/fedora-rawhide/man1/perlperf.1 +++ b/upstream/fedora-rawhide/man1/perlperf.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLPERF 1" -.TH PERLPERF 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLPERF 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlplan9.1 b/upstream/fedora-rawhide/man1/perlplan9.1 index a08eb844..1e386daa 100644 --- a/upstream/fedora-rawhide/man1/perlplan9.1 +++ b/upstream/fedora-rawhide/man1/perlplan9.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLPLAN9 1" -.TH PERLPLAN9 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLPLAN9 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlpod.1 b/upstream/fedora-rawhide/man1/perlpod.1 index be76f3a3..539bfdc2 100644 --- a/upstream/fedora-rawhide/man1/perlpod.1 +++ b/upstream/fedora-rawhide/man1/perlpod.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLPOD 1" -.TH PERLPOD 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLPOD 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlpodspec.1 b/upstream/fedora-rawhide/man1/perlpodspec.1 index c47435d1..f9db149b 100644 --- a/upstream/fedora-rawhide/man1/perlpodspec.1 +++ b/upstream/fedora-rawhide/man1/perlpodspec.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLPODSPEC 1" -.TH PERLPODSPEC 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLPODSPEC 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlpolicy.1 b/upstream/fedora-rawhide/man1/perlpolicy.1 index 7143adc5..c294e2b0 100644 --- a/upstream/fedora-rawhide/man1/perlpolicy.1 +++ b/upstream/fedora-rawhide/man1/perlpolicy.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLPOLICY 1" -.TH PERLPOLICY 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLPOLICY 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlport.1 b/upstream/fedora-rawhide/man1/perlport.1 index 8262b2c1..f31cb8a3 100644 --- a/upstream/fedora-rawhide/man1/perlport.1 +++ b/upstream/fedora-rawhide/man1/perlport.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLPORT 1" -.TH PERLPORT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLPORT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlpragma.1 b/upstream/fedora-rawhide/man1/perlpragma.1 index 443f8057..18e4cdb4 100644 --- a/upstream/fedora-rawhide/man1/perlpragma.1 +++ b/upstream/fedora-rawhide/man1/perlpragma.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLPRAGMA 1" -.TH PERLPRAGMA 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLPRAGMA 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlqnx.1 b/upstream/fedora-rawhide/man1/perlqnx.1 index 0d3cd049..a9b259c3 100644 --- a/upstream/fedora-rawhide/man1/perlqnx.1 +++ b/upstream/fedora-rawhide/man1/perlqnx.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLQNX 1" -.TH PERLQNX 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLQNX 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlre.1 b/upstream/fedora-rawhide/man1/perlre.1 index 82e03b65..4808a5ad 100644 --- a/upstream/fedora-rawhide/man1/perlre.1 +++ b/upstream/fedora-rawhide/man1/perlre.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLRE 1" -.TH PERLRE 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLRE 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlreapi.1 b/upstream/fedora-rawhide/man1/perlreapi.1 index 05dee3ac..c8f11971 100644 --- a/upstream/fedora-rawhide/man1/perlreapi.1 +++ b/upstream/fedora-rawhide/man1/perlreapi.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLREAPI 1" -.TH PERLREAPI 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLREAPI 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlrebackslash.1 b/upstream/fedora-rawhide/man1/perlrebackslash.1 index d4a33dde..bd7a0a26 100644 --- a/upstream/fedora-rawhide/man1/perlrebackslash.1 +++ b/upstream/fedora-rawhide/man1/perlrebackslash.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLREBACKSLASH 1" -.TH PERLREBACKSLASH 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLREBACKSLASH 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlrecharclass.1 b/upstream/fedora-rawhide/man1/perlrecharclass.1 index c72d550f..fb73d060 100644 --- a/upstream/fedora-rawhide/man1/perlrecharclass.1 +++ b/upstream/fedora-rawhide/man1/perlrecharclass.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLRECHARCLASS 1" -.TH PERLRECHARCLASS 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLRECHARCLASS 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlref.1 b/upstream/fedora-rawhide/man1/perlref.1 index 2f989264..9bc4f9b7 100644 --- a/upstream/fedora-rawhide/man1/perlref.1 +++ b/upstream/fedora-rawhide/man1/perlref.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLREF 1" -.TH PERLREF 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLREF 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlreftut.1 b/upstream/fedora-rawhide/man1/perlreftut.1 index 84edb45f..cecd06aa 100644 --- a/upstream/fedora-rawhide/man1/perlreftut.1 +++ b/upstream/fedora-rawhide/man1/perlreftut.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLREFTUT 1" -.TH PERLREFTUT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLREFTUT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlreguts.1 b/upstream/fedora-rawhide/man1/perlreguts.1 index 94308646..168ddcdf 100644 --- a/upstream/fedora-rawhide/man1/perlreguts.1 +++ b/upstream/fedora-rawhide/man1/perlreguts.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLREGUTS 1" -.TH PERLREGUTS 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLREGUTS 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlrepository.1 b/upstream/fedora-rawhide/man1/perlrepository.1 index 5917c95a..7c80661f 100644 --- a/upstream/fedora-rawhide/man1/perlrepository.1 +++ b/upstream/fedora-rawhide/man1/perlrepository.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLREPOSITORY 1" -.TH PERLREPOSITORY 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLREPOSITORY 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlrequick.1 b/upstream/fedora-rawhide/man1/perlrequick.1 index 83b0c982..31d08bf7 100644 --- a/upstream/fedora-rawhide/man1/perlrequick.1 +++ b/upstream/fedora-rawhide/man1/perlrequick.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLREQUICK 1" -.TH PERLREQUICK 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLREQUICK 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlreref.1 b/upstream/fedora-rawhide/man1/perlreref.1 index fd790fde..210073a6 100644 --- a/upstream/fedora-rawhide/man1/perlreref.1 +++ b/upstream/fedora-rawhide/man1/perlreref.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLREREF 1" -.TH PERLREREF 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLREREF 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlretut.1 b/upstream/fedora-rawhide/man1/perlretut.1 index 7ea8e90b..36b56f22 100644 --- a/upstream/fedora-rawhide/man1/perlretut.1 +++ b/upstream/fedora-rawhide/man1/perlretut.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLRETUT 1" -.TH PERLRETUT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLRETUT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlriscos.1 b/upstream/fedora-rawhide/man1/perlriscos.1 index 605bfe63..2a879c9b 100644 --- a/upstream/fedora-rawhide/man1/perlriscos.1 +++ b/upstream/fedora-rawhide/man1/perlriscos.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLRISCOS 1" -.TH PERLRISCOS 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLRISCOS 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlrun.1 b/upstream/fedora-rawhide/man1/perlrun.1 index 313975df..bffb96d0 100644 --- a/upstream/fedora-rawhide/man1/perlrun.1 +++ b/upstream/fedora-rawhide/man1/perlrun.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLRUN 1" -.TH PERLRUN 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLRUN 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlsec.1 b/upstream/fedora-rawhide/man1/perlsec.1 index f8ce0f90..7e09ec49 100644 --- a/upstream/fedora-rawhide/man1/perlsec.1 +++ b/upstream/fedora-rawhide/man1/perlsec.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLSEC 1" -.TH PERLSEC 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLSEC 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlsecpolicy.1 b/upstream/fedora-rawhide/man1/perlsecpolicy.1 index 81627422..441161ca 100644 --- a/upstream/fedora-rawhide/man1/perlsecpolicy.1 +++ b/upstream/fedora-rawhide/man1/perlsecpolicy.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLSECPOLICY 1" -.TH PERLSECPOLICY 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLSECPOLICY 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlsolaris.1 b/upstream/fedora-rawhide/man1/perlsolaris.1 index f405c2dd..26250875 100644 --- a/upstream/fedora-rawhide/man1/perlsolaris.1 +++ b/upstream/fedora-rawhide/man1/perlsolaris.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLSOLARIS 1" -.TH PERLSOLARIS 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLSOLARIS 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlsource.1 b/upstream/fedora-rawhide/man1/perlsource.1 index a07a61fe..5f652dff 100644 --- a/upstream/fedora-rawhide/man1/perlsource.1 +++ b/upstream/fedora-rawhide/man1/perlsource.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLSOURCE 1" -.TH PERLSOURCE 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLSOURCE 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlstyle.1 b/upstream/fedora-rawhide/man1/perlstyle.1 index 35ac98c0..33fe5908 100644 --- a/upstream/fedora-rawhide/man1/perlstyle.1 +++ b/upstream/fedora-rawhide/man1/perlstyle.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLSTYLE 1" -.TH PERLSTYLE 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLSTYLE 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlsub.1 b/upstream/fedora-rawhide/man1/perlsub.1 index 4c78b616..296cec7a 100644 --- a/upstream/fedora-rawhide/man1/perlsub.1 +++ b/upstream/fedora-rawhide/man1/perlsub.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLSUB 1" -.TH PERLSUB 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLSUB 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlsyn.1 b/upstream/fedora-rawhide/man1/perlsyn.1 index 41b270b0..606adca9 100644 --- a/upstream/fedora-rawhide/man1/perlsyn.1 +++ b/upstream/fedora-rawhide/man1/perlsyn.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLSYN 1" -.TH PERLSYN 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLSYN 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlsynology.1 b/upstream/fedora-rawhide/man1/perlsynology.1 index e42f8852..217bca14 100644 --- a/upstream/fedora-rawhide/man1/perlsynology.1 +++ b/upstream/fedora-rawhide/man1/perlsynology.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLSYNOLOGY 1" -.TH PERLSYNOLOGY 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLSYNOLOGY 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlthrtut.1 b/upstream/fedora-rawhide/man1/perlthrtut.1 index 52215d6b..7fa56453 100644 --- a/upstream/fedora-rawhide/man1/perlthrtut.1 +++ b/upstream/fedora-rawhide/man1/perlthrtut.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLTHRTUT 1" -.TH PERLTHRTUT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLTHRTUT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perltie.1 b/upstream/fedora-rawhide/man1/perltie.1 index 0d08064c..28013077 100644 --- a/upstream/fedora-rawhide/man1/perltie.1 +++ b/upstream/fedora-rawhide/man1/perltie.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLTIE 1" -.TH PERLTIE 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLTIE 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perltoc.1 b/upstream/fedora-rawhide/man1/perltoc.1 index b253d67d..2c96cc46 100644 --- a/upstream/fedora-rawhide/man1/perltoc.1 +++ b/upstream/fedora-rawhide/man1/perltoc.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLTOC 1" -.TH PERLTOC 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLTOC 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perltodo.1 b/upstream/fedora-rawhide/man1/perltodo.1 index cbc88a2d..36460781 100644 --- a/upstream/fedora-rawhide/man1/perltodo.1 +++ b/upstream/fedora-rawhide/man1/perltodo.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLTODO 1" -.TH PERLTODO 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLTODO 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perltooc.1 b/upstream/fedora-rawhide/man1/perltooc.1 index 2cafdc6a..ee5d9a99 100644 --- a/upstream/fedora-rawhide/man1/perltooc.1 +++ b/upstream/fedora-rawhide/man1/perltooc.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLTOOC 1" -.TH PERLTOOC 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLTOOC 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perltoot.1 b/upstream/fedora-rawhide/man1/perltoot.1 index 22a0cc5a..96ee3c3a 100644 --- a/upstream/fedora-rawhide/man1/perltoot.1 +++ b/upstream/fedora-rawhide/man1/perltoot.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLTOOT 1" -.TH PERLTOOT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLTOOT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perltrap.1 b/upstream/fedora-rawhide/man1/perltrap.1 index ec49bf9e..53e95668 100644 --- a/upstream/fedora-rawhide/man1/perltrap.1 +++ b/upstream/fedora-rawhide/man1/perltrap.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLTRAP 1" -.TH PERLTRAP 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLTRAP 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perltru64.1 b/upstream/fedora-rawhide/man1/perltru64.1 index 93814f2b..fa5ae57d 100644 --- a/upstream/fedora-rawhide/man1/perltru64.1 +++ b/upstream/fedora-rawhide/man1/perltru64.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLTRU64 1" -.TH PERLTRU64 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLTRU64 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perltw.1 b/upstream/fedora-rawhide/man1/perltw.1 index 7de66e8e..be2fdfc5 100644 --- a/upstream/fedora-rawhide/man1/perltw.1 +++ b/upstream/fedora-rawhide/man1/perltw.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLTW 1" -.TH PERLTW 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLTW 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlunicode.1 b/upstream/fedora-rawhide/man1/perlunicode.1 index fe2021bf..a9f3eedd 100644 --- a/upstream/fedora-rawhide/man1/perlunicode.1 +++ b/upstream/fedora-rawhide/man1/perlunicode.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLUNICODE 1" -.TH PERLUNICODE 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLUNICODE 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlunicook.1 b/upstream/fedora-rawhide/man1/perlunicook.1 index 7df30bb4..735254e2 100644 --- a/upstream/fedora-rawhide/man1/perlunicook.1 +++ b/upstream/fedora-rawhide/man1/perlunicook.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLUNICOOK 1" -.TH PERLUNICOOK 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLUNICOOK 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlunifaq.1 b/upstream/fedora-rawhide/man1/perlunifaq.1 index a6414c2d..40e970a9 100644 --- a/upstream/fedora-rawhide/man1/perlunifaq.1 +++ b/upstream/fedora-rawhide/man1/perlunifaq.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLUNIFAQ 1" -.TH PERLUNIFAQ 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLUNIFAQ 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perluniintro.1 b/upstream/fedora-rawhide/man1/perluniintro.1 index 08862270..ad0335ef 100644 --- a/upstream/fedora-rawhide/man1/perluniintro.1 +++ b/upstream/fedora-rawhide/man1/perluniintro.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLUNIINTRO 1" -.TH PERLUNIINTRO 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLUNIINTRO 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perluniprops.1 b/upstream/fedora-rawhide/man1/perluniprops.1 index b3ba2b8f..2f1b8933 100644 --- a/upstream/fedora-rawhide/man1/perluniprops.1 +++ b/upstream/fedora-rawhide/man1/perluniprops.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLUNIPROPS 1" -.TH PERLUNIPROPS 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLUNIPROPS 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlunitut.1 b/upstream/fedora-rawhide/man1/perlunitut.1 index 35861459..3cbe439b 100644 --- a/upstream/fedora-rawhide/man1/perlunitut.1 +++ b/upstream/fedora-rawhide/man1/perlunitut.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLUNITUT 1" -.TH PERLUNITUT 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLUNITUT 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlvar.1 b/upstream/fedora-rawhide/man1/perlvar.1 index 7244d76c..62a2f515 100644 --- a/upstream/fedora-rawhide/man1/perlvar.1 +++ b/upstream/fedora-rawhide/man1/perlvar.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLVAR 1" -.TH PERLVAR 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLVAR 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlvms.1 b/upstream/fedora-rawhide/man1/perlvms.1 index d13f7c6c..d5a847e7 100644 --- a/upstream/fedora-rawhide/man1/perlvms.1 +++ b/upstream/fedora-rawhide/man1/perlvms.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLVMS 1" -.TH PERLVMS 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLVMS 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlvos.1 b/upstream/fedora-rawhide/man1/perlvos.1 index 75ce383f..6830c4fe 100644 --- a/upstream/fedora-rawhide/man1/perlvos.1 +++ b/upstream/fedora-rawhide/man1/perlvos.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLVOS 1" -.TH PERLVOS 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLVOS 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/perlwin32.1 b/upstream/fedora-rawhide/man1/perlwin32.1 index 5573435a..33b1cb0c 100644 --- a/upstream/fedora-rawhide/man1/perlwin32.1 +++ b/upstream/fedora-rawhide/man1/perlwin32.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "PERLWIN32 1" -.TH PERLWIN32 1 2024-01-25 "perl v5.38.2" "Perl Programmers Reference Guide" +.TH PERLWIN32 1 2024-04-17 "perl v5.38.2" "Perl Programmers Reference Guide" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/pinky.1 b/upstream/fedora-rawhide/man1/pinky.1 index ff8ca242..5481caf9 100644 --- a/upstream/fedora-rawhide/man1/pinky.1 +++ b/upstream/fedora-rawhide/man1/pinky.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH PINKY "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH PINKY "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME pinky \- lightweight finger .SH SYNOPSIS @@ -36,6 +36,9 @@ omit the user's full name and remote host in short format omit the user's full name, remote host and idle time in short format .TP +\fB\-\-lookup\fR +attempt to canonicalize hostnames via DNS +.TP \fB\-\-help\fR display this help and exit .TP @@ -51,7 +54,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/pldd.1 b/upstream/fedora-rawhide/man1/pldd.1 index 955ffa82..db74dc9e 100644 --- a/upstream/fedora-rawhide/man1/pldd.1 +++ b/upstream/fedora-rawhide/man1/pldd.1 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pldd 1 2023-10-31 "Linux man-pages 6.06" +.TH pldd 1 2023-10-31 "Linux man-pages 6.7" .SH NAME pldd \- display dynamic shared objects linked into a process .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/portablectl.1 b/upstream/fedora-rawhide/man1/portablectl.1 index 4dba78bb..d0b277fc 100644 --- a/upstream/fedora-rawhide/man1/portablectl.1 +++ b/upstream/fedora-rawhide/man1/portablectl.1 @@ -1,5 +1,5 @@ '\" t -.TH "PORTABLECTL" "1" "" "systemd 255" "portablectl" +.TH "PORTABLECTL" "1" "" "systemd 256~rc3" "portablectl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -38,10 +38,10 @@ or \fIRootImage=\fR assignments (in case of service units) pointing to the image file or directory, ensuring the services will run within the file system context of the image\&. .PP -Portable service images are an efficient way to bundle multiple related services and other units together, and transfer them as a whole between systems\&. When these images are attached the local system the contained units may run in most ways like regular system\-provided units, either with full privileges or inside strict sandboxing, depending on the selected configuration\&. For more details, see +Portable service images are an efficient way to bundle multiple related services and other units together, and transfer them as a whole between systems\&. When these images are attached to the local system, the contained units may run in most ways like regular system\-provided units, either with full privileges or inside strict sandboxing, depending on the selected configuration\&. For more details, see \m[blue]\fBPortable Services Documentation\fR\m[]\&\s-2\u[1]\d\s+2\&. .PP -Specifically portable service images may be of the following kind: +Portable service images may be of the following kinds: .sp .RS 4 .ie n \{\ @@ -197,6 +197,18 @@ are passed, the portable services are immediately started (blocking operation un \fB\-\-no\-block\fR is passed) and/or enabled after attaching the image\&. .sp +In place of the image path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. +.sp +In place of the directory path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. +.sp Added in version 239\&. .RE .PP @@ -209,14 +221,14 @@ command above, and removes the unit file copies, drop\-ins and image symlink aga also to \fBdetach\fR\&. .sp -Added in version 239\&. -.PP If \fB\-\-now\fR and/or \fB\-\-enable\fR are passed, the portable services are immediately stopped (blocking operation) and/or disabled before detaching the image\&. Prefix(es) are also accepted, to be used in case the unit names do not match the image name as described in the \fBattach\fR\&. +.sp +Added in version 239\&. .RE .PP \fBreattach\fR \fIIMAGE\fR [\fIPREFIX\&...\fR] @@ -227,8 +239,6 @@ character has to match\&. If the new image doesn\*(Aqt exist, the existing one w \fBattach\fR command\&. .sp -Added in version 248\&. -.PP If \fB\-\-now\fR and/or @@ -236,6 +246,8 @@ and/or are passed, the portable services are immediately stopped if removed, started and/or enabled if added, or restarted if updated\&. Prefixes are also accepted, in the same way as described in the \fBattach\fR case\&. +.sp +Added in version 248\&. .RE .PP \fBinspect\fR \fIIMAGE\fR [\fIPREFIX\&...\fR] @@ -359,7 +371,7 @@ Suppresses additional informational output while running\&. Added in version 239\&. .RE .PP -\fB\-p\fR \fIPROFILE\fR, \fB\-\-profile=\fR\fIPROFILE\fR +\fB\-p\fR \fIPROFILE\fR, \fB\-\-profile=\fR\fB\fIPROFILE\fR\fR .RS 4 When attaching an image, select the profile to use\&. By default the "default" @@ -372,11 +384,13 @@ Added in version 239\&. .RS 4 When attaching an image, select whether to prefer copying or symlinking of files installed into the host system\&. Takes one of "copy" -(to prefer copying of files), +(files will be copied), "symlink" -(to prefer creation of symbolic links) or +(to prefer creation of symbolic links), "auto" -for an intermediary mode where security profile drop\-ins are symlinked while unit files are copied\&. Note that this option expresses a preference only, in cases where symbolic links cannot be created \(em for example when the image operated on is a raw disk image, and hence not directly referentiable from the host file system \(em copying of files is used unconditionally\&. +for an intermediary mode where security profile drop\-ins and images are symlinked while unit files are copied, or +"mixed" +(since v256) where security profile drop\-ins are symlinked while unit files and images are copied\&. Note that this option expresses a preference only, in cases where symbolic links cannot be created \(em for example when the image operated on is a raw disk image, and hence not directly referentiable from the host file system \(em copying of files is used unconditionally\&. .sp Added in version 239\&. .RE @@ -428,7 +442,14 @@ Don\*(Aqt block waiting for attach \-\-now to complete\&. Added in version 245\&. .RE .PP -\fB\-\-extension=\fR\fIPATH\fR +\fB\-\-clean\fR +.RS 4 +When detaching ensure the configuration, state, logs, cache, and runtime data directories of the portable service are removed from the host system\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-extension=\fR\fB\fIPATH\fR\fR .RS 4 Add an additional image \fIPATH\fR @@ -440,7 +461,7 @@ for the \fIExtensionImages=\fR directive and for the \fBsystemd-sysext\fR(8) -and\&. +and \fBsystemd-confext\fR(8) tools\&. The images must contain an extension\-release @@ -455,6 +476,18 @@ paragraph on .sp Note that the same extensions have to be specified, in the same order, when attaching and detaching\&. .sp +In place of the image path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. +.sp +In place of the directory path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. +.sp Added in version 249\&. .RE .PP @@ -592,7 +625,7 @@ On success, 0 is returned, a non\-zero failure code otherwise\&. .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, @@ -602,7 +635,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 @@ -721,6 +762,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\&. @@ -732,6 +779,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 @@ -787,10 +840,7 @@ and other conditions\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-sysext\fR(8), -\fBorg.freedesktop.portable1\fR(5), -\fBsystemd-portabled.service\fR(8) +\fBsystemd\fR(1), \fBsystemd-sysext\fR(8), \fBorg.freedesktop.portable1\fR(5), \fBsystemd-portabled.service\fR(8), \fBimportctl\fR(1) .SH "NOTES" .IP " 1." 4 Portable Services Documentation diff --git a/upstream/fedora-rawhide/man1/pr.1 b/upstream/fedora-rawhide/man1/pr.1 index a8278ce9..12bd6f19 100644 --- a/upstream/fedora-rawhide/man1/pr.1 +++ b/upstream/fedora-rawhide/man1/pr.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH PR "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH PR "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME pr \- convert text files for printing .SH SYNOPSIS @@ -121,7 +121,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/printenv.1 b/upstream/fedora-rawhide/man1/printenv.1 index 711b4d59..133dab20 100644 --- a/upstream/fedora-rawhide/man1/printenv.1 +++ b/upstream/fedora-rawhide/man1/printenv.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH PRINTENV "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH PRINTENV "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME printenv \- print all or part of environment .SH SYNOPSIS @@ -20,7 +20,7 @@ display this help and exit \fB\-\-version\fR output version information and exit .PP -NOTE: your shell may have its own version of printenv, which usually supersedes +Your shell may have its own version of printenv, which usually supersedes the version described here. Please refer to your shell's documentation for details about the options it supports. .SH AUTHOR @@ -30,7 +30,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/printf.1 b/upstream/fedora-rawhide/man1/printf.1 index 705802cc..fe30289a 100644 --- a/upstream/fedora-rawhide/man1/printf.1 +++ b/upstream/fedora-rawhide/man1/printf.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH PRINTF "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH PRINTF "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME printf \- format and print data .SH SYNOPSIS @@ -80,7 +80,7 @@ escaping non\-printable characters with the proposed POSIX $'' syntax. and all C format specifications ending with one of diouxXfeEgGcs, with ARGUMENTs converted to proper type first. Variable widths are handled. .PP -NOTE: your shell may have its own version of printf, which usually supersedes +Your shell may have its own version of printf, which usually supersedes the version described here. Please refer to your shell's documentation for details about the options it supports. .SH AUTHOR @@ -90,7 +90,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/ps2ascii.1 b/upstream/fedora-rawhide/man1/ps2ascii.1 index e36de044..818e1f4e 100644 --- a/upstream/fedora-rawhide/man1/ps2ascii.1 +++ b/upstream/fedora-rawhide/man1/ps2ascii.1 @@ -1,4 +1,4 @@ -.TH PS2ASCII 1 "01 November 2023" 10.02.1 "Ghostscript Tools" \" -*- nroff -*- +.TH PS2ASCII 1 "06 May 2024" 10.03.1 "Ghostscript Tools" \" -*- nroff -*- .SH NAME ps2ascii \- Ghostscript translator from PostScript or PDF to ASCII .SH SYNOPSIS @@ -22,7 +22,7 @@ system, from which you can get more details. .SH SEE ALSO pstotext(1), http://www.research.digital.com/SRC/virtualpaper/pstotext.html .SH VERSION -This document was last revised for Ghostscript version 10.02.1. +This document was last revised for Ghostscript version 10.03.1. .SH AUTHOR Artifex Software, Inc. are the primary maintainers of Ghostscript. diff --git a/upstream/fedora-rawhide/man1/ps2epsi.1 b/upstream/fedora-rawhide/man1/ps2epsi.1 index 4911c9de..c0509763 100644 --- a/upstream/fedora-rawhide/man1/ps2epsi.1 +++ b/upstream/fedora-rawhide/man1/ps2epsi.1 @@ -1,4 +1,4 @@ -.TH PS2EPSI 1 "01 November 2023" 10.02.1 "Ghostscript Tools" \" -*- nroff -*- +.TH PS2EPSI 1 "06 May 2024" 10.03.1 "Ghostscript Tools" \" -*- nroff -*- .SH NAME ps2epsi \- generate conforming Encapsulated PostScript .SH SYNOPSIS @@ -59,7 +59,7 @@ ps2epsi.ps>the Ghostscript program which does the work .SH SEE ALSO gs (1) .SH VERSION -This document was last revised for Ghostscript version 10.02.1. +This document was last revised for Ghostscript version 10.03.1. However, the content may be obsolete, or inconsistent with ps2epsi.txt. .SH AUTHOR George Cameron diff --git a/upstream/fedora-rawhide/man1/ps2pdf.1 b/upstream/fedora-rawhide/man1/ps2pdf.1 index c8288b6e..88b00649 100644 --- a/upstream/fedora-rawhide/man1/ps2pdf.1 +++ b/upstream/fedora-rawhide/man1/ps2pdf.1 @@ -1,4 +1,4 @@ -.TH PS2PDF 1 "01 November 2023" 10.02.1 Ghostscript \" -*- nroff -*- +.TH PS2PDF 1 "06 May 2024" 10.03.1 Ghostscript \" -*- nroff -*- .SH NAME ps2pdf \- Convert PostScript to PDF using ghostscript .br @@ -89,7 +89,7 @@ VectorDevices.htm in the Ghostscript documentation See http://bugs.ghostscript.com/ and the Usenet news group comp.lang.postscript. .SH VERSION -This document was last revised for Ghostscript version 10.02.1. +This document was last revised for Ghostscript version 10.03.1. .SH AUTHOR Artifex Software, Inc. are the primary maintainers of Ghostscript. diff --git a/upstream/fedora-rawhide/man1/ps2pdfwr.1 b/upstream/fedora-rawhide/man1/ps2pdfwr.1 index cfd2a8e8..4781e544 100644 --- a/upstream/fedora-rawhide/man1/ps2pdfwr.1 +++ b/upstream/fedora-rawhide/man1/ps2pdfwr.1 @@ -1,4 +1,4 @@ -.TH PS2PDFWR 1 "01 November 2023" 10.02.1 Ghostscript \" -*- nroff -*- +.TH PS2PDFWR 1 "06 May 2024" 10.03.1 Ghostscript \" -*- nroff -*- .SH NAME ps2pdfwr \- Convert PostScript to PDF without specifying CompatibilityLevel, using ghostscript .SH SYNOPSIS @@ -24,7 +24,7 @@ scripts all invoke this one with the addition of the respective compatibility le .SH SEE ALSO gs(1), ps2pdf(1) .SH VERSION -This document was last revised for Ghostscript version 10.02.1. +This document was last revised for Ghostscript version 10.03.1. .SH AUTHOR Artifex Software, Inc. are the primary maintainers of Ghostscript. diff --git a/upstream/fedora-rawhide/man1/ps2ps.1 b/upstream/fedora-rawhide/man1/ps2ps.1 index 884aa021..3d57f4ef 100644 --- a/upstream/fedora-rawhide/man1/ps2ps.1 +++ b/upstream/fedora-rawhide/man1/ps2ps.1 @@ -1,4 +1,4 @@ -.TH PS2PS 1 "01 November 2023" 10.02.1 "Ghostscript Tools" \" -*- nroff -*- +.TH PS2PS 1 "06 May 2024" 10.03.1 "Ghostscript Tools" \" -*- nroff -*- .SH NAME ps2ps, eps2eps \- Ghostscript PostScript "distiller" .SH SYNOPSIS @@ -22,7 +22,7 @@ system, from which you can get more details. .SH SEE ALSO ps2pdf(1), ps2ascii(1), ps2epsi(1) .SH VERSION -This document was last revised for Ghostscript version 10.02.1. +This document was last revised for Ghostscript version 10.03.1. .SH AUTHOR Artifex Software, Inc. are the primary maintainers of Ghostscript. diff --git a/upstream/fedora-rawhide/man1/ptx.1 b/upstream/fedora-rawhide/man1/ptx.1 index 96d491f1..51e15980 100644 --- a/upstream/fedora-rawhide/man1/ptx.1 +++ b/upstream/fedora-rawhide/man1/ptx.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH PTX "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH PTX "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME ptx \- produce a permuted index of file contents .SH SYNOPSIS @@ -80,7 +80,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/pwd.1 b/upstream/fedora-rawhide/man1/pwd.1 index fa32ba9c..0f03b3f1 100644 --- a/upstream/fedora-rawhide/man1/pwd.1 +++ b/upstream/fedora-rawhide/man1/pwd.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH PWD "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH PWD "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME pwd \- print name of current/working directory .SH SYNOPSIS @@ -24,7 +24,7 @@ output version information and exit .PP If no option is specified, \fB\-P\fR is assumed. .PP -NOTE: your shell may have its own version of pwd, which usually supersedes +Your shell may have its own version of pwd, which usually supersedes the version described here. Please refer to your shell's documentation for details about the options it supports. .SH AUTHOR @@ -34,7 +34,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/pzstd.1 b/upstream/fedora-rawhide/man1/pzstd.1 index 286c6e3d..2b5a9851 100644 --- a/upstream/fedora-rawhide/man1/pzstd.1 +++ b/upstream/fedora-rawhide/man1/pzstd.1 @@ -1,388 +1,566 @@ -.TH "ZSTD" "1" "March 2023" "zstd 1.5.5" "User Commands" +. +.TH "ZSTD" "1" "March 2024" "zstd 1.5.6" "User Commands" +. .SH "NAME" \fBzstd\fR \- zstd, zstdmt, unzstd, zstdcat \- Compress or decompress \.zst files +. .SH "SYNOPSIS" -.TS -allbox; -\fBzstd\fR [\fIOPTIONS\fR] [\- \fIINPUT\-FILE\fR] [\-o \fIOUTPUT\-FILE\fR] -.TE +\fBzstd\fR [\fIOPTIONS\fR] [\-|\fIINPUT\-FILE\fR] [\-o \fIOUTPUT\-FILE\fR] +. .P \fBzstdmt\fR is equivalent to \fBzstd \-T0\fR +. .P \fBunzstd\fR is equivalent to \fBzstd \-d\fR +. .P \fBzstdcat\fR is equivalent to \fBzstd \-dcf\fR +. .SH "DESCRIPTION" -\fBzstd\fR is a fast lossless compression algorithm and data compression tool, with command line syntax similar to \fBgzip\fR(1) and \fBxz\fR(1)\. It is based on the \fBLZ77\fR family, with further FSE & huff0 entropy stages\. \fBzstd\fR offers highly configurable compression speed, from fast modes at > 200 MB/s per core, to strong modes with excellent compression ratios\. It also features a very fast decoder, with speeds > 500 MB/s per core\. +\fBzstd\fR is a fast lossless compression algorithm and data compression tool, with command line syntax similar to \fBgzip\fR(1) and \fBxz\fR(1)\. It is based on the \fBLZ77\fR family, with further FSE & huff0 entropy stages\. \fBzstd\fR offers highly configurable compression speed, from fast modes at > 200 MB/s per core, to strong modes with excellent compression ratios\. It also features a very fast decoder, with speeds > 500 MB/s per core, which remains roughly stable at all compression settings\. +. .P -\fBzstd\fR command line syntax is generally similar to gzip, but features the following differences: -.IP "\[ci]" 4 +\fBzstd\fR command line syntax is generally similar to gzip, but features the following few differences: +. +.IP "\(bu" 4 Source files are preserved by default\. It\'s possible to remove them automatically by using the \fB\-\-rm\fR command\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 When compressing a single file, \fBzstd\fR displays progress notifications and result summary by default\. Use \fB\-q\fR to turn them off\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fBzstd\fR displays a short help page when command line is an error\. Use \fB\-q\fR to turn it off\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fBzstd\fR does not accept input from console, though it does accept \fBstdin\fR when it\'s not the console\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fBzstd\fR does not store the input\'s filename or attributes, only its contents\. +. .IP "" 0 +. .P \fBzstd\fR processes each \fIfile\fR according to the selected operation mode\. If no \fIfiles\fR are given or \fIfile\fR is \fB\-\fR, \fBzstd\fR reads from standard input and writes the processed data to standard output\. \fBzstd\fR will refuse to write compressed data to standard output if it is a terminal: it will display an error message and skip the file\. Similarly, \fBzstd\fR will refuse to read compressed data from standard input if it is a terminal\. +. .P Unless \fB\-\-stdout\fR or \fB\-o\fR is specified, \fIfiles\fR are written to a new file whose name is derived from the source \fIfile\fR name: -.IP "\[ci]" 4 +. +.IP "\(bu" 4 When compressing, the suffix \fB\.zst\fR is appended to the source filename to get the target filename\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 When decompressing, the \fB\.zst\fR suffix is removed from the source filename to get the target filename +. .IP "" 0 +. .SS "Concatenation with \.zst Files" It is possible to concatenate multiple \fB\.zst\fR files\. \fBzstd\fR will decompress such agglomerated file as if it was a single \fB\.zst\fR file\. +. .SH "OPTIONS" +. .SS "Integer Suffixes and Special Values" In most places where an integer argument is expected, an optional suffix is supported to easily indicate large integers\. There must be no space between the integer and the suffix\. +. .TP \fBKiB\fR -Multiply the integer by 1,024 (2\e^10)\. \fBKi\fR, \fBK\fR, and \fBKB\fR are accepted as synonyms for \fBKiB\fR\. +Multiply the integer by 1,024 (2^10)\. \fBKi\fR, \fBK\fR, and \fBKB\fR are accepted as synonyms for \fBKiB\fR\. +. .TP \fBMiB\fR -Multiply the integer by 1,048,576 (2\e^20)\. \fBMi\fR, \fBM\fR, and \fBMB\fR are accepted as synonyms for \fBMiB\fR\. +Multiply the integer by 1,048,576 (2^20)\. \fBMi\fR, \fBM\fR, and \fBMB\fR are accepted as synonyms for \fBMiB\fR\. +. .SS "Operation Mode" If multiple operation mode options are given, the last one takes effect\. +. .TP \fB\-z\fR, \fB\-\-compress\fR Compress\. This is the default operation mode when no operation mode option is specified and no other operation mode is implied from the command name (for example, \fBunzstd\fR implies \fB\-\-decompress\fR)\. +. .TP \fB\-d\fR, \fB\-\-decompress\fR, \fB\-\-uncompress\fR Decompress\. +. .TP \fB\-t\fR, \fB\-\-test\fR Test the integrity of compressed \fIfiles\fR\. This option is equivalent to \fB\-\-decompress \-\-stdout > /dev/null\fR, decompressed data is discarded and checksummed for errors\. No files are created or removed\. +. .TP \fB\-b#\fR Benchmark file(s) using compression level \fI#\fR\. See \fIBENCHMARK\fR below for a description of this operation\. +. .TP \fB\-\-train FILES\fR Use \fIFILES\fR as a training set to create a dictionary\. The training set should contain a lot of small files (> 100)\. See \fIDICTIONARY BUILDER\fR below for a description of this operation\. +. .TP \fB\-l\fR, \fB\-\-list\fR Display information related to a zstd compressed file, such as size, ratio, and checksum\. Some of these fields may not be available\. This command\'s output can be augmented with the \fB\-v\fR modifier\. +. .SS "Operation Modifiers" -.IP "\[ci]" 4 -\fB\-#\fR: selects \fB#\fR compression level [1\-19] (default: 3) -.IP "\[ci]" 4 +. +.IP "\(bu" 4 +\fB\-#\fR: selects \fB#\fR compression level [1\-19] (default: 3)\. Higher compression levels \fIgenerally\fR produce higher compression ratio at the expense of speed and memory\. A rough rule of thumb is that compression speed is expected to be divided by 2 every 2 levels\. Technically, each level is mapped to a set of advanced parameters (that can also be modified individually, see below)\. Because the compressor\'s behavior highly depends on the content to compress, there\'s no guarantee of a smooth progression from one level to another\. +. +.IP "\(bu" 4 \fB\-\-ultra\fR: unlocks high compression levels 20+ (maximum 22), using a lot more memory\. Note that decompression will also require more memory when using these levels\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-fast[=#]\fR: switch to ultra\-fast compression levels\. If \fB=#\fR is not present, it defaults to \fB1\fR\. The higher the value, the faster the compression speed, at the cost of some compression ratio\. This setting overwrites compression level if one was set previously\. Similarly, if a compression level is set after \fB\-\-fast\fR, it overrides it\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-T#\fR, \fB\-\-threads=#\fR: Compress using \fB#\fR working threads (default: 1)\. If \fB#\fR is 0, attempt to detect and use the number of physical CPU cores\. In all cases, the nb of threads is capped to \fBZSTDMT_NBWORKERS_MAX\fR, which is either 64 in 32\-bit mode, or 256 for 64\-bit environments\. This modifier does nothing if \fBzstd\fR is compiled without multithread support\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-single\-thread\fR: Use a single thread for both I/O and compression\. As compression is serialized with I/O, this can be slightly slower\. Single\-thread mode features significantly lower memory usage, which can be useful for systems with limited amount of memory, such as 32\-bit systems\. +. .IP Note 1: this mode is the only available one when multithread support is disabled\. +. .IP Note 2: this mode is different from \fB\-T1\fR, which spawns 1 compression thread in parallel with I/O\. Final compressed result is also slightly different from \fB\-T1\fR\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-auto\-threads={physical,logical} (default: physical)\fR: When using a default amount of threads via \fB\-T0\fR, choose the default based on the number of detected physical or logical cores\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-adapt[=min=#,max=#]\fR: \fBzstd\fR will dynamically adapt compression level to perceived I/O conditions\. Compression level adaptation can be observed live by using command \fB\-v\fR\. Adaptation can be constrained between supplied \fBmin\fR and \fBmax\fR levels\. The feature works when combined with multi\-threading and \fB\-\-long\fR mode\. It does not work with \fB\-\-single\-thread\fR\. It sets window size to 8 MiB by default (can be changed manually, see \fBwlog\fR)\. Due to the chaotic nature of dynamic adaptation, compressed result is not reproducible\. +. .IP \fINote\fR: at the time of this writing, \fB\-\-adapt\fR can remain stuck at low speed when combined with multiple worker threads (>=2)\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-long[=#]\fR: enables long distance matching with \fB#\fR \fBwindowLog\fR, if \fB#\fR is not present it defaults to \fB27\fR\. This increases the window size (\fBwindowLog\fR) and memory usage for both the compressor and decompressor\. This setting is designed to improve the compression ratio for files with long matches at a large distance\. +. .IP Note: If \fBwindowLog\fR is set to larger than 27, \fB\-\-long=windowLog\fR or \fB\-\-memory=windowSize\fR needs to be passed to the decompressor\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-D DICT\fR: use \fBDICT\fR as Dictionary to compress or decompress FILE(s) -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-patch\-from FILE\fR: Specify the file to be used as a reference point for zstd\'s diff engine\. This is effectively dictionary compression with some convenient parameter selection, namely that \fIwindowSize\fR > \fIsrcSize\fR\. +. .IP Note: cannot use both this and \fB\-D\fR together\. +. .IP Note: \fB\-\-long\fR mode will be automatically activated if \fIchainLog\fR < \fIfileLog\fR (\fIfileLog\fR being the \fIwindowLog\fR required to cover the whole file)\. You can also manually force it\. +. .IP Note: for all levels, you can use \fB\-\-patch\-from\fR in \fB\-\-single\-thread\fR mode to improve compression ratio at the cost of speed\. +. .IP Note: for level 19, you can get increased compression ratio at the cost of speed by specifying \fB\-\-zstd=targetLength=\fR to be something large (i\.e\. 4096), and by setting a large \fB\-\-zstd=chainLog=\fR\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-rsyncable\fR: \fBzstd\fR will periodically synchronize the compression state to make the compressed file more rsync\-friendly\. There is a negligible impact to compression ratio, and a potential impact to compression speed, perceptible at higher speeds, for example when combining \fB\-\-rsyncable\fR with many parallel worker threads\. This feature does not work with \fB\-\-single\-thread\fR\. You probably don\'t want to use it with long range mode, since it will decrease the effectiveness of the synchronization points, but your mileage may vary\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-C\fR, \fB\-\-[no\-]check\fR: add integrity check computed from uncompressed data (default: enabled) -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-[no\-]content\-size\fR: enable / disable whether or not the original size of the file is placed in the header of the compressed file\. The default option is \fB\-\-content\-size\fR (meaning that the original size will be placed in the header)\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-no\-dictID\fR: do not store dictionary ID within frame header (dictionary compression)\. The decoder will have to rely on implicit knowledge about which dictionary to use, it won\'t be able to check if it\'s correct\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-M#\fR, \fB\-\-memory=#\fR: Set a memory usage limit\. By default, \fBzstd\fR uses 128 MiB for decompression as the maximum amount of memory the decompressor is allowed to use, but you can override this manually if need be in either direction (i\.e\. you can increase or decrease it)\. +. .IP This is also used during compression when using with \fB\-\-patch\-from=\fR\. In this case, this parameter overrides that maximum size allowed for a dictionary\. (128 MiB)\. +. .IP Additionally, this can be used to limit memory for dictionary training\. This parameter overrides the default limit of 2 GiB\. zstd will load training samples up to the memory limit and ignore the rest\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-stream\-size=#\fR: Sets the pledged source size of input coming from a stream\. This value must be exact, as it will be included in the produced frame header\. Incorrect stream sizes will cause an error\. This information will be used to better optimize compression parameters, resulting in better and potentially faster compression, especially for smaller source sizes\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-size\-hint=#\fR: When handling input from a stream, \fBzstd\fR must guess how large the source size will be when optimizing compression parameters\. If the stream size is relatively small, this guess may be a poor one, resulting in a higher compression ratio than expected\. This feature allows for controlling the guess when needed\. Exact guesses result in better compression ratios\. Overestimates result in slightly degraded compression ratios, while underestimates may result in significant degradation\. -.IP "\[ci]" 4 -\fB\-o FILE\fR: save result into \fBFILE\fR\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 +\fB\-\-target\-compressed\-block\-size=#\fR: Attempt to produce compressed blocks of approximately this size\. This will split larger blocks in order to approach this target\. This feature is notably useful for improved latency, when the receiver can leverage receiving early incomplete data\. This parameter defines a loose target: compressed blocks will target this size "on average", but individual blocks can still be larger or smaller\. Enabling this feature can decrease compression speed by up to ~10% at level 1\. Higher levels will see smaller relative speed regression, becoming invisible at higher settings\. +. +.IP "\(bu" 4 \fB\-f\fR, \fB\-\-force\fR: disable input and output checks\. Allows overwriting existing files, input from console, output to stdout, operating on links, block devices, etc\. During decompression and when the output destination is stdout, pass\-through unrecognized formats as\-is\. -.IP "\[ci]" 4 -\fB\-c\fR, \fB\-\-stdout\fR: write to standard output (even if it is the console); keep original files unchanged\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 +\fB\-c\fR, \fB\-\-stdout\fR: write to standard output (even if it is the console); keep original files (disable \fB\-\-rm\fR)\. +. +.IP "\(bu" 4 +\fB\-o FILE\fR: save result into \fBFILE\fR\. Note that this operation is in conflict with \fB\-c\fR\. If both operations are present on the command line, the last expressed one wins\. +. +.IP "\(bu" 4 \fB\-\-[no\-]sparse\fR: enable / disable sparse FS support, to make files with many zeroes smaller on disk\. Creating sparse files may save disk space and speed up decompression by reducing the amount of disk I/O\. default: enabled when output is into a file, and disabled when output is stdout\. This setting overrides default and can force sparse mode over stdout\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-[no\-]pass\-through\fR enable / disable passing through uncompressed files as\-is\. During decompression when pass\-through is enabled, unrecognized formats will be copied as\-is from the input to the output\. By default, pass\-through will occur when the output destination is stdout and the force (\fB\-f\fR) option is set\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-rm\fR: remove source file(s) after successful compression or decompression\. This command is silently ignored if output is \fBstdout\fR\. If used in combination with \fB\-o\fR, triggers a confirmation prompt (which can be silenced with \fB\-f\fR), as this is a destructive operation\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-k\fR, \fB\-\-keep\fR: keep source file(s) after successful compression or decompression\. This is the default behavior\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-r\fR: operate recursively on directories\. It selects all files in the named directory and all its subdirectories\. This can be useful both to reduce command line typing, and to circumvent shell expansion limitations, when there are a lot of files and naming breaks the maximum size of a command line\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-filelist FILE\fR read a list of files to process as content from \fBFILE\fR\. Format is compatible with \fBls\fR output, with one file per line\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-output\-dir\-flat DIR\fR: resulting files are stored into target \fBDIR\fR directory, instead of same directory as origin file\. Be aware that this command can introduce name collision issues, if multiple files, from different directories, end up having the same name\. Collision resolution ensures first file with a given name will be present in \fBDIR\fR, while in combination with \fB\-f\fR, the last file will be present instead\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-output\-dir\-mirror DIR\fR: similar to \fB\-\-output\-dir\-flat\fR, the output files are stored underneath target \fBDIR\fR directory, but this option will replicate input directory hierarchy into output \fBDIR\fR\. +. .IP If input directory contains "\.\.", the files in this directory will be ignored\. If input directory is an absolute directory (i\.e\. "/var/tmp/abc"), it will be stored into the "output\-dir/var/tmp/abc"\. If there are multiple input files or directories, name collision resolution will follow the same rules as \fB\-\-output\-dir\-flat\fR\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-format=FORMAT\fR: compress and decompress in other formats\. If compiled with support, zstd can compress to or decompress from other compression algorithm formats\. Possibly available options are \fBzstd\fR, \fBgzip\fR, \fBxz\fR, \fBlzma\fR, and \fBlz4\fR\. If no such format is provided, \fBzstd\fR is the default\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-h\fR/\fB\-H\fR, \fB\-\-help\fR: display help/long help and exit -.IP "\[ci]" 4 -\fB\-V\fR, \fB\-\-version\fR: display version number and exit\. Advanced: \fB\-vV\fR also displays supported formats\. \fB\-vvV\fR also displays POSIX support\. \fB\-q\fR will only display the version number, suitable for machine reading\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 +\fB\-V\fR, \fB\-\-version\fR: display version number and immediately exit\. note that, since it exits, flags specified after \fB\-V\fR are effectively ignored\. Advanced: \fB\-vV\fR also displays supported formats\. \fB\-vvV\fR also displays POSIX support\. \fB\-qV\fR will only display the version number, suitable for machine reading\. +. +.IP "\(bu" 4 \fB\-v\fR, \fB\-\-verbose\fR: verbose mode, display more information -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-q\fR, \fB\-\-quiet\fR: suppress warnings, interactivity, and notifications\. specify twice to suppress errors too\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-no\-progress\fR: do not display the progress bar, but keep all other messages\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-show\-default\-cparams\fR: shows the default compression parameters that will be used for a particular input file, based on the provided compression level and the input size\. If the provided file is not a regular file (e\.g\. a pipe), this flag will output the parameters used for inputs of unknown size\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 +\fB\-\-exclude\-compressed\fR: only compress files that are not already compressed\. +. +.IP "\(bu" 4 \fB\-\-\fR: All arguments after \fB\-\-\fR are treated as files - -.SH Parallel Zstd OPTIONS -Additional options for the pzstd utility -.TP -.BR \-p ", " --processes - number of threads to use for (de)compression (default:4) - +. .IP "" 0 +. .SS "gzip Operation Modifiers" When invoked via a \fBgzip\fR symlink, \fBzstd\fR will support further options that intend to mimic the \fBgzip\fR behavior: +. .TP \fB\-n\fR, \fB\-\-no\-name\fR do not store the original filename and timestamps when compressing a file\. This is the default behavior and hence a no\-op\. +. .TP \fB\-\-best\fR alias to the option \fB\-9\fR\. +. .SS "Environment Variables" -Employing environment variables to set parameters has security implications\. Therefore, this avenue is intentionally limited\. Only \fBZSTD_CLEVEL\fR and \fBZSTD_NBTHREADS\fR are currently supported\. They set the compression level and number of threads to use during compression, respectively\. +Employing environment variables to set parameters has security implications\. Therefore, this avenue is intentionally limited\. Only \fBZSTD_CLEVEL\fR and \fBZSTD_NBTHREADS\fR are currently supported\. They set the default compression level and number of threads to use during compression, respectively\. +. .P \fBZSTD_CLEVEL\fR can be used to set the level between 1 and 19 (the "normal" range)\. If the value of \fBZSTD_CLEVEL\fR is not a valid integer, it will be ignored with a warning message\. \fBZSTD_CLEVEL\fR just replaces the default compression level (\fB3\fR)\. +. .P -\fBZSTD_NBTHREADS\fR can be used to set the number of threads \fBzstd\fR will attempt to use during compression\. If the value of \fBZSTD_NBTHREADS\fR is not a valid unsigned integer, it will be ignored with a warning message\. \fBZSTD_NBTHREADS\fR has a default value of (\fB1\fR), and is capped at ZSTDMT_NBWORKERS_MAX==200\. \fBzstd\fR must be compiled with multithread support for this to have any effect\. +\fBZSTD_NBTHREADS\fR can be used to set the number of threads \fBzstd\fR will attempt to use during compression\. If the value of \fBZSTD_NBTHREADS\fR is not a valid unsigned integer, it will be ignored with a warning message\. \fBZSTD_NBTHREADS\fR has a default value of (\fB1\fR), and is capped at ZSTDMT_NBWORKERS_MAX==200\. \fBzstd\fR must be compiled with multithread support for this variable to have any effect\. +. .P They can both be overridden by corresponding command line arguments: \fB\-#\fR for compression level and \fB\-T#\fR for number of compression threads\. -.SH "DICTIONARY BUILDER" -\fBzstd\fR offers \fIdictionary\fR compression, which greatly improves efficiency on small files and messages\. It\'s possible to train \fBzstd\fR with a set of samples, the result of which is saved into a file called a \fBdictionary\fR\. Then, during compression and decompression, reference the same dictionary, using command \fB\-D dictionaryFileName\fR\. Compression of small files similar to the sample set will be greatly improved\. -.TP -\fB\-\-train FILEs\fR -Use FILEs as training set to create a dictionary\. The training set should ideally contain a lot of samples (> 100), and weight typically 100x the target dictionary size (for example, ~10 MB for a 100 KB dictionary)\. \fB\-\-train\fR can be combined with \fB\-r\fR to indicate a directory rather than listing all the files, which can be useful to circumvent shell expansion limits\. -.IP -Since dictionary compression is mostly effective for small files, the expectation is that the training set will only contain small files\. In the case where some samples happen to be large, only the first 128 KiB of these samples will be used for training\. -.IP -\fB\-\-train\fR supports multithreading if \fBzstd\fR is compiled with threading support (default)\. Additional advanced parameters can be specified with \fB\-\-train\-fastcover\fR\. The legacy dictionary builder can be accessed with \fB\-\-train\-legacy\fR\. The slower cover dictionary builder can be accessed with \fB\-\-train\-cover\fR\. Default \fB\-\-train\fR is equivalent to \fB\-\-train\-fastcover=d=8,steps=4\fR\. -.TP -\fB\-o FILE\fR -Dictionary saved into \fBFILE\fR (default name: dictionary)\. -.TP -\fB\-\-maxdict=#\fR -Limit dictionary to specified size (default: 112640 bytes)\. As usual, quantities are expressed in bytes by default, and it\'s possible to employ suffixes (like \fBKB\fR or \fBMB\fR) to specify larger values\. -.TP -\fB\-#\fR -Use \fB#\fR compression level during training (optional)\. Will generate statistics more tuned for selected compression level, resulting in a \fIsmall\fR compression ratio improvement for this level\. -.TP -\fB\-B#\fR -Split input files into blocks of size # (default: no split) -.TP -\fB\-M#\fR, \fB\-\-memory=#\fR -Limit the amount of sample data loaded for training (default: 2 GB)\. Note that the default (2 GB) is also the maximum\. This parameter can be useful in situations where the training set size is not well controlled and could be potentially very large\. Since speed of the training process is directly correlated to the size of the training sample set, a smaller sample set leads to faster training\. -.IP -In situations where the training set is larger than maximum memory, the CLI will randomly select samples among the available ones, up to the maximum allowed memory budget\. This is meant to improve dictionary relevance by mitigating the potential impact of clustering, such as selecting only files from the beginning of a list sorted by modification date, or sorted by alphabetical order\. The randomization process is deterministic, so training of the same list of files with the same parameters will lead to the creation of the same dictionary\. -.TP -\fB\-\-dictID=#\fR -A dictionary ID is a locally unique ID\. The decoder will use this value to verify it is using the right dictionary\. By default, zstd will create a 4\-bytes random number ID\. It\'s possible to provide an explicit number ID instead\. It\'s up to the dictionary manager to not assign twice the same ID to 2 different dictionaries\. Note that short numbers have an advantage: an ID < 256 will only need 1 byte in the compressed frame header, and an ID < 65536 will only need 2 bytes\. This compares favorably to 4 bytes default\. -.IP -Note that RFC8878 reserves IDs less than 32768 and greater than or equal to 2\e^31, so they should not be used in public\. -.TP -\fB\-\-train\-cover[=k#,d=#,steps=#,split=#,shrink[=#]]\fR -Select parameters for the default dictionary builder algorithm named cover\. If \fId\fR is not specified, then it tries \fId\fR = 6 and \fId\fR = 8\. If \fIk\fR is not specified, then it tries \fIsteps\fR values in the range [50, 2000]\. If \fIsteps\fR is not specified, then the default value of 40 is used\. If \fIsplit\fR is not specified or split <= 0, then the default value of 100 is used\. Requires that \fId\fR <= \fIk\fR\. If \fIshrink\fR flag is not used, then the default value for \fIshrinkDict\fR of 0 is used\. If \fIshrink\fR is not specified, then the default value for \fIshrinkDictMaxRegression\fR of 1 is used\. -.IP -Selects segments of size \fIk\fR with highest score to put in the dictionary\. The score of a segment is computed by the sum of the frequencies of all the subsegments of size \fId\fR\. Generally \fId\fR should be in the range [6, 8], occasionally up to 16, but the algorithm will run faster with d <= \fI8\fR\. Good values for \fIk\fR vary widely based on the input data, but a safe range is [2 * \fId\fR, 2000]\. If \fIsplit\fR is 100, all input samples are used for both training and testing to find optimal \fId\fR and \fIk\fR to build dictionary\. Supports multithreading if \fBzstd\fR is compiled with threading support\. Having \fIshrink\fR enabled takes a truncated dictionary of minimum size and doubles in size until compression ratio of the truncated dictionary is at most \fIshrinkDictMaxRegression%\fR worse than the compression ratio of the largest dictionary\. -.IP -Examples: -.IP -\fBzstd \-\-train\-cover FILEs\fR -.IP -\fBzstd \-\-train\-cover=k=50,d=8 FILEs\fR -.IP -\fBzstd \-\-train\-cover=d=8,steps=500 FILEs\fR -.IP -\fBzstd \-\-train\-cover=k=50 FILEs\fR -.IP -\fBzstd \-\-train\-cover=k=50,split=60 FILEs\fR -.IP -\fBzstd \-\-train\-cover=shrink FILEs\fR -.IP -\fBzstd \-\-train\-cover=shrink=2 FILEs\fR -.TP -\fB\-\-train\-fastcover[=k#,d=#,f=#,steps=#,split=#,accel=#]\fR -Same as cover but with extra parameters \fIf\fR and \fIaccel\fR and different default value of split If \fIsplit\fR is not specified, then it tries \fIsplit\fR = 75\. If \fIf\fR is not specified, then it tries \fIf\fR = 20\. Requires that 0 < \fIf\fR < 32\. If \fIaccel\fR is not specified, then it tries \fIaccel\fR = 1\. Requires that 0 < \fIaccel\fR <= 10\. Requires that \fId\fR = 6 or \fId\fR = 8\. -.IP -\fIf\fR is log of size of array that keeps track of frequency of subsegments of size \fId\fR\. The subsegment is hashed to an index in the range [0,2^\fIf\fR \- 1]\. It is possible that 2 different subsegments are hashed to the same index, and they are considered as the same subsegment when computing frequency\. Using a higher \fIf\fR reduces collision but takes longer\. -.IP -Examples: -.IP -\fBzstd \-\-train\-fastcover FILEs\fR -.IP -\fBzstd \-\-train\-fastcover=d=8,f=15,accel=2 FILEs\fR -.TP -\fB\-\-train\-legacy[=selectivity=#]\fR -Use legacy dictionary builder algorithm with the given dictionary \fIselectivity\fR (default: 9)\. The smaller the \fIselectivity\fR value, the denser the dictionary, improving its efficiency but reducing its achievable maximum size\. \fB\-\-train\-legacy=s=#\fR is also accepted\. -.IP -Examples: -.IP -\fBzstd \-\-train\-legacy FILEs\fR -.IP -\fBzstd \-\-train\-legacy=selectivity=8 FILEs\fR -.SH "BENCHMARK" -.TP -\fB\-b#\fR -benchmark file(s) using compression level # -.TP -\fB\-e#\fR -benchmark file(s) using multiple compression levels, from \fB\-b#\fR to \fB\-e#\fR (inclusive) -.TP -\fB\-i#\fR -minimum evaluation time, in seconds (default: 3s), benchmark mode only -.TP -\fB\-B#\fR, \fB\-\-block\-size=#\fR -cut file(s) into independent chunks of size # (default: no chunking) -.TP -\fB\-\-priority=rt\fR -set process priority to real\-time -.P -\fBOutput Format:\fR CompressionLevel#Filename: InputSize \-> OutputSize (CompressionRatio), CompressionSpeed, DecompressionSpeed -.P -\fBMethodology:\fR For both compression and decompression speed, the entire input is compressed/decompressed in\-memory to measure speed\. A run lasts at least 1 sec, so when files are small, they are compressed/decompressed several times per run, in order to improve measurement accuracy\. +. .SH "ADVANCED COMPRESSION OPTIONS" -### \-B#: Specify the size of each compression job\. This parameter is only available when multi\-threading is enabled\. Each compression job is run in parallel, so this value indirectly impacts the nb of active threads\. Default job size varies depending on compression level (generally \fB4 * windowSize\fR)\. \fB\-B#\fR makes it possible to manually select a custom size\. Note that job size must respect a minimum value which is enforced transparently\. This minimum is either 512 KB, or \fBoverlapSize\fR, whichever is largest\. Different job sizes will lead to non\-identical compressed frames\. +\fBzstd\fR provides 22 predefined regular compression levels plus the fast levels\. A compression level is translated internally into multiple advanced parameters that control the behavior of the compressor (one can observe the result of this translation with \fB\-\-show\-default\-cparams\fR)\. These advanced parameters can be overridden using advanced compression options\. +. .SS "\-\-zstd[=options]:" -\fBzstd\fR provides 22 predefined regular compression levels plus the fast levels\. This compression level is translated internally into a number of specific parameters that actually control the behavior of the compressor\. (You can see the result of this translation with \fB\-\-show\-default\-cparams\fR\.) These specific parameters can be overridden with advanced compression options\. The \fIoptions\fR are provided as a comma\-separated list\. You may specify only the options you want to change and the rest will be taken from the selected or default compression level\. The list of available \fIoptions\fR: +The \fIoptions\fR are provided as a comma\-separated list\. You may specify only the options you want to change and the rest will be taken from the selected or default compression level\. The list of available \fIoptions\fR: +. .TP \fBstrategy\fR=\fIstrat\fR, \fBstrat\fR=\fIstrat\fR Specify a strategy used by a match finder\. +. .IP There are 9 strategies numbered from 1 to 9, from fastest to strongest: 1=\fBZSTD_fast\fR, 2=\fBZSTD_dfast\fR, 3=\fBZSTD_greedy\fR, 4=\fBZSTD_lazy\fR, 5=\fBZSTD_lazy2\fR, 6=\fBZSTD_btlazy2\fR, 7=\fBZSTD_btopt\fR, 8=\fBZSTD_btultra\fR, 9=\fBZSTD_btultra2\fR\. +. .TP \fBwindowLog\fR=\fIwlog\fR, \fBwlog\fR=\fIwlog\fR Specify the maximum number of bits for a match distance\. +. .IP The higher number of increases the chance to find a match which usually improves compression ratio\. It also increases memory requirements for the compressor and decompressor\. The minimum \fIwlog\fR is 10 (1 KiB) and the maximum is 30 (1 GiB) on 32\-bit platforms and 31 (2 GiB) on 64\-bit platforms\. +. .IP Note: If \fBwindowLog\fR is set to larger than 27, \fB\-\-long=windowLog\fR or \fB\-\-memory=windowSize\fR needs to be passed to the decompressor\. +. .TP \fBhashLog\fR=\fIhlog\fR, \fBhlog\fR=\fIhlog\fR Specify the maximum number of bits for a hash table\. +. .IP Bigger hash tables cause fewer collisions which usually makes compression faster, but requires more memory during compression\. +. .IP The minimum \fIhlog\fR is 6 (64 entries / 256 B) and the maximum is 30 (1B entries / 4 GiB)\. +. .TP \fBchainLog\fR=\fIclog\fR, \fBclog\fR=\fIclog\fR Specify the maximum number of bits for the secondary search structure, whose form depends on the selected \fBstrategy\fR\. +. .IP Higher numbers of bits increases the chance to find a match which usually improves compression ratio\. It also slows down compression speed and increases memory requirements for compression\. This option is ignored for the \fBZSTD_fast\fR \fBstrategy\fR, which only has the primary hash table\. +. .IP The minimum \fIclog\fR is 6 (64 entries / 256 B) and the maximum is 29 (512M entries / 2 GiB) on 32\-bit platforms and 30 (1B entries / 4 GiB) on 64\-bit platforms\. +. .TP \fBsearchLog\fR=\fIslog\fR, \fBslog\fR=\fIslog\fR Specify the maximum number of searches in a hash chain or a binary tree using logarithmic scale\. +. .IP More searches increases the chance to find a match which usually increases compression ratio but decreases compression speed\. +. .IP The minimum \fIslog\fR is 1 and the maximum is \'windowLog\' \- 1\. +. .TP \fBminMatch\fR=\fImml\fR, \fBmml\fR=\fImml\fR Specify the minimum searched length of a match in a hash table\. +. .IP Larger search lengths usually decrease compression ratio but improve decompression speed\. +. .IP The minimum \fImml\fR is 3 and the maximum is 7\. +. .TP \fBtargetLength\fR=\fItlen\fR, \fBtlen\fR=\fItlen\fR The impact of this field vary depending on selected strategy\. +. .IP For \fBZSTD_btopt\fR, \fBZSTD_btultra\fR and \fBZSTD_btultra2\fR, it specifies the minimum match length that causes match finder to stop searching\. A larger \fBtargetLength\fR usually improves compression ratio but decreases compression speed\. +. .IP For \fBZSTD_fast\fR, it triggers ultra\-fast mode when > 0\. The value represents the amount of data skipped between match sampling\. Impact is reversed: a larger \fBtargetLength\fR increases compression speed but decreases compression ratio\. +. .IP For all other strategies, this field has no impact\. +. .IP The minimum \fItlen\fR is 0 and the maximum is 128 KiB\. +. .TP \fBoverlapLog\fR=\fIovlog\fR, \fBovlog\fR=\fIovlog\fR Determine \fBoverlapSize\fR, amount of data reloaded from previous job\. This parameter is only available when multithreading is enabled\. Reloading more data improves compression ratio, but decreases speed\. +. .IP The minimum \fIovlog\fR is 0, and the maximum is 9\. 1 means "no overlap", hence completely independent jobs\. 9 means "full overlap", meaning up to \fBwindowSize\fR is reloaded from previous job\. Reducing \fIovlog\fR by 1 reduces the reloaded amount by a factor 2\. For example, 8 means "windowSize/2", and 6 means "windowSize/8"\. Value 0 is special and means "default": \fIovlog\fR is automatically determined by \fBzstd\fR\. In which case, \fIovlog\fR will range from 6 to 9, depending on selected \fIstrat\fR\. +. .TP \fBldmHashLog\fR=\fIlhlog\fR, \fBlhlog\fR=\fIlhlog\fR Specify the maximum size for a hash table used for long distance matching\. +. .IP This option is ignored unless long distance matching is enabled\. +. .IP Bigger hash tables usually improve compression ratio at the expense of more memory during compression and a decrease in compression speed\. +. .IP The minimum \fIlhlog\fR is 6 and the maximum is 30 (default: 20)\. +. .TP \fBldmMinMatch\fR=\fIlmml\fR, \fBlmml\fR=\fIlmml\fR Specify the minimum searched length of a match for long distance matching\. +. .IP This option is ignored unless long distance matching is enabled\. +. .IP Larger/very small values usually decrease compression ratio\. +. .IP The minimum \fIlmml\fR is 4 and the maximum is 4096 (default: 64)\. +. .TP \fBldmBucketSizeLog\fR=\fIlblog\fR, \fBlblog\fR=\fIlblog\fR Specify the size of each bucket for the hash table used for long distance matching\. +. .IP This option is ignored unless long distance matching is enabled\. +. .IP Larger bucket sizes improve collision resolution but decrease compression speed\. +. .IP The minimum \fIlblog\fR is 1 and the maximum is 8 (default: 3)\. +. .TP \fBldmHashRateLog\fR=\fIlhrlog\fR, \fBlhrlog\fR=\fIlhrlog\fR Specify the frequency of inserting entries into the long distance matching hash table\. +. .IP This option is ignored unless long distance matching is enabled\. +. .IP Larger values will improve compression speed\. Deviating far from the default value will likely result in a decrease in compression ratio\. +. .IP The default value is \fBwlog \- lhlog\fR\. +. .SS "Example" The following parameters sets advanced compression options to something similar to predefined level 19 for files bigger than 256 KB: +. .P \fB\-\-zstd\fR=wlog=23,clog=23,hlog=22,slog=6,mml=3,tlen=48,strat=6 +. +.SS "\-B#:" +Specify the size of each compression job\. This parameter is only available when multi\-threading is enabled\. Each compression job is run in parallel, so this value indirectly impacts the nb of active threads\. Default job size varies depending on compression level (generally \fB4 * windowSize\fR)\. \fB\-B#\fR makes it possible to manually select a custom size\. Note that job size must respect a minimum value which is enforced transparently\. This minimum is either 512 KB, or \fBoverlapSize\fR, whichever is largest\. Different job sizes will lead to non\-identical compressed frames\. +. +.SH "DICTIONARY BUILDER" +\fBzstd\fR offers \fIdictionary\fR compression, which greatly improves efficiency on small files and messages\. It\'s possible to train \fBzstd\fR with a set of samples, the result of which is saved into a file called a \fBdictionary\fR\. Then, during compression and decompression, reference the same dictionary, using command \fB\-D dictionaryFileName\fR\. Compression of small files similar to the sample set will be greatly improved\. +. +.TP +\fB\-\-train FILEs\fR +Use FILEs as training set to create a dictionary\. The training set should ideally contain a lot of samples (> 100), and weight typically 100x the target dictionary size (for example, ~10 MB for a 100 KB dictionary)\. \fB\-\-train\fR can be combined with \fB\-r\fR to indicate a directory rather than listing all the files, which can be useful to circumvent shell expansion limits\. +. +.IP +Since dictionary compression is mostly effective for small files, the expectation is that the training set will only contain small files\. In the case where some samples happen to be large, only the first 128 KiB of these samples will be used for training\. +. +.IP +\fB\-\-train\fR supports multithreading if \fBzstd\fR is compiled with threading support (default)\. Additional advanced parameters can be specified with \fB\-\-train\-fastcover\fR\. The legacy dictionary builder can be accessed with \fB\-\-train\-legacy\fR\. The slower cover dictionary builder can be accessed with \fB\-\-train\-cover\fR\. Default \fB\-\-train\fR is equivalent to \fB\-\-train\-fastcover=d=8,steps=4\fR\. +. +.TP +\fB\-o FILE\fR +Dictionary saved into \fBFILE\fR (default name: dictionary)\. +. +.TP +\fB\-\-maxdict=#\fR +Limit dictionary to specified size (default: 112640 bytes)\. As usual, quantities are expressed in bytes by default, and it\'s possible to employ suffixes (like \fBKB\fR or \fBMB\fR) to specify larger values\. +. +.TP +\fB\-#\fR +Use \fB#\fR compression level during training (optional)\. Will generate statistics more tuned for selected compression level, resulting in a \fIsmall\fR compression ratio improvement for this level\. +. +.TP +\fB\-B#\fR +Split input files into blocks of size # (default: no split) +. +.TP +\fB\-M#\fR, \fB\-\-memory=#\fR +Limit the amount of sample data loaded for training (default: 2 GB)\. Note that the default (2 GB) is also the maximum\. This parameter can be useful in situations where the training set size is not well controlled and could be potentially very large\. Since speed of the training process is directly correlated to the size of the training sample set, a smaller sample set leads to faster training\. +. +.IP +In situations where the training set is larger than maximum memory, the CLI will randomly select samples among the available ones, up to the maximum allowed memory budget\. This is meant to improve dictionary relevance by mitigating the potential impact of clustering, such as selecting only files from the beginning of a list sorted by modification date, or sorted by alphabetical order\. The randomization process is deterministic, so training of the same list of files with the same parameters will lead to the creation of the same dictionary\. +. +.TP +\fB\-\-dictID=#\fR +A dictionary ID is a locally unique ID\. The decoder will use this value to verify it is using the right dictionary\. By default, zstd will create a 4\-bytes random number ID\. It\'s possible to provide an explicit number ID instead\. It\'s up to the dictionary manager to not assign twice the same ID to 2 different dictionaries\. Note that short numbers have an advantage: an ID < 256 will only need 1 byte in the compressed frame header, and an ID < 65536 will only need 2 bytes\. This compares favorably to 4 bytes default\. +. +.IP +Note that RFC8878 reserves IDs less than 32768 and greater than or equal to 2^31, so they should not be used in public\. +. +.TP +\fB\-\-train\-cover[=k#,d=#,steps=#,split=#,shrink[=#]]\fR +Select parameters for the default dictionary builder algorithm named cover\. If \fId\fR is not specified, then it tries \fId\fR = 6 and \fId\fR = 8\. If \fIk\fR is not specified, then it tries \fIsteps\fR values in the range [50, 2000]\. If \fIsteps\fR is not specified, then the default value of 40 is used\. If \fIsplit\fR is not specified or split <= 0, then the default value of 100 is used\. Requires that \fId\fR <= \fIk\fR\. If \fIshrink\fR flag is not used, then the default value for \fIshrinkDict\fR of 0 is used\. If \fIshrink\fR is not specified, then the default value for \fIshrinkDictMaxRegression\fR of 1 is used\. +. +.IP +Selects segments of size \fIk\fR with highest score to put in the dictionary\. The score of a segment is computed by the sum of the frequencies of all the subsegments of size \fId\fR\. Generally \fId\fR should be in the range [6, 8], occasionally up to 16, but the algorithm will run faster with d <= \fI8\fR\. Good values for \fIk\fR vary widely based on the input data, but a safe range is [2 * \fId\fR, 2000]\. If \fIsplit\fR is 100, all input samples are used for both training and testing to find optimal \fId\fR and \fIk\fR to build dictionary\. Supports multithreading if \fBzstd\fR is compiled with threading support\. Having \fIshrink\fR enabled takes a truncated dictionary of minimum size and doubles in size until compression ratio of the truncated dictionary is at most \fIshrinkDictMaxRegression%\fR worse than the compression ratio of the largest dictionary\. +. +.IP +Examples: +. +.IP +\fBzstd \-\-train\-cover FILEs\fR +. +.IP +\fBzstd \-\-train\-cover=k=50,d=8 FILEs\fR +. +.IP +\fBzstd \-\-train\-cover=d=8,steps=500 FILEs\fR +. +.IP +\fBzstd \-\-train\-cover=k=50 FILEs\fR +. +.IP +\fBzstd \-\-train\-cover=k=50,split=60 FILEs\fR +. +.IP +\fBzstd \-\-train\-cover=shrink FILEs\fR +. +.IP +\fBzstd \-\-train\-cover=shrink=2 FILEs\fR +. +.TP +\fB\-\-train\-fastcover[=k#,d=#,f=#,steps=#,split=#,accel=#]\fR +Same as cover but with extra parameters \fIf\fR and \fIaccel\fR and different default value of split If \fIsplit\fR is not specified, then it tries \fIsplit\fR = 75\. If \fIf\fR is not specified, then it tries \fIf\fR = 20\. Requires that 0 < \fIf\fR < 32\. If \fIaccel\fR is not specified, then it tries \fIaccel\fR = 1\. Requires that 0 < \fIaccel\fR <= 10\. Requires that \fId\fR = 6 or \fId\fR = 8\. +. +.IP +\fIf\fR is log of size of array that keeps track of frequency of subsegments of size \fId\fR\. The subsegment is hashed to an index in the range [0,2^\fIf\fR \- 1]\. It is possible that 2 different subsegments are hashed to the same index, and they are considered as the same subsegment when computing frequency\. Using a higher \fIf\fR reduces collision but takes longer\. +. +.IP +Examples: +. +.IP +\fBzstd \-\-train\-fastcover FILEs\fR +. +.IP +\fBzstd \-\-train\-fastcover=d=8,f=15,accel=2 FILEs\fR +. +.TP +\fB\-\-train\-legacy[=selectivity=#]\fR +Use legacy dictionary builder algorithm with the given dictionary \fIselectivity\fR (default: 9)\. The smaller the \fIselectivity\fR value, the denser the dictionary, improving its efficiency but reducing its achievable maximum size\. \fB\-\-train\-legacy=s=#\fR is also accepted\. +. +.IP +Examples: +. +.IP +\fBzstd \-\-train\-legacy FILEs\fR +. +.IP +\fBzstd \-\-train\-legacy=selectivity=8 FILEs\fR +. +.SH "BENCHMARK" +The \fBzstd\fR CLI provides a benchmarking mode that can be used to easily find suitable compression parameters, or alternatively to benchmark a computer\'s performance\. Note that the results are highly dependent on the content being compressed\. +. +.TP +\fB\-b#\fR +benchmark file(s) using compression level # +. +.TP +\fB\-e#\fR +benchmark file(s) using multiple compression levels, from \fB\-b#\fR to \fB\-e#\fR (inclusive) +. +.TP +\fB\-d\fR +benchmark decompression speed only (requires providing an already zstd\-compressed content) +. +.TP +\fB\-i#\fR +minimum evaluation time, in seconds (default: 3s), benchmark mode only +. +.TP +\fB\-B#\fR, \fB\-\-block\-size=#\fR +cut file(s) into independent chunks of size # (default: no chunking) +. +.TP +\fB\-\-priority=rt\fR +set process priority to real\-time (Windows) +. +.P +\fBOutput Format:\fR CompressionLevel#Filename: InputSize \-> OutputSize (CompressionRatio), CompressionSpeed, DecompressionSpeed +. +.P +\fBMethodology:\fR For both compression and decompression speed, the entire input is compressed/decompressed in\-memory to measure speed\. A run lasts at least 1 sec, so when files are small, they are compressed/decompressed several times per run, in order to improve measurement accuracy\. +. .SH "SEE ALSO" \fBzstdgrep\fR(1), \fBzstdless\fR(1), \fBgzip\fR(1), \fBxz\fR(1) +. .P The \fIzstandard\fR format is specified in Y\. Collet, "Zstandard Compression and the \'application/zstd\' Media Type", https://www\.ietf\.org/rfc/rfc8878\.txt, Internet RFC 8878 (February 2021)\. +. .SH "BUGS" Report bugs at: https://github\.com/facebook/zstd/issues +. .SH "AUTHOR" Yann Collet diff --git a/upstream/fedora-rawhide/man1/ranlib.1 b/upstream/fedora-rawhide/man1/ranlib.1 index 8685a8dc..b7d20c00 100644 --- a/upstream/fedora-rawhide/man1/ranlib.1 +++ b/upstream/fedora-rawhide/man1/ranlib.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "RANLIB 1" -.TH RANLIB 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH RANLIB 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/readelf.1 b/upstream/fedora-rawhide/man1/readelf.1 index 050fc2ba..cc59ed65 100644 --- a/upstream/fedora-rawhide/man1/readelf.1 +++ b/upstream/fedora-rawhide/man1/readelf.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "READELF 1" -.TH READELF 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH READELF 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -90,6 +90,7 @@ readelf [\fB\-a\fR|\fB\-\-all\fR] [\fB\-x\fR <number or name>|\fB\-\-hex\-dump=\fR<number or name>] [\fB\-p\fR <number or name>|\fB\-\-string\-dump=\fR<number or name>] [\fB\-R\fR <number or name>|\fB\-\-relocated\-dump=\fR<number or name>] + [\fB\-j\fR <number or name>|\fB\-\-display\-section=\fR<number or name>] [\fB\-z\fR|\fB\-\-decompress\fR] [\fB\-c\fR|\fB\-\-archive\-index\fR] [\fB\-w[lLiaprmfFsoORtUuTgAck]\fR| @@ -393,6 +394,8 @@ displayed. Displays the contents of the indicated section as a hexadecimal bytes. A number identifies a particular section by index in the section table; any other string identifies all sections with that name in the object file. +This option can be repeated multiple times on the command line in +order to request multiple hex dumps. .IP "\fB\-R <number or name>\fR" 4 .IX Item "-R <number or name>" .PD 0 @@ -404,6 +407,8 @@ bytes. A number identifies a particular section by index in the section table; any other string identifies all sections with that name in the object file. The contents of the section will be relocated before they are displayed. +This option can be repeated multiple times on the command line in +order to request multiple relocated dumps. .IP "\fB\-p <number or name>\fR" 4 .IX Item "-p <number or name>" .PD 0 @@ -413,6 +418,26 @@ before they are displayed. Displays the contents of the indicated section as printable strings. A number identifies a particular section by index in the section table; any other string identifies all sections with that name in the object file. +This option can be repeated multiple times on the command line in +order to request multiple string dumps. +.IP "\fB\-j <number or name>\fR" 4 +.IX Item "-j <number or name>" +.PD 0 +.IP \fB\-\-display\-section\fR 4 +.IX Item "--display-section" +.PD +Displays the contents of the indicated section according to its +section header type. Sections containing relocations will be +displayed as if the \fB\-\-relocations\fR option had been used, +sections contains symbols will be displayed as if the \fB\-\-syms\fR +option had been used and so on. +.Sp +A number identifies a particular section by index in the section +table; any other string identifies all sections with that name in the +input file(s). +.Sp +This option can be repeated multiple times on the command line in +order to request multiple section dumps. .IP \fB\-z\fR 4 .IX Item "-z" .PD 0 @@ -761,6 +786,15 @@ function at link time. When looking at CTF archives that have been created by a linker that uses the name changer to rename the parent archive member, \fB\-\-ctf\-parent\fR can be used to specify the name used for the parent. +.IP \fB\-\-ctf\-parent\-section=\fR\fIsection\fR 4 +.IX Item "--ctf-parent-section=section" +This option lets you pick a completely different section for the CTF +parent dictionary containing unambiguous types than for the child +dictionaries that contain the ambiguous remainder. The linker does +not emit ELF objects structured like this, but some third-party linkers +may. It's also convenient to inspect CTF written out as multiple raw +files to compose them with objcopy, which can put them in different +ELF sections but not in different members of a single CTF dict. .IP \fB\-\-ctf\-symbols=\fR\fIsection\fR 4 .IX Item "--ctf-symbols=section" .PD 0 diff --git a/upstream/fedora-rawhide/man1/readlink.1 b/upstream/fedora-rawhide/man1/readlink.1 index 30a4d61d..a029c06e 100644 --- a/upstream/fedora-rawhide/man1/readlink.1 +++ b/upstream/fedora-rawhide/man1/readlink.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH READLINK "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH READLINK "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME readlink \- print resolved symbolic links or canonical file names .SH SYNOPSIS @@ -7,7 +7,7 @@ readlink \- print resolved symbolic links or canonical file names [\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... .SH DESCRIPTION .\" Add any additional description here -Note \fBrealpath\fP(1) is the preferred command to use +\fBrealpath\fP(1) is a better command for canonicalization functionality. .PP Print value of a symbolic link or canonical file name @@ -53,7 +53,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/realpath.1 b/upstream/fedora-rawhide/man1/realpath.1 index 61589eba..e8c594bc 100644 --- a/upstream/fedora-rawhide/man1/realpath.1 +++ b/upstream/fedora-rawhide/man1/realpath.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH REALPATH "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH REALPATH "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME realpath \- print the resolved path .SH SYNOPSIS @@ -50,7 +50,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/recode-sr-latin.1 b/upstream/fedora-rawhide/man1/recode-sr-latin.1 index f2a9bf26..560dbe8e 100644 --- a/upstream/fedora-rawhide/man1/recode-sr-latin.1 +++ b/upstream/fedora-rawhide/man1/recode-sr-latin.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH RECODE-SR-LATIN "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH RECODE-SR-LATIN "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME recode-sr-latin \- convert Serbian text from Cyrillic to Latin script .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/repo-graph.1 b/upstream/fedora-rawhide/man1/repo-graph.1 index 7c93fc76..ad7557c7 100644 --- a/upstream/fedora-rawhide/man1/repo-graph.1 +++ b/upstream/fedora-rawhide/man1/repo-graph.1 @@ -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 "REPO-GRAPH" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "REPO-GRAPH" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME repo-graph \- redirecting to DNF repograph Plugin .sp diff --git a/upstream/fedora-rawhide/man1/repoclosure.1 b/upstream/fedora-rawhide/man1/repoclosure.1 index af92c3c1..9c522ef8 100644 --- a/upstream/fedora-rawhide/man1/repoclosure.1 +++ b/upstream/fedora-rawhide/man1/repoclosure.1 @@ -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 "REPOCLOSURE" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "REPOCLOSURE" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME repoclosure \- redirecting to DNF repoclosure Plugin .sp diff --git a/upstream/fedora-rawhide/man1/repodiff.1 b/upstream/fedora-rawhide/man1/repodiff.1 index 8f99bc88..cdd12a51 100644 --- a/upstream/fedora-rawhide/man1/repodiff.1 +++ b/upstream/fedora-rawhide/man1/repodiff.1 @@ -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 "REPODIFF" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "REPODIFF" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME repodiff \- redirecting to DNF repodiff Plugin .sp diff --git a/upstream/fedora-rawhide/man1/repomanage.1 b/upstream/fedora-rawhide/man1/repomanage.1 index 3d3a04c5..0f398498 100644 --- a/upstream/fedora-rawhide/man1/repomanage.1 +++ b/upstream/fedora-rawhide/man1/repomanage.1 @@ -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 "REPOMANAGE" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "REPOMANAGE" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME repomanage \- redirecting to DNF repomanage Plugin .sp diff --git a/upstream/fedora-rawhide/man1/reposync.1 b/upstream/fedora-rawhide/man1/reposync.1 index 51edc0b5..b1f87475 100644 --- a/upstream/fedora-rawhide/man1/reposync.1 +++ b/upstream/fedora-rawhide/man1/reposync.1 @@ -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 "REPOSYNC" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "REPOSYNC" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME reposync \- redirecting to DNF reposync Plugin .sp diff --git a/upstream/fedora-rawhide/man1/resolvectl.1 b/upstream/fedora-rawhide/man1/resolvectl.1 index 1a735d74..e67714a4 100644 --- a/upstream/fedora-rawhide/man1/resolvectl.1 +++ b/upstream/fedora-rawhide/man1/resolvectl.1 @@ -1,5 +1,5 @@ '\" t -.TH "RESOLVECTL" "1" "" "systemd 255" "resolvectl" +.TH "RESOLVECTL" "1" "" "systemd 256~rc3" "resolvectl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -55,6 +55,11 @@ If an international domain name is specified, it is automatically translated acc \fB\-\-type=\fR/\fB\-\-class=\fR is used IDNA translation is turned off and domain names are processed as specified\&. .sp +If combined with +\fB\-\-json=\fR +(only supported in combination with +\fB\-\-type=\fR) will output the resource record data in a JSON object\&. +.sp Added in version 239\&. .RE .PP @@ -266,7 +271,7 @@ only IPv6 addresses are requested\&. Added in version 239\&. .RE .PP -\fB\-i\fR \fIINTERFACE\fR, \fB\-\-interface=\fR\fIINTERFACE\fR +\fB\-i\fR \fIINTERFACE\fR, \fB\-\-interface=\fR\fB\fIINTERFACE\fR\fR .RS 4 Specifies the network interface to execute the query on\&. This may either be specified as numeric interface index or as network interface string (e\&.g\&. "en0")\&. Note that this option has no effect if system\-wide DNS configuration (as configured in @@ -277,7 +282,7 @@ or Added in version 239\&. .RE .PP -\fB\-p\fR \fIPROTOCOL\fR, \fB\-\-protocol=\fR\fIPROTOCOL\fR +\fB\-p\fR \fIPROTOCOL\fR, \fB\-\-protocol=\fR\fB\fIPROTOCOL\fR\fR .RS 4 Specifies the network protocol for the query\&. May be one of "dns" @@ -303,7 +308,7 @@ may be used to list known values\&. Added in version 239\&. .RE .PP -\fB\-t\fR \fITYPE\fR, \fB\-\-type=\fR\fITYPE\fR, \fB\-c\fR \fICLASS\fR, \fB\-\-class=\fR\fICLASS\fR +\fB\-t\fR \fITYPE\fR, \fB\-\-type=\fR\fB\fITYPE\fR\fR, \fB\-c\fR \fICLASS\fR, \fB\-\-class=\fR\fB\fICLASS\fR\fR .RS 4 When used in conjunction with the \fBquery\fR @@ -327,7 +332,7 @@ notation, unless look\-up in MulticastDNS/LLMNR is desired, in which case UTF\-8 Added in version 239\&. .RE .PP -\fB\-\-service\-address=\fR\fIBOOL\fR +\fB\-\-service\-address=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean parameter\&. If true (the default), when doing a service lookup with \fB\-\-service\fR @@ -338,7 +343,7 @@ resource records are resolved as well\&. Added in version 239\&. .RE .PP -\fB\-\-service\-txt=\fR\fIBOOL\fR +\fB\-\-service\-txt=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean parameter\&. If true (the default), when doing a DNS\-SD service lookup with \fB\-\-service\fR @@ -349,7 +354,7 @@ service metadata record is resolved as well\&. Added in version 239\&. .RE .PP -\fB\-\-cname=\fR\fIBOOL\fR +\fB\-\-cname=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean parameter\&. If true (the default), DNS \fBCNAME\fR @@ -360,7 +365,7 @@ redirections are followed\&. Otherwise, if a CNAME or DNAME record is encountere Added in version 239\&. .RE .PP -\fB\-\-validate=\fR\fIBOOL\fR +\fB\-\-validate=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean parameter; used in conjunction with \fBquery\fR\&. If true (the default), DNSSEC validation is applied as usual \(em under the condition that it is enabled for the network and for @@ -370,7 +375,7 @@ as a whole\&. If false, DNSSEC validation is disabled for the specific query, re Added in version 248\&. .RE .PP -\fB\-\-synthesize=\fR\fIBOOL\fR +\fB\-\-synthesize=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean parameter; used in conjunction with \fBquery\fR\&. If true (the default), select domains are resolved on the local system, among them @@ -393,7 +398,7 @@ entries)\&. Added in version 248\&. .RE .PP -\fB\-\-cache=\fR\fIBOOL\fR +\fB\-\-cache=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean parameter; used in conjunction with \fBquery\fR\&. If true (the default), lookups use the local DNS resource record cache\&. If false, lookups are routed to the network instead, regardless if already available in the local cache\&. @@ -401,7 +406,7 @@ Takes a boolean parameter; used in conjunction with Added in version 248\&. .RE .PP -\fB\-\-zone=\fR\fIBOOL\fR +\fB\-\-zone=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean parameter; used in conjunction with \fBquery\fR\&. If true (the default), lookups are answered from locally registered LLMNR or mDNS resource records, if defined\&. If false, locally registered LLMNR/mDNS records are not considered for the lookup request\&. @@ -409,7 +414,7 @@ Takes a boolean parameter; used in conjunction with Added in version 248\&. .RE .PP -\fB\-\-trust\-anchor=\fR\fIBOOL\fR +\fB\-\-trust\-anchor=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean parameter; used in conjunction with \fBquery\fR\&. If true (the default), lookups for DS and DNSKEY are answered from the local DNSSEC trust anchors if possible\&. If false, the local trust store is not considered for the lookup request\&. @@ -417,7 +422,7 @@ Takes a boolean parameter; used in conjunction with Added in version 248\&. .RE .PP -\fB\-\-network=\fR\fIBOOL\fR +\fB\-\-network=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean parameter; used in conjunction with \fBquery\fR\&. If true (the default), lookups are answered via DNS, LLMNR or mDNS network requests if they cannot be synthesized locally, or be answered from the local cache, zone or trust anchors (see above)\&. If false, the request is not answered from the network and will thus fail if none of the indicated sources can answer them\&. @@ -425,7 +430,7 @@ Takes a boolean parameter; used in conjunction with Added in version 248\&. .RE .PP -\fB\-\-search=\fR\fIBOOL\fR +\fB\-\-search=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean parameter\&. If true (the default), any specified single\-label hostnames will be searched in the domains configured in the search domain list, if it is non\-empty\&. Otherwise, the search domain logic is disabled\&. Note that this option has no effect if \fB\-\-type=\fR @@ -443,14 +448,14 @@ Dump the answer as binary data\&. If there is no argument or if the argument is Added in version 239\&. .RE .PP -\fB\-\-legend=\fR\fIBOOL\fR +\fB\-\-legend=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean parameter\&. If true (the default), column headers and meta information about the query response are shown\&. Otherwise, this output is suppressed\&. .sp Added in version 239\&. .RE .PP -\fB\-\-stale\-data=\fR\fIBOOL\fR +\fB\-\-stale\-data=\fR\fB\fIBOOL\fR\fR .RS 4 Takes a boolean parameter; used in conjunction with \fBquery\fR\&. If true (the default), lookups are answered with stale data (expired resource records) if possible\&. If false, the stale data is not considered for the lookup request\&. @@ -458,7 +463,19 @@ Takes a boolean parameter; used in conjunction with Added in version 254\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-relax\-single\-label=\fR\fB\fIBOOL\fR\fR +.RS 4 +Takes a boolean parameter; used in conjunction with +\fBquery\fR\&. If true, rules regarding routing of single\-label names are relaxed\&. Defaults to false\&. By default, lookups of single label names are assumed to refer to local hosts to be resolved via local resolution such as LLMNR or via search domain qualification and are not routed to upstream servers as is\&. If this option is enabled these rules are disabled and the queries are routed upstream anyway\&. Also see the +\fIResolveUnicastSingleLabel=\fR +option in +\fBresolved.conf\fR(5) +which provides a system\-wide option that controls this behaviour\&. +.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" @@ -471,10 +488,11 @@ Shows output formatted as JSON\&. Expects one of .PP \fB\-j\fR .RS 4 -Short for -\fB\-\-json=auto\fR -.sp -Added in version 252\&. +Equivalent to +\fB\-\-json=pretty\fR +if running on a terminal, and +\fB\-\-json=short\fR +otherwise\&. .RE .PP \fB\-\-no\-pager\fR @@ -689,11 +707,7 @@ and are optional and could be skipped\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-resolved.service\fR(8), -\fBsystemd.dnssd\fR(5), -\fBsystemd-networkd.service\fR(8), -\fBresolvconf\fR(8) +\fBsystemd\fR(1), \fBsystemd-resolved.service\fR(8), \fBsystemd.dnssd\fR(5), \fBsystemd-networkd.service\fR(8), \fBresolvconf\fR(8) .SH "NOTES" .IP " 1." 4 RFC 6763 DNS-SD diff --git a/upstream/fedora-rawhide/man1/rm.1 b/upstream/fedora-rawhide/man1/rm.1 index d2ea1c77..b0e4913a 100644 --- a/upstream/fedora-rawhide/man1/rm.1 +++ b/upstream/fedora-rawhide/man1/rm.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH RM "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH RM "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME rm \- remove files or directories .SH SYNOPSIS @@ -76,6 +76,9 @@ output version information and exit By default, rm does not remove directories. Use the \fB\-\-recursive\fR (\fB\-r\fR or \fB\-R\fR) option to remove each listed directory, too, along with all of its contents. .PP +Any attempt to remove a file whose last file name component is '.' or '..' +is rejected with a diagnostic. +.PP To remove a file whose name starts with a '\-', for example '\-foo', use one of these commands: .IP @@ -83,9 +86,9 @@ rm \fB\-\-\fR \fB\-foo\fR .IP rm ./\-foo .PP -Note that if you use rm to remove a file, it might be possible to recover +If you use rm to remove a file, it might be possible to recover some of its contents, given sufficient expertise and/or time. For greater -assurance that the contents are truly unrecoverable, consider using \fBshred\fP(1). +assurance that the contents are unrecoverable, consider using \fBshred\fP(1). .SH AUTHOR Written by Paul Rubin, David MacKenzie, Richard M. Stallman, and Jim Meyering. @@ -94,7 +97,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/rmdir.1 b/upstream/fedora-rawhide/man1/rmdir.1 index a70528a7..0d0789cc 100644 --- a/upstream/fedora-rawhide/man1/rmdir.1 +++ b/upstream/fedora-rawhide/man1/rmdir.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH RMDIR "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH RMDIR "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME rmdir \- remove empty directories .SH SYNOPSIS @@ -32,7 +32,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/rnano.1 b/upstream/fedora-rawhide/man1/rnano.1 index 27762bc6..69c188b0 100644 --- a/upstream/fedora-rawhide/man1/rnano.1 +++ b/upstream/fedora-rawhide/man1/rnano.1 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2002-2007, 2014-2023 Free Software Foundation, Inc. +.\" Copyright (C) 2002-2007, 2014-2024 Free Software Foundation, Inc. .\" .\" This document is dual-licensed. You may distribute and/or modify it .\" under the terms of either of the following licenses: @@ -16,7 +16,7 @@ .\" Documentation License along with this program. If not, see .\" <https://www.gnu.org/licenses/>. .\" -.TH RNANO 1 "version 7.2" "January 2023" +.TH RNANO 1 "version 8.0" "May 2024" .SH NAME rnano \- a restricted nano @@ -32,15 +32,19 @@ access to the filesystem nor to a command shell. .sp In restricted mode, \fBnano\fR will: .IP \[bu] 2 +not make backups; +.IP \[bu] not allow suspending; .IP \[bu] +not allow spell checking; +.IP \[bu] +not read nor write the history files; +.IP \[bu] not allow saving the current buffer under a different name; .IP \[bu] not allow inserting another file or opening a new buffer; .IP \[bu] -not allow appending or prepending to any file; -.IP \[bu] -not make backup files nor do spell checking. +not allow appending or prepending to any file. .SH OPTIONS .TP diff --git a/upstream/fedora-rawhide/man1/rsync-ssl.1 b/upstream/fedora-rawhide/man1/rsync-ssl.1 index c7f5ad1b..1f12489f 100644 --- a/upstream/fedora-rawhide/man1/rsync-ssl.1 +++ b/upstream/fedora-rawhide/man1/rsync-ssl.1 @@ -1,4 +1,4 @@ -.TH "rsync-ssl" "1" "20 Oct 2022" "rsync-ssl from rsync 3.2.7" "User Commands" +.TH "rsync-ssl" "1" "6 Apr 2024" "rsync-ssl from rsync 3.3.0" "User Commands" .\" prefix=/usr .P .SH "NAME" @@ -12,7 +12,9 @@ rsync-ssl [--type=SSL_TYPE] RSYNC_ARGS .fi .P The online version of this manpage (that includes cross-linking of topics) -is available at https://download.samba.org/pub/rsync/rsync-ssl.1. +is available at +.UR https://download.samba.org/pub/rsync/rsync-ssl.1 +.UE . .P .SH "DESCRIPTION" .P @@ -122,18 +124,23 @@ exported RSYNC_SSL_TYPE environment variable to make its use the default. .P .SH "BUGS" .P -Please report bugs! See the web site at https://rsync.samba.org/. +Please report bugs! See the web site at +.UR https://rsync.samba.org/ +.UE . .P .SH "VERSION" .P -This manpage is current for version 3.2.7 of rsync. +This manpage is current for version 3.3.0 of rsync. .P .SH "CREDITS" .P Rsync is distributed under the GNU General Public License. See the file COPYING for details. .P -A web site is available at https://rsync.samba.org/. The site includes an +A web site is available at +.UR https://rsync.samba.org/ +.UE . +The site includes an FAQ-O-Matic which may cover questions unanswered by this manual page. .P .SH "AUTHOR" @@ -141,4 +148,5 @@ FAQ-O-Matic which may cover questions unanswered by this manual page. This manpage was written by Wayne Davison. .P Mailing lists for support and development are available at -https://lists.samba.org/. +.UR https://lists.samba.org/ +.UE . diff --git a/upstream/fedora-rawhide/man1/rsync.1 b/upstream/fedora-rawhide/man1/rsync.1 index 66a2da39..63277c0e 100644 --- a/upstream/fedora-rawhide/man1/rsync.1 +++ b/upstream/fedora-rawhide/man1/rsync.1 @@ -1,4 +1,4 @@ -.TH "rsync" "1" "20 Oct 2022" "rsync 3.2.7" "User Commands" +.TH "rsync" "1" "6 Apr 2024" "rsync 3.3.0" "User Commands" .\" prefix=/usr .P .SH "NAME" @@ -30,7 +30,9 @@ Usages with just one SRC arg and no DEST arg will list the source files instead of copying. .P The online version of this manpage (that includes cross-linking of topics) -is available at https://download.samba.org/pub/rsync/rsync.1. +is available at +.UR https://download.samba.org/pub/rsync/rsync.1 +.UE . .P .SH "DESCRIPTION" .P @@ -306,7 +308,7 @@ to be copied to different destination directories using more than one copy. .P While a copy of a case-ignoring filesystem to a case-ignoring filesystem can work out fairly well, if no \fB\-\-delete-during\fP or \fB\-\-delete-before\fP option is -active, rsync can potentially update an existing file on the receiveing side +active, rsync can potentially update an existing file on the receiving side without noticing that the upper-/lower-case of the filename should be changed to match the sender. .P @@ -604,6 +606,9 @@ has its own detailed description later in this manpage. --modify-window=NUM, -@ set the accuracy for mod-time comparisons --temp-dir=DIR, -T create temporary files in directory DIR --fuzzy, -y find similar file for basis if no dest file +--detect-renamed try to find renamed files to speed the xfer +--detect-renamed-lax ...& assume identical to src files (risky!) +--detect-moved ... only if basenames match (less risky) --compare-dest=DIR also compare destination files relative to DIR --copy-dest=DIR ... and include copies of unchanged files --link-dest=DIR hardlink to files in DIR when unchanged @@ -1728,7 +1733,9 @@ mounted to avoid updating the atime on read access even without the O_NOATIME flag being set. .IP "\fB\-\-crtimes\fP, \fB\-N,\fP" This tells rsync to set the create times (newness) of the destination -files to the same value as the source files. +files to the same value as the source files. Your OS & filesystem must +support the setting of arbitrary creation (birth) times for this option +to be supported. .IP "\fB\-\-omit-dir-times\fP, \fB\-O\fP" This tells rsync to omit directories when it is preserving modification, access, and create times. If NFS is sharing the directories on the receiving @@ -2153,7 +2160,8 @@ memory. It is a sanity-check value for each individual allocation. See the \fB\-\-max-size\fP option for a description of how SIZE can be specified. The default suffix if none is given is bytes. .IP -Beginning in 3.2.3, a value of 0 specifies no limit. +Beginning in 3.2.7, a value of 0 is an easy way to specify SIZE_MAX (the +largest limit possible). .IP You can set a default value using the environment variable \fBRSYNC_MAX_ALLOC\fP using the same SIZE values as supported by this @@ -2698,6 +2706,30 @@ alternate destination directories that are specified via Note that the use of the \fB\-\-delete\fP option might get rid of any potential fuzzy-match files, so either use \fB\-\-delete-after\fP or specify some filename exclusions if you need to prevent this. +.IP "\fB\-\-detect-renamed\fP" +With this option, for each new source file (call it \fBsrc/S\fP), rsync looks +for a file \fBdest/D\fP anywhere in the destination that passes the quick check +with \fBsrc/S\fP. If such a \fBdest/D\fP is found, rsync uses it as an alternate +basis for transferring \fBS\fP. The idea is that if \fBsrc/S\fP was renamed from +\fBsrc/D\fP (as opposed to \fBsrc/S\fP passing the quick check with \fBdest/D\fP by +coincidence), the delta-transfer algorithm will find that all the data +matches between \fBsrc/S\fP and \fBdest/D\fP, and the transfer will be really fast. +.IP +By default, alternate-basis files are hard-linked into a directory named +".~tmp~" in each file's destination directory, but if you've specified the +\fB\-\-partial-dir\fP option, that directory will be used instead. These +otential alternate-basis files will be removed as the transfer progresses. +This option conflicts with \fB\-\-inplace\fP and \fB\-\-append\fP. +.IP "\fB\-\-detect-renamed-lax\fP" +This version of \fB\-\-detect-renamed\fP makes rsync hard-link \fBdest/D\fP +to \fBdest/S\fP without verifying that \fBsrc/S\fP and \fBdest/S\fP have the same data. +This poses a significant risk of corrupting the destination by representing +a new source file by an unrelated destination file that coincidentally +passes the quick check with the source file. Use this option only if you +accept the risk and disk I/O is a bottleneck. +.IP "\fB\-\-detect-moved\fP" +A less risky variant of \fB\-\-detect-renamed-lax\fP that only uses a +destination file that has the same basename as the new source file. .IP "\fB\-\-compare-dest=DIR\fP" This option instructs rsync to use \fIDIR\fP on the destination machine as an additional hierarchy to compare destination files against doing transfers @@ -5000,11 +5032,13 @@ File permissions, devices, etc. are transferred as native numerical values. .IP o See also the comments on the \fB\-\-delete\fP option. .P -Please report bugs! See the web site at https://rsync.samba.org/. +Please report bugs! See the web site at +.UR https://rsync.samba.org/ +.UE . .P .SH "VERSION" .P -This manpage is current for version 3.2.7 of rsync. +This manpage is current for version 3.3.0 of rsync. .P .SH "INTERNAL OPTIONS" .P @@ -5020,14 +5054,22 @@ that can be used with a restricted ssh login. Rsync is distributed under the GNU General Public License. See the file COPYING for details. .P -An rsync web site is available at https://rsync.samba.org/. The site +An rsync web site is available at +.UR https://rsync.samba.org/ +.UE . +The site includes an FAQ-O-Matic which may cover questions unanswered by this manual page. .P -The rsync github project is https://github.com/WayneD/rsync. +The rsync github project is +.UR https://github.com/WayneD/rsync +.UE . .P We would be delighted to hear from you if you like this program. Please -contact the mailing-list at rsync@lists.samba.org. +contact the mailing-list at +.UR mailto:rsync@lists.samba.org +rsync@lists.samba.org +.UE . .P This program uses the excellent zlib compression library written by Jean-loup Gailly and Mark Adler. @@ -5048,4 +5090,5 @@ people have later contributed to it. It is currently maintained by Wayne Davison. .P Mailing lists for support and development are available at -https://lists.samba.org/. +.UR https://lists.samba.org/ +.UE . diff --git a/upstream/fedora-rawhide/man1/run0.1 b/upstream/fedora-rawhide/man1/run0.1 new file mode 100644 index 00000000..637eef76 --- /dev/null +++ b/upstream/fedora-rawhide/man1/run0.1 @@ -0,0 +1,306 @@ +'\" t +.TH "RUN0" "1" "" "systemd 256~rc3" "run0" +.\" ----------------------------------------------------------------- +.\" * 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" +run0 \- Elevate privileges +.SH "SYNOPSIS" +.HP \w'\fBrun0\fR\ 'u +\fBrun0\fR [OPTIONS...] [COMMAND...] +.SH "DESCRIPTION" +.PP +\fBrun0\fR +may be used to temporarily and interactively acquire elevated or different privileges\&. It serves a similar purpose as +\fBsudo\fR(8), but operates differently in a couple of key areas: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +No execution or security context credentials are inherited from the caller into the invoked commands, as they are invoked from a fresh, isolated service forked off by the service manager\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Authentication takes place via +\m[blue]\fBpolkit\fR\m[]\&\s-2\u[1]\d\s+2, thus isolating the authentication prompt from the terminal (if possible)\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +An independent pseudo\-tty is allocated for the invoked command, detaching its lifecycle and isolating it for security\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +No SetUID/SetGID file access bit functionality is used for the implementation\&. +.RE +.PP +Altogether this should provide a safer and more robust alternative to the +\fBsudo\fR +mechanism, in particular in OS environments where SetUID/SetGID support is not available (for example by setting the +\fINoNewPrivileges=\fR +variable in +\fBsystemd-system.conf\fR(5))\&. +.PP +Any session invoked via +\fBrun0\fR +will run through the +"systemd\-run0" +PAM stack\&. +.PP +Note that +\fBrun0\fR +is implemented as an alternative multi\-call invocation of +\fBsystemd-run\fR(1)\&. +.SH "OPTIONS" +.PP +The following options are understood: +.PP +\fB\-\-no\-ask\-password\fR +.RS 4 +Do not query the user for authentication for privileged operations\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-unit=\fR +.RS 4 +Use this unit name instead of an automatically generated one\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-property=\fR +.RS 4 +Sets a property on the service unit that is created\&. This option takes an assignment in the same format as +\fBsystemctl\fR(1)\*(Aqs +\fBset\-property\fR +command\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-description=\fR +.RS 4 +Provide a description for the service unit that is invoked\&. If not specified, the command itself will be used as a description\&. See +\fIDescription=\fR +in +\fBsystemd.unit\fR(5)\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-slice=\fR +.RS 4 +Make the new +\&.service +unit part of the specified slice, instead of +user\&.slice\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-slice\-inherit\fR +.RS 4 +Make the new +\&.service +unit part of the slice the +\fBrun0\fR +itself has been invoked in\&. This option may be combined with +\fB\-\-slice=\fR, in which case the slice specified via +\fB\-\-slice=\fR +is placed within the slice the +\fBrun0\fR +command is invoked in\&. +.sp +Example: consider +\fBrun0\fR +being invoked in the slice +foo\&.slice, and the +\fB\-\-slice=\fR +argument is +bar\&. The unit will then be placed under +foo\-bar\&.slice\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-user=\fR, \fB\-u\fR, \fB\-\-group=\fR, \fB\-g\fR +.RS 4 +Switches to the specified user/group instead of root\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-nice=\fR +.RS 4 +Runs the invoked session with the specified nice level\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-chdir=\fR, \fB\-D\fR +.RS 4 +Runs the invoked session with the specified working directory\&. If not specified defaults to the client\*(Aqs current working directory if switching to the root user, or the target user\*(Aqs home directory otherwise\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-setenv=\fR\fB\fINAME\fR\fR\fB[=\fR\fB\fIVALUE\fR\fR\fB]\fR +.RS 4 +Runs the invoked session with the specified environment variable set\&. This parameter may be used more than once to set multiple variables\&. When +"=" +and +\fIVALUE\fR +are omitted, the value of the variable with the same name in the invoking environment will be used\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-background=\fR\fB\fICOLOR\fR\fR +.RS 4 +Change the terminal background color to the specified ANSI color as long as the session lasts\&. If not specified, the background will be tinted in a reddish tone when operating as root, and in a yellowish tone when operating under another UID, as reminder of the changed privileges\&. The color specified should be an ANSI X3\&.64 SGR background color, i\&.e\&. strings such as +"40", +"41", \&..., +"47", +"48;2;\&...", +"48;5;\&..."\&. See +\m[blue]\fBANSI Escape Code (Wikipedia)\fR\m[]\&\s-2\u[2]\d\s+2 +for details\&. Set to an empty string to disable\&. +.sp +Example: +"\-\-background=44" +for a blue background\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-M\fR, \fB\-\-machine=\fR +.RS 4 +Execute operation on a local container\&. Specify a container name to connect to, optionally prefixed by a user name to connect as and a separating +"@" +character\&. If the special string +"\&.host" +is used in place of the container name, a connection to the local system is made\&. If the +"@" +syntax is not used, the connection is made as root user\&. If the +"@" +syntax is used either the left hand side or the right hand side may be omitted (but not both) in which case the local user name and +"\&.host" +are implied\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-h\fR, \fB\-\-help\fR +.RS 4 +Print a short help text and exit\&. +.RE +.PP +\fB\-\-version\fR +.RS 4 +Print a short version string and exit\&. +.RE +.PP +All command line arguments after the first non\-option argument become part of the command line of the launched process\&. If no command line is specified an interactive shell is invoked\&. The shell to invoke may be controlled via +\fB\-\-setenv=SHELL=\&...\fR +and currently defaults to the +\fIoriginating user\*(Aqs\fR +shell (i\&.e\&. not the target user\*(Aqs!) if operating locally, or +/bin/sh +when operating with +\fB\-\-machine=\fR\&. +.SH "EXIT STATUS" +.PP +On success, 0 is returned\&. If +\fBrun0\fR +failed to start the session or the specified command fails, a non\-zero return value will be returned\&. +.SH "ENVIRONMENT VARIABLES" +.PP +As with +\fBsystemd\-run\fR, the session will inherit the system environment from the service manager\&. In addition, the following environment variables will be set: +.PP +\fI$TERM\fR +.RS 4 +Copied from the +\fI$TERM\fR +of the caller\&. Can be overridden with +\fB\-\-setenv=\fR +.sp +Added in version 256\&. +.RE +.PP +\fI$SUDO_USER\fR +.RS 4 +Set to the username of the originating user\&. +.sp +Added in version 256\&. +.RE +.PP +\fI$SUDO_UID\fR +.RS 4 +Set to the numeric UNIX user id of the originating user\&. +.sp +Added in version 256\&. +.RE +.PP +\fI$SUDO_GID\fR +.RS 4 +Set to the primary numeric UNIX group id of the originating session\&. +.sp +Added in version 256\&. +.RE +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), \fBsystemd-run\fR(1), \fBsudo\fR(8), \fBmachinectl\fR(1) +.SH "NOTES" +.IP " 1." 4 +polkit +.RS 4 +\%https://www.freedesktop.org/wiki/Software/polkit +.RE +.IP " 2." 4 +ANSI Escape Code (Wikipedia) +.RS 4 +\%https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_(Select_Graphic_Rendition)_parameters +.RE diff --git a/upstream/fedora-rawhide/man1/runcon.1 b/upstream/fedora-rawhide/man1/runcon.1 index 68d38135..912170f9 100644 --- a/upstream/fedora-rawhide/man1/runcon.1 +++ b/upstream/fedora-rawhide/man1/runcon.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH RUNCON "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH RUNCON "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME runcon \- run command with specified security context .SH SYNOPSIS @@ -18,8 +18,7 @@ the first argument is used as the complete context. Any additional arguments after \fICOMMAND\fR are interpreted as arguments to the command. .PP -Note that only carefully-chosen contexts are likely to successfully -run. +Only carefully-chosen contexts are likely to run successfully. .PP Run a program in a different SELinux security context. With neither CONTEXT nor COMMAND, print the current security context. @@ -69,7 +68,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/seq.1 b/upstream/fedora-rawhide/man1/seq.1 index 2e94c5d0..e85e1091 100644 --- a/upstream/fedora-rawhide/man1/seq.1 +++ b/upstream/fedora-rawhide/man1/seq.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SEQ "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SEQ "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME seq \- print a sequence of numbers .SH SYNOPSIS @@ -51,7 +51,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/sha1sum.1 b/upstream/fedora-rawhide/man1/sha1sum.1 index 133a3d43..d639d0c0 100644 --- a/upstream/fedora-rawhide/man1/sha1sum.1 +++ b/upstream/fedora-rawhide/man1/sha1sum.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SHA1SUM "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SHA1SUM "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME sha1sum \- compute and check SHA1 message digest .SH SYNOPSIS @@ -56,7 +56,7 @@ The default mode is to print a line with: checksum, a space, a character indicating input mode ('*' for binary, ' ' for text or where binary is insignificant), and name for each FILE. .PP -Note: There is no difference between binary mode and text mode on GNU systems. +There is no difference between binary mode and text mode on GNU systems. .SH BUGS Do not use the SHA-1 algorithm for security related purposes. Instead, use an SHA\-2 algorithm, implemented in the programs @@ -69,7 +69,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/sha224sum.1 b/upstream/fedora-rawhide/man1/sha224sum.1 index 1ad5a3cc..65af4ac9 100644 --- a/upstream/fedora-rawhide/man1/sha224sum.1 +++ b/upstream/fedora-rawhide/man1/sha224sum.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SHA224SUM "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SHA224SUM "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME sha224sum \- compute and check SHA224 message digest .SH SYNOPSIS @@ -56,7 +56,7 @@ The default mode is to print a line with: checksum, a space, a character indicating input mode ('*' for binary, ' ' for text or where binary is insignificant), and name for each FILE. .PP -Note: There is no difference between binary mode and text mode on GNU systems. +There is no difference between binary mode and text mode on GNU systems. .SH AUTHOR Written by Ulrich Drepper, Scott Miller, and David Madore. .SH "REPORTING BUGS" @@ -64,7 +64,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/sha256sum.1 b/upstream/fedora-rawhide/man1/sha256sum.1 index e097fc9b..5ec4940c 100644 --- a/upstream/fedora-rawhide/man1/sha256sum.1 +++ b/upstream/fedora-rawhide/man1/sha256sum.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SHA256SUM "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SHA256SUM "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME sha256sum \- compute and check SHA256 message digest .SH SYNOPSIS @@ -56,7 +56,7 @@ The default mode is to print a line with: checksum, a space, a character indicating input mode ('*' for binary, ' ' for text or where binary is insignificant), and name for each FILE. .PP -Note: There is no difference between binary mode and text mode on GNU systems. +There is no difference between binary mode and text mode on GNU systems. .SH AUTHOR Written by Ulrich Drepper, Scott Miller, and David Madore. .SH "REPORTING BUGS" @@ -64,7 +64,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/sha384sum.1 b/upstream/fedora-rawhide/man1/sha384sum.1 index 198f1fbb..40f1a5b3 100644 --- a/upstream/fedora-rawhide/man1/sha384sum.1 +++ b/upstream/fedora-rawhide/man1/sha384sum.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SHA384SUM "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SHA384SUM "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME sha384sum \- compute and check SHA384 message digest .SH SYNOPSIS @@ -56,7 +56,7 @@ The default mode is to print a line with: checksum, a space, a character indicating input mode ('*' for binary, ' ' for text or where binary is insignificant), and name for each FILE. .PP -Note: There is no difference between binary mode and text mode on GNU systems. +There is no difference between binary mode and text mode on GNU systems. .SH AUTHOR Written by Ulrich Drepper, Scott Miller, and David Madore. .SH "REPORTING BUGS" @@ -64,7 +64,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/sha512sum.1 b/upstream/fedora-rawhide/man1/sha512sum.1 index cc569051..f7f9bd61 100644 --- a/upstream/fedora-rawhide/man1/sha512sum.1 +++ b/upstream/fedora-rawhide/man1/sha512sum.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SHA512SUM "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SHA512SUM "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME sha512sum \- compute and check SHA512 message digest .SH SYNOPSIS @@ -56,7 +56,7 @@ The default mode is to print a line with: checksum, a space, a character indicating input mode ('*' for binary, ' ' for text or where binary is insignificant), and name for each FILE. .PP -Note: There is no difference between binary mode and text mode on GNU systems. +There is no difference between binary mode and text mode on GNU systems. .SH AUTHOR Written by Ulrich Drepper, Scott Miller, and David Madore. .SH "REPORTING BUGS" @@ -64,7 +64,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/shred.1 b/upstream/fedora-rawhide/man1/shred.1 index 8465cffc..9dfc7da8 100644 --- a/upstream/fedora-rawhide/man1/shred.1 +++ b/upstream/fedora-rawhide/man1/shred.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SHRED "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SHRED "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME shred \- overwrite a file to hide its contents, and optionally delete it .SH SYNOPSIS @@ -70,7 +70,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/shuf.1 b/upstream/fedora-rawhide/man1/shuf.1 index 522aabfe..904f5f06 100644 --- a/upstream/fedora-rawhide/man1/shuf.1 +++ b/upstream/fedora-rawhide/man1/shuf.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SHUF "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SHUF "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME shuf \- generate random permutations .SH SYNOPSIS @@ -53,7 +53,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/size.1 b/upstream/fedora-rawhide/man1/size.1 index 0b2f720a..fc97801a 100644 --- a/upstream/fedora-rawhide/man1/size.1 +++ b/upstream/fedora-rawhide/man1/size.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "SIZE 1" -.TH SIZE 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH SIZE 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/sleep.1 b/upstream/fedora-rawhide/man1/sleep.1 index 2dd34099..89b4c152 100644 --- a/upstream/fedora-rawhide/man1/sleep.1 +++ b/upstream/fedora-rawhide/man1/sleep.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SLEEP "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SLEEP "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME sleep \- delay for a specified amount of time .SH SYNOPSIS @@ -28,7 +28,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/sort.1 b/upstream/fedora-rawhide/man1/sort.1 index 2afb89bb..eaf7ad97 100644 --- a/upstream/fedora-rawhide/man1/sort.1 +++ b/upstream/fedora-rawhide/man1/sort.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SORT "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SORT "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME sort \- sort lines of text files .SH SYNOPSIS @@ -40,7 +40,8 @@ compare (unknown) < 'JAN' < ... < 'DEC' compare human readable numbers (e.g., 2K 1G) .TP \fB\-n\fR, \fB\-\-numeric\-sort\fR -compare according to string numerical value +compare according to string numerical value; +see manual for which strings are supported .TP \fB\-R\fR, \fB\-\-random\-sort\fR shuffle, but group identical keys. See \fBshuf\fP(1) @@ -144,7 +145,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/split.1 b/upstream/fedora-rawhide/man1/split.1 index acbbe11a..871760d7 100644 --- a/upstream/fedora-rawhide/man1/split.1 +++ b/upstream/fedora-rawhide/man1/split.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SPLIT "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SPLIT "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME split \- split a file into pieces .SH SYNOPSIS @@ -97,7 +97,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/sprof.1 b/upstream/fedora-rawhide/man1/sprof.1 index b99e4aad..6d9796b4 100644 --- a/upstream/fedora-rawhide/man1/sprof.1 +++ b/upstream/fedora-rawhide/man1/sprof.1 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sprof 1 2023-10-31 "Linux man-pages 6.06" +.TH sprof 1 2023-10-31 "Linux man-pages 6.7" .SH NAME sprof \- read and display shared object profiling data .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/stat.1 b/upstream/fedora-rawhide/man1/stat.1 index ee84d3fc..98e6164f 100644 --- a/upstream/fedora-rawhide/man1/stat.1 +++ b/upstream/fedora-rawhide/man1/stat.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH STAT "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH STAT "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME stat \- display file or file system status .SH SYNOPSIS @@ -48,7 +48,7 @@ The MODE argument of \fB\-\-cached\fR can be: always, never, or default. The valid format sequences for files (without \fB\-\-file\-system\fR): .TP %a -permission bits in octal (note '#' and '0' printf flags) +permission bits in octal (see '#' and '0' printf flags) .TP %A permission bits and file type in human readable form @@ -199,7 +199,7 @@ file system type in human readable form .IP %n %i %l %t %s %S %b %f %a %c %d .PP -NOTE: your shell may have its own version of stat, which usually supersedes +Your shell may have its own version of stat, which usually supersedes the version described here. Please refer to your shell's documentation for details about the options it supports. .SH AUTHOR @@ -209,7 +209,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/stdbuf.1 b/upstream/fedora-rawhide/man1/stdbuf.1 index 90fdb7bc..06d1035f 100644 --- a/upstream/fedora-rawhide/man1/stdbuf.1 +++ b/upstream/fedora-rawhide/man1/stdbuf.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH STDBUF "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH STDBUF "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME stdbuf \- Run COMMAND, with modified buffering operations for its standard streams. @@ -70,7 +70,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/strings.1 b/upstream/fedora-rawhide/man1/strings.1 index 04497b25..af549e3d 100644 --- a/upstream/fedora-rawhide/man1/strings.1 +++ b/upstream/fedora-rawhide/man1/strings.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "STRINGS 1" -.TH STRINGS 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH STRINGS 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/strip.1 b/upstream/fedora-rawhide/man1/strip.1 index 79eccc66..04dae66d 100644 --- a/upstream/fedora-rawhide/man1/strip.1 +++ b/upstream/fedora-rawhide/man1/strip.1 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "STRIP 1" -.TH STRIP 1 2024-02-22 binutils-2.42.50 "GNU Development Tools" +.TH STRIP 1 2024-05-13 binutils-2.42.50 "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/upstream/fedora-rawhide/man1/stty.1 b/upstream/fedora-rawhide/man1/stty.1 index b73399f5..7860eeeb 100644 --- a/upstream/fedora-rawhide/man1/stty.1 +++ b/upstream/fedora-rawhide/man1/stty.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH STTY "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH STTY "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME stty \- change and print terminal line settings .SH SYNOPSIS @@ -402,7 +402,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/sum.1 b/upstream/fedora-rawhide/man1/sum.1 index 2f0f8067..4ca32720 100644 --- a/upstream/fedora-rawhide/man1/sum.1 +++ b/upstream/fedora-rawhide/man1/sum.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SUM "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SUM "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME sum \- checksum and count the blocks in a file .SH SYNOPSIS @@ -30,7 +30,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/sync.1 b/upstream/fedora-rawhide/man1/sync.1 index e80c72f4..f5baddd3 100644 --- a/upstream/fedora-rawhide/man1/sync.1 +++ b/upstream/fedora-rawhide/man1/sync.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH SYNC "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH SYNC "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME sync \- Synchronize cached writes to persistent storage .SH SYNOPSIS @@ -34,7 +34,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/systemctl.1 b/upstream/fedora-rawhide/man1/systemctl.1 index e6609537..9de3380d 100644 --- a/upstream/fedora-rawhide/man1/systemctl.1 +++ b/upstream/fedora-rawhide/man1/systemctl.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMCTL" "1" "" "systemd 255" "systemctl" +.TH "SYSTEMCTL" "1" "" "systemd 256~rc3" "systemctl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -394,7 +394,7 @@ For details about many of these properties, see the documentation of the D\-Bus .PP \fBcat \fR\fB\fIPATTERN\fR\fR\fB\&...\fR .RS 4 -Show backing files of one or more units\&. Prints the "fragment" and "drop\-ins" (source files) of units\&. Each file is preceded by a comment which includes the file name\&. Note that this shows the contents of the backing files on disk, which may not match the system manager\*(Aqs understanding of these units if any unit files were updated on disk and the +Show backing files of one or more units\&. Prints the "fragment" and "drop\-ins" (source files) of units\&. Each file is preceded by a comment which includes the file name\&. Note that this shows the contents of the backing files on disk, which might not match the system manager\*(Aqs understanding of these units if any unit files were updated on disk and the \fBdaemon\-reload\fR command wasn\*(Aqt issued since\&. .sp @@ -574,6 +574,64 @@ is selected, see \fB\-\-what=\fR is not specified, the cache and runtime data as well as the file descriptor store are removed (as these three types of resources are generally redundant and reproducible on the next invocation of the unit)\&. Note that the specified units must be stopped to invoke this operation\&. .sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.B Table\ \&1.\ \& Possible values for \-\-what= +.TS +allbox tab(:); +lB lB. +T{ +Value +T}:T{ +Unit Setting +T} +.T& +l l +l l +l l +l l +l l +l l +l l. +T{ +"runtime" +T}:T{ +\fIRuntimeDirectory=\fR +T} +T{ +"state" +T}:T{ +\fIStateDirectory=\fR +T} +T{ +"cache" +T}:T{ +\fICacheDirectory=\fR +T} +T{ +"logs" +T}:T{ +\fILogsDirectory=\fR +T} +T{ +"configuration" +T}:T{ +\fIConfigurationDirectory=\fR +T} +T{ +"fdstore" +T}:T{ +\fIFileDescriptorStorePreserve=\fR +T} +T{ +"all" +T}:T{ +All of the above +T} +.TE +.sp 1 Added in version 243\&. .RE .PP @@ -967,7 +1025,7 @@ Checks whether any of the specified unit files are enabled (as with .nr an-no-space-flag 1 .nr an-break-flag 1 .br -.B Table\ \&1.\ \& is\-enabled output +.B Table\ \&2.\ \& is\-enabled output .TS allbox tab(:); lB lB lB. @@ -1186,29 +1244,34 @@ Added in version 217\&. .PP \fBedit \fR\fB\fIUNIT\fR\fR\fB\&...\fR .RS 4 -Edit a drop\-in snippet or a whole replacement file if -\fB\-\-full\fR -is specified, to extend or override the specified unit\&. +Edit or replace a drop\-in snippet or the main unit file, to extend or override the definition of the specified unit\&. .sp Depending on whether \fB\-\-system\fR (the default), \fB\-\-user\fR, or \fB\-\-global\fR -is specified, this command creates a drop\-in file for each unit either for the system, for the calling user, or for all futures logins of all users\&. Then, the editor (see the "Environment" section below) is invoked on temporary files which will be written to the real location if the editor exits successfully\&. +is specified, this command will operate on the system unit files, unit files for the calling user, or the unit files shared between all users\&. .sp -If -\fB\-\-drop\-in=\fR -is specified, the given drop\-in file name will be used instead of the default -override\&.conf\&. +The editor (see the "Environment" section below) is invoked on temporary files which will be written to the real location if the editor exits successfully\&. After the editing is finished, configuration is reloaded, equivalent to +\fBsystemctl daemon\-reload \-\-system\fR +or +\fBsystemctl daemon\-reload \-\-user\fR\&. For +\fBedit \-\-global\fR, the reload is not performed and the edits will take effect only for subsequent logins (or after a reload is requested in a different way)\&. .sp If \fB\-\-full\fR -is specified, this will copy the original units instead of creating drop\-in files\&. +is specified, a replacement for the main unit file will be created or edited\&. Otherwise, a drop\-in file will be created or edited\&. .sp If +\fB\-\-drop\-in=\fR +is specified, the given drop\-in file name will be used instead of the default +override\&.conf\&. +.sp +The unit must exist, i\&.e\&. its main unit file must be present\&. If \fB\-\-force\fR -is specified and any units do not already exist, new unit files will be opened for editing\&. +is specified, this requirement is ignored and a new unit may be created (with +\fB\-\-full\fR), or a drop\-in for a nonexistent unit may be created\&. .sp If \fB\-\-runtime\fR @@ -1216,10 +1279,11 @@ is specified, the changes will be made temporarily in /run/ and they will be lost on the next reboot\&. .sp -If the temporary file is empty upon exit, the modification of the related unit is canceled\&. +If +\fB\-\-stdin\fR +is specified, the new contents will be read from standard input\&. In this mode, the old contents of the file are discarded\&. .sp -After the units have been edited, systemd configuration is reloaded (in a way that is equivalent to -\fBdaemon\-reload\fR)\&. +If the temporary file is empty upon exit, the modification of the related unit is canceled\&. .sp Note that this command cannot be used to remotely edit units and that you cannot temporarily edit units which are in /etc/, since they take precedence over @@ -1299,11 +1363,21 @@ Dump the systemd manager environment block\&. This is the environment block that \fBdash\fR(1) or \fBfish\fR(1)\&. +.sp +Note that this shows the +\fIeffective\fR +block, i\&.e\&. the combination of environment variables configured via configuration files, environment generators and via IPC (i\&.e\&. via the +\fBset\-environment\fR +described below)\&. At the moment a unit process is forked off this combined environment block will be further combined with per\-unit environment variables, which are not visible in this command\&. .RE .PP \fBset\-environment \fR\fB\fIVARIABLE=VALUE\fR\fR\fB\&...\fR .RS 4 -Set one or more systemd manager environment variables, as specified on the command line\&. This command will fail if variable names and values do not conform to the rules listed above\&. +Set one or more service manager environment variables, as specified on the command line\&. This command will fail if variable names and values do not conform to the rules listed above\&. +.sp +Note that this operates on an environment block separate from the environment block configured from service manager configuration and environment generators\&. Whenever a process is invoked the two blocks are combined (also incorporating any per\-service environment variables), and passed to it\&. The +\fBshow\-environment\fR +verb will show the combination of the blocks, see above\&. .sp Added in version 233\&. .RE @@ -1312,6 +1386,10 @@ Added in version 233\&. .RS 4 Unset one or more systemd manager environment variables\&. If only a variable name is specified, it will be removed regardless of its value\&. If a variable and a value are specified, the variable is only removed if it has the specified value\&. .sp +Note that this operates on an environment block separate from the environment block configured from service manager configuration and environment generators\&. Whenever a process is invoked the two blocks are combined (also incorporating any per\-service environment variables), and passed to it\&. The +\fBshow\-environment\fR +verb will show the combination of the blocks, see above\&. Note that this means this command cannot be used to unset environment variables defined in the service manager configuration files or via generators\&. +.sp Added in version 233\&. .RE .PP @@ -1405,7 +1483,7 @@ or .nr an-no-space-flag 1 .nr an-break-flag 1 .br -.B Table\ \&2.\ \&is\-system\-running output +.B Table\ \&3.\ \&is\-system\-running output .TS allbox tab(:); lB lB lB. @@ -1676,16 +1754,49 @@ Switches to a different root directory and executes a new system manager process Added in version 209\&. .RE .PP +\fBsleep\fR +.RS 4 +Put the system to sleep, through +\fBsuspend\fR, +\fBhibernate\fR, +\fBhybrid\-sleep\fR, or +\fBsuspend\-then\-hibernate\fR\&. The sleep operation to use is automatically selected by +\fBsystemd-logind.service\fR(8)\&. By default, +\fBsuspend\-then\-hibernate\fR +is used, and falls back to +\fBsuspend\fR +and then +\fBhibernate\fR +if not supported\&. Refer to +\fISleepOperation=\fR +setting in +\fBlogind.conf\fR(5) +for more details\&. This command is asynchronous, and will return after the sleep operation is successfully enqueued\&. It will not wait for the sleep/resume cycle to complete\&. +.sp +Added in version 256\&. +.RE +.PP \fBsuspend\fR .RS 4 Suspend the system\&. This will trigger activation of the special target unit suspend\&.target\&. This command is asynchronous, and will return after the suspend operation is successfully enqueued\&. It will not wait for the suspend/resume cycle to complete\&. +.sp +If +\fB\-\-force\fR +is specified, and +\fBsystemd\-logind\fR +returned error for the operation, the error will be ignored and the operation will be tried again directly through starting the target unit\&. .RE .PP \fBhibernate\fR .RS 4 Hibernate the system\&. This will trigger activation of the special target unit hibernate\&.target\&. This command is asynchronous, and will return after the hibernation operation is successfully enqueued\&. It will not wait for the hibernate/thaw cycle to complete\&. +.sp +This command honors +\fB\-\-force\fR +in the same way as +\fBsuspend\fR\&. .RE .PP \fBhybrid\-sleep\fR @@ -1693,15 +1804,26 @@ hibernate\&.target\&. This command is asynchronous, and will return after the hi Hibernate and suspend the system\&. This will trigger activation of the special target unit hybrid\-sleep\&.target\&. This command is asynchronous, and will return after the hybrid sleep operation is successfully enqueued\&. It will not wait for the sleep/wake\-up cycle to complete\&. .sp +This command honors +\fB\-\-force\fR +in the same way as +\fBsuspend\fR\&. +.sp Added in version 196\&. .RE .PP \fBsuspend\-then\-hibernate\fR .RS 4 -Suspend the system and hibernate it after the delay specified in -systemd\-sleep\&.conf\&. This will trigger activation of the special target unit +Suspend the system and hibernate it when the battery is low, or when the delay specified in +systemd\-sleep\&.conf +elapsed\&. This will trigger activation of the special target unit suspend\-then\-hibernate\&.target\&. This command is asynchronous, and will return after the hybrid sleep operation is successfully enqueued\&. It will not wait for the sleep/wake\-up or hibernate/thaw cycle to complete\&. .sp +This command honors +\fB\-\-force\fR +in the same way as +\fBsuspend\fR\&. +.sp Added in version 240\&. .RE .SS "Parameter Syntax" @@ -1799,7 +1921,7 @@ for more details\&. The patterns are matched against the primary names of units .RS 4 .\} .nf -# systemctl stop sshd@*\&.service +# systemctl stop "sshd@*\&.service" .fi .if n \{\ .RE @@ -2240,7 +2362,19 @@ on units that are enabled in global scope, when a \fBstop\fR\-ped, \fBdisable\fR\-d, or -\fBmask\fR\-ed unit still has active triggering units\&. +\fBmask\fR\-ed unit still has active triggering units, +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +when a unit file is changed and requires +\fBdaemon\-reload\fR\&. .RE .sp Added in version 253\&. @@ -2256,13 +2390,19 @@ will wait until the unit\*(Aqs start\-up is completed\&. By passing this argumen .PP \fB\-\-wait\fR .RS 4 -Synchronously wait for started units to terminate again\&. This option may not be combined with +When used with +\fBstart\fR +or +\fBrestart\fR, synchronously wait for started units to terminate again\&. This option may not be combined with \fB\-\-no\-block\fR\&. Note that this will wait forever if any given unit never terminates (by itself or by getting stopped explicitly); particularly services which use "RemainAfterExit=yes"\&. .sp When used with \fBis\-system\-running\fR, wait until the boot process is completed before returning\&. .sp +When used with +\fBkill\fR, wait until the signalled units terminate\&. Note that this will wait forever if any given unit never terminates\&. +.sp Added in version 232\&. .RE .PP @@ -2341,7 +2481,7 @@ and Added in version 252\&. .RE .PP -\fB\-\-kill\-value=\fR\fIINT\fR +\fB\-\-kill\-value=\fR\fB\fIINT\fR\fR .RS 4 If used with the \fBkill\fR @@ -2415,20 +2555,42 @@ When used with \fBedit\fR, create all of the specified units which do not already exist\&. .sp When used with +\fBsuspend\fR, +\fBhibernate\fR, +\fBhybrid\-sleep\fR, or +\fBsuspend\-then\-hibernate\fR, the error returned by +\fBsystemd\-logind\fR +will be ignored, and the operation will be performed directly through starting the corresponding units\&. +.sp +When used with \fBhalt\fR, \fBpoweroff\fR, -\fBreboot\fR -or +\fBreboot\fR, or \fBkexec\fR, execute the selected operation without shutting down all units\&. However, all processes will be killed forcibly and all file systems are unmounted or remounted read\-only\&. This is hence a drastic but relatively safe option to request an immediate reboot\&. If \fB\-\-force\fR is specified twice for these operations (with the exception of -\fBkexec\fR), they will be executed immediately, without terminating any processes or unmounting any file systems\&. Warning: specifying +\fBkexec\fR), they will be executed immediately, without terminating any processes or unmounting any file systems\&. +.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 +Specifying \fB\-\-force\fR twice with any of these operations might result in data loss\&. Note that when \fB\-\-force\fR is specified twice the selected operation is executed by \fBsystemctl\fR itself, and the system manager is not contacted\&. This means the command should succeed even when the system manager has crashed\&. +.sp .5v +.RE .RE .PP \fB\-\-message=\fR @@ -2663,7 +2825,7 @@ When used with Added in version 248\&. .RE .PP -\fB\-\-drop\-in=\fR\fINAME\fR +\fB\-\-drop\-in=\fR\fB\fINAME\fR\fR .RS 4 When used with \fBedit\fR, use @@ -2691,6 +2853,30 @@ is given, the currently scheduled action will be shown, which can be canceled by Added in version 254\&. .RE .PP +\fB\-\-stdin\fR +.RS 4 +When used with +\fBedit\fR, the contents of the file will be read from standard input and the editor will not be launched\&. In this mode, the old contents of the file are completely replaced\&. This is useful to "edit" unit files from scripts: +.sp +.if n \{\ +.RS 4 +.\} +.nf +$ systemctl edit \-\-drop\-in=limits\&.conf \-\-stdin some\-service\&.service <<EOF +[Unit] +AllowedCPUs=7,11 +EOF + +.fi +.if n \{\ +.RE +.\} +.sp +Multiple drop\-ins may be "edited" in this mode; the same contents will be written to all of them\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-H\fR, \fB\-\-host=\fR .RS 4 Execute the operation remotely\&. Specify a hostname, or a username and hostname separated by @@ -2716,12 +2902,19 @@ syntax is used either the left hand side or the right hand side may be omitted ( are implied\&. .RE .PP +\fB\-C\fR, \fB\-\-capsule=\fR +.RS 4 +Execute operation on a capsule\&. Specify a capsule name to connect to\&. See +\fBcapsule@.service\fR(5) +for details about capsules\&. +.RE +.PP \fB\-\-no\-pager\fR .RS 4 Do not pipe output into a pager\&. .RE .PP -\fB\-\-legend=\fR\fIBOOL\fR +\fB\-\-legend=\fR\fB\fIBOOL\fR\fR .RS 4 Enable or disable printing of the legend, i\&.e\&. column headers and the footer with hints\&. The legend is printed by default, unless disabled with \fB\-\-quiet\fR @@ -2749,7 +2942,7 @@ uses the return codes defined by LSB, as defined in .nr an-no-space-flag 1 .nr an-break-flag 1 .br -.B Table\ \&3.\ \&LSB return codes +.B Table\ \&4.\ \&LSB return codes .TS allbox tab(:); lB lB lB. @@ -2829,7 +3022,7 @@ Added in version 218\&. .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, @@ -2839,7 +3032,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 @@ -2945,6 +3146,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\&. @@ -2956,6 +3163,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 @@ -3011,17 +3224,7 @@ and other conditions\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBjournalctl\fR(1), -\fBloginctl\fR(1), -\fBmachinectl\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemd.resource-control\fR(5), -\fBsystemd.special\fR(7), -\fBwall\fR(1), -\fBsystemd.preset\fR(5), -\fBsystemd.generator\fR(7), -\fBglob\fR(7) +\fBsystemd\fR(1), \fBjournalctl\fR(1), \fBloginctl\fR(1), \fBmachinectl\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.special\fR(7), \fBwall\fR(1), \fBsystemd.preset\fR(5), \fBsystemd.generator\fR(7), \fBglob\fR(7) .SH "NOTES" .IP " 1." 4 Boot Loader Specification diff --git a/upstream/fedora-rawhide/man1/systemd-ac-power.1 b/upstream/fedora-rawhide/man1/systemd-ac-power.1 index aadfbf33..863afbf7 100644 --- a/upstream/fedora-rawhide/man1/systemd-ac-power.1 +++ b/upstream/fedora-rawhide/man1/systemd-ac-power.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-AC\-POWER" "1" "" "systemd 255" "systemd-ac-power" +.TH "SYSTEMD\-AC\-POWER" "1" "" "systemd 256~rc3" "systemd-ac-power" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man1/systemd-analyze.1 b/upstream/fedora-rawhide/man1/systemd-analyze.1 index ce1a2b09..22b5a31a 100644 --- a/upstream/fedora-rawhide/man1/systemd-analyze.1 +++ b/upstream/fedora-rawhide/man1/systemd-analyze.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-ANALYZE" "1" "" "systemd 255" "systemd-analyze" +.TH "SYSTEMD\-ANALYZE" "1" "" "systemd 256~rc3" "systemd-analyze" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -73,7 +73,9 @@ systemd-analyze \- Analyze and debug system manager .HP \w'\fBsystemd\-analyze\fR\ 'u \fBsystemd\-analyze\fR [OPTIONS...] pcrs [\fIPCR\fR...] .HP \w'\fBsystemd\-analyze\fR\ 'u -\fBsystemd\-analyze\fR [OPTIONS...] srk > \fIFILE\fR +\fBsystemd\-analyze\fR [OPTIONS...] srk [\fI>FILE\fR] +.HP \w'\fBsystemd\-analyze\fR\ 'u +\fBsystemd\-analyze\fR [OPTIONS...] architectures [\fINAME\fR...] .SH "DESCRIPTION" .PP \fBsystemd\-analyze\fR @@ -906,15 +908,48 @@ NR NAME SHA256 .if n \{\ .RE .\} -.SS "systemd\-analyze srk > \fIFILE\fR" +.SS "systemd\-analyze srk [>\fIFILE\fR]" +.PP +This command reads the Storage Root Key (SRK) from the TPM2 device, and writes it in marshalled TPM2B_PUBLIC format to stdout\&. The output is non\-printable data, so it should be redirected to a file or into a pipe\&. .PP -This command reads the Storage Root Key (SRK) from the TPM2 device, and writes it in marshalled TPM2B_PUBLIC format to stdout\&. Example: +\fBExample\ \&25.\ \&Save the Storage Root Key to srk\&.tpm2b_public\fR .sp .if n \{\ .RS 4 .\} .nf -systemd\-analyze srk > srk\&.tpm2b_public +systemd\-analyze srk >srk\&.tpm2b_public +.fi +.if n \{\ +.RE +.\} +.SS "systemd\-analyze architectures [\fINAME\fR\&.\&.\&.]" +.PP +Lists all known CPU architectures, and which ones are native\&. The listed architecture names are those +\fIConditionArchitecture=\fR +supports, see +\fBsystemd.unit\fR(5) +for details\&. If architecture names are specified only those specified are listed\&. +.PP +\fBExample\ \&26.\ \&Table output\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +$ systemd\-analyze architectures +NAME SUPPORT +alpha foreign +arc foreign +arc\-be foreign +arm foreign +arm64 foreign +\&... +sparc foreign +sparc64 foreign +tilegx foreign +x86 secondary +x86\-64 native .fi .if n \{\ .RE @@ -959,8 +994,8 @@ are shown\&. If is passed, only dependencies of type \fIRequires=\fR, \fIRequisite=\fR, -\fIWants=\fR -and +\fIBindsTo=\fR, +\fIWants=\fR, and \fIConflicts=\fR are shown\&. If neither is passed, this shows dependencies of all these types\&. .sp @@ -980,7 +1015,7 @@ Each of these can be used more than once, in which case the unit name must match Added in version 201\&. .RE .PP -\fB\-\-fuzz=\fR\fItimespan\fR +\fB\-\-fuzz=\fR\fB\fItimespan\fR\fR .RS 4 When used in conjunction with the \fBcritical\-chain\fR @@ -1026,9 +1061,13 @@ Added in version 250\&. \fB\-\-root=\fR\fB\fIPATH\fR\fR .RS 4 With -\fBcat\-files\fR +\fBcat\-config\fR, +\fBverify\fR, +\fBcondition\fR and -\fBverify\fR, operate on files underneath the specified root path +\fBsecurity\fR +when used with +\fB\-\-offline=\fR, operate on files underneath the specified root path \fIPATH\fR\&. .sp Added in version 239\&. @@ -1037,9 +1076,13 @@ Added in version 239\&. \fB\-\-image=\fR\fB\fIPATH\fR\fR .RS 4 With -\fBcat\-files\fR +\fBcat\-config\fR, +\fBverify\fR, +\fBcondition\fR and -\fBverify\fR, operate on files inside the specified image path +\fBsecurity\fR +when used with +\fB\-\-offline=\fR, operate on files inside the specified image path \fIPATH\fR\&. .sp Added in version 250\&. @@ -1609,7 +1652,7 @@ if the condition is respectively true or false\&. .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, @@ -1619,7 +1662,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 @@ -1738,6 +1789,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\&. @@ -1749,6 +1806,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 @@ -1804,7 +1867,7 @@ and other conditions\&. .RE .SH "EXAMPLES" .PP -\fBExample\ \&25.\ \&JSON Policy\fR +\fBExample\ \&27.\ \&JSON Policy\fR .PP The JSON file passed as a path parameter to \fB\-\-security\-policy=\fR @@ -1870,8 +1933,7 @@ means the setting will not be checked\&. .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1) .SH "NOTES" .IP " 1." 4 Packaging Metadata diff --git a/upstream/fedora-rawhide/man1/systemd-ask-password.1 b/upstream/fedora-rawhide/man1/systemd-ask-password.1 index 8583162a..e033ef73 100644 --- a/upstream/fedora-rawhide/man1/systemd-ask-password.1 +++ b/upstream/fedora-rawhide/man1/systemd-ask-password.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-ASK\-PASSWORD" "1" "" "systemd 255" "systemd-ask-password" +.TH "SYSTEMD\-ASK\-PASSWORD" "1" "" "systemd 256~rc3" "systemd-ask-password" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -22,8 +22,8 @@ .SH "NAME" systemd-ask-password \- Query the user for a system password .SH "SYNOPSIS" -.HP \w'\fBsystemd\-ask\-password\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB[MESSAGE]\fR\ 'u -\fBsystemd\-ask\-password \fR\fB[OPTIONS...]\fR\fB \fR\fB[MESSAGE]\fR +.HP \w'\fBsystemd\-ask\-password\fR\ 'u +\fBsystemd\-ask\-password\fR [OPTIONS...] [MESSAGE] .SH "DESCRIPTION" .PP \fBsystemd\-ask\-password\fR @@ -232,12 +232,7 @@ Print a short help text and exit\&. On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-ask-password-console.service\fR(8), -\fBsystemd-tty-ask-password-agent\fR(1), -\fBkeyctl\fR(1), -\fBplymouth\fR(8), -\fBwall\fR(1) +\fBsystemd\fR(1), \fBsystemd-ask-password-console.service\fR(8), \fBsystemd-tty-ask-password-agent\fR(1), \fBkeyctl\fR(1), \fBplymouth\fR(8), \fBwall\fR(1) .SH "NOTES" .IP " 1." 4 systemd Password Agent Specification diff --git a/upstream/fedora-rawhide/man1/systemd-cat.1 b/upstream/fedora-rawhide/man1/systemd-cat.1 index 0e441745..dac2205f 100644 --- a/upstream/fedora-rawhide/man1/systemd-cat.1 +++ b/upstream/fedora-rawhide/man1/systemd-cat.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-CAT" "1" "" "systemd 255" "systemd-cat" +.TH "SYSTEMD\-CAT" "1" "" "systemd 256~rc3" "systemd-cat" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -22,10 +22,10 @@ .SH "NAME" systemd-cat \- Connect a pipeline or program\*(Aqs output with the journal .SH "SYNOPSIS" -.HP \w'\fBsystemd\-cat\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB[COMMAND]\fR\fB\ \fR\fB[ARGUMENTS...]\fR\ 'u -\fBsystemd\-cat \fR\fB[OPTIONS...]\fR\fB \fR\fB[COMMAND]\fR\fB \fR\fB[ARGUMENTS...]\fR -.HP \w'\fBsystemd\-cat\ \fR\fB[OPTIONS...]\fR\ 'u -\fBsystemd\-cat \fR\fB[OPTIONS...]\fR +.HP \w'\fBsystemd\-cat\fR\ 'u +\fBsystemd\-cat\fR [OPTIONS...] [COMMAND] [ARGUMENTS...] +.HP \w'\fBsystemd\-cat\fR\ 'u +\fBsystemd\-cat\fR [OPTIONS...] .SH "DESCRIPTION" .PP \fBsystemd\-cat\fR @@ -95,6 +95,14 @@ Controls whether lines read are parsed for syslog priority level prefixes\&. If "<5>" is logged at priority 5 ("notice"), and similarly for the other priority levels\&. Takes a boolean argument\&. .RE +.PP +\fB\-\-namespace=\fR +.RS 4 +Specifies the journal namespace to which the standard IO should be connected\&. For details about journal namespaces, see +\fBsystemd-journald.service\fR(8)\&. +.sp +Added in version 256\&. +.RE .SH "EXIT STATUS" .PP On success, 0 is returned, a non\-zero failure code otherwise\&. @@ -135,6 +143,4 @@ and writes the output it generates to the journal: Even though the two examples have very similar effects, the first is preferable, since only one process is running at a time and both stdout and stderr are captured, while in the second example, only stdout is captured\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBlogger\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBlogger\fR(1) diff --git a/upstream/fedora-rawhide/man1/systemd-cgls.1 b/upstream/fedora-rawhide/man1/systemd-cgls.1 index 781d9307..7f53bd49 100644 --- a/upstream/fedora-rawhide/man1/systemd-cgls.1 +++ b/upstream/fedora-rawhide/man1/systemd-cgls.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-CGLS" "1" "" "systemd 255" "systemd-cgls" +.TH "SYSTEMD\-CGLS" "1" "" "systemd 256~rc3" "systemd-cgls" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -109,8 +109,4 @@ Do not pipe output into a pager\&. On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd-cgtop\fR(1), -\fBsystemd-nspawn\fR(1), -\fBps\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-cgtop\fR(1), \fBsystemd-nspawn\fR(1), \fBps\fR(1) diff --git a/upstream/fedora-rawhide/man1/systemd-cgtop.1 b/upstream/fedora-rawhide/man1/systemd-cgtop.1 index c67d5e34..99b1e60d 100644 --- a/upstream/fedora-rawhide/man1/systemd-cgtop.1 +++ b/upstream/fedora-rawhide/man1/systemd-cgtop.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-CGTOP" "1" "" "systemd 255" "systemd-cgtop" +.TH "SYSTEMD\-CGTOP" "1" "" "systemd 256~rc3" "systemd-cgtop" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -283,8 +283,4 @@ Added in version 226\&. On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd-cgls\fR(1), -\fBsystemd.resource-control\fR(5), -\fBtop\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-cgls\fR(1), \fBsystemd.resource-control\fR(5), \fBtop\fR(1) diff --git a/upstream/fedora-rawhide/man1/systemd-creds.1 b/upstream/fedora-rawhide/man1/systemd-creds.1 index db9944ec..e2c9198c 100644 --- a/upstream/fedora-rawhide/man1/systemd-creds.1 +++ b/upstream/fedora-rawhide/man1/systemd-creds.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-CREDS" "1" "" "systemd 255" "systemd-creds" +.TH "SYSTEMD\-CREDS" "1" "" "systemd 256~rc3" "systemd-creds" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -219,6 +219,39 @@ commands operates on the credentials passed to system as a whole instead of on t Added in version 250\&. .RE .PP +\fB\-\-user\fR +.RS 4 +When specified with the +\fBencrypt\fR +and +\fBdecrypt\fR +commands encrypts a user\-scoped (rather than a system\-scoped) credential\&. Use +\fB\-\-uid=\fR +to select which user the credential is from\&. Such credentials may only be decrypted from the specified user\*(Aqs context, except if privileges can be acquired\&. Generally, when an encrypted credential shall be used in the per\-user service manager it should be encrypted with this option set, when it shall be used in the system service manager it should be encrypted without\&. +.sp +Internally, this ensures that the selected user\*(Aqs numeric UID and username, as well as the system\*(Aqs +\fBmachine-id\fR(5) +are incorporated into the encryption key\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-uid=\fR +.RS 4 +Specifies the user to encrypt the credential for\&. Takes a user name or numeric UID\&. If set, implies +\fB\-\-user\fR\&. If set to the special string +"self" +sets the user to the user of the calling process\&. If +\fB\-\-user\fR +is used without +\fB\-\-uid=\fR +then +\fB\-\-uid=self\fR +is implied, i\&.e\&. the credential is encrypted for the calling user\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-\-transcode=\fR .RS 4 When specified with the @@ -272,7 +305,7 @@ as the output file\&. Added in version 250\&. .RE .PP -\fB\-\-name=\fR\fIname\fR +\fB\-\-name=\fR\fB\fIname\fR\fR .RS 4 When specified with the \fBencrypt\fR @@ -289,7 +322,7 @@ Embedding the credential name in the encrypted credential is done in order to pr Added in version 250\&. .RE .PP -\fB\-\-timestamp=\fR\fItimestamp\fR +\fB\-\-timestamp=\fR\fB\fItimestamp\fR\fR .RS 4 When specified with the \fBencrypt\fR @@ -305,7 +338,7 @@ during encryption\&. If not specified defaults to the current system time\&. Added in version 250\&. .RE .PP -\fB\-\-not\-after=\fR\fItimestamp\fR +\fB\-\-not\-after=\fR\fB\fItimestamp\fR\fR .RS 4 When specified with the \fBencrypt\fR @@ -323,7 +356,7 @@ command controls the encryption/signature key to use\&. Takes one of "host", "tpm2", "host+tpm2", -"tpm2\-absent", +"null", "auto", "auto\-initrd"\&. See above for details on the three key types\&. If set to "auto" @@ -334,11 +367,11 @@ is on persistent media\&. This means on typical systems the encryption is by def is selected but neither TPM2 is available (or running in container) nor /var/lib/systemd/ is on persistent media, encryption will fail\&. If set to -"tpm2\-absent" +"null" a fixed zero length key is used (thus, in this mode no confidentiality nor authenticity are provided!)\&. This logic is useful to cover for systems that lack a TPM2 chip but where credentials shall be generated\&. Note that decryption of such credentials is refused on systems that have a TPM2 chip and where UEFI SecureBoot is enabled (this is done so that such a locked down system cannot be tricked into loading a credential generated this way that lacks authentication information)\&. If set to "auto\-initrd" a TPM2 key is used if a TPM2 is found\&. If not a fixed zero length key is used, equivalent to -"tpm2\-absent" +"null" mode\&. This option is particularly useful to generate credentials files that are encrypted/authenticated against TPM2 where available but still work on systems lacking support for this\&. .sp The @@ -362,7 +395,7 @@ command, as information on which key to use for decryption is included in the en Added in version 250\&. .RE .PP -\fB\-\-tpm2\-device=\fR\fIPATH\fR +\fB\-\-tpm2\-device=\fR\fB\fIPATH\fR\fR .RS 4 Controls the TPM2 device to use\&. Expects a device node path referring to the TPM2 chip (e\&.g\&. /dev/tpmrm0)\&. Alternatively the special value @@ -374,7 +407,7 @@ may be used to enumerate all suitable TPM2 devices currently discovered\&. Added in version 250\&. .RE .PP -\fB\-\-tpm2\-pcrs=\fR [PCR...] +\fB\-\-tpm2\-pcrs=\fR\fB\fIPCR\fR\fI[+PCR\&.\&.\&.]\fR\fR .RS 4 Configures the TPM2 PCRs (Platform Configuration Registers) to bind the encryption key to\&. Takes a "+" @@ -384,7 +417,7 @@ separated list of numeric PCR indexes in the range 0\&...23\&. If not used, defa Added in version 250\&. .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, for use with the \fBencrypt\fR @@ -410,7 +443,7 @@ and Added in version 252\&. .RE .PP -\fB\-\-tpm2\-signature=\fR [PATH] +\fB\-\-tpm2\-signature=\fR\fB\fIPATH\fR\fR .RS 4 Takes a path to a TPM2 PCR signature file as generated by the \fBsystemd-measure\fR(1) @@ -427,6 +460,13 @@ is searched for in Added in version 252\&. .RE .PP +\fB\-\-allow\-null\fR +.RS 4 +Allow decrypting credentials that use an empty key\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-\-quiet\fR, \fB\-q\fR .RS 4 When used with @@ -446,7 +486,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" @@ -543,9 +583,7 @@ xyz\&.service: .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.exec\fR(5), -\fBsystemd-measure\fR(1) +\fBsystemd\fR(1), \fBsystemd.exec\fR(5), \fBsystemd-measure\fR(1) .SH "NOTES" .IP " 1." 4 System and Service Credentials diff --git a/upstream/fedora-rawhide/man1/systemd-cryptenroll.1 b/upstream/fedora-rawhide/man1/systemd-cryptenroll.1 index e65f3cd0..9efa4454 100644 --- a/upstream/fedora-rawhide/man1/systemd-cryptenroll.1 +++ b/upstream/fedora-rawhide/man1/systemd-cryptenroll.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-CRYPTENROLL" "1" "" "systemd 255" "systemd-cryptenroll" +.TH "SYSTEMD\-CRYPTENROLL" "1" "" "systemd 256~rc3" "systemd-cryptenroll" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -37,7 +37,7 @@ is a tool for enrolling hardware security tokens and devices into a LUKS2 encryp .sp -1 .IP " 1." 4.2 .\} -PKCS#11 security tokens and smartcards that may carry an RSA key pair (e\&.g\&. various YubiKeys) +PKCS#11 security tokens and smartcards that may carry an RSA or EC key pair (e\&.g\&. various YubiKeys) .RE .sp .RS 4 @@ -89,6 +89,13 @@ Recovery keys\&. These are similar to regular passphrases, however are randomly In addition, the tool may be used to enumerate currently enrolled security tokens and wipe a subset of them\&. The latter may be combined with the enrollment operation of a new security token, in order to update or replace enrollments\&. .PP The tool supports only LUKS2 volumes, as it stores token meta\-information in the LUKS2 JSON token area, which is not available in other encryption formats\&. +.PP +\fBsystemd\-cryptsetup\fR +operates on the device backing +/var/ +if no device is specified explicitly, and no wipe operation is requested\&. (Note that in the typical case where +/var/ +is on the same file system as the root file system, this hence enrolls a key into the backing device of the root file system\&.) .SS "TPM2 PCRs and policies" .PP PCRs allow binding of the encryption of secrets to specific software versions and system state, so that the enrolled key is only accessible (may be "unsealed") if specific trusted software and/or configuration is used\&. Such bindings may be created with the option @@ -257,10 +264,10 @@ In general, encrypted volumes would be bound to some combination of PCRs 7, 11, for more discussion\&. .SH "LIMITATIONS" .PP -Note that currently when enrolling a new key of one of the five supported types listed above, it is required to first provide a passphrase, a recovery key or a FIDO2 token\&. It\*(Aqs currently not supported to unlock a device with a TPM2/PKCS#11 key in order to enroll a new TPM2/PKCS#11 key\&. Thus, if in future key roll\-over is desired it\*(Aqs generally recommended to ensure a passphrase, a recovery key or a FIDO2 token is always enrolled\&. +Note that currently when enrolling a new key of one of the five supported types listed above, it is required to first provide a passphrase, a recovery key, a FIDO2 token, or a TPM2 key\&. It\*(Aqs currently not supported to unlock a device with a PKCS#11 key in order to enroll a new PKCS#11 key\&. Thus, if in future key roll\-over is desired it\*(Aqs generally recommended to ensure a passphrase, a recovery key, a FIDO2 token, or a TPM2 key is always enrolled\&. .PP Also note that support for enrolling multiple FIDO2 tokens is currently limited\&. When multiple FIDO2 tokens are enrolled, -\fBsystemd\-cryptseup\fR +\fBsystemd\-cryptsetup\fR will perform pre\-flight requests to attempt to identify which of the enrolled tokens are currently plugged in\&. However, this is not possible for FIDO2 tokens with user verification (UV, usually via biometrics), in which case it will fall back to attempting each enrolled token one by one\&. This will result in multiple prompts for PIN and user verification\&. This limitation does not apply to PKCS#11 tokens\&. .SH "COMPATIBILITY" .PP @@ -319,7 +326,7 @@ Enroll a recovery key\&. Recovery keys are mostly identical to passphrases, but Added in version 248\&. .RE .PP -\fB\-\-unlock\-key\-file=\fR\fIPATH\fR +\fB\-\-unlock\-key\-file=\fR\fB\fIPATH\fR\fR .RS 4 Use a file instead of a password/passphrase read from stdin to unlock the volume\&. Expects the PATH to the file containing your key to unlock the volume\&. Currently there is nothing like \fB\-\-key\-file\-offset=\fR @@ -330,7 +337,7 @@ so this file has to only contain the full key\&. Added in version 252\&. .RE .PP -\fB\-\-unlock\-fido2\-device=\fR\fIPATH\fR +\fB\-\-unlock\-fido2\-device=\fR\fB\fIPATH\fR\fR .RS 4 Use a FIDO2 device instead of a password/passphrase read from stdin to unlock the volume\&. Expects a hidraw @@ -344,13 +351,25 @@ option is also specified\&. Added in version 253\&. .RE .PP -\fB\-\-pkcs11\-token\-uri=\fR\fIURI\fR +\fB\-\-unlock\-tpm2\-device=\fR\fB\fIPATH\fR\fR +.RS 4 +Use a TPM2 device instead of a password/passhprase read from stdin to unlock the volume\&. Expects a device node path referring to the TPM2 chip (e\&.g\&. +/dev/tpmrm0)\&. Alternatively the special value +"auto" +may be specified, in order to automatically determine the device node of a currently discovered TPM2 device (of which there must be exactly one)\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-pkcs11\-token\-uri=\fR\fB\fIURI\fR\fR .RS 4 -Enroll a PKCS#11 security token or smartcard (e\&.g\&. a YubiKey)\&. Expects a PKCS#11 smartcard URI referring to the token\&. Alternatively the special value +Enroll a PKCS#11 security token or smartcard (e\&.g\&. a YubiKey)\&. Expects a PKCS#11 URI that allows finding an X\&.509 certificate or a public key on the token\&. The URI must also be suitable to find a related private key after changing the type of object in it\&. Alternatively the special value "auto" -may be specified, in order to automatically determine the URI of a currently plugged in security token (of which there must be exactly one)\&. The special value +may be specified, in order to automatically determine the suitable URI if a single security token containing a single key pair is plugged in\&. The special value "list" -may be used to enumerate all suitable PKCS#11 tokens currently plugged in\&. The security token must contain an RSA key pair which is used to encrypt the randomly generated key that is used to unlock the LUKS2 volume\&. The encrypted key is then stored in the LUKS2 JSON token header area\&. +may be used to enumerate all suitable PKCS#11 tokens currently plugged in\&. +.sp +The PKCS#11 token must contain an RSA or EC key pair which will be used to unlock a LUKS2 volume\&. For RSA, a randomly generated volume key is encrypted with a public key in the token, and stored in the LUKS2 JSON token header area\&. To unlock a volume, the stored encrypted volume key will be decrypted with a private key in the token\&. For ECC, ECDH algorithm is used: we generate a pair of EC keys in the same EC group, then derive a shared secret using the generated private key and the public key in the token\&. The derived shared secret is used as a volume key\&. The generated public key is stored in the LUKS2 JSON token header area\&. The generated private key is erased\&. To unlock a volume, we derive the shared secret with the stored public key and a private key in the token\&. .sp In order to unlock a LUKS2 volume with an enrolled PKCS#11 security token, specify the \fBpkcs11\-uri=\fR @@ -379,7 +398,7 @@ line\&. Added in version 248\&. .RE .PP -\fB\-\-fido2\-credential\-algorithm=\fR\fISTRING\fR +\fB\-\-fido2\-credential\-algorithm=\fR\fB\fISTRING\fR\fR .RS 4 Specify COSE algorithm used in credential generation\&. The default value is "es256"\&. Supported values are @@ -395,12 +414,12 @@ denotes 2048\-bit RSA with PKCS#1\&.5 padding and SHA\-256\&. "eddsa" denotes EDDSA over Curve25519 with SHA\-512\&. .sp -Note that your authenticator may not support some algorithms\&. +Note that your authenticator may choose not to support some algorithms\&. .sp Added in version 251\&. .RE .PP -\fB\-\-fido2\-device=\fR\fIPATH\fR +\fB\-\-fido2\-device=\fR\fB\fIPATH\fR\fR .RS 4 Enroll a FIDO2 security token that implements the "hmac\-secret" @@ -442,7 +461,7 @@ line\&. Added in version 248\&. .RE .PP -\fB\-\-fido2\-with\-client\-pin=\fR\fIBOOL\fR +\fB\-\-fido2\-with\-client\-pin=\fR\fB\fIBOOL\fR\fR .RS 4 When enrolling a FIDO2 security token, controls whether to require the user to enter a PIN when unlocking the volume (the FIDO2 "clientPin" @@ -454,7 +473,7 @@ feature at all, or does not allow enabling or disabling it\&.) Added in version 249\&. .RE .PP -\fB\-\-fido2\-with\-user\-presence=\fR\fIBOOL\fR +\fB\-\-fido2\-with\-user\-presence=\fR\fB\fIBOOL\fR\fR .RS 4 When enrolling a FIDO2 security token, controls whether to require the user to verify presence (tap the token, the FIDO2 "up" @@ -466,7 +485,7 @@ feature at all, or does not allow enabling or disabling it\&.) Added in version 249\&. .RE .PP -\fB\-\-fido2\-with\-user\-verification=\fR\fIBOOL\fR +\fB\-\-fido2\-with\-user\-verification=\fR\fB\fIBOOL\fR\fR .RS 4 When enrolling a FIDO2 security token, controls whether to require user verification when unlocking the volume (the FIDO2 "uv" @@ -478,7 +497,7 @@ feature at all, or does not allow enabling or disabling it\&.) Added in version 249\&. .RE .PP -\fB\-\-tpm2\-device=\fR\fIPATH\fR +\fB\-\-tpm2\-device=\fR\fB\fIPATH\fR\fR .RS 4 Enroll a TPM2 security chip\&. Expects a device node path referring to the TPM2 chip (e\&.g\&. /dev/tpmrm0)\&. Alternatively the special value @@ -518,7 +537,7 @@ Use Added in version 248\&. .RE .PP -\fB\-\-tpm2\-device\-key=\fR\fIPATH\fR +\fB\-\-tpm2\-device\-key=\fR\fB\fIPATH\fR\fR .RS 4 Enroll a TPM2 security chip using its public key\&. Expects a path referring to the TPM2 public key in TPM2B_PUBLIC format\&. This cannot be used with \fB\-\-tpm2\-device=\fR, as it performs the same operation, but without connecting to the TPM2 security chip; instead the enrollment is calculated using the provided TPM2 key\&. This is useful in situations where the TPM2 security chip is not available at the time of enrollment\&. @@ -551,7 +570,7 @@ systemd\-analyze srk > srk\&.tpm2b_public Added in version 255\&. .RE .PP -\fB\-\-tpm2\-seal\-key\-handle=\fR\fIHANDLE\fR +\fB\-\-tpm2\-seal\-key\-handle=\fR\fB\fIHANDLE\fR\fR .RS 4 Configures which parent key to use for sealing, using the TPM handle (index) of the key\&. This is used to "seal" (encrypt) a secret and must be used later to "unseal" (decrypt) the secret\&. Expects a hexadecimal 32bit integer, optionally prefixed with "0x"\&. Allowable values are any handle index in the persistent ("0x81000000"\-"0x81ffffff") or transient ("0x80000000"\-"0x80ffffff") ranges\&. Since transient handles are lost after a TPM reset, and may be flushed during TPM context switching, they should not be used except for very specific use cases, e\&.g\&. testing\&. @@ -564,7 +583,7 @@ This should not be changed unless you know what you are doing\&. Added in version 255\&. .RE .PP -\fB\-\-tpm2\-pcrs=\fR [PCR...] +\fB\-\-tpm2\-pcrs=\fR\fB\fIPCR\fR\fI[+PCR\&.\&.\&.]\fR\fR .RS 4 Configures the TPM2 PCRs (Platform Configuration Registers) to bind to when enrollment is requested via \fB\-\-tpm2\-device=\fR\&. Takes a list of PCR entries, where each entry starts with a name or numeric index in the range 0\&...23, optionally followed by @@ -589,7 +608,7 @@ specifies that PCR register 4 from the SHA1 bank should be used, and a hash dige Added in version 248\&. .RE .PP -\fB\-\-tpm2\-with\-pin=\fR\fIBOOL\fR +\fB\-\-tpm2\-with\-pin=\fR\fB\fIBOOL\fR\fR .RS 4 When enrolling a TPM2 device, controls whether to require the user to enter a PIN when unlocking the volume in addition to PCR binding, based on TPM2 policy authentication\&. Defaults to "no"\&. Despite being called PIN, any character can be used, not just numbers\&. @@ -605,7 +624,7 @@ commands, respectively\&. Added in version 251\&. .RE .PP -\fB\-\-tpm2\-public\-key=\fR [PATH], \fB\-\-tpm2\-public\-key\-pcrs=\fR [PCR...], \fB\-\-tpm2\-signature=\fR [PATH] +\fB\-\-tpm2\-public\-key=\fR\fB\fIPATH\fR\fR, \fB\-\-tpm2\-public\-key\-pcrs=\fR\fB\fIPCR\fR\fI[+PCR\&.\&.\&.]\fR\fR, \fB\-\-tpm2\-signature=\fR\fB\fIPATH\fR\fR .RS 4 Configures a TPM2 signed PCR policy to bind encryption to\&. The \fB\-\-tpm2\-public\-key=\fR @@ -643,7 +662,7 @@ is searched for in 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\&. Expects a path to a pcrlock policy file as generated by the \fBsystemd-pcrlock\fR(1) @@ -658,7 +677,7 @@ it is automatically used\&. Assign an empty string to turn this behaviour off\&. Added in version 255\&. .RE .PP -\fB\-\-wipe\-slot=\fR [SLOT...] +\fB\-\-wipe\-slot=\fR\fB\fISLOT\fR\fI[,SLOT\&.\&.\&.]\fR\fR .RS 4 Wipes one or more LUKS2 key slots\&. Takes a comma separated list of numeric slot indexes, or the special strings "all" @@ -724,6 +743,42 @@ Print a short help text and exit\&. .RS 4 Print a short version string and exit\&. .RE +.SH "CREDENTIALS" +.PP +\fBsystemd\-cryptenroll\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 +\fIcryptenroll\&.passphrase\fR, \fIcryptenroll\&.new\-passphrase\fR +.RS 4 +May contain the passphrase to unlock the volume with/to newly enroll\&. +.sp +Added in version 256\&. +.RE +.PP +\fIcryptenroll\&.tpm2\-pin\fR, \fIcryptenroll\&.new\-tpm2\-pin\fR +.RS 4 +May contain the TPM2 PIN to unlock the volume with/to newly enroll\&. +.sp +Added in version 256\&. +.RE +.PP +\fIcryptenroll\&.fido2\-pin\fR +.RS 4 +If a FIDO2 token is enrolled this may contain the PIN of the token\&. +.sp +Added in version 256\&. +.RE +.PP +\fIcryptenroll\&.pkcs11\-pin\fR +.RS 4 +If a PKCS#11 token is enrolled this may contain the PIN of the token\&. +.sp +Added in version 256\&. +.RE .SH "EXIT STATUS" .PP On success, 0 is returned, a non\-zero failure code otherwise\&. @@ -736,11 +791,7 @@ contain various examples employing \fBsystemd\-cryptenroll\fR\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-cryptsetup@.service\fR(8), -\fBcrypttab\fR(5), -\fBcryptsetup\fR(8), -\fBsystemd-measure\fR(1) +\fBsystemd\fR(1), \fBsystemd-cryptsetup@.service\fR(8), \fBcrypttab\fR(5), \fBcryptsetup\fR(8), \fBsystemd-measure\fR(1) .SH "NOTES" .IP " 1." 4 Linux TPM PCR Registry diff --git a/upstream/fedora-rawhide/man1/systemd-delta.1 b/upstream/fedora-rawhide/man1/systemd-delta.1 index d874587b..7462100b 100644 --- a/upstream/fedora-rawhide/man1/systemd-delta.1 +++ b/upstream/fedora-rawhide/man1/systemd-delta.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-DELTA" "1" "" "systemd 255" "systemd-delta" +.TH "SYSTEMD\-DELTA" "1" "" "systemd 256~rc3" "systemd-delta" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,7 +23,7 @@ systemd-delta \- Find overridden configuration files .SH "SYNOPSIS" .HP \w'\fBsystemd\-delta\fR\ 'u -\fBsystemd\-delta\fR [OPTIONS...] [\fIPREFIX\fR[/\fISUFFIX\fR]|\fISUFFIX\fR...] +\fBsystemd\-delta\fR [OPTIONS...] [\fIPREFIX\fR | \fIPREFIX\fR/\fISUFFIX\fR | \fISUFFIX\fR...] .SH "DESCRIPTION" .PP \fBsystemd\-delta\fR @@ -165,5 +165,4 @@ systemd\-delta \-\-type=extended /run/systemd/system On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.unit\fR(5) +\fBsystemd\fR(1), \fBsystemd.unit\fR(5) diff --git a/upstream/fedora-rawhide/man1/systemd-detect-virt.1 b/upstream/fedora-rawhide/man1/systemd-detect-virt.1 index 1a0b04e5..6320ba51 100644 --- a/upstream/fedora-rawhide/man1/systemd-detect-virt.1 +++ b/upstream/fedora-rawhide/man1/systemd-detect-virt.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-DETECT\-VIRT" "1" "" "systemd 255" "systemd-detect-virt" +.TH "SYSTEMD\-DETECT\-VIRT" "1" "" "systemd 256~rc3" "systemd-detect-virt" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -311,10 +311,7 @@ Print a short version string and exit\&. If a virtualization technology is detected, 0 is returned, a non\-zero code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-nspawn\fR(1), -\fBchroot\fR(2), -\fBnamespaces\fR(7) +\fBsystemd\fR(1), \fBsystemd-nspawn\fR(1), \fBchroot\fR(2), \fBnamespaces\fR(7) .SH "NOTES" .IP " 1." 4 ACRN hypervisor diff --git a/upstream/fedora-rawhide/man1/systemd-dissect.1 b/upstream/fedora-rawhide/man1/systemd-dissect.1 index 994c72a0..c8b6a286 100644 --- a/upstream/fedora-rawhide/man1/systemd-dissect.1 +++ b/upstream/fedora-rawhide/man1/systemd-dissect.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-DISSECT" "1" "" "systemd 255" "systemd-dissect" +.TH "SYSTEMD\-DISSECT" "1" "" "systemd 256~rc3" "systemd-dissect" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -22,30 +22,32 @@ .SH "NAME" systemd-dissect, mount.ddi \- Dissect Discoverable Disk Images (DDIs) .SH "SYNOPSIS" -.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u -\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fIIMAGE\fR\fR -.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-mount\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\fB\ \fR\fB\fIPATH\fR\fR\ 'u -\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-mount\fR\fR\fB \fR\fB\fIIMAGE\fR\fR\fB \fR\fB\fIPATH\fR\fR -.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-umount\fR\fR\fB\ \fR\fB\fIPATH\fR\fR\ 'u -\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-umount\fR\fR\fB \fR\fB\fIPATH\fR\fR -.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-attach\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u -\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-attach\fR\fR\fB \fR\fB\fIIMAGE\fR\fR -.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-detach\fR\fR\fB\ \fR\fB\fIPATH\fR\fR\ 'u -\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-detach\fR\fR\fB \fR\fB\fIPATH\fR\fR -.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-list\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u -\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-list\fR\fR\fB \fR\fB\fIIMAGE\fR\fR -.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-mtree\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u -\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-mtree\fR\fR\fB \fR\fB\fIIMAGE\fR\fR -.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-with\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\fB\ \fR\fB[\fICOMMAND\fR...]\fR\ 'u -\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-with\fR\fR\fB \fR\fB\fIIMAGE\fR\fR\fB \fR\fB[\fICOMMAND\fR...]\fR -.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-copy\-from\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\fB\ \fR\fB\fIPATH\fR\fR\fB\ \fR\fB[\fITARGET\fR]\fR\ 'u -\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-copy\-from\fR\fR\fB \fR\fB\fIIMAGE\fR\fR\fB \fR\fB\fIPATH\fR\fR\fB \fR\fB[\fITARGET\fR]\fR -.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-copy\-to\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\fB\ \fR\fB[\fISOURCE\fR]\fR\fB\ \fR\fB\fIPATH\fR\fR\ 'u -\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-copy\-to\fR\fR\fB \fR\fB\fIIMAGE\fR\fR\fB \fR\fB[\fISOURCE\fR]\fR\fB \fR\fB\fIPATH\fR\fR -.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-discover\fR\fR\ 'u -\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-discover\fR\fR -.HP \w'\fBsystemd\-dissect\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB\fB\-\-validate\fR\fR\fB\ \fR\fB\fIIMAGE\fR\fR\ 'u -\fBsystemd\-dissect \fR\fB[OPTIONS...]\fR\fB \fR\fB\fB\-\-validate\fR\fR\fB \fR\fB\fIIMAGE\fR\fR +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] \fIIMAGE\fR +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] [\-\-mount] \fIIMAGE\fR \fIPATH\fR +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] [\-\-umount] \fIPATH\fR +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] [\-\-attach] \fIIMAGE\fR +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] [\-\-detach] \fIPATH\fR +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] [\-\-list] \fIIMAGE\fR +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] [\-\-mtree] \fIIMAGE\fR +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] [\-\-with] \fIIMAGE\fR [\fICOMMAND\fR...] +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] [\-\-copy\-from] \fIIMAGE\fR \fIPATH\fR [\fITARGET\fR] +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] [\-\-copy\-to] \fIIMAGE\fR [\fISOURCE\fR] \fIPATH\fR +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] [\-\-make\-archive] \fIIMAGE\fR [\fITARGET\fR] +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] [\-\-discover] +.HP \w'\fBsystemd\-dissect\fR\ 'u +\fBsystemd\-dissect\fR [OPTIONS...] [\-\-validate] \fIIMAGE\fR .SH "DESCRIPTION" .PP \fBsystemd\-dissect\fR @@ -158,6 +160,12 @@ can be mounted directly by \fBmount\fR and \fBfstab\fR(5)\&. For details see below\&. +.PP +In place of the image path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. .SH "COMMANDS" .PP If neither of the command switches listed below are passed the specified disk image is opened and general information about the image and the contained partitions and their use is shown\&. @@ -282,6 +290,17 @@ file system checks are implicitly run before the copy operation begins\&. Added in version 247\&. .RE .PP +\fB\-\-make\-archive\fR +.RS 4 +Generates an archive file from the specified disk image\&. Expects two arguments: the path to the disk image and optionally the output archive file path\&. If the latter is omitted the archive is written to standard output\&. The archive file format is determined automatically from the specified output archive file name, e\&.g\&. any path suffixed with +"\&.tar\&.xz" +will result in an xz compressed UNIX tarball (if the path is omitted an uncompressed UNIX tarball is created)\&. See +\fBlibarchive\fR(3) +for a list of supported archive formats and compression schemes\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-\-discover\fR .RS 4 Show a list of DDIs in well\-known directories\&. This will show machine, portable service and system/configuration extension disk images in the usual directories @@ -525,7 +544,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" @@ -601,7 +620,7 @@ map to the corresponding options listed above (i\&.e\&. generically passed on to the file systems inside the images\&. .SH "EXAMPLES" .PP -\fBExample\ \&1.\ \&Generate a tarball from an OS disk image\fR +\fBExample\ \&1.\ \&Generate a tarball from an OS disk image (\-\-with)\fR .sp .if n \{\ .RS 4 @@ -612,15 +631,23 @@ generically passed on to the file systems inside the images\&. .if n \{\ .RE .\} +.PP +or alternatively just: +.PP +\fBExample\ \&2.\ \&Generate a tarball from an OS disk image (\-\-make\-archive)\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +# systemd\-dissect \-\-make\-archive foo\&.raw foo\&.tar\&.gz +.fi +.if n \{\ +.RE +.\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-nspawn\fR(1), -\fBsystemd.exec\fR(5), -\m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2, -\fBmount\fR(8), -\fBumount\fR(8), -\fBfdisk\fR(8) +\fBsystemd\fR(1), \fBsystemd-nspawn\fR(1), \fBsystemd.exec\fR(5), \fBsystemd.v\fR(7), \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2, \fBmount\fR(8), \fBumount\fR(8), \fBfdisk\fR(8) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man1/systemd-escape.1 b/upstream/fedora-rawhide/man1/systemd-escape.1 index a69c2c8d..203a8b5d 100644 --- a/upstream/fedora-rawhide/man1/systemd-escape.1 +++ b/upstream/fedora-rawhide/man1/systemd-escape.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-ESCAPE" "1" "" "systemd 255" "systemd-escape" +.TH "SYSTEMD\-ESCAPE" "1" "" "systemd 256~rc3" "systemd-escape" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -218,6 +218,4 @@ My Container 1 On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemctl\fR(1) +\fBsystemd\fR(1), \fBsystemd.unit\fR(5), \fBsystemctl\fR(1) diff --git a/upstream/fedora-rawhide/man1/systemd-firstboot.1 b/upstream/fedora-rawhide/man1/systemd-firstboot.1 index 2b65a8ad..38848a53 100644 --- a/upstream/fedora-rawhide/man1/systemd-firstboot.1 +++ b/upstream/fedora-rawhide/man1/systemd-firstboot.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-FIRSTBOOT" "1" "" "systemd 255" "systemd-firstboot" +.TH "SYSTEMD\-FIRSTBOOT" "1" "" "systemd 256~rc3" "systemd-firstboot" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -28,14 +28,27 @@ systemd-firstboot, systemd-firstboot.service \- Initialize basic system settings systemd\-firstboot\&.service .SH "DESCRIPTION" .PP -\fBsystemd\-firstboot\fR -initializes basic system settings interactively during the first boot, or non\-interactively on an offline system image\&. The service is started during boot if +The +\fBsystemd\-firstboot\&.service\fR +unit is one of the units which are used to initialize the machine configuration during "First Boot", i\&.e\&. when the system is freshly installed or after a factory reset\&. The +\fBsystemd\fR(1) +manager itself will initialize +\fBmachine-id\fR(5) +and preset all units, enabling or disabling them according to the +\fBsystemd.preset\fR(5) +settings\&. +systemd\-firstboot\&.service +is started later to interactively initialize basic system configuration\&. It is started only if \fIConditionFirstBoot=yes\fR is met, which essentially means that /etc/ is unpopulated, see \fBsystemd.unit\fR(5) -for details\&. +for details\&. System credentials may be used to inject configuration; those settings are not queried interactively\&. +.PP +The +\fBsystemd\-firstboot\fR +command can also be used to non\-interactively initialize an offline system image\&. .PP The following settings may be configured: .sp @@ -440,7 +453,7 @@ like this: .RE .\} .PP -Note that these credentials are only read and applied during the first boot process\&. Once they are applied they remain applied for subsequent boots, and the credentials are not considered anymore\&. +Note that these credentials are only read and applied during the first boot\&. Once they are applied they remain applied for subsequent boots, and the credentials are not considered anymore\&. .SH "EXIT STATUS" .PP On success, 0 is returned, a non\-zero failure code otherwise\&. @@ -456,17 +469,7 @@ Added in version 233\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBlocale.conf\fR(5), -\fBvconsole.conf\fR(5), -\fBlocaltime\fR(5), -\fBhostname\fR(5), -\fBmachine-id\fR(5), -\fBshadow\fR(5), -\fBsystemd-machine-id-setup\fR(1), -\fBlocalectl\fR(1), -\fBtimedatectl\fR(1), -\fBhostnamectl\fR(1) +\fBsystemd\fR(1), \fBlocale.conf\fR(5), \fBvconsole.conf\fR(5), \fBlocaltime\fR(5), \fBhostname\fR(5), \fBmachine-id\fR(5), \fBshadow\fR(5), \fBsystemd-machine-id-setup\fR(1), \fBlocalectl\fR(1), \fBtimedatectl\fR(1), \fBhostnamectl\fR(1) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man1/systemd-id128.1 b/upstream/fedora-rawhide/man1/systemd-id128.1 index 79d82b32..478b37cd 100644 --- a/upstream/fedora-rawhide/man1/systemd-id128.1 +++ b/upstream/fedora-rawhide/man1/systemd-id128.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-ID128" "1" "" "systemd 255" "systemd-id128" +.TH "SYSTEMD\-ID128" "1" "" "systemd 256~rc3" "systemd-id128" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -111,6 +111,36 @@ for more discussion\&. Added in version 244\&. .RE .PP +\fB\-\-no\-pager\fR +.RS 4 +Do not pipe output into a pager\&. +.RE +.PP +\fB\-\-no\-legend\fR +.RS 4 +Do not print the legend, i\&.e\&. column headers and the footer with hints\&. +.RE +.PP +\fB\-\-json=\fR\fB\fIMODE\fR\fR +.RS 4 +Shows output formatted as JSON\&. Expects one of +"short" +(for the shortest possible output without any redundant whitespace or line breaks), +"pretty" +(for a pretty version of the same, with indentation and line breaks) or +"off" +(to turn off JSON output, the default)\&. +.RE +.PP +\fB\-j\fR +.RS 4 +Equivalent to +\fB\-\-json=pretty\fR +if running on a terminal, and +\fB\-\-json=short\fR +otherwise\&. +.RE +.PP \fB\-h\fR, \fB\-\-help\fR .RS 4 Print a short help text and exit\&. @@ -174,9 +204,7 @@ On a given machine with the ID 3a9d668b\-4db7\-4939\-8a4a\-5e78a03bffb7, for the \fBshow\fR\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-id128\fR(3), -\fBsd_id128_get_machine\fR(3) +\fBsystemd\fR(1), \fBsd-id128\fR(3), \fBsd_id128_get_machine\fR(3) .SH "NOTES" .IP " 1." 4 Universally Unique Identifiers diff --git a/upstream/fedora-rawhide/man1/systemd-inhibit.1 b/upstream/fedora-rawhide/man1/systemd-inhibit.1 index 19950530..c099bce0 100644 --- a/upstream/fedora-rawhide/man1/systemd-inhibit.1 +++ b/upstream/fedora-rawhide/man1/systemd-inhibit.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-INHIBIT" "1" "" "systemd 255" "systemd-inhibit" +.TH "SYSTEMD\-INHIBIT" "1" "" "systemd 256~rc3" "systemd-inhibit" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -22,10 +22,10 @@ .SH "NAME" systemd-inhibit \- Execute a program with an inhibition lock taken .SH "SYNOPSIS" -.HP \w'\fBsystemd\-inhibit\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB[COMMAND]\fR\fB\ \fR\fB[ARGUMENTS...]\fR\ 'u -\fBsystemd\-inhibit \fR\fB[OPTIONS...]\fR\fB \fR\fB[COMMAND]\fR\fB \fR\fB[ARGUMENTS...]\fR -.HP \w'\fBsystemd\-inhibit\ \fR\fB[OPTIONS...]\fR\fB\ \-\-list\fR\ 'u -\fBsystemd\-inhibit \fR\fB[OPTIONS...]\fR\fB \-\-list\fR +.HP \w'\fBsystemd\-inhibit\fR\ 'u +\fBsystemd\-inhibit\fR [OPTIONS...] [COMMAND] [ARGUMENTS...] +.HP \w'\fBsystemd\-inhibit\fR\ 'u +\fBsystemd\-inhibit\fR [OPTIONS...] [\-\-list] .SH "DESCRIPTION" .PP \fBsystemd\-inhibit\fR @@ -128,7 +128,7 @@ on a CD using .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, @@ -138,7 +138,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 @@ -257,6 +265,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\&. @@ -268,6 +282,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 @@ -323,8 +343,7 @@ and other conditions\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBlogind.conf\fR(5) +\fBsystemd\fR(1), \fBlogind.conf\fR(5) .SH "NOTES" .IP " 1." 4 Inhibitor Lock Developer Documentation diff --git a/upstream/fedora-rawhide/man1/systemd-machine-id-setup.1 b/upstream/fedora-rawhide/man1/systemd-machine-id-setup.1 index 4dbbe6f3..74a60875 100644 --- a/upstream/fedora-rawhide/man1/systemd-machine-id-setup.1 +++ b/upstream/fedora-rawhide/man1/systemd-machine-id-setup.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-MACHINE\-ID\-SETUP" "1" "" "systemd 255" "systemd-machine-id-setup" +.TH "SYSTEMD\-MACHINE\-ID\-SETUP" "1" "" "systemd 256~rc3" "systemd-machine-id-setup" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -172,11 +172,7 @@ 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), -\fBmachine-id\fR(5), -\fBsystemd-machine-id-commit.service\fR(8), -\fBdbus-uuidgen\fR(1), -\fBsystemd-firstboot\fR(1) +\fBsystemd\fR(1), \fBmachine-id\fR(5), \fBsystemd-machine-id-commit.service\fR(8), \fBdbus-uuidgen\fR(1), \fBsystemd-firstboot\fR(1) .SH "NOTES" .IP " 1." 4 Container Interface diff --git a/upstream/fedora-rawhide/man1/systemd-measure.1 b/upstream/fedora-rawhide/man1/systemd-measure.1 index cbb356f3..9599e6b8 100644 --- a/upstream/fedora-rawhide/man1/systemd-measure.1 +++ b/upstream/fedora-rawhide/man1/systemd-measure.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-MEASURE" "1" "" "systemd 255" "systemd-measure" +.TH "SYSTEMD\-MEASURE" "1" "" "systemd 256~rc3" "systemd-measure" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -22,8 +22,8 @@ .SH "NAME" systemd-measure \- Pre\-calculate and sign expected TPM2 PCR values for booted unified kernel images .SH "SYNOPSIS" -.HP \w'\fB/usr/lib/systemd/systemd\-measure\ \fR\fB[OPTIONS...]\fR\ 'u -\fB/usr/lib/systemd/systemd\-measure \fR\fB[OPTIONS...]\fR +.HP \w'\fB/usr/lib/systemd/systemd\-measure\fR\ 'u +\fB/usr/lib/systemd/systemd\-measure\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\&. @@ -64,6 +64,7 @@ Pre\-calculate the expected values seen in PCR register 11 after boot\-up of a u \fB\-\-osrel=\fR, \fB\-\-cmdline=\fR, \fB\-\-initrd=\fR, +\fB\-\-ucode=\fR, \fB\-\-splash=\fR, \fB\-\-dtb=\fR, \fB\-\-uname=\fR, @@ -99,7 +100,7 @@ Added in version 252\&. .PP The following options are understood: .PP -\fB\-\-linux=\fR\fB\fIPATH\fR\fR, \fB\-\-osrel=\fR\fB\fIPATH\fR\fR, \fB\-\-cmdline=\fR\fB\fIPATH\fR\fR, \fB\-\-initrd=\fR\fB\fIPATH\fR\fR, \fB\-\-splash=\fR\fB\fIPATH\fR\fR, \fB\-\-dtb=\fR\fB\fIPATH\fR\fR, \fB\-\-uname=\fR\fB\fIPATH\fR\fR, \fB\-\-sbat=\fR\fB\fIPATH\fR\fR, \fB\-\-pcrpkey=\fR\fB\fIPATH\fR\fR +\fB\-\-linux=\fR\fB\fIPATH\fR\fR, \fB\-\-osrel=\fR\fB\fIPATH\fR\fR, \fB\-\-cmdline=\fR\fB\fIPATH\fR\fR, \fB\-\-initrd=\fR\fB\fIPATH\fR\fR, \fB\-\-ucode=\fR\fB\fIPATH\fR\fR, \fB\-\-splash=\fR\fB\fIPATH\fR\fR, \fB\-\-dtb=\fR\fB\fIPATH\fR\fR, \fB\-\-uname=\fR\fB\fIPATH\fR\fR, \fB\-\-sbat=\fR\fB\fIPATH\fR\fR, \fB\-\-pcrpkey=\fR\fB\fIPATH\fR\fR .RS 4 When used with the \fBcalculate\fR @@ -144,7 +145,7 @@ output\&. May be used more then once to specify multiple banks\&. If not specifi Added in version 252\&. .RE .PP -\fB\-\-private\-key=\fR\fB\fIPATH\fR\fR, \fB\-\-public\-key=\fR\fB\fIPATH\fR\fR +\fB\-\-private\-key=\fR\fB\fIPATH\fR\fR, \fB\-\-public\-key=\fR\fB\fIPATH\fR\fR, \fB\-\-certificate=\fR\fB\fIPATH\fR\fR .RS 4 These switches take paths to a pair of PEM encoded RSA key files, for use with the \fBsign\fR @@ -164,10 +165,28 @@ is not specified but \fB\-\-private\-key=\fR is specified the public key is automatically derived from the private key\&. .sp +\fB\-\-certificate=\fR +can be used to specify an X\&.509 certificate as an alternative to +\fB\-\-public\-key=\fR +since v256\&. +.sp Added in version 252\&. .RE .PP -\fB\-\-tpm2\-device=\fR\fIPATH\fR +\fB\-\-private\-key=\fR\fB\fIPATH/URI\fR\fR, \fB\-\-private\-key\-source=\fR\fB\fITYPE[:NAME]\fR\fR, \fB\-\-certificate=\fR\fB\fIPATH\fR\fR +.RS 4 +As an alternative to +\fB\-\-public\-key=\fR +for the +\fBsign\fR +command, these switches can be used to sign with an hardware token\&. The private key option can take a path or a URI that will be passed to the OpenSSL engine or provider, as specified by +\fB\-\-private\-key\-source=\fR +as a type:name tuple, such as engine:pkcs11\&. The specified OpenSSL signing engine or provider will be used to sign\&. +.sp +Added in version 256\&. +.RE +.PP +\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 @@ -179,7 +198,7 @@ may be used to enumerate all suitable TPM2 devices currently discovered\&. Added in version 252\&. .RE .PP -\fB\-\-phase=\fR\fIPHASE\fR +\fB\-\-phase=\fR\fB\fIPHASE\fR\fR .RS 4 Controls which boot phases to calculate expected PCR 11 values for\&. This takes a series of colon\-separated strings that encode boot "paths" for entering a specific phase of the boot process\&. Each of the specified strings is measured by the systemd\-pcrphase\-initrd\&.service, @@ -200,7 +219,7 @@ For further details about PCR boot phases, see Added in version 252\&. .RE .PP -\fB\-\-append=\fR\fIPATH\fR +\fB\-\-append=\fR\fB\fIPATH\fR\fR .RS 4 When generating a PCR JSON signature (via the \fBsign\fR @@ -209,7 +228,7 @@ command), combine it with a previously generated PCR JSON signature, and output Added in version 253\&. .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" @@ -415,12 +434,7 @@ on the command line of those tools\&. On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-stub\fR(7), -\fBukify\fR(1), -\fBsystemd-creds\fR(1), -\fBsystemd-cryptsetup@.service\fR(8), -\fBsystemd-pcrphase.service\fR(8) +\fBsystemd\fR(1), \fBsystemd-stub\fR(7), \fBukify\fR(1), \fBsystemd-creds\fR(1), \fBsystemd-cryptsetup@.service\fR(8), \fBsystemd-pcrphase.service\fR(8) .SH "NOTES" .IP " 1." 4 Unified Kernel Image (UKI) diff --git a/upstream/fedora-rawhide/man1/systemd-mount.1 b/upstream/fedora-rawhide/man1/systemd-mount.1 index 22f5c0be..42952e5f 100644 --- a/upstream/fedora-rawhide/man1/systemd-mount.1 +++ b/upstream/fedora-rawhide/man1/systemd-mount.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-MOUNT" "1" "" "systemd 255" "systemd-mount" +.TH "SYSTEMD\-MOUNT" "1" "" "systemd 256~rc3" "systemd-mount" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -396,10 +396,4 @@ ACTION=="add", SUBSYSTEMS=="usb", SUBSYSTEM=="block", ENV{ID_FS_USAGE}=="filesys .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBmount\fR(8), -\fBsystemctl\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemd.mount\fR(5), -\fBsystemd.automount\fR(5), -\fBsystemd-run\fR(1) +\fBsystemd\fR(1), \fBmount\fR(8), \fBsystemctl\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.mount\fR(5), \fBsystemd.automount\fR(5), \fBsystemd-run\fR(1) diff --git a/upstream/fedora-rawhide/man1/systemd-notify.1 b/upstream/fedora-rawhide/man1/systemd-notify.1 index a8f251e3..3d3a13a9 100644 --- a/upstream/fedora-rawhide/man1/systemd-notify.1 +++ b/upstream/fedora-rawhide/man1/systemd-notify.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-NOTIFY" "1" "" "systemd 255" "systemd-notify" +.TH "SYSTEMD\-NOTIFY" "1" "" "systemd 256~rc3" "systemd-notify" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -22,10 +22,10 @@ .SH "NAME" systemd-notify \- Notify service manager about start\-up completion and other daemon status changes .SH "SYNOPSIS" -.HP \w'\fBsystemd\-notify\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB[VARIABLE=VALUE...]\fR\ 'u -\fBsystemd\-notify \fR\fB[OPTIONS...]\fR\fB \fR\fB[VARIABLE=VALUE...]\fR -.HP \w'\fBsystemd\-notify\ \-\-exec\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB[VARIABLE=VALUE...]\fR\fB\ ;\ \fR\fB[CMDLINE...]\fR\ 'u -\fBsystemd\-notify \-\-exec \fR\fB[OPTIONS...]\fR\fB \fR\fB[VARIABLE=VALUE...]\fR\fB ; \fR\fB[CMDLINE...]\fR +.HP \w'\fBsystemd\-notify\fR\ 'u +\fBsystemd\-notify\fR [OPTIONS...] [VARIABLE=VALUE...] +.HP \w'\fBsystemd\-notify\fR\ 'u +\fBsystemd\-notify\fR [\-\-exec] [OPTIONS...] [VARIABLE=VALUE...] [;] [CMDLINE...] .SH "DESCRIPTION" .PP \fBsystemd\-notify\fR @@ -117,7 +117,9 @@ is used, except if that\*(Aqs the service manager\&. If the argument is specifie \fBsystemd\-notify\fR command itself is used, and if "parent" -is specified the calling process\*(Aq PID is used \(em even if it is the service manager\&. The latter is equivalent to +is specified the calling process\*(Aq PID is used \(em even if it is the service manager\&. +\fB\-\-pid=auto\fR +is equivalent to \fBsystemd\-notify MAINPID=$PID\fR\&. For details about the semantics of this option see \fBsd_notify\fR(3)\&. .sp @@ -130,7 +132,7 @@ in the service unit file, or otherwise the notification will be ignored for secu for details\&. .RE .PP -\fB\-\-uid=\fR\fIUSER\fR +\fB\-\-uid=\fR\fB\fIUSER\fR\fR .RS 4 Set the user ID to send the notification from\&. Takes a UNIX user name or numeric UID\&. When specified the notification message will be sent with the specified UID as sender, in place of the user the command was invoked as\&. This option requires sufficient privileges in order to be able manipulate the user identity of the process\&. .sp @@ -267,9 +269,4 @@ done .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemd.service\fR(5), -\fBsd_notify\fR(3), -\fBsd_booted\fR(3) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.service\fR(5), \fBsd_notify\fR(3), \fBsd_booted\fR(3) diff --git a/upstream/fedora-rawhide/man1/systemd-nspawn.1 b/upstream/fedora-rawhide/man1/systemd-nspawn.1 index 9aafd6eb..77ab1706 100644 --- a/upstream/fedora-rawhide/man1/systemd-nspawn.1 +++ b/upstream/fedora-rawhide/man1/systemd-nspawn.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-NSPAWN" "1" "" "systemd 255" "systemd-nspawn" +.TH "SYSTEMD\-NSPAWN" "1" "" "systemd 256~rc3" "systemd-nspawn" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -119,6 +119,56 @@ While running, containers invoked with are registered with the \fBsystemd-machined\fR(8) service that keeps track of running containers, and provides programming interfaces to interact with them\&. +.SH "UNPRIVILEGED OPERATION" +.PP +\fBsystemd\-nspawn\fR +may be invoked with or without privileges\&. The full functionality is currently only available when invoked with privileges\&. When invoked without privileges, various limitations apply, including, but not limited to: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Only disk image based containers are supported (i\&.e\&. +\fB\-\-image=\fR)\&. Directory based ones (i\&.e\&. +\fB\-\-directory=\fR) are not supported\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Machine registration via +\fB\-\-machine=\fR +is not supported\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Only +\fB\-\-private\-network\fR +and +\fB\-\-network\-veth\fR +networking modes are supported\&. +.RE +.PP +When running in unprivileged mode, some needed functionality is provided via +\fBsystemd-mountfsd.service\fR(8) +and +\fBsystemd-nsresourced.service\fR(8) .SH "OPTIONS" .PP If option @@ -138,7 +188,7 @@ Turns off any status output by the tool itself\&. When this switch is used, the Added in version 209\&. .RE .PP -\fB\-\-settings=\fR\fIMODE\fR +\fB\-\-settings=\fR\fB\fIMODE\fR\fR .RS 4 Controls whether \fBsystemd\-nspawn\fR @@ -194,6 +244,12 @@ is specified the directory is determined by searching for a directory named the \fBmachinectl\fR(1) section "Files and Directories" for the precise search path\&. .sp +In place of the directory path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. +.sp If neither \fB\-\-directory=\fR, \fB\-\-image=\fR, nor @@ -313,6 +369,12 @@ Any other partitions, such as foreign partitions or swap partitions are not moun \fB\-\-directory=\fR, \fB\-\-template=\fR\&. .sp +In place of the image path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. +.sp Added in version 211\&. .RE .PP @@ -346,7 +408,7 @@ and similar options\&. This mode is implied if the container image file or direc is used\&. In this case the container image on disk is strictly read\-only, while changes are permitted but kept non\-persistently in memory only\&. For further details, see below\&. .RE .PP -\fB\-\-volatile\fR, \fB\-\-volatile=\fR\fIMODE\fR +\fB\-\-volatile\fR, \fB\-\-volatile=\fR\fB\fIMODE\fR\fR .RS 4 Boots the container in volatile mode\&. When no mode parameter is passed or when mode is specified as \fByes\fR, full volatile mode is enabled\&. This means the root directory is mounted as a mostly unpopulated @@ -592,6 +654,20 @@ Added in version 209\&. \fB\-u\fR, \fB\-\-user=\fR .RS 4 After transitioning into the container, change to the specified user defined in the container\*(Aqs user database\&. Like all other systemd\-nspawn features, this is not a security feature and provides protection against accidental destructive operations only\&. +.sp +Note that if credentials are used in combination with a non\-root +\fB\-\-user=\fR +(e\&.g\&.: +\fB\-\-set\-credential=\fR, +\fB\-\-load\-credential=\fR +or +\fB\-\-import\-credential=\fR), then +\fB\-\-no\-new\-privileges=yes\fR +must be used, and +\fB\-\-boot\fR +or +\fB\-\-as\-pid2\fR +must not be used, as the credentials would otherwise be unreadable by the container due to missing privileges after switching to the specified user\&. .RE .PP \fB\-\-kill\-signal=\fR @@ -1453,7 +1529,9 @@ Control whether the container\*(Aqs journal shall be made visible to the host sy "try\-host" and "try\-guest" -do the same but do not fail if the host does not have persistent journaling enabled\&. If +do the same but do not fail if the host does not have persistent journaling enabled, or if the container is in the +\fB\-\-ephemeral\fR +mode\&. If "auto" (the default), and the right subdirectory of /var/log/journal @@ -1502,14 +1580,17 @@ and control whether to create a recursive or a regular bind mount\&. Defaults to \fBrbind\fR\&. \fBnoidmap\fR, -\fBidmap\fR, and +\fBidmap\fR, \fBrootidmap\fR +and +\fBowneridmap\fR control ID mapping\&. .sp Using -\fBidmap\fR -or +\fBidmap\fR, \fBrootidmap\fR +or +\fBowneridmap\fR requires support by the source filesystem for user/group ID mapped mounts\&. Defaults to \fBnoidmap\fR\&. With \fBx\fR @@ -1584,9 +1665,28 @@ on the host\&. Other host users are mapped to inside the container\&. .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If +\fBowneridmap\fR +is used, the owner of the target directory inside of the container is mapped to +\fBp\fR +on the host\&. Other host users are mapped to +\fBnobody\fR +inside the container\&. +.RE +.sp Whichever ID mapping option is used, the same mapping will be used for users and groups IDs\&. If \fBrootidmap\fR -is used, the group owning the bind mounted directory will have no effect\&. +or +\fBowneridmap\fR +are used, the group owning the bind mounted directory will have no effect\&. .sp Note that when this option is used in combination with \fB\-\-private\-users\fR, the resulting mount points will be owned by the @@ -1725,7 +1825,7 @@ Added in version 220\&. .RE .SS "Input/Output Options" .PP -\fB\-\-console=\fR\fIMODE\fR +\fB\-\-console=\fR\fB\fIMODE\fR\fR .RS 4 Configures how to set up standard input, output and error output for the container payload, as well as the /dev/console @@ -1785,9 +1885,23 @@ Equivalent to .sp Added in version 242\&. .RE +.PP +\fB\-\-background=\fR\fB\fICOLOR\fR\fR +.RS 4 +Change the terminal background color to the specified ANSI color as long as the container runs\&. The color specified should be an ANSI X3\&.64 SGR background color, i\&.e\&. strings such as +"40", +"41", \&..., +"47", +"48;2;\&...", +"48;5;\&..."\&. See +\m[blue]\fBANSI Escape Code (Wikipedia)\fR\m[]\&\s-2\u[6]\d\s+2 +for details\&. Assign an empty string to disable any coloring\&. +.sp +Added in version 256\&. +.RE .SS "Credentials" .PP -\fB\-\-load\-credential=\fR\fIID\fR:\fIPATH\fR, \fB\-\-set\-credential=\fR\fIID\fR:\fIVALUE\fR +\fB\-\-load\-credential=\fR\fB\fIID\fR\fR\fB:\fR\fB\fIPATH\fR\fR, \fB\-\-set\-credential=\fR\fB\fIID\fR\fR\fB:\fR\fB\fIVALUE\fR\fR .RS 4 Pass a credential to the container\&. These two options correspond to the \fILoadCredential=\fR @@ -1810,7 +1924,7 @@ to embed a newline, or "\ex00" to embed a \fBNUL\fR -byte)\&. Note that the invoking shell might already apply unescaping once, hence this might require double escaping!\&. +byte)\&. Note that the invoking shell might already apply unescaping once, hence this might require double escaping! .sp The \fBsystemd-sysusers.service\fR(8) @@ -1866,7 +1980,7 @@ Print a short version string and exit\&. .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, @@ -1876,7 +1990,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 @@ -1995,6 +2117,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\&. @@ -2006,6 +2134,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 @@ -2061,24 +2195,24 @@ and other conditions\&. .RE .SH "EXAMPLES" .PP -\fBExample\ \&1.\ \&Download a Fedora image and start a shell in it\fR +\fBExample\ \&1.\ \&Download an Ubuntu TAR image and open a shell in it\fR .sp .if n \{\ .RS 4 .\} .nf -# machinectl pull\-raw \-\-verify=no \e - https://download\&.fedoraproject\&.org/pub/fedora/linux/releases/38/Cloud/x86_64/images/Fedora\-Cloud\-Base\-38\-1\&.6\&.x86_64\&.raw\&.xz \e - Fedora\-Cloud\-Base\-38\-1\&.6\&.x86\-64 -# systemd\-nspawn \-M Fedora\-Cloud\-Base\-38\-1\&.6\&.x86\-64 +# importctl pull\-tar \-mN https://cloud\-images\&.ubuntu\&.com/jammy/current/jammy\-server\-cloudimg\-amd64\-root\&.tar\&.xz +# systemd\-nspawn \-M jammy\-server\-cloudimg\-amd64\-root .fi .if n \{\ .RE .\} .PP -This downloads an image using -\fBmachinectl\fR(1) -and opens a shell in it\&. +This downloads and verifies the specified +\&.tar +image, and then uses +\fBsystemd-nspawn\fR(1) +to open a shell in it\&. .PP \fBExample\ \&2.\ \&Build and boot a minimal Fedora distribution in a container\fR .sp @@ -2086,21 +2220,21 @@ and opens a shell in it\&. .RS 4 .\} .nf -# dnf \-y \-\-releasever=38 \-\-installroot=/var/lib/machines/f38 \e +# dnf \-y \-\-releasever=40 \-\-installroot=/var/lib/machines/f40 \e \-\-repo=fedora \-\-repo=updates \-\-setopt=install_weak_deps=False install \e passwd dnf fedora\-release vim\-minimal util\-linux systemd systemd\-networkd -# systemd\-nspawn \-bD /var/lib/machines/f38 +# systemd\-nspawn \-bD /var/lib/machines/f40 .fi .if n \{\ .RE .\} .PP This installs a minimal Fedora distribution into the directory -/var/lib/machines/f38 +/var/lib/machines/f40 and then boots that OS in a namespace container\&. Because the installation is located underneath the standard /var/lib/machines/ directory, it is also possible to start the machine using -\fBsystemd\-nspawn \-M f38\fR\&. +\fBsystemd\-nspawn \-M f40\fR\&. .PP \fBExample\ \&3.\ \&Spawn a shell in a container of a minimal Debian unstable distribution\fR .sp @@ -2208,16 +2342,7 @@ This runs a copy of the host system in a snapshot which is removed immediately w The exit code of the program executed in the container is returned\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.nspawn\fR(5), -\fBchroot\fR(1), -\fBdnf\fR(8), -\fBdebootstrap\fR(8), -\fBpacman\fR(8), -\fBzypper\fR(8), -\fBsystemd.slice\fR(5), -\fBmachinectl\fR(1), -\fBbtrfs\fR(8) +\fBsystemd\fR(1), \fBsystemd.nspawn\fR(5), \fBchroot\fR(1), \fBdnf\fR(8), \fBdebootstrap\fR(8), \fBpacman\fR(8), \fBzypper\fR(8), \fBsystemd.slice\fR(5), \fBmachinectl\fR(1), \fBimportctl\fR(1), \fBsystemd-mountfsd.service\fR(8), \fBsystemd-nsresourced.service\fR(8), \fBbtrfs\fR(8) .SH "NOTES" .IP " 1." 4 Container Interface @@ -2245,9 +2370,9 @@ Overlay Filesystem \%https://docs.kernel.org/filesystems/overlayfs.html .RE .IP " 6." 4 -Fedora +ANSI Escape Code (Wikipedia) .RS 4 -\%https://getfedora.org +\%https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_(Select_Graphic_Rendition)_parameters .RE .IP " 7." 4 Debian diff --git a/upstream/fedora-rawhide/man1/systemd-path.1 b/upstream/fedora-rawhide/man1/systemd-path.1 index ca933fef..e12a4e89 100644 --- a/upstream/fedora-rawhide/man1/systemd-path.1 +++ b/upstream/fedora-rawhide/man1/systemd-path.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-PATH" "1" "" "systemd 255" "systemd-path" +.TH "SYSTEMD\-PATH" "1" "" "systemd 256~rc3" "systemd-path" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -48,8 +48,6 @@ Added in version 215\&. \fB\-\-no\-pager\fR .RS 4 Do not pipe output into a pager\&. -.sp -Added in version 255\&. .RE .PP \fB\-h\fR, \fB\-\-help\fR @@ -66,5 +64,4 @@ 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), -\fBfile-hierarchy\fR(7) +\fBsystemd\fR(1), \fBfile-hierarchy\fR(7) diff --git a/upstream/fedora-rawhide/man1/systemd-run.1 b/upstream/fedora-rawhide/man1/systemd-run.1 index b2792c09..5d85f498 100644 --- a/upstream/fedora-rawhide/man1/systemd-run.1 +++ b/upstream/fedora-rawhide/man1/systemd-run.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-RUN" "1" "" "systemd 255" "systemd-run" +.TH "SYSTEMD\-RUN" "1" "" "systemd 256~rc3" "systemd-run" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -52,9 +52,10 @@ If a command is run as transient service unit, it will be started and managed by like any other unit\&. It will run in a clean and detached execution environment, with the service manager as its parent process\&. In this mode, \fBsystemd\-run\fR will start the service asynchronously in the background and return after the command has begun execution (unless -\fB\-\-no\-block\fR -or -\fB\-\-wait\fR +\fB\-\-no\-block\fR, +\fB\-\-wait\fR, +\fB\-\-pipe\fR, or +\fB\-\-pty\fR are specified, see below)\&. .PP If a command is run as transient scope unit, it will be executed by @@ -176,18 +177,22 @@ Make the new \&.service or \&.scope -unit part of the inherited slice\&. This option can be combined with -\fB\-\-slice=\fR\&. -.sp -An inherited slice is located within +unit part of the slice the \fBsystemd\-run\fR -slice\&. Example: if +itself has been invoked in\&. This option may be combined with +\fB\-\-slice=\fR, in which case the slice specified via +\fB\-\-slice=\fR +is placed within the slice the \fBsystemd\-run\fR -slice is +command is invoked in\&. +.sp +Example: consider +\fBsystemd\-run\fR +being invoked in the slice foo\&.slice, and the \fB\-\-slice=\fR argument is -bar, the unit will be placed under the +bar\&. The unit will then be placed under foo\-bar\&.slice\&. .sp Added in version 246\&. @@ -313,6 +318,14 @@ When invoking the command, the transient service connects its standard input, ou \fBsystemd\-run\fR is invoked on, via a pseudo TTY device\&. This allows running programs that expect interactive user input/output as services, such as interactive command shells\&. .sp +This option will result in +\fBsystemd\-run\fR +synchronously waiting for the transient service to terminate, similar to specifying +\fB\-\-wait\fR\&. If specified along with +\fB\-\-wait\fR, +\fBsystemd\-run\fR +won\*(Aqt exit when manually disconnecting from the pseudo TTY device\&. +.sp Note that \fBmachinectl\fR(1)\*(Aqs \fBshell\fR @@ -330,7 +343,9 @@ If specified, standard input, output, and error of the transient service are inh \fBsystemd\-run\fR command itself\&. This allows \fBsystemd\-run\fR -to be used within shell pipelines\&. Note that this mode is not suitable for interactive command shells and similar, as the service process will not become a TTY controller when invoked on a terminal\&. Use +to be used within shell pipelines\&. +.sp +Note that this mode is not suitable for interactive command shells and similar, as the service process will not become a TTY controller when invoked on a terminal\&. Use \fB\-\-pty\fR instead in that case\&. .sp @@ -343,12 +358,17 @@ are used in combination the more appropriate option is automatically determined is used, and otherwise \fB\-\-pipe\fR\&. .sp +This option will result in +\fBsystemd\-run\fR +synchronously waiting for the transient service to terminate, similar to specifying +\fB\-\-wait\fR\&. +.sp When this option is used the original file descriptors \fBsystemd\-run\fR receives are passed to the service processes as\-is\&. If the service runs with different privileges than -\fBsystemd\-run\fR, this means the service might not be able to re\-open the passed file descriptors, due to normal file descriptor access restrictions\&. If the invoked process is a shell script that uses the +\fBsystemd\-run\fR, this means the service might not be able to reopen the passed file descriptors, due to normal file descriptor access restrictions\&. If the invoked process is a shell script that uses the \fBecho "hello" >/dev/stderr\fR -construct for writing messages to stderr, this might cause problems, as this only works if stderr can be re\-opened\&. To mitigate this use the construct +construct for writing messages to stderr, this might cause problems, as this only works if stderr can be reopened\&. To mitigate this use the construct \fBecho "hello" >&2\fR instead, which is mostly equivalent and avoids this pitfall\&. .sp @@ -476,6 +496,28 @@ for further information\&. Added in version 236\&. .RE .PP +\fB\-\-ignore\-failure\fR +.RS 4 +By default, if the specified command fails the invoked unit will be marked failed (though possibly still unloaded, see +\fB\-\-collect=\fR, above), and this is reported in the logs\&. If this switch is specified this is suppressed and any non\-success exit status/code of the command is treated as success\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-background=\fR\fB\fICOLOR\fR\fR +.RS 4 +Change the terminal background color to the specified ANSI color as long as the session lasts\&. The color specified should be an ANSI X3\&.64 SGR background color, i\&.e\&. strings such as +"40", +"41", \&..., +"47", +"48;2;\&...", +"48;5;\&..."\&. See +\m[blue]\fBANSI Escape Code (Wikipedia)\fR\m[]\&\s-2\u[1]\d\s+2 +for details\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-\-user\fR .RS 4 Talk to the service manager of the calling user, rather than the service manager of the system\&. @@ -511,6 +553,13 @@ syntax is used either the left hand side or the right hand side may be omitted ( are implied\&. .RE .PP +\fB\-C\fR, \fB\-\-capsule=\fR +.RS 4 +Execute operation on a capsule\&. Specify a capsule name to connect to\&. See +\fBcapsule@.service\fR(5) +for details about capsules\&. +.RE +.PP \fB\-h\fR, \fB\-\-help\fR .RS 4 Print a short help text and exit\&. @@ -746,14 +795,10 @@ $ systemd\-run \-\-user \-\-wait \-p SuccessExitStatus=SIGUSR1 \-\-expand\-envir Those three invocations will succeed, i\&.e\&. terminate with an exit code of 0\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemd.service\fR(5), -\fBsystemd.scope\fR(5), -\fBsystemd.slice\fR(5), -\fBsystemd.exec\fR(5), -\fBsystemd.resource-control\fR(5), -\fBsystemd.timer\fR(5), -\fBsystemd-mount\fR(1), -\fBmachinectl\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.service\fR(5), \fBsystemd.scope\fR(5), \fBsystemd.slice\fR(5), \fBsystemd.exec\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.timer\fR(5), \fBsystemd-mount\fR(1), \fBmachinectl\fR(1), \fBrun0\fR(1) +.SH "NOTES" +.IP " 1." 4 +ANSI Escape Code (Wikipedia) +.RS 4 +\%https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_(Select_Graphic_Rendition)_parameters +.RE diff --git a/upstream/fedora-rawhide/man1/systemd-socket-activate.1 b/upstream/fedora-rawhide/man1/systemd-socket-activate.1 index e9235e31..52e53b6f 100644 --- a/upstream/fedora-rawhide/man1/systemd-socket-activate.1 +++ b/upstream/fedora-rawhide/man1/systemd-socket-activate.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SOCKET\-ACTIVATE" "1" "" "systemd 255" "systemd-socket-activate" +.TH "SYSTEMD\-SOCKET\-ACTIVATE" "1" "" "systemd 256~rc3" "systemd-socket-activate" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -104,7 +104,7 @@ itself\&. Added in version 230\&. .RE .PP -\fB\-\-fdname=\fR\fINAME\fR[:\fINAME\fR\&...] +\fB\-\-fdname=\fR\fB\fINAME\fR\fR\fB[:\fINAME\fR\&...]\fR .RS 4 Specify names for the file descriptors passed\&. This is equivalent to setting \fIFileDescriptorName=\fR @@ -167,10 +167,4 @@ $ systemd\-socket\-activate \-l 19531 /usr/lib/systemd/systemd\-journal\-gateway .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.socket\fR(5), -\fBsystemd.service\fR(5), -\fBsystemd-run\fR(1), -\fBsd_listen_fds\fR(3), -\fBsd_listen_fds_with_names\fR(3), -\fBcat\fR(1) +\fBsystemd\fR(1), \fBsystemd.socket\fR(5), \fBsystemd.service\fR(5), \fBsystemd-run\fR(1), \fBsd_listen_fds\fR(3), \fBsd_listen_fds_with_names\fR(3), \fBcat\fR(1) diff --git a/upstream/fedora-rawhide/man1/systemd-ssh-proxy.1 b/upstream/fedora-rawhide/man1/systemd-ssh-proxy.1 new file mode 100644 index 00000000..70df9299 --- /dev/null +++ b/upstream/fedora-rawhide/man1/systemd-ssh-proxy.1 @@ -0,0 +1,132 @@ +'\" t +.TH "SYSTEMD\-SSH\-PROXY" "1" "" "systemd 256~rc3" "systemd-ssh-proxy" +.\" ----------------------------------------------------------------- +.\" * 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-proxy \- SSH client plugin for connecting to \fBAF_VSOCK\fR and \fBAF_UNIX\fR sockets +.SH "SYNOPSIS" +.sp +.nf +Host unix/* vsock/* + ProxyCommand /usr/lib/systemd/systemd\-ssh\-proxy %h %p + ProxyUseFdpass yes +.fi +.HP \w'\fB/usr/lib/systemd/systemd\-ssh\-proxy\fR\ 'u +\fB/usr/lib/systemd/systemd\-ssh\-proxy\fR [ADDRESS] [PORT] +.SH "DESCRIPTION" +.PP +\fBsystemd\-ssh\-proxy\fR +is a small "proxy" plugin for the +\fBssh\fR(1) +tool that allows connecting to +\fBAF_UNIX\fR +and +\fBAF_VSOCK\fR +sockets\&. It implements the interface defined by +ssh\*(Aqs +\fIProxyCommand\fR +configuration option\&. It\*(Aqs supposed to be used with an +\fBssh_config\fR(5) +configuration fragment like the following: +.sp +.if n \{\ +.RS 4 +.\} +.nf +Host unix/* vsock/* + ProxyCommand /usr/lib/systemd/systemd\-ssh\-proxy %h %p + ProxyUseFdpass yes + CheckHostIP no + +Host \&.host + ProxyCommand /usr/lib/systemd/systemd\-ssh\-proxy unix/run/ssh\-unix\-local/socket %p + ProxyUseFdpass yes + CheckHostIP no +.fi +.if n \{\ +.RE +.\} +.PP +A configuration fragment along these lines is by default installed into +/etc/ssh/ssh_config\&.d/20\-systemd\-ssh\-proxy\&.conf\&.in\&. +.PP +With this in place, SSH connections to host string +"unix/" +followed by an absolute +\fBAF_UNIX\fR +file system path to a socket will be directed to the specified socket, which must be of type +\fBSOCK_STREAM\fR\&. Similar, SSH connections to +"vsock/" +followed by an +\fBAF_VSOCK\fR +CID will result in an SSH connection made to that CID\&. Moreover connecting to +"\&.host" +will connect to the local host via SSH, without involving networking\&. +.PP +This tool is supposed to be used together with +\fBsystemd-ssh-generator\fR(8) +which when run inside a VM or container will bind SSH to suitable addresses\&. +\fBsystemd\-ssh\-generator\fR +is supposed to run in the container of VM guest, and +\fBsystemd\-ssh\-proxy\fR +is run on the host, in order to connect to the container or VM guest\&. +.SH "EXIT STATUS" +.PP +On success, 0 is returned, a non\-zero failure code otherwise\&. +.SH "EXAMPLES" +.PP +\fBExample\ \&1.\ \&Talk to a local VM with CID 4711\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +ssh vsock/4711 +.fi +.if n \{\ +.RE +.\} +.PP +\fBExample\ \&2.\ \&Talk to the local host via ssh\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +ssh \&.host +.fi +.if n \{\ +.RE +.\} +.PP +or equivalent: +.sp +.if n \{\ +.RS 4 +.\} +.nf +ssh unix/run/ssh\-unix\-local/socket +.fi +.if n \{\ +.RE +.\} +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), \fBsystemd-ssh-generator\fR(8), \fBvsock\fR(7), \fBunix\fR(7), \fBssh\fR(1), \fBsshd\fR(8) diff --git a/upstream/fedora-rawhide/man1/systemd-stdio-bridge.1 b/upstream/fedora-rawhide/man1/systemd-stdio-bridge.1 index e5c06413..1970fb44 100644 --- a/upstream/fedora-rawhide/man1/systemd-stdio-bridge.1 +++ b/upstream/fedora-rawhide/man1/systemd-stdio-bridge.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-STDIO\-BRIDGE" "1" "" "systemd 255" "systemd-stdio-bridge" +.TH "SYSTEMD\-STDIO\-BRIDGE" "1" "" "systemd 256~rc3" "systemd-stdio-bridge" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -93,10 +93,7 @@ Print a short version string and exit\&. On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBdbus-daemon\fR(1), -\fBdbus-broker\fR(1), -\m[blue]\fBD\-Bus\fR\m[]\&\s-2\u[1]\d\s+2, -\fBsystemd\fR(1) +\fBdbus-daemon\fR(1), \fBdbus-broker\fR(1), \m[blue]\fBD\-Bus\fR\m[]\&\s-2\u[1]\d\s+2, \fBsystemd\fR(1) .SH "NOTES" .IP " 1." 4 D-Bus diff --git a/upstream/fedora-rawhide/man1/systemd-tty-ask-password-agent.1 b/upstream/fedora-rawhide/man1/systemd-tty-ask-password-agent.1 index d6643734..488dd656 100644 --- a/upstream/fedora-rawhide/man1/systemd-tty-ask-password-agent.1 +++ b/upstream/fedora-rawhide/man1/systemd-tty-ask-password-agent.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-TTY\-ASK\-PASSWORD\-AGENT" "1" "" "systemd 255" "systemd-tty-ask-password-agent" +.TH "SYSTEMD\-TTY\-ASK\-PASSWORD\-AGENT" "1" "" "systemd 256~rc3" "systemd-tty-ask-password-agent" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -103,11 +103,7 @@ 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), -\fBsystemctl\fR(1), -\fBsystemd-ask-password-console.service\fR(8), -\fBwall\fR(1), -\fBplymouth\fR(8) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-ask-password-console.service\fR(8), \fBwall\fR(1), \fBplymouth\fR(8) .SH "NOTES" .IP " 1." 4 Password Agents Specification diff --git a/upstream/fedora-rawhide/man1/systemd-vmspawn.1 b/upstream/fedora-rawhide/man1/systemd-vmspawn.1 index 85b7c5e0..13ec83be 100644 --- a/upstream/fedora-rawhide/man1/systemd-vmspawn.1 +++ b/upstream/fedora-rawhide/man1/systemd-vmspawn.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-VMSPAWN" "1" "" "systemd 255" "systemd-vmspawn" +.TH "SYSTEMD\-VMSPAWN" "1" "" "systemd 256~rc3" "systemd-vmspawn" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,7 +20,7 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -systemd-vmspawn \- Spawn an OS in a virtual machine\&. +systemd-vmspawn \- Spawn an OS in a virtual machine .SH "SYNOPSIS" .HP \w'\fBsystemd\-vmspawn\fR\ 'u \fBsystemd\-vmspawn\fR [OPTIONS...] [ARGS...] @@ -28,18 +28,60 @@ systemd-vmspawn \- Spawn an OS in a virtual machine\&. .PP \fBsystemd\-vmspawn\fR may be used to start a virtual machine from an OS image\&. In many ways it is similar to -\fBsystemd-nspawn\fR(1), but it launches a full virtual machine instead of using namespaces\&. +\fBsystemd-nspawn\fR(1), but launches a full virtual machine instead of using namespaces\&. +.PP +File descriptors for +/dev/kvm +and +/dev/vhost\-vsock +can be passed to +\fBsystemd\-vmspawn\fR +via systemd\*(Aqs native socket passing interface (see +\fBsd_listen_fds\fR(3) +for details about the precise protocol used and the order in which the file descriptors are passed), these file descriptors must be passed with the names +"kvm" +and +"vhost\-vsock" +respectively\&. .PP Note: on Ubuntu/Debian derivatives systemd\-vmspawn requires the user to be in the "kvm" -group to use the VSock options\&. +group to use the VSOCK options\&. .SH "OPTIONS" .PP The excess arguments are passed as extra kernel command line arguments using SMBIOS\&. .PP The following options are understood: +.PP +\fB\-q\fR, \fB\-\-quiet\fR +.RS 4 +Turns off any status output by the tool itself\&. When this switch is used, the only output from vmspawn will be the console output of the Virtual Machine OS itself\&. +.sp +Added in version 256\&. +.RE .SS "Image Options" .PP +\fB\-D\fR, \fB\-\-directory=\fR +.RS 4 +Directory to use as file system root for the virtual machine\&. +.sp +One of either +\fB\-\-directory=\fR +or +\fB\-\-image=\fR +must be specified\&. If neither are specified +\fB\-\-directory=\&.\fR +is assumed\&. +.sp +Note: If mounting a non\-root owned directory you may require +\fB\-\-private\-users=\fR +to map into the user\*(Aqs subuid namespace\&. An example of how to use +\fB/etc/subuid\fR +for this is given later\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-i\fR, \fB\-\-image=\fR .RS 4 Root file system disk image (or device node) for the virtual machine\&. @@ -48,59 +90,130 @@ Added in version 255\&. .RE .SS "Host Configuration" .PP -\fB\-\-qemu\-smp=\fR\fISMP\fR +\fB\-\-cpus=\fR\fB\fICPUS\fR\fR .RS 4 -Configures the number of CPUs to start the virtual machine with\&. Defaults to 1\&. +The number of CPUs to start the virtual machine with\&. Defaults to 1\&. .sp Added in version 255\&. .RE .PP -\fB\-\-qemu\-mem=\fR\fIMEM\fR +\fB\-\-ram=\fR\fB\fIBYTES\fR\fR .RS 4 -Configures the amount of memory to start the virtual machine with\&. Defaults to 2G\&. +The amount of memory to start the virtual machine with\&. Defaults to 2G\&. .sp Added in version 255\&. .RE .PP -\fB\-\-qemu\-kvm=\fR\fIBOOL\fR +\fB\-\-kvm=\fR\fB\fIBOOL\fR\fR .RS 4 -Configures whether to use KVM\&. If the option is not specified KVM support will be detected automatically\&. If true, KVM is always used, and if false, KVM is never used\&. +If +\fB\-\-kvm=\fR +is not specified KVM support will be detected automatically\&. If true, KVM is always used, and if false, KVM is never used\&. .sp Added in version 255\&. .RE .PP -\fB\-\-qemu\-vsock=\fR\fIBOOL\fR +\fB\-\-vsock=\fR\fB\fIBOOL\fR\fR .RS 4 -Configure whether to use VSock networking\&. -.sp -If the option is not specified VSock support will be detected automatically\&. If yes is specified VSocks are always used, and vice versa if no is set VSocks are never used\&. +If +\fB\-\-vsock=\fR +is not specified VSOCK networking support will be detected automatically\&. If true, VSOCK networking is always used, and if false, VSOCK networking is never used\&. .sp Added in version 255\&. .RE .PP -\fB\-\-vsock\-cid=\fR\fICID\fR +\fB\-\-vsock\-cid=\fR\fB\fICID\fR\fR .RS 4 -Configure vmspawn to use a specific CID for the guest\&. -.sp -If the option is not specified or an empty argument is supplied the guest will be assigned a random CID\&. -.sp -Valid CIDs are in the range +Sets the specific CID to use for the guest\&. Valid CIDs are in the range \fB3\fR to \fB4294967294\fR -(\fB0xFFFF_FFFE\fR)\&. CIDs outside of this range are reserved\&. +(\fB0xFFFF_FFFE\fR)\&. CIDs outside of this range are reserved\&. By default vmspawn will attempt to derive a CID for the guest derived from the machine name, falling back to a random CID if this CID is taken\&. .sp Added in version 255\&. .RE .PP -\fB\-\-qemu\-gui\fR +\fB\-\-tpm=\fR\fB\fIBOOL\fR\fR +.RS 4 +If +\fB\-\-tpm=\fR +is not specified vmspawn will detect the presence of +\fBswtpm\fR(8) +and use it if available\&. If yes is specified +\fBswtpm\fR(8) +is always used, and if no is set +\fBswtpm\fR(8) +is never used\&. +.sp +Note: the virtual TPM used may change in future\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-linux=\fR\fB\fIPATH\fR\fR +.RS 4 +Set the linux kernel image to use for direct kernel boot\&. If a directory type image is used and +\fB\-\-linux=\fR +was omitted, vmspawn will search for boot loader entries according to the +\m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[1]\d\s+2 +assuming XBOOTLDR to be located at /boot and ESP to be /efi respectively\&. If no kernel was installed into the image then the image will fail to boot\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-initrd=\fR\fB\fIPATH\fR\fR .RS 4 -Start QEMU in graphical mode\&. +Set the initrd to use for direct kernel boot\&. If the +\fB\-\-linux=\fR +supplied is a +\m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[1]\d\s+2 +Type #2 entry, then this argument is not required\&. If no initrd was installed into the image then the image will fail to boot\&. +.sp +\fB\-\-initrd=\fR +can be specified multiple times and vmspawn will merge them together\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-n\fR, \fB\-\-network\-tap\fR +.RS 4 +Create a TAP device to network with the virtual machine\&. +.sp +Note: root privileges are required to use TAP networking\&. Additionally, +\fBsystemd-networkd\fR(8) +must be running and correctly set up on the host to provision the host interface\&. The relevant +"\&.network" +file can be found at +/usr/lib/systemd/network/80\-vm\-vt\&.network\&. .sp Added in version 255\&. .RE .PP -\fB\-\-secure\-boot=\fR\fIBOOL\fR +\fB\-\-network\-user\-mode\fR +.RS 4 +Use user mode networking\&. +.sp +Added in version 255\&. +.RE +.PP +\fB\-\-firmware=\fR\fB\fIPATH\fR\fR +.RS 4 +Takes an absolute path, or a relative path beginning with +\&./\&. Specifies a JSON firmware definition file, which allows selecting the firmware to boot in the VM\&. If not specified a suitable firmware is automatically discovered\&. If the special string +"list" +is specified lists all discovered firmwares\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-discard\-disk=\fR\fB\fIBOOL\fR\fR +.RS 4 +Controls whether qemu processes discard requests from the VM\&. This prevents long running VMs from using more disk space than required\&. This is enabled by default\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-secure\-boot=\fR\fB\fIBOOL\fR\fR .RS 4 Configure whether to search for firmware which supports Secure Boot\&. .sp @@ -112,17 +225,166 @@ Added in version 255\&. .PP \fB\-M\fR, \fB\-\-machine=\fR .RS 4 -Sets the machine name for this container\&. This name may be used to identify this container during its runtime (for example in tools like +Sets the machine name for this virtual machine\&. This name may be used to identify this virtual machine during its runtime (for example in tools like \fBmachinectl\fR(1) and similar)\&. .sp Added in version 255\&. .RE +.PP +\fB\-\-uuid=\fR +.RS 4 +Set the specified UUID for the virtual machine\&. The init system will initialize +/etc/machine\-id +from this if this file is not set yet\&. Note that this option takes effect only if +/etc/machine\-id +in the virtual machine is unpopulated\&. +.sp +Added in version 256\&. +.RE +.SS "Property Options" +.PP +\fB\-\-register=\fR +.RS 4 +Controls whether the virtual machine is registered with +\fBsystemd-machined\fR(8)\&. Takes a boolean argument, which defaults to +"yes" +when running as root, and +"no" +when running as a regular user\&. This ensures that the virtual machine is accessible via +\fBmachinectl\fR(1)\&. +.sp +Note: root privileges are required to use this option as registering with +\fBsystemd-machined\fR(8) +requires privileged D\-Bus method calls\&. +.sp +Added in version 256\&. +.RE +.SS "User Namespacing Options" +.PP +\fB\-\-private\-users=\fR\fB\fIUID_SHIFT[:UID_RANGE]\fR\fR +.RS 4 +Controls user namespacing under +\fB\-\-directory=\fR\&. If enabled, +\fBvirtiofsd\fR(1) +is instructed to map user and group ids (UIDs and GIDs)\&. This involves mapping the private UIDs/GIDs used in the virtual machine (starting with the virtual machine\*(Aqs root user 0 and up) to a range of UIDs/GIDs on the host that are not used for other purposes (usually in the range beyond the host\*(Aqs UID/GID 65536)\&. +.sp +If one or two colon\-separated numbers are specified, user namespacing is turned on\&. +\fIUID_SHIFT\fR +specifies the first host UID/GID to map, +\fIUID_RANGE\fR +is optional and specifies number of host UIDs/GIDs to assign to the virtual machine\&. If +\fIUID_RANGE\fR +is omitted, 65536 UIDs/GIDs are assigned\&. +.sp +When user namespaces are used, the GID range assigned to each virtual machine is always chosen identical to the UID range\&. +.sp +Added in version 256\&. +.RE +.SS "Mount Options" +.PP +\fB\-\-bind=\fR\fB\fIPATH\fR\fR, \fB\-\-bind\-ro=\fR\fB\fIPATH\fR\fR +.RS 4 +Mount a directory from the host into the virtual machine\&. Takes one of: a path argument\ \&\(em in which case the specified path will be mounted from the host to the same path in the virtual machine, or a colon\-separated pair of paths\ \&\(em in which case the first specified path is the source in the host, and the second path is the destination in the virtual machine\&. If the source path is not absolute, it is resolved relative to the current working directory\&. The +\fB\-\-bind\-ro=\fR +option creates read\-only bind mounts\&. Backslash escapes are interpreted, so +"\e:" +may be used to embed colons in either path\&. This option may be specified multiple times for creating multiple independent bind mount points\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-extra\-drive=\fR\fB\fIPATH\fR\fR +.RS 4 +Takes a disk image or block device on the host and supplies it to the virtual machine as another drive\&. +.sp +Added in version 256\&. +.RE +.SS "Integration Options" +.PP +\fB\-\-forward\-journal=\fR\fB\fIFILE|DIR\fR\fR +.RS 4 +Forward the virtual machine\*(Aqs journal to the host\&. +\fBsystemd-journal-remote\fR(8) +is currently used to receive the guest VM\*(Aqs forwarded journal entries\&. This option determines where this journal is saved on the host and has the same semantics as +\fB\-o\fR/\fB\-\-output\fR +described in +\fBsystemd-journal-remote\fR(8)\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-pass\-ssh\-key=\fR\fB\fIBOOL\fR\fR +.RS 4 +By default an SSH key is generated to allow +\fBsystemd\-vmspawn\fR +to open a D\-Bus connection to the VM\*(Aqs systemd bus\&. Setting this to "no" will disable SSH key generation\&. +.sp +The generated keys are ephemeral\&. That is they are valid only for the current invocation of +\fBsystemd\-vmspawn\fR, and are typically not persisted\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-ssh\-key\-type=\fR\fB\fITYPE\fR\fR +.RS 4 +Configures the type of SSH key to generate, see +\fBssh-keygen\fR(1) +for more information\&. +.sp +By default +"ed25519" +keys are generated, however +"rsa" +keys may also be useful if the VM has a particularly old version of +\fBsshd\fR\&. +.sp +Added in version 256\&. +.RE +.SS "Input/Output Options" +.PP +\fB\-\-console=\fR\fB\fIMODE\fR\fR +.RS 4 +Configures how to set up the console of the VM\&. Takes one of +"interactive", +"read\-only", +"native", +"gui"\&. Defaults to +"interactive"\&. +"interactive" +provides an interactive terminal interface to the VM\&. +"read\-only" +is similar, but is strictly read\-only, i\&.e\&. does not accept any input from the user\&. +"native" +also provides a TTY\-based interface, but uses qemu native implementation (which means the qemu monitor is available)\&. +"gui" +shows the qemu graphical UI\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-background=\fR\fB\fICOLOR\fR\fR +.RS 4 +Change the terminal background color to the specified ANSI color as long as the VM runs\&. The color specified should be an ANSI X3\&.64 SGR background color, i\&.e\&. strings such as +"40", +"41", \&..., +"47", +"48;2;\&...", +"48;5;\&..."\&. See +\m[blue]\fBANSI Escape Code (Wikipedia)\fR\m[]\&\s-2\u[2]\d\s+2 +for details\&. Assign an empty string to disable any coloring\&. This only has an effect in +\fB\-\-console=interactive\fR +and +\fB\-\-console=read\-only\fR +modes\&. +.sp +Added in version 256\&. +.RE .SS "Credentials" .PP -\fB\-\-load\-credential=\fR\fIID\fR:\fIPATH\fR, \fB\-\-set\-credential=\fR\fIID\fR:\fIVALUE\fR +\fB\-\-load\-credential=\fR\fB\fIID\fR\fR\fB:\fR\fB\fIPATH\fR\fR, \fB\-\-set\-credential=\fR\fB\fIID\fR\fR\fB:\fR\fB\fIVALUE\fR\fR .RS 4 -Pass a credential to the container\&. These two options correspond to the +Pass a credential to the virtual machine\&. These two options correspond to the \fILoadCredential=\fR and \fISetCredential=\fR @@ -137,7 +399,7 @@ to embed a newline, or "\ex00" to embed a \fBNUL\fR -byte)\&. Note that the invoking shell might already apply unescaping once, hence this might require double escaping!\&. +byte)\&. Note that the invoking shell might already apply unescaping once, hence this might require double escaping! .sp Added in version 255\&. .RE @@ -161,7 +423,7 @@ Print a short version string and exit\&. .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, @@ -171,7 +433,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 @@ -290,6 +560,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\&. @@ -301,6 +577,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 @@ -369,10 +651,82 @@ $ systemd\-vmspawn \-\-image=image\&.raw .if n \{\ .RE .\} +.PP +\fBExample\ \&2.\ \&Import and run a Fedora 39 Cloud image using machinectl\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +$ curl \-L \e + \-O https://download\&.fedoraproject\&.org/pub/fedora/linux/releases/40/Cloud/x86_64/images/Fedora\-Cloud\-Base\-40\-1\&.10\&.x86_64\&.raw\&.xz \e + \-O https://download\&.fedoraproject\&.org/pub/fedora/linux/releases/40/Cloud/x86_64/images/Fedora\-Cloud\-40\-1\&.10\-x86_64\-CHECKSUM \e + \-O https://fedoraproject\&.org/fedora\&.gpg +$ gpgv \-\-keyring \&./fedora\&.gpg Fedora\-Cloud\-40\-1\&.10\-x86_64\-CHECKSUM +$ sha256sum \-c Fedora\-Cloud\-40\-1\&.10\-x86_64\-CHECKSUM +# machinectl import\-raw Fedora\-Cloud\-Base\-40\-1\&.10\&.x86_64\&.raw\&.xz fedora\-40\-cloud +# systemd\-vmspawn \-M fedora\-40\-cloud + +.fi +.if n \{\ +.RE +.\} +.PP +\fBExample\ \&3.\ \&Build and run systemd\*(Aqs system image and forward the VM\*(Aqs journal to a local file\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +$ mkosi build +$ systemd\-vmspawn \e + \-D mkosi\&.output/system \e + \-\-private\-users $(grep $(whoami) /etc/subuid | cut \-d: \-f2) \e + \-\-linux mkosi\&.output/system\&.efi \e + \-\-forward\-journal=vm\&.journal \e + enforcing=0 + +.fi +.if n \{\ +.RE +.\} +.PP +Note: this example also uses a kernel command line argument to ensure SELinux isn\*(Aqt started in enforcing mode\&. +.PP +\fBExample\ \&4.\ \&SSH into a running VM using systemd\-ssh\-proxy\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +$ mkosi build +$ my_vsock_cid=3735928559 +$ systemd\-vmspawn \e + \-D mkosi\&.output/system \e + \-\-private\-users $(grep $(whoami) /etc/subuid | cut \-d: \-f2) \e + \-\-linux mkosi\&.output/system\&.efi \e + \-\-vsock\-cid $my_vsock_cid \e + enforcing=0 +$ ssh root@vsock/$my_vsock_cid \-i /run/user/$UID/systemd/vmspawn/machine\-*\-system\-ed25519 + +.fi +.if n \{\ +.RE +.\} .SH "EXIT STATUS" .PP If an error occurred the value errno is propagated to the return code\&. If EXIT_STATUS is supplied by the running image that is returned\&. Otherwise EXIT_SUCCESS is returned\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBmkosi\fR(1) +\fBsystemd\fR(1), \fBmkosi\fR(1), \fBmachinectl\fR(1), \fBimportctl\fR(1), \m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[1]\d\s+2 +.SH "NOTES" +.IP " 1." 4 +Boot Loader Specification +.RS 4 +\%https://uapi-group.org/specifications/specs/boot_loader_specification +.RE +.IP " 2." 4 +ANSI Escape Code (Wikipedia) +.RS 4 +\%https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_(Select_Graphic_Rendition)_parameters +.RE diff --git a/upstream/fedora-rawhide/man1/systemd-vpick.1 b/upstream/fedora-rawhide/man1/systemd-vpick.1 new file mode 100644 index 00000000..557af222 --- /dev/null +++ b/upstream/fedora-rawhide/man1/systemd-vpick.1 @@ -0,0 +1,253 @@ +'\" t +.TH "SYSTEMD\-VPICK" "1" "" "systemd 256~rc3" "systemd-vpick" +.\" ----------------------------------------------------------------- +.\" * 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-vpick \- Resolve paths to "\&.v/" versioned directories +.SH "SYNOPSIS" +.HP \w'\fBsystemd\-vpick\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB[PATH...]\fR\ 'u +\fBsystemd\-vpick \fR\fB[OPTIONS...]\fR\fB \fR\fB[PATH...]\fR +.SH "DESCRIPTION" +.PP +\fBsystemd\-vpick\fR +resolves a file system path referencing a +"\&.v/" +versioned directory to a path to the newest (by version) file contained therein\&. This tool provides a command line interface for the +\fBsystemd.v\fR(7) +logic\&. +.PP +The tool expects a path to a +"\&.v/" +directory as argument (either directly, or with a triple underscore pattern as final component)\&. It then determines the newest file contained in that directory, and writes its path to standard output\&. +.PP +Unless the triple underscore pattern is passed as last component of the path, it is typically necessary to at least specify the +\fB\-\-suffix=\fR +switch to configure the file suffix to look for\&. +.PP +If the specified path does not reference a +"\&.v/" +path (i\&.e\&. neither the final component ends in +"\&.v", nor the penultimate does or the final one does contain a triple underscore) it specified path is written unmodified to standard output\&. +.SH "OPTIONS" +.PP +The following options are understood: +.PP +\fB\-\-basename=\fR, \fB\-B\fR +.RS 4 +Overrides the "basename" of the files to look for, i\&.e\&. the part to the left of the variable part of the filenames\&. Normally this is derived automatically from the filename of the +"\&.v" +component of the specified path, or from the triple underscore pattern in the last component of the specified path\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-V\fR +.RS 4 +Explicitly configures the version to select\&. If specified, a filename with the specified version string will be looked for, instead of the newest version available\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-A\fR +.RS 4 +Explicitly configures the architecture to select\&. If specified, a filename with the specified architecture identifier will be looked for\&. If not specified only filenames with a locally supported architecture are considered, or those without any architecture identifier\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-suffix=\fR, \fB\-S\fR +.RS 4 +Configures the suffix of the filenames to consider\&. For the +"\&.v/" +logic it is necessary to specify the suffix to look for, and the +"\&.v/" +component must also carry the suffix immediately before +"\&.v" +in its name\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-type=\fR, \fB\-t\fR +.RS 4 +Configures the inode type to look for in the +"\&.v/" +directory\&. Takes one of +"reg", +"dir", +"sock", +"fifo", +"blk", +"chr", +"lnk" +as argument, each identifying an inode type\&. See +\fBinode\fR(7) +for details about inode types\&. If this option is used inodes not matching the specified type are filtered and not taken into consideration\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-print=\fR, \fB\-p\fR +.RS 4 +Configures what precisely to write to standard output\&. If not specified prints the full, resolved path of the newest matching file in the +"\&.v/" +directory\&. This switch can be set to one of the following: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If set to +"filename", will print only the filename instead of the full path of the resolved file\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If set to +"version", will print only the version of the resolved file\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If set to +"type", will print only the inode type of the resolved file (i\&.e\&. a string such as +"reg" +for regular files, or +"dir" +for directories)\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If set to +"arch", will print only the architecture of the resolved file\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If set to +"tries", will print only the tries left/tries done of the resolved file\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If set to +"all", will print all of the above in a simple tabular output\&. +.RE +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-resolve=\fR +.RS 4 +Takes a boolean argument\&. If true the path to the versioned file is fully canonicalized (i\&.e\&. symlinks resolved, and redundant path components removed) before it is shown\&. If false (the default) this is not done, and the path is shown without canonicalization\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-h\fR, \fB\-\-help\fR +.RS 4 +Print a short help text and exit\&. +.RE +.PP +\fB\-\-version\fR +.RS 4 +Print a short version string and exit\&. +.RE +.SH "EXAMPLES" +.PP +Use a command like the following to automatically pick the newest raw disk image from a +"\&.v/" +directory: +.sp +.if n \{\ +.RS 4 +.\} +.nf +$ systemd\-vpick \-\-suffix=\&.raw \-\-type=reg /var/lib/machines/quux\&.raw\&.v/ +.fi +.if n \{\ +.RE +.\} +.PP +This will enumerate all regular files matching +/var/lib/machines/quux\&.raw\&.v/quux*\&.raw, filter and sort them according to the rules described in +\fBsystemd.v\fR(7), and then write the path to the newest (by version) file to standard output\&. +.PP +Use a command like the following to automatically pick the newest OS directory tree from a +"\&.v/" +directory: +.sp +.if n \{\ +.RS 4 +.\} +.nf +$ systemd\-vpick \-\-type=dir /var/lib/machines/waldo\&.v/ +.fi +.if n \{\ +.RE +.\} +.PP +This will enumerate all directory inodes matching +/var/lib/machines/waldo\&.v/waldo*, filter and sort them according to the rules described in +\fBsystemd.v\fR(7), and then write the path to the newest (by version) directory to standard output\&. +.PP +For further examples see +\fBsystemd.v\fR(7)\&. +.SH "EXIT STATUS" +.PP +On success, 0 is returned, a non\-zero failure code otherwise\&. +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), \fBsystemd.v\fR(7) diff --git a/upstream/fedora-rawhide/man1/systemd.1 b/upstream/fedora-rawhide/man1/systemd.1 index 24ba6297..410c1617 100644 --- a/upstream/fedora-rawhide/man1/systemd.1 +++ b/upstream/fedora-rawhide/man1/systemd.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD" "1" "" "systemd 255" "systemd" +.TH "SYSTEMD" "1" "" "systemd 256~rc3" "systemd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -394,6 +394,12 @@ The location of the SysV runlevel link farm directory varies between distributio .RE .SH "SIGNALS" .PP +The service listens to various UNIX process signals that can be used to request various actions asynchronously\&. The signal handling is enabled very early during boot, before any further processes are invoked\&. However, a supervising container manager or similar that intends to request these operations via this mechanism must take into consideration that this functionality is not available during the earliest initialization phase\&. An +\fBsd_notify()\fR +notification message carrying the +\fIX_SYSTEMD_SIGNALS_LEVEL=2\fR +field is emitted once the signal handlers are enabled, see below\&. This may be used to schedule submission of these signals correctly\&. +.PP \fBSIGTERM\fR .RS 4 Upon receiving this signal the systemd system manager serializes its state, reexecutes itself and deserializes the saved state again\&. This is mostly equivalent to @@ -657,7 +663,7 @@ Some of the variables understood by .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, @@ -667,7 +673,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\&. .sp This can be overridden with \fB\-\-log\-level=\fR\&. @@ -809,6 +823,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\&. @@ -820,6 +840,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 @@ -883,9 +909,9 @@ for more information\&. .PP \fI$NOTIFY_SOCKET\fR .RS 4 -Set by systemd for supervised processes for status and start\-up completion notification\&. See +Set by service manager for its services for status and readiness notifications\&. Also consumed by service manager for notifying supervising container managers or service managers up the stack about its own progress\&. See \fBsd_notify\fR(3) -for more information\&. +and the relevant section below for more information\&. .RE .PP For further environment variables understood by systemd and its various components, see @@ -940,12 +966,20 @@ Takes a boolean argument or enables the option if specified without an argument\ Added in version 233\&. .RE .PP -\fIsystemd\&.crash_reboot\fR +\fIsystemd\&.crash_action=\fR .RS 4 -Takes a boolean argument or enables the option if specified without an argument\&. If enabled, the system manager (PID 1) will reboot the machine automatically when it crashes, after a 10s delay\&. Otherwise, the system will hang indefinitely\&. Defaults to disabled, in order to avoid a reboot loop\&. If combined with -\fIsystemd\&.crash_shell\fR, the system is rebooted after the shell exits\&. +Takes one of +"freeze", +"reboot" +or +"poweroff"\&. Defaults to +"freeze"\&. If set to +"freeze", the system will hang indefinitely when the system manager (PID 1) crashes\&. If set to +"reboot", the system manager (PID 1) will reboot the machine automatically when it crashes, after a 10s delay\&. If set to +"poweroff", the system manager (PID 1) will power off the machine immediately when it crashes\&. If combined with +\fIsystemd\&.crash_shell\fR, the configured crash action is executed after the shell exits\&. .sp -Added in version 227\&. +Added in version 256\&. .RE .PP \fIsystemd\&.confirm_spawn\fR @@ -1247,19 +1281,26 @@ or \fBAF_UNIX\fR address where to send a \fBREADY=1\fR -notification datagram when the system has finished booting\&. See +notification message when the service manager has completed booting\&. See \fBsd_notify\fR(3) -for more information\&. Note that in case the hypervisor does not support +and the next section for more information\&. Note that in case the hypervisor does not support \fBSOCK_DGRAM\fR over \fBAF_VSOCK\fR, \fBSOCK_SEQPACKET\fR will be tried instead\&. The credential payload for \fBAF_VSOCK\fR -should be in the form +should be a string in the form "vsock:CID:PORT"\&. +"vsock\-stream", +"vsock\-dgram" +and +"vsock\-seqpacket" +can be used instead of +"vsock" +to force usage of the corresponding socket type\&. .sp -This feature is useful for hypervisors/VMMs or other processes on the host to receive a notification via VSOCK when a virtual machine has finished booting\&. +This feature is useful for machine managers or other processes on the host to receive a notification via VSOCK when a virtual machine has finished booting\&. .sp Added in version 254\&. .RE @@ -1274,6 +1315,146 @@ for details\&. .sp Added in version 254\&. .RE +.PP +For a list of system credentials various other components of systemd consume, see +\fBsystemd.system-credentials\fR(7)\&. +.SH "READINESS PROTOCOL" +.PP +The service manager implements a readiness notification protocol both between the manager and its services (i\&.e\&. down the stack), and between the manager and a potential supervisor further up the stack (the latter could be a machine or container manager, or in case of a per\-user service manager the system service manager instance)\&. The basic protocol (and the suggested API for it) is described in +\fBsd_notify\fR(3)\&. +.PP +The notification socket the service manager (including PID 1) uses for reporting readiness to its own supervisor is set via the usual +\fI$NOTIFY_SOCKET\fR +environment variable (see above)\&. Since this is directly settable only for container managers and for the per\-user instance of the service manager, an additional mechanism to configure this is available, in particular intended for use in VM environments: the +\fIvmm\&.notify_socket\fR +system credential (see above) may be set to a suitable socket (typically an +\fBAF_VSOCK\fR +one) via SMBIOS Type 11 vendor strings\&. For details see above\&. +.PP +The notification protocol from the service manager up the stack towards a supervisor supports a number of extension fields that allow a supervisor to learn about specific properties of the system and track its boot progress\&. Specifically the following fields are sent: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +An +\fIX_SYSTEMD_HOSTNAME=\&...\fR +message will be sent out once the initial hostname for the system has been determined\&. Note that during later runtime the hostname might be changed again programmatically, and (currently) no further notifications are sent out in that case\&. +.sp +Added in version 256\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +An +\fIX_SYSTEMD_MACHINE_ID=\&...\fR +message will be sent out once the machine ID of the system has been determined\&. See +\fBmachine-id\fR(5) +for details\&. +.sp +Added in version 256\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +An +\fIX_SYSTEMD_SIGNALS_LEVEL=\&...\fR +message will be sent out once the service manager installed the various UNIX process signal handlers described above\&. The field\*(Aqs value is an unsigned integer formatted as decimal string, and indicates the supported UNIX process signal feature level of the service manager\&. Currently, only a single feature level is defined: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +\fIX_SYSTEMD_SIGNALS_LEVEL=2\fR +covers the various UNIX process signals documented above \(en which are a superset of those supported by the historical SysV init system\&. +.RE +.sp +Signals sent to PID 1 before this message is sent might not be handled correctly yet\&. A consumer of these messages should parse the value as an unsigned integer indication the level of support\&. For now only the mentioned level 2 is defined, but later on additional levels might be defined with higher integers, that will implement a superset of the currently defined behaviour\&. +.sp +Added in version 256\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +\fIX_SYSTEMD_UNIT_ACTIVE=\&...\fR +and +\fIX_SYSTEMD_UNIT_INACTIVE=\&...\fR +messages will be sent out for each target unit as it becomes active or stops being active\&. This is useful to track boot progress and functionality\&. For example, once the +ssh\-access\&.target +unit is reported started SSH access is typically available, see +\fBsystemd.special\fR(7) +for details\&. +.sp +Added in version 256\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +An +\fIX_SYSTEMD_SHUTDOWN=\&...\fR +message will be sent out very shortly before the system shuts down\&. The value is one of the strings +"reboot", +"halt", +"poweroff", +"kexec" +and indicates which kind of shutdown is being executed\&. +.sp +Added in version 256\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +An +\fIX_SYSTEMD_REBOOT_PARAMETER=\&...\fR +message will also be sent out very shortly before the system shuts down\&. Its value is the reboot argument as configured with +\fBsystemctl \-\-reboot\-argument=\&...\fR\&. +.sp +Added in version 256\&. +.RE +.PP +Note that these extension fields are sent in addition to the regular +"READY=1" +and +"RELOADING=1" +notifications\&. .SH "OPTIONS" .PP \fBsystemd\fR @@ -1355,7 +1536,7 @@ Enable core dumping on crash\&. This switch has no effect when running as user i above\&. .RE .PP -\fB\-\-crash\-vt=\fR\fIVT\fR +\fB\-\-crash\-vt=\fR\fB\fIVT\fR\fR .RS 4 Switch to a specific virtual console (VT) on crash\&. This switch has no effect when running as user instance\&. Same as \fIsystemd\&.crash_chvt=\fR @@ -1371,13 +1552,13 @@ Run a shell on crash\&. This switch has no effect when running as user instance\ above\&. .RE .PP -\fB\-\-crash\-reboot\fR +\fB\-\-crash\-action=\fR .RS 4 -Automatically reboot the system on crash\&. This switch has no effect when running as user instance\&. See -\fIsystemd\&.crash_reboot\fR +Specify what to do when the system manager (PID 1) crashes\&. This switch has no effect when systemd is running as user instance\&. See +\fIsystemd\&.crash_action=\fR above\&. .sp -Added in version 227\&. +Added in version 256\&. .RE .PP \fB\-\-confirm\-spawn\fR @@ -1502,22 +1683,7 @@ Added in version 252\&. .RE .SH "SEE ALSO" .PP -The -\m[blue]\fBsystemd Homepage\fR\m[]\&\s-2\u[9]\d\s+2, -\fBsystemd-system.conf\fR(5), -\fBlocale.conf\fR(5), -\fBsystemctl\fR(1), -\fBjournalctl\fR(1), -\fBsystemd-notify\fR(1), -\fBdaemon\fR(7), -\fBsd-daemon\fR(3), -\fBorg.freedesktop.systemd1\fR(5), -\fBsystemd.unit\fR(5), -\fBsystemd.special\fR(7), -\fBpkg-config\fR(1), -\fBkernel-command-line\fR(7), -\fBbootup\fR(7), -\fBsystemd.directives\fR(7) +The \m[blue]\fBsystemd Homepage\fR\m[]\&\s-2\u[9]\d\s+2, \fBsystemd-system.conf\fR(5), \fBlocale.conf\fR(5), \fBsystemctl\fR(1), \fBjournalctl\fR(1), \fBsystemd-notify\fR(1), \fBdaemon\fR(7), \fBsd-daemon\fR(3), \fBorg.freedesktop.systemd1\fR(5), \fBsystemd.unit\fR(5), \fBsystemd.special\fR(7), \fBpkg-config\fR(1), \fBkernel-command-line\fR(7), \fBbootup\fR(7), \fBsystemd.directives\fR(7) .SH "NOTES" .IP " 1." 4 Control Groups v2 diff --git a/upstream/fedora-rawhide/man1/tac.1 b/upstream/fedora-rawhide/man1/tac.1 index 0dc5b04b..ab18ea3b 100644 --- a/upstream/fedora-rawhide/man1/tac.1 +++ b/upstream/fedora-rawhide/man1/tac.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH TAC "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH TAC "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME tac \- concatenate and print files in reverse .SH SYNOPSIS @@ -35,7 +35,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/tail.1 b/upstream/fedora-rawhide/man1/tail.1 index ceedfc92..58239af9 100644 --- a/upstream/fedora-rawhide/man1/tail.1 +++ b/upstream/fedora-rawhide/man1/tail.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH TAIL "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH TAIL "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME tail \- output the last part of files .SH SYNOPSIS @@ -40,7 +40,8 @@ to see if it has been unlinked or renamed with inotify, this option is rarely useful .TP \fB\-\-pid\fR=\fI\,PID\/\fR -with \fB\-f\fR, terminate after process ID, PID dies +with \fB\-f\fR, terminate after process ID, PID dies; +can be repeated to watch multiple processes .TP \fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR never output headers giving file names @@ -85,7 +86,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/tee.1 b/upstream/fedora-rawhide/man1/tee.1 index 9be88388..0384e31c 100644 --- a/upstream/fedora-rawhide/man1/tee.1 +++ b/upstream/fedora-rawhide/man1/tee.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH TEE "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH TEE "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME tee \- read from standard input and write to standard output and files .SH SYNOPSIS @@ -53,7 +53,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/test.1 b/upstream/fedora-rawhide/man1/test.1 index d26d04ba..73150ed8 100644 --- a/upstream/fedora-rawhide/man1/test.1 +++ b/upstream/fedora-rawhide/man1/test.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH TEST "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH TEST "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME test \- check file types and compare values .SH SYNOPSIS @@ -149,13 +149,12 @@ Except for \fB\-h\fR and \fB\-L\fR, all FILE\-related tests dereference symbolic Beware that parentheses need to be escaped (e.g., by backslashes) for shells. INTEGER may also be \fB\-l\fR STRING, which evaluates to the length of STRING. .PP -NOTE: Binary \fB\-a\fR and \fB\-o\fR are inherently ambiguous. Use 'test EXPR1 && test -EXPR2' or 'test EXPR1 || test EXPR2' instead. +Binary \fB\-a\fR and \fB\-o\fR are ambiguous. Use 'test EXPR1 && test EXPR2' +or 'test EXPR1 || test EXPR2' instead. .PP -NOTE: [ honors the \fB\-\-help\fR and \fB\-\-version\fR options, but test does not. -test treats each of those as it treats any other nonempty STRING. +\&'[' honors \fB\-\-help\fR and \fB\-\-version\fR, but 'test' treats them as STRINGs. .PP -NOTE: your shell may have its own version of test and/or [, which usually supersedes +Your shell may have its own version of test and/or [, which usually supersedes the version described here. Please refer to your shell's documentation for details about the options it supports. .SH AUTHOR @@ -165,7 +164,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/time.1 b/upstream/fedora-rawhide/man1/time.1 index 9b0f2c46..6e4ea376 100644 --- a/upstream/fedora-rawhide/man1/time.1 +++ b/upstream/fedora-rawhide/man1/time.1 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH time 1 2023-10-31 "Linux man-pages 6.06" +.TH time 1 2023-10-31 "Linux man-pages 6.7" .SH NAME time \- time a simple command or give resource usage .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/timedatectl.1 b/upstream/fedora-rawhide/man1/timedatectl.1 index 1a6738e0..4391edd9 100644 --- a/upstream/fedora-rawhide/man1/timedatectl.1 +++ b/upstream/fedora-rawhide/man1/timedatectl.1 @@ -1,5 +1,5 @@ '\" t -.TH "TIMEDATECTL" "1" "" "systemd 255" "timedatectl" +.TH "TIMEDATECTL" "1" "" "systemd 256~rc3" "timedatectl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -215,6 +215,19 @@ When printing properties with Added in version 239\&. .RE .PP +\fB\-P\fR +.RS 4 +Equivalent to +\fB\-\-value\fR +\fB\-\-property=\fR, i\&.e\&. shows the value of the property without the property name or +"="\&. Note that using +\fB\-P\fR +once will also affect all properties listed with +\fB\-p\fR/\fB\-\-property=\fR\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-H\fR, \fB\-\-host=\fR .RS 4 Execute the operation remotely\&. Specify a hostname, or a username and hostname separated by @@ -261,7 +274,7 @@ On success, 0 is returned, a non\-zero failure code otherwise\&. .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, @@ -271,7 +284,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 @@ -390,6 +411,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\&. @@ -401,6 +428,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 @@ -541,11 +574,4 @@ Root distance: 335us (max: 5s) .sp .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBhwclock\fR(8), -\fBdate\fR(1), -\fBlocaltime\fR(5), -\fBsystemctl\fR(1), -\fBsystemd-timedated.service\fR(8), -\fBsystemd-timesyncd.service\fR(8), -\fBsystemd-firstboot\fR(1) +\fBsystemd\fR(1), \fBhwclock\fR(8), \fBdate\fR(1), \fBlocaltime\fR(5), \fBsystemctl\fR(1), \fBsystemd-timedated.service\fR(8), \fBsystemd-timesyncd.service\fR(8), \fBsystemd-firstboot\fR(1) diff --git a/upstream/fedora-rawhide/man1/timeout.1 b/upstream/fedora-rawhide/man1/timeout.1 index 70e27d5c..cfd15f65 100644 --- a/upstream/fedora-rawhide/man1/timeout.1 +++ b/upstream/fedora-rawhide/man1/timeout.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH TIMEOUT "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH TIMEOUT "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME timeout \- run a command with a time limit .SH SYNOPSIS @@ -85,7 +85,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/touch.1 b/upstream/fedora-rawhide/man1/touch.1 index f562a6c4..861b9490 100644 --- a/upstream/fedora-rawhide/man1/touch.1 +++ b/upstream/fedora-rawhide/man1/touch.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH TOUCH "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH TOUCH "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME touch \- change file timestamps .SH SYNOPSIS @@ -41,21 +41,20 @@ change only the modification time \fB\-r\fR, \fB\-\-reference\fR=\fI\,FILE\/\fR use this file's times instead of current time .TP -\fB\-t\fR STAMP -use [[CC]YY]MMDDhhmm[.ss] instead of current time +\fB\-t\fR [[CC]YY]MMDDhhmm[.ss] +use specified time instead of current time, +with a date\-time format that differs from \fB\-d\fR's .TP \fB\-\-time\fR=\fI\,WORD\/\fR -change the specified time: -WORD is access, atime, or use: equivalent to \fB\-a\fR -WORD is modify or mtime: equivalent to \fB\-m\fR +specify which time to change: +access time (\fB\-a\fR): 'access', 'atime', 'use'; +modification time (\fB\-m\fR): 'modify', 'mtime' .TP \fB\-\-help\fR display this help and exit .TP \fB\-\-version\fR output version information and exit -.PP -Note that the \fB\-d\fR and \fB\-t\fR options accept different time\-date formats. .SH "DATE STRING" .\" NOTE: keep this paragraph in sync with the one in date.x The --date=STRING is a mostly free format human readable date string @@ -73,7 +72,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/tr.1 b/upstream/fedora-rawhide/man1/tr.1 index 6c12a59c..6dedf45a 100644 --- a/upstream/fedora-rawhide/man1/tr.1 +++ b/upstream/fedora-rawhide/man1/tr.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH TR "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH TR "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME tr \- translate or delete characters .SH SYNOPSIS @@ -132,7 +132,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/true.1 b/upstream/fedora-rawhide/man1/true.1 index a9e769ef..6a476b0f 100644 --- a/upstream/fedora-rawhide/man1/true.1 +++ b/upstream/fedora-rawhide/man1/true.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH TRUE "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH TRUE "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME true \- do nothing, successfully .SH SYNOPSIS @@ -19,7 +19,7 @@ display this help and exit \fB\-\-version\fR output version information and exit .PP -NOTE: your shell may have its own version of true, which usually supersedes +Your shell may have its own version of true, which usually supersedes the version described here. Please refer to your shell's documentation for details about the options it supports. .SH AUTHOR @@ -29,7 +29,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/truncate.1 b/upstream/fedora-rawhide/man1/truncate.1 index 6973314f..b1148aea 100644 --- a/upstream/fedora-rawhide/man1/truncate.1 +++ b/upstream/fedora-rawhide/man1/truncate.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH TRUNCATE "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH TRUNCATE "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME truncate \- shrink or extend the size of a file to the specified size .SH SYNOPSIS @@ -50,7 +50,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/tsort.1 b/upstream/fedora-rawhide/man1/tsort.1 index f61e36f7..3685681b 100644 --- a/upstream/fedora-rawhide/man1/tsort.1 +++ b/upstream/fedora-rawhide/man1/tsort.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH TSORT "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH TSORT "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME tsort \- perform topological sort .SH SYNOPSIS @@ -24,7 +24,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/tty.1 b/upstream/fedora-rawhide/man1/tty.1 index f79e8155..7b711635 100644 --- a/upstream/fedora-rawhide/man1/tty.1 +++ b/upstream/fedora-rawhide/man1/tty.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH TTY "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH TTY "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME tty \- print the file name of the terminal connected to standard input .SH SYNOPSIS @@ -25,7 +25,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/ukify.1 b/upstream/fedora-rawhide/man1/ukify.1 index 00e7ff62..10123b4f 100644 --- a/upstream/fedora-rawhide/man1/ukify.1 +++ b/upstream/fedora-rawhide/man1/ukify.1 @@ -1,5 +1,5 @@ '\" t -.TH "UKIFY" "1" "" "systemd 255" "ukify" +.TH "UKIFY" "1" "" "systemd 256~rc3" "ukify" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -52,6 +52,7 @@ accepts multiple whitespace\-separated paths and can be specified multiple times\&. .PP Additional sections will be inserted into the UKI, either automatically or only if a specific option is provided\&. See the discussions of +\fIMicrocode=\fR/\fB\-\-microcode=\fR, \fICmdline=\fR/\fB\-\-cmdline=\fR, \fIOSRelease=\fR/\fB\-\-os\-release=\fR, \fIDeviceTree=\fR/\fB\-\-devicetree=\fR, @@ -89,7 +90,9 @@ are used, they must be specified the same number of times, and then the n\-th bo \fIPCRPrivateKey=\fR, \fIPCRPublicKey=\fR, and \fIPhases=\fR -are grouped into separate sections, describing separate boot phases\&. +are grouped into separate sections, describing separate boot phases\&. If +\fISigningEngine=\fR/\fB\-\-signing\-engine=\fR +is specified, then the private keys arguments will be passed verbatim to OpenSSL as URIs, and the public key arguments will be loaded as X\&.509 certificates, so that signing can be performed with an OpenSSL engine\&. .PP If a SecureBoot signing key is provided via the \fISecureBootPrivateKey=\fR/\fB\-\-secureboot\-private\-key=\fR @@ -123,6 +126,12 @@ Also see the description of \fB\-j\fR/\fB\-\-json=\fR and \fB\-\-section=\fR\&. +.PP +Other tools that may be useful for inspect UKIs: +\fBllvm-objdump\fR(1) +\fB\-p\fR +and +\fBpe\-inspect\fR\&. .SH "CONFIGURATION SETTINGS" .PP Settings can appear in configuration files (the syntax with @@ -133,8 +142,8 @@ If no config file is provided via the option \fB\-\-config=\fR\fB\fIPATH\fR\fR, \fBukify\fR will try to look for a default configuration file in the following paths in this order: -/run/systemd/ukify\&.conf, /etc/systemd/ukify\&.conf, +/run/systemd/ukify\&.conf, /usr/local/lib/systemd/ukify\&.conf, and /usr/lib/systemd/ukify\&.conf, and then load the first one found\&. \fBukify\fR @@ -169,7 +178,7 @@ to print pre\-calculated PCR values\&. Defaults to false\&. Added in version 253\&. .RE .PP -\fB\-\-section=\fR\fB\fINAME\fR\fR\fB:\fR\fB\fITEXT\fR\fR\fB|\fR\fB\fI@PATH\fR\fR, \fB\-\-section=\fR\fB\fINAME\fR\fR\fB:\fR\fBtext|binary\fR\fB[@\fIPATH\fR]\fR +\fB\-\-section=\fR\fB\fINAME\fR\fR\fB:\fR\fB\fITEXT\fR\fR\fB|\fR\fB\fI@PATH\fR\fR, \fB\-\-section=\fR\fB\fINAME\fR\fR\fB:text|binary\fR\fB[@\fIPATH\fR]\fR .RS 4 For all verbs except \fBinspect\fR, the first syntax is used\&. Specify an arbitrary additional section @@ -267,6 +276,13 @@ Zero or more initrd paths\&. In the configuration file, items are separated by w Added in version 254\&. .RE .PP +\fIMicrocode=\fR\fI\fIUCODE\fR\fR, \fB\-\-microcode=\fR\fB\fIUCODE\fR\fR +.RS 4 +Path to initrd containing microcode updates\&. If not specified, the section will not be present\&. +.sp +Added in version 256\&. +.RE +.PP \fICmdline=\fR\fI\fITEXT\fR\fR\fI|\fR\fI\fI@PATH\fR\fR, \fB\-\-cmdline=\fR\fB\fITEXT\fR\fR\fB|\fR\fB\fI@PATH\fR\fR .RS 4 The kernel command line (the @@ -421,8 +437,10 @@ Added in version 253\&. \fISBAT=\fR\fI\fITEXT\fR\fR\fI|\fR\fI\fI@PATH\fR\fR, \fB\-\-sbat=\fR\fB\fITEXT\fR\fR\fB|\fR\fB\fI@PATH\fR\fR .RS 4 SBAT metadata associated with the UKI or addon\&. SBAT policies are useful to revoke whole groups of UKIs or addons with a single, static policy update that does not take space in DBX/MOKX\&. If not specified manually, a default metadata entry consisting of -"uki,1,UKI,uki,1,https://www\&.freedesktop\&.org/software/systemd/man/systemd\-stub\&.html" -will be used, to ensure it is always possible to revoke UKIs and addons\&. For more information on SBAT see +"uki,1,UKI,uki,1,https://uapi\-group\&.org/specifications/specs/unified_kernel_image/" +for UKIs and +"uki\-addon,1,UKI Addon,addon,1,https://www\&.freedesktop\&.org/software/systemd/man/latest/systemd\-stub\&.html" +for addons will be used, to ensure it is always possible to revoke them\&. For more information on SBAT see \m[blue]\fBShim documentation\fR\m[]\&\s-2\u[2]\d\s+2\&. .sp Added in version 254\&. @@ -495,7 +513,7 @@ $ ukify build \e \-\-initrd=early_cpio \e \-\-initrd=/some/path/initramfs\-6\&.0\&.9\-300\&.fc37\&.x86_64\&.img \e \-\-sbat=\*(Aqsbat,1,SBAT Version,sbat,1,https://github\&.com/rhboot/shim/blob/main/SBAT\&.md - uki\&.author\&.myimage,1,UKI for System,uki\&.author\&.myimage,1,https://www\&.freedesktop\&.org/software/systemd/man/systemd\-stub\&.html\*(Aq \e + uki\&.author\&.myimage,1,UKI for System,uki\&.author\&.myimage,1,https://uapi\-group\&.org/specifications/specs/unified_kernel_image/\*(Aq \e \-\-pcr\-private\-key=pcr\-private\-initrd\-key\&.pem \e \-\-pcr\-public\-key=pcr\-public\-initrd\-key\&.pem \e \-\-phases=\*(Aqenter\-initrd\*(Aq \e @@ -582,7 +600,7 @@ ukify build \e \-\-secureboot\-certificate=sb\&.cert \e \-\-cmdline=\*(Aqdebug\*(Aq \e \-\-sbat=\*(Aqsbat,1,SBAT Version,sbat,1,https://github\&.com/rhboot/shim/blob/main/SBAT\&.md - uki\&.addon\&.author,1,UKI Addon for System,uki\&.addon\&.author,1,https://www\&.freedesktop\&.org/software/systemd/man/systemd\-stub\&.html\*(Aq + uki\-addon\&.author,1,UKI Addon for System,uki\-addon\&.author,1,https://www\&.freedesktop\&.org/software/systemd/man/systemd\-stub\&.html\*(Aq \-\-output=debug\&.cmdline .fi @@ -655,11 +673,7 @@ by default, so after this file has been created, installations of kernels that c will perform signing using this config\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-stub\fR(7), -\fBsystemd-boot\fR(7), -\fBsystemd-measure\fR(1), -\fBsystemd-pcrphase.service\fR(8) +\fBsystemd\fR(1), \fBsystemd-stub\fR(7), \fBsystemd-boot\fR(7), \fBsystemd-measure\fR(1), \fBsystemd-pcrphase.service\fR(8) .SH "NOTES" .IP " 1." 4 Unified Kernel Image (UKI) diff --git a/upstream/fedora-rawhide/man1/uname.1 b/upstream/fedora-rawhide/man1/uname.1 index eedf99ee..709abec5 100644 --- a/upstream/fedora-rawhide/man1/uname.1 +++ b/upstream/fedora-rawhide/man1/uname.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH UNAME "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH UNAME "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME uname \- print system information .SH SYNOPSIS @@ -50,7 +50,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/unexpand.1 b/upstream/fedora-rawhide/man1/unexpand.1 index 10f88ede..3705ae48 100644 --- a/upstream/fedora-rawhide/man1/unexpand.1 +++ b/upstream/fedora-rawhide/man1/unexpand.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH UNEXPAND "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH UNEXPAND "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME unexpand \- convert spaces to tabs .SH SYNOPSIS @@ -43,7 +43,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/uniq.1 b/upstream/fedora-rawhide/man1/uniq.1 index 3e5c45c6..7a88e3ee 100644 --- a/upstream/fedora-rawhide/man1/uniq.1 +++ b/upstream/fedora-rawhide/man1/uniq.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH UNIQ "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH UNIQ "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME uniq \- report or omit repeated lines .SH SYNOPSIS @@ -60,7 +60,7 @@ output version information and exit A field is a run of blanks (usually spaces and/or TABs), then non\-blank characters. Fields are skipped before chars. .PP -Note: 'uniq' does not detect repeated lines unless they are adjacent. +\&'uniq' does not detect repeated lines unless they are adjacent. You may want to sort the input first, or use 'sort \fB\-u\fR' without 'uniq'. .SH AUTHOR Written by Richard M. Stallman and David MacKenzie. @@ -69,7 +69,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/unlink.1 b/upstream/fedora-rawhide/man1/unlink.1 index f92605ee..878efa9c 100644 --- a/upstream/fedora-rawhide/man1/unlink.1 +++ b/upstream/fedora-rawhide/man1/unlink.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH UNLINK "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH UNLINK "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME unlink \- call the unlink function to remove the specified file .SH SYNOPSIS @@ -25,7 +25,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/userdbctl.1 b/upstream/fedora-rawhide/man1/userdbctl.1 index a5445353..b77cbec6 100644 --- a/upstream/fedora-rawhide/man1/userdbctl.1 +++ b/upstream/fedora-rawhide/man1/userdbctl.1 @@ -1,5 +1,5 @@ '\" t -.TH "USERDBCTL" "1" "" "systemd 255" "userdbctl" +.TH "USERDBCTL" "1" "" "systemd 256~rc3" "userdbctl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -41,7 +41,7 @@ definitions), and classic UNIX NSS/glibc user and group records\&. This tool is .PP The following options are understood: .PP -\fB\-\-output=\fR\fIMODE\fR +\fB\-\-output=\fR\fB\fIMODE\fR\fR .RS 4 Choose the output mode, takes one of "classic", @@ -75,7 +75,7 @@ to view all fields, including any authentication fields\&. Added in version 245\&. .RE .PP -\fB\-\-json=\fR\fIFORMAT\fR +\fB\-\-json=\fR\fB\fIFORMAT\fR\fR .RS 4 Selects JSON output mode (like \fB\-\-output=json\fR) and selects the precise display mode\&. Takes one of @@ -88,7 +88,7 @@ or Added in version 250\&. .RE .PP -\fB\-\-service=\fR\fISERVICE\fR[:\fISERVICE\&...\fR], \fB\-s\fR \fISERVICE\fR:\fISERVICE\&...\fR +\fB\-\-service=\fR\fB\fISERVICE\fR\fR\fB[:\fISERVICE\&...\fR]\fR, \fB\-s\fR \fISERVICE\fR:\fISERVICE\&...\fR .RS 4 Controls which services to query for users/groups\&. Takes a list of one or more service names, separated by ":"\&. See below for a list of well\-known service names\&. If not specified all available services are queried at once\&. @@ -96,7 +96,7 @@ Controls which services to query for users/groups\&. Takes a list of one or more Added in version 245\&. .RE .PP -\fB\-\-with\-nss=\fR\fIBOOL\fR +\fB\-\-with\-nss=\fR\fB\fIBOOL\fR\fR .RS 4 Controls whether to include classic glibc/NSS user/group lookups in the output\&. If \fB\-\-with\-nss=no\fR @@ -107,7 +107,7 @@ is specified such users/groups are included in the output (which is the default) Added in version 245\&. .RE .PP -\fB\-\-with\-varlink=\fR\fIBOOL\fR +\fB\-\-with\-varlink=\fR\fB\fIBOOL\fR\fR .RS 4 Controls whether to include Varlink user/group lookups in the output, i\&.e\&. those done via the \m[blue]\fBUser/Group Record Lookup API via Varlink\fR\m[]\&\s-2\u[3]\d\s+2\&. If @@ -119,7 +119,7 @@ is specified such users/groups are included in the output (which is the default) Added in version 249\&. .RE .PP -\fB\-\-with\-dropin=\fR\fIBOOL\fR +\fB\-\-with\-dropin=\fR\fB\fIBOOL\fR\fR .RS 4 Controls whether to include user/group lookups in the output that are defined using drop\-in files in /etc/userdb/, @@ -134,7 +134,7 @@ is specified such users/groups are included in the output (which is the default) Added in version 249\&. .RE .PP -\fB\-\-synthesize=\fR\fIBOOL\fR +\fB\-\-synthesize=\fR\fB\fIBOOL\fR\fR .RS 4 Controls whether to synthesize records for the root and nobody users/groups if they aren\*(Aqt defined otherwise\&. By default (or "yes") such records are implicitly synthesized if otherwise missing since they have special significance to the OS\&. When @@ -153,7 +153,7 @@ This option is short for Added in version 245\&. .RE .PP -\fB\-\-multiplexer=\fR\fIBOOL\fR +\fB\-\-multiplexer=\fR\fB\fIBOOL\fR\fR .RS 4 Controls whether to do lookups via the multiplexer service (if specified as true, the default) or do lookups in the client (if specified as false)\&. Using the multiplexer service is typically preferable, since it runs in a locked down sandbox\&. .sp @@ -377,7 +377,7 @@ On success, 0 is returned, a non\-zero failure code otherwise\&. .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, @@ -387,7 +387,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 @@ -506,6 +514,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\&. @@ -517,6 +531,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 @@ -572,11 +592,7 @@ and other conditions\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-userdbd.service\fR(8), -\fBsystemd-homed.service\fR(8), -\fBnss-systemd\fR(8), -\fBgetent\fR(1) +\fBsystemd\fR(1), \fBsystemd-userdbd.service\fR(8), \fBsystemd-homed.service\fR(8), \fBnss-systemd\fR(8), \fBgetent\fR(1) .SH "NOTES" .IP " 1." 4 JSON User Records diff --git a/upstream/fedora-rawhide/man1/users.1 b/upstream/fedora-rawhide/man1/users.1 index ed6a8acb..ab624239 100644 --- a/upstream/fedora-rawhide/man1/users.1 +++ b/upstream/fedora-rawhide/man1/users.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH USERS "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH USERS "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME users \- print the user names of users currently logged in to the current host .SH SYNOPSIS @@ -23,7 +23,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/varlinkctl.1 b/upstream/fedora-rawhide/man1/varlinkctl.1 index 61b4aa3c..3dd650e7 100644 --- a/upstream/fedora-rawhide/man1/varlinkctl.1 +++ b/upstream/fedora-rawhide/man1/varlinkctl.1 @@ -1,5 +1,5 @@ '\" t -.TH "VARLINKCTL" "1" "" "systemd 255" "varlinkctl" +.TH "VARLINKCTL" "1" "" "systemd 256~rc3" "varlinkctl" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -29,7 +29,7 @@ varlinkctl \- Introspect with and invoke Varlink services .HP \w'\fBvarlinkctl\fR\ 'u \fBvarlinkctl\fR [OPTIONS...] introspect \fIADDRESS\fR \fIINTERFACE\fR .HP \w'\fBvarlinkctl\fR\ 'u -\fBvarlinkctl\fR [OPTIONS...] call \fIADDRESS\fR \fIMETHOD\fR [\fIPARAMETERS\fR] +\fBvarlinkctl\fR [OPTIONS...] call \fIADDRESS\fR \fIMETHOD\fR [\fIARGUMENTS\fR] .HP \w'\fBvarlinkctl\fR\ 'u \fBvarlinkctl\fR [OPTIONS...] validate\-idl [\fIFILE\fR] .SH "DESCRIPTION" @@ -53,7 +53,7 @@ A Varlink service reference starting with the "unix:" string, followed by an absolute \fBAF_UNIX\fR -path, or by +socket path, or by "@" and an arbitrary string (the latter for referencing sockets in the abstract namespace)\&. .RE @@ -70,6 +70,22 @@ A Varlink service reference starting with the "exec:" string, followed by an absolute path of a binary to execute\&. .RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +A Varlink service reference starting with the +"ssh:" +string, followed by an SSH host specification, followed by +":", followed by an absolute +\fBAF_UNIX\fR +socket path\&. (This requires OpenSSH 9\&.4 or newer on the server side, abstract namespace sockets are not supported\&.) +.RE .PP For convenience these two simpler (redundant) service address syntaxes are also supported: .sp @@ -106,21 +122,21 @@ The following commands are understood: .PP \fBinfo\fR \fIADDRESS\fR .RS 4 -Show brief information about the specified service, including vendor name and list of implemented interfaces\&. Expects a service address in the formats described above\&. +Show brief information about the specified service, including vendor name and list of implemented interfaces\&. Expects a service address in one of the formats described above\&. .sp Added in version 255\&. .RE .PP \fBlist\-interfaces\fR \fIADDRESS\fR .RS 4 -Show list of interfaces implemented by the specified service\&. Expects a service address in the formats described above\&. +Show list of interfaces implemented by the specified service\&. Expects a service address in one of the formats described above\&. .sp Added in version 255\&. .RE .PP \fBintrospect\fR \fIADDRESS\fR \fIINTERFACE\fR .RS 4 -Show interface definition of the specified interface provided by the specified service\&. Expects a service address in the formats described above and a Varlink interface name\&. +Show interface definition of the specified interface provided by the specified service\&. Expects a service address in one of the formats described above and a Varlink interface name\&. .sp Added in version 255\&. .RE @@ -164,6 +180,15 @@ If this mode is enabled output is automatically switched to JSON\-SEQ mode, so t Added in version 255\&. .RE .PP +\fB\-\-collect\fR +.RS 4 +This is similar to +\fB\-\-more\fR +but collects all responses in a JSON array, and prints it, rather than in JSON_SEQ mode\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-\-oneway\fR .RS 4 When used with @@ -174,7 +199,7 @@ flag set (the command exits immediately after), which tells the service not to g Added in version 255\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Selects the JSON output formatting, one of "pretty" @@ -314,8 +339,7 @@ method Extend( .\} .SH "SEE ALSO" .PP -\fBbusctl\fR(1), -\m[blue]\fBVarlink\fR\m[]\&\s-2\u[1]\d\s+2 +\fBbusctl\fR(1), \m[blue]\fBVarlink\fR\m[]\&\s-2\u[1]\d\s+2 .SH "NOTES" .IP " 1." 4 Varlink diff --git a/upstream/fedora-rawhide/man1/vdir.1 b/upstream/fedora-rawhide/man1/vdir.1 index 50de3f56..2848dc6e 100644 --- a/upstream/fedora-rawhide/man1/vdir.1 +++ b/upstream/fedora-rawhide/man1/vdir.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH VDIR "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH VDIR "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME vdir \- list directory contents .SH SYNOPSIS @@ -51,7 +51,7 @@ list directories themselves, not their contents generate output designed for Emacs' dired mode .TP \fB\-f\fR -list all entries in directory order +do not sort, enable \fB\-aU\fR, disable \fB\-ls\fR \fB\-\-color\fR .TP \fB\-F\fR, \fB\-\-classify\fR[=\fI\,WHEN\/\fR] append indicator (one of */=>@|) to entries WHEN @@ -254,7 +254,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/wc.1 b/upstream/fedora-rawhide/man1/wc.1 index fe02c051..02924b38 100644 --- a/upstream/fedora-rawhide/man1/wc.1 +++ b/upstream/fedora-rawhide/man1/wc.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH WC "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH WC "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME wc \- print newline, word, and byte counts for each file .SH SYNOPSIS @@ -12,8 +12,8 @@ wc \- print newline, word, and byte counts for each file .\" Add any additional description here .PP Print newline, word, and byte counts for each FILE, and a total line if -more than one FILE is specified. A word is a non\-zero\-length sequence of -printable characters delimited by white space. +more than one FILE is specified. A word is a nonempty sequence of non white +space delimited by white space characters or by start or end of input. .PP With no FILE, or when FILE is \-, read standard input. .PP @@ -56,7 +56,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/wget2.1 b/upstream/fedora-rawhide/man1/wget2.1 index 29a4bea5..7f2386b5 100644 --- a/upstream/fedora-rawhide/man1/wget2.1 +++ b/upstream/fedora-rawhide/man1/wget2.1 @@ -2068,7 +2068,7 @@ Enable TLS SNI verification (default: on). .SS \f[V]--ocsp\f[R] .PP Enable OCSP server access to check the possible revocation the HTTPS -server certificate(s) (default: on). +server certificate(s) (default: off). .PP This procedure is pretty slow (connect to server, HTTP request, response) and thus we support OSCP stapling (server sends OCSP response diff --git a/upstream/fedora-rawhide/man1/who.1 b/upstream/fedora-rawhide/man1/who.1 index e3699fcf..589d5f9f 100644 --- a/upstream/fedora-rawhide/man1/who.1 +++ b/upstream/fedora-rawhide/man1/who.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH WHO "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH WHO "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME who \- show who is logged on .SH SYNOPSIS @@ -73,7 +73,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/whoami.1 b/upstream/fedora-rawhide/man1/whoami.1 index 424cb266..4f2c0541 100644 --- a/upstream/fedora-rawhide/man1/whoami.1 +++ b/upstream/fedora-rawhide/man1/whoami.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH WHOAMI "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH WHOAMI "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME whoami \- print effective user name .SH SYNOPSIS @@ -23,7 +23,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/xgettext.1 b/upstream/fedora-rawhide/man1/xgettext.1 index e2d7cb78..4a5d8d87 100644 --- a/upstream/fedora-rawhide/man1/xgettext.1 +++ b/upstream/fedora-rawhide/man1/xgettext.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. -.TH XGETTEXT "1" "September 2023" "GNU gettext-tools 0.22.2" "User Commands" +.TH XGETTEXT "1" "February 2024" "GNU gettext-tools 0.22.5" "User Commands" .SH NAME xgettext \- extract gettext strings from source .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man1/yes.1 b/upstream/fedora-rawhide/man1/yes.1 index 84be3fd6..c2281c9f 100644 --- a/upstream/fedora-rawhide/man1/yes.1 +++ b/upstream/fedora-rawhide/man1/yes.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. -.TH YES "1" "January 2024" "GNU coreutils 9.4" "User Commands" +.TH YES "1" "April 2024" "GNU coreutils 9.5" "User Commands" .SH NAME yes \- output a string repeatedly until killed .SH SYNOPSIS @@ -25,7 +25,7 @@ GNU coreutils online help: <https://www.gnu.org/software/coreutils/> .br Report any translation bugs to <https://translationproject.org/team/> .SH COPYRIGHT -Copyright \(co 2023 Free Software Foundation, Inc. +Copyright \(co 2024 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. .br This is free software: you are free to change and redistribute it. diff --git a/upstream/fedora-rawhide/man1/yum-builddep.1 b/upstream/fedora-rawhide/man1/yum-builddep.1 index 2e80fd56..84ff08b3 100644 --- a/upstream/fedora-rawhide/man1/yum-builddep.1 +++ b/upstream/fedora-rawhide/man1/yum-builddep.1 @@ -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-BUILDDEP" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "YUM-BUILDDEP" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME yum-builddep \- redirecting to DNF builddep Plugin .sp diff --git a/upstream/fedora-rawhide/man1/yum-changelog.1 b/upstream/fedora-rawhide/man1/yum-changelog.1 index 60105882..bfc85792 100644 --- a/upstream/fedora-rawhide/man1/yum-changelog.1 +++ b/upstream/fedora-rawhide/man1/yum-changelog.1 @@ -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-CHANGELOG" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "YUM-CHANGELOG" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME yum-changelog \- redirecting to DNF changelog Plugin .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man1/yum-config-manager.1 b/upstream/fedora-rawhide/man1/yum-config-manager.1 index 1aec5002..a62546a2 100644 --- a/upstream/fedora-rawhide/man1/yum-config-manager.1 +++ b/upstream/fedora-rawhide/man1/yum-config-manager.1 @@ -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-CONFIG-MANAGER" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "YUM-CONFIG-MANAGER" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME yum-config-manager \- redirecting to DNF config-manager Plugin .sp diff --git a/upstream/fedora-rawhide/man1/yum-debug-dump.1 b/upstream/fedora-rawhide/man1/yum-debug-dump.1 index f2fac375..ea3da337 100644 --- a/upstream/fedora-rawhide/man1/yum-debug-dump.1 +++ b/upstream/fedora-rawhide/man1/yum-debug-dump.1 @@ -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-DEBUG-DUMP" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "YUM-DEBUG-DUMP" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME yum-debug-dump \- redirecting to DNF debug Plugin .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man1/yum-debug-restore.1 b/upstream/fedora-rawhide/man1/yum-debug-restore.1 index 06d48e0b..a86e2d2e 100644 --- a/upstream/fedora-rawhide/man1/yum-debug-restore.1 +++ b/upstream/fedora-rawhide/man1/yum-debug-restore.1 @@ -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-DEBUG-RESTORE" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "YUM-DEBUG-RESTORE" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME yum-debug-restore \- redirecting to DNF debug Plugin .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man1/yum-groups-manager.1 b/upstream/fedora-rawhide/man1/yum-groups-manager.1 index 0378aa9a..704629f9 100644 --- a/upstream/fedora-rawhide/man1/yum-groups-manager.1 +++ b/upstream/fedora-rawhide/man1/yum-groups-manager.1 @@ -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-GROUPS-MANAGER" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "YUM-GROUPS-MANAGER" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME yum-groups-manager \- redirecting to DNF groups-manager Plugin .sp diff --git a/upstream/fedora-rawhide/man1/yum-utils.1 b/upstream/fedora-rawhide/man1/yum-utils.1 index a4ad0b92..6ecd624c 100644 --- a/upstream/fedora-rawhide/man1/yum-utils.1 +++ b/upstream/fedora-rawhide/man1/yum-utils.1 @@ -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-UTILS" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "YUM-UTILS" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME yum-utils \- classic YUM utilities implemented as CLI shims on top of DNF .sp diff --git a/upstream/fedora-rawhide/man1/yumdownloader.1 b/upstream/fedora-rawhide/man1/yumdownloader.1 index 993e0416..2ce01497 100644 --- a/upstream/fedora-rawhide/man1/yumdownloader.1 +++ b/upstream/fedora-rawhide/man1/yumdownloader.1 @@ -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 "YUMDOWNLOADER" "1" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "YUMDOWNLOADER" "1" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME yumdownloader \- redirecting to DNF download Plugin .sp diff --git a/upstream/fedora-rawhide/man1/zstd.1 b/upstream/fedora-rawhide/man1/zstd.1 index 286c6e3d..2b5a9851 100644 --- a/upstream/fedora-rawhide/man1/zstd.1 +++ b/upstream/fedora-rawhide/man1/zstd.1 @@ -1,388 +1,566 @@ -.TH "ZSTD" "1" "March 2023" "zstd 1.5.5" "User Commands" +. +.TH "ZSTD" "1" "March 2024" "zstd 1.5.6" "User Commands" +. .SH "NAME" \fBzstd\fR \- zstd, zstdmt, unzstd, zstdcat \- Compress or decompress \.zst files +. .SH "SYNOPSIS" -.TS -allbox; -\fBzstd\fR [\fIOPTIONS\fR] [\- \fIINPUT\-FILE\fR] [\-o \fIOUTPUT\-FILE\fR] -.TE +\fBzstd\fR [\fIOPTIONS\fR] [\-|\fIINPUT\-FILE\fR] [\-o \fIOUTPUT\-FILE\fR] +. .P \fBzstdmt\fR is equivalent to \fBzstd \-T0\fR +. .P \fBunzstd\fR is equivalent to \fBzstd \-d\fR +. .P \fBzstdcat\fR is equivalent to \fBzstd \-dcf\fR +. .SH "DESCRIPTION" -\fBzstd\fR is a fast lossless compression algorithm and data compression tool, with command line syntax similar to \fBgzip\fR(1) and \fBxz\fR(1)\. It is based on the \fBLZ77\fR family, with further FSE & huff0 entropy stages\. \fBzstd\fR offers highly configurable compression speed, from fast modes at > 200 MB/s per core, to strong modes with excellent compression ratios\. It also features a very fast decoder, with speeds > 500 MB/s per core\. +\fBzstd\fR is a fast lossless compression algorithm and data compression tool, with command line syntax similar to \fBgzip\fR(1) and \fBxz\fR(1)\. It is based on the \fBLZ77\fR family, with further FSE & huff0 entropy stages\. \fBzstd\fR offers highly configurable compression speed, from fast modes at > 200 MB/s per core, to strong modes with excellent compression ratios\. It also features a very fast decoder, with speeds > 500 MB/s per core, which remains roughly stable at all compression settings\. +. .P -\fBzstd\fR command line syntax is generally similar to gzip, but features the following differences: -.IP "\[ci]" 4 +\fBzstd\fR command line syntax is generally similar to gzip, but features the following few differences: +. +.IP "\(bu" 4 Source files are preserved by default\. It\'s possible to remove them automatically by using the \fB\-\-rm\fR command\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 When compressing a single file, \fBzstd\fR displays progress notifications and result summary by default\. Use \fB\-q\fR to turn them off\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fBzstd\fR displays a short help page when command line is an error\. Use \fB\-q\fR to turn it off\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fBzstd\fR does not accept input from console, though it does accept \fBstdin\fR when it\'s not the console\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fBzstd\fR does not store the input\'s filename or attributes, only its contents\. +. .IP "" 0 +. .P \fBzstd\fR processes each \fIfile\fR according to the selected operation mode\. If no \fIfiles\fR are given or \fIfile\fR is \fB\-\fR, \fBzstd\fR reads from standard input and writes the processed data to standard output\. \fBzstd\fR will refuse to write compressed data to standard output if it is a terminal: it will display an error message and skip the file\. Similarly, \fBzstd\fR will refuse to read compressed data from standard input if it is a terminal\. +. .P Unless \fB\-\-stdout\fR or \fB\-o\fR is specified, \fIfiles\fR are written to a new file whose name is derived from the source \fIfile\fR name: -.IP "\[ci]" 4 +. +.IP "\(bu" 4 When compressing, the suffix \fB\.zst\fR is appended to the source filename to get the target filename\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 When decompressing, the \fB\.zst\fR suffix is removed from the source filename to get the target filename +. .IP "" 0 +. .SS "Concatenation with \.zst Files" It is possible to concatenate multiple \fB\.zst\fR files\. \fBzstd\fR will decompress such agglomerated file as if it was a single \fB\.zst\fR file\. +. .SH "OPTIONS" +. .SS "Integer Suffixes and Special Values" In most places where an integer argument is expected, an optional suffix is supported to easily indicate large integers\. There must be no space between the integer and the suffix\. +. .TP \fBKiB\fR -Multiply the integer by 1,024 (2\e^10)\. \fBKi\fR, \fBK\fR, and \fBKB\fR are accepted as synonyms for \fBKiB\fR\. +Multiply the integer by 1,024 (2^10)\. \fBKi\fR, \fBK\fR, and \fBKB\fR are accepted as synonyms for \fBKiB\fR\. +. .TP \fBMiB\fR -Multiply the integer by 1,048,576 (2\e^20)\. \fBMi\fR, \fBM\fR, and \fBMB\fR are accepted as synonyms for \fBMiB\fR\. +Multiply the integer by 1,048,576 (2^20)\. \fBMi\fR, \fBM\fR, and \fBMB\fR are accepted as synonyms for \fBMiB\fR\. +. .SS "Operation Mode" If multiple operation mode options are given, the last one takes effect\. +. .TP \fB\-z\fR, \fB\-\-compress\fR Compress\. This is the default operation mode when no operation mode option is specified and no other operation mode is implied from the command name (for example, \fBunzstd\fR implies \fB\-\-decompress\fR)\. +. .TP \fB\-d\fR, \fB\-\-decompress\fR, \fB\-\-uncompress\fR Decompress\. +. .TP \fB\-t\fR, \fB\-\-test\fR Test the integrity of compressed \fIfiles\fR\. This option is equivalent to \fB\-\-decompress \-\-stdout > /dev/null\fR, decompressed data is discarded and checksummed for errors\. No files are created or removed\. +. .TP \fB\-b#\fR Benchmark file(s) using compression level \fI#\fR\. See \fIBENCHMARK\fR below for a description of this operation\. +. .TP \fB\-\-train FILES\fR Use \fIFILES\fR as a training set to create a dictionary\. The training set should contain a lot of small files (> 100)\. See \fIDICTIONARY BUILDER\fR below for a description of this operation\. +. .TP \fB\-l\fR, \fB\-\-list\fR Display information related to a zstd compressed file, such as size, ratio, and checksum\. Some of these fields may not be available\. This command\'s output can be augmented with the \fB\-v\fR modifier\. +. .SS "Operation Modifiers" -.IP "\[ci]" 4 -\fB\-#\fR: selects \fB#\fR compression level [1\-19] (default: 3) -.IP "\[ci]" 4 +. +.IP "\(bu" 4 +\fB\-#\fR: selects \fB#\fR compression level [1\-19] (default: 3)\. Higher compression levels \fIgenerally\fR produce higher compression ratio at the expense of speed and memory\. A rough rule of thumb is that compression speed is expected to be divided by 2 every 2 levels\. Technically, each level is mapped to a set of advanced parameters (that can also be modified individually, see below)\. Because the compressor\'s behavior highly depends on the content to compress, there\'s no guarantee of a smooth progression from one level to another\. +. +.IP "\(bu" 4 \fB\-\-ultra\fR: unlocks high compression levels 20+ (maximum 22), using a lot more memory\. Note that decompression will also require more memory when using these levels\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-fast[=#]\fR: switch to ultra\-fast compression levels\. If \fB=#\fR is not present, it defaults to \fB1\fR\. The higher the value, the faster the compression speed, at the cost of some compression ratio\. This setting overwrites compression level if one was set previously\. Similarly, if a compression level is set after \fB\-\-fast\fR, it overrides it\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-T#\fR, \fB\-\-threads=#\fR: Compress using \fB#\fR working threads (default: 1)\. If \fB#\fR is 0, attempt to detect and use the number of physical CPU cores\. In all cases, the nb of threads is capped to \fBZSTDMT_NBWORKERS_MAX\fR, which is either 64 in 32\-bit mode, or 256 for 64\-bit environments\. This modifier does nothing if \fBzstd\fR is compiled without multithread support\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-single\-thread\fR: Use a single thread for both I/O and compression\. As compression is serialized with I/O, this can be slightly slower\. Single\-thread mode features significantly lower memory usage, which can be useful for systems with limited amount of memory, such as 32\-bit systems\. +. .IP Note 1: this mode is the only available one when multithread support is disabled\. +. .IP Note 2: this mode is different from \fB\-T1\fR, which spawns 1 compression thread in parallel with I/O\. Final compressed result is also slightly different from \fB\-T1\fR\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-auto\-threads={physical,logical} (default: physical)\fR: When using a default amount of threads via \fB\-T0\fR, choose the default based on the number of detected physical or logical cores\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-adapt[=min=#,max=#]\fR: \fBzstd\fR will dynamically adapt compression level to perceived I/O conditions\. Compression level adaptation can be observed live by using command \fB\-v\fR\. Adaptation can be constrained between supplied \fBmin\fR and \fBmax\fR levels\. The feature works when combined with multi\-threading and \fB\-\-long\fR mode\. It does not work with \fB\-\-single\-thread\fR\. It sets window size to 8 MiB by default (can be changed manually, see \fBwlog\fR)\. Due to the chaotic nature of dynamic adaptation, compressed result is not reproducible\. +. .IP \fINote\fR: at the time of this writing, \fB\-\-adapt\fR can remain stuck at low speed when combined with multiple worker threads (>=2)\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-long[=#]\fR: enables long distance matching with \fB#\fR \fBwindowLog\fR, if \fB#\fR is not present it defaults to \fB27\fR\. This increases the window size (\fBwindowLog\fR) and memory usage for both the compressor and decompressor\. This setting is designed to improve the compression ratio for files with long matches at a large distance\. +. .IP Note: If \fBwindowLog\fR is set to larger than 27, \fB\-\-long=windowLog\fR or \fB\-\-memory=windowSize\fR needs to be passed to the decompressor\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-D DICT\fR: use \fBDICT\fR as Dictionary to compress or decompress FILE(s) -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-patch\-from FILE\fR: Specify the file to be used as a reference point for zstd\'s diff engine\. This is effectively dictionary compression with some convenient parameter selection, namely that \fIwindowSize\fR > \fIsrcSize\fR\. +. .IP Note: cannot use both this and \fB\-D\fR together\. +. .IP Note: \fB\-\-long\fR mode will be automatically activated if \fIchainLog\fR < \fIfileLog\fR (\fIfileLog\fR being the \fIwindowLog\fR required to cover the whole file)\. You can also manually force it\. +. .IP Note: for all levels, you can use \fB\-\-patch\-from\fR in \fB\-\-single\-thread\fR mode to improve compression ratio at the cost of speed\. +. .IP Note: for level 19, you can get increased compression ratio at the cost of speed by specifying \fB\-\-zstd=targetLength=\fR to be something large (i\.e\. 4096), and by setting a large \fB\-\-zstd=chainLog=\fR\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-rsyncable\fR: \fBzstd\fR will periodically synchronize the compression state to make the compressed file more rsync\-friendly\. There is a negligible impact to compression ratio, and a potential impact to compression speed, perceptible at higher speeds, for example when combining \fB\-\-rsyncable\fR with many parallel worker threads\. This feature does not work with \fB\-\-single\-thread\fR\. You probably don\'t want to use it with long range mode, since it will decrease the effectiveness of the synchronization points, but your mileage may vary\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-C\fR, \fB\-\-[no\-]check\fR: add integrity check computed from uncompressed data (default: enabled) -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-[no\-]content\-size\fR: enable / disable whether or not the original size of the file is placed in the header of the compressed file\. The default option is \fB\-\-content\-size\fR (meaning that the original size will be placed in the header)\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-no\-dictID\fR: do not store dictionary ID within frame header (dictionary compression)\. The decoder will have to rely on implicit knowledge about which dictionary to use, it won\'t be able to check if it\'s correct\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-M#\fR, \fB\-\-memory=#\fR: Set a memory usage limit\. By default, \fBzstd\fR uses 128 MiB for decompression as the maximum amount of memory the decompressor is allowed to use, but you can override this manually if need be in either direction (i\.e\. you can increase or decrease it)\. +. .IP This is also used during compression when using with \fB\-\-patch\-from=\fR\. In this case, this parameter overrides that maximum size allowed for a dictionary\. (128 MiB)\. +. .IP Additionally, this can be used to limit memory for dictionary training\. This parameter overrides the default limit of 2 GiB\. zstd will load training samples up to the memory limit and ignore the rest\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-stream\-size=#\fR: Sets the pledged source size of input coming from a stream\. This value must be exact, as it will be included in the produced frame header\. Incorrect stream sizes will cause an error\. This information will be used to better optimize compression parameters, resulting in better and potentially faster compression, especially for smaller source sizes\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-size\-hint=#\fR: When handling input from a stream, \fBzstd\fR must guess how large the source size will be when optimizing compression parameters\. If the stream size is relatively small, this guess may be a poor one, resulting in a higher compression ratio than expected\. This feature allows for controlling the guess when needed\. Exact guesses result in better compression ratios\. Overestimates result in slightly degraded compression ratios, while underestimates may result in significant degradation\. -.IP "\[ci]" 4 -\fB\-o FILE\fR: save result into \fBFILE\fR\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 +\fB\-\-target\-compressed\-block\-size=#\fR: Attempt to produce compressed blocks of approximately this size\. This will split larger blocks in order to approach this target\. This feature is notably useful for improved latency, when the receiver can leverage receiving early incomplete data\. This parameter defines a loose target: compressed blocks will target this size "on average", but individual blocks can still be larger or smaller\. Enabling this feature can decrease compression speed by up to ~10% at level 1\. Higher levels will see smaller relative speed regression, becoming invisible at higher settings\. +. +.IP "\(bu" 4 \fB\-f\fR, \fB\-\-force\fR: disable input and output checks\. Allows overwriting existing files, input from console, output to stdout, operating on links, block devices, etc\. During decompression and when the output destination is stdout, pass\-through unrecognized formats as\-is\. -.IP "\[ci]" 4 -\fB\-c\fR, \fB\-\-stdout\fR: write to standard output (even if it is the console); keep original files unchanged\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 +\fB\-c\fR, \fB\-\-stdout\fR: write to standard output (even if it is the console); keep original files (disable \fB\-\-rm\fR)\. +. +.IP "\(bu" 4 +\fB\-o FILE\fR: save result into \fBFILE\fR\. Note that this operation is in conflict with \fB\-c\fR\. If both operations are present on the command line, the last expressed one wins\. +. +.IP "\(bu" 4 \fB\-\-[no\-]sparse\fR: enable / disable sparse FS support, to make files with many zeroes smaller on disk\. Creating sparse files may save disk space and speed up decompression by reducing the amount of disk I/O\. default: enabled when output is into a file, and disabled when output is stdout\. This setting overrides default and can force sparse mode over stdout\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-[no\-]pass\-through\fR enable / disable passing through uncompressed files as\-is\. During decompression when pass\-through is enabled, unrecognized formats will be copied as\-is from the input to the output\. By default, pass\-through will occur when the output destination is stdout and the force (\fB\-f\fR) option is set\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-rm\fR: remove source file(s) after successful compression or decompression\. This command is silently ignored if output is \fBstdout\fR\. If used in combination with \fB\-o\fR, triggers a confirmation prompt (which can be silenced with \fB\-f\fR), as this is a destructive operation\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-k\fR, \fB\-\-keep\fR: keep source file(s) after successful compression or decompression\. This is the default behavior\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-r\fR: operate recursively on directories\. It selects all files in the named directory and all its subdirectories\. This can be useful both to reduce command line typing, and to circumvent shell expansion limitations, when there are a lot of files and naming breaks the maximum size of a command line\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-filelist FILE\fR read a list of files to process as content from \fBFILE\fR\. Format is compatible with \fBls\fR output, with one file per line\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-output\-dir\-flat DIR\fR: resulting files are stored into target \fBDIR\fR directory, instead of same directory as origin file\. Be aware that this command can introduce name collision issues, if multiple files, from different directories, end up having the same name\. Collision resolution ensures first file with a given name will be present in \fBDIR\fR, while in combination with \fB\-f\fR, the last file will be present instead\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-output\-dir\-mirror DIR\fR: similar to \fB\-\-output\-dir\-flat\fR, the output files are stored underneath target \fBDIR\fR directory, but this option will replicate input directory hierarchy into output \fBDIR\fR\. +. .IP If input directory contains "\.\.", the files in this directory will be ignored\. If input directory is an absolute directory (i\.e\. "/var/tmp/abc"), it will be stored into the "output\-dir/var/tmp/abc"\. If there are multiple input files or directories, name collision resolution will follow the same rules as \fB\-\-output\-dir\-flat\fR\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-format=FORMAT\fR: compress and decompress in other formats\. If compiled with support, zstd can compress to or decompress from other compression algorithm formats\. Possibly available options are \fBzstd\fR, \fBgzip\fR, \fBxz\fR, \fBlzma\fR, and \fBlz4\fR\. If no such format is provided, \fBzstd\fR is the default\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-h\fR/\fB\-H\fR, \fB\-\-help\fR: display help/long help and exit -.IP "\[ci]" 4 -\fB\-V\fR, \fB\-\-version\fR: display version number and exit\. Advanced: \fB\-vV\fR also displays supported formats\. \fB\-vvV\fR also displays POSIX support\. \fB\-q\fR will only display the version number, suitable for machine reading\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 +\fB\-V\fR, \fB\-\-version\fR: display version number and immediately exit\. note that, since it exits, flags specified after \fB\-V\fR are effectively ignored\. Advanced: \fB\-vV\fR also displays supported formats\. \fB\-vvV\fR also displays POSIX support\. \fB\-qV\fR will only display the version number, suitable for machine reading\. +. +.IP "\(bu" 4 \fB\-v\fR, \fB\-\-verbose\fR: verbose mode, display more information -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-q\fR, \fB\-\-quiet\fR: suppress warnings, interactivity, and notifications\. specify twice to suppress errors too\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-no\-progress\fR: do not display the progress bar, but keep all other messages\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 \fB\-\-show\-default\-cparams\fR: shows the default compression parameters that will be used for a particular input file, based on the provided compression level and the input size\. If the provided file is not a regular file (e\.g\. a pipe), this flag will output the parameters used for inputs of unknown size\. -.IP "\[ci]" 4 +. +.IP "\(bu" 4 +\fB\-\-exclude\-compressed\fR: only compress files that are not already compressed\. +. +.IP "\(bu" 4 \fB\-\-\fR: All arguments after \fB\-\-\fR are treated as files - -.SH Parallel Zstd OPTIONS -Additional options for the pzstd utility -.TP -.BR \-p ", " --processes - number of threads to use for (de)compression (default:4) - +. .IP "" 0 +. .SS "gzip Operation Modifiers" When invoked via a \fBgzip\fR symlink, \fBzstd\fR will support further options that intend to mimic the \fBgzip\fR behavior: +. .TP \fB\-n\fR, \fB\-\-no\-name\fR do not store the original filename and timestamps when compressing a file\. This is the default behavior and hence a no\-op\. +. .TP \fB\-\-best\fR alias to the option \fB\-9\fR\. +. .SS "Environment Variables" -Employing environment variables to set parameters has security implications\. Therefore, this avenue is intentionally limited\. Only \fBZSTD_CLEVEL\fR and \fBZSTD_NBTHREADS\fR are currently supported\. They set the compression level and number of threads to use during compression, respectively\. +Employing environment variables to set parameters has security implications\. Therefore, this avenue is intentionally limited\. Only \fBZSTD_CLEVEL\fR and \fBZSTD_NBTHREADS\fR are currently supported\. They set the default compression level and number of threads to use during compression, respectively\. +. .P \fBZSTD_CLEVEL\fR can be used to set the level between 1 and 19 (the "normal" range)\. If the value of \fBZSTD_CLEVEL\fR is not a valid integer, it will be ignored with a warning message\. \fBZSTD_CLEVEL\fR just replaces the default compression level (\fB3\fR)\. +. .P -\fBZSTD_NBTHREADS\fR can be used to set the number of threads \fBzstd\fR will attempt to use during compression\. If the value of \fBZSTD_NBTHREADS\fR is not a valid unsigned integer, it will be ignored with a warning message\. \fBZSTD_NBTHREADS\fR has a default value of (\fB1\fR), and is capped at ZSTDMT_NBWORKERS_MAX==200\. \fBzstd\fR must be compiled with multithread support for this to have any effect\. +\fBZSTD_NBTHREADS\fR can be used to set the number of threads \fBzstd\fR will attempt to use during compression\. If the value of \fBZSTD_NBTHREADS\fR is not a valid unsigned integer, it will be ignored with a warning message\. \fBZSTD_NBTHREADS\fR has a default value of (\fB1\fR), and is capped at ZSTDMT_NBWORKERS_MAX==200\. \fBzstd\fR must be compiled with multithread support for this variable to have any effect\. +. .P They can both be overridden by corresponding command line arguments: \fB\-#\fR for compression level and \fB\-T#\fR for number of compression threads\. -.SH "DICTIONARY BUILDER" -\fBzstd\fR offers \fIdictionary\fR compression, which greatly improves efficiency on small files and messages\. It\'s possible to train \fBzstd\fR with a set of samples, the result of which is saved into a file called a \fBdictionary\fR\. Then, during compression and decompression, reference the same dictionary, using command \fB\-D dictionaryFileName\fR\. Compression of small files similar to the sample set will be greatly improved\. -.TP -\fB\-\-train FILEs\fR -Use FILEs as training set to create a dictionary\. The training set should ideally contain a lot of samples (> 100), and weight typically 100x the target dictionary size (for example, ~10 MB for a 100 KB dictionary)\. \fB\-\-train\fR can be combined with \fB\-r\fR to indicate a directory rather than listing all the files, which can be useful to circumvent shell expansion limits\. -.IP -Since dictionary compression is mostly effective for small files, the expectation is that the training set will only contain small files\. In the case where some samples happen to be large, only the first 128 KiB of these samples will be used for training\. -.IP -\fB\-\-train\fR supports multithreading if \fBzstd\fR is compiled with threading support (default)\. Additional advanced parameters can be specified with \fB\-\-train\-fastcover\fR\. The legacy dictionary builder can be accessed with \fB\-\-train\-legacy\fR\. The slower cover dictionary builder can be accessed with \fB\-\-train\-cover\fR\. Default \fB\-\-train\fR is equivalent to \fB\-\-train\-fastcover=d=8,steps=4\fR\. -.TP -\fB\-o FILE\fR -Dictionary saved into \fBFILE\fR (default name: dictionary)\. -.TP -\fB\-\-maxdict=#\fR -Limit dictionary to specified size (default: 112640 bytes)\. As usual, quantities are expressed in bytes by default, and it\'s possible to employ suffixes (like \fBKB\fR or \fBMB\fR) to specify larger values\. -.TP -\fB\-#\fR -Use \fB#\fR compression level during training (optional)\. Will generate statistics more tuned for selected compression level, resulting in a \fIsmall\fR compression ratio improvement for this level\. -.TP -\fB\-B#\fR -Split input files into blocks of size # (default: no split) -.TP -\fB\-M#\fR, \fB\-\-memory=#\fR -Limit the amount of sample data loaded for training (default: 2 GB)\. Note that the default (2 GB) is also the maximum\. This parameter can be useful in situations where the training set size is not well controlled and could be potentially very large\. Since speed of the training process is directly correlated to the size of the training sample set, a smaller sample set leads to faster training\. -.IP -In situations where the training set is larger than maximum memory, the CLI will randomly select samples among the available ones, up to the maximum allowed memory budget\. This is meant to improve dictionary relevance by mitigating the potential impact of clustering, such as selecting only files from the beginning of a list sorted by modification date, or sorted by alphabetical order\. The randomization process is deterministic, so training of the same list of files with the same parameters will lead to the creation of the same dictionary\. -.TP -\fB\-\-dictID=#\fR -A dictionary ID is a locally unique ID\. The decoder will use this value to verify it is using the right dictionary\. By default, zstd will create a 4\-bytes random number ID\. It\'s possible to provide an explicit number ID instead\. It\'s up to the dictionary manager to not assign twice the same ID to 2 different dictionaries\. Note that short numbers have an advantage: an ID < 256 will only need 1 byte in the compressed frame header, and an ID < 65536 will only need 2 bytes\. This compares favorably to 4 bytes default\. -.IP -Note that RFC8878 reserves IDs less than 32768 and greater than or equal to 2\e^31, so they should not be used in public\. -.TP -\fB\-\-train\-cover[=k#,d=#,steps=#,split=#,shrink[=#]]\fR -Select parameters for the default dictionary builder algorithm named cover\. If \fId\fR is not specified, then it tries \fId\fR = 6 and \fId\fR = 8\. If \fIk\fR is not specified, then it tries \fIsteps\fR values in the range [50, 2000]\. If \fIsteps\fR is not specified, then the default value of 40 is used\. If \fIsplit\fR is not specified or split <= 0, then the default value of 100 is used\. Requires that \fId\fR <= \fIk\fR\. If \fIshrink\fR flag is not used, then the default value for \fIshrinkDict\fR of 0 is used\. If \fIshrink\fR is not specified, then the default value for \fIshrinkDictMaxRegression\fR of 1 is used\. -.IP -Selects segments of size \fIk\fR with highest score to put in the dictionary\. The score of a segment is computed by the sum of the frequencies of all the subsegments of size \fId\fR\. Generally \fId\fR should be in the range [6, 8], occasionally up to 16, but the algorithm will run faster with d <= \fI8\fR\. Good values for \fIk\fR vary widely based on the input data, but a safe range is [2 * \fId\fR, 2000]\. If \fIsplit\fR is 100, all input samples are used for both training and testing to find optimal \fId\fR and \fIk\fR to build dictionary\. Supports multithreading if \fBzstd\fR is compiled with threading support\. Having \fIshrink\fR enabled takes a truncated dictionary of minimum size and doubles in size until compression ratio of the truncated dictionary is at most \fIshrinkDictMaxRegression%\fR worse than the compression ratio of the largest dictionary\. -.IP -Examples: -.IP -\fBzstd \-\-train\-cover FILEs\fR -.IP -\fBzstd \-\-train\-cover=k=50,d=8 FILEs\fR -.IP -\fBzstd \-\-train\-cover=d=8,steps=500 FILEs\fR -.IP -\fBzstd \-\-train\-cover=k=50 FILEs\fR -.IP -\fBzstd \-\-train\-cover=k=50,split=60 FILEs\fR -.IP -\fBzstd \-\-train\-cover=shrink FILEs\fR -.IP -\fBzstd \-\-train\-cover=shrink=2 FILEs\fR -.TP -\fB\-\-train\-fastcover[=k#,d=#,f=#,steps=#,split=#,accel=#]\fR -Same as cover but with extra parameters \fIf\fR and \fIaccel\fR and different default value of split If \fIsplit\fR is not specified, then it tries \fIsplit\fR = 75\. If \fIf\fR is not specified, then it tries \fIf\fR = 20\. Requires that 0 < \fIf\fR < 32\. If \fIaccel\fR is not specified, then it tries \fIaccel\fR = 1\. Requires that 0 < \fIaccel\fR <= 10\. Requires that \fId\fR = 6 or \fId\fR = 8\. -.IP -\fIf\fR is log of size of array that keeps track of frequency of subsegments of size \fId\fR\. The subsegment is hashed to an index in the range [0,2^\fIf\fR \- 1]\. It is possible that 2 different subsegments are hashed to the same index, and they are considered as the same subsegment when computing frequency\. Using a higher \fIf\fR reduces collision but takes longer\. -.IP -Examples: -.IP -\fBzstd \-\-train\-fastcover FILEs\fR -.IP -\fBzstd \-\-train\-fastcover=d=8,f=15,accel=2 FILEs\fR -.TP -\fB\-\-train\-legacy[=selectivity=#]\fR -Use legacy dictionary builder algorithm with the given dictionary \fIselectivity\fR (default: 9)\. The smaller the \fIselectivity\fR value, the denser the dictionary, improving its efficiency but reducing its achievable maximum size\. \fB\-\-train\-legacy=s=#\fR is also accepted\. -.IP -Examples: -.IP -\fBzstd \-\-train\-legacy FILEs\fR -.IP -\fBzstd \-\-train\-legacy=selectivity=8 FILEs\fR -.SH "BENCHMARK" -.TP -\fB\-b#\fR -benchmark file(s) using compression level # -.TP -\fB\-e#\fR -benchmark file(s) using multiple compression levels, from \fB\-b#\fR to \fB\-e#\fR (inclusive) -.TP -\fB\-i#\fR -minimum evaluation time, in seconds (default: 3s), benchmark mode only -.TP -\fB\-B#\fR, \fB\-\-block\-size=#\fR -cut file(s) into independent chunks of size # (default: no chunking) -.TP -\fB\-\-priority=rt\fR -set process priority to real\-time -.P -\fBOutput Format:\fR CompressionLevel#Filename: InputSize \-> OutputSize (CompressionRatio), CompressionSpeed, DecompressionSpeed -.P -\fBMethodology:\fR For both compression and decompression speed, the entire input is compressed/decompressed in\-memory to measure speed\. A run lasts at least 1 sec, so when files are small, they are compressed/decompressed several times per run, in order to improve measurement accuracy\. +. .SH "ADVANCED COMPRESSION OPTIONS" -### \-B#: Specify the size of each compression job\. This parameter is only available when multi\-threading is enabled\. Each compression job is run in parallel, so this value indirectly impacts the nb of active threads\. Default job size varies depending on compression level (generally \fB4 * windowSize\fR)\. \fB\-B#\fR makes it possible to manually select a custom size\. Note that job size must respect a minimum value which is enforced transparently\. This minimum is either 512 KB, or \fBoverlapSize\fR, whichever is largest\. Different job sizes will lead to non\-identical compressed frames\. +\fBzstd\fR provides 22 predefined regular compression levels plus the fast levels\. A compression level is translated internally into multiple advanced parameters that control the behavior of the compressor (one can observe the result of this translation with \fB\-\-show\-default\-cparams\fR)\. These advanced parameters can be overridden using advanced compression options\. +. .SS "\-\-zstd[=options]:" -\fBzstd\fR provides 22 predefined regular compression levels plus the fast levels\. This compression level is translated internally into a number of specific parameters that actually control the behavior of the compressor\. (You can see the result of this translation with \fB\-\-show\-default\-cparams\fR\.) These specific parameters can be overridden with advanced compression options\. The \fIoptions\fR are provided as a comma\-separated list\. You may specify only the options you want to change and the rest will be taken from the selected or default compression level\. The list of available \fIoptions\fR: +The \fIoptions\fR are provided as a comma\-separated list\. You may specify only the options you want to change and the rest will be taken from the selected or default compression level\. The list of available \fIoptions\fR: +. .TP \fBstrategy\fR=\fIstrat\fR, \fBstrat\fR=\fIstrat\fR Specify a strategy used by a match finder\. +. .IP There are 9 strategies numbered from 1 to 9, from fastest to strongest: 1=\fBZSTD_fast\fR, 2=\fBZSTD_dfast\fR, 3=\fBZSTD_greedy\fR, 4=\fBZSTD_lazy\fR, 5=\fBZSTD_lazy2\fR, 6=\fBZSTD_btlazy2\fR, 7=\fBZSTD_btopt\fR, 8=\fBZSTD_btultra\fR, 9=\fBZSTD_btultra2\fR\. +. .TP \fBwindowLog\fR=\fIwlog\fR, \fBwlog\fR=\fIwlog\fR Specify the maximum number of bits for a match distance\. +. .IP The higher number of increases the chance to find a match which usually improves compression ratio\. It also increases memory requirements for the compressor and decompressor\. The minimum \fIwlog\fR is 10 (1 KiB) and the maximum is 30 (1 GiB) on 32\-bit platforms and 31 (2 GiB) on 64\-bit platforms\. +. .IP Note: If \fBwindowLog\fR is set to larger than 27, \fB\-\-long=windowLog\fR or \fB\-\-memory=windowSize\fR needs to be passed to the decompressor\. +. .TP \fBhashLog\fR=\fIhlog\fR, \fBhlog\fR=\fIhlog\fR Specify the maximum number of bits for a hash table\. +. .IP Bigger hash tables cause fewer collisions which usually makes compression faster, but requires more memory during compression\. +. .IP The minimum \fIhlog\fR is 6 (64 entries / 256 B) and the maximum is 30 (1B entries / 4 GiB)\. +. .TP \fBchainLog\fR=\fIclog\fR, \fBclog\fR=\fIclog\fR Specify the maximum number of bits for the secondary search structure, whose form depends on the selected \fBstrategy\fR\. +. .IP Higher numbers of bits increases the chance to find a match which usually improves compression ratio\. It also slows down compression speed and increases memory requirements for compression\. This option is ignored for the \fBZSTD_fast\fR \fBstrategy\fR, which only has the primary hash table\. +. .IP The minimum \fIclog\fR is 6 (64 entries / 256 B) and the maximum is 29 (512M entries / 2 GiB) on 32\-bit platforms and 30 (1B entries / 4 GiB) on 64\-bit platforms\. +. .TP \fBsearchLog\fR=\fIslog\fR, \fBslog\fR=\fIslog\fR Specify the maximum number of searches in a hash chain or a binary tree using logarithmic scale\. +. .IP More searches increases the chance to find a match which usually increases compression ratio but decreases compression speed\. +. .IP The minimum \fIslog\fR is 1 and the maximum is \'windowLog\' \- 1\. +. .TP \fBminMatch\fR=\fImml\fR, \fBmml\fR=\fImml\fR Specify the minimum searched length of a match in a hash table\. +. .IP Larger search lengths usually decrease compression ratio but improve decompression speed\. +. .IP The minimum \fImml\fR is 3 and the maximum is 7\. +. .TP \fBtargetLength\fR=\fItlen\fR, \fBtlen\fR=\fItlen\fR The impact of this field vary depending on selected strategy\. +. .IP For \fBZSTD_btopt\fR, \fBZSTD_btultra\fR and \fBZSTD_btultra2\fR, it specifies the minimum match length that causes match finder to stop searching\. A larger \fBtargetLength\fR usually improves compression ratio but decreases compression speed\. +. .IP For \fBZSTD_fast\fR, it triggers ultra\-fast mode when > 0\. The value represents the amount of data skipped between match sampling\. Impact is reversed: a larger \fBtargetLength\fR increases compression speed but decreases compression ratio\. +. .IP For all other strategies, this field has no impact\. +. .IP The minimum \fItlen\fR is 0 and the maximum is 128 KiB\. +. .TP \fBoverlapLog\fR=\fIovlog\fR, \fBovlog\fR=\fIovlog\fR Determine \fBoverlapSize\fR, amount of data reloaded from previous job\. This parameter is only available when multithreading is enabled\. Reloading more data improves compression ratio, but decreases speed\. +. .IP The minimum \fIovlog\fR is 0, and the maximum is 9\. 1 means "no overlap", hence completely independent jobs\. 9 means "full overlap", meaning up to \fBwindowSize\fR is reloaded from previous job\. Reducing \fIovlog\fR by 1 reduces the reloaded amount by a factor 2\. For example, 8 means "windowSize/2", and 6 means "windowSize/8"\. Value 0 is special and means "default": \fIovlog\fR is automatically determined by \fBzstd\fR\. In which case, \fIovlog\fR will range from 6 to 9, depending on selected \fIstrat\fR\. +. .TP \fBldmHashLog\fR=\fIlhlog\fR, \fBlhlog\fR=\fIlhlog\fR Specify the maximum size for a hash table used for long distance matching\. +. .IP This option is ignored unless long distance matching is enabled\. +. .IP Bigger hash tables usually improve compression ratio at the expense of more memory during compression and a decrease in compression speed\. +. .IP The minimum \fIlhlog\fR is 6 and the maximum is 30 (default: 20)\. +. .TP \fBldmMinMatch\fR=\fIlmml\fR, \fBlmml\fR=\fIlmml\fR Specify the minimum searched length of a match for long distance matching\. +. .IP This option is ignored unless long distance matching is enabled\. +. .IP Larger/very small values usually decrease compression ratio\. +. .IP The minimum \fIlmml\fR is 4 and the maximum is 4096 (default: 64)\. +. .TP \fBldmBucketSizeLog\fR=\fIlblog\fR, \fBlblog\fR=\fIlblog\fR Specify the size of each bucket for the hash table used for long distance matching\. +. .IP This option is ignored unless long distance matching is enabled\. +. .IP Larger bucket sizes improve collision resolution but decrease compression speed\. +. .IP The minimum \fIlblog\fR is 1 and the maximum is 8 (default: 3)\. +. .TP \fBldmHashRateLog\fR=\fIlhrlog\fR, \fBlhrlog\fR=\fIlhrlog\fR Specify the frequency of inserting entries into the long distance matching hash table\. +. .IP This option is ignored unless long distance matching is enabled\. +. .IP Larger values will improve compression speed\. Deviating far from the default value will likely result in a decrease in compression ratio\. +. .IP The default value is \fBwlog \- lhlog\fR\. +. .SS "Example" The following parameters sets advanced compression options to something similar to predefined level 19 for files bigger than 256 KB: +. .P \fB\-\-zstd\fR=wlog=23,clog=23,hlog=22,slog=6,mml=3,tlen=48,strat=6 +. +.SS "\-B#:" +Specify the size of each compression job\. This parameter is only available when multi\-threading is enabled\. Each compression job is run in parallel, so this value indirectly impacts the nb of active threads\. Default job size varies depending on compression level (generally \fB4 * windowSize\fR)\. \fB\-B#\fR makes it possible to manually select a custom size\. Note that job size must respect a minimum value which is enforced transparently\. This minimum is either 512 KB, or \fBoverlapSize\fR, whichever is largest\. Different job sizes will lead to non\-identical compressed frames\. +. +.SH "DICTIONARY BUILDER" +\fBzstd\fR offers \fIdictionary\fR compression, which greatly improves efficiency on small files and messages\. It\'s possible to train \fBzstd\fR with a set of samples, the result of which is saved into a file called a \fBdictionary\fR\. Then, during compression and decompression, reference the same dictionary, using command \fB\-D dictionaryFileName\fR\. Compression of small files similar to the sample set will be greatly improved\. +. +.TP +\fB\-\-train FILEs\fR +Use FILEs as training set to create a dictionary\. The training set should ideally contain a lot of samples (> 100), and weight typically 100x the target dictionary size (for example, ~10 MB for a 100 KB dictionary)\. \fB\-\-train\fR can be combined with \fB\-r\fR to indicate a directory rather than listing all the files, which can be useful to circumvent shell expansion limits\. +. +.IP +Since dictionary compression is mostly effective for small files, the expectation is that the training set will only contain small files\. In the case where some samples happen to be large, only the first 128 KiB of these samples will be used for training\. +. +.IP +\fB\-\-train\fR supports multithreading if \fBzstd\fR is compiled with threading support (default)\. Additional advanced parameters can be specified with \fB\-\-train\-fastcover\fR\. The legacy dictionary builder can be accessed with \fB\-\-train\-legacy\fR\. The slower cover dictionary builder can be accessed with \fB\-\-train\-cover\fR\. Default \fB\-\-train\fR is equivalent to \fB\-\-train\-fastcover=d=8,steps=4\fR\. +. +.TP +\fB\-o FILE\fR +Dictionary saved into \fBFILE\fR (default name: dictionary)\. +. +.TP +\fB\-\-maxdict=#\fR +Limit dictionary to specified size (default: 112640 bytes)\. As usual, quantities are expressed in bytes by default, and it\'s possible to employ suffixes (like \fBKB\fR or \fBMB\fR) to specify larger values\. +. +.TP +\fB\-#\fR +Use \fB#\fR compression level during training (optional)\. Will generate statistics more tuned for selected compression level, resulting in a \fIsmall\fR compression ratio improvement for this level\. +. +.TP +\fB\-B#\fR +Split input files into blocks of size # (default: no split) +. +.TP +\fB\-M#\fR, \fB\-\-memory=#\fR +Limit the amount of sample data loaded for training (default: 2 GB)\. Note that the default (2 GB) is also the maximum\. This parameter can be useful in situations where the training set size is not well controlled and could be potentially very large\. Since speed of the training process is directly correlated to the size of the training sample set, a smaller sample set leads to faster training\. +. +.IP +In situations where the training set is larger than maximum memory, the CLI will randomly select samples among the available ones, up to the maximum allowed memory budget\. This is meant to improve dictionary relevance by mitigating the potential impact of clustering, such as selecting only files from the beginning of a list sorted by modification date, or sorted by alphabetical order\. The randomization process is deterministic, so training of the same list of files with the same parameters will lead to the creation of the same dictionary\. +. +.TP +\fB\-\-dictID=#\fR +A dictionary ID is a locally unique ID\. The decoder will use this value to verify it is using the right dictionary\. By default, zstd will create a 4\-bytes random number ID\. It\'s possible to provide an explicit number ID instead\. It\'s up to the dictionary manager to not assign twice the same ID to 2 different dictionaries\. Note that short numbers have an advantage: an ID < 256 will only need 1 byte in the compressed frame header, and an ID < 65536 will only need 2 bytes\. This compares favorably to 4 bytes default\. +. +.IP +Note that RFC8878 reserves IDs less than 32768 and greater than or equal to 2^31, so they should not be used in public\. +. +.TP +\fB\-\-train\-cover[=k#,d=#,steps=#,split=#,shrink[=#]]\fR +Select parameters for the default dictionary builder algorithm named cover\. If \fId\fR is not specified, then it tries \fId\fR = 6 and \fId\fR = 8\. If \fIk\fR is not specified, then it tries \fIsteps\fR values in the range [50, 2000]\. If \fIsteps\fR is not specified, then the default value of 40 is used\. If \fIsplit\fR is not specified or split <= 0, then the default value of 100 is used\. Requires that \fId\fR <= \fIk\fR\. If \fIshrink\fR flag is not used, then the default value for \fIshrinkDict\fR of 0 is used\. If \fIshrink\fR is not specified, then the default value for \fIshrinkDictMaxRegression\fR of 1 is used\. +. +.IP +Selects segments of size \fIk\fR with highest score to put in the dictionary\. The score of a segment is computed by the sum of the frequencies of all the subsegments of size \fId\fR\. Generally \fId\fR should be in the range [6, 8], occasionally up to 16, but the algorithm will run faster with d <= \fI8\fR\. Good values for \fIk\fR vary widely based on the input data, but a safe range is [2 * \fId\fR, 2000]\. If \fIsplit\fR is 100, all input samples are used for both training and testing to find optimal \fId\fR and \fIk\fR to build dictionary\. Supports multithreading if \fBzstd\fR is compiled with threading support\. Having \fIshrink\fR enabled takes a truncated dictionary of minimum size and doubles in size until compression ratio of the truncated dictionary is at most \fIshrinkDictMaxRegression%\fR worse than the compression ratio of the largest dictionary\. +. +.IP +Examples: +. +.IP +\fBzstd \-\-train\-cover FILEs\fR +. +.IP +\fBzstd \-\-train\-cover=k=50,d=8 FILEs\fR +. +.IP +\fBzstd \-\-train\-cover=d=8,steps=500 FILEs\fR +. +.IP +\fBzstd \-\-train\-cover=k=50 FILEs\fR +. +.IP +\fBzstd \-\-train\-cover=k=50,split=60 FILEs\fR +. +.IP +\fBzstd \-\-train\-cover=shrink FILEs\fR +. +.IP +\fBzstd \-\-train\-cover=shrink=2 FILEs\fR +. +.TP +\fB\-\-train\-fastcover[=k#,d=#,f=#,steps=#,split=#,accel=#]\fR +Same as cover but with extra parameters \fIf\fR and \fIaccel\fR and different default value of split If \fIsplit\fR is not specified, then it tries \fIsplit\fR = 75\. If \fIf\fR is not specified, then it tries \fIf\fR = 20\. Requires that 0 < \fIf\fR < 32\. If \fIaccel\fR is not specified, then it tries \fIaccel\fR = 1\. Requires that 0 < \fIaccel\fR <= 10\. Requires that \fId\fR = 6 or \fId\fR = 8\. +. +.IP +\fIf\fR is log of size of array that keeps track of frequency of subsegments of size \fId\fR\. The subsegment is hashed to an index in the range [0,2^\fIf\fR \- 1]\. It is possible that 2 different subsegments are hashed to the same index, and they are considered as the same subsegment when computing frequency\. Using a higher \fIf\fR reduces collision but takes longer\. +. +.IP +Examples: +. +.IP +\fBzstd \-\-train\-fastcover FILEs\fR +. +.IP +\fBzstd \-\-train\-fastcover=d=8,f=15,accel=2 FILEs\fR +. +.TP +\fB\-\-train\-legacy[=selectivity=#]\fR +Use legacy dictionary builder algorithm with the given dictionary \fIselectivity\fR (default: 9)\. The smaller the \fIselectivity\fR value, the denser the dictionary, improving its efficiency but reducing its achievable maximum size\. \fB\-\-train\-legacy=s=#\fR is also accepted\. +. +.IP +Examples: +. +.IP +\fBzstd \-\-train\-legacy FILEs\fR +. +.IP +\fBzstd \-\-train\-legacy=selectivity=8 FILEs\fR +. +.SH "BENCHMARK" +The \fBzstd\fR CLI provides a benchmarking mode that can be used to easily find suitable compression parameters, or alternatively to benchmark a computer\'s performance\. Note that the results are highly dependent on the content being compressed\. +. +.TP +\fB\-b#\fR +benchmark file(s) using compression level # +. +.TP +\fB\-e#\fR +benchmark file(s) using multiple compression levels, from \fB\-b#\fR to \fB\-e#\fR (inclusive) +. +.TP +\fB\-d\fR +benchmark decompression speed only (requires providing an already zstd\-compressed content) +. +.TP +\fB\-i#\fR +minimum evaluation time, in seconds (default: 3s), benchmark mode only +. +.TP +\fB\-B#\fR, \fB\-\-block\-size=#\fR +cut file(s) into independent chunks of size # (default: no chunking) +. +.TP +\fB\-\-priority=rt\fR +set process priority to real\-time (Windows) +. +.P +\fBOutput Format:\fR CompressionLevel#Filename: InputSize \-> OutputSize (CompressionRatio), CompressionSpeed, DecompressionSpeed +. +.P +\fBMethodology:\fR For both compression and decompression speed, the entire input is compressed/decompressed in\-memory to measure speed\. A run lasts at least 1 sec, so when files are small, they are compressed/decompressed several times per run, in order to improve measurement accuracy\. +. .SH "SEE ALSO" \fBzstdgrep\fR(1), \fBzstdless\fR(1), \fBgzip\fR(1), \fBxz\fR(1) +. .P The \fIzstandard\fR format is specified in Y\. Collet, "Zstandard Compression and the \'application/zstd\' Media Type", https://www\.ietf\.org/rfc/rfc8878\.txt, Internet RFC 8878 (February 2021)\. +. .SH "BUGS" Report bugs at: https://github\.com/facebook/zstd/issues +. .SH "AUTHOR" Yann Collet diff --git a/upstream/fedora-rawhide/man1/zstdgrep.1 b/upstream/fedora-rawhide/man1/zstdgrep.1 index 1204e5bb..d7fda583 100644 --- a/upstream/fedora-rawhide/man1/zstdgrep.1 +++ b/upstream/fedora-rawhide/man1/zstdgrep.1 @@ -1,17 +1,26 @@ -.TH "ZSTDGREP" "1" "March 2023" "zstd 1.5.5" "User Commands" +. +.TH "ZSTDGREP" "1" "March 2024" "zstd 1.5.6" "User Commands" +. .SH "NAME" \fBzstdgrep\fR \- print lines matching a pattern in zstandard\-compressed files +. .SH "SYNOPSIS" -\fBzstdgrep\fR [\fIgrep\-flags\fR] [\-\-] \fIpattern\fR [\fIfiles\fR \|\.\|\.\|\.] +\fBzstdgrep\fR [\fIgrep\-flags\fR] [\-\-] \fIpattern\fR [\fIfiles\fR \.\.\.] +. .SH "DESCRIPTION" \fBzstdgrep\fR runs \fBgrep\fR(1) on files, or \fBstdin\fR if no files argument is given, after decompressing them with \fBzstdcat\fR(1)\. +. .P The \fIgrep\-flags\fR and \fIpattern\fR arguments are passed on to \fBgrep\fR(1)\. If an \fB\-e\fR flag is found in the \fIgrep\-flags\fR, \fBzstdgrep\fR will not look for a \fIpattern\fR argument\. +. .P Note that modern \fBgrep\fR alternatives such as \fBripgrep\fR (\fBrg\fR(1)) support \fBzstd\fR\-compressed files out of the box, and can prove better alternatives than \fBzstdgrep\fR notably for unsupported complex pattern searches\. Note though that such alternatives may also feature some minor command line differences\. +. .SH "EXIT STATUS" In case of missing arguments or missing pattern, 1 will be returned, otherwise 0\. +. .SH "SEE ALSO" \fBzstd\fR(1) +. .SH "AUTHORS" Thomas Klausner \fIwiz@NetBSD\.org\fR diff --git a/upstream/fedora-rawhide/man1/zstdless.1 b/upstream/fedora-rawhide/man1/zstdless.1 index bc019b26..7dd65f8f 100644 --- a/upstream/fedora-rawhide/man1/zstdless.1 +++ b/upstream/fedora-rawhide/man1/zstdless.1 @@ -1,9 +1,14 @@ -.TH "ZSTDLESS" "1" "March 2023" "zstd 1.5.5" "User Commands" +. +.TH "ZSTDLESS" "1" "March 2024" "zstd 1.5.6" "User Commands" +. .SH "NAME" \fBzstdless\fR \- view zstandard\-compressed files +. .SH "SYNOPSIS" -\fBzstdless\fR [\fIflags\fR] [\fIfile\fR \|\.\|\.\|\.] +\fBzstdless\fR [\fIflags\fR] [\fIfile\fR \.\.\.] +. .SH "DESCRIPTION" \fBzstdless\fR runs \fBless\fR(1) on files or stdin, if no \fIfile\fR argument is given, after decompressing them with \fBzstdcat\fR(1)\. +. .SH "SEE ALSO" \fBzstd\fR(1) |