diff options
| author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-06-17 10:52:03 +0000 |
|---|---|---|
| committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-06-17 10:52:03 +0000 |
| commit | 932e4432596447eb9331cc2a2bb74a26a35b4efc (patch) | |
| tree | 95161711ea07fd64f0c82d6e7943024c033dd5a8 /upstream/fedora-rawhide | |
| parent | Adding debian version 4.22.0-1. (diff) | |
| download | manpages-l10n-932e4432596447eb9331cc2a2bb74a26a35b4efc.tar.xz manpages-l10n-932e4432596447eb9331cc2a2bb74a26a35b4efc.zip | |
Merging upstream version 4.23.0.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/fedora-rawhide')
2139 files changed, 18031 insertions, 10650 deletions
diff --git a/upstream/fedora-rawhide/links.txt b/upstream/fedora-rawhide/links.txt index f0c285b6..746ceb5e 100644 --- a/upstream/fedora-rawhide/links.txt +++ b/upstream/fedora-rawhide/links.txt @@ -73,8 +73,8 @@ man1/bzgrep.1.gz man1/bzfgrep.1.gz man1/bzip2.1.gz man1/bzip2recover.1.gz man1/bzmore.1.gz man1/bzless.1.gz man8/cron.8.gz man8/crond.8.gz -man8/dnf-system-upgrade.8.gz man8/dnf-offline-distrosync.8.gz -man8/dnf-system-upgrade.8.gz man8/dnf-offline-upgrade.8.gz +man8/dnf4-system-upgrade.8.gz man8/dnf4-offline-distrosync.8.gz +man8/dnf4-system-upgrade.8.gz man8/dnf4-offline-upgrade.8.gz man1/dnf-utils.1.gz man1/find-repos-of-install.1.gz man1/dnf-utils.1.gz man1/repoquery.1.gz man1/dnf-utils.1.gz man1/repotrack.1.gz @@ -483,6 +483,7 @@ man3/tailq.3.gz man3/TAILQ_NEXT.3.gz man3/tailq.3.gz man3/TAILQ_PREV.3.gz man3/tailq.3.gz man3/TAILQ_REMOVE.3.gz man3/tailq.3.gz man3/TAILQ_SWAP.3.gz +man3/TIMEVAL_TO_TIMESPEC.3.gz man3/TIMESPEC_TO_TIMEVAL.3.gz man3/static_assert.3.gz man3/_Static_assert.3.gz man3/malloc_hook.3.gz man3/__after_morecore_hook.3.gz man3/stdio_ext.3.gz man3/__fbufsize.3.gz @@ -1584,6 +1585,7 @@ man7/uri.7.gz man7/urn.7.gz man7/utf-8.7.gz man7/utf8.7.gz man8/ld.so.8.gz man8/ld-linux.8.gz man8/ld.so.8.gz man8/ld-linux.so.8.gz +man1/mkosi.1 man1/mkosi.1 man5/mtools.5.gz man5/mtools.conf.5.gz man5/muttrc.5.gz man5/muttrc.local.5.gz man1/compress.1.gz man1/uncompress.1.gz @@ -2436,7 +2438,9 @@ man8/systemd-journald.service.8.gz man8/systemd-journald@.socket.8.gz man8/systemd-poweroff.service.8.gz man8/systemd-kexec.service.8.gz man8/systemd-localed.service.8.gz man8/systemd-localed.8.gz man8/systemd-logind.service.8.gz man8/systemd-logind.8.gz +man8/systemd-mountfsd.service.8.gz man8/systemd-mountfsd.8.gz man8/systemd-network-generator.service.8.gz man8/systemd-network-generator.8.gz +man8/systemd-nsresourced.service.8.gz man8/systemd-nsresourced.8.gz man8/systemd-poweroff.service.8.gz man8/systemd-reboot.service.8.gz man8/systemd-poweroff.service.8.gz man8/systemd-shutdown.8.gz man8/systemd-storagetm.service.8.gz man8/systemd-storagetm.8.gz @@ -2596,6 +2600,7 @@ man3/sd_bus_creds_get_pid.3.gz man3/sd_bus_creds_get_fsuid.3.gz man3/sd_bus_creds_get_pid.3.gz man3/sd_bus_creds_get_gid.3.gz man3/sd_bus_creds_new_from_pid.3.gz man3/sd_bus_creds_get_mask.3.gz man3/sd_bus_creds_get_pid.3.gz man3/sd_bus_creds_get_owner_uid.3.gz +man3/sd_bus_creds_get_pid.3.gz man3/sd_bus_creds_get_pidfd_dup.3.gz man3/sd_bus_creds_get_pid.3.gz man3/sd_bus_creds_get_ppid.3.gz man3/sd_bus_creds_get_pid.3.gz man3/sd_bus_creds_get_selinux_context.3.gz man3/sd_bus_creds_get_pid.3.gz man3/sd_bus_creds_get_session.3.gz @@ -2616,6 +2621,7 @@ man3/sd_bus_creds_get_pid.3.gz man3/sd_bus_creds_has_bounding_cap.3.gz man3/sd_bus_creds_get_pid.3.gz man3/sd_bus_creds_has_effective_cap.3.gz man3/sd_bus_creds_get_pid.3.gz man3/sd_bus_creds_has_inheritable_cap.3.gz man3/sd_bus_creds_get_pid.3.gz man3/sd_bus_creds_has_permitted_cap.3.gz +man3/sd_bus_creds_new_from_pid.3.gz man3/sd_bus_creds_new_from_pidfd.3.gz man3/sd_bus_creds_new_from_pid.3.gz man3/sd_bus_creds_ref.3.gz man3/sd_bus_creds_new_from_pid.3.gz man3/sd_bus_creds_unref.3.gz man3/sd_bus_creds_new_from_pid.3.gz man3/sd_bus_creds_unrefp.3.gz @@ -2845,6 +2851,7 @@ man3/sd_event_source_set_enabled.3.gz man3/sd_event_source_get_enabled.3.gz man3/sd_event_source_set_exit_on_failure.3.gz man3/sd_event_source_get_exit_on_failure.3.gz man3/sd_event_source_set_floating.3.gz man3/sd_event_source_get_floating.3.gz man3/sd_event_add_inotify.3.gz man3/sd_event_source_get_inotify_mask.3.gz +man3/sd_event_add_inotify.3.gz man3/sd_event_source_get_inotify_path.3.gz man3/sd_event_add_io.3.gz man3/sd_event_source_get_io_events.3.gz man3/sd_event_add_io.3.gz man3/sd_event_source_get_io_fd.3.gz man3/sd_event_add_io.3.gz man3/sd_event_source_get_io_fd_own.3.gz @@ -2949,6 +2956,7 @@ man3/sd_journal_print.3.gz man3/sd_journal_sendv.3.gz man3/sd_journal_print.3.gz man3/sd_journal_sendv_with_location.3.gz man3/sd_journal_get_data.3.gz man3/sd_journal_set_data_threshold.3.gz man3/sd_journal_next.3.gz man3/sd_journal_step_one.3.gz +man3/sd_journal_stream_fd.3.gz man3/sd_journal_stream_fd_with_namespace.3.gz man3/sd_journal_get_cursor.3.gz man3/sd_journal_test_cursor.3.gz man3/sd_journal_get_fd.3.gz man3/sd_journal_wait.3.gz man3/sd_listen_fds.3.gz man3/sd_listen_fds_with_names.3.gz @@ -3088,6 +3096,7 @@ man5/resolved.conf.5.gz man5/resolved.conf.d.5.gz man5/dnssec-trust-anchors.d.5.gz man5/systemd.negative.5.gz man5/dnssec-trust-anchors.d.5.gz man5/systemd.positive.5.gz man8/systemd-resolved.service.8.gz man8/systemd-resolved.8.gz +man1/homectl.1.gz man1/systemd-homed-firstboot.service.1.gz man5/coredump.conf.5.gz man5/coredump.conf.d.5.gz man5/homed.conf.5.gz man5/homed.conf.d.5.gz man5/os-release.5.gz man5/initrd-release.5.gz @@ -3095,6 +3104,7 @@ man5/oomd.conf.5.gz man5/oomd.conf.d.5.gz man5/pstore.conf.5.gz man5/pstore.conf.d.5.gz man5/systemd-sleep.conf.5.gz man5/sleep.conf.d.5.gz man5/timesyncd.conf.5.gz man5/timesyncd.conf.d.5.gz +man5/udev.conf.5.gz man5/udev.conf.d.5.gz man8/systemd-backlight@.service.8.gz man8/systemd-backlight.8.gz man8/systemd-binfmt.service.8.gz man8/systemd-binfmt.8.gz man8/systemd-bless-boot.service.8.gz man8/systemd-bless-boot.8.gz @@ -3108,6 +3118,7 @@ man8/systemd-fsck@.service.8.gz man8/systemd-fsck.8.gz man8/systemd-makefs@.service.8.gz man8/systemd-growfs-root.service.8.gz man8/systemd-makefs@.service.8.gz man8/systemd-growfs.8.gz man8/systemd-makefs@.service.8.gz man8/systemd-growfs@.service.8.gz +man8/systemd-hibernate-resume.service.8.gz man8/systemd-hibernate-clear.service.8.gz man8/systemd-hibernate-resume.service.8.gz man8/systemd-hibernate-resume.8.gz man8/systemd-suspend.service.8.gz man8/systemd-hibernate.service.8.gz man8/systemd-homed.service.8.gz man8/systemd-homed.8.gz 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) diff --git a/upstream/fedora-rawhide/man2/_exit.2 b/upstream/fedora-rawhide/man2/_exit.2 index 71ae8584..ea3ca63a 100644 --- a/upstream/fedora-rawhide/man2/_exit.2 +++ b/upstream/fedora-rawhide/man2/_exit.2 @@ -6,7 +6,7 @@ .\" Modified Wed Jul 21 23:02:38 1993 by Rik Faith <faith@cs.unc.edu> .\" Modified 2001-11-17, aeb .\" -.TH _exit 2 2023-10-31 "Linux man-pages 6.06" +.TH _exit 2 2023-10-31 "Linux man-pages 6.7" .SH NAME _exit, _Exit \- terminate the calling process .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/_syscall.2 b/upstream/fedora-rawhide/man2/_syscall.2 index 26d0a85b..84612a19 100644 --- a/upstream/fedora-rawhide/man2/_syscall.2 +++ b/upstream/fedora-rawhide/man2/_syscall.2 @@ -16,7 +16,7 @@ .\" 2007-10-23 mtk: created as a new page, by taking the content .\" specific to the _syscall() macros from intro(2). .\" -.TH _syscall 2 2023-10-31 "Linux man-pages 6.06" +.TH _syscall 2 2024-02-26 "Linux man-pages 6.7" .SH NAME _syscall \- invoking a system call without library support (OBSOLETE) .SH SYNOPSIS @@ -123,7 +123,7 @@ passed by-value or by-pointer (for aggregates like structs). .\" Otherwise, the use of a _syscall macro is required. .\" .SH EXAMPLES -.\" [[deprecated]] SRC BEGIN (_syscall.c) +.\" SRC BEGIN (_syscall.c) .EX #include <stdio.h> #include <stdlib.h> diff --git a/upstream/fedora-rawhide/man2/accept.2 b/upstream/fedora-rawhide/man2/accept.2 index 1115414d..bc73416c 100644 --- a/upstream/fedora-rawhide/man2/accept.2 +++ b/upstream/fedora-rawhide/man2/accept.2 @@ -10,7 +10,7 @@ .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" 2008-12-04, mtk, Add documentation of accept4() .\" -.TH accept 2 2023-10-31 "Linux man-pages 6.06" +.TH accept 2 2023-10-31 "Linux man-pages 6.7" .SH NAME accept, accept4 \- accept a connection on a socket .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/access.2 b/upstream/fedora-rawhide/man2/access.2 index 611f8008..7e60a33d 100644 --- a/upstream/fedora-rawhide/man2/access.2 +++ b/upstream/fedora-rawhide/man2/access.2 @@ -20,7 +20,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk .\" 2007-06-10, mtk, various parts rewritten, and added BUGS section. .\" -.TH access 2 2024-01-01 "Linux man-pages 6.06" +.TH access 2 2024-01-01 "Linux man-pages 6.7" .SH NAME access, faccessat, faccessat2 \- check user's permissions for a file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/acct.2 b/upstream/fedora-rawhide/man2/acct.2 index 8eaddac2..d3ce589e 100644 --- a/upstream/fedora-rawhide/man2/acct.2 +++ b/upstream/fedora-rawhide/man2/acct.2 @@ -9,7 +9,7 @@ .\" Modified 1998-11-04 by Tigran Aivazian <tigran@sco.com> .\" Modified 2004-05-27, 2004-06-17, 2004-06-23 by Michael Kerrisk .\" -.TH acct 2 2023-10-31 "Linux man-pages 6.06" +.TH acct 2 2023-10-31 "Linux man-pages 6.7" .SH NAME acct \- switch process accounting on or off .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/add_key.2 b/upstream/fedora-rawhide/man2/add_key.2 index de942796..6e81ec9a 100644 --- a/upstream/fedora-rawhide/man2/add_key.2 +++ b/upstream/fedora-rawhide/man2/add_key.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH add_key 2 2023-10-31 "Linux man-pages 6.06" +.TH add_key 2 2024-02-25 "Linux man-pages 6.7" .SH NAME add_key \- add a key to the kernel's key management facility .SH LIBRARY @@ -96,7 +96,7 @@ argument to .BR add_key () are the following: .TP -.I """keyring""" +.I \[dq]keyring\[dq] Keyrings are special key types that may contain links to sequences of other keys of any type. If this interface is used to create a keyring, then @@ -105,17 +105,17 @@ should be NULL and .I plen should be zero. .TP -.I """user""" +.I \[dq]user\[dq] This is a general purpose key type whose payload may be read and updated by user-space applications. The key is kept entirely within kernel memory. The payload for keys of this type is a blob of arbitrary data of up to 32,767 bytes. .TP -.IR """logon""" " (since Linux 3.3)" +.IR \[dq]logon\[dq] " (since Linux 3.3)" .\" commit 9f6ed2ca257fa8650b876377833e6f14e272848b This key type is essentially the same as -.IR """user""" , +.IR \[dq]user\[dq] , but it does not permit the key to read. This is suitable for storing payloads that you do not want to be readable from user space. @@ -127,10 +127,10 @@ by checking to ensure that the .I description contains a ':' that is preceded by other characters. .TP -.IR """big_key""" " (since Linux 3.13)" +.IR \[dq]big_key\[dq] " (since Linux 3.13)" .\" commit ab3c3587f8cda9083209a61dbe3a4407d3cada10 This key type is similar to -.IR """user""" , +.IR \[dq]user\[dq] , but may hold a payload of up to 1\ MiB. If the key payload is large enough, then it may be stored encrypted in tmpfs @@ -175,11 +175,11 @@ The payload data was invalid. .B EINVAL .I type was -.I """logon""" +.I \[dq]logon\[dq] and the .I description was not qualified with a prefix string of the form -.IR """service:""" . +.IR \[dq]service:\[dq] . .TP .B EKEYEXPIRED The keyring has expired. @@ -202,7 +202,7 @@ Key types that begin with a period are reserved to the implementation. .B EPERM .I type was -.I """keyring""" +.I \[dq]keyring\[dq] and the .I description started with a period (\[aq].\[aq]). diff --git a/upstream/fedora-rawhide/man2/adjtimex.2 b/upstream/fedora-rawhide/man2/adjtimex.2 index 71b32d7a..e5264df5 100644 --- a/upstream/fedora-rawhide/man2/adjtimex.2 +++ b/upstream/fedora-rawhide/man2/adjtimex.2 @@ -8,7 +8,7 @@ .\" Modified 1997-07-30 by Paul Slootman <paul@wurtel.demon.nl> .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH adjtimex 2 2023-10-31 "Linux man-pages 6.06" +.TH adjtimex 2 2023-10-31 "Linux man-pages 6.7" .SH NAME adjtimex, clock_adjtime, ntp_adjtime \- tune kernel clock .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/alarm.2 b/upstream/fedora-rawhide/man2/alarm.2 index bd10e840..18a93ad0 100644 --- a/upstream/fedora-rawhide/man2/alarm.2 +++ b/upstream/fedora-rawhide/man2/alarm.2 @@ -7,7 +7,7 @@ .\" Modified Sun Jul 21 21:25:26 1996 by Andries Brouwer <aeb@cwi.nl> .\" Modified Wed Nov 6 03:46:05 1996 by Eric S. Raymond <esr@thyrsus.com> .\" -.TH alarm 2 2023-10-31 "Linux man-pages 6.06" +.TH alarm 2 2023-10-31 "Linux man-pages 6.7" .SH NAME alarm \- set an alarm clock for delivery of a signal .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/alloc_hugepages.2 b/upstream/fedora-rawhide/man2/alloc_hugepages.2 index 9cbc9397..0aba97e1 100644 --- a/upstream/fedora-rawhide/man2/alloc_hugepages.2 +++ b/upstream/fedora-rawhide/man2/alloc_hugepages.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH alloc_hugepages 2 2023-10-31 "Linux man-pages 6.06" +.TH alloc_hugepages 2 2023-10-31 "Linux man-pages 6.7" .SH NAME alloc_hugepages, free_hugepages \- allocate or free huge pages .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/arch_prctl.2 b/upstream/fedora-rawhide/man2/arch_prctl.2 index dcb31afe..6981ec32 100644 --- a/upstream/fedora-rawhide/man2/arch_prctl.2 +++ b/upstream/fedora-rawhide/man2/arch_prctl.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH arch_prctl 2 2023-10-31 "Linux man-pages 6.06" +.TH arch_prctl 2 2024-03-03 "Linux man-pages 6.7" .SH NAME arch_prctl \- set architecture-specific thread state .SH LIBRARY @@ -14,8 +14,8 @@ Standard C library .BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */" .B #include <unistd.h> .P -.BI "int syscall(SYS_arch_prctl, int " code ", unsigned long " addr ); -.BI "int syscall(SYS_arch_prctl, int " code ", unsigned long *" addr ); +.BI "int syscall(SYS_arch_prctl, int " op ", unsigned long " addr ); +.BI "int syscall(SYS_arch_prctl, int " op ", unsigned long *" addr ); .fi .P .IR Note : @@ -26,8 +26,8 @@ necessitating the use of .SH DESCRIPTION .BR arch_prctl () sets architecture-specific process or thread state. -.I code -selects a subfunction +.I op +selects an operation and passes argument .I addr to it; @@ -120,8 +120,8 @@ is set to indicate the error. points to an unmapped address or is outside the process address space. .TP .B EINVAL -.I code -is not a valid subcommand. +.I op +is not a valid operation. .TP .B ENODEV .B ARCH_SET_CPUID diff --git a/upstream/fedora-rawhide/man2/bdflush.2 b/upstream/fedora-rawhide/man2/bdflush.2 index 452248f2..0f1ccca6 100644 --- a/upstream/fedora-rawhide/man2/bdflush.2 +++ b/upstream/fedora-rawhide/man2/bdflush.2 @@ -5,7 +5,7 @@ .\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com> .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH bdflush 2 2023-10-31 "Linux man-pages 6.06" +.TH bdflush 2 2023-10-31 "Linux man-pages 6.7" .SH NAME bdflush \- start, flush, or tune buffer-dirty-flush daemon .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/bind.2 b/upstream/fedora-rawhide/man2/bind.2 index a7af6e34..0fc33088 100644 --- a/upstream/fedora-rawhide/man2/bind.2 +++ b/upstream/fedora-rawhide/man2/bind.2 @@ -18,7 +18,7 @@ .\" $Id: bind.2,v 1.3 1999/04/23 19:56:07 freitag Exp $ .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH bind 2 2023-10-31 "Linux man-pages 6.06" +.TH bind 2 2023-10-31 "Linux man-pages 6.7" .SH NAME bind \- bind a name to a socket .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/bpf.2 b/upstream/fedora-rawhide/man2/bpf.2 index 7b33da5b..28220763 100644 --- a/upstream/fedora-rawhide/man2/bpf.2 +++ b/upstream/fedora-rawhide/man2/bpf.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH bpf 2 2023-11-01 "Linux man-pages 6.06" +.TH bpf 2 2024-03-18 "Linux man-pages 6.7" .SH NAME bpf \- perform a command on an extended BPF map or program .SH SYNOPSIS @@ -1143,7 +1143,7 @@ provided in the kernel source tree. .P Since Linux 4.15, .\" commit 290af86629b25ffd1ed6232c4e9107da031705cb -the kernel may configured with the +the kernel may be configured with the .B CONFIG_BPF_JIT_ALWAYS_ON option. In this case, the JIT compiler is always enabled, and the @@ -1192,7 +1192,7 @@ riscv (since Linux 5.1). .\" commit 2353ecc6f91fd15b893fa01bf85a1c7a823ee4f2 .PD .SH EXAMPLES -.\" [[FIXME]] SRC BEGIN (bpf.c) +.\" SRC BEGIN (bpf.c) .EX /* bpf+sockets example: * 1. create array map of 256 elements diff --git a/upstream/fedora-rawhide/man2/brk.2 b/upstream/fedora-rawhide/man2/brk.2 index 91b8d81a..0248459d 100644 --- a/upstream/fedora-rawhide/man2/brk.2 +++ b/upstream/fedora-rawhide/man2/brk.2 @@ -7,7 +7,7 @@ .\" Modified Wed Jul 21 19:52:58 1993 by Rik Faith <faith@cs.unc.edu> .\" Modified Sun Aug 21 17:40:38 1994 by Rik Faith <faith@cs.unc.edu> .\" -.TH brk 2 2023-10-31 "Linux man-pages 6.06" +.TH brk 2 2023-10-31 "Linux man-pages 6.7" .SH NAME brk, sbrk \- change data segment size .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/cacheflush.2 b/upstream/fedora-rawhide/man2/cacheflush.2 index ce8e797f..b2a5f26c 100644 --- a/upstream/fedora-rawhide/man2/cacheflush.2 +++ b/upstream/fedora-rawhide/man2/cacheflush.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH cacheflush 2 2023-10-31 "Linux man-pages 6.06" +.TH cacheflush 2 2023-10-31 "Linux man-pages 6.7" .SH NAME cacheflush \- flush contents of instruction and/or data cache .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/capget.2 b/upstream/fedora-rawhide/man2/capget.2 index 11fa5619..db9ad253 100644 --- a/upstream/fedora-rawhide/man2/capget.2 +++ b/upstream/fedora-rawhide/man2/capget.2 @@ -11,7 +11,7 @@ .\" 64-bit capability sets in Linux 2.6.2[45]. .\" Modified 2009-01-26, andi kleen .\" -.TH capget 2 2023-10-31 "Linux man-pages 6.06" +.TH capget 2 2023-10-31 "Linux man-pages 6.7" .SH NAME capget, capset \- set/get capabilities of thread(s) .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/chdir.2 b/upstream/fedora-rawhide/man2/chdir.2 index 4b43371f..33e7473c 100644 --- a/upstream/fedora-rawhide/man2/chdir.2 +++ b/upstream/fedora-rawhide/man2/chdir.2 @@ -10,7 +10,7 @@ .\" Modified 1997-08-21 by Joseph S. Myers <jsm28@cam.ac.uk> .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH chdir 2 2023-10-31 "Linux man-pages 6.06" +.TH chdir 2 2023-10-31 "Linux man-pages 6.7" .SH NAME chdir, fchdir \- change working directory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/chmod.2 b/upstream/fedora-rawhide/man2/chmod.2 index 71ba1f01..d7b9694b 100644 --- a/upstream/fedora-rawhide/man2/chmod.2 +++ b/upstream/fedora-rawhide/man2/chmod.2 @@ -9,7 +9,7 @@ .\" <michael@cantor.informatik.rwth-aachen.de>: NFS details .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH chmod 2 2023-10-31 "Linux man-pages 6.06" +.TH chmod 2 2023-10-31 "Linux man-pages 6.7" .SH NAME chmod, fchmod, fchmodat \- change permissions of a file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/chown.2 b/upstream/fedora-rawhide/man2/chown.2 index 5c138533..f71030d7 100644 --- a/upstream/fedora-rawhide/man2/chown.2 +++ b/upstream/fedora-rawhide/man2/chown.2 @@ -15,7 +15,7 @@ .\" (bsdgroups versus sysvgroups, and the effect of the parent .\" directory's set-group-ID mode bit). .\" -.TH chown 2 2023-10-31 "Linux man-pages 6.06" +.TH chown 2 2023-10-31 "Linux man-pages 6.7" .SH NAME chown, fchown, lchown, fchownat \- change ownership of a file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/chroot.2 b/upstream/fedora-rawhide/man2/chroot.2 index ceb351fd..bdba54f4 100644 --- a/upstream/fedora-rawhide/man2/chroot.2 +++ b/upstream/fedora-rawhide/man2/chroot.2 @@ -10,7 +10,7 @@ .\" Modified 1997-08-21 by Joseph S. Myers <jsm28@cam.ac.uk> .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH chroot 2 2023-10-31 "Linux man-pages 6.06" +.TH chroot 2 2023-10-31 "Linux man-pages 6.7" .SH NAME chroot \- change root directory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/clock_getres.2 b/upstream/fedora-rawhide/man2/clock_getres.2 index 7f9ad02b..ec1e3274 100644 --- a/upstream/fedora-rawhide/man2/clock_getres.2 +++ b/upstream/fedora-rawhide/man2/clock_getres.2 @@ -9,7 +9,7 @@ .\" 2003-08-24 aeb, large parts rewritten .\" 2004-08-06 Christoph Lameter <clameter@sgi.com>, SMP note .\" -.TH clock_getres 2 2023-11-11 "Linux man-pages 6.06" +.TH clock_getres 2 2024-03-05 "Linux man-pages 6.7" .SH NAME clock_getres, clock_gettime, clock_settime \- clock and time functions .SH LIBRARY @@ -377,6 +377,8 @@ Linux 2.6. On POSIX systems on which these functions are available, the symbol .B _POSIX_TIMERS is defined in \fI<unistd.h>\fP to a value greater than 0. +POSIX.1-2008 makes these functions mandatory. +.P The symbols .BR _POSIX_MONOTONIC_CLOCK , .BR _POSIX_CPUTIME , @@ -388,7 +390,6 @@ indicate that are available. (See also .BR sysconf (3).) -POSIX.1-2008 makes these APIs mandatory. .\" .SS Historical note for SMP systems Before Linux added kernel support for diff --git a/upstream/fedora-rawhide/man2/clock_nanosleep.2 b/upstream/fedora-rawhide/man2/clock_nanosleep.2 index 04bacfc2..12948c7e 100644 --- a/upstream/fedora-rawhide/man2/clock_nanosleep.2 +++ b/upstream/fedora-rawhide/man2/clock_nanosleep.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH clock_nanosleep 2 2023-11-11 "Linux man-pages 6.06" +.TH clock_nanosleep 2 2024-03-05 "Linux man-pages 6.7" .SH NAME clock_nanosleep \- high-resolution sleep with specifiable clock .SH LIBRARY @@ -19,7 +19,7 @@ Real-time library .nf .P .BI "int clock_nanosleep(clockid_t " clockid ", int " flags , -.BI " const struct timespec *" request , +.BI " const struct timespec *" t , .BI " struct timespec *_Nullable " remain ); .fi .P @@ -94,7 +94,7 @@ can also be passed in If .I flags is 0, then the value specified in -.I request +.I t is interpreted as an interval relative to the current value of the clock specified by .IR clockid . @@ -104,11 +104,11 @@ If is .BR TIMER_ABSTIME , then -.I request +.I t is interpreted as an absolute time as measured by the clock, .IR clockid . If -.I request +.I t is less than or equal to the current value of the clock, then .BR clock_nanosleep () @@ -117,7 +117,7 @@ returns immediately without suspending the calling thread. .BR clock_nanosleep () suspends the execution of the calling thread until either at least the time specified by -.I request +.I t has elapsed, or a signal is delivered that causes a signal handler to be called or that terminates the process. @@ -146,7 +146,7 @@ then it returns one of the positive error number listed in ERRORS. .SH ERRORS .TP .B EFAULT -.I request +.I t or .I remain specified an invalid address. @@ -180,7 +180,7 @@ Linux 2.6, glibc 2.1. .SH NOTES If the interval specified in -.I request +.I t is not an exact multiple of the granularity underlying clock (see .BR time (7)), then the interval will be rounded up to the next multiple. @@ -216,7 +216,7 @@ argument is unused, and unnecessary, when is .BR TIMER_ABSTIME . (An absolute sleep can be restarted using the same -.I request +.I t argument.) .P POSIX.1 specifies that diff --git a/upstream/fedora-rawhide/man2/clone.2 b/upstream/fedora-rawhide/man2/clone.2 index a73af0dc..69e4547e 100644 --- a/upstream/fedora-rawhide/man2/clone.2 +++ b/upstream/fedora-rawhide/man2/clone.2 @@ -38,7 +38,7 @@ .\" 2008-11-19, mtk, document CLONE_NEWIPC .\" 2008-11-19, Jens Axboe, mtk, document CLONE_IO .\" -.TH clone 2 2023-11-01 "Linux man-pages 6.06" +.TH clone 2 2024-02-18 "Linux man-pages 6.7" .SH NAME clone, __clone2, clone3 \- create a child process .SH LIBRARY @@ -1745,7 +1745,7 @@ does not take arguments and .IR child_tid . .SH NOTES -One use of these systems calls +One use of these system calls is to implement threads: multiple flows of control in a program that run concurrently in a shared address space. .P diff --git a/upstream/fedora-rawhide/man2/close.2 b/upstream/fedora-rawhide/man2/close.2 index bee0f100..510b3206 100644 --- a/upstream/fedora-rawhide/man2/close.2 +++ b/upstream/fedora-rawhide/man2/close.2 @@ -13,7 +13,7 @@ .\" Modified 2000-07-22 by Nicolás Lichtmaier <nick@debian.org> .\" added note about close(2) not guaranteeing that data is safe on close. .\" -.TH close 2 2023-10-31 "Linux man-pages 6.06" +.TH close 2 2023-10-31 "Linux man-pages 6.7" .SH NAME close \- close a file descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/close_range.2 b/upstream/fedora-rawhide/man2/close_range.2 index 017f95f9..d9582b00 100644 --- a/upstream/fedora-rawhide/man2/close_range.2 +++ b/upstream/fedora-rawhide/man2/close_range.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH close_range 2 2023-10-31 "Linux man-pages 6.06" +.TH close_range 2 2024-02-25 "Linux man-pages 6.7" .SH NAME close_range \- close all file descriptors in a given range .SH LIBRARY @@ -11,10 +11,14 @@ Standard C library .RI ( libc ", " \-lc ) .SH SYNOPSIS .nf -.B #include <linux/close_range.h> +.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" +.B #include <unistd.h> .P -.BI "int close_range(unsigned int " first ", unsigned int " last , -.BI " unsigned int " flags ); +.BR "#include <linux/close_range.h>" " /* Definition of " CLOSE_RANGE_* +.BR "" " constants */" +.P +.BI "int close_range(unsigned int " first ", unsigned int " last \ +", int " flags ); .fi .SH DESCRIPTION The @@ -205,7 +209,6 @@ result from the calls to #include <limits.h> #include <stdio.h> #include <stdlib.h> -#include <sys/syscall.h> #include <unistd.h> \& /* Show the contents of the symbolic links in /proc/self/fd */ @@ -259,7 +262,7 @@ main(int argc, char *argv[]) \& printf("========= About to call close_range() =======\en"); \& - if (syscall(SYS_close_range, 3, \[ti]0U, 0) == \-1) { + if (close_range(3, \[ti]0U, 0) == \-1) { perror("close_range"); exit(EXIT_FAILURE); } diff --git a/upstream/fedora-rawhide/man2/connect.2 b/upstream/fedora-rawhide/man2/connect.2 index 16ad92bd..ad8888a1 100644 --- a/upstream/fedora-rawhide/man2/connect.2 +++ b/upstream/fedora-rawhide/man2/connect.2 @@ -16,7 +16,7 @@ .\" Modified 1998, 1999 by Andi Kleen .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH connect 2 2023-11-01 "Linux man-pages 6.06" +.TH connect 2 2023-11-01 "Linux man-pages 6.7" .SH NAME connect \- initiate a connection on a socket .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/copy_file_range.2 b/upstream/fedora-rawhide/man2/copy_file_range.2 index 65beac38..aee98017 100644 --- a/upstream/fedora-rawhide/man2/copy_file_range.2 +++ b/upstream/fedora-rawhide/man2/copy_file_range.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH copy_file_range 2 2023-10-31 "Linux man-pages 6.06" +.TH copy_file_range 2 2023-10-31 "Linux man-pages 6.7" .SH NAME copy_file_range \- Copy a range of data from one file to another .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/create_module.2 b/upstream/fedora-rawhide/man2/create_module.2 index 14bd594d..153acc28 100644 --- a/upstream/fedora-rawhide/man2/create_module.2 +++ b/upstream/fedora-rawhide/man2/create_module.2 @@ -5,7 +5,7 @@ .\" 2006-02-09, some reformatting by Luc Van Oostenryck; some .\" reformatting and rewordings by mtk .\" -.TH create_module 2 2023-10-31 "Linux man-pages 6.06" +.TH create_module 2 2023-10-31 "Linux man-pages 6.7" .SH NAME create_module \- create a loadable module entry .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/delete_module.2 b/upstream/fedora-rawhide/man2/delete_module.2 index bd3b3146..bbee49bb 100644 --- a/upstream/fedora-rawhide/man2/delete_module.2 +++ b/upstream/fedora-rawhide/man2/delete_module.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH delete_module 2 2023-10-31 "Linux man-pages 6.06" +.TH delete_module 2 2023-10-31 "Linux man-pages 6.7" .SH NAME delete_module \- unload a kernel module .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/dup.2 b/upstream/fedora-rawhide/man2/dup.2 index 2549d9fd..e03ca26d 100644 --- a/upstream/fedora-rawhide/man2/dup.2 +++ b/upstream/fedora-rawhide/man2/dup.2 @@ -14,7 +14,7 @@ .\" details for dup2(). .\" 2008-10-09, mtk: add description of dup3() .\" -.TH dup 2 2023-10-31 "Linux man-pages 6.06" +.TH dup 2 2023-10-31 "Linux man-pages 6.7" .SH NAME dup, dup2, dup3 \- duplicate a file descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/epoll_create.2 b/upstream/fedora-rawhide/man2/epoll_create.2 index 153fb385..c6369f44 100644 --- a/upstream/fedora-rawhide/man2/epoll_create.2 +++ b/upstream/fedora-rawhide/man2/epoll_create.2 @@ -8,7 +8,7 @@ .\" Modified 2005-04-04 by Marko Kohtala <marko.kohtala@gmail.com> .\" 2008-10-10, mtk: add description of epoll_create1() .\" -.TH epoll_create 2 2023-10-31 "Linux man-pages 6.06" +.TH epoll_create 2 2023-10-31 "Linux man-pages 6.7" .SH NAME epoll_create, epoll_create1 \- open an epoll file descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/epoll_ctl.2 b/upstream/fedora-rawhide/man2/epoll_ctl.2 index 3a19826d..73a04468 100644 --- a/upstream/fedora-rawhide/man2/epoll_ctl.2 +++ b/upstream/fedora-rawhide/man2/epoll_ctl.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH epoll_ctl 2 2023-10-31 "Linux man-pages 6.06" +.TH epoll_ctl 2 2023-10-31 "Linux man-pages 6.7" .SH NAME epoll_ctl \- control interface for an epoll file descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/epoll_wait.2 b/upstream/fedora-rawhide/man2/epoll_wait.2 index bfdad49c..72d6fab4 100644 --- a/upstream/fedora-rawhide/man2/epoll_wait.2 +++ b/upstream/fedora-rawhide/man2/epoll_wait.2 @@ -6,7 +6,7 @@ .\" .\" 2007-04-30: mtk, Added description of epoll_pwait() .\" -.TH epoll_wait 2 2023-10-31 "Linux man-pages 6.06" +.TH epoll_wait 2 2024-03-03 "Linux man-pages 6.7" .SH NAME epoll_wait, epoll_pwait, epoll_pwait2 \- wait for an I/O event on an epoll file descriptor @@ -77,7 +77,7 @@ of \-1 causes .BR epoll_wait () to block indefinitely, while specifying a .I timeout -equal to zero cause +equal to zero causes .BR epoll_wait () to return immediately, even if no events are available. .P @@ -173,8 +173,8 @@ can block indefinitely. .SH RETURN VALUE On success, .BR epoll_wait () -returns the number of file descriptors ready for the requested I/O, or zero -if no file descriptor became ready during the requested +returns the number of file descriptors ready for the requested I/O operation, +or zero if no file descriptor became ready during the requested .I timeout milliseconds. On failure, diff --git a/upstream/fedora-rawhide/man2/eventfd.2 b/upstream/fedora-rawhide/man2/eventfd.2 index a44f6711..2de063ea 100644 --- a/upstream/fedora-rawhide/man2/eventfd.2 +++ b/upstream/fedora-rawhide/man2/eventfd.2 @@ -6,7 +6,7 @@ .\" .\" 2008-10-10, mtk: describe eventfd2(), and EFD_NONBLOCK and EFD_CLOEXEC .\" -.TH eventfd 2 2023-10-31 "Linux man-pages 6.06" +.TH eventfd 2 2023-10-31 "Linux man-pages 6.7" .SH NAME eventfd \- create a file descriptor for event notification .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/execve.2 b/upstream/fedora-rawhide/man2/execve.2 index 73da5701..23404b5a 100644 --- a/upstream/fedora-rawhide/man2/execve.2 +++ b/upstream/fedora-rawhide/man2/execve.2 @@ -14,7 +14,7 @@ .\" 2007-09-14 Ollie Wild <aaw@google.com>, mtk .\" Add text describing limits on command-line arguments + environment .\" -.TH execve 2 2023-11-01 "Linux man-pages 6.06" +.TH execve 2 2023-11-01 "Linux man-pages 6.7" .SH NAME execve \- execute program .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/execveat.2 b/upstream/fedora-rawhide/man2/execveat.2 index 566314ec..3a612ae3 100644 --- a/upstream/fedora-rawhide/man2/execveat.2 +++ b/upstream/fedora-rawhide/man2/execveat.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH execveat 2 2023-10-31 "Linux man-pages 6.06" +.TH execveat 2 2023-10-31 "Linux man-pages 6.7" .SH NAME execveat \- execute program relative to a directory file descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/exit_group.2 b/upstream/fedora-rawhide/man2/exit_group.2 index f17d9a32..af66e6a7 100644 --- a/upstream/fedora-rawhide/man2/exit_group.2 +++ b/upstream/fedora-rawhide/man2/exit_group.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH exit_group 2 2023-10-31 "Linux man-pages 6.06" +.TH exit_group 2 2023-10-31 "Linux man-pages 6.7" .SH NAME exit_group \- exit all threads in a process .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/fallocate.2 b/upstream/fedora-rawhide/man2/fallocate.2 index 1ce8a196..bedc533a 100644 --- a/upstream/fedora-rawhide/man2/fallocate.2 +++ b/upstream/fedora-rawhide/man2/fallocate.2 @@ -6,7 +6,7 @@ .\" 2011-09-19: Added FALLOC_FL_PUNCH_HOLE .\" 2011-09-19: Substantial restructuring of the page .\" -.TH fallocate 2 2023-10-31 "Linux man-pages 6.06" +.TH fallocate 2 2023-10-31 "Linux man-pages 6.7" .SH NAME fallocate \- manipulate file space .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/fanotify_init.2 b/upstream/fedora-rawhide/man2/fanotify_init.2 index d0860043..8a9667bb 100644 --- a/upstream/fedora-rawhide/man2/fanotify_init.2 +++ b/upstream/fedora-rawhide/man2/fanotify_init.2 @@ -1,7 +1,7 @@ .\" Copyright (C) 2013, Heinrich Schuchardt <xypron.glpk@gmx.de> .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH fanotify_init 2 2023-10-31 "Linux man-pages 6.06" +.TH fanotify_init 2 2023-10-31 "Linux man-pages 6.7" .SH NAME fanotify_init \- create and initialize fanotify group .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/fanotify_mark.2 b/upstream/fedora-rawhide/man2/fanotify_mark.2 index 7f3a3513..c942b0b8 100644 --- a/upstream/fedora-rawhide/man2/fanotify_mark.2 +++ b/upstream/fedora-rawhide/man2/fanotify_mark.2 @@ -1,7 +1,7 @@ .\" Copyright (C) 2013, Heinrich Schuchardt <xypron.glpk@gmx.de> .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH fanotify_mark 2 2023-10-31 "Linux man-pages 6.06" +.TH fanotify_mark 2 2023-10-31 "Linux man-pages 6.7" .SH NAME fanotify_mark \- add, remove, or modify an fanotify mark on a filesystem object diff --git a/upstream/fedora-rawhide/man2/fcntl.2 b/upstream/fedora-rawhide/man2/fcntl.2 index 05d2e5d2..01d18aa5 100644 --- a/upstream/fedora-rawhide/man2/fcntl.2 +++ b/upstream/fedora-rawhide/man2/fcntl.2 @@ -44,7 +44,7 @@ .\" 2017-06-26, Jens Axboe <axboe@kernel.dk> .\" Document F_{GET,SET}_RW_HINT and F_{GET,SET}_FILE_RW_HINT .\" -.TH fcntl 2 2023-10-31 "Linux man-pages 6.06" +.TH fcntl 2 2024-03-03 "Linux man-pages 6.7" .SH NAME fcntl \- manipulate file descriptor .SH LIBRARY @@ -54,21 +54,21 @@ Standard C library .nf .B #include <fcntl.h> .P -.BI "int fcntl(int " fd ", int " cmd ", ... /* " arg " */ );" +.BI "int fcntl(int " fd ", int " op ", ... /* " arg " */ );" .fi .SH DESCRIPTION .BR fcntl () performs one of the operations described below on the open file descriptor .IR fd . The operation is determined by -.IR cmd . +.IR op . .P .BR fcntl () can take an optional third argument. Whether or not this argument is required is determined by -.IR cmd . +.IR op . The required argument type is indicated in parentheses after each -.I cmd +.I op name (in most cases, the required type is .IR int , and we identify the argument using the name @@ -83,7 +83,7 @@ The preferred method of checking whether the host kernel supports a particular operation is to invoke .BR fcntl () with the desired -.I cmd +.I op value and then test whether the call failed with .BR EINVAL , indicating that the kernel does not recognize this value. @@ -121,7 +121,7 @@ see the description of in .BR open (2). .SS File descriptor flags -The following commands manipulate the flags associated with +The following operations manipulate the flags associated with a file descriptor. Currently, only one such flag is defined: .BR FD_CLOEXEC , @@ -198,7 +198,7 @@ and file creation flags in .I arg are ignored. -On Linux, this command can change only the +On Linux, this operation can change only the .BR O_APPEND , .BR O_ASYNC , .BR O_DIRECT , @@ -529,9 +529,9 @@ structure. By contrast with traditional record locks, the .I l_pid field of that structure must be set to zero -when using the commands described below. +when using the operations described below. .P -The commands for working with open file description locks are analogous +The operations for working with open file description locks are analogous to those used with traditional locks: .TP .BR F_OFD_SETLK " (\fIstruct flock *\fP)" @@ -722,7 +722,7 @@ one must also enable generation of signals on the file descriptor. This is done by using the .BR fcntl () .B F_SETFL -command to set the +operation to set the .B O_ASYNC file status flag on the file descriptor. Subsequently, a @@ -732,7 +732,7 @@ on the file descriptor. The .BR fcntl () .B F_SETSIG -command can be used to obtain delivery of a signal other than +operation can be used to obtain delivery of a signal other than .BR SIGIO . .IP Sending a signal to the owner process (group) specified by @@ -1120,7 +1120,7 @@ accessed by another process (e.g., flushing cached buffers) and then either remove or downgrade its lease. A lease is removed by performing an .B F_SETLEASE -command specifying +operation specifying .I arg as .BR F_UNLCK . @@ -1130,7 +1130,7 @@ then it is sufficient for the lease holder to downgrade the lease to a read lease. This is done by performing an .B F_SETLEASE -command specifying +operation specifying .I arg as .BR F_RDLCK . @@ -1179,11 +1179,11 @@ The default signal used to notify the lease holder is .BR SIGIO , but this can be changed using the .B F_SETSIG -command to +operation to .BR fcntl (). If a .B F_SETSIG -command is performed (even one specifying +operation is performed (even one specifying .BR SIGIO ), and the signal handler is established using @@ -1289,7 +1289,7 @@ The default signal is .BR SIGIO , but this can be changed using the .B F_SETSIG -command to +operation to .BR fcntl (). (Note that .B SIGIO @@ -1639,7 +1639,7 @@ A bit mask identifying the seals that have been set for the inode referred to by .IR fd . .TP -All other commands +All other operations Zero. .P On error, \-1 is returned, and @@ -1659,7 +1659,7 @@ another process. is not an open file descriptor .TP .B EBADF -.I cmd +.I op is .B F_SETLK or @@ -1668,7 +1668,7 @@ and the file descriptor open mode doesn't match with the type of lock requested. .TP .B EBUSY -.I cmd +.I op is .B F_SETPIPE_SZ and the new pipe capacity specified in @@ -1677,7 +1677,7 @@ is smaller than the amount of buffer space currently used to store data in the pipe. .TP .B EBUSY -.I cmd +.I op is .BR F_ADD_SEALS , .I arg @@ -1689,14 +1689,14 @@ and there exists a writable, shared mapping on the file referred to by .B EDEADLK It was detected that the specified .B F_SETLKW -command would cause a deadlock. +operation would cause a deadlock. .TP .B EFAULT .I lock is outside your accessible address space. .TP .B EINTR -.I cmd +.I op is .B F_SETLKW or @@ -1705,7 +1705,7 @@ and the operation was interrupted by a signal; see .BR signal (7). .TP .B EINTR -.I cmd +.I op is .BR F_GETLK , .BR F_SETLK , @@ -1719,11 +1719,11 @@ NFS), but can sometimes happen locally. .TP .B EINVAL The value specified in -.I cmd +.I op is not recognized by this kernel. .TP .B EINVAL -.I cmd +.I op is .B F_ADD_SEALS and @@ -1731,7 +1731,7 @@ and includes an unrecognized sealing bit. .TP .B EINVAL -.I cmd +.I op is .B F_ADD_SEALS or @@ -1741,7 +1741,7 @@ and the filesystem containing the inode referred to by does not support sealing. .TP .B EINVAL -.I cmd +.I op is .B F_DUPFD and @@ -1753,7 +1753,7 @@ in .BR getrlimit (2)). .TP .B EINVAL -.I cmd +.I op is .B F_SETSIG and @@ -1761,7 +1761,7 @@ and is not an allowable signal number. .TP .B EINVAL -.I cmd +.I op is .BR F_OFD_SETLK , .BR F_OFD_SETLKW , @@ -1772,7 +1772,7 @@ and was not specified as zero. .TP .B EMFILE -.I cmd +.I op is .B F_DUPFD and the per-process limit on the number of open file descriptors @@ -1785,13 +1785,13 @@ protocol failed (e.g., locking over NFS). .B ENOTDIR .B F_NOTIFY was specified in -.IR cmd , +.IR op , but .I fd does not refer to a directory. .TP .B EPERM -.I cmd +.I op is .B F_SETPIPE_SZ and the soft or hard user pipe limit has been reached; see @@ -1803,7 +1803,7 @@ Attempted to clear the flag on a file that has the append-only attribute set. .TP .B EPERM -.I cmd +.I op was .BR F_ADD_SEALS , but @@ -1897,7 +1897,7 @@ Consequently, an system call was added in Linux 2.4. The newer system call employs a different structure for file locking, .IR flock64 , -and corresponding commands, +and corresponding operations, .BR F_GETLK64 , .BR F_SETLK64 , and @@ -1940,7 +1940,7 @@ Consequently, an system call was added in Linux 2.4. The newer system call employs a different structure for file locking, .IR flock64 , -and corresponding commands, +and corresponding operations, .BR F_GETLK64 , .BR F_SETLK64 , and diff --git a/upstream/fedora-rawhide/man2/flock.2 b/upstream/fedora-rawhide/man2/flock.2 index 1ef6962f..c2c93cad 100644 --- a/upstream/fedora-rawhide/man2/flock.2 +++ b/upstream/fedora-rawhide/man2/flock.2 @@ -12,7 +12,7 @@ .\" FIXME Maybe document LOCK_MAND, LOCK_RW, LOCK_READ, LOCK_WRITE .\" which only have effect for SAMBA. .\" -.TH flock 2 2023-10-31 "Linux man-pages 6.06" +.TH flock 2 2024-03-03 "Linux man-pages 6.7" .SH NAME flock \- apply or remove an advisory lock on an open file .SH LIBRARY @@ -22,13 +22,13 @@ Standard C library .nf .B #include <sys/file.h> .P -.BI "int flock(int " fd ", int " operation ); +.BI "int flock(int " fd ", int " op ); .fi .SH DESCRIPTION Apply or remove an advisory lock on the open file specified by .IR fd . The argument -.I operation +.I op is one of the following: .RS 4 .TP 9 @@ -111,7 +111,7 @@ delivery of a signal caught by a handler; see .BR signal (7). .TP .B EINVAL -.I operation +.I op is invalid. .TP .B ENOLCK diff --git a/upstream/fedora-rawhide/man2/fork.2 b/upstream/fedora-rawhide/man2/fork.2 index a08f38b8..abfbbedc 100644 --- a/upstream/fedora-rawhide/man2/fork.2 +++ b/upstream/fedora-rawhide/man2/fork.2 @@ -16,7 +16,7 @@ .\" Greatly expanded, to describe all attributes that differ .\" parent and child. .\" -.TH fork 2 2023-10-31 "Linux man-pages 6.06" +.TH fork 2 2023-10-31 "Linux man-pages 6.7" .SH NAME fork \- create a child process .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/fsync.2 b/upstream/fedora-rawhide/man2/fsync.2 index 8c1749dc..8566ef7f 100644 --- a/upstream/fedora-rawhide/man2/fsync.2 +++ b/upstream/fedora-rawhide/man2/fsync.2 @@ -15,7 +15,7 @@ .\" 2006-04-28, mtk, substantial rewrite of various parts. .\" 2012-02-27 Various changes by Christoph Hellwig <hch@lst.de> .\" -.TH fsync 2 2023-10-31 "Linux man-pages 6.06" +.TH fsync 2 2023-10-31 "Linux man-pages 6.7" .SH NAME fsync, fdatasync \- synchronize a file's in-core state with storage device .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/futex.2 b/upstream/fedora-rawhide/man2/futex.2 index 690fb776..2ff300b3 100644 --- a/upstream/fedora-rawhide/man2/futex.2 +++ b/upstream/fedora-rawhide/man2/futex.2 @@ -19,7 +19,7 @@ .\" FIXME Do we need to add some text regarding Torvald Riegel's 2015-01-24 mail .\" http://thread.gmane.org/gmane.linux.kernel/1703405/focus=1873242 .\" -.TH futex 2 2023-10-31 "Linux man-pages 6.06" +.TH futex 2 2023-10-31 "Linux man-pages 6.7" .SH NAME futex \- fast user-space locking .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/futimesat.2 b/upstream/fedora-rawhide/man2/futimesat.2 index ef9751cd..b2a18abb 100644 --- a/upstream/fedora-rawhide/man2/futimesat.2 +++ b/upstream/fedora-rawhide/man2/futimesat.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH futimesat 2 2023-10-31 "Linux man-pages 6.06" +.TH futimesat 2 2023-10-31 "Linux man-pages 6.7" .SH NAME futimesat \- change timestamps of a file relative to a \ directory file descriptor diff --git a/upstream/fedora-rawhide/man2/get_kernel_syms.2 b/upstream/fedora-rawhide/man2/get_kernel_syms.2 index e059e793..a1029b19 100644 --- a/upstream/fedora-rawhide/man2/get_kernel_syms.2 +++ b/upstream/fedora-rawhide/man2/get_kernel_syms.2 @@ -5,7 +5,7 @@ .\" 2006-02-09, some reformatting by Luc Van Oostenryck; some .\" reformatting and rewordings by mtk .\" -.TH get_kernel_syms 2 2023-10-31 "Linux man-pages 6.06" +.TH get_kernel_syms 2 2023-10-31 "Linux man-pages 6.7" .SH NAME get_kernel_syms \- retrieve exported kernel and module symbols .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/get_mempolicy.2 b/upstream/fedora-rawhide/man2/get_mempolicy.2 index 3d308c61..3846bcc2 100644 --- a/upstream/fedora-rawhide/man2/get_mempolicy.2 +++ b/upstream/fedora-rawhide/man2/get_mempolicy.2 @@ -7,7 +7,7 @@ .\" 2007-08-27, Lee Schermerhorn <Lee.Schermerhorn@hp.com> .\" more precise specification of behavior. .\" -.TH get_mempolicy 2 2023-10-31 "Linux man-pages 6.06" +.TH get_mempolicy 2 2023-10-31 "Linux man-pages 6.7" .SH NAME get_mempolicy \- retrieve NUMA memory policy for a thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/get_robust_list.2 b/upstream/fedora-rawhide/man2/get_robust_list.2 index 4b8533bb..bd8682a8 100644 --- a/upstream/fedora-rawhide/man2/get_robust_list.2 +++ b/upstream/fedora-rawhide/man2/get_robust_list.2 @@ -7,7 +7,7 @@ .\" FIXME Something could be added to this page (or exit(2)) .\" about exit_robust_list processing .\" -.TH get_robust_list 2 2023-10-31 "Linux man-pages 6.06" +.TH get_robust_list 2 2023-10-31 "Linux man-pages 6.7" .SH NAME get_robust_list, set_robust_list \- get/set list of robust futexes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getcpu.2 b/upstream/fedora-rawhide/man2/getcpu.2 index 90c93e43..45254707 100644 --- a/upstream/fedora-rawhide/man2/getcpu.2 +++ b/upstream/fedora-rawhide/man2/getcpu.2 @@ -4,7 +4,7 @@ .\" .\" 2008, mtk, various edits .\" -.TH getcpu 2 2023-10-31 "Linux man-pages 6.06" +.TH getcpu 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getcpu \- determine CPU and NUMA node on which the calling thread is running .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getdents.2 b/upstream/fedora-rawhide/man2/getdents.2 index d57204bd..728d4d72 100644 --- a/upstream/fedora-rawhide/man2/getdents.2 +++ b/upstream/fedora-rawhide/man2/getdents.2 @@ -8,7 +8,7 @@ .\" Derived from 'readdir.2'. .\" Modified Tue Oct 22 08:11:14 EDT 1996 by Eric S. Raymond <esr@thyrsus.com> .\" -.TH getdents 2 2023-10-31 "Linux man-pages 6.06" +.TH getdents 2 2024-02-25 "Linux man-pages 6.7" .SH NAME getdents, getdents64 \- get directory entries .SH LIBRARY @@ -67,7 +67,7 @@ structure is declared as follows: .EX struct linux_dirent { unsigned long d_ino; /* Inode number */ - unsigned long d_off; /* Offset to next \fIlinux_dirent\fP */ + unsigned long d_off; /* Not an offset; see below */ unsigned short d_reclen; /* Length of this \fIlinux_dirent\fP */ char d_name[]; /* Filename (null\-terminated) */ /* length is actually (d_reclen \- 2 \- @@ -84,8 +84,12 @@ struct linux_dirent { .I d_ino is an inode number. .I d_off -is the distance from the start of the directory to the start of the next -.IR linux_dirent . +is a filesystem-specific value with no specific meaning to user space, +though on older filesystems it used to be +the distance from the start of the directory to the start of the next +.IR linux_dirent ; +see +.BR readdir (3) . .I d_reclen is the size of this entire .IR linux_dirent . @@ -167,7 +171,7 @@ structures of the following type: .EX struct linux_dirent64 { ino64_t d_ino; /* 64\-bit inode number */ - off64_t d_off; /* 64\-bit offset to next structure */ + off64_t d_off; /* Not an offset; see getdents() */ unsigned short d_reclen; /* Size of this dirent */ unsigned char d_type; /* File type */ char d_name[]; /* Filename (null\-terminated) */ diff --git a/upstream/fedora-rawhide/man2/getdomainname.2 b/upstream/fedora-rawhide/man2/getdomainname.2 index 24cf7736..9c3b6e5b 100644 --- a/upstream/fedora-rawhide/man2/getdomainname.2 +++ b/upstream/fedora-rawhide/man2/getdomainname.2 @@ -6,7 +6,7 @@ .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2008-11-27 by mtk .\" -.TH getdomainname 2 2023-10-31 "Linux man-pages 6.06" +.TH getdomainname 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getdomainname, setdomainname \- get/set NIS domain name .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getgid.2 b/upstream/fedora-rawhide/man2/getgid.2 index 61b838cc..74394a1c 100644 --- a/upstream/fedora-rawhide/man2/getgid.2 +++ b/upstream/fedora-rawhide/man2/getgid.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getgid 2 2023-10-31 "Linux man-pages 6.06" +.TH getgid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getgid, getegid \- get group identity .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getgroups.2 b/upstream/fedora-rawhide/man2/getgroups.2 index cddba228..d00dc9e3 100644 --- a/upstream/fedora-rawhide/man2/getgroups.2 +++ b/upstream/fedora-rawhide/man2/getgroups.2 @@ -9,7 +9,7 @@ .\" 2008-05-03, mtk, expanded and rewrote parts of DESCRIPTION and RETURN .\" VALUE, made style of page more consistent with man-pages style. .\" -.TH getgroups 2 2023-10-31 "Linux man-pages 6.06" +.TH getgroups 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getgroups, setgroups \- get/set list of supplementary group IDs .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/gethostname.2 b/upstream/fedora-rawhide/man2/gethostname.2 index 23dc9398..0e3ed703 100644 --- a/upstream/fedora-rawhide/man2/gethostname.2 +++ b/upstream/fedora-rawhide/man2/gethostname.2 @@ -9,7 +9,7 @@ .\" Modified 2004-06-17 by mtk .\" Modified 2008-11-27 by mtk .\" -.TH gethostname 2 2023-10-31 "Linux man-pages 6.06" +.TH gethostname 2 2023-10-31 "Linux man-pages 6.7" .SH NAME gethostname, sethostname \- get/set hostname .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getitimer.2 b/upstream/fedora-rawhide/man2/getitimer.2 index 67ffe281..66741177 100644 --- a/upstream/fedora-rawhide/man2/getitimer.2 +++ b/upstream/fedora-rawhide/man2/getitimer.2 @@ -10,7 +10,7 @@ .\" 2005-04-06 mtk, Matthias Lang <matthias@corelatus.se> .\" Noted MAX_SEC_IN_JIFFIES ceiling .\" -.TH getitimer 2 2023-10-31 "Linux man-pages 6.06" +.TH getitimer 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getitimer, setitimer \- get or set value of an interval timer .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getpagesize.2 b/upstream/fedora-rawhide/man2/getpagesize.2 index 0c5f2d23..25fcbcdf 100644 --- a/upstream/fedora-rawhide/man2/getpagesize.2 +++ b/upstream/fedora-rawhide/man2/getpagesize.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getpagesize 2 2023-10-31 "Linux man-pages 6.06" +.TH getpagesize 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getpagesize \- get memory page size .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getpeername.2 b/upstream/fedora-rawhide/man2/getpeername.2 index be6f521a..b738e9eb 100644 --- a/upstream/fedora-rawhide/man2/getpeername.2 +++ b/upstream/fedora-rawhide/man2/getpeername.2 @@ -11,7 +11,7 @@ .\" Modified 17 Jul 2002, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added 'socket' to NAME, so that "man -k socket" will show this page. .\" -.TH getpeername 2 2023-10-31 "Linux man-pages 6.06" +.TH getpeername 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getpeername \- get name of connected peer socket .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getpid.2 b/upstream/fedora-rawhide/man2/getpid.2 index 6d8b39f7..51660353 100644 --- a/upstream/fedora-rawhide/man2/getpid.2 +++ b/upstream/fedora-rawhide/man2/getpid.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getpid 2 2023-10-31 "Linux man-pages 6.06" +.TH getpid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getpid, getppid \- get process identification .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getpriority.2 b/upstream/fedora-rawhide/man2/getpriority.2 index 6a6380a2..e4aa4f09 100644 --- a/upstream/fedora-rawhide/man2/getpriority.2 +++ b/upstream/fedora-rawhide/man2/getpriority.2 @@ -14,7 +14,7 @@ .\" Clarified meaning of 0 value for 'who' argument .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH getpriority 2 2023-10-31 "Linux man-pages 6.06" +.TH getpriority 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getpriority, setpriority \- get/set program scheduling priority .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getrandom.2 b/upstream/fedora-rawhide/man2/getrandom.2 index aef6508e..e4c63a8a 100644 --- a/upstream/fedora-rawhide/man2/getrandom.2 +++ b/upstream/fedora-rawhide/man2/getrandom.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getrandom 2 2023-10-31 "Linux man-pages 6.06" +.TH getrandom 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getrandom \- obtain a series of random bytes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getresuid.2 b/upstream/fedora-rawhide/man2/getresuid.2 index f31a4497..9b4a1fff 100644 --- a/upstream/fedora-rawhide/man2/getresuid.2 +++ b/upstream/fedora-rawhide/man2/getresuid.2 @@ -5,7 +5,7 @@ .\" .\" Modified, 2003-05-26, Michael Kerrisk, <mtk.manpages@gmail.com> .\" -.TH getresuid 2 2023-10-31 "Linux man-pages 6.06" +.TH getresuid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getresuid, getresgid \- get real, effective, and saved user/group IDs .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getrlimit.2 b/upstream/fedora-rawhide/man2/getrlimit.2 index f64100b8..ece8e97b 100644 --- a/upstream/fedora-rawhide/man2/getrlimit.2 +++ b/upstream/fedora-rawhide/man2/getrlimit.2 @@ -42,7 +42,7 @@ .\" 2008-05-07, mtk / Peter Zijlstra, Added description of RLIMIT_RTTIME .\" 2010-11-06, mtk: Added documentation of prlimit() .\" -.TH getrlimit 2 2023-10-31 "Linux man-pages 6.06" +.TH getrlimit 2 2024-02-25 "Linux man-pages 6.7" .SH NAME getrlimit, setrlimit, prlimit \- get/set resource limits .SH LIBRARY @@ -717,7 +717,7 @@ Linux doesn't return an error when an attempt to set .B RLIMIT_CPU has failed, for compatibility reasons. .\" -.SS Representation of """large""" resource limit values on 32-bit platforms +.SS Representation of \[dq]large\[dq] resource limit values on 32-bit platforms The glibc .BR getrlimit () and diff --git a/upstream/fedora-rawhide/man2/getrusage.2 b/upstream/fedora-rawhide/man2/getrusage.2 index 107365a2..97c144ff 100644 --- a/upstream/fedora-rawhide/man2/getrusage.2 +++ b/upstream/fedora-rawhide/man2/getrusage.2 @@ -17,7 +17,7 @@ .\" document ru_maxrss .\" 2010-05-24, mtk, enhanced description of various fields .\" -.TH getrusage 2 2023-10-31 "Linux man-pages 6.06" +.TH getrusage 2 2024-03-14 "Linux man-pages 6.7" .SH NAME getrusage \- get resource usage .SH LIBRARY @@ -239,15 +239,12 @@ implementation.) .SH NOTES Resource usage metrics are preserved across an .BR execve (2). -.P -See also the description of -.IR /proc/ pid /stat -in -.BR proc (5). .SH SEE ALSO .BR clock_gettime (2), .BR getrlimit (2), .BR times (2), .BR wait (2), .BR wait4 (2), -.BR clock (3) +.BR clock (3), +.BR proc_pid_stat (5), +.BR proc_pid_io (5) diff --git a/upstream/fedora-rawhide/man2/getsid.2 b/upstream/fedora-rawhide/man2/getsid.2 index ecdcdbec..25f0b2d1 100644 --- a/upstream/fedora-rawhide/man2/getsid.2 +++ b/upstream/fedora-rawhide/man2/getsid.2 @@ -5,7 +5,7 @@ .\" .\" Modified Thu Oct 31 14:18:40 1996 by Eric S. Raymond <esr@y\thyrsus.com> .\" Modified 2001-12-17, aeb -.TH getsid 2 2023-10-31 "Linux man-pages 6.06" +.TH getsid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getsid \- get session ID .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getsockname.2 b/upstream/fedora-rawhide/man2/getsockname.2 index 44d4f885..6d4a9f67 100644 --- a/upstream/fedora-rawhide/man2/getsockname.2 +++ b/upstream/fedora-rawhide/man2/getsockname.2 @@ -9,7 +9,7 @@ .\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond <esr@thyrsus.com> .\" Modified Sun Mar 28 21:26:46 1999 by Andries Brouwer <aeb@cwi.nl> .\" -.TH getsockname 2 2023-10-31 "Linux man-pages 6.06" +.TH getsockname 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getsockname \- get socket name .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getsockopt.2 b/upstream/fedora-rawhide/man2/getsockopt.2 index 448235c3..baf3395a 100644 --- a/upstream/fedora-rawhide/man2/getsockopt.2 +++ b/upstream/fedora-rawhide/man2/getsockopt.2 @@ -13,7 +13,7 @@ .\" Modified 1999 by Andi Kleen <ak@muc.de>. .\" Removed most stuff because it is in socket.7 now. .\" -.TH getsockopt 2 2023-10-31 "Linux man-pages 6.06" +.TH getsockopt 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getsockopt, setsockopt \- get and set options on sockets .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/gettid.2 b/upstream/fedora-rawhide/man2/gettid.2 index 007a6a73..297a9026 100644 --- a/upstream/fedora-rawhide/man2/gettid.2 +++ b/upstream/fedora-rawhide/man2/gettid.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH gettid 2 2023-10-31 "Linux man-pages 6.06" +.TH gettid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME gettid \- get thread identification .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/gettimeofday.2 b/upstream/fedora-rawhide/man2/gettimeofday.2 index fcdcd9b1..cd8bc841 100644 --- a/upstream/fedora-rawhide/man2/gettimeofday.2 +++ b/upstream/fedora-rawhide/man2/gettimeofday.2 @@ -17,7 +17,7 @@ .\" Modified, 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirement. .\" -.TH gettimeofday 2 2023-10-31 "Linux man-pages 6.06" +.TH gettimeofday 2 2023-10-31 "Linux man-pages 6.7" .SH NAME gettimeofday, settimeofday \- get / set time .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getuid.2 b/upstream/fedora-rawhide/man2/getuid.2 index e669f7fd..978b8ec0 100644 --- a/upstream/fedora-rawhide/man2/getuid.2 +++ b/upstream/fedora-rawhide/man2/getuid.2 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Historical remark, aeb, 2004-06-05 -.TH getuid 2 2023-10-31 "Linux man-pages 6.06" +.TH getuid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getuid, geteuid \- get user identity .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getunwind.2 b/upstream/fedora-rawhide/man2/getunwind.2 index 6fb96e33..1a904b70 100644 --- a/upstream/fedora-rawhide/man2/getunwind.2 +++ b/upstream/fedora-rawhide/man2/getunwind.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getunwind 2 2023-10-31 "Linux man-pages 6.06" +.TH getunwind 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getunwind \- copy the unwind data to caller's buffer .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/getxattr.2 b/upstream/fedora-rawhide/man2/getxattr.2 index e65a2a6d..6d7a0ee4 100644 --- a/upstream/fedora-rawhide/man2/getxattr.2 +++ b/upstream/fedora-rawhide/man2/getxattr.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH getxattr 2 2023-10-31 "Linux man-pages 6.06" +.TH getxattr 2 2023-10-31 "Linux man-pages 6.7" .SH NAME getxattr, lgetxattr, fgetxattr \- retrieve an extended attribute value .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/idle.2 b/upstream/fedora-rawhide/man2/idle.2 index 53a48ed4..c32b3d7d 100644 --- a/upstream/fedora-rawhide/man2/idle.2 +++ b/upstream/fedora-rawhide/man2/idle.2 @@ -9,7 +9,7 @@ .\" N.B. calling "idle" from user process used to hang process! .\" Modified Thu Oct 31 14:41:15 1996 by Eric S. Raymond <esr@thyrsus.com> .\" " -.TH idle 2 2023-10-31 "Linux man-pages 6.06" +.TH idle 2 2023-10-31 "Linux man-pages 6.7" .SH NAME idle \- make process 0 idle .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/init_module.2 b/upstream/fedora-rawhide/man2/init_module.2 index b667b841..5cc61d04 100644 --- a/upstream/fedora-rawhide/man2/init_module.2 +++ b/upstream/fedora-rawhide/man2/init_module.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH init_module 2 2023-10-31 "Linux man-pages 6.06" +.TH init_module 2 2023-10-31 "Linux man-pages 6.7" .SH NAME init_module, finit_module \- load a kernel module .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/inotify_add_watch.2 b/upstream/fedora-rawhide/man2/inotify_add_watch.2 index f25a8240..b86328b6 100644 --- a/upstream/fedora-rawhide/man2/inotify_add_watch.2 +++ b/upstream/fedora-rawhide/man2/inotify_add_watch.2 @@ -6,7 +6,7 @@ .\" 2005-07-19 Robert Love <rlove@rlove.org> - initial version .\" 2006-02-07 mtk, various changes .\" -.TH inotify_add_watch 2 2023-10-31 "Linux man-pages 6.06" +.TH inotify_add_watch 2 2023-10-31 "Linux man-pages 6.7" .SH NAME inotify_add_watch \- add a watch to an initialized inotify instance .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/inotify_init.2 b/upstream/fedora-rawhide/man2/inotify_init.2 index 91c28cfb..16694cf5 100644 --- a/upstream/fedora-rawhide/man2/inotify_init.2 +++ b/upstream/fedora-rawhide/man2/inotify_init.2 @@ -7,7 +7,7 @@ .\" 2006-02-07 mtk, minor changes .\" 2008-10-10 mtk: add description of inotify_init1() .\" -.TH inotify_init 2 2023-10-31 "Linux man-pages 6.06" +.TH inotify_init 2 2023-10-31 "Linux man-pages 6.7" .SH NAME inotify_init, inotify_init1 \- initialize an inotify instance .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/inotify_rm_watch.2 b/upstream/fedora-rawhide/man2/inotify_rm_watch.2 index 02a045c7..9fb52385 100644 --- a/upstream/fedora-rawhide/man2/inotify_rm_watch.2 +++ b/upstream/fedora-rawhide/man2/inotify_rm_watch.2 @@ -5,7 +5,7 @@ .\" 2005-07-19 Robert Love <rlove@rlove.org> - initial version .\" 2006-02-07 mtk, minor changes .\" -.TH inotify_rm_watch 2 2023-10-31 "Linux man-pages 6.06" +.TH inotify_rm_watch 2 2023-10-31 "Linux man-pages 6.7" .SH NAME inotify_rm_watch \- remove an existing watch from an inotify instance .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/intro.2 b/upstream/fedora-rawhide/man2/intro.2 index dd70500a..74af07ca 100644 --- a/upstream/fedora-rawhide/man2/intro.2 +++ b/upstream/fedora-rawhide/man2/intro.2 @@ -6,7 +6,7 @@ .\" new _syscall(2) page, and substantially enhanced and rewrote .\" the remaining material on this page. .\" -.TH intro 2 2023-10-31 "Linux man-pages 6.06" +.TH intro 2 2023-10-31 "Linux man-pages 6.7" .SH NAME intro \- introduction to system calls .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man2/io_cancel.2 b/upstream/fedora-rawhide/man2/io_cancel.2 index 5ab47e7b..7cce965e 100644 --- a/upstream/fedora-rawhide/man2/io_cancel.2 +++ b/upstream/fedora-rawhide/man2/io_cancel.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH io_cancel 2 2023-10-31 "Linux man-pages 6.06" +.TH io_cancel 2 2023-10-31 "Linux man-pages 6.7" .SH NAME io_cancel \- cancel an outstanding asynchronous I/O operation .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/io_destroy.2 b/upstream/fedora-rawhide/man2/io_destroy.2 index 7b97a979..b22be597 100644 --- a/upstream/fedora-rawhide/man2/io_destroy.2 +++ b/upstream/fedora-rawhide/man2/io_destroy.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH io_destroy 2 2023-10-31 "Linux man-pages 6.06" +.TH io_destroy 2 2023-10-31 "Linux man-pages 6.7" .SH NAME io_destroy \- destroy an asynchronous I/O context .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/io_getevents.2 b/upstream/fedora-rawhide/man2/io_getevents.2 index a40950d5..05332f3d 100644 --- a/upstream/fedora-rawhide/man2/io_getevents.2 +++ b/upstream/fedora-rawhide/man2/io_getevents.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH io_getevents 2 2023-10-31 "Linux man-pages 6.06" +.TH io_getevents 2 2023-10-31 "Linux man-pages 6.7" .SH NAME io_getevents \- read asynchronous I/O events from the completion queue .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/io_setup.2 b/upstream/fedora-rawhide/man2/io_setup.2 index 1dfd3a94..8fba0bac 100644 --- a/upstream/fedora-rawhide/man2/io_setup.2 +++ b/upstream/fedora-rawhide/man2/io_setup.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH io_setup 2 2023-10-31 "Linux man-pages 6.06" +.TH io_setup 2 2023-10-31 "Linux man-pages 6.7" .SH NAME io_setup \- create an asynchronous I/O context .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/io_submit.2 b/upstream/fedora-rawhide/man2/io_submit.2 index 5398d53e..215701e4 100644 --- a/upstream/fedora-rawhide/man2/io_submit.2 +++ b/upstream/fedora-rawhide/man2/io_submit.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH io_submit 2 2023-10-31 "Linux man-pages 6.06" +.TH io_submit 2 2023-10-31 "Linux man-pages 6.7" .SH NAME io_submit \- submit asynchronous I/O blocks for processing .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/ioctl.2 b/upstream/fedora-rawhide/man2/ioctl.2 index 75c8ad11..518712b7 100644 --- a/upstream/fedora-rawhide/man2/ioctl.2 +++ b/upstream/fedora-rawhide/man2/ioctl.2 @@ -10,7 +10,7 @@ .\" Modified 1999-06-25 by Rachael Munns <vashti@dream.org.uk> .\" Modified 2000-09-21 by Andries Brouwer <aeb@cwi.nl> .\" -.TH ioctl 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl 2 2024-03-03 "Linux man-pages 6.7" .SH NAME ioctl \- control device .SH LIBRARY @@ -20,8 +20,8 @@ Standard C library .nf .B #include <sys/ioctl.h> .P -.BI "int ioctl(int " fd ", unsigned long " request ", ...);" "\f[R] /* glibc, BSD */\f[]" -.BI "int ioctl(int " fd ", int " request ", ...);" "\f[R] /* musl, other UNIX */\f[]" +.BI "int ioctl(int " fd ", unsigned long " op ", ...);" "\f[R] /* glibc, BSD */\f[]" +.BI "int ioctl(int " fd ", int " op ", ...);" "\f[R] /* musl, other UNIX */\f[]" .fi .SH DESCRIPTION The @@ -30,12 +30,12 @@ system call manipulates the underlying device parameters of special files. In particular, many operating characteristics of character special files (e.g., terminals) may be controlled with .BR ioctl () -requests. +operations. The argument .I fd must be an open file descriptor. .P -The second argument is a device-dependent request code. +The second argument is a device-dependent operation code. The third argument is an untyped pointer to memory. It's traditionally .BI "char *" argp @@ -45,7 +45,7 @@ was valid C), and will be so named for this discussion. .P An .BR ioctl () -.I request +.I op has encoded in it whether the argument is an .I in parameter or @@ -55,7 +55,7 @@ parameter, and the size of the argument in bytes. Macros and defines used in specifying an .BR ioctl () -.I request +.I op are located in the file .IR <sys/ioctl.h> . See NOTES. @@ -63,7 +63,7 @@ See NOTES. Usually, on success zero is returned. A few .BR ioctl () -requests use the return value as an output parameter +operations use the return value as an output parameter and return a nonnegative value on success. On error, \-1 is returned, and .I errno @@ -79,7 +79,7 @@ is not a valid file descriptor. references an inaccessible memory area. .TP .B EINVAL -.I request +.I op or .I argp is not valid. @@ -89,7 +89,7 @@ is not valid. is not associated with a character special device. .TP .B ENOTTY -The specified request does not apply to the kind of object that the +The specified operation does not apply to the kind of object that the file descriptor .I fd references. @@ -106,7 +106,7 @@ Version\~7 AT&T UNIX has .PD 0 .in +4n .nf -.BI "ioctl(int " fildes ", int " request ", struct sgttyb *" argp ); +.BI "ioctl(int " fildes ", int " op ", struct sgttyb *" argp ); .fi .in .P @@ -117,7 +117,7 @@ has historically been used by .BR stty (2) and .BR gtty (2), -and is polymorphic by request type (like a +and is polymorphic by operation type (like a .B void * would be, if it had been available)). .P @@ -129,7 +129,7 @@ without a type at all. .PD 0 .in +4n .nf -.BI "ioctl(int " d ", unsigned long " request ", char *" argp ); +.BI "ioctl(int " d ", unsigned long " op ", char *" argp ); .fi .in .P @@ -143,7 +143,7 @@ SysVr4 has .PD 0 .in +4n .nf -.BI "int ioctl(int " fildes ", int " request ", ... /* " arg " */);" +.BI "int ioctl(int " fildes ", int " op ", ... /* " arg " */);" .fi .in .P @@ -159,7 +159,9 @@ flag. .\" .SS ioctl structure .\" added two sections - aeb -Ioctl command values are 32-bit constants. +Ioctl +.I op +values are 32-bit constants. In principle these constants are completely arbitrary, but people have tried to build some structure into them. .P diff --git a/upstream/fedora-rawhide/man2/ioctl_console.2 b/upstream/fedora-rawhide/man2/ioctl_console.2 index 06d01a6e..f06725ff 100644 --- a/upstream/fedora-rawhide/man2/ioctl_console.2 +++ b/upstream/fedora-rawhide/man2/ioctl_console.2 @@ -19,14 +19,14 @@ .\" VT_UNLOCKSWITCH (since Linux 1.3.47, needs CAP_SYS_TTY_CONFIG) .\" VT_GETHIFONTMASK (since Linux 2.6.18) .\" -.TH ioctl_console 2 2023-12-21 "Linux man-pages 6.06" +.TH ioctl_console 2 2024-03-03 "Linux man-pages 6.7" .SH NAME ioctl_console \- ioctls for console terminal and virtual consoles .SH DESCRIPTION The following Linux-specific .BR ioctl (2) -requests are supported for console terminals and virtual consoles. -Each requires a third argument, assumed here to be +operations are supported for console terminals and virtual consoles. +Each operation requires a third argument, assumed here to be .IR argp . .TP .B KDGETLED @@ -546,7 +546,7 @@ points to a struct vt_mode { char mode; /* vt mode */ char waitv; /* if set, hang on writes if not active */ - short relsig; /* signal to raise on release req */ + short relsig; /* signal to raise on release op */ short acqsig; /* signal to raise on acquisition */ short frsig; /* unused (set to 0) */ }; @@ -861,7 +861,7 @@ is invalid. .TP .B ENOTTY The file descriptor is not associated with a character special device, -or the specified request does not apply to it. +or the specified operation does not apply to it. .TP .B EPERM Insufficient permission. diff --git a/upstream/fedora-rawhide/man2/ioctl_fat.2 b/upstream/fedora-rawhide/man2/ioctl_fat.2 index b028898f..a690cf1f 100644 --- a/upstream/fedora-rawhide/man2/ioctl_fat.2 +++ b/upstream/fedora-rawhide/man2/ioctl_fat.2 @@ -1,7 +1,7 @@ .\" Copyright (C) 2014, Heinrich Schuchardt <xypron.glpk@gmx.de> .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH ioctl_fat 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_fat 2 2023-10-31 "Linux man-pages 6.7" .SH NAME ioctl_fat \- manipulating the FAT filesystem .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/ioctl_ficlonerange.2 b/upstream/fedora-rawhide/man2/ioctl_ficlonerange.2 index 01f06856..b2c5e6b4 100644 --- a/upstream/fedora-rawhide/man2/ioctl_ficlonerange.2 +++ b/upstream/fedora-rawhide/man2/ioctl_ficlonerange.2 @@ -1,7 +1,7 @@ .\" Copyright (c) 2016, Oracle. All rights reserved. .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH ioctl_ficlonerange 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_ficlonerange 2 2023-10-31 "Linux man-pages 6.7" .SH NAME ioctl_ficlonerange, ioctl_ficlone \- share some the data of one file with another file diff --git a/upstream/fedora-rawhide/man2/ioctl_fideduperange.2 b/upstream/fedora-rawhide/man2/ioctl_fideduperange.2 index 4b04efa5..84fd2e88 100644 --- a/upstream/fedora-rawhide/man2/ioctl_fideduperange.2 +++ b/upstream/fedora-rawhide/man2/ioctl_fideduperange.2 @@ -1,7 +1,7 @@ .\" Copyright (c) 2016, Oracle. All rights reserved. .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH ioctl_fideduperange 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_fideduperange 2 2024-03-03 "Linux man-pages 6.7" .SH NAME ioctl_fideduperange \- share some the data of one file with another file .SH LIBRARY @@ -116,7 +116,7 @@ deduplicated is returned in and a status code for the deduplication operation is returned in .IR status . If even a single byte in the range does not match, the deduplication -request will be ignored and +operation request will be ignored and .I status set to .BR FILE_DEDUPE_RANGE_DIFFERS . diff --git a/upstream/fedora-rawhide/man2/ioctl_fslabel.2 b/upstream/fedora-rawhide/man2/ioctl_fslabel.2 index 6abc8348..7fcde808 100644 --- a/upstream/fedora-rawhide/man2/ioctl_fslabel.2 +++ b/upstream/fedora-rawhide/man2/ioctl_fslabel.2 @@ -1,7 +1,7 @@ .\" Copyright (c) 2018, Red Hat, Inc. All rights reserved. .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH ioctl_fslabel 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_fslabel 2 2023-10-31 "Linux man-pages 6.7" .SH NAME ioctl_fslabel \- get or set a filesystem label .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/ioctl_getfsmap.2 b/upstream/fedora-rawhide/man2/ioctl_getfsmap.2 index 99dccdfc..97fbc677 100644 --- a/upstream/fedora-rawhide/man2/ioctl_getfsmap.2 +++ b/upstream/fedora-rawhide/man2/ioctl_getfsmap.2 @@ -1,7 +1,7 @@ .\" Copyright (c) 2017, Oracle. All rights reserved. .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH ioctl_getfsmap 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_getfsmap 2 2024-03-03 "Linux man-pages 6.7" .SH NAME ioctl_getfsmap \- retrieve the physical layout of the filesystem .SH LIBRARY @@ -124,7 +124,7 @@ By convention, the field .I fsmap_head.fmh_keys[0] must contain the low key and .I fsmap_head.fmh_keys[1] -must contain the high key for the request. +must contain the high key for the operation. .P For convenience, if .I fmr_length @@ -328,10 +328,10 @@ physical storage address space than the high key, or a nonzero value was passed in one of the fields that must be zero. .TP .B ENOMEM -Insufficient memory to process the request. +Insufficient memory to process the operation. .TP .B EOPNOTSUPP -The filesystem does not support this command. +The filesystem does not support this operation. .TP .B EUCLEAN The filesystem metadata is corrupt and needs repair. diff --git a/upstream/fedora-rawhide/man2/ioctl_iflags.2 b/upstream/fedora-rawhide/man2/ioctl_iflags.2 index c066c9e6..e6cc7cbf 100644 --- a/upstream/fedora-rawhide/man2/ioctl_iflags.2 +++ b/upstream/fedora-rawhide/man2/ioctl_iflags.2 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH ioctl_iflags 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_iflags 2 2023-10-31 "Linux man-pages 6.7" .SH NAME ioctl_iflags \- ioctl() operations for inode flags .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man2/ioctl_ns.2 b/upstream/fedora-rawhide/man2/ioctl_ns.2 index 0f8563e1..a21c14ab 100644 --- a/upstream/fedora-rawhide/man2/ioctl_ns.2 +++ b/upstream/fedora-rawhide/man2/ioctl_ns.2 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH ioctl_ns 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_ns 2 2024-03-03 "Linux man-pages 6.7" .SH NAME ioctl_ns \- ioctl() operations for Linux namespaces .SH DESCRIPTION @@ -20,7 +20,7 @@ The form of the calls is: .P .in +4n .EX -new_fd = ioctl(fd, request); +new_fd = ioctl(fd, op); .EE .in .P diff --git a/upstream/fedora-rawhide/man2/ioctl_pagemap_scan.2 b/upstream/fedora-rawhide/man2/ioctl_pagemap_scan.2 index 64763da4..fcd9bdcb 100644 --- a/upstream/fedora-rawhide/man2/ioctl_pagemap_scan.2 +++ b/upstream/fedora-rawhide/man2/ioctl_pagemap_scan.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH ioctl_pagemap_scan 2 2024-01-28 "Linux man-pages 6.06" +.TH ioctl_pagemap_scan 2 2024-01-28 "Linux man-pages 6.7" .SH NAME ioctl_pagemap_scan \- get and/or clear page flags .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/ioctl_pipe.2 b/upstream/fedora-rawhide/man2/ioctl_pipe.2 index fe99cd8d..d08efa1f 100644 --- a/upstream/fedora-rawhide/man2/ioctl_pipe.2 +++ b/upstream/fedora-rawhide/man2/ioctl_pipe.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH ioctl_pipe 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_pipe 2 2023-10-31 "Linux man-pages 6.7" .SH NAME ioctl_pipe \- ioctl() operations for General notification mechanism .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/ioctl_tty.2 b/upstream/fedora-rawhide/man2/ioctl_tty.2 index 8ade11e8..9d247ed5 100644 --- a/upstream/fedora-rawhide/man2/ioctl_tty.2 +++ b/upstream/fedora-rawhide/man2/ioctl_tty.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH ioctl_tty 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_tty 2 2024-03-03 "Linux man-pages 6.7" .SH NAME ioctl_tty \- ioctls for terminals and serial lines .SH LIBRARY @@ -18,12 +18,12 @@ Standard C library .BR " Bnnn" ", " BOTHER ", " CBAUD ", " CLOCAL , .BR " TC*" { FLUSH , ON , OFF "} and other constants */" .P -.BI "int ioctl(int " fd ", int " cmd ", ...);" +.BI "int ioctl(int " fd ", int " op ", ...);" .fi .SH DESCRIPTION The .BR ioctl (2) -call for terminals and serial ports accepts many possible command arguments. +call for terminals and serial ports accepts many possible operation arguments. Most require a third argument, of varying type, here called .I argp or @@ -735,7 +735,7 @@ Get the .I tty_struct corresponding to .IR fd . -This command was removed in Linux 2.5.67. +This operation was removed in Linux 2.5.67. .\" commit b3506a09d15dc5aee6d4bb88d759b157016e1864 .\" Author: Andries E. Brouwer <andries.brouwer@cwi.nl> .\" Date: Tue Apr 1 04:42:46 2003 -0800 @@ -764,10 +764,10 @@ to indicate the error. .SH ERRORS .TP .B EINVAL -Invalid command parameter. +Invalid operation parameter. .TP .B ENOIOCTLCMD -Unknown command. +Unknown operation. .TP .B ENOTTY Inappropriate diff --git a/upstream/fedora-rawhide/man2/ioctl_userfaultfd.2 b/upstream/fedora-rawhide/man2/ioctl_userfaultfd.2 index 390fb8bb..08e52e61 100644 --- a/upstream/fedora-rawhide/man2/ioctl_userfaultfd.2 +++ b/upstream/fedora-rawhide/man2/ioctl_userfaultfd.2 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH ioctl_userfaultfd 2 2023-10-31 "Linux man-pages 6.06" +.TH ioctl_userfaultfd 2 2024-03-03 "Linux man-pages 6.7" .SH NAME ioctl_userfaultfd \- create a file descriptor for handling page faults in user space @@ -17,7 +17,7 @@ Standard C library .BR "#include <linux/userfaultfd.h>" " /* Definition of " UFFD* " constants */" .B #include <sys/ioctl.h> .P -.BI "int ioctl(int " fd ", int " cmd ", ...);" +.BI "int ioctl(int " fd ", int " op ", ...);" .fi .SH DESCRIPTION Various @@ -28,18 +28,18 @@ using calls of the form: .P .in +4n .EX -ioctl(fd, cmd, argp); +ioctl(fd, op, argp); .EE .in .P In the above, .I fd is a file descriptor referring to a userfaultfd object, -.I cmd -is one of the commands listed below, and +.I op +is one of the operations listed below, and .I argp is a pointer to a data structure that is specific to -.IR cmd . +.IR op . .P The various .BR ioctl (2) diff --git a/upstream/fedora-rawhide/man2/ioperm.2 b/upstream/fedora-rawhide/man2/ioperm.2 index 565c16a8..dd62ce59 100644 --- a/upstream/fedora-rawhide/man2/ioperm.2 +++ b/upstream/fedora-rawhide/man2/ioperm.2 @@ -12,7 +12,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH ioperm 2 2023-10-31 "Linux man-pages 6.06" +.TH ioperm 2 2023-10-31 "Linux man-pages 6.7" .SH NAME ioperm \- set port input/output permissions .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/iopl.2 b/upstream/fedora-rawhide/man2/iopl.2 index 7f754df3..b2211e25 100644 --- a/upstream/fedora-rawhide/man2/iopl.2 +++ b/upstream/fedora-rawhide/man2/iopl.2 @@ -10,7 +10,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH iopl 2 2023-10-31 "Linux man-pages 6.06" +.TH iopl 2 2023-10-31 "Linux man-pages 6.7" .SH NAME iopl \- change I/O privilege level .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/ioprio_set.2 b/upstream/fedora-rawhide/man2/ioprio_set.2 index 16b0ff03..629d2df9 100644 --- a/upstream/fedora-rawhide/man2/ioprio_set.2 +++ b/upstream/fedora-rawhide/man2/ioprio_set.2 @@ -7,7 +7,7 @@ .\" with various additions by Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" -.TH ioprio_set 2 2023-10-31 "Linux man-pages 6.06" +.TH ioprio_set 2 2023-10-31 "Linux man-pages 6.7" .SH NAME ioprio_get, ioprio_set \- get/set I/O scheduling class and priority .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/ipc.2 b/upstream/fedora-rawhide/man2/ipc.2 index c6734938..e1b6c20a 100644 --- a/upstream/fedora-rawhide/man2/ipc.2 +++ b/upstream/fedora-rawhide/man2/ipc.2 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Tue Oct 22 08:11:14 EDT 1996 by Eric S. Raymond <esr@thyrsus.com> -.TH ipc 2 2023-10-31 "Linux man-pages 6.06" +.TH ipc 2 2023-10-31 "Linux man-pages 6.7" .SH NAME ipc \- System V IPC system calls .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/kcmp.2 b/upstream/fedora-rawhide/man2/kcmp.2 index 991448eb..cfd65df5 100644 --- a/upstream/fedora-rawhide/man2/kcmp.2 +++ b/upstream/fedora-rawhide/man2/kcmp.2 @@ -5,7 +5,7 @@ .\" .\" Kernel commit d97b46a64674a267bc41c9e16132ee2a98c3347d .\" -.TH kcmp 2 2023-10-31 "Linux man-pages 6.06" +.TH kcmp 2 2023-10-31 "Linux man-pages 6.7" .SH NAME kcmp \- compare two processes to determine if they share a kernel resource .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/kexec_load.2 b/upstream/fedora-rawhide/man2/kexec_load.2 index 93f98f0c..499f6caa 100644 --- a/upstream/fedora-rawhide/man2/kexec_load.2 +++ b/upstream/fedora-rawhide/man2/kexec_load.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH kexec_load 2 2023-10-31 "Linux man-pages 6.06" +.TH kexec_load 2 2023-10-31 "Linux man-pages 6.7" .SH NAME kexec_load, kexec_file_load \- load a new kernel for later execution .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/keyctl.2 b/upstream/fedora-rawhide/man2/keyctl.2 index db020bff..8f8ec190 100644 --- a/upstream/fedora-rawhide/man2/keyctl.2 +++ b/upstream/fedora-rawhide/man2/keyctl.2 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH keyctl 2 2023-11-01 "Linux man-pages 6.06" +.TH keyctl 2 2024-02-25 "Linux man-pages 6.7" .SH NAME keyctl \- manipulate the kernel's key management facility .SH LIBRARY @@ -1415,7 +1415,7 @@ The .I arg2 argument is a pointer to a set of parameters containing serial numbers for three -.I """user""" +.I \[dq]user\[dq] keys used in the Diffie-Hellman calculation, packaged in a structure of the following form: .IP @@ -1897,7 +1897,7 @@ was .B KEYCTL_READ and the key type does not support reading (e.g., the type is -.IR """login""" ). +.IR \[dq]login\[dq] ). .TP .B EOPNOTSUPP .I operation diff --git a/upstream/fedora-rawhide/man2/kill.2 b/upstream/fedora-rawhide/man2/kill.2 index 6d14ff31..1260ee04 100644 --- a/upstream/fedora-rawhide/man2/kill.2 +++ b/upstream/fedora-rawhide/man2/kill.2 @@ -21,7 +21,7 @@ .\" Modified 2004-06-24 by aeb .\" Modified, 2004-11-30, after idea from emmanuel.colbus@ensimag.imag.fr .\" -.TH kill 2 2023-10-31 "Linux man-pages 6.06" +.TH kill 2 2023-10-31 "Linux man-pages 6.7" .SH NAME kill \- send signal to a process .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/landlock_add_rule.2 b/upstream/fedora-rawhide/man2/landlock_add_rule.2 index 86e06a4c..2858fa38 100644 --- a/upstream/fedora-rawhide/man2/landlock_add_rule.2 +++ b/upstream/fedora-rawhide/man2/landlock_add_rule.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH landlock_add_rule 2 2023-10-31 "Linux man-pages 6.06" +.TH landlock_add_rule 2 2023-10-31 "Linux man-pages 6.7" .SH NAME landlock_add_rule \- add a new Landlock rule to a ruleset .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/landlock_create_ruleset.2 b/upstream/fedora-rawhide/man2/landlock_create_ruleset.2 index 367645c9..0c690271 100644 --- a/upstream/fedora-rawhide/man2/landlock_create_ruleset.2 +++ b/upstream/fedora-rawhide/man2/landlock_create_ruleset.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH landlock_create_ruleset 2 2023-10-31 "Linux man-pages 6.06" +.TH landlock_create_ruleset 2 2023-10-31 "Linux man-pages 6.7" .SH NAME landlock_create_ruleset \- create a new Landlock ruleset .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/landlock_restrict_self.2 b/upstream/fedora-rawhide/man2/landlock_restrict_self.2 index dc73c6de..c82181bd 100644 --- a/upstream/fedora-rawhide/man2/landlock_restrict_self.2 +++ b/upstream/fedora-rawhide/man2/landlock_restrict_self.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH landlock_restrict_self 2 2023-10-31 "Linux man-pages 6.06" +.TH landlock_restrict_self 2 2023-10-31 "Linux man-pages 6.7" .SH NAME landlock_restrict_self \- enforce a Landlock ruleset .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/link.2 b/upstream/fedora-rawhide/man2/link.2 index b6373b92..74437a0a 100644 --- a/upstream/fedora-rawhide/man2/link.2 +++ b/upstream/fedora-rawhide/man2/link.2 @@ -9,7 +9,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2005-04-04, as per suggestion by Michael Hardt for rename.2 .\" -.TH link 2 2023-10-31 "Linux man-pages 6.06" +.TH link 2 2023-10-31 "Linux man-pages 6.7" .SH NAME link, linkat \- make a new name for a file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/listen.2 b/upstream/fedora-rawhide/man2/listen.2 index 035d315f..94f0b2ce 100644 --- a/upstream/fedora-rawhide/man2/listen.2 +++ b/upstream/fedora-rawhide/man2/listen.2 @@ -14,7 +14,7 @@ .\" Modified 11 May 2001 by Sam Varshavchik <mrsam@courier-mta.com> .\" .\" -.TH listen 2 2023-10-31 "Linux man-pages 6.06" +.TH listen 2 2023-10-31 "Linux man-pages 6.7" .SH NAME listen \- listen for connections on a socket .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/listxattr.2 b/upstream/fedora-rawhide/man2/listxattr.2 index 16aea8b4..71a8e536 100644 --- a/upstream/fedora-rawhide/man2/listxattr.2 +++ b/upstream/fedora-rawhide/man2/listxattr.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH listxattr 2 2023-10-31 "Linux man-pages 6.06" +.TH listxattr 2 2023-10-31 "Linux man-pages 6.7" .SH NAME listxattr, llistxattr, flistxattr \- list extended attribute names .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/llseek.2 b/upstream/fedora-rawhide/man2/llseek.2 index 1a97e131..3ac742fb 100644 --- a/upstream/fedora-rawhide/man2/llseek.2 +++ b/upstream/fedora-rawhide/man2/llseek.2 @@ -6,7 +6,7 @@ .\" .\" Modified Thu Oct 31 15:16:23 1996 by Eric S. Raymond <esr@thyrsus.com> .\" -.TH _llseek 2 2023-10-31 "Linux man-pages 6.06" +.TH _llseek 2 2023-10-31 "Linux man-pages 6.7" .SH NAME _llseek \- reposition read/write file offset .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/lookup_dcookie.2 b/upstream/fedora-rawhide/man2/lookup_dcookie.2 index 6bd79f2b..006afe24 100644 --- a/upstream/fedora-rawhide/man2/lookup_dcookie.2 +++ b/upstream/fedora-rawhide/man2/lookup_dcookie.2 @@ -4,7 +4,7 @@ .\" .\" Modified 2004-06-17 Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH lookup_dcookie 2 2023-10-31 "Linux man-pages 6.06" +.TH lookup_dcookie 2 2023-10-31 "Linux man-pages 6.7" .SH NAME lookup_dcookie \- return a directory entry's path .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/lseek.2 b/upstream/fedora-rawhide/man2/lseek.2 index 316f4447..93b3f6da 100644 --- a/upstream/fedora-rawhide/man2/lseek.2 +++ b/upstream/fedora-rawhide/man2/lseek.2 @@ -15,7 +15,7 @@ .\" Modified 2003-08-21 by Andries Brouwer <aeb@cwi.nl> .\" 2011-09-18, mtk, Added SEEK_DATA + SEEK_HOLE .\" -.TH lseek 2 2023-10-31 "Linux man-pages 6.06" +.TH lseek 2 2023-10-31 "Linux man-pages 6.7" .SH NAME lseek \- reposition read/write file offset .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/madvise.2 b/upstream/fedora-rawhide/man2/madvise.2 index 29459851..c30ec4c4 100644 --- a/upstream/fedora-rawhide/man2/madvise.2 +++ b/upstream/fedora-rawhide/man2/madvise.2 @@ -12,7 +12,7 @@ .\" 2011-09-18, Doug Goldstein <cardoe@cardoe.com> .\" Document MADV_HUGEPAGE and MADV_NOHUGEPAGE .\" -.TH madvise 2 2023-10-31 "Linux man-pages 6.06" +.TH madvise 2 2023-10-31 "Linux man-pages 6.7" .SH NAME madvise \- give advice about use of memory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/mbind.2 b/upstream/fedora-rawhide/man2/mbind.2 index 4c84c8e3..4b43aca9 100644 --- a/upstream/fedora-rawhide/man2/mbind.2 +++ b/upstream/fedora-rawhide/man2/mbind.2 @@ -15,7 +15,7 @@ .\" Author: Lee Schermerhorn <lee.schermerhorn@hp.com> .\" Date: Thu Oct 25 14:16:32 2012 +0200 .\" -.TH mbind 2 2023-12-09 "Linux man-pages 6.06" +.TH mbind 2 2023-12-09 "Linux man-pages 6.7" .SH NAME mbind \- set memory policy for a memory range .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/membarrier.2 b/upstream/fedora-rawhide/man2/membarrier.2 index 33fd354a..ce5a9dea 100644 --- a/upstream/fedora-rawhide/man2/membarrier.2 +++ b/upstream/fedora-rawhide/man2/membarrier.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH membarrier 2 2023-10-31 "Linux man-pages 6.06" +.TH membarrier 2 2023-10-31 "Linux man-pages 6.7" .SH NAME membarrier \- issue memory barriers on a set of threads .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/memfd_create.2 b/upstream/fedora-rawhide/man2/memfd_create.2 index 8082b13f..c7cf8594 100644 --- a/upstream/fedora-rawhide/man2/memfd_create.2 +++ b/upstream/fedora-rawhide/man2/memfd_create.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH memfd_create 2 2023-10-31 "Linux man-pages 6.06" +.TH memfd_create 2 2023-10-31 "Linux man-pages 6.7" .SH NAME memfd_create \- create an anonymous file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/memfd_secret.2 b/upstream/fedora-rawhide/man2/memfd_secret.2 index f0f111cd..8b4fb489 100644 --- a/upstream/fedora-rawhide/man2/memfd_secret.2 +++ b/upstream/fedora-rawhide/man2/memfd_secret.2 @@ -7,7 +7,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH memfd_secret 2 2023-10-31 "Linux man-pages 6.06" +.TH memfd_secret 2 2023-10-31 "Linux man-pages 6.7" .SH NAME memfd_secret \- create an anonymous RAM-based file to access secret memory regions diff --git a/upstream/fedora-rawhide/man2/migrate_pages.2 b/upstream/fedora-rawhide/man2/migrate_pages.2 index 44aa04be..8f2ee8ee 100644 --- a/upstream/fedora-rawhide/man2/migrate_pages.2 +++ b/upstream/fedora-rawhide/man2/migrate_pages.2 @@ -6,7 +6,7 @@ .\" This manpage is Copyright (C) 2006 Silicon Graphics, Inc. .\" Christoph Lameter .\" -.TH migrate_pages 2 2023-10-31 "Linux man-pages 6.06" +.TH migrate_pages 2 2023-10-31 "Linux man-pages 6.7" .SH NAME migrate_pages \- move all pages in a process to another set of nodes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/mincore.2 b/upstream/fedora-rawhide/man2/mincore.2 index 169fda21..efba7fc3 100644 --- a/upstream/fedora-rawhide/man2/mincore.2 +++ b/upstream/fedora-rawhide/man2/mincore.2 @@ -11,7 +11,7 @@ .\" after message from <gordon.jin@intel.com> .\" 2007-01-08 mtk, rewrote various parts .\" -.TH mincore 2 2023-10-31 "Linux man-pages 6.06" +.TH mincore 2 2023-10-31 "Linux man-pages 6.7" .SH NAME mincore \- determine whether pages are resident in memory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/mkdir.2 b/upstream/fedora-rawhide/man2/mkdir.2 index 36b2a856..d63059f4 100644 --- a/upstream/fedora-rawhide/man2/mkdir.2 +++ b/upstream/fedora-rawhide/man2/mkdir.2 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH mkdir 2 2023-10-31 "Linux man-pages 6.06" +.TH mkdir 2 2023-10-31 "Linux man-pages 6.7" .SH NAME mkdir, mkdirat \- create a directory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/mknod.2 b/upstream/fedora-rawhide/man2/mknod.2 index 3a78be46..dd7905cf 100644 --- a/upstream/fedora-rawhide/man2/mknod.2 +++ b/upstream/fedora-rawhide/man2/mknod.2 @@ -9,7 +9,7 @@ .\" Modified 2003-04-23 by Michael Kerrisk .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH mknod 2 2023-10-31 "Linux man-pages 6.06" +.TH mknod 2 2023-10-31 "Linux man-pages 6.7" .SH NAME mknod, mknodat \- create a special or ordinary file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/mlock.2 b/upstream/fedora-rawhide/man2/mlock.2 index c9535e56..965e0189 100644 --- a/upstream/fedora-rawhide/man2/mlock.2 +++ b/upstream/fedora-rawhide/man2/mlock.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH mlock 2 2023-10-31 "Linux man-pages 6.06" +.TH mlock 2 2023-10-31 "Linux man-pages 6.7" .SH NAME mlock, mlock2, munlock, mlockall, munlockall \- lock and unlock memory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/mmap.2 b/upstream/fedora-rawhide/man2/mmap.2 index 1e6d881b..300eb2b8 100644 --- a/upstream/fedora-rawhide/man2/mmap.2 +++ b/upstream/fedora-rawhide/man2/mmap.2 @@ -18,7 +18,7 @@ .\" 2007-07-10, mtk, Added an example program. .\" 2008-11-18, mtk, document MAP_STACK .\" -.TH mmap 2 2023-10-31 "Linux man-pages 6.06" +.TH mmap 2 2023-10-31 "Linux man-pages 6.7" .SH NAME mmap, munmap \- map or unmap files or devices into memory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/mmap2.2 b/upstream/fedora-rawhide/man2/mmap2.2 index 35e33af4..e406c20d 100644 --- a/upstream/fedora-rawhide/man2/mmap2.2 +++ b/upstream/fedora-rawhide/man2/mmap2.2 @@ -6,7 +6,7 @@ .\" Added description of mmap2 .\" Modified, 2004-11-25, mtk -- removed stray #endif in prototype .\" -.TH mmap2 2 2023-10-31 "Linux man-pages 6.06" +.TH mmap2 2 2023-10-31 "Linux man-pages 6.7" .SH NAME mmap2 \- map files or devices into memory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/modify_ldt.2 b/upstream/fedora-rawhide/man2/modify_ldt.2 index c9be272f..7ef27220 100644 --- a/upstream/fedora-rawhide/man2/modify_ldt.2 +++ b/upstream/fedora-rawhide/man2/modify_ldt.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH modify_ldt 2 2023-10-31 "Linux man-pages 6.06" +.TH modify_ldt 2 2023-10-31 "Linux man-pages 6.7" .SH NAME modify_ldt \- get or set a per-process LDT entry .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/mount.2 b/upstream/fedora-rawhide/man2/mount.2 index 381e8d7b..f2511c43 100644 --- a/upstream/fedora-rawhide/man2/mount.2 +++ b/upstream/fedora-rawhide/man2/mount.2 @@ -17,7 +17,7 @@ .\" 2008-10-06, mtk: move umount*() material into separate umount.2 page. .\" 2008-10-06, mtk: Add discussion of namespaces. .\" -.TH mount 2 2023-10-31 "Linux man-pages 6.06" +.TH mount 2 2023-10-31 "Linux man-pages 6.7" .SH NAME mount \- mount filesystem .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/mount_setattr.2 b/upstream/fedora-rawhide/man2/mount_setattr.2 index 42aed03d..d59994b3 100644 --- a/upstream/fedora-rawhide/man2/mount_setattr.2 +++ b/upstream/fedora-rawhide/man2/mount_setattr.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mount_setattr 2 2023-10-31 "Linux man-pages 6.06" +.TH mount_setattr 2 2023-10-31 "Linux man-pages 6.7" .SH NAME mount_setattr \- change properties of a mount or mount tree .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/move_pages.2 b/upstream/fedora-rawhide/man2/move_pages.2 index b7374bad..e9627d18 100644 --- a/upstream/fedora-rawhide/man2/move_pages.2 +++ b/upstream/fedora-rawhide/man2/move_pages.2 @@ -8,7 +8,7 @@ .\" (e.g., compare with recommendation in mbind(2)). .\" Does this page need to give advice on this topic? .\" -.TH move_pages 2 2023-10-31 "Linux man-pages 6.06" +.TH move_pages 2 2023-10-31 "Linux man-pages 6.7" .SH NAME move_pages \- move individual pages of a process to another node .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/mprotect.2 b/upstream/fedora-rawhide/man2/mprotect.2 index bdad746d..91812f5e 100644 --- a/upstream/fedora-rawhide/man2/mprotect.2 +++ b/upstream/fedora-rawhide/man2/mprotect.2 @@ -10,7 +10,7 @@ .\" 2007-06-02, mtk: Fairly substantial rewrites and additions, and .\" a much improved example program. .\" -.TH mprotect 2 2023-10-31 "Linux man-pages 6.06" +.TH mprotect 2 2023-10-31 "Linux man-pages 6.7" .SH NAME mprotect, pkey_mprotect \- set protection on a region of memory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/mq_getsetattr.2 b/upstream/fedora-rawhide/man2/mq_getsetattr.2 index c5fa12eb..0fca73b7 100644 --- a/upstream/fedora-rawhide/man2/mq_getsetattr.2 +++ b/upstream/fedora-rawhide/man2/mq_getsetattr.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mq_getsetattr 2 2023-10-31 "Linux man-pages 6.06" +.TH mq_getsetattr 2 2023-10-31 "Linux man-pages 6.7" .SH NAME mq_getsetattr \- get/set message queue attributes .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/mremap.2 b/upstream/fedora-rawhide/man2/mremap.2 index cade8399..aa635dd3 100644 --- a/upstream/fedora-rawhide/man2/mremap.2 +++ b/upstream/fedora-rawhide/man2/mremap.2 @@ -8,7 +8,7 @@ .\" Update for Linux 1.3.87 and later .\" 2005-10-11 mtk: Added NOTES for MREMAP_FIXED; revised EINVAL text. .\" -.TH mremap 2 2024-01-16 "Linux man-pages 6.06" +.TH mremap 2 2024-01-16 "Linux man-pages 6.7" .SH NAME mremap \- remap a virtual memory address .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/msgctl.2 b/upstream/fedora-rawhide/man2/msgctl.2 index beefa480..27aca822 100644 --- a/upstream/fedora-rawhide/man2/msgctl.2 +++ b/upstream/fedora-rawhide/man2/msgctl.2 @@ -16,7 +16,7 @@ .\" 2005-08-02, mtk: Added IPC_INFO, MSG_INFO, MSG_STAT descriptions .\" 2018-03-20, dbueso: Added MSG_STAT_ANY description. .\" -.TH msgctl 2 2023-10-31 "Linux man-pages 6.06" +.TH msgctl 2 2024-03-03 "Linux man-pages 6.7" .SH NAME msgctl \- System V message control operations .SH LIBRARY @@ -26,12 +26,12 @@ Standard C library .nf .B #include <sys/msg.h> .P -.BI "int msgctl(int " msqid ", int " cmd ", struct msqid_ds *" buf ); +.BI "int msgctl(int " msqid ", int " op ", struct msqid_ds *" buf ); .fi .SH DESCRIPTION .BR msgctl () performs the control operation specified by -.I cmd +.I op on the System\ V message queue with identifier .IR msqid . .P @@ -142,7 +142,7 @@ l l. Bits 0100, 0010, and 0001 (the execute bits) are unused by the system. .P Valid values for -.I cmd +.I op are: .TP .B IPC_STAT @@ -320,7 +320,7 @@ is set to indicate the error. .TP .B EACCES The argument -.I cmd +.I op is equal to .B IPC_STAT or @@ -333,7 +333,7 @@ capability in the user namespace that governs its IPC namespace. .TP .B EFAULT The argument -.I cmd +.I op has the value .B IPC_SET or @@ -347,7 +347,7 @@ The message queue was removed. .TP .B EINVAL Invalid value for -.I cmd +.I op or .IR msqid . Or: for a @@ -358,7 +358,7 @@ referred to an array slot that is currently unused. .TP .B EPERM The argument -.I cmd +.I op has the value .B IPC_SET or @@ -402,7 +402,7 @@ a recompilation under glibc-2.1.91 or later should suffice. (The kernel distinguishes old and new calls by an .B IPC_64 flag in -.IR cmd .) +.IR op .) .SH NOTES The .BR IPC_INFO , diff --git a/upstream/fedora-rawhide/man2/msgget.2 b/upstream/fedora-rawhide/man2/msgget.2 index 0ff07144..4a871d8a 100644 --- a/upstream/fedora-rawhide/man2/msgget.2 +++ b/upstream/fedora-rawhide/man2/msgget.2 @@ -12,7 +12,7 @@ .\" Language and formatting clean-ups .\" Added notes on /proc files .\" -.TH msgget 2 2023-10-31 "Linux man-pages 6.06" +.TH msgget 2 2023-10-31 "Linux man-pages 6.7" .SH NAME msgget \- get a System V message queue identifier .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/msgop.2 b/upstream/fedora-rawhide/man2/msgop.2 index b80e7125..e09c6321 100644 --- a/upstream/fedora-rawhide/man2/msgop.2 +++ b/upstream/fedora-rawhide/man2/msgop.2 @@ -17,7 +17,7 @@ .\" Language and formatting clean-ups .\" Added notes on /proc files .\" -.TH MSGOP 2 2023-10-31 "Linux man-pages 6.06" +.TH MSGOP 2 2023-10-31 "Linux man-pages 6.7" .SH NAME msgrcv, msgsnd \- System V message queue operations .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/msync.2 b/upstream/fedora-rawhide/man2/msync.2 index 5f52982d..64dffbd5 100644 --- a/upstream/fedora-rawhide/man2/msync.2 +++ b/upstream/fedora-rawhide/man2/msync.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH msync 2 2023-10-31 "Linux man-pages 6.06" +.TH msync 2 2023-10-31 "Linux man-pages 6.7" .SH NAME msync \- synchronize a file with a memory map .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/nanosleep.2 b/upstream/fedora-rawhide/man2/nanosleep.2 index e174d111..61242ea2 100644 --- a/upstream/fedora-rawhide/man2/nanosleep.2 +++ b/upstream/fedora-rawhide/man2/nanosleep.2 @@ -12,7 +12,7 @@ .\" NOTES: describe case where clock_nanosleep() can be preferable. .\" NOTES: describe CLOCK_REALTIME versus CLOCK_NANOSLEEP .\" Replace crufty discussion of HZ with a pointer to time(7). -.TH nanosleep 2 2023-10-31 "Linux man-pages 6.06" +.TH nanosleep 2 2024-03-03 "Linux man-pages 6.7" .SH NAME nanosleep \- high-resolution sleep .SH LIBRARY @@ -22,7 +22,7 @@ Standard C library .nf .B #include <time.h> .P -.BI "int nanosleep(const struct timespec *" req , +.BI "int nanosleep(const struct timespec *" duration , .BI " struct timespec *_Nullable " rem ); .fi .P @@ -39,7 +39,7 @@ Feature Test Macro Requirements for glibc (see .BR nanosleep () suspends the execution of the calling thread until either at least the time specified in -.I *req +.I *duration has elapsed, or the delivery of a signal that triggers the invocation of a handler in the calling thread or that terminates the process. @@ -80,7 +80,7 @@ does not interact with signals; and it makes the task of resuming a sleep that has been interrupted by a signal handler easier. .SH RETURN VALUE -On successfully sleeping for the requested interval, +On successfully sleeping for the requested duration, .BR nanosleep () returns 0. If the call is interrupted by a signal handler or encounters an error, @@ -138,8 +138,9 @@ have no effect on threads that are blocked waiting for a relative time service based upon this clock, including the .BR nanosleep () function; ... -Consequently, these time services shall expire when the requested relative -interval elapses, independently of the new or old value of the clock. +Consequently, +these time services shall expire when the requested duration elapses, +independently of the new or old value of the clock. .RE .SH STANDARDS POSIX.1-2008. @@ -158,8 +159,8 @@ or This special extension was removed in Linux 2.5.39, and is thus not available in Linux 2.6.0 and later kernels. .SH NOTES -If the interval specified in -.I req +If the +.I duration is not an exact multiple of the granularity underlying clock (see .BR time (7)), then the interval will be rounded up to the next multiple. diff --git a/upstream/fedora-rawhide/man2/nfsservctl.2 b/upstream/fedora-rawhide/man2/nfsservctl.2 index d2ffeffe..c0d49650 100644 --- a/upstream/fedora-rawhide/man2/nfsservctl.2 +++ b/upstream/fedora-rawhide/man2/nfsservctl.2 @@ -2,7 +2,7 @@ .\" This text is in the public domain. .\" %%%LICENSE_END .\" -.TH nfsservctl 2 2023-10-31 "Linux man-pages 6.06" +.TH nfsservctl 2 2023-10-31 "Linux man-pages 6.7" .SH NAME nfsservctl \- syscall interface to kernel nfs daemon .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/nice.2 b/upstream/fedora-rawhide/man2/nice.2 index 0a2b49c2..3e5854b0 100644 --- a/upstream/fedora-rawhide/man2/nice.2 +++ b/upstream/fedora-rawhide/man2/nice.2 @@ -8,7 +8,7 @@ .\" Modified 2001-06-04 by aeb .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH nice 2 2023-10-31 "Linux man-pages 6.06" +.TH nice 2 2023-10-31 "Linux man-pages 6.7" .SH NAME nice \- change process priority .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/open.2 b/upstream/fedora-rawhide/man2/open.2 index f81058e7..a6982faa 100644 --- a/upstream/fedora-rawhide/man2/open.2 +++ b/upstream/fedora-rawhide/man2/open.2 @@ -28,7 +28,7 @@ .\" FIXME . Apr 08: The next POSIX revision has O_EXEC, O_SEARCH, and .\" O_TTYINIT. Eventually these may need to be documented. --mtk .\" -.TH open 2 2024-01-16 "Linux man-pages 6.06" +.TH open 2 2024-01-16 "Linux man-pages 6.7" .SH NAME open, openat, creat \- open and possibly create a file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/open_by_handle_at.2 b/upstream/fedora-rawhide/man2/open_by_handle_at.2 index 591af265..26bb9c20 100644 --- a/upstream/fedora-rawhide/man2/open_by_handle_at.2 +++ b/upstream/fedora-rawhide/man2/open_by_handle_at.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH open_by_handle_at 2 2023-10-31 "Linux man-pages 6.06" +.TH open_by_handle_at 2 2023-10-31 "Linux man-pages 6.7" .SH NAME name_to_handle_at, open_by_handle_at \- obtain handle for a pathname and open file via a handle diff --git a/upstream/fedora-rawhide/man2/openat2.2 b/upstream/fedora-rawhide/man2/openat2.2 index 53db59f7..4a194395 100644 --- a/upstream/fedora-rawhide/man2/openat2.2 +++ b/upstream/fedora-rawhide/man2/openat2.2 @@ -1,7 +1,7 @@ .\" Copyright (C) 2019 Aleksa Sarai <cyphar@cyphar.com> .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH openat2 2 2023-10-31 "Linux man-pages 6.06" +.TH openat2 2 2024-02-25 "Linux man-pages 6.7" .SH NAME openat2 \- open and possibly create a file (extended) .SH LIBRARY @@ -374,7 +374,7 @@ in the kernel's lookup cache. If any kind of revalidation or I/O is needed to satisfy the lookup, .BR openat2 () fails with the error -.B EAGAIN . +.BR EAGAIN . This is useful in providing a fast-path open that can be performed without resorting to thread offload, or other mechanisms that an application might use to offload slower operations. @@ -421,7 +421,7 @@ information. The caller should retry without .B RESOLVE_CACHED set in -.I how.resolve . +.IR how.resolve . .TP .B EINVAL An unknown flag or invalid value was specified in diff --git a/upstream/fedora-rawhide/man2/outb.2 b/upstream/fedora-rawhide/man2/outb.2 index 17da297f..ce39f5a5 100644 --- a/upstream/fedora-rawhide/man2/outb.2 +++ b/upstream/fedora-rawhide/man2/outb.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH outb 2 2023-10-31 "Linux man-pages 6.06" +.TH outb 2 2023-10-31 "Linux man-pages 6.7" .SH NAME outb, outw, outl, outsb, outsw, outsl, inb, inw, inl, insb, insw, insl, diff --git a/upstream/fedora-rawhide/man2/pause.2 b/upstream/fedora-rawhide/man2/pause.2 index 3e2ebf97..59e93453 100644 --- a/upstream/fedora-rawhide/man2/pause.2 +++ b/upstream/fedora-rawhide/man2/pause.2 @@ -7,7 +7,7 @@ .\" Modified 1995 by Mike Battersby (mib@deakin.edu.au) .\" Modified 2000 by aeb, following Michael Kerrisk .\" -.TH pause 2 2023-10-31 "Linux man-pages 6.06" +.TH pause 2 2023-10-31 "Linux man-pages 6.7" .SH NAME pause \- wait for signal .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/perf_event_open.2 b/upstream/fedora-rawhide/man2/perf_event_open.2 index 55d4ff07..7af8e35c 100644 --- a/upstream/fedora-rawhide/man2/perf_event_open.2 +++ b/upstream/fedora-rawhide/man2/perf_event_open.2 @@ -5,7 +5,7 @@ .\" This document is based on the perf_event.h header file, the .\" tools/perf/design.txt file, and a lot of bitter experience. .\" -.TH perf_event_open 2 2023-11-19 "Linux man-pages 6.06" +.TH perf_event_open 2 2023-11-19 "Linux man-pages 6.7" .SH NAME perf_event_open \- set up performance monitoring .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/perfmonctl.2 b/upstream/fedora-rawhide/man2/perfmonctl.2 index 2926674b..fac1aa14 100644 --- a/upstream/fedora-rawhide/man2/perfmonctl.2 +++ b/upstream/fedora-rawhide/man2/perfmonctl.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH perfmonctl 2 2023-10-31 "Linux man-pages 6.06" +.TH perfmonctl 2 2023-10-31 "Linux man-pages 6.7" .SH NAME perfmonctl \- interface to IA-64 performance monitoring unit .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/personality.2 b/upstream/fedora-rawhide/man2/personality.2 index 1f83faf5..ae8db10e 100644 --- a/upstream/fedora-rawhide/man2/personality.2 +++ b/upstream/fedora-rawhide/man2/personality.2 @@ -10,7 +10,7 @@ .\" changed prototype, documented 0xffffffff, aeb, 030101 .\" Modified 2004-11-03 patch from Martin Schulze <joey@infodrom.org> .\" -.TH personality 2 2023-10-31 "Linux man-pages 6.06" +.TH personality 2 2023-10-31 "Linux man-pages 6.7" .SH NAME personality \- set the process execution domain .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/pidfd_getfd.2 b/upstream/fedora-rawhide/man2/pidfd_getfd.2 index f991f8c7..918f1d23 100644 --- a/upstream/fedora-rawhide/man2/pidfd_getfd.2 +++ b/upstream/fedora-rawhide/man2/pidfd_getfd.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pidfd_getfd 2 2023-10-31 "Linux man-pages 6.06" +.TH pidfd_getfd 2 2023-10-31 "Linux man-pages 6.7" .SH NAME pidfd_getfd \- obtain a duplicate of another process's file descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/pidfd_open.2 b/upstream/fedora-rawhide/man2/pidfd_open.2 index 36350291..32e92c03 100644 --- a/upstream/fedora-rawhide/man2/pidfd_open.2 +++ b/upstream/fedora-rawhide/man2/pidfd_open.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pidfd_open 2 2023-10-31 "Linux man-pages 6.06" +.TH pidfd_open 2 2023-10-31 "Linux man-pages 6.7" .SH NAME pidfd_open \- obtain a file descriptor that refers to a process .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/pidfd_send_signal.2 b/upstream/fedora-rawhide/man2/pidfd_send_signal.2 index b0cea18f..ae884b87 100644 --- a/upstream/fedora-rawhide/man2/pidfd_send_signal.2 +++ b/upstream/fedora-rawhide/man2/pidfd_send_signal.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pidfd_send_signal 2 2023-11-01 "Linux man-pages 6.06" +.TH pidfd_send_signal 2 2023-11-01 "Linux man-pages 6.7" .SH NAME pidfd_send_signal \- send a signal to a process specified by a file descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/pipe.2 b/upstream/fedora-rawhide/man2/pipe.2 index 556f2582..55e631d3 100644 --- a/upstream/fedora-rawhide/man2/pipe.2 +++ b/upstream/fedora-rawhide/man2/pipe.2 @@ -13,7 +13,7 @@ .\" to EXAMPLE text. .\" 2008-10-10, mtk: add description of pipe2() .\" -.TH pipe 2 2023-10-31 "Linux man-pages 6.06" +.TH pipe 2 2023-10-31 "Linux man-pages 6.7" .SH NAME pipe, pipe2 \- create pipe .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/pivot_root.2 b/upstream/fedora-rawhide/man2/pivot_root.2 index 0c901fd6..3e0e55e9 100644 --- a/upstream/fedora-rawhide/man2/pivot_root.2 +++ b/upstream/fedora-rawhide/man2/pivot_root.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pivot_root 2 2023-10-31 "Linux man-pages 6.06" +.TH pivot_root 2 2024-02-25 "Linux man-pages 6.7" .SH NAME pivot_root \- change the root mount .SH LIBRARY @@ -66,7 +66,7 @@ must yield the same directory as \fInew_root\fP. .IP \[bu] .I new_root must be a path to a mount point, but can't be -.IR """/""" . +.IR \[dq]/\[dq] . A path that is not already a mount point can be converted into one by bind mounting the path onto itself. .IP \[bu] @@ -115,7 +115,7 @@ is on the current root mount. (This error covers the pathological case where .I new_root is -.IR """/""" .) +.IR \[dq]/\[dq] .) .TP .B EINVAL .I new_root @@ -227,7 +227,7 @@ working directory refer to the new root mount point During the subsequent .BR umount () call, resolution of -.I """.""" +.I \[dq].\[dq] starts with .I new_root and then moves up the list of mounts stacked at diff --git a/upstream/fedora-rawhide/man2/pkey_alloc.2 b/upstream/fedora-rawhide/man2/pkey_alloc.2 index a5494ccd..5d72fb9a 100644 --- a/upstream/fedora-rawhide/man2/pkey_alloc.2 +++ b/upstream/fedora-rawhide/man2/pkey_alloc.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pkey_alloc 2 2023-10-31 "Linux man-pages 6.06" +.TH pkey_alloc 2 2023-10-31 "Linux man-pages 6.7" .SH NAME pkey_alloc, pkey_free \- allocate or free a protection key .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/poll.2 b/upstream/fedora-rawhide/man2/poll.2 index 0abd6f20..36e89f8e 100644 --- a/upstream/fedora-rawhide/man2/poll.2 +++ b/upstream/fedora-rawhide/man2/poll.2 @@ -7,7 +7,7 @@ .\" 2006-07-01, mtk, Added POLLRDHUP + various other wording and .\" formatting changes. .\" -.TH poll 2 2023-10-31 "Linux man-pages 6.06" +.TH poll 2 2023-10-31 "Linux man-pages 6.7" .SH NAME poll, ppoll \- wait for some event on a file descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/posix_fadvise.2 b/upstream/fedora-rawhide/man2/posix_fadvise.2 index 0e499ad7..96c06a70 100644 --- a/upstream/fedora-rawhide/man2/posix_fadvise.2 +++ b/upstream/fedora-rawhide/man2/posix_fadvise.2 @@ -6,7 +6,7 @@ .\" 2005-04-08 mtk, noted kernel version and added BUGS .\" 2010-10-09, mtk, document arm_fadvise64_64() .\" -.TH posix_fadvise 2 2023-10-31 "Linux man-pages 6.06" +.TH posix_fadvise 2 2023-10-31 "Linux man-pages 6.7" .SH NAME posix_fadvise \- predeclare an access pattern for file data .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/prctl.2 b/upstream/fedora-rawhide/man2/prctl.2 index 8de8bbba..c6dae6df 100644 --- a/upstream/fedora-rawhide/man2/prctl.2 +++ b/upstream/fedora-rawhide/man2/prctl.2 @@ -36,7 +36,7 @@ .\" 2014-11-10 Dave Hansen, document PR_MPX_{EN,DIS}ABLE_MANAGEMENT .\" .\" -.TH prctl 2 2023-10-31 "Linux man-pages 6.06" +.TH prctl 2 2024-03-03 "Linux man-pages 6.7" .SH NAME prctl \- operations on a process or thread .SH LIBRARY @@ -46,7 +46,7 @@ Standard C library .nf .B #include <sys/prctl.h> .P -.BI "int prctl(int " operation ", ..." +.BI "int prctl(int " op ", ..." .BI " \fR/*\fP unsigned long " arg2 ", unsigned long " arg3 , .BI " unsigned long " arg4 ", unsigned long " arg5 " \fR*/\fP );" .fi @@ -379,7 +379,7 @@ can operate only when this bit is Applications that use the O32 FPXX ABI can operate with either .B FR=0 or -.B FR=1 . +.BR FR=1 . .TP .B PR_FP_MODE_FRE Enable emulation of 32-bit floating-point mode. @@ -2096,7 +2096,7 @@ and (if it returns) .B PR_GET_SECCOMP return the nonnegative values described above. All other -.I operation +.I op values return 0 on success. On error, \-1 is returned, and .I errno @@ -2104,7 +2104,7 @@ is set to indicate the error. .SH ERRORS .TP .B EACCES -.I operation +.I op is .B PR_SET_SECCOMP and @@ -2120,7 +2120,7 @@ attribute (see the discussion of above). .TP .B EACCES -.I operation +.I op is .BR PR_SET_MM , and @@ -2130,7 +2130,7 @@ is the file is not executable. .TP .B EBADF -.I operation +.I op is .BR PR_SET_MM , .I arg3 @@ -2141,7 +2141,7 @@ and the file descriptor passed in is not valid. .TP .B EBUSY -.I operation +.I op is .BR PR_SET_MM , .I arg3 @@ -2156,7 +2156,7 @@ symbolic link, which is prohibited. is an invalid address. .TP .B EFAULT -.I operation +.I op is .BR PR_SET_SECCOMP , .I arg2 @@ -2169,7 +2169,7 @@ and is an invalid address. .TP .B EFAULT -.I operation +.I op is .B PR_SET_SYSCALL_USER_DISPATCH and @@ -2178,12 +2178,12 @@ has an invalid address. .TP .B EINVAL The value of -.I operation +.I op is not recognized, or not supported on this system. .TP .B EINVAL -.I operation +.I op is .B PR_MCE_KILL or @@ -2197,10 +2197,10 @@ arguments were not specified as zero. .B EINVAL .I arg2 is not valid value for this -.IR operation . +.IR op . .TP .B EINVAL -.I operation +.I op is .B PR_SET_SECCOMP or @@ -2209,7 +2209,7 @@ and the kernel was not configured with .BR CONFIG_SECCOMP . .TP .B EINVAL -.I operation +.I op is .BR PR_SET_SECCOMP , .I arg2 @@ -2219,7 +2219,7 @@ and the kernel was not configured with .BR CONFIG_SECCOMP_FILTER . .TP .B EINVAL -.I operation +.I op is .BR PR_SET_MM , and one of the following is true @@ -2259,7 +2259,7 @@ resource limit to be exceeded. .RE .TP .B EINVAL -.I operation +.I op is .B PR_SET_PTRACER and @@ -2269,7 +2269,7 @@ is not 0, or the PID of an existing process. .TP .B EINVAL -.I operation +.I op is .B PR_SET_PDEATHSIG and @@ -2277,7 +2277,7 @@ and is not a valid signal number. .TP .B EINVAL -.I operation +.I op is .B PR_SET_DUMPABLE and @@ -2288,7 +2288,7 @@ nor .BR SUID_DUMP_USER . .TP .B EINVAL -.I operation +.I op is .B PR_SET_TIMING and @@ -2297,7 +2297,7 @@ is not .BR PR_TIMING_STATISTICAL . .TP .B EINVAL -.I operation +.I op is .B PR_SET_NO_NEW_PRIVS and @@ -2311,7 +2311,7 @@ or is nonzero. .TP .B EINVAL -.I operation +.I op is .B PR_GET_NO_NEW_PRIVS and @@ -2323,7 +2323,7 @@ or is nonzero. .TP .B EINVAL -.I operation +.I op is .B PR_SET_THP_DISABLE and @@ -2334,7 +2334,7 @@ or is nonzero. .TP .B EINVAL -.I operation +.I op is .B PR_GET_THP_DISABLE and @@ -2346,7 +2346,7 @@ or is nonzero. .TP .B EINVAL -.I operation +.I op is .B PR_CAP_AMBIENT and an unused argument @@ -2371,7 +2371,7 @@ and does not specify a valid capability. .TP .B EINVAL -.I operation +.I op was .B PR_GET_SPECULATION_CTRL or @@ -2381,7 +2381,7 @@ and unused arguments to are not 0. .TP .B EINVAL -.I operation +.I op is .B PR_PAC_RESET_KEYS and the arguments are invalid or unsupported. @@ -2390,7 +2390,7 @@ See the description of above for details. .TP .B EINVAL -.I operation +.I op is .B PR_SVE_SET_VL and the arguments are invalid or unsupported, @@ -2400,13 +2400,13 @@ See the description of above for details. .TP .B EINVAL -.I operation +.I op is .B PR_SVE_GET_VL and SVE is not available on this platform. .TP .B EINVAL -.I operation +.I op is .B PR_SET_SYSCALL_USER_DISPATCH and one of the following is true: @@ -2428,7 +2428,7 @@ is invalid. .RE .TP .B EINVAL -.I operation +.I op is .B PR_SET_TAGGED_ADDR_CTRL and the arguments are invalid or unsupported. @@ -2437,7 +2437,7 @@ See the description of above for details. .TP .B EINVAL -.I operation +.I op is .B PR_GET_TAGGED_ADDR_CTRL and the arguments are invalid or unsupported. @@ -2446,13 +2446,13 @@ See the description of above for details. .TP .B ENODEV -.I operation +.I op was .B PR_SET_SPECULATION_CTRL the kernel or CPU does not support the requested speculation misfeature. .TP .B ENXIO -.I operation +.I op was .B PR_MPX_ENABLE_MANAGEMENT or @@ -2461,7 +2461,7 @@ and the kernel or the CPU does not support MPX management. Check that the kernel and processor have MPX support. .TP .B ENXIO -.I operation +.I op was .B PR_SET_SPECULATION_CTRL implies that the control of the selected speculation misfeature is not possible. @@ -2470,7 +2470,7 @@ See for the bit fields to determine which option is available. .TP .B EOPNOTSUPP -.I operation +.I op is .B PR_SET_FP_MODE and @@ -2478,7 +2478,7 @@ and has an invalid or unsupported value. .TP .B EPERM -.I operation +.I op is .BR PR_SET_SECUREBITS , and the caller does not have the @@ -2490,7 +2490,7 @@ or tried to set a flag whose corresponding locked flag was set .BR capabilities (7)). .TP .B EPERM -.I operation +.I op is .B PR_SET_SPECULATION_CTRL wherein the speculation was disabled with @@ -2498,7 +2498,7 @@ wherein the speculation was disabled with and caller tried to enable it again. .TP .B EPERM -.I operation +.I op is .BR PR_SET_KEEPCAPS , and the caller's @@ -2508,7 +2508,7 @@ flag is set .BR capabilities (7)). .TP .B EPERM -.I operation +.I op is .BR PR_CAPBSET_DROP , and the caller does not have the @@ -2516,7 +2516,7 @@ and the caller does not have the capability. .TP .B EPERM -.I operation +.I op is .BR PR_SET_MM , and the caller does not have the @@ -2524,7 +2524,7 @@ and the caller does not have the capability. .TP .B EPERM -.I operation +.I op is .B PR_CAP_AMBIENT and @@ -2539,7 +2539,7 @@ or the securebit has been set. .TP .B ERANGE -.I operation +.I op was .B PR_SET_SPECULATION_CTRL and @@ -2559,7 +2559,7 @@ with prototype .P .in +4n .EX -.BI "ptrdiff_t prctl(int " operation ", int " arg2 ", int " arg3 ); +.BI "ptrdiff_t prctl(int " op ", int " arg2 ", int " arg3 ); .EE .in .P diff --git a/upstream/fedora-rawhide/man2/pread.2 b/upstream/fedora-rawhide/man2/pread.2 index 3bfecf1e..4ff94c08 100644 --- a/upstream/fedora-rawhide/man2/pread.2 +++ b/upstream/fedora-rawhide/man2/pread.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pread 2 2023-10-31 "Linux man-pages 6.06" +.TH pread 2 2023-10-31 "Linux man-pages 6.7" .SH NAME pread, pwrite \- read from or write to a file descriptor at a given offset .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/process_madvise.2 b/upstream/fedora-rawhide/man2/process_madvise.2 index e6f78bf6..37ec5fd8 100644 --- a/upstream/fedora-rawhide/man2/process_madvise.2 +++ b/upstream/fedora-rawhide/man2/process_madvise.2 @@ -5,7 +5,7 @@ .\" .\" Commit ecb8ac8b1f146915aa6b96449b66dd48984caacc .\" -.TH process_madvise 2 2023-10-31 "Linux man-pages 6.06" +.TH process_madvise 2 2024-02-28 "Linux man-pages 6.7" .SH NAME process_madvise \- give advice about use of memory to a process .SH LIBRARY @@ -13,23 +13,12 @@ Standard C library .RI ( libc ", " \-lc ) .SH SYNOPSIS .nf -.BR "#include <sys/mman.h>" " /* Definition of " MADV_* " constants */" -.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */" -.BR "#include <sys/uio.h>" " /* Definition of " "struct iovec" " type */" -.B #include <unistd.h> +.B #include <sys/mman.h> .P -.BI "ssize_t syscall(SYS_process_madvise, int " pidfd , -.BI " const struct iovec *" iovec ", size_t " vlen \ -", int " advice , -.BI " unsigned int " flags ");" +.BI "ssize_t process_madvise(int " pidfd ", const struct iovec " iovec [. n ], +.BI " size_t " n ", int " advice \ +", unsigned int " flags ); .fi -.P -.IR Note : -glibc provides no wrapper for -.BR process_madvise (), -necessitating the use of -.BR syscall (2). -.\" FIXME: See <https://sourceware.org/bugzilla/show_bug.cgi?id=27380> .SH DESCRIPTION The .BR process_madvise () @@ -38,7 +27,7 @@ address ranges of another process or of the calling process. It provides the advice for the address ranges described by .I iovec and -.IR vlen . +.IR n . The goal of such advice is to improve system or application performance. .P The @@ -54,7 +43,7 @@ points to an array of structures, described in .BR iovec (3type). .P -.I vlen +.I n specifies the number of elements in the array of .I iovec structures. @@ -91,12 +80,12 @@ argument is reserved for future use; currently, this argument must be specified as 0. .P The -.I vlen +.I n and .I iovec arguments are checked before applying any advice. If -.I vlen +.I n is too big, or .I iovec is invalid, @@ -163,7 +152,7 @@ overflows a value. .TP .B EINVAL -.I vlen +.I n is too large. .TP .B ENOMEM @@ -187,7 +176,9 @@ errors. Linux. .SH HISTORY Linux 5.10. -.\" commit ecb8ac8b1f146915aa6b96449b66dd48984caacc +.\" Linux commit ecb8ac8b1f146915aa6b96449b66dd48984caacc +glibc 2.36. +.\" glibc commit d19ee3473d68ca0e794f3a8b7677a0983ae1342e .P Support for this system call is optional, depending on the setting of the diff --git a/upstream/fedora-rawhide/man2/process_vm_readv.2 b/upstream/fedora-rawhide/man2/process_vm_readv.2 index 810eed24..23c91117 100644 --- a/upstream/fedora-rawhide/man2/process_vm_readv.2 +++ b/upstream/fedora-rawhide/man2/process_vm_readv.2 @@ -6,7 +6,7 @@ .\" .\" Commit fcf634098c00dd9cd247447368495f0b79be12d1 .\" -.TH process_vm_readv 2 2023-10-31 "Linux man-pages 6.06" +.TH process_vm_readv 2 2023-10-31 "Linux man-pages 6.7" .SH NAME process_vm_readv, process_vm_writev \- transfer data between process address spaces diff --git a/upstream/fedora-rawhide/man2/ptrace.2 b/upstream/fedora-rawhide/man2/ptrace.2 index 565f0cc5..1cd9966d 100644 --- a/upstream/fedora-rawhide/man2/ptrace.2 +++ b/upstream/fedora-rawhide/man2/ptrace.2 @@ -83,7 +83,7 @@ .\" .\" and others that can be found in the arch/*/include/uapi/asm/ptrace files .\" -.TH ptrace 2 2023-10-31 "Linux man-pages 6.06" +.TH ptrace 2 2024-03-03 "Linux man-pages 6.7" .SH NAME ptrace \- process trace .SH LIBRARY @@ -93,7 +93,7 @@ Standard C library .nf .B #include <sys/ptrace.h> .P -.BI "long ptrace(enum __ptrace_request " request ", pid_t " pid , +.BI "long ptrace(enum __ptrace_request " op ", pid_t " pid , .BI " void *" addr ", void *" data ); .fi .SH DESCRIPTION @@ -155,7 +155,7 @@ The tracer will be notified at its next call to value containing information that indicates the cause of the stop in the tracee. While the tracee is stopped, -the tracer can use various ptrace requests to inspect and modify the tracee. +the tracer can use various ptrace operations to inspect and modify the tracee. The tracer then causes the tracee to continue, optionally ignoring the delivered signal (or even delivering a different signal instead). @@ -175,12 +175,12 @@ executing in a normal, untraced mode via .BR PTRACE_DETACH . .P The value of -.I request -determines the action to be performed: +.I op +determines the operation to be performed: .TP .B PTRACE_TRACEME Indicate that this process is to be traced by its parent. -A process probably shouldn't make this request if its parent +A process probably shouldn't make this operation if its parent isn't expecting to trace it. .RI ( pid , .IR addr , @@ -190,12 +190,12 @@ are ignored.) .IP The .B PTRACE_TRACEME -request is used only by the tracee; -the remaining requests are used only by the tracer. -In the following requests, +operation is used only by the tracee; +the remaining operations are used only by the tracer. +In the following operations, .I pid specifies the thread ID of the tracee to be acted on. -For requests other than +For operations other than .BR PTRACE_ATTACH , .BR PTRACE_SEIZE , .BR PTRACE_INTERRUPT , @@ -212,7 +212,7 @@ in the tracee's memory, returning the word as the result of the .BR ptrace () call. Linux does not have separate text and data address spaces, -so these two requests are currently equivalent. +so these two operations are currently equivalent. .RI ( data is ignored; but see NOTES.) .TP @@ -246,7 +246,7 @@ As for .B PTRACE_PEEKTEXT and .BR PTRACE_PEEKDATA , -these two requests are currently equivalent. +these two operations are currently equivalent. .TP .B PTRACE_POKEUSER .\" PTRACE_POKEUSR in kernel source, but glibc uses PTRACE_POKEUSER, @@ -740,7 +740,7 @@ argument. The .I addr argument is ignored. -This request is currently +This operation is currently .\" As of 4.19-rc2 supported only on arm (and arm64, though only for backwards compatibility), .\" commit 27aa55c5e5123fa8b8ad0156559d34d7edff58ca @@ -770,7 +770,7 @@ argument is treated as for The .I addr argument is ignored. -These requests are currently +These operations are currently .\" As at 3.7 supported only on x86. .TP @@ -1211,7 +1211,7 @@ ptrace operation returned .I waitpid(WNOHANG) may return 0 instead. In other words, the tracee may be "not yet fully dead", -but already refusing ptrace requests. +but already refusing ptrace operations. .P The tracer can't assume that the tracee .I always @@ -1355,7 +1355,7 @@ If the selected thread is traced, it enters signal-delivery-stop. At this point, the signal is not yet delivered to the process, and can be suppressed by the tracer. If the tracer doesn't suppress the signal, -it passes the signal to the tracee in the next ptrace restart request. +it passes the signal to the tracee in the next ptrace restart operation. This second step of signal delivery is called .I "signal injection" in this manual page. @@ -1390,7 +1390,7 @@ ptrace(PTRACE_restart, pid, 0, sig) .P where .B PTRACE_restart -is one of the restarting ptrace requests. +is one of the restarting ptrace operations. If .I sig is 0, then a signal is not delivered. @@ -1434,7 +1434,7 @@ Ptrace users should not try to "create a new signal" this way: use .BR tgkill (2) instead. .P -The fact that signal injection requests may be ignored +The fact that signal injection operations may be ignored when restarting the tracee after ptrace stops that are not signal-delivery-stops is a cause of confusion among ptrace users. @@ -1798,7 +1798,7 @@ for example, a system call etc.), expiration of a POSIX timer, change of state on a POSIX message queue, -or completion of an asynchronous I/O request. +or completion of an asynchronous I/O operation. .TP .IR si_code " == SI_KERNEL (0x80)" .B SIGTRAP @@ -2097,7 +2097,7 @@ use .B PTRACE_INTERRUPT command. .P -The request +The operation .P .in +4n .EX @@ -2385,21 +2385,21 @@ the report is sent only once. .SH RETURN VALUE On success, the .B PTRACE_PEEK* -requests return the requested data (but see NOTES), +operations return the requested data (but see NOTES), the .B PTRACE_SECCOMP_GET_FILTER -request returns the number of instructions in the BPF program, +operation returns the number of instructions in the BPF program, the .B PTRACE_GET_SYSCALL_INFO -request returns the number of bytes available to be written by the kernel, -and other requests return zero. +operation returns the number of bytes available to be written by the kernel, +and other operations return zero. .P -On error, all requests return \-1, and +On error, all operations return \-1, and .I errno is set to indicate the error. Since the value returned by a successful .B PTRACE_PEEK* -request may be \-1, the caller must clear +operation may be \-1, the caller must clear .I errno before the call, and then check it afterward to determine whether or not an error occurred. @@ -2423,11 +2423,11 @@ more or less arbitrarily. An attempt was made to set an invalid option. .TP .B EIO -.I request +.I op is invalid, or an attempt was made to read from or write to an invalid area in the tracer's or the tracee's memory, or there was a word-alignment violation, -or an invalid signal was specified during a restart request. +or an invalid signal was specified during a restart operation. .TP .B EPERM The specified process cannot be traced. @@ -2445,7 +2445,7 @@ or (before Linux 2.6.26) be .B ESRCH The specified process does not exist, or is not currently being traced by the caller, or is not stopped -(for requests that require a stopped tracee). +(for operations that require a stopped tracee). .SH STANDARDS None. .SH HISTORY @@ -2462,7 +2462,7 @@ are interpreted according to the prototype given, glibc currently declares .BR ptrace () as a variadic function with only the -.I request +.I op argument fixed. It is recommended to always supply four arguments, even if the requested operation does not use them, @@ -2829,7 +2829,7 @@ At the system call level, the .BR PTRACE_PEEKDATA , and .B PTRACE_PEEKUSER -requests have a different API: they store the result +operations have a different API: they store the result at the address specified by the .I data parameter, and the return value is the error flag. diff --git a/upstream/fedora-rawhide/man2/query_module.2 b/upstream/fedora-rawhide/man2/query_module.2 index c74803b1..f2b163af 100644 --- a/upstream/fedora-rawhide/man2/query_module.2 +++ b/upstream/fedora-rawhide/man2/query_module.2 @@ -5,7 +5,7 @@ .\" 2006-02-09, some reformatting by Luc Van Oostenryck; some .\" reformatting and rewordings by mtk .\" -.TH query_module 2 2023-10-31 "Linux man-pages 6.06" +.TH query_module 2 2023-10-31 "Linux man-pages 6.7" .SH NAME query_module \- query the kernel for various bits pertaining to modules .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/quotactl.2 b/upstream/fedora-rawhide/man2/quotactl.2 index dc7f588d..3cfaaf57 100644 --- a/upstream/fedora-rawhide/man2/quotactl.2 +++ b/upstream/fedora-rawhide/man2/quotactl.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH quotactl 2 2023-10-31 "Linux man-pages 6.06" +.TH quotactl 2 2024-03-03 "Linux man-pages 6.7" .SH NAME quotactl \- manipulate disk quotas .SH LIBRARY @@ -17,7 +17,7 @@ Standard C library " constants" .RB " (or " <linux/dqblk_xfs.h> "; see NOTES) */" .P -.BI "int quotactl(int " cmd ", const char *_Nullable " special ", int " id , +.BI "int quotactl(int " op ", const char *_Nullable " special ", int " id , .BI " caddr_t " addr ); .fi .SH DESCRIPTION @@ -35,14 +35,14 @@ The .BR quotactl () call manipulates disk quotas. The -.I cmd -argument indicates a command to be applied to the user or +.I op +argument indicates an operation to be applied to the user or group ID specified in .IR id . To initialize the -.I cmd +.I op argument, use the -.I QCMD(subcmd, type) +.I QCMD(subop, type) macro. The .I type @@ -55,7 +55,7 @@ for group quotas, or (since Linux 4.1) .BR PRJQUOTA , for project quotas. The -.I subcmd +.I subop value is described below. .P The @@ -65,14 +65,14 @@ of the (mounted) block special device for the filesystem being manipulated. .P The .I addr -argument is the address of an optional, command-specific, data structure +argument is the address of an optional, operation-specific, data structure that is copied in or out of the system. The interpretation of .I addr is given with each operation below. .P The -.I subcmd +.I subop value is one of the following operations: .TP .B Q_QUOTAON @@ -649,7 +649,7 @@ structure) which identify what types of quota should be removed. (Note that the quota type passed in the -.I cmd +.I op argument is ignored, but should remain valid in order to pass preliminary quotactl syscall handler checks.) .IP @@ -681,7 +681,7 @@ is set to indicate the error. .SH ERRORS .TP .B EACCES -.I cmd +.I op is .BR Q_QUOTAON , and the quota file pointed to by @@ -691,7 +691,7 @@ is not on the filesystem pointed to by .IR special . .TP .B EBUSY -.I cmd +.I op is .BR Q_QUOTAON , but another @@ -705,20 +705,20 @@ or is invalid. .TP .B EINVAL -.I cmd +.I op or .I type is invalid. .TP .B EINVAL -.I cmd +.I op is .BR Q_QUOTAON , but the specified quota file is corrupted. .TP .BR EINVAL " (since Linux 5.5)" .\" 3dd4d40b420846dd35869ccc8f8627feef2cff32 -.I cmd +.I op is .BR Q_XQUOTARM , but @@ -747,7 +747,7 @@ The caller lacked the required privilege for the specified operation. .TP .B ERANGE -.I cmd +.I op is .BR Q_SETQUOTA , but the specified limits are out of the range allowed by the quota format. @@ -757,13 +757,13 @@ No disk quota is found for the indicated user. Quotas have not been turned on for this filesystem. .TP .B ESRCH -.I cmd +.I op is .BR Q_QUOTAON , but the specified quota format was not found. .TP .B ESRCH -.I cmd +.I op is .B Q_GETNEXTQUOTA or diff --git a/upstream/fedora-rawhide/man2/read.2 b/upstream/fedora-rawhide/man2/read.2 index d70fa14a..973993ee 100644 --- a/upstream/fedora-rawhide/man2/read.2 +++ b/upstream/fedora-rawhide/man2/read.2 @@ -13,7 +13,7 @@ .\" Modified Sat Jul 12 20:45:39 1997 by Michael Haardt .\" <michael@cantor.informatik.rwth-aachen.de> .\" -.TH read 2 2023-10-31 "Linux man-pages 6.06" +.TH read 2 2024-03-12 "Linux man-pages 6.7" .SH NAME read \- read from a file descriptor .SH LIBRARY @@ -216,7 +216,7 @@ perform a (or .BR readv (2)) at the same time, then the I/O operations were not atomic -with respect updating the file offset, +with respect to updating the file offset, with the result that the reads in the two processes might (incorrectly) overlap in the blocks of data that they obtained. This problem was fixed in Linux 3.14. diff --git a/upstream/fedora-rawhide/man2/readahead.2 b/upstream/fedora-rawhide/man2/readahead.2 index c8bf1e2c..701efde2 100644 --- a/upstream/fedora-rawhide/man2/readahead.2 +++ b/upstream/fedora-rawhide/man2/readahead.2 @@ -5,7 +5,7 @@ .\" 2004-05-40 Created by Michael Kerrisk <mtk.manpages@gmail.com> .\" 2004-10-05 aeb, minor correction .\" -.TH readahead 2 2023-10-31 "Linux man-pages 6.06" +.TH readahead 2 2023-10-31 "Linux man-pages 6.7" .SH NAME readahead \- initiate file readahead into page cache .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/readdir.2 b/upstream/fedora-rawhide/man2/readdir.2 index 21abb81f..dbb91e1b 100644 --- a/upstream/fedora-rawhide/man2/readdir.2 +++ b/upstream/fedora-rawhide/man2/readdir.2 @@ -7,7 +7,7 @@ .\" In 1.3.X, returns only one entry each time; return value is different. .\" Modified 2004-12-01, mtk, fixed headers listed in SYNOPSIS .\" -.TH readdir 2 2023-10-31 "Linux man-pages 6.06" +.TH readdir 2 2023-10-31 "Linux man-pages 6.7" .SH NAME readdir \- read directory entry .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/readlink.2 b/upstream/fedora-rawhide/man2/readlink.2 index e7b9998c..c476091e 100644 --- a/upstream/fedora-rawhide/man2/readlink.2 +++ b/upstream/fedora-rawhide/man2/readlink.2 @@ -13,7 +13,7 @@ .\" 2011-09-20, Guillem Jover <guillem@hadrons.org>: .\" Added text on dynamically allocating buffer + example program .\" -.TH readlink 2 2023-11-01 "Linux man-pages 6.06" +.TH readlink 2 2023-11-01 "Linux man-pages 6.7" .SH NAME readlink, readlinkat \- read value of a symbolic link .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/readv.2 b/upstream/fedora-rawhide/man2/readv.2 index 27ca77fb..c1295cde 100644 --- a/upstream/fedora-rawhide/man2/readv.2 +++ b/upstream/fedora-rawhide/man2/readv.2 @@ -9,7 +9,7 @@ .\" add more details. .\" 2010-11-16, mtk, Added documentation of preadv() and pwritev() .\" -.TH readv 2 2023-10-31 "Linux man-pages 6.06" +.TH readv 2 2023-10-31 "Linux man-pages 6.7" .SH NAME readv, writev, preadv, pwritev, preadv2, pwritev2 \- read or write data into multiple buffers diff --git a/upstream/fedora-rawhide/man2/reboot.2 b/upstream/fedora-rawhide/man2/reboot.2 index 8c5751af..7ca639c5 100644 --- a/upstream/fedora-rawhide/man2/reboot.2 +++ b/upstream/fedora-rawhide/man2/reboot.2 @@ -5,7 +5,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH reboot 2 2023-10-31 "Linux man-pages 6.06" +.TH reboot 2 2024-03-03 "Linux man-pages 6.7" .SH NAME reboot \- reboot or enable/disable Ctrl-Alt-Del .SH LIBRARY @@ -21,7 +21,7 @@ Standard C library .BR "#include <sys/syscall.h> " "/* Definition of " SYS_* " constants */" .B #include <unistd.h> .P -.BI "int syscall(SYS_reboot, int " magic ", int " magic2 ", int " cmd ", void *" arg ); +.BI "int syscall(SYS_reboot, int " magic ", int " magic2 ", int " op ", void *" arg ); .P /* Under glibc and most alternative libc's (including uclibc, dietlibc, musl and a few others), some of the constants involved have gotten @@ -31,7 +31,7 @@ Standard C library .BR "#include <sys/reboot.h> " "/* Definition of " RB_* " constants */" .B #include <unistd.h> .P -.BI "int reboot(int " cmd ); +.BI "int reboot(int " op ); .fi .SH DESCRIPTION The @@ -66,7 +66,7 @@ are permitted as values for (The hexadecimal values of these constants are meaningful.) .P The -.I cmd +.I op argument can have the following values: .TP .B LINUX_REBOOT_CMD_CAD_OFF @@ -157,7 +157,7 @@ if is called from a PID namespace other than the initial PID namespace with one of the -.I cmd +.I op values listed below, it performs a "reboot" of that namespace: the "init" process of the PID namespace is immediately terminated, @@ -165,7 +165,7 @@ with the effects described in .BR pid_namespaces (7). .P The values that can be supplied in -.I cmd +.I op when calling .BR reboot () in this case are as follows: @@ -191,7 +191,7 @@ in the parent process reports that the child was killed with a signal. .P For the other -.I cmd +.I op values, .BR reboot () returns \-1 and @@ -200,13 +200,13 @@ is set to .BR EINVAL . .SH RETURN VALUE For the values of -.I cmd +.I op that stop or restart the system, a successful call to .BR reboot () does not return. For the other -.I cmd +.I op values, zero is returned on success. In all cases, \-1 is returned on failure, and .I errno @@ -218,7 +218,8 @@ Problem with getting user-space data under .BR LINUX_REBOOT_CMD_RESTART2 . .TP .B EINVAL -Bad magic numbers or \fIcmd\fP. +Bad magic numbers or +.IR op . .TP .B EPERM The calling process has insufficient privilege to call diff --git a/upstream/fedora-rawhide/man2/recv.2 b/upstream/fedora-rawhide/man2/recv.2 index 06658e12..916cca3b 100644 --- a/upstream/fedora-rawhide/man2/recv.2 +++ b/upstream/fedora-rawhide/man2/recv.2 @@ -10,7 +10,7 @@ .\" Modified 1998,1999 by Andi Kleen .\" 2001-06-19 corrected SO_EE_OFFENDER, bug report by James Hawtin .\" -.TH recv 2 2023-10-31 "Linux man-pages 6.06" +.TH recv 2 2024-02-18 "Linux man-pages 6.7" .SH NAME recv, recvfrom, recvmsg \- receive a message from a socket .SH LIBRARY @@ -123,7 +123,7 @@ is a per-call option, whereas is a setting on the open file description (see .BR open (2)), which will affect all threads in the calling process -and as well as other processes that hold file descriptors +as well as other processes that hold file descriptors referring to the same open file description. .TP .BR MSG_ERRQUEUE " (since Linux 2.2)" diff --git a/upstream/fedora-rawhide/man2/recvmmsg.2 b/upstream/fedora-rawhide/man2/recvmmsg.2 index ca3edbd2..f732d031 100644 --- a/upstream/fedora-rawhide/man2/recvmmsg.2 +++ b/upstream/fedora-rawhide/man2/recvmmsg.2 @@ -8,7 +8,7 @@ .\" Author: Arnaldo Carvalho de Melo <acme@redhat.com> .\" Date: Mon Oct 12 23:40:10 2009 -0700 .\" -.TH recvmmsg 2 2023-10-31 "Linux man-pages 6.06" +.TH recvmmsg 2 2023-10-31 "Linux man-pages 6.7" .SH NAME recvmmsg \- receive multiple messages on a socket .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/remap_file_pages.2 b/upstream/fedora-rawhide/man2/remap_file_pages.2 index 7dc9efeb..f662c46a 100644 --- a/upstream/fedora-rawhide/man2/remap_file_pages.2 +++ b/upstream/fedora-rawhide/man2/remap_file_pages.2 @@ -5,7 +5,7 @@ .\" 2003-12-10 Initial creation, Michael Kerrisk <mtk.manpages@gmail.com> .\" 2004-10-28 aeb, corrected prototype, prot must be 0 .\" -.TH remap_file_pages 2 2023-10-31 "Linux man-pages 6.06" +.TH remap_file_pages 2 2023-10-31 "Linux man-pages 6.7" .SH NAME remap_file_pages \- create a nonlinear file mapping .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/removexattr.2 b/upstream/fedora-rawhide/man2/removexattr.2 index aeceb4ca..50a567e4 100644 --- a/upstream/fedora-rawhide/man2/removexattr.2 +++ b/upstream/fedora-rawhide/man2/removexattr.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH removexattr 2 2023-10-31 "Linux man-pages 6.06" +.TH removexattr 2 2023-10-31 "Linux man-pages 6.7" .SH NAME removexattr, lremovexattr, fremovexattr \- remove an extended attribute .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/rename.2 b/upstream/fedora-rawhide/man2/rename.2 index 6bbb3beb..6b538d4d 100644 --- a/upstream/fedora-rawhide/man2/rename.2 +++ b/upstream/fedora-rawhide/man2/rename.2 @@ -10,7 +10,7 @@ .\" Modified Thu Mar 3 09:49:35 2005 by Michael Haardt <michael@moria.de> .\" 2007-03-25, mtk, added various text to DESCRIPTION. .\" -.TH rename 2 2023-10-31 "Linux man-pages 6.06" +.TH rename 2 2023-10-31 "Linux man-pages 6.7" .SH NAME rename, renameat, renameat2 \- change the name or location of a file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/request_key.2 b/upstream/fedora-rawhide/man2/request_key.2 index 58c8b4fe..dd2e39d9 100644 --- a/upstream/fedora-rawhide/man2/request_key.2 +++ b/upstream/fedora-rawhide/man2/request_key.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH request_key 2 2023-10-31 "Linux man-pages 6.06" +.TH request_key 2 2024-02-25 "Linux man-pages 6.7" .SH NAME request_key \- request a key from the kernel's key management facility .SH LIBRARY @@ -227,7 +227,7 @@ The authorization key is constructed as follows: .RS .IP \[bu] 3 The key type is -.IR """.request_key_auth""" . +.IR \[dq].request_key_auth\[dq] . .IP \[bu] The key's UID and GID are the same as the corresponding filesystem IDs of the requesting process. @@ -263,10 +263,10 @@ This program is supplied with the following command-line arguments: .RS .IP [0] 5 The string -.IR """/sbin/request\-key""" . +.IR \[dq]/sbin/request\-key\[dq] . .IP [1] The string -.I """create""" +.I \[dq]create\[dq] (indicating that a key is to be created). .IP [2] The ID of the key that is to be instantiated. diff --git a/upstream/fedora-rawhide/man2/restart_syscall.2 b/upstream/fedora-rawhide/man2/restart_syscall.2 index 41b3335a..87e87057 100644 --- a/upstream/fedora-rawhide/man2/restart_syscall.2 +++ b/upstream/fedora-rawhide/man2/restart_syscall.2 @@ -10,7 +10,7 @@ .\" .\" See also Section 11.3.3 of Understanding the Linux Kernel, 3rd edition .\" -.TH restart_syscall 2 2023-10-31 "Linux man-pages 6.06" +.TH restart_syscall 2 2023-10-31 "Linux man-pages 6.7" .SH NAME restart_syscall \- restart a system call after interruption by a stop signal .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/rmdir.2 b/upstream/fedora-rawhide/man2/rmdir.2 index c5c50d97..a1dc594d 100644 --- a/upstream/fedora-rawhide/man2/rmdir.2 +++ b/upstream/fedora-rawhide/man2/rmdir.2 @@ -7,7 +7,7 @@ .\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com> .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH rmdir 2 2023-10-31 "Linux man-pages 6.06" +.TH rmdir 2 2023-10-31 "Linux man-pages 6.7" .SH NAME rmdir \- delete a directory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/rt_sigqueueinfo.2 b/upstream/fedora-rawhide/man2/rt_sigqueueinfo.2 index cdbf7559..d2d2eecc 100644 --- a/upstream/fedora-rawhide/man2/rt_sigqueueinfo.2 +++ b/upstream/fedora-rawhide/man2/rt_sigqueueinfo.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH rt_sigqueueinfo 2 2023-10-31 "Linux man-pages 6.06" +.TH rt_sigqueueinfo 2 2023-10-31 "Linux man-pages 6.7" .SH NAME rt_sigqueueinfo, rt_tgsigqueueinfo \- queue a signal and data .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/s390_guarded_storage.2 b/upstream/fedora-rawhide/man2/s390_guarded_storage.2 index 9f801093..b2038e5f 100644 --- a/upstream/fedora-rawhide/man2/s390_guarded_storage.2 +++ b/upstream/fedora-rawhide/man2/s390_guarded_storage.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH s390_guarded_storage 2 2023-10-31 "Linux man-pages 6.06" +.TH s390_guarded_storage 2 2023-10-31 "Linux man-pages 6.7" .SH NAME s390_guarded_storage \- operations with z/Architecture guarded storage facility .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/s390_pci_mmio_write.2 b/upstream/fedora-rawhide/man2/s390_pci_mmio_write.2 index ae015b1c..f6b8c468 100644 --- a/upstream/fedora-rawhide/man2/s390_pci_mmio_write.2 +++ b/upstream/fedora-rawhide/man2/s390_pci_mmio_write.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH s390_pci_mmio_write 2 2023-10-31 "Linux man-pages 6.06" +.TH s390_pci_mmio_write 2 2023-10-31 "Linux man-pages 6.7" .SH NAME s390_pci_mmio_write, s390_pci_mmio_read \- transfer data to/from PCI MMIO memory page diff --git a/upstream/fedora-rawhide/man2/s390_runtime_instr.2 b/upstream/fedora-rawhide/man2/s390_runtime_instr.2 index 1db4a498..a01421b4 100644 --- a/upstream/fedora-rawhide/man2/s390_runtime_instr.2 +++ b/upstream/fedora-rawhide/man2/s390_runtime_instr.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH s390_runtime_instr 2 2023-10-31 "Linux man-pages 6.06" +.TH s390_runtime_instr 2 2023-10-31 "Linux man-pages 6.7" .SH NAME s390_runtime_instr \- enable/disable s390 CPU run-time instrumentation .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/s390_sthyi.2 b/upstream/fedora-rawhide/man2/s390_sthyi.2 index 6a925581..1b0023ea 100644 --- a/upstream/fedora-rawhide/man2/s390_sthyi.2 +++ b/upstream/fedora-rawhide/man2/s390_sthyi.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH s390_sthyi 2 2023-10-31 "Linux man-pages 6.06" +.TH s390_sthyi 2 2023-10-31 "Linux man-pages 6.7" .SH NAME s390_sthyi \- emulate STHYI instruction .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sched_get_priority_max.2 b/upstream/fedora-rawhide/man2/sched_get_priority_max.2 index e4c3e743..30a66fad 100644 --- a/upstream/fedora-rawhide/man2/sched_get_priority_max.2 +++ b/upstream/fedora-rawhide/man2/sched_get_priority_max.2 @@ -7,7 +7,7 @@ .\" 1996-04-10 Markus Kuhn <mskuhn@cip.informatik.uni-erlangen.de> .\" revision .\" -.TH sched_get_priority_max 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_get_priority_max 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sched_get_priority_max, sched_get_priority_min \- get static priority range .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sched_rr_get_interval.2 b/upstream/fedora-rawhide/man2/sched_rr_get_interval.2 index 110f9a29..b547cf24 100644 --- a/upstream/fedora-rawhide/man2/sched_rr_get_interval.2 +++ b/upstream/fedora-rawhide/man2/sched_rr_get_interval.2 @@ -7,7 +7,7 @@ .\" 1996-04-10 Markus Kuhn <mskuhn@cip.informatik.uni-erlangen.de> .\" revision .\" -.TH sched_rr_get_interval 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_rr_get_interval 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sched_rr_get_interval \- get the SCHED_RR interval for the named process .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sched_setaffinity.2 b/upstream/fedora-rawhide/man2/sched_setaffinity.2 index d7455b34..75121298 100644 --- a/upstream/fedora-rawhide/man2/sched_setaffinity.2 +++ b/upstream/fedora-rawhide/man2/sched_setaffinity.2 @@ -12,7 +12,7 @@ .\" 2008-11-12, mtk, removed CPU_*() macro descriptions to a .\" separate CPU_SET(3) page. .\" -.TH sched_setaffinity 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_setaffinity 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sched_setaffinity, sched_getaffinity \- \ set and get a thread's CPU affinity mask diff --git a/upstream/fedora-rawhide/man2/sched_setattr.2 b/upstream/fedora-rawhide/man2/sched_setattr.2 index b55af427..546ac319 100644 --- a/upstream/fedora-rawhide/man2/sched_setattr.2 +++ b/upstream/fedora-rawhide/man2/sched_setattr.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sched_setattr 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_setattr 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sched_setattr, sched_getattr \- set and get scheduling policy and attributes diff --git a/upstream/fedora-rawhide/man2/sched_setparam.2 b/upstream/fedora-rawhide/man2/sched_setparam.2 index 5e72087b..3e699610 100644 --- a/upstream/fedora-rawhide/man2/sched_setparam.2 +++ b/upstream/fedora-rawhide/man2/sched_setparam.2 @@ -8,7 +8,7 @@ .\" revision .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH sched_setparam 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_setparam 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sched_setparam, sched_getparam \- set and get scheduling parameters .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sched_setscheduler.2 b/upstream/fedora-rawhide/man2/sched_setscheduler.2 index 185bc906..ec67aefc 100644 --- a/upstream/fedora-rawhide/man2/sched_setscheduler.2 +++ b/upstream/fedora-rawhide/man2/sched_setscheduler.2 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH sched_setscheduler 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_setscheduler 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sched_setscheduler, sched_getscheduler \- set and get scheduling policy/parameters diff --git a/upstream/fedora-rawhide/man2/sched_yield.2 b/upstream/fedora-rawhide/man2/sched_yield.2 index 0d2b7665..caf77928 100644 --- a/upstream/fedora-rawhide/man2/sched_yield.2 +++ b/upstream/fedora-rawhide/man2/sched_yield.2 @@ -7,7 +7,7 @@ .\" 1996-04-10 Markus Kuhn <mskuhn@cip.informatik.uni-erlangen.de> .\" revision .\" -.TH sched_yield 2 2023-10-31 "Linux man-pages 6.06" +.TH sched_yield 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sched_yield \- yield the processor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/seccomp.2 b/upstream/fedora-rawhide/man2/seccomp.2 index 522b4090..b3f80269 100644 --- a/upstream/fedora-rawhide/man2/seccomp.2 +++ b/upstream/fedora-rawhide/man2/seccomp.2 @@ -6,7 +6,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH seccomp 2 2023-10-31 "Linux man-pages 6.06" +.TH seccomp 2 2023-10-31 "Linux man-pages 6.7" .SH NAME seccomp \- operate on Secure Computing state of the process .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/seccomp_unotify.2 b/upstream/fedora-rawhide/man2/seccomp_unotify.2 index 1bd5eb4d..7c2084ba 100644 --- a/upstream/fedora-rawhide/man2/seccomp_unotify.2 +++ b/upstream/fedora-rawhide/man2/seccomp_unotify.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH seccomp_unotify 2 2023-10-31 "Linux man-pages 6.06" +.TH seccomp_unotify 2 2023-10-31 "Linux man-pages 6.7" .SH NAME seccomp_unotify \- Seccomp user-space notification mechanism .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/select.2 b/upstream/fedora-rawhide/man2/select.2 index a43bbdb9..e544918b 100644 --- a/upstream/fedora-rawhide/man2/select.2 +++ b/upstream/fedora-rawhide/man2/select.2 @@ -17,7 +17,7 @@ .\" 2005-03-11, mtk, modified pselect() text (it is now a system .\" call in Linux 2.6.16. .\" -.TH select 2 2023-10-31 "Linux man-pages 6.06" +.TH select 2 2023-10-31 "Linux man-pages 6.7" .SH NAME select, pselect, FD_CLR, FD_ISSET, FD_SET, FD_ZERO, fd_set \- synchronous I/O multiplexing diff --git a/upstream/fedora-rawhide/man2/select_tut.2 b/upstream/fedora-rawhide/man2/select_tut.2 index ab6c8c30..cbb69538 100644 --- a/upstream/fedora-rawhide/man2/select_tut.2 +++ b/upstream/fedora-rawhide/man2/select_tut.2 @@ -9,7 +9,7 @@ .\" various other changes .\" 2008-01-26, mtk, substantial changes and rewrites .\" -.TH SELECT_TUT 2 2023-10-31 "Linux man-pages 6.06" +.TH SELECT_TUT 2 2023-10-31 "Linux man-pages 6.7" .SH NAME select, pselect \- synchronous I/O multiplexing .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/semctl.2 b/upstream/fedora-rawhide/man2/semctl.2 index f8a322a1..c3724e48 100644 --- a/upstream/fedora-rawhide/man2/semctl.2 +++ b/upstream/fedora-rawhide/man2/semctl.2 @@ -20,7 +20,7 @@ .\" 2005-08-02, mtk: Added IPC_INFO, SEM_INFO, SEM_STAT descriptions. .\" 2018-03-20, dbueso: Added SEM_STAT_ANY description. .\" -.TH semctl 2 2023-10-31 "Linux man-pages 6.06" +.TH semctl 2 2024-03-03 "Linux man-pages 6.7" .SH NAME semctl \- System V semaphore control operations .SH LIBRARY @@ -30,12 +30,12 @@ Standard C library .nf .B #include <sys/sem.h> .P -.BI "int semctl(int " semid ", int " semnum ", int " cmd ", ...);" +.BI "int semctl(int " semid ", int " semnum ", int " op ", ...);" .fi .SH DESCRIPTION .BR semctl () performs the control operation specified by -.I cmd +.I op on the System\ V semaphore set identified by .IR semid , or on the @@ -44,7 +44,7 @@ semaphore of that set. (The semaphores in a set are numbered starting at 0.) .P This function has three or four arguments, depending on -.IR cmd . +.IR op . When there are four, the fourth has the type .IR "union semun" . The \fIcalling program\fP must define this union as follows: @@ -149,7 +149,7 @@ In effect, "write" means "alter" for a semaphore set. Bits 0100, 0010, and 0001 (the execute bits) are unused by the system. .P Valid values for -.I cmd +.I op are: .TP .B IPC_STAT @@ -380,7 +380,7 @@ The calling process must have alter permission on the semaphore set. On success, .BR semctl () returns a nonnegative value depending on -.I cmd +.I op as follows: .TP .B GETNCNT @@ -422,7 +422,7 @@ as for .BR SEM_STAT . .P All other -.I cmd +.I op values return 0 on success. .P On failure, @@ -434,7 +434,7 @@ to indicate the error. .TP .B EACCES The argument -.I cmd +.I op has one of the values .BR GETALL , .BR GETPID , @@ -464,7 +464,7 @@ The semaphore set was removed. .TP .B EINVAL Invalid value for -.I cmd +.I op or .IR semid . Or: for a @@ -475,7 +475,7 @@ referred to an array slot that is currently unused. .TP .B EPERM The argument -.I cmd +.I op has the value .B IPC_SET or @@ -493,7 +493,7 @@ capability. .TP .B ERANGE The argument -.I cmd +.I op has the value .B SETALL or @@ -575,7 +575,7 @@ a recompilation under glibc-2.1.91 or later should suffice. (The kernel distinguishes old and new calls by an .B IPC_64 flag in -.IR cmd .) +.IR op .) .P In some earlier versions of glibc, the .I semun diff --git a/upstream/fedora-rawhide/man2/semget.2 b/upstream/fedora-rawhide/man2/semget.2 index b1fcb45a..50813ba8 100644 --- a/upstream/fedora-rawhide/man2/semget.2 +++ b/upstream/fedora-rawhide/man2/semget.2 @@ -14,7 +14,7 @@ .\" Rewrote BUGS note about semget()'s failure to initialize .\" semaphore values .\" -.TH semget 2 2023-10-31 "Linux man-pages 6.06" +.TH semget 2 2023-10-31 "Linux man-pages 6.7" .SH NAME semget \- get a System V semaphore set identifier .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/semop.2 b/upstream/fedora-rawhide/man2/semop.2 index 23402861..b04fe6a1 100644 --- a/upstream/fedora-rawhide/man2/semop.2 +++ b/upstream/fedora-rawhide/man2/semop.2 @@ -12,7 +12,7 @@ .\" 2005-04-08, mtk, Noted kernel version numbers for semtimedop() .\" 2007-07-09, mtk, Added an EXAMPLE code segment. .\" -.TH semop 2 2023-10-31 "Linux man-pages 6.06" +.TH semop 2 2023-10-31 "Linux man-pages 6.7" .SH NAME semop, semtimedop \- System V semaphore operations .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/send.2 b/upstream/fedora-rawhide/man2/send.2 index 1fbd790e..79abcc7d 100644 --- a/upstream/fedora-rawhide/man2/send.2 +++ b/upstream/fedora-rawhide/man2/send.2 @@ -9,7 +9,7 @@ .\" Modified Oct 2003 by aeb .\" Modified 2004-07-01 by mtk .\" -.TH send 2 2023-10-31 "Linux man-pages 6.06" +.TH send 2 2024-02-18 "Linux man-pages 6.7" .SH NAME send, sendto, sendmsg \- send a message on a socket .SH LIBRARY @@ -184,7 +184,7 @@ is a per-call option, whereas is a setting on the open file description (see .BR open (2)), which will affect all threads in the calling process -and as well as other processes that hold file descriptors +as well as other processes that hold file descriptors referring to the same open file description. .TP .BR MSG_EOR " (since Linux 2.2)" diff --git a/upstream/fedora-rawhide/man2/sendfile.2 b/upstream/fedora-rawhide/man2/sendfile.2 index db0e3939..e013fa6d 100644 --- a/upstream/fedora-rawhide/man2/sendfile.2 +++ b/upstream/fedora-rawhide/man2/sendfile.2 @@ -11,7 +11,7 @@ .\" .\" 2005-03-31 Martin Pool <mbp@sourcefrog.net> mmap() improvements .\" -.TH sendfile 2 2023-12-21 "Linux man-pages 6.06" +.TH sendfile 2 2023-12-21 "Linux man-pages 6.7" .SH NAME sendfile \- transfer data between file descriptors .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sendmmsg.2 b/upstream/fedora-rawhide/man2/sendmmsg.2 index f1f9456e..64a4da08 100644 --- a/upstream/fedora-rawhide/man2/sendmmsg.2 +++ b/upstream/fedora-rawhide/man2/sendmmsg.2 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sendmmsg 2 2023-10-31 "Linux man-pages 6.06" +.TH sendmmsg 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sendmmsg \- send multiple messages on a socket .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/set_mempolicy.2 b/upstream/fedora-rawhide/man2/set_mempolicy.2 index ccefec19..58e39596 100644 --- a/upstream/fedora-rawhide/man2/set_mempolicy.2 +++ b/upstream/fedora-rawhide/man2/set_mempolicy.2 @@ -7,7 +7,7 @@ .\" 2007-08-27, Lee Schermerhorn <Lee.Schermerhorn@hp.com> .\" more precise specification of behavior. .\" -.TH set_mempolicy 2 2023-10-31 "Linux man-pages 6.06" +.TH set_mempolicy 2 2023-10-31 "Linux man-pages 6.7" .SH NAME set_mempolicy \- set default NUMA memory policy for a thread and its children .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/set_thread_area.2 b/upstream/fedora-rawhide/man2/set_thread_area.2 index 6406cfb1..389d65b6 100644 --- a/upstream/fedora-rawhide/man2/set_thread_area.2 +++ b/upstream/fedora-rawhide/man2/set_thread_area.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH set_thread_area 2 2023-10-31 "Linux man-pages 6.06" +.TH set_thread_area 2 2023-10-31 "Linux man-pages 6.7" .SH NAME get_thread_area, set_thread_area \- manipulate thread-local storage information .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/set_tid_address.2 b/upstream/fedora-rawhide/man2/set_tid_address.2 index aa90b057..d1741056 100644 --- a/upstream/fedora-rawhide/man2/set_tid_address.2 +++ b/upstream/fedora-rawhide/man2/set_tid_address.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH set_tid_address 2 2023-10-31 "Linux man-pages 6.06" +.TH set_tid_address 2 2023-10-31 "Linux man-pages 6.7" .SH NAME set_tid_address \- set pointer to thread ID .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/seteuid.2 b/upstream/fedora-rawhide/man2/seteuid.2 index a82ab6eb..c1cae7ca 100644 --- a/upstream/fedora-rawhide/man2/seteuid.2 +++ b/upstream/fedora-rawhide/man2/seteuid.2 @@ -6,7 +6,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH seteuid 2 2024-02-11 "Linux man-pages 6.06" +.TH seteuid 2 2024-02-11 "Linux man-pages 6.7" .SH NAME seteuid, setegid \- set effective user or group ID .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/setfsgid.2 b/upstream/fedora-rawhide/man2/setfsgid.2 index e87e5160..8cb8403a 100644 --- a/upstream/fedora-rawhide/man2/setfsgid.2 +++ b/upstream/fedora-rawhide/man2/setfsgid.2 @@ -9,7 +9,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH setfsgid 2 2023-10-31 "Linux man-pages 6.06" +.TH setfsgid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME setfsgid \- set group identity used for filesystem checks .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/setfsuid.2 b/upstream/fedora-rawhide/man2/setfsuid.2 index 01102bf5..cd55bc3d 100644 --- a/upstream/fedora-rawhide/man2/setfsuid.2 +++ b/upstream/fedora-rawhide/man2/setfsuid.2 @@ -9,7 +9,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH setfsuid 2 2023-10-31 "Linux man-pages 6.06" +.TH setfsuid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME setfsuid \- set user identity used for filesystem checks .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/setgid.2 b/upstream/fedora-rawhide/man2/setgid.2 index 52bdd29c..cb65798c 100644 --- a/upstream/fedora-rawhide/man2/setgid.2 +++ b/upstream/fedora-rawhide/man2/setgid.2 @@ -7,7 +7,7 @@ .\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com> .\" Modified 2002-03-09 by aeb .\" -.TH setgid 2 2023-10-31 "Linux man-pages 6.06" +.TH setgid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME setgid \- set group identity .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/setns.2 b/upstream/fedora-rawhide/man2/setns.2 index 50573c7d..5bd33855 100644 --- a/upstream/fedora-rawhide/man2/setns.2 +++ b/upstream/fedora-rawhide/man2/setns.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-only .\" -.TH setns 2 2023-10-31 "Linux man-pages 6.06" +.TH setns 2 2023-10-31 "Linux man-pages 6.7" .SH NAME setns \- reassociate thread with a namespace .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/setpgid.2 b/upstream/fedora-rawhide/man2/setpgid.2 index 27d057c2..b3983c44 100644 --- a/upstream/fedora-rawhide/man2/setpgid.2 +++ b/upstream/fedora-rawhide/man2/setpgid.2 @@ -17,7 +17,7 @@ .\" 2007-07-25, mtk, fairly substantial rewrites and rearrangements .\" of text. .\" -.TH setpgid 2 2023-10-31 "Linux man-pages 6.06" +.TH setpgid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME setpgid, getpgid, setpgrp, getpgrp \- set/get process group .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/setresuid.2 b/upstream/fedora-rawhide/man2/setresuid.2 index f5ecf3b3..9c6499b9 100644 --- a/upstream/fedora-rawhide/man2/setresuid.2 +++ b/upstream/fedora-rawhide/man2/setresuid.2 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified, 2003-05-26, Michael Kerrisk, <mtk.manpages@gmail.com> -.TH setresuid 2 2023-10-31 "Linux man-pages 6.06" +.TH setresuid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME setresuid, setresgid \- set real, effective, and saved user or group ID .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/setreuid.2 b/upstream/fedora-rawhide/man2/setreuid.2 index daf2c5a5..e8876190 100644 --- a/upstream/fedora-rawhide/man2/setreuid.2 +++ b/upstream/fedora-rawhide/man2/setreuid.2 @@ -15,7 +15,7 @@ .\" 2004-07-04 by aeb .\" 2004-05-27 by Michael Kerrisk .\" -.TH setreuid 2 2023-10-31 "Linux man-pages 6.06" +.TH setreuid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME setreuid, setregid \- set real and/or effective user or group ID .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/setsid.2 b/upstream/fedora-rawhide/man2/setsid.2 index 2adc19bf..a437a1bc 100644 --- a/upstream/fedora-rawhide/man2/setsid.2 +++ b/upstream/fedora-rawhide/man2/setsid.2 @@ -9,7 +9,7 @@ .\" tiny changes from a man page by Charles Livingston). .\" Modified Sun Jul 21 14:45:46 1996 <aeb@cwi.nl> .\" -.TH setsid 2 2023-10-31 "Linux man-pages 6.06" +.TH setsid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME setsid \- creates a session and sets the process group ID .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/setuid.2 b/upstream/fedora-rawhide/man2/setuid.2 index 4d8ffb7d..e9a283ea 100644 --- a/upstream/fedora-rawhide/man2/setuid.2 +++ b/upstream/fedora-rawhide/man2/setuid.2 @@ -8,7 +8,7 @@ .\" <richard@greenend.org.uk>, aeb 970616. .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements -.TH setuid 2 2023-10-31 "Linux man-pages 6.06" +.TH setuid 2 2023-10-31 "Linux man-pages 6.7" .SH NAME setuid \- set user identity .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/setup.2 b/upstream/fedora-rawhide/man2/setup.2 index c10fb44d..c2d0b526 100644 --- a/upstream/fedora-rawhide/man2/setup.2 +++ b/upstream/fedora-rawhide/man2/setup.2 @@ -11,7 +11,7 @@ .\" Modified Wed Nov 6 04:05:28 1996 by Eric S. Raymond <esr@thyrsus.com> .\" Modified Sat Jan 29 01:08:23 2000 by aeb .\" -.TH setup 2 2023-10-31 "Linux man-pages 6.06" +.TH setup 2 2023-10-31 "Linux man-pages 6.7" .SH NAME setup \- setup devices and filesystems, mount root filesystem .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/setxattr.2 b/upstream/fedora-rawhide/man2/setxattr.2 index df821e59..636462e0 100644 --- a/upstream/fedora-rawhide/man2/setxattr.2 +++ b/upstream/fedora-rawhide/man2/setxattr.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH setxattr 2 2023-10-31 "Linux man-pages 6.06" +.TH setxattr 2 2023-10-31 "Linux man-pages 6.7" .SH NAME setxattr, lsetxattr, fsetxattr \- set an extended attribute value .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sgetmask.2 b/upstream/fedora-rawhide/man2/sgetmask.2 index 07e413a1..e1701c2c 100644 --- a/upstream/fedora-rawhide/man2/sgetmask.2 +++ b/upstream/fedora-rawhide/man2/sgetmask.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sgetmask 2 2023-10-31 "Linux man-pages 6.06" +.TH sgetmask 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sgetmask, ssetmask \- manipulation of signal mask (obsolete) .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/shmctl.2 b/upstream/fedora-rawhide/man2/shmctl.2 index 0ede555d..5d5176ae 100644 --- a/upstream/fedora-rawhide/man2/shmctl.2 +++ b/upstream/fedora-rawhide/man2/shmctl.2 @@ -24,7 +24,7 @@ .\" 2005-08-02, mtk: Added IPC_INFO, SHM_INFO, SHM_STAT descriptions. .\" 2018-03-20, dbueso: Added SHM_STAT_ANY description. .\" -.TH shmctl 2 2023-10-31 "Linux man-pages 6.06" +.TH shmctl 2 2024-03-03 "Linux man-pages 6.7" .SH NAME shmctl \- System V shared memory control .SH LIBRARY @@ -34,12 +34,12 @@ Standard C library .nf .B #include <sys/shm.h> .P -.BI "int shmctl(int " shmid ", int " cmd ", struct shmid_ds *" buf ); +.BI "int shmctl(int " shmid ", int " op ", struct shmid_ds *" buf ); .fi .SH DESCRIPTION .BR shmctl () performs the control operation specified by -.I cmd +.I op on the System\ V shared memory segment whose identifier is given in .IR shmid . .P @@ -153,7 +153,7 @@ call with the flag.) .P Valid values for -.I cmd +.I op are: .TP .B IPC_STAT @@ -309,7 +309,9 @@ meaning that any user can employ this operation (just as any user may read to obtain the same information). .P The caller can prevent or allow swapping of a shared -memory segment with the following \fIcmd\fP values: +memory segment with the following +.I op +values: .TP .BR SHM_LOCK " (Linux-specific)" Prevent swapping of the shared memory segment. @@ -379,7 +381,7 @@ capability in the user namespace that governs its IPC namespace. .TP .B EFAULT The argument -.I cmd +.I op has value .B IPC_SET or @@ -392,8 +394,10 @@ isn't accessible. \fIshmid\fP points to a removed identifier. .TP .B EINVAL -\fIshmid\fP is not a valid identifier, or \fIcmd\fP -is not a valid command. +.I shmid +is not a valid identifier, or +.I op +is not a valid operation. Or: for a .B SHM_STAT or @@ -468,7 +472,7 @@ a recompilation under glibc-2.1.91 or later should suffice. (The kernel distinguishes old and new calls by an .B IPC_64 flag in -.IR cmd .) +.IR op .) .SH NOTES The .BR IPC_INFO , diff --git a/upstream/fedora-rawhide/man2/shmget.2 b/upstream/fedora-rawhide/man2/shmget.2 index ac3e2b75..685963a8 100644 --- a/upstream/fedora-rawhide/man2/shmget.2 +++ b/upstream/fedora-rawhide/man2/shmget.2 @@ -15,7 +15,7 @@ .\" Language and formatting clean-ups .\" Added notes on /proc files .\" -.TH shmget 2 2023-10-31 "Linux man-pages 6.06" +.TH shmget 2 2023-10-31 "Linux man-pages 6.7" .SH NAME shmget \- allocates a System V shared memory segment .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/shmop.2 b/upstream/fedora-rawhide/man2/shmop.2 index f5b70a48..a763420c 100644 --- a/upstream/fedora-rawhide/man2/shmop.2 +++ b/upstream/fedora-rawhide/man2/shmop.2 @@ -17,7 +17,7 @@ .\" Changed wording and placement of sentence regarding attachment .\" of segments marked for destruction .\" -.TH SHMOP 2 2023-10-31 "Linux man-pages 6.06" +.TH SHMOP 2 2023-10-31 "Linux man-pages 6.7" .SH NAME shmat, shmdt \- System V shared memory operations .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/shutdown.2 b/upstream/fedora-rawhide/man2/shutdown.2 index 7dde6565..6f45f9f9 100644 --- a/upstream/fedora-rawhide/man2/shutdown.2 +++ b/upstream/fedora-rawhide/man2/shutdown.2 @@ -9,7 +9,7 @@ .\" Modified Tue Oct 22 22:04:51 1996 by Eric S. Raymond <esr@thyrsus.com> .\" Modified 1998 by Andi Kleen .\" -.TH shutdown 2 2023-10-31 "Linux man-pages 6.06" +.TH shutdown 2 2023-10-31 "Linux man-pages 6.7" .SH NAME shutdown \- shut down part of a full-duplex connection .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sigaction.2 b/upstream/fedora-rawhide/man2/sigaction.2 index 85c6c00f..bbe4d5a6 100644 --- a/upstream/fedora-rawhide/man2/sigaction.2 +++ b/upstream/fedora-rawhide/man2/sigaction.2 @@ -25,7 +25,7 @@ .\" 2015-01-17, Kees Cook <keescook@chromium.org> .\" Added notes on ptrace SIGTRAP and SYS_SECCOMP. .\" -.TH sigaction 2 2023-10-31 "Linux man-pages 6.06" +.TH sigaction 2 2024-02-25 "Linux man-pages 6.7" .SH NAME sigaction, rt_sigaction \- examine and change a signal action .SH LIBRARY @@ -1020,14 +1020,21 @@ or similar. POSIX.1-1990 specified only .BR SA_NOCLDSTOP . POSIX.1-2001 added -.BR SA_NOCLDSTOP , .BR SA_NOCLDWAIT , .BR SA_NODEFER , .BR SA_ONSTACK , .BR SA_RESETHAND , .BR SA_RESTART , and -.BR SA_SIGINFO . +.B SA_SIGINFO +as XSI extensions. +POSIX.1-2008 moved +.BR SA_NODEFER , +.BR SA_RESETHAND , +.BR SA_RESTART , +and +.B SA_SIGINFO +to the base specifications. Use of these latter values in .I sa_flags may be less portable in applications intended for older diff --git a/upstream/fedora-rawhide/man2/sigaltstack.2 b/upstream/fedora-rawhide/man2/sigaltstack.2 index 8b91da5a..82ba8127 100644 --- a/upstream/fedora-rawhide/man2/sigaltstack.2 +++ b/upstream/fedora-rawhide/man2/sigaltstack.2 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" aeb, various minor fixes -.TH sigaltstack 2 2023-10-31 "Linux man-pages 6.06" +.TH sigaltstack 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sigaltstack \- set and/or get signal stack context .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/signal.2 b/upstream/fedora-rawhide/man2/signal.2 index cfb0aef9..77f7b192 100644 --- a/upstream/fedora-rawhide/man2/signal.2 +++ b/upstream/fedora-rawhide/man2/signal.2 @@ -13,7 +13,7 @@ .\" various sections. .\" 2008-07-11, mtk: rewrote and expanded portability discussion. .\" -.TH signal 2 2023-10-31 "Linux man-pages 6.06" +.TH signal 2 2023-10-31 "Linux man-pages 6.7" .SH NAME signal \- ANSI C signal handling .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/signalfd.2 b/upstream/fedora-rawhide/man2/signalfd.2 index e0c0a47e..fba622c5 100644 --- a/upstream/fedora-rawhide/man2/signalfd.2 +++ b/upstream/fedora-rawhide/man2/signalfd.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH signalfd 2 2023-10-31 "Linux man-pages 6.06" +.TH signalfd 2 2023-10-31 "Linux man-pages 6.7" .SH NAME signalfd \- create a file descriptor for accepting signals .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sigpending.2 b/upstream/fedora-rawhide/man2/sigpending.2 index 7f321f5e..cd67531a 100644 --- a/upstream/fedora-rawhide/man2/sigpending.2 +++ b/upstream/fedora-rawhide/man2/sigpending.2 @@ -6,7 +6,7 @@ .\" .\" 2005-09-15, mtk, Created new page by splitting off from sigaction.2 .\" -.TH sigpending 2 2023-10-31 "Linux man-pages 6.06" +.TH sigpending 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sigpending, rt_sigpending \- examine pending signals .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sigprocmask.2 b/upstream/fedora-rawhide/man2/sigprocmask.2 index 28a5f908..f0017b43 100644 --- a/upstream/fedora-rawhide/man2/sigprocmask.2 +++ b/upstream/fedora-rawhide/man2/sigprocmask.2 @@ -6,7 +6,7 @@ .\" .\" 2005-09-15, mtk, Created new page by splitting off from sigaction.2 .\" -.TH sigprocmask 2 2023-10-31 "Linux man-pages 6.06" +.TH sigprocmask 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sigprocmask, rt_sigprocmask \- examine and change blocked signals .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sigreturn.2 b/upstream/fedora-rawhide/man2/sigreturn.2 index b230591c..dd0935aa 100644 --- a/upstream/fedora-rawhide/man2/sigreturn.2 +++ b/upstream/fedora-rawhide/man2/sigreturn.2 @@ -7,7 +7,7 @@ .\" 2008-06-26, mtk, added some more detail on the work done by sigreturn() .\" 2014-12-05, mtk, rewrote all of the rest of the original page .\" -.TH sigreturn 2 2023-10-31 "Linux man-pages 6.06" +.TH sigreturn 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sigreturn, rt_sigreturn \- return from signal handler and cleanup stack frame .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sigsuspend.2 b/upstream/fedora-rawhide/man2/sigsuspend.2 index 945d30d6..9bb39f8d 100644 --- a/upstream/fedora-rawhide/man2/sigsuspend.2 +++ b/upstream/fedora-rawhide/man2/sigsuspend.2 @@ -6,7 +6,7 @@ .\" .\" 2005-09-15, mtk, Created new page by splitting off from sigaction.2 .\" -.TH sigsuspend 2 2023-10-31 "Linux man-pages 6.06" +.TH sigsuspend 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sigsuspend, rt_sigsuspend \- wait for a signal .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sigwaitinfo.2 b/upstream/fedora-rawhide/man2/sigwaitinfo.2 index 656c8f18..cf231bc7 100644 --- a/upstream/fedora-rawhide/man2/sigwaitinfo.2 +++ b/upstream/fedora-rawhide/man2/sigwaitinfo.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sigwaitinfo 2 2023-10-31 "Linux man-pages 6.06" +.TH sigwaitinfo 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sigwaitinfo, sigtimedwait, rt_sigtimedwait \- synchronously wait for queued signals diff --git a/upstream/fedora-rawhide/man2/socket.2 b/upstream/fedora-rawhide/man2/socket.2 index d1ab728a..b83bd5b6 100644 --- a/upstream/fedora-rawhide/man2/socket.2 +++ b/upstream/fedora-rawhide/man2/socket.2 @@ -12,7 +12,7 @@ .\" Modified 2002-07-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH socket 2 2024-01-28 "Linux man-pages 6.06" +.TH socket 2 2024-01-28 "Linux man-pages 6.7" .SH NAME socket \- create an endpoint for communication .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/socketcall.2 b/upstream/fedora-rawhide/man2/socketcall.2 index 57fbf13f..d536966f 100644 --- a/upstream/fedora-rawhide/man2/socketcall.2 +++ b/upstream/fedora-rawhide/man2/socketcall.2 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Tue Oct 22 22:11:53 1996 by Eric S. Raymond <esr@thyrsus.com> -.TH socketcall 2 2023-10-31 "Linux man-pages 6.06" +.TH socketcall 2 2023-10-31 "Linux man-pages 6.7" .SH NAME socketcall \- socket system calls .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/socketpair.2 b/upstream/fedora-rawhide/man2/socketpair.2 index 880f9a0b..ae304e60 100644 --- a/upstream/fedora-rawhide/man2/socketpair.2 +++ b/upstream/fedora-rawhide/man2/socketpair.2 @@ -11,7 +11,7 @@ .\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com> .\" 2008-10-11, mtk: Add description of SOCK_NONBLOCK and SOCK_CLOEXEC .\" -.TH socketpair 2 2023-10-31 "Linux man-pages 6.06" +.TH socketpair 2 2023-10-31 "Linux man-pages 6.7" .SH NAME socketpair \- create a pair of connected sockets .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/splice.2 b/upstream/fedora-rawhide/man2/splice.2 index 2c44ed18..ff39e036 100644 --- a/upstream/fedora-rawhide/man2/splice.2 +++ b/upstream/fedora-rawhide/man2/splice.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH splice 2 2023-10-31 "Linux man-pages 6.06" +.TH splice 2 2023-10-31 "Linux man-pages 6.7" .SH NAME splice \- splice data to/from a pipe .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/spu_create.2 b/upstream/fedora-rawhide/man2/spu_create.2 index 9cab20ad..38efa2c9 100644 --- a/upstream/fedora-rawhide/man2/spu_create.2 +++ b/upstream/fedora-rawhide/man2/spu_create.2 @@ -8,7 +8,7 @@ .\" 2007-07-10, some polishing by mtk .\" 2007-09-28, updates for newer kernels by Jeremy Kerr <jk@ozlabs.org> .\" -.TH spu_create 2 2023-10-31 "Linux man-pages 6.06" +.TH spu_create 2 2023-10-31 "Linux man-pages 6.7" .SH NAME spu_create \- create a new spu context .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/spu_run.2 b/upstream/fedora-rawhide/man2/spu_run.2 index 62762c86..5b707533 100644 --- a/upstream/fedora-rawhide/man2/spu_run.2 +++ b/upstream/fedora-rawhide/man2/spu_run.2 @@ -9,7 +9,7 @@ .\" 2007-09-28, updates for newer kernels, added example .\" by Jeremy Kerr <jk@ozlabs.org> .\" -.TH spu_run 2 2023-10-31 "Linux man-pages 6.06" +.TH spu_run 2 2023-10-31 "Linux man-pages 6.7" .SH NAME spu_run \- execute an SPU context .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/stat.2 b/upstream/fedora-rawhide/man2/stat.2 index 295d0b49..bb813ffa 100644 --- a/upstream/fedora-rawhide/man2/stat.2 +++ b/upstream/fedora-rawhide/man2/stat.2 @@ -16,7 +16,7 @@ .\" 2007-06-08 mtk: Added example program .\" 2007-07-05 mtk: Added details on underlying system call interfaces .\" -.TH stat 2 2023-10-31 "Linux man-pages 6.06" +.TH stat 2 2023-10-31 "Linux man-pages 6.7" .SH NAME stat, fstat, lstat, fstatat \- get file status .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/statfs.2 b/upstream/fedora-rawhide/man2/statfs.2 index 8b2783c4..df633ae1 100644 --- a/upstream/fedora-rawhide/man2/statfs.2 +++ b/upstream/fedora-rawhide/man2/statfs.2 @@ -5,7 +5,7 @@ .\" Modified 2003-08-17 by Walter Harms .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH statfs 2 2023-10-31 "Linux man-pages 6.06" +.TH statfs 2 2023-10-31 "Linux man-pages 6.7" .SH NAME statfs, fstatfs \- get filesystem statistics .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/statx.2 b/upstream/fedora-rawhide/man2/statx.2 index 4174d368..ce79da25 100644 --- a/upstream/fedora-rawhide/man2/statx.2 +++ b/upstream/fedora-rawhide/man2/statx.2 @@ -8,7 +8,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH statx 2 2023-10-31 "Linux man-pages 6.06" +.TH statx 2 2023-10-31 "Linux man-pages 6.7" .SH NAME statx \- get file status (extended) .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/stime.2 b/upstream/fedora-rawhide/man2/stime.2 index 0362b687..13378891 100644 --- a/upstream/fedora-rawhide/man2/stime.2 +++ b/upstream/fedora-rawhide/man2/stime.2 @@ -7,7 +7,7 @@ .\" Modified 2001-03-16 by Andries Brouwer <aeb@cwi.nl> .\" Modified 2004-05-27 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH stime 2 2023-10-31 "Linux man-pages 6.06" +.TH stime 2 2023-10-31 "Linux man-pages 6.7" .SH NAME stime \- set time .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/subpage_prot.2 b/upstream/fedora-rawhide/man2/subpage_prot.2 index d943de48..aaeb8833 100644 --- a/upstream/fedora-rawhide/man2/subpage_prot.2 +++ b/upstream/fedora-rawhide/man2/subpage_prot.2 @@ -7,7 +7,7 @@ .\" in Linux commit fa28237cfcc5827553044cbd6ee52e33692b0faa .\" both written by Paul Mackerras <paulus@samba.org> .\" -.TH subpage_prot 2 2023-10-31 "Linux man-pages 6.06" +.TH subpage_prot 2 2023-10-31 "Linux man-pages 6.7" .SH NAME subpage_prot \- define a subpage protection for an address range .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/swapon.2 b/upstream/fedora-rawhide/man2/swapon.2 index 4db52438..87bd6a0e 100644 --- a/upstream/fedora-rawhide/man2/swapon.2 +++ b/upstream/fedora-rawhide/man2/swapon.2 @@ -22,7 +22,7 @@ .\" Author: Rafael Aquini <aquini@redhat.com> .\" Date: Wed Jul 3 15:02:46 2013 -0700 .\" -.TH swapon 2 2023-12-22 "Linux man-pages 6.06" +.TH swapon 2 2023-12-22 "Linux man-pages 6.7" .SH NAME swapon, swapoff \- start/stop swapping to file/device .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/symlink.2 b/upstream/fedora-rawhide/man2/symlink.2 index d7b9548e..37db3c83 100644 --- a/upstream/fedora-rawhide/man2/symlink.2 +++ b/upstream/fedora-rawhide/man2/symlink.2 @@ -10,7 +10,7 @@ .\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com> .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH symlink 2 2023-10-31 "Linux man-pages 6.06" +.TH symlink 2 2023-10-31 "Linux man-pages 6.7" .SH NAME symlink, symlinkat \- make a new name for a file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sync.2 b/upstream/fedora-rawhide/man2/sync.2 index 20975794..a556c8e9 100644 --- a/upstream/fedora-rawhide/man2/sync.2 +++ b/upstream/fedora-rawhide/man2/sync.2 @@ -13,7 +13,7 @@ .\" Modified 2001-10-10 by aeb, following Michael Kerrisk. .\" 2011-09-07, mtk, Added syncfs() documentation, .\" -.TH sync 2 2023-10-31 "Linux man-pages 6.06" +.TH sync 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sync, syncfs \- commit filesystem caches to disk .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/sync_file_range.2 b/upstream/fedora-rawhide/man2/sync_file_range.2 index a051178c..becef29d 100644 --- a/upstream/fedora-rawhide/man2/sync_file_range.2 +++ b/upstream/fedora-rawhide/man2/sync_file_range.2 @@ -7,7 +7,7 @@ .\" Andrew Morton's comments in fs/sync.c .\" 2010-10-09, mtk, Document sync_file_range2() .\" -.TH sync_file_range 2 2023-10-31 "Linux man-pages 6.06" +.TH sync_file_range 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sync_file_range \- sync a file segment with disk .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/syscall.2 b/upstream/fedora-rawhide/man2/syscall.2 index 80df9e72..01229e8c 100644 --- a/upstream/fedora-rawhide/man2/syscall.2 +++ b/upstream/fedora-rawhide/man2/syscall.2 @@ -12,7 +12,7 @@ .\" 2015-01-17, Kees Cook <keescook@chromium.org> .\" Added mips and arm64. .\" -.TH syscall 2 2023-10-31 "Linux man-pages 6.06" +.TH syscall 2 2023-10-31 "Linux man-pages 6.7" .SH NAME syscall \- indirect system call .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/syscalls.2 b/upstream/fedora-rawhide/man2/syscalls.2 index 97293c27..09535aa4 100644 --- a/upstream/fedora-rawhide/man2/syscalls.2 +++ b/upstream/fedora-rawhide/man2/syscalls.2 @@ -9,7 +9,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH syscalls 2 2024-01-16 "Linux man-pages 6.06" +.TH syscalls 2 2024-02-18 "Linux man-pages 6.7" .SH NAME syscalls \- Linux system calls .SH SYNOPSIS @@ -985,7 +985,7 @@ details such as the size of their arguments. the glibc wrapper functions do some work to ensure that the right system call is invoked, and that ABI compatibility is preserved for old binaries.) -Examples of systems calls that exist in multiple versions are +Examples of system calls that exist in multiple versions are the following: .IP \[bu] 3 By now there are three different versions of diff --git a/upstream/fedora-rawhide/man2/sysctl.2 b/upstream/fedora-rawhide/man2/sysctl.2 index 7e9f185b..082545e2 100644 --- a/upstream/fedora-rawhide/man2/sysctl.2 +++ b/upstream/fedora-rawhide/man2/sysctl.2 @@ -7,7 +7,7 @@ .\" Modified Tue Oct 22 22:28:41 1996 by Eric S. Raymond <esr@thyrsus.com> .\" Modified Mon Jan 5 20:31:04 1998 by aeb. .\" -.TH sysctl 2 2023-10-31 "Linux man-pages 6.06" +.TH sysctl 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sysctl \- read/write system parameters .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/sysfs.2 b/upstream/fedora-rawhide/man2/sysfs.2 index a3ce6936..06507fdf 100644 --- a/upstream/fedora-rawhide/man2/sysfs.2 +++ b/upstream/fedora-rawhide/man2/sysfs.2 @@ -4,7 +4,7 @@ .\" .\" Created Wed Aug 9 1995 Thomas K. Dyas <tdyas@eden.rutgers.edu> .\" -.TH sysfs 2 2023-10-31 "Linux man-pages 6.06" +.TH sysfs 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sysfs \- get filesystem type information .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/sysinfo.2 b/upstream/fedora-rawhide/man2/sysinfo.2 index 843b4cc2..5566b4b9 100644 --- a/upstream/fedora-rawhide/man2/sysinfo.2 +++ b/upstream/fedora-rawhide/man2/sysinfo.2 @@ -12,7 +12,7 @@ .\" Modified Tue Oct 22 22:29:51 1996 by Eric S. Raymond <esr@thyrsus.com> .\" Modified Mon Aug 25 16:06:11 1997 by Nicolás Lichtmaier <nick@debian.org> .\" -.TH sysinfo 2 2023-10-31 "Linux man-pages 6.06" +.TH sysinfo 2 2023-10-31 "Linux man-pages 6.7" .SH NAME sysinfo \- return system information .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/syslog.2 b/upstream/fedora-rawhide/man2/syslog.2 index f544f935..a799c823 100644 --- a/upstream/fedora-rawhide/man2/syslog.2 +++ b/upstream/fedora-rawhide/man2/syslog.2 @@ -10,7 +10,7 @@ .\" 2008-02-15, Michael Kerrisk <mtk.manpages@gmail.com> .\" Update LOG_BUF_LEN details; update RETURN VALUE section. .\" -.TH syslog 2 2023-10-31 "Linux man-pages 6.06" +.TH syslog 2 2023-10-31 "Linux man-pages 6.7" .SH NAME syslog, klogctl \- read and/or clear kernel message ring buffer; set console_loglevel diff --git a/upstream/fedora-rawhide/man2/tee.2 b/upstream/fedora-rawhide/man2/tee.2 index 6dcb104b..e9ae11fb 100644 --- a/upstream/fedora-rawhide/man2/tee.2 +++ b/upstream/fedora-rawhide/man2/tee.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH tee 2 2023-10-31 "Linux man-pages 6.06" +.TH tee 2 2023-10-31 "Linux man-pages 6.7" .SH NAME tee \- duplicating pipe content .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/time.2 b/upstream/fedora-rawhide/man2/time.2 index d728fa44..5ac0bc49 100644 --- a/upstream/fedora-rawhide/man2/time.2 +++ b/upstream/fedora-rawhide/man2/time.2 @@ -6,7 +6,7 @@ .\" Modified Sat Jul 24 14:13:40 1993 by Rik Faith <faith@cs.unc.edu> .\" Additions by Joseph S. Myers <jsm28@cam.ac.uk>, 970909 .\" -.TH time 2 2023-11-11 "Linux man-pages 6.06" +.TH time 2 2023-11-11 "Linux man-pages 6.7" .SH NAME time \- get time in seconds .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/timer_create.2 b/upstream/fedora-rawhide/man2/timer_create.2 index 3afc36b5..44d505da 100644 --- a/upstream/fedora-rawhide/man2/timer_create.2 +++ b/upstream/fedora-rawhide/man2/timer_create.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH timer_create 2 2023-11-11 "Linux man-pages 6.06" +.TH timer_create 2 2023-11-11 "Linux man-pages 6.7" .SH NAME timer_create \- create a POSIX per-process timer .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/timer_delete.2 b/upstream/fedora-rawhide/man2/timer_delete.2 index 670e09d1..b08d7360 100644 --- a/upstream/fedora-rawhide/man2/timer_delete.2 +++ b/upstream/fedora-rawhide/man2/timer_delete.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH timer_delete 2 2023-10-31 "Linux man-pages 6.06" +.TH timer_delete 2 2023-10-31 "Linux man-pages 6.7" .SH NAME timer_delete \- delete a POSIX per-process timer .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/timer_getoverrun.2 b/upstream/fedora-rawhide/man2/timer_getoverrun.2 index 68b8b27b..0f136b6b 100644 --- a/upstream/fedora-rawhide/man2/timer_getoverrun.2 +++ b/upstream/fedora-rawhide/man2/timer_getoverrun.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH timer_getoverrun 2 2023-10-31 "Linux man-pages 6.06" +.TH timer_getoverrun 2 2023-10-31 "Linux man-pages 6.7" .SH NAME timer_getoverrun \- get overrun count for a POSIX per-process timer .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/timer_settime.2 b/upstream/fedora-rawhide/man2/timer_settime.2 index 064693ba..d222fe42 100644 --- a/upstream/fedora-rawhide/man2/timer_settime.2 +++ b/upstream/fedora-rawhide/man2/timer_settime.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH timer_settime 2 2023-10-31 "Linux man-pages 6.06" +.TH timer_settime 2 2023-10-31 "Linux man-pages 6.7" .SH NAME timer_settime, timer_gettime \- arm/disarm and fetch state of POSIX per-process timer diff --git a/upstream/fedora-rawhide/man2/timerfd_create.2 b/upstream/fedora-rawhide/man2/timerfd_create.2 index abd5e265..1d6a0d29 100644 --- a/upstream/fedora-rawhide/man2/timerfd_create.2 +++ b/upstream/fedora-rawhide/man2/timerfd_create.2 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH timerfd_create 2 2023-10-31 "Linux man-pages 6.06" +.TH timerfd_create 2 2023-10-31 "Linux man-pages 6.7" .SH NAME timerfd_create, timerfd_settime, timerfd_gettime \- timers that notify via file descriptors diff --git a/upstream/fedora-rawhide/man2/times.2 b/upstream/fedora-rawhide/man2/times.2 index fa853a7c..2dad5b53 100644 --- a/upstream/fedora-rawhide/man2/times.2 +++ b/upstream/fedora-rawhide/man2/times.2 @@ -15,7 +15,7 @@ .\" Added notes on nonstandard behavior: Linux allows 'buf' to .\" be NULL, but POSIX.1 doesn't specify this and it's nonportable. .\" -.TH times 2 2023-10-31 "Linux man-pages 6.06" +.TH times 2 2023-10-31 "Linux man-pages 6.7" .SH NAME times \- get process times .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/tkill.2 b/upstream/fedora-rawhide/man2/tkill.2 index 127ee7cc..78a1ce56 100644 --- a/upstream/fedora-rawhide/man2/tkill.2 +++ b/upstream/fedora-rawhide/man2/tkill.2 @@ -6,7 +6,7 @@ .\" 2004-05-31, added tgkill, ahu, aeb .\" 2008-01-15 mtk -- rewrote DESCRIPTION .\" -.TH tkill 2 2023-10-31 "Linux man-pages 6.06" +.TH tkill 2 2023-10-31 "Linux man-pages 6.7" .SH NAME tkill, tgkill \- send a signal to a thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/truncate.2 b/upstream/fedora-rawhide/man2/truncate.2 index 4107b7b3..13ebec02 100644 --- a/upstream/fedora-rawhide/man2/truncate.2 +++ b/upstream/fedora-rawhide/man2/truncate.2 @@ -12,7 +12,7 @@ .\" Modified 2002-04-06 by Andries Brouwer <aeb@cwi.nl> .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH truncate 2 2023-10-31 "Linux man-pages 6.06" +.TH truncate 2 2023-10-31 "Linux man-pages 6.7" .SH NAME truncate, ftruncate \- truncate a file to a specified length .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/umask.2 b/upstream/fedora-rawhide/man2/umask.2 index f031a3ff..bfea2e66 100644 --- a/upstream/fedora-rawhide/man2/umask.2 +++ b/upstream/fedora-rawhide/man2/umask.2 @@ -11,7 +11,7 @@ .\" <nick@debian.com> with Lars Wirzenius <liw@iki.fi> suggestion .\" 2006-05-13, mtk, substantial rewrite of description of 'mask' .\" 2008-01-09, mtk, a few rewrites and additions. -.TH umask 2 2023-10-31 "Linux man-pages 6.06" +.TH umask 2 2023-10-31 "Linux man-pages 6.7" .SH NAME umask \- set file mode creation mask .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/umount.2 b/upstream/fedora-rawhide/man2/umount.2 index 85a37b7d..07e3a938 100644 --- a/upstream/fedora-rawhide/man2/umount.2 +++ b/upstream/fedora-rawhide/man2/umount.2 @@ -7,7 +7,7 @@ .\" 2008-10-06, mtk: Created this as a new page by splitting .\" umount/umount2 material out of mount.2 .\" -.TH umount 2 2023-10-31 "Linux man-pages 6.06" +.TH umount 2 2023-10-31 "Linux man-pages 6.7" .SH NAME umount, umount2 \- unmount filesystem .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/uname.2 b/upstream/fedora-rawhide/man2/uname.2 index be0b1550..e4f449f2 100644 --- a/upstream/fedora-rawhide/man2/uname.2 +++ b/upstream/fedora-rawhide/man2/uname.2 @@ -4,7 +4,7 @@ .\" .\" 2007-07-05 mtk: Added details on underlying system call interfaces .\" -.TH uname 2 2023-10-31 "Linux man-pages 6.06" +.TH uname 2 2023-10-31 "Linux man-pages 6.7" .SH NAME uname \- get name and information about current kernel .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/unimplemented.2 b/upstream/fedora-rawhide/man2/unimplemented.2 index cbb61d3e..3daa030e 100644 --- a/upstream/fedora-rawhide/man2/unimplemented.2 +++ b/upstream/fedora-rawhide/man2/unimplemented.2 @@ -4,7 +4,7 @@ .\" .\" Updated, aeb, 980612 .\" -.TH UNIMPLEMENTED 2 2023-10-31 "Linux man-pages 6.06" +.TH UNIMPLEMENTED 2 2023-10-31 "Linux man-pages 6.7" .SH NAME afs_syscall, break, fattach, fdetach, ftime, getmsg, getpmsg, gtty, isastream, lock, madvise1, mpx, prof, profil, putmsg, putpmsg, security, diff --git a/upstream/fedora-rawhide/man2/unlink.2 b/upstream/fedora-rawhide/man2/unlink.2 index 3018bb10..7485a327 100644 --- a/upstream/fedora-rawhide/man2/unlink.2 +++ b/upstream/fedora-rawhide/man2/unlink.2 @@ -10,7 +10,7 @@ .\" Modified 2001-05-17 by aeb .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH unlink 2 2023-10-31 "Linux man-pages 6.06" +.TH unlink 2 2024-02-18 "Linux man-pages 6.7" .SH NAME unlink, unlinkat \- delete a name and possibly the file it refers to .SH LIBRARY @@ -117,7 +117,7 @@ on .IR pathname . If the .B AT_REMOVEDIR -flag is specified, then +flag is specified, it performs the equivalent of .BR rmdir (2) on diff --git a/upstream/fedora-rawhide/man2/unshare.2 b/upstream/fedora-rawhide/man2/unshare.2 index bbb15484..ce2464d0 100644 --- a/upstream/fedora-rawhide/man2/unshare.2 +++ b/upstream/fedora-rawhide/man2/unshare.2 @@ -15,7 +15,7 @@ .\" by clone, which would require porting and maintaining all commands .\" such as login, and su, that establish a user session. .\" -.TH unshare 2 2023-10-31 "Linux man-pages 6.06" +.TH unshare 2 2023-10-31 "Linux man-pages 6.7" .SH NAME unshare \- disassociate parts of the process execution context .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/uselib.2 b/upstream/fedora-rawhide/man2/uselib.2 index b8f0d307..cdd7fbab 100644 --- a/upstream/fedora-rawhide/man2/uselib.2 +++ b/upstream/fedora-rawhide/man2/uselib.2 @@ -8,7 +8,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2005-01-09 by aeb .\" -.TH uselib 2 2023-10-31 "Linux man-pages 6.06" +.TH uselib 2 2023-10-31 "Linux man-pages 6.7" .SH NAME uselib \- load shared library .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man2/userfaultfd.2 b/upstream/fedora-rawhide/man2/userfaultfd.2 index c1f60cb3..27f4b694 100644 --- a/upstream/fedora-rawhide/man2/userfaultfd.2 +++ b/upstream/fedora-rawhide/man2/userfaultfd.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH userfaultfd 2 2024-02-12 "Linux man-pages 6.06" +.TH userfaultfd 2 2024-02-12 "Linux man-pages 6.7" .SH NAME userfaultfd \- create a file descriptor for handling page faults in user space .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/ustat.2 b/upstream/fedora-rawhide/man2/ustat.2 index f7a8c648..6a682d72 100644 --- a/upstream/fedora-rawhide/man2/ustat.2 +++ b/upstream/fedora-rawhide/man2/ustat.2 @@ -7,7 +7,7 @@ .\" Modified 2001-03-22 by aeb .\" Modified 2003-08-04 by aeb .\" -.TH ustat 2 2023-10-31 "Linux man-pages 6.06" +.TH ustat 2 2023-10-31 "Linux man-pages 6.7" .SH NAME ustat \- get filesystem statistics .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/utime.2 b/upstream/fedora-rawhide/man2/utime.2 index 7ba1a396..51073d06 100644 --- a/upstream/fedora-rawhide/man2/utime.2 +++ b/upstream/fedora-rawhide/man2/utime.2 @@ -8,7 +8,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" Modified 2004-10-10 by Andries Brouwer <aeb@cwi.nl> .\" -.TH utime 2 2023-10-31 "Linux man-pages 6.06" +.TH utime 2 2023-10-31 "Linux man-pages 6.7" .SH NAME utime, utimes \- change file last access and modification times .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/utimensat.2 b/upstream/fedora-rawhide/man2/utimensat.2 index a91e5915..d69539d2 100644 --- a/upstream/fedora-rawhide/man2/utimensat.2 +++ b/upstream/fedora-rawhide/man2/utimensat.2 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH utimensat 2 2024-01-01 "Linux man-pages 6.06" +.TH utimensat 2 2024-01-01 "Linux man-pages 6.7" .SH NAME utimensat, futimens \- change file timestamps with nanosecond precision .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/vfork.2 b/upstream/fedora-rawhide/man2/vfork.2 index 6175ea1c..5d523ada 100644 --- a/upstream/fedora-rawhide/man2/vfork.2 +++ b/upstream/fedora-rawhide/man2/vfork.2 @@ -6,7 +6,7 @@ .\" 1999-11-10: Merged text taken from the page contributed by .\" Reed H. Petty (rhp@draper.net) .\" -.TH vfork 2 2023-10-31 "Linux man-pages 6.06" +.TH vfork 2 2023-10-31 "Linux man-pages 6.7" .SH NAME vfork \- create a child process and block parent .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/vhangup.2 b/upstream/fedora-rawhide/man2/vhangup.2 index 31612479..ed422b63 100644 --- a/upstream/fedora-rawhide/man2/vhangup.2 +++ b/upstream/fedora-rawhide/man2/vhangup.2 @@ -5,7 +5,7 @@ .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on capability requirements .\" -.TH vhangup 2 2023-10-31 "Linux man-pages 6.06" +.TH vhangup 2 2023-10-31 "Linux man-pages 6.7" .SH NAME vhangup \- virtually hangup the current terminal .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/vm86.2 b/upstream/fedora-rawhide/man2/vm86.2 index 93747159..fba11673 100644 --- a/upstream/fedora-rawhide/man2/vm86.2 +++ b/upstream/fedora-rawhide/man2/vm86.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH vm86 2 2023-10-31 "Linux man-pages 6.06" +.TH vm86 2 2023-10-31 "Linux man-pages 6.7" .SH NAME vm86old, vm86 \- enter virtual 8086 mode .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/vmsplice.2 b/upstream/fedora-rawhide/man2/vmsplice.2 index 81a6d2f1..ccbf2c63 100644 --- a/upstream/fedora-rawhide/man2/vmsplice.2 +++ b/upstream/fedora-rawhide/man2/vmsplice.2 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH vmsplice 2 2023-10-31 "Linux man-pages 6.06" +.TH vmsplice 2 2023-10-31 "Linux man-pages 6.7" .SH NAME vmsplice \- splice user pages to/from a pipe .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/wait.2 b/upstream/fedora-rawhide/man2/wait.2 index f9d519d5..e15ca879 100644 --- a/upstream/fedora-rawhide/man2/wait.2 +++ b/upstream/fedora-rawhide/man2/wait.2 @@ -26,7 +26,7 @@ .\" 2005-05-10, mtk, __W* flags can't be used with waitid() .\" 2008-07-04, mtk, removed erroneous text about SA_NOCLDSTOP .\" -.TH wait 2 2023-10-31 "Linux man-pages 6.06" +.TH wait 2 2023-10-31 "Linux man-pages 6.7" .SH NAME wait, waitpid, waitid \- wait for process to change state .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/wait4.2 b/upstream/fedora-rawhide/man2/wait4.2 index 2772ebd7..8e0798a8 100644 --- a/upstream/fedora-rawhide/man2/wait4.2 +++ b/upstream/fedora-rawhide/man2/wait4.2 @@ -10,7 +10,7 @@ .\" Rewrote much of this page, and removed much duplicated text, .\" replacing with pointers to wait.2 .\" -.TH wait4 2 2023-10-31 "Linux man-pages 6.06" +.TH wait4 2 2023-10-31 "Linux man-pages 6.7" .SH NAME wait3, wait4 \- wait for process to change state, BSD style .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2/write.2 b/upstream/fedora-rawhide/man2/write.2 index b94305e1..fc22ae35 100644 --- a/upstream/fedora-rawhide/man2/write.2 +++ b/upstream/fedora-rawhide/man2/write.2 @@ -16,7 +16,7 @@ .\" gave some examples of why this might occur. .\" Noted what happens if write() is interrupted by a signal. .\" -.TH write 2 2023-10-31 "Linux man-pages 6.06" +.TH write 2 2023-10-31 "Linux man-pages 6.7" .SH NAME write \- write to a file descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man2type/open_how.2type b/upstream/fedora-rawhide/man2type/open_how.2type index 8f658461..869f18a0 100644 --- a/upstream/fedora-rawhide/man2type/open_how.2type +++ b/upstream/fedora-rawhide/man2type/open_how.2type @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH open_how 2type 2023-10-31 "Linux man-pages 6.06" +.TH open_how 2type 2023-10-31 "Linux man-pages 6.7" .SH NAME open_how \- how to open a pathname .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/CPU_SET.3 b/upstream/fedora-rawhide/man3/CPU_SET.3 index 9f3c9a72..6c13a62c 100644 --- a/upstream/fedora-rawhide/man3/CPU_SET.3 +++ b/upstream/fedora-rawhide/man3/CPU_SET.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH CPU_SET 3 2023-10-31 "Linux man-pages 6.06" +.TH CPU_SET 3 2023-10-31 "Linux man-pages 6.7" .SH NAME CPU_SET, CPU_CLR, CPU_ISSET, CPU_ZERO, CPU_COUNT, CPU_AND, CPU_OR, CPU_XOR, CPU_EQUAL, diff --git a/upstream/fedora-rawhide/man3/INFINITY.3 b/upstream/fedora-rawhide/man3/INFINITY.3 index 9c5f2b0c..0f8eab06 100644 --- a/upstream/fedora-rawhide/man3/INFINITY.3 +++ b/upstream/fedora-rawhide/man3/INFINITY.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH INFINITY 3 2023-10-31 "Linux man-pages 6.06" +.TH INFINITY 3 2023-10-31 "Linux man-pages 6.7" .SH NAME INFINITY, NAN, HUGE_VAL, HUGE_VALF, HUGE_VALL \- floating-point constants .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/MAX.3 b/upstream/fedora-rawhide/man3/MAX.3 index c02c9b6c..de466148 100644 --- a/upstream/fedora-rawhide/man3/MAX.3 +++ b/upstream/fedora-rawhide/man3/MAX.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH MAX 3 2023-10-31 "Linux man-pages 6.06" +.TH MAX 3 2023-10-31 "Linux man-pages 6.7" .SH NAME MAX, MIN \- maximum or minimum of two values .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/MB_CUR_MAX.3 b/upstream/fedora-rawhide/man3/MB_CUR_MAX.3 index a9a709be..9aa20895 100644 --- a/upstream/fedora-rawhide/man3/MB_CUR_MAX.3 +++ b/upstream/fedora-rawhide/man3/MB_CUR_MAX.3 @@ -9,7 +9,7 @@ .\" .\" Modified, aeb, 990824 .\" -.TH MB_CUR_MAX 3 2023-03-30 "Linux man-pages 6.06" +.TH MB_CUR_MAX 3 2023-03-30 "Linux man-pages 6.7" .SH NAME MB_CUR_MAX \- maximum length of a multibyte character in the current locale .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/MB_LEN_MAX.3 b/upstream/fedora-rawhide/man3/MB_LEN_MAX.3 index 77b3a296..3c56b44e 100644 --- a/upstream/fedora-rawhide/man3/MB_LEN_MAX.3 +++ b/upstream/fedora-rawhide/man3/MB_LEN_MAX.3 @@ -9,7 +9,7 @@ .\" .\" Modified, aeb, 990824 .\" -.TH MB_LEN_MAX 3 2023-03-30 "Linux man-pages 6.06" +.TH MB_LEN_MAX 3 2023-03-30 "Linux man-pages 6.7" .SH NAME MB_LEN_MAX \- maximum multibyte length of a character across all locales .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/TIMEVAL_TO_TIMESPEC.3 b/upstream/fedora-rawhide/man3/TIMEVAL_TO_TIMESPEC.3 new file mode 100644 index 00000000..9559a52d --- /dev/null +++ b/upstream/fedora-rawhide/man3/TIMEVAL_TO_TIMESPEC.3 @@ -0,0 +1,32 @@ +.\" Copyright (C) 2024 Alejandro Colomar <alx@kernel.org> +.\" +.\" SPDX-License-Identifier: Linux-man-pages-copyleft +.\" +.TH TIMEVAL_TO_TIMESPEC 3 2024-03-12 "Linux man-pages 6.7" +.SH NAME +TIMEVAL_TO_TIMESPEC, +TIMESPEC_TO_TIMEVAL +\- +convert between time structures +.SH SYNOPSIS +.nf +.B #define _GNU_SOURCE +.B #include <sys/time.h> +.P +.BI "void TIMEVAL_TO_TIMESPEC(const struct timeval *" tv ", struct timespec *" ts ); +.BI "void TIMESPEC_TO_TIMEVAL(struct timeval *" tv ", const struct timespec *" ts ); +.fi +.SH DESCRIPTION +These macros convert from a +.BR timeval (3type) +to a +.BR timespec (3type) +structure, +and vice versa, +respectively. +.P +This is especially useful for writing interfaces that receive a type, +but are implemented with calls to functions that receive the other one. +.SH STANDARDS +GNU, +BSD. diff --git a/upstream/fedora-rawhide/man3/_Generic.3 b/upstream/fedora-rawhide/man3/_Generic.3 index 04bd618e..b9bb0264 100644 --- a/upstream/fedora-rawhide/man3/_Generic.3 +++ b/upstream/fedora-rawhide/man3/_Generic.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH _Generic 3 2023-10-31 "Linux man-pages 6.06" +.TH _Generic 3 2023-10-31 "Linux man-pages 6.7" .SH NAME _Generic \- type-generic selection .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man3/__ppc_get_timebase.3 b/upstream/fedora-rawhide/man3/__ppc_get_timebase.3 index 9604c93d..29337873 100644 --- a/upstream/fedora-rawhide/man3/__ppc_get_timebase.3 +++ b/upstream/fedora-rawhide/man3/__ppc_get_timebase.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH __ppc_get_timebase 3 2023-10-31 "Linux man-pages 6.06" +.TH __ppc_get_timebase 3 2023-10-31 "Linux man-pages 6.7" .SH NAME __ppc_get_timebase, __ppc_get_timebase_freq \- get the current value of the Time Base Register on Power architecture and its frequency. diff --git a/upstream/fedora-rawhide/man3/__ppc_set_ppr_med.3 b/upstream/fedora-rawhide/man3/__ppc_set_ppr_med.3 index e0e9649e..6c2e692e 100644 --- a/upstream/fedora-rawhide/man3/__ppc_set_ppr_med.3 +++ b/upstream/fedora-rawhide/man3/__ppc_set_ppr_med.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH __ppc_set_ppr_med 3 2023-10-31 "Linux man-pages 6.06" +.TH __ppc_set_ppr_med 3 2023-10-31 "Linux man-pages 6.7" Programmer's Manual" .SH NAME __ppc_set_ppr_med, __ppc_set_ppr_very_low, __ppc_set_ppr_low, diff --git a/upstream/fedora-rawhide/man3/__ppc_yield.3 b/upstream/fedora-rawhide/man3/__ppc_yield.3 index f8b9ad12..c98a74fa 100644 --- a/upstream/fedora-rawhide/man3/__ppc_yield.3 +++ b/upstream/fedora-rawhide/man3/__ppc_yield.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH __ppc_yield 3 2023-10-31 "Linux man-pages 6.06" +.TH __ppc_yield 3 2023-10-31 "Linux man-pages 6.7" .SH NAME __ppc_yield, __ppc_mdoio, __ppc_mdoom \- Hint the processor to release shared resources diff --git a/upstream/fedora-rawhide/man3/__setfpucw.3 b/upstream/fedora-rawhide/man3/__setfpucw.3 index d132953c..22962689 100644 --- a/upstream/fedora-rawhide/man3/__setfpucw.3 +++ b/upstream/fedora-rawhide/man3/__setfpucw.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH __setfpucw 3 2023-10-31 "Linux man-pages 6.06" +.TH __setfpucw 3 2023-10-31 "Linux man-pages 6.7" .SH NAME __setfpucw \- set FPU control word on i386 architecture (obsolete) .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/a64l.3 b/upstream/fedora-rawhide/man3/a64l.3 index c0bbcbc5..228c259d 100644 --- a/upstream/fedora-rawhide/man3/a64l.3 +++ b/upstream/fedora-rawhide/man3/a64l.3 @@ -6,7 +6,7 @@ .\" .\" Corrected, aeb, 2002-05-30 .\" -.TH a64l 3 2023-10-31 "Linux man-pages 6.06" +.TH a64l 3 2023-10-31 "Linux man-pages 6.7" .SH NAME a64l, l64a \- convert between long and base-64 .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/abort.3 b/upstream/fedora-rawhide/man3/abort.3 index 048b30c5..75f47bd0 100644 --- a/upstream/fedora-rawhide/man3/abort.3 +++ b/upstream/fedora-rawhide/man3/abort.3 @@ -12,7 +12,7 @@ .\" Modified Fri Aug 4 10:51:53 2000 - patch from Joseph S. Myers .\" 2007-12-15, mtk, Mostly rewritten .\" -.TH abort 3 2023-10-31 "Linux man-pages 6.06" +.TH abort 3 2023-10-31 "Linux man-pages 6.7" .SH NAME abort \- cause abnormal process termination .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/abs.3 b/upstream/fedora-rawhide/man3/abs.3 index 04383b48..6492c6b7 100644 --- a/upstream/fedora-rawhide/man3/abs.3 +++ b/upstream/fedora-rawhide/man3/abs.3 @@ -12,7 +12,7 @@ .\" Modified Sat Jul 24 21:45:37 1993, Rik Faith (faith@cs.unc.edu) .\" Modified Sat Dec 16 15:02:59 2000, Joseph S. Myers .\" -.TH abs 3 2023-10-31 "Linux man-pages 6.06" +.TH abs 3 2023-10-31 "Linux man-pages 6.7" .SH NAME abs, labs, llabs, imaxabs \- compute the absolute value of an integer .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/acos.3 b/upstream/fedora-rawhide/man3/acos.3 index 8630053e..b67d1cd9 100644 --- a/upstream/fedora-rawhide/man3/acos.3 +++ b/upstream/fedora-rawhide/man3/acos.3 @@ -13,7 +13,7 @@ .\" Modified 2002-07-25 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH acos 3 2023-10-31 "Linux man-pages 6.06" +.TH acos 3 2023-10-31 "Linux man-pages 6.7" .SH NAME acos, acosf, acosl \- arc cosine function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/acosh.3 b/upstream/fedora-rawhide/man3/acosh.3 index 97be4bfc..0c8963dc 100644 --- a/upstream/fedora-rawhide/man3/acosh.3 +++ b/upstream/fedora-rawhide/man3/acosh.3 @@ -13,7 +13,7 @@ .\" Modified 2002-07-25 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH acosh 3 2023-10-31 "Linux man-pages 6.06" +.TH acosh 3 2023-10-31 "Linux man-pages 6.7" .SH NAME acosh, acoshf, acoshl \- inverse hyperbolic cosine function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/addseverity.3 b/upstream/fedora-rawhide/man3/addseverity.3 index a634bdab..9f430e6d 100644 --- a/upstream/fedora-rawhide/man3/addseverity.3 +++ b/upstream/fedora-rawhide/man3/addseverity.3 @@ -5,7 +5,7 @@ .\" adapted glibc info page .\" .\" polished a little, aeb -.TH addseverity 3 2023-10-31 "Linux man-pages 6.06" +.TH addseverity 3 2023-10-31 "Linux man-pages 6.7" .SH NAME addseverity \- introduce new severity classes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/adjtime.3 b/upstream/fedora-rawhide/man3/adjtime.3 index a73ea605..a6fcce52 100644 --- a/upstream/fedora-rawhide/man3/adjtime.3 +++ b/upstream/fedora-rawhide/man3/adjtime.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH adjtime 3 2024-01-28 "Linux man-pages 6.06" +.TH adjtime 3 2024-01-28 "Linux man-pages 6.7" .SH NAME adjtime \- correct the time to synchronize the system clock .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/aio_cancel.3 b/upstream/fedora-rawhide/man3/aio_cancel.3 index 34ec553e..1125669a 100644 --- a/upstream/fedora-rawhide/man3/aio_cancel.3 +++ b/upstream/fedora-rawhide/man3/aio_cancel.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH aio_cancel 3 2023-10-31 "Linux man-pages 6.06" +.TH aio_cancel 3 2023-10-31 "Linux man-pages 6.7" .SH NAME aio_cancel \- cancel an outstanding asynchronous I/O request .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/aio_error.3 b/upstream/fedora-rawhide/man3/aio_error.3 index fb3818ae..9f8bf8cc 100644 --- a/upstream/fedora-rawhide/man3/aio_error.3 +++ b/upstream/fedora-rawhide/man3/aio_error.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH aio_error 3 2023-10-31 "Linux man-pages 6.06" +.TH aio_error 3 2023-10-31 "Linux man-pages 6.7" .SH NAME aio_error \- get error status of asynchronous I/O operation .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/aio_fsync.3 b/upstream/fedora-rawhide/man3/aio_fsync.3 index 0ec0e829..4246c565 100644 --- a/upstream/fedora-rawhide/man3/aio_fsync.3 +++ b/upstream/fedora-rawhide/man3/aio_fsync.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH aio_fsync 3 2023-10-31 "Linux man-pages 6.06" +.TH aio_fsync 3 2023-10-31 "Linux man-pages 6.7" .SH NAME aio_fsync \- asynchronous file synchronization .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/aio_init.3 b/upstream/fedora-rawhide/man3/aio_init.3 index 23fe15f4..2e43d032 100644 --- a/upstream/fedora-rawhide/man3/aio_init.3 +++ b/upstream/fedora-rawhide/man3/aio_init.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH aio_init 3 2023-10-31 "Linux man-pages 6.06" +.TH aio_init 3 2023-10-31 "Linux man-pages 6.7" .SH NAME aio_init \- asynchronous I/O initialization .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/aio_read.3 b/upstream/fedora-rawhide/man3/aio_read.3 index 5af8717e..49de8f86 100644 --- a/upstream/fedora-rawhide/man3/aio_read.3 +++ b/upstream/fedora-rawhide/man3/aio_read.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH aio_read 3 2023-10-31 "Linux man-pages 6.06" +.TH aio_read 3 2023-10-31 "Linux man-pages 6.7" .SH NAME aio_read \- asynchronous read .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/aio_return.3 b/upstream/fedora-rawhide/man3/aio_return.3 index f4e0d5aa..1993d047 100644 --- a/upstream/fedora-rawhide/man3/aio_return.3 +++ b/upstream/fedora-rawhide/man3/aio_return.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH aio_return 3 2023-10-31 "Linux man-pages 6.06" +.TH aio_return 3 2023-10-31 "Linux man-pages 6.7" .SH NAME aio_return \- get return status of asynchronous I/O operation .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/aio_suspend.3 b/upstream/fedora-rawhide/man3/aio_suspend.3 index d9ecfdcd..c8f606eb 100644 --- a/upstream/fedora-rawhide/man3/aio_suspend.3 +++ b/upstream/fedora-rawhide/man3/aio_suspend.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH aio_suspend 3 2023-10-31 "Linux man-pages 6.06" +.TH aio_suspend 3 2023-10-31 "Linux man-pages 6.7" .SH NAME aio_suspend \- wait for asynchronous I/O operation or timeout .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/aio_write.3 b/upstream/fedora-rawhide/man3/aio_write.3 index e1d70a7b..eaba4571 100644 --- a/upstream/fedora-rawhide/man3/aio_write.3 +++ b/upstream/fedora-rawhide/man3/aio_write.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH aio_write 3 2023-10-31 "Linux man-pages 6.06" +.TH aio_write 3 2023-10-31 "Linux man-pages 6.7" .SH NAME aio_write \- asynchronous write .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/alloca.3 b/upstream/fedora-rawhide/man3/alloca.3 index c49b525f..7fa61bc2 100644 --- a/upstream/fedora-rawhide/man3/alloca.3 +++ b/upstream/fedora-rawhide/man3/alloca.3 @@ -13,7 +13,7 @@ .\" Various rewrites and additions (notes on longjmp() and SIGSEGV). .\" Weaken warning against use of alloca() (as per Debian bug 461100). .\" -.TH alloca 3 2023-10-31 "Linux man-pages 6.06" +.TH alloca 3 2023-10-31 "Linux man-pages 6.7" .SH NAME alloca \- allocate memory that is automatically freed .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/arc4random.3 b/upstream/fedora-rawhide/man3/arc4random.3 index 3b467bb9..b205ca9b 100644 --- a/upstream/fedora-rawhide/man3/arc4random.3 +++ b/upstream/fedora-rawhide/man3/arc4random.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH arc4random 3 2023-10-31 "Linux man-pages 6.06" +.TH arc4random 3 2023-10-31 "Linux man-pages 6.7" .SH NAME arc4random, arc4random_uniform, arc4random_buf \- cryptographically-secure pseudorandom number generator diff --git a/upstream/fedora-rawhide/man3/argz_add.3 b/upstream/fedora-rawhide/man3/argz_add.3 index ca7f2a35..c61705a4 100644 --- a/upstream/fedora-rawhide/man3/argz_add.3 +++ b/upstream/fedora-rawhide/man3/argz_add.3 @@ -6,7 +6,7 @@ .\" based on the description in glibc source and infopages .\" .\" Corrections and additions, aeb -.TH argz_add 3 2023-10-31 "Linux man-pages 6.06" +.TH argz_add 3 2023-10-31 "Linux man-pages 6.7" .SH NAME argz_add, argz_add_sep, argz_append, argz_count, argz_create, argz_create_sep, argz_delete, argz_extract, argz_insert, diff --git a/upstream/fedora-rawhide/man3/asin.3 b/upstream/fedora-rawhide/man3/asin.3 index 4c730eea..3545d5c2 100644 --- a/upstream/fedora-rawhide/man3/asin.3 +++ b/upstream/fedora-rawhide/man3/asin.3 @@ -13,7 +13,7 @@ .\" Modified 2002-07-25 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH asin 3 2023-10-31 "Linux man-pages 6.06" +.TH asin 3 2023-10-31 "Linux man-pages 6.7" .SH NAME asin, asinf, asinl \- arc sine function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/asinh.3 b/upstream/fedora-rawhide/man3/asinh.3 index 9b4d0067..dd0ada06 100644 --- a/upstream/fedora-rawhide/man3/asinh.3 +++ b/upstream/fedora-rawhide/man3/asinh.3 @@ -13,7 +13,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH asinh 3 2023-10-31 "Linux man-pages 6.06" +.TH asinh 3 2023-10-31 "Linux man-pages 6.7" .SH NAME asinh, asinhf, asinhl \- inverse hyperbolic sine function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/asprintf.3 b/upstream/fedora-rawhide/man3/asprintf.3 index 4d57ce45..40b687b0 100644 --- a/upstream/fedora-rawhide/man3/asprintf.3 +++ b/upstream/fedora-rawhide/man3/asprintf.3 @@ -5,7 +5,7 @@ .\" .\" Text fragments inspired by Martin Schulze <joey@infodrom.org>. .\" -.TH asprintf 3 2023-10-31 "Linux man-pages 6.06" +.TH asprintf 3 2023-10-31 "Linux man-pages 6.7" .SH NAME asprintf, vasprintf \- print to allocated string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/assert.3 b/upstream/fedora-rawhide/man3/assert.3 index 68b23dc9..6f5a242c 100644 --- a/upstream/fedora-rawhide/man3/assert.3 +++ b/upstream/fedora-rawhide/man3/assert.3 @@ -6,7 +6,7 @@ .\" Modified Sat Jul 24 21:42:42 1993 by Rik Faith <faith@cs.unc.edu> .\" Modified Tue Oct 22 23:44:11 1996 by Eric S. Raymond <esr@thyrsus.com> .\" Modified Thu Jun 2 23:44:11 2016 by Nikos Mavrogiannopoulos <nmav@redhat.com> -.TH assert 3 2023-10-31 "Linux man-pages 6.06" +.TH assert 3 2023-10-31 "Linux man-pages 6.7" .SH NAME assert \- abort the program if assertion is false .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/assert_perror.3 b/upstream/fedora-rawhide/man3/assert_perror.3 index 09fbc927..cde80242 100644 --- a/upstream/fedora-rawhide/man3/assert_perror.3 +++ b/upstream/fedora-rawhide/man3/assert_perror.3 @@ -6,7 +6,7 @@ .\" This replaces an earlier man page written by Walter Harms .\" <walter.harms@informatik.uni-oldenburg.de>. .\" -.TH assert_perror 3 2023-10-31 "Linux man-pages 6.06" +.TH assert_perror 3 2023-10-31 "Linux man-pages 6.7" .SH NAME assert_perror \- test errnum and abort .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/atan.3 b/upstream/fedora-rawhide/man3/atan.3 index 5b923469..8e866981 100644 --- a/upstream/fedora-rawhide/man3/atan.3 +++ b/upstream/fedora-rawhide/man3/atan.3 @@ -13,7 +13,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH atan 3 2023-10-31 "Linux man-pages 6.06" +.TH atan 3 2023-10-31 "Linux man-pages 6.7" .SH NAME atan, atanf, atanl \- arc tangent function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/atan2.3 b/upstream/fedora-rawhide/man3/atan2.3 index cb71d13c..9ac661b4 100644 --- a/upstream/fedora-rawhide/man3/atan2.3 +++ b/upstream/fedora-rawhide/man3/atan2.3 @@ -13,7 +13,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH atan2 3 2023-10-31 "Linux man-pages 6.06" +.TH atan2 3 2023-10-31 "Linux man-pages 6.7" .SH NAME atan2, atan2f, atan2l \- arc tangent function of two variables .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/atanh.3 b/upstream/fedora-rawhide/man3/atanh.3 index eeed72d4..02204930 100644 --- a/upstream/fedora-rawhide/man3/atanh.3 +++ b/upstream/fedora-rawhide/man3/atanh.3 @@ -13,7 +13,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH atanh 3 2023-10-31 "Linux man-pages 6.06" +.TH atanh 3 2023-10-31 "Linux man-pages 6.7" .SH NAME atanh, atanhf, atanhl \- inverse hyperbolic tangent function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/atexit.3 b/upstream/fedora-rawhide/man3/atexit.3 index b490dc20..4a9842b1 100644 --- a/upstream/fedora-rawhide/man3/atexit.3 +++ b/upstream/fedora-rawhide/man3/atexit.3 @@ -11,7 +11,7 @@ .\" Modified 1993-07-24, Rik Faith (faith@cs.unc.edu) .\" Modified 2003-10-25, Walter Harms .\" -.TH atexit 3 2023-10-31 "Linux man-pages 6.06" +.TH atexit 3 2023-10-31 "Linux man-pages 6.7" .SH NAME atexit \- register a function to be called at normal process termination .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/atof.3 b/upstream/fedora-rawhide/man3/atof.3 index f07a33c6..acb75ae3 100644 --- a/upstream/fedora-rawhide/man3/atof.3 +++ b/upstream/fedora-rawhide/man3/atof.3 @@ -9,7 +9,7 @@ .\" 386BSD man pages .\" Modified Mon Mar 29 22:39:24 1993, David Metcalfe .\" Modified Sat Jul 24 21:39:22 1993, Rik Faith (faith@cs.unc.edu) -.TH atof 3 2023-10-31 "Linux man-pages 6.06" +.TH atof 3 2023-10-31 "Linux man-pages 6.7" .SH NAME atof \- convert a string to a double .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/atoi.3 b/upstream/fedora-rawhide/man3/atoi.3 index e1cf820d..ebe67f3f 100644 --- a/upstream/fedora-rawhide/man3/atoi.3 +++ b/upstream/fedora-rawhide/man3/atoi.3 @@ -11,7 +11,7 @@ .\" Modified Sat Jul 24 21:38:42 1993, Rik Faith (faith@cs.unc.edu) .\" Modified Sun Dec 17 18:35:06 2000, Joseph S. Myers .\" -.TH atoi 3 2023-10-31 "Linux man-pages 6.06" +.TH atoi 3 2023-10-31 "Linux man-pages 6.7" .SH NAME atoi, atol, atoll \- convert a string to an integer .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/backtrace.3 b/upstream/fedora-rawhide/man3/backtrace.3 index 3160a05c..399b1809 100644 --- a/upstream/fedora-rawhide/man3/backtrace.3 +++ b/upstream/fedora-rawhide/man3/backtrace.3 @@ -25,7 +25,7 @@ .\" .\" References: .\" glibc manual and source -.TH backtrace 3 2023-10-31 "Linux man-pages 6.06" +.TH backtrace 3 2023-10-31 "Linux man-pages 6.7" .SH NAME backtrace, backtrace_symbols, backtrace_symbols_fd \- support for application self-debugging diff --git a/upstream/fedora-rawhide/man3/basename.3 b/upstream/fedora-rawhide/man3/basename.3 index 3bb4c436..a3dc0752 100644 --- a/upstream/fedora-rawhide/man3/basename.3 +++ b/upstream/fedora-rawhide/man3/basename.3 @@ -5,7 +5,7 @@ .\" .\" Created, 14 Dec 2000 by Michael Kerrisk .\" -.TH basename 3 2023-10-31 "Linux man-pages 6.06" +.TH basename 3 2023-10-31 "Linux man-pages 6.7" .SH NAME basename, dirname \- parse pathname components .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/bcmp.3 b/upstream/fedora-rawhide/man3/bcmp.3 index 2de47ac0..ef96d9ce 100644 --- a/upstream/fedora-rawhide/man3/bcmp.3 +++ b/upstream/fedora-rawhide/man3/bcmp.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH bcmp 3 2023-11-02 "Linux man-pages 6.06" +.TH bcmp 3 2023-11-02 "Linux man-pages 6.7" .SH NAME bcmp \- compare byte sequences .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/bcopy.3 b/upstream/fedora-rawhide/man3/bcopy.3 index 3ed9c31c..7f76812e 100644 --- a/upstream/fedora-rawhide/man3/bcopy.3 +++ b/upstream/fedora-rawhide/man3/bcopy.3 @@ -11,7 +11,7 @@ .\" Modified Sun Feb 26 14:52:00 1995 by Rik Faith <faith@cs.unc.edu> .\" Modified Tue Oct 22 23:48:10 1996 by Eric S. Raymond <esr@thyrsus.com> .\" " -.TH bcopy 3 2023-10-31 "Linux man-pages 6.06" +.TH bcopy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME bcopy \- copy byte sequence .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/bind_textdomain_codeset.3 b/upstream/fedora-rawhide/man3/bind_textdomain_codeset.3 index 5414339b..80810932 100644 --- a/upstream/fedora-rawhide/man3/bind_textdomain_codeset.3 +++ b/upstream/fedora-rawhide/man3/bind_textdomain_codeset.3 @@ -10,7 +10,7 @@ .\" GNU gettext source code and manual .\" LI18NUX 2000 Globalization Specification .\" -.TH BIND_TEXTDOMAIN_CODESET 3 "May 2001" "GNU gettext 0.22.2" +.TH BIND_TEXTDOMAIN_CODESET 3 "May 2001" "GNU gettext 0.22.5" .SH NAME bind_textdomain_codeset \- set encoding of message translations .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man3/bindresvport.3 b/upstream/fedora-rawhide/man3/bindresvport.3 index 7b33d289..89cd5d0b 100644 --- a/upstream/fedora-rawhide/man3/bindresvport.3 +++ b/upstream/fedora-rawhide/man3/bindresvport.3 @@ -8,7 +8,7 @@ .\" 2007-05-31, mtk: Rewrite and substantial additional text. .\" 2008-12-03, mtk: Rewrote some pieces and fixed some errors .\" -.TH bindresvport 3 2023-10-31 "Linux man-pages 6.06" +.TH bindresvport 3 2023-10-31 "Linux man-pages 6.7" .SH NAME bindresvport \- bind a socket to a privileged IP port .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/bindtextdomain.3 b/upstream/fedora-rawhide/man3/bindtextdomain.3 index 03589b56..b6fe8701 100644 --- a/upstream/fedora-rawhide/man3/bindtextdomain.3 +++ b/upstream/fedora-rawhide/man3/bindtextdomain.3 @@ -10,7 +10,7 @@ .\" GNU gettext source code and manual .\" LI18NUX 2000 Globalization Specification .\" -.TH BINDTEXTDOMAIN 3 "May 2001" "GNU gettext 0.22.2" +.TH BINDTEXTDOMAIN 3 "May 2001" "GNU gettext 0.22.5" .SH NAME bindtextdomain \- set directory containing message catalogs .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man3/bsd_signal.3 b/upstream/fedora-rawhide/man3/bsd_signal.3 index 89a5d557..19c21474 100644 --- a/upstream/fedora-rawhide/man3/bsd_signal.3 +++ b/upstream/fedora-rawhide/man3/bsd_signal.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH bsd_signal 3 2023-10-31 "Linux man-pages 6.06" +.TH bsd_signal 3 2023-10-31 "Linux man-pages 6.7" .SH NAME bsd_signal \- signal handling with BSD semantics .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/bsearch.3 b/upstream/fedora-rawhide/man3/bsearch.3 index 2f0a16ea..38a4ac31 100644 --- a/upstream/fedora-rawhide/man3/bsearch.3 +++ b/upstream/fedora-rawhide/man3/bsearch.3 @@ -9,7 +9,7 @@ .\" 386BSD man pages .\" Modified Mon Mar 29 22:41:16 1993, David Metcalfe .\" Modified Sat Jul 24 21:35:16 1993, Rik Faith (faith@cs.unc.edu) -.TH bsearch 3 2023-10-31 "Linux man-pages 6.06" +.TH bsearch 3 2023-10-31 "Linux man-pages 6.7" .SH NAME bsearch \- binary search of a sorted array .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/bstring.3 b/upstream/fedora-rawhide/man3/bstring.3 index 40f1b96b..68e8ae72 100644 --- a/upstream/fedora-rawhide/man3/bstring.3 +++ b/upstream/fedora-rawhide/man3/bstring.3 @@ -9,7 +9,7 @@ .\" Modified 1993-04-12, David Metcalfe .\" Modified 1993-07-24, Rik Faith (faith@cs.unc.edu) .\" Modified 2002-01-20, Walter Harms -.TH bstring 3 2023-10-31 "Linux man-pages 6.06" +.TH bstring 3 2023-10-31 "Linux man-pages 6.7" .SH NAME bcmp, bcopy, bzero, memccpy, memchr, memcmp, memcpy, memfrob, memmem, memmove, memset \- byte string operations diff --git a/upstream/fedora-rawhide/man3/bswap.3 b/upstream/fedora-rawhide/man3/bswap.3 index 8c2b8ea5..53d8c51e 100644 --- a/upstream/fedora-rawhide/man3/bswap.3 +++ b/upstream/fedora-rawhide/man3/bswap.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH bswap 3 2023-10-31 "Linux man-pages 6.06" +.TH bswap 3 2023-10-31 "Linux man-pages 6.7" .SH NAME bswap_16, bswap_32, bswap_64 \- reverse order of bytes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/btowc.3 b/upstream/fedora-rawhide/man3/btowc.3 index 837f43ca..a9808642 100644 --- a/upstream/fedora-rawhide/man3/btowc.3 +++ b/upstream/fedora-rawhide/man3/btowc.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH btowc 3 2023-10-31 "Linux man-pages 6.06" +.TH btowc 3 2023-10-31 "Linux man-pages 6.7" .SH NAME btowc \- convert single byte to wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/byteorder.3 b/upstream/fedora-rawhide/man3/byteorder.3 index a2062be5..e8a14396 100644 --- a/upstream/fedora-rawhide/man3/byteorder.3 +++ b/upstream/fedora-rawhide/man3/byteorder.3 @@ -10,7 +10,7 @@ .\" Modified Sat Jul 24 21:29:05 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Thu Jul 26 14:06:20 2001 by Andries Brouwer (aeb@cwi.nl) .\" -.TH BYTEORDER 3 2023-10-31 "Linux man-pages 6.06" +.TH BYTEORDER 3 2023-10-31 "Linux man-pages 6.7" .SH NAME htonl, htons, ntohl, ntohs \- convert values between host and network byte order diff --git a/upstream/fedora-rawhide/man3/bzero.3 b/upstream/fedora-rawhide/man3/bzero.3 index 95cb5b88..59b30ab8 100644 --- a/upstream/fedora-rawhide/man3/bzero.3 +++ b/upstream/fedora-rawhide/man3/bzero.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH bzero 3 2023-10-31 "Linux man-pages 6.06" +.TH bzero 3 2023-10-31 "Linux man-pages 6.7" .SH NAME bzero, explicit_bzero \- zero a byte string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/cabs.3 b/upstream/fedora-rawhide/man3/cabs.3 index ca3a637b..d331ce71 100644 --- a/upstream/fedora-rawhide/man3/cabs.3 +++ b/upstream/fedora-rawhide/man3/cabs.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH cabs 3 2023-10-31 "Linux man-pages 6.06" +.TH cabs 3 2023-10-31 "Linux man-pages 6.7" .SH NAME cabs, cabsf, cabsl \- absolute value of a complex number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/cacos.3 b/upstream/fedora-rawhide/man3/cacos.3 index 74be4862..3c66ff87 100644 --- a/upstream/fedora-rawhide/man3/cacos.3 +++ b/upstream/fedora-rawhide/man3/cacos.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH cacos 3 2023-10-31 "Linux man-pages 6.06" +.TH cacos 3 2023-10-31 "Linux man-pages 6.7" .SH NAME cacos, cacosf, cacosl \- complex arc cosine .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/cacosh.3 b/upstream/fedora-rawhide/man3/cacosh.3 index a16c82ea..941b3758 100644 --- a/upstream/fedora-rawhide/man3/cacosh.3 +++ b/upstream/fedora-rawhide/man3/cacosh.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH cacosh 3 2023-10-31 "Linux man-pages 6.06" +.TH cacosh 3 2023-10-31 "Linux man-pages 6.7" .SH NAME cacosh, cacoshf, cacoshl \- complex arc hyperbolic cosine .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/canonicalize_file_name.3 b/upstream/fedora-rawhide/man3/canonicalize_file_name.3 index 65b0ea8d..6304835f 100644 --- a/upstream/fedora-rawhide/man3/canonicalize_file_name.3 +++ b/upstream/fedora-rawhide/man3/canonicalize_file_name.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH canonicalize_file_name 3 2023-10-31 "Linux man-pages 6.06" +.TH canonicalize_file_name 3 2023-10-31 "Linux man-pages 6.7" .SH NAME canonicalize_file_name \- return the canonicalized absolute pathname .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/carg.3 b/upstream/fedora-rawhide/man3/carg.3 index e96adc68..bf5003fd 100644 --- a/upstream/fedora-rawhide/man3/carg.3 +++ b/upstream/fedora-rawhide/man3/carg.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH carg 3 2023-10-31 "Linux man-pages 6.06" +.TH carg 3 2023-10-31 "Linux man-pages 6.7" .SH NAME carg, cargf, cargl \- calculate the complex argument .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/casin.3 b/upstream/fedora-rawhide/man3/casin.3 index 89c4463a..edc09358 100644 --- a/upstream/fedora-rawhide/man3/casin.3 +++ b/upstream/fedora-rawhide/man3/casin.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH casin 3 2023-10-31 "Linux man-pages 6.06" +.TH casin 3 2023-10-31 "Linux man-pages 6.7" .SH NAME casin, casinf, casinl \- complex arc sine .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/casinh.3 b/upstream/fedora-rawhide/man3/casinh.3 index a620132a..39afc1ec 100644 --- a/upstream/fedora-rawhide/man3/casinh.3 +++ b/upstream/fedora-rawhide/man3/casinh.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH casinh 3 2023-10-31 "Linux man-pages 6.06" +.TH casinh 3 2023-10-31 "Linux man-pages 6.7" .SH NAME casinh, casinhf, casinhl \- complex arc sine hyperbolic .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/catan.3 b/upstream/fedora-rawhide/man3/catan.3 index 22fa7f2a..4bba0365 100644 --- a/upstream/fedora-rawhide/man3/catan.3 +++ b/upstream/fedora-rawhide/man3/catan.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH catan 3 2023-11-01 "Linux man-pages 6.06" +.TH catan 3 2023-11-01 "Linux man-pages 6.7" .SH NAME catan, catanf, catanl \- complex arc tangents .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/catanh.3 b/upstream/fedora-rawhide/man3/catanh.3 index 647737f9..48abbaac 100644 --- a/upstream/fedora-rawhide/man3/catanh.3 +++ b/upstream/fedora-rawhide/man3/catanh.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH catanh 3 2023-10-31 "Linux man-pages 6.06" +.TH catanh 3 2023-10-31 "Linux man-pages 6.7" .SH NAME catanh, catanhf, catanhl \- complex arc tangents hyperbolic .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/catgets.3 b/upstream/fedora-rawhide/man3/catgets.3 index a1c4cdba..2132dcc7 100644 --- a/upstream/fedora-rawhide/man3/catgets.3 +++ b/upstream/fedora-rawhide/man3/catgets.3 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Updated, aeb, 980809 -.TH catgets 3 2023-10-31 "Linux man-pages 6.06" +.TH catgets 3 2023-10-31 "Linux man-pages 6.7" .SH NAME catgets \- get message from a message catalog .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/catopen.3 b/upstream/fedora-rawhide/man3/catopen.3 index f3e0c33c..03edefef 100644 --- a/upstream/fedora-rawhide/man3/catopen.3 +++ b/upstream/fedora-rawhide/man3/catopen.3 @@ -6,7 +6,7 @@ .\" Modified Thu Dec 13 22:51:19 2001 by Martin Schulze <joey@infodrom.org> .\" Modified 2001-12-14 aeb .\" -.TH catopen 3 2023-10-31 "Linux man-pages 6.06" +.TH catopen 3 2023-10-31 "Linux man-pages 6.7" .SH NAME catopen, catclose \- open/close a message catalog .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/cbrt.3 b/upstream/fedora-rawhide/man3/cbrt.3 index c11f9f27..373cd8f3 100644 --- a/upstream/fedora-rawhide/man3/cbrt.3 +++ b/upstream/fedora-rawhide/man3/cbrt.3 @@ -8,7 +8,7 @@ .\" Modified 2002-07-27 Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH cbrt 3 2023-10-31 "Linux man-pages 6.06" +.TH cbrt 3 2024-03-12 "Linux man-pages 6.7" .SH NAME cbrt, cbrtf, cbrtl \- cube root function .SH LIBRARY @@ -47,8 +47,11 @@ Feature Test Macro Requirements for glibc (see .SH DESCRIPTION These functions return the (real) cube root of .IR x . -This function cannot fail; every representable real value has a -representable real cube root. +This function cannot fail; +every representable real value +has a real cube root, +and rounding it to a representable value +never causes overflow nor underflow. .SH RETURN VALUE These functions return the cube root of .IR x . diff --git a/upstream/fedora-rawhide/man3/ccos.3 b/upstream/fedora-rawhide/man3/ccos.3 index 893a4816..2d992e79 100644 --- a/upstream/fedora-rawhide/man3/ccos.3 +++ b/upstream/fedora-rawhide/man3/ccos.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH ccos 3 2023-10-31 "Linux man-pages 6.06" +.TH ccos 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ccos, ccosf, ccosl \- complex cosine function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ccosh.3 b/upstream/fedora-rawhide/man3/ccosh.3 index 245f517a..b61c5f37 100644 --- a/upstream/fedora-rawhide/man3/ccosh.3 +++ b/upstream/fedora-rawhide/man3/ccosh.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH ccosh 3 2023-10-31 "Linux man-pages 6.06" +.TH ccosh 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ccosh, ccoshf, ccoshl \- complex hyperbolic cosine .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ceil.3 b/upstream/fedora-rawhide/man3/ceil.3 index f9bddec1..60a86c0a 100644 --- a/upstream/fedora-rawhide/man3/ceil.3 +++ b/upstream/fedora-rawhide/man3/ceil.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH ceil 3 2023-10-31 "Linux man-pages 6.06" +.TH ceil 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ceil, ceilf, ceill \- ceiling function: smallest integral value not less than argument diff --git a/upstream/fedora-rawhide/man3/cexp.3 b/upstream/fedora-rawhide/man3/cexp.3 index 2b5655b4..5954913d 100644 --- a/upstream/fedora-rawhide/man3/cexp.3 +++ b/upstream/fedora-rawhide/man3/cexp.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH cexp 3 2023-10-31 "Linux man-pages 6.06" +.TH cexp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME cexp, cexpf, cexpl \- complex exponential function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/cexp2.3 b/upstream/fedora-rawhide/man3/cexp2.3 index 9a7c03c2..b8d25046 100644 --- a/upstream/fedora-rawhide/man3/cexp2.3 +++ b/upstream/fedora-rawhide/man3/cexp2.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH cexp2 3 2023-10-31 "Linux man-pages 6.06" +.TH cexp2 3 2023-10-31 "Linux man-pages 6.7" .SH NAME cexp2, cexp2f, cexp2l \- base-2 exponent of a complex number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/cfree.3 b/upstream/fedora-rawhide/man3/cfree.3 index 657eb148..97d30b62 100644 --- a/upstream/fedora-rawhide/man3/cfree.3 +++ b/upstream/fedora-rawhide/man3/cfree.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH cfree 3 2023-10-31 "Linux man-pages 6.06" +.TH cfree 3 2023-10-31 "Linux man-pages 6.7" .SH NAME cfree \- free allocated memory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/cimag.3 b/upstream/fedora-rawhide/man3/cimag.3 index 17f4cd44..d369cf8b 100644 --- a/upstream/fedora-rawhide/man3/cimag.3 +++ b/upstream/fedora-rawhide/man3/cimag.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH cimag 3 2023-10-31 "Linux man-pages 6.06" +.TH cimag 3 2023-10-31 "Linux man-pages 6.7" .SH NAME cimag, cimagf, cimagl \- get imaginary part of a complex number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/circleq.3 b/upstream/fedora-rawhide/man3/circleq.3 index b446416f..47b82137 100644 --- a/upstream/fedora-rawhide/man3/circleq.3 +++ b/upstream/fedora-rawhide/man3/circleq.3 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: BSD-3-Clause .\" .\" -.TH CIRCLEQ 3 2023-10-31 "Linux man-pages 6.06" +.TH CIRCLEQ 3 2023-10-31 "Linux man-pages 6.7" .SH NAME CIRCLEQ_EMPTY, CIRCLEQ_ENTRY, diff --git a/upstream/fedora-rawhide/man3/clearenv.3 b/upstream/fedora-rawhide/man3/clearenv.3 index 08f23a41..3ffd7613 100644 --- a/upstream/fedora-rawhide/man3/clearenv.3 +++ b/upstream/fedora-rawhide/man3/clearenv.3 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Additions, aeb, 2001-10-17. -.TH clearenv 3 2023-10-31 "Linux man-pages 6.06" +.TH clearenv 3 2023-10-31 "Linux man-pages 6.7" .SH NAME clearenv \- clear the environment .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/clock.3 b/upstream/fedora-rawhide/man3/clock.3 index 6d8ace49..53231aa7 100644 --- a/upstream/fedora-rawhide/man3/clock.3 +++ b/upstream/fedora-rawhide/man3/clock.3 @@ -7,7 +7,7 @@ .\" Modified 14 Jun 2002, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added notes on differences from other UNIX systems with respect to .\" waited-for children. -.TH clock 3 2023-10-31 "Linux man-pages 6.06" +.TH clock 3 2023-10-31 "Linux man-pages 6.7" .SH NAME clock \- determine processor time .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/clock_getcpuclockid.3 b/upstream/fedora-rawhide/man3/clock_getcpuclockid.3 index ce9d3bd6..541c46af 100644 --- a/upstream/fedora-rawhide/man3/clock_getcpuclockid.3 +++ b/upstream/fedora-rawhide/man3/clock_getcpuclockid.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH clock_getcpuclockid 3 2023-10-31 "Linux man-pages 6.06" +.TH clock_getcpuclockid 3 2023-10-31 "Linux man-pages 6.7" .SH NAME clock_getcpuclockid \- obtain ID of a process CPU-time clock .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/clog.3 b/upstream/fedora-rawhide/man3/clog.3 index 79c4d30f..9ada2768 100644 --- a/upstream/fedora-rawhide/man3/clog.3 +++ b/upstream/fedora-rawhide/man3/clog.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH clog 3 2023-10-31 "Linux man-pages 6.06" +.TH clog 3 2023-10-31 "Linux man-pages 6.7" .SH NAME clog, clogf, clogl \- natural logarithm of a complex number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/clog10.3 b/upstream/fedora-rawhide/man3/clog10.3 index 1ff78e4f..6ad20a44 100644 --- a/upstream/fedora-rawhide/man3/clog10.3 +++ b/upstream/fedora-rawhide/man3/clog10.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH clog10 3 2023-10-31 "Linux man-pages 6.06" +.TH clog10 3 2023-10-31 "Linux man-pages 6.7" .SH NAME clog10, clog10f, clog10l \- base-10 logarithm of a complex number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/clog2.3 b/upstream/fedora-rawhide/man3/clog2.3 index afe69401..d1f3b4ab 100644 --- a/upstream/fedora-rawhide/man3/clog2.3 +++ b/upstream/fedora-rawhide/man3/clog2.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH clog2 3 2023-10-31 "Linux man-pages 6.06" +.TH clog2 3 2023-10-31 "Linux man-pages 6.7" .SH NAME clog2, clog2f, clog2l \- base-2 logarithm of a complex number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/closedir.3 b/upstream/fedora-rawhide/man3/closedir.3 index f374e767..5fc97372 100644 --- a/upstream/fedora-rawhide/man3/closedir.3 +++ b/upstream/fedora-rawhide/man3/closedir.3 @@ -9,7 +9,7 @@ .\" 386BSD man pages .\" Modified Sat Jul 24 21:25:52 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 11 June 1995 by Andries Brouwer (aeb@cwi.nl) -.TH closedir 3 2023-10-31 "Linux man-pages 6.06" +.TH closedir 3 2023-10-31 "Linux man-pages 6.7" .SH NAME closedir \- close a directory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/cmsg.3 b/upstream/fedora-rawhide/man3/cmsg.3 index 6efbcbb7..2d0a70e7 100644 --- a/upstream/fedora-rawhide/man3/cmsg.3 +++ b/upstream/fedora-rawhide/man3/cmsg.3 @@ -3,7 +3,7 @@ .\" This man page is Copyright (C) 1999 Andi Kleen <ak@muc.de>. .\" .\" $Id: cmsg.3,v 1.8 2000/12/20 18:10:31 ak Exp $ -.TH CMSG 3 2023-10-31 "Linux man-pages 6.06" +.TH CMSG 3 2023-10-31 "Linux man-pages 6.7" .SH NAME CMSG_ALIGN, CMSG_SPACE, CMSG_NXTHDR, CMSG_FIRSTHDR \- access ancillary data .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/confstr.3 b/upstream/fedora-rawhide/man3/confstr.3 index d549e7fe..4a04a251 100644 --- a/upstream/fedora-rawhide/man3/confstr.3 +++ b/upstream/fedora-rawhide/man3/confstr.3 @@ -11,7 +11,7 @@ .\" These should all be added to this page. .\" See also the POSIX.1-2001 specification of confstr() .\" -.TH confstr 3 2023-10-31 "Linux man-pages 6.06" +.TH confstr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME confstr \- get configuration dependent string variables .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/conj.3 b/upstream/fedora-rawhide/man3/conj.3 index 475c2703..4f0bef36 100644 --- a/upstream/fedora-rawhide/man3/conj.3 +++ b/upstream/fedora-rawhide/man3/conj.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH conj 3 2023-10-31 "Linux man-pages 6.06" +.TH conj 3 2023-10-31 "Linux man-pages 6.7" .SH NAME conj, conjf, conjl \- calculate the complex conjugate .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/copysign.3 b/upstream/fedora-rawhide/man3/copysign.3 index c76cebe5..8f7e7ab6 100644 --- a/upstream/fedora-rawhide/man3/copysign.3 +++ b/upstream/fedora-rawhide/man3/copysign.3 @@ -9,7 +9,7 @@ .\" 386BSD man pages .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2002-08-10 by Walter Harms (walter.harms@informatik.uni-oldenburg.de) -.TH copysign 3 2023-10-31 "Linux man-pages 6.06" +.TH copysign 3 2023-10-31 "Linux man-pages 6.7" .SH NAME copysign, copysignf, copysignl \- copy sign of a number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/cos.3 b/upstream/fedora-rawhide/man3/cos.3 index 843d9c45..9b8e1f4d 100644 --- a/upstream/fedora-rawhide/man3/cos.3 +++ b/upstream/fedora-rawhide/man3/cos.3 @@ -12,7 +12,7 @@ .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) -.TH cos 3 2023-10-31 "Linux man-pages 6.06" +.TH cos 3 2023-10-31 "Linux man-pages 6.7" .SH NAME cos, cosf, cosl \- cosine function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/cosh.3 b/upstream/fedora-rawhide/man3/cosh.3 index 2f3d6efc..5177cceb 100644 --- a/upstream/fedora-rawhide/man3/cosh.3 +++ b/upstream/fedora-rawhide/man3/cosh.3 @@ -14,7 +14,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH cosh 3 2023-10-31 "Linux man-pages 6.06" +.TH cosh 3 2023-10-31 "Linux man-pages 6.7" .SH NAME cosh, coshf, coshl \- hyperbolic cosine function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/cpow.3 b/upstream/fedora-rawhide/man3/cpow.3 index f7a22df0..788f5aa7 100644 --- a/upstream/fedora-rawhide/man3/cpow.3 +++ b/upstream/fedora-rawhide/man3/cpow.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH cpow 3 2023-10-31 "Linux man-pages 6.06" +.TH cpow 3 2023-10-31 "Linux man-pages 6.7" .SH NAME cpow, cpowf, cpowl \- complex power function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/cproj.3 b/upstream/fedora-rawhide/man3/cproj.3 index 0b015638..2d32c1ed 100644 --- a/upstream/fedora-rawhide/man3/cproj.3 +++ b/upstream/fedora-rawhide/man3/cproj.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH cproj 3 2023-10-31 "Linux man-pages 6.06" +.TH cproj 3 2023-10-31 "Linux man-pages 6.7" .SH NAME cproj, cprojf, cprojl \- project into Riemann Sphere .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/creal.3 b/upstream/fedora-rawhide/man3/creal.3 index 77e79a93..ded56e68 100644 --- a/upstream/fedora-rawhide/man3/creal.3 +++ b/upstream/fedora-rawhide/man3/creal.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH creal 3 2023-10-31 "Linux man-pages 6.06" +.TH creal 3 2023-10-31 "Linux man-pages 6.7" .SH NAME creal, crealf, creall \- get real part of a complex number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/csin.3 b/upstream/fedora-rawhide/man3/csin.3 index 4a09ef20..1bf04a17 100644 --- a/upstream/fedora-rawhide/man3/csin.3 +++ b/upstream/fedora-rawhide/man3/csin.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH csin 3 2023-10-31 "Linux man-pages 6.06" +.TH csin 3 2023-10-31 "Linux man-pages 6.7" .SH NAME csin, csinf, csinl \- complex sine function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/csinh.3 b/upstream/fedora-rawhide/man3/csinh.3 index 8dd07042..263e2d09 100644 --- a/upstream/fedora-rawhide/man3/csinh.3 +++ b/upstream/fedora-rawhide/man3/csinh.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH csinh 3 2023-10-31 "Linux man-pages 6.06" +.TH csinh 3 2023-10-31 "Linux man-pages 6.7" .SH NAME csinh, csinhf, csinhl \- complex hyperbolic sine .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/csqrt.3 b/upstream/fedora-rawhide/man3/csqrt.3 index d2060fff..9fdf80bb 100644 --- a/upstream/fedora-rawhide/man3/csqrt.3 +++ b/upstream/fedora-rawhide/man3/csqrt.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH csqrt 3 2023-10-31 "Linux man-pages 6.06" +.TH csqrt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME csqrt, csqrtf, csqrtl \- complex square root .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ctan.3 b/upstream/fedora-rawhide/man3/ctan.3 index fe46a735..3daf68b7 100644 --- a/upstream/fedora-rawhide/man3/ctan.3 +++ b/upstream/fedora-rawhide/man3/ctan.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH ctan 3 2023-10-31 "Linux man-pages 6.06" +.TH ctan 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ctan, ctanf, ctanl \- complex tangent function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ctanh.3 b/upstream/fedora-rawhide/man3/ctanh.3 index 360c8352..f2178b9e 100644 --- a/upstream/fedora-rawhide/man3/ctanh.3 +++ b/upstream/fedora-rawhide/man3/ctanh.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH ctanh 3 2023-10-31 "Linux man-pages 6.06" +.TH ctanh 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ctanh, ctanhf, ctanhl \- complex hyperbolic tangent .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ctermid.3 b/upstream/fedora-rawhide/man3/ctermid.3 index abd1719f..987637fa 100644 --- a/upstream/fedora-rawhide/man3/ctermid.3 +++ b/upstream/fedora-rawhide/man3/ctermid.3 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified Sat Jul 24 19:51:06 1993 by Rik Faith (faith@cs.unc.edu) -.TH ctermid 3 2023-10-31 "Linux man-pages 6.06" +.TH ctermid 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ctermid \- get controlling terminal name .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ctime.3 b/upstream/fedora-rawhide/man3/ctime.3 index e2d1c079..817e964d 100644 --- a/upstream/fedora-rawhide/man3/ctime.3 +++ b/upstream/fedora-rawhide/man3/ctime.3 @@ -13,7 +13,7 @@ .\" Modified 2001-12-13, joey, aeb .\" Modified 2004-11-16, mtk .\" -.TH ctime 3 2023-10-31 "Linux man-pages 6.06" +.TH ctime 3 2023-10-31 "Linux man-pages 6.7" .SH NAME asctime, ctime, gmtime, localtime, mktime, asctime_r, ctime_r, gmtime_r, localtime_r \- transform date and time to broken-down time or ASCII diff --git a/upstream/fedora-rawhide/man3/daemon.3 b/upstream/fedora-rawhide/man3/daemon.3 index 3c4ebc0e..9ee15871 100644 --- a/upstream/fedora-rawhide/man3/daemon.3 +++ b/upstream/fedora-rawhide/man3/daemon.3 @@ -6,7 +6,7 @@ .\" .\" @(#)daemon.3 8.1 (Berkeley) 6/9/93 .\" Added mentioning of glibc weirdness wrt unistd.h. 5/11/98, Al Viro -.TH daemon 3 2023-10-31 "Linux man-pages 6.06" +.TH daemon 3 2023-10-31 "Linux man-pages 6.7" .SH NAME daemon \- run in the background .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/des_crypt.3 b/upstream/fedora-rawhide/man3/des_crypt.3 index b2c9aabc..8a1228d7 100644 --- a/upstream/fedora-rawhide/man3/des_crypt.3 +++ b/upstream/fedora-rawhide/man3/des_crypt.3 @@ -10,7 +10,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH des_crypt 3 2023-10-31 "Linux man-pages 6.06" +.TH des_crypt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME des_crypt, ecb_crypt, cbc_crypt, des_setparity, DES_FAILED \- fast DES encryption diff --git a/upstream/fedora-rawhide/man3/difftime.3 b/upstream/fedora-rawhide/man3/difftime.3 index 77aec052..d1e392e1 100644 --- a/upstream/fedora-rawhide/man3/difftime.3 +++ b/upstream/fedora-rawhide/man3/difftime.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:48:17 1993 by Rik Faith (faith@cs.unc.edu) -.TH difftime 3 2023-11-11 "Linux man-pages 6.06" +.TH difftime 3 2023-11-11 "Linux man-pages 6.7" .SH NAME difftime \- calculate time difference .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/dirfd.3 b/upstream/fedora-rawhide/man3/dirfd.3 index 83450bfe..fa296ec5 100644 --- a/upstream/fedora-rawhide/man3/dirfd.3 +++ b/upstream/fedora-rawhide/man3/dirfd.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH dirfd 3 2023-10-31 "Linux man-pages 6.06" +.TH dirfd 3 2023-10-31 "Linux man-pages 6.7" .SH NAME dirfd \- get directory stream file descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/div.3 b/upstream/fedora-rawhide/man3/div.3 index 2428cb3f..bbe2aeb3 100644 --- a/upstream/fedora-rawhide/man3/div.3 +++ b/upstream/fedora-rawhide/man3/div.3 @@ -12,7 +12,7 @@ .\" Modified 1993-07-24, Rik Faith (faith@cs.unc.edu) .\" Modified 2002-08-10, 2003-11-01 Walter Harms, aeb .\" -.TH div 3 2023-10-31 "Linux man-pages 6.06" +.TH div 3 2023-10-31 "Linux man-pages 6.7" .SH NAME div, ldiv, lldiv, imaxdiv \- compute quotient and remainder of an integer division diff --git a/upstream/fedora-rawhide/man3/dl_iterate_phdr.3 b/upstream/fedora-rawhide/man3/dl_iterate_phdr.3 index f45c3682..b5cbb867 100644 --- a/upstream/fedora-rawhide/man3/dl_iterate_phdr.3 +++ b/upstream/fedora-rawhide/man3/dl_iterate_phdr.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH dl_iterate_phdr 3 2023-10-31 "Linux man-pages 6.06" +.TH dl_iterate_phdr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME dl_iterate_phdr \- walk through list of shared objects .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/dladdr.3 b/upstream/fedora-rawhide/man3/dladdr.3 index 2b0a49dc..6929b015 100644 --- a/upstream/fedora-rawhide/man3/dladdr.3 +++ b/upstream/fedora-rawhide/man3/dladdr.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH dladdr 3 2023-10-31 "Linux man-pages 6.06" +.TH dladdr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME dladdr, dladdr1 \- translate address to symbolic information .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/dlerror.3 b/upstream/fedora-rawhide/man3/dlerror.3 index 1c44425e..06718ee0 100644 --- a/upstream/fedora-rawhide/man3/dlerror.3 +++ b/upstream/fedora-rawhide/man3/dlerror.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH dlerror 3 2023-10-31 "Linux man-pages 6.06" +.TH dlerror 3 2023-10-31 "Linux man-pages 6.7" .SH NAME dlerror \- obtain error diagnostic for functions in the dlopen API .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/dlinfo.3 b/upstream/fedora-rawhide/man3/dlinfo.3 index d5f62d38..8fd42fc8 100644 --- a/upstream/fedora-rawhide/man3/dlinfo.3 +++ b/upstream/fedora-rawhide/man3/dlinfo.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH dlinfo 3 2023-10-31 "Linux man-pages 6.06" +.TH dlinfo 3 2023-10-31 "Linux man-pages 6.7" .SH NAME dlinfo \- obtain information about a dynamically loaded object .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/dlopen.3 b/upstream/fedora-rawhide/man3/dlopen.3 index 25496c95..9e31e0f6 100644 --- a/upstream/fedora-rawhide/man3/dlopen.3 +++ b/upstream/fedora-rawhide/man3/dlopen.3 @@ -14,7 +14,7 @@ .\" Modified by Walter Harms: dladdr, dlvsym .\" Modified by Petr Baudis <pasky@suse.cz>, 2008-12-04: dladdr caveat .\" -.TH dlopen 3 2023-10-31 "Linux man-pages 6.06" +.TH dlopen 3 2023-10-31 "Linux man-pages 6.7" .SH NAME dlclose, dlopen, dlmopen \- open and close a shared object diff --git a/upstream/fedora-rawhide/man3/dlsym.3 b/upstream/fedora-rawhide/man3/dlsym.3 index 0cf45c69..18ba9535 100644 --- a/upstream/fedora-rawhide/man3/dlsym.3 +++ b/upstream/fedora-rawhide/man3/dlsym.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH dlsym 3 2023-10-31 "Linux man-pages 6.06" +.TH dlsym 3 2023-10-31 "Linux man-pages 6.7" .SH NAME dlsym, dlvsym \- obtain address of a symbol in a shared object or executable .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/drand48.3 b/upstream/fedora-rawhide/man3/drand48.3 index a27305e8..18123b08 100644 --- a/upstream/fedora-rawhide/man3/drand48.3 +++ b/upstream/fedora-rawhide/man3/drand48.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:46:03 1993 by Rik Faith (faith@cs.unc.edu) -.TH drand48 3 2023-10-31 "Linux man-pages 6.06" +.TH drand48 3 2023-10-31 "Linux man-pages 6.7" .SH NAME drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, seed48, lcong48 \- generate uniformly distributed pseudo-random numbers diff --git a/upstream/fedora-rawhide/man3/drand48_r.3 b/upstream/fedora-rawhide/man3/drand48_r.3 index 361592be..19618d7e 100644 --- a/upstream/fedora-rawhide/man3/drand48_r.3 +++ b/upstream/fedora-rawhide/man3/drand48_r.3 @@ -5,7 +5,7 @@ .\" .\" Created 2004-10-31. Text taken from a page by Walter Harms, 2003-09-08 .\" -.TH drand48_r 3 2023-10-31 "Linux man-pages 6.06" +.TH drand48_r 3 2023-10-31 "Linux man-pages 6.7" .SH NAME drand48_r, erand48_r, lrand48_r, nrand48_r, mrand48_r, jrand48_r, srand48_r, seed48_r, lcong48_r diff --git a/upstream/fedora-rawhide/man3/duplocale.3 b/upstream/fedora-rawhide/man3/duplocale.3 index 8d8a5745..0f754728 100644 --- a/upstream/fedora-rawhide/man3/duplocale.3 +++ b/upstream/fedora-rawhide/man3/duplocale.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH duplocale 3 2023-10-31 "Linux man-pages 6.06" +.TH duplocale 3 2023-10-31 "Linux man-pages 6.7" .SH NAME duplocale \- duplicate a locale object .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/dysize.3 b/upstream/fedora-rawhide/man3/dysize.3 index 24eb9340..d3450767 100644 --- a/upstream/fedora-rawhide/man3/dysize.3 +++ b/upstream/fedora-rawhide/man3/dysize.3 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" aeb: some corrections -.TH dysize 3 2023-10-31 "Linux man-pages 6.06" +.TH dysize 3 2023-10-31 "Linux man-pages 6.7" .SH NAME dysize \- get number of days for a given year .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ecvt.3 b/upstream/fedora-rawhide/man3/ecvt.3 index 7900ed28..2e773f44 100644 --- a/upstream/fedora-rawhide/man3/ecvt.3 +++ b/upstream/fedora-rawhide/man3/ecvt.3 @@ -10,7 +10,7 @@ .\" Modified Sat Jul 24 19:40:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Fri Jun 25 12:10:47 1999 by Andries Brouwer (aeb@cwi.nl) .\" -.TH ecvt 3 2023-10-31 "Linux man-pages 6.06" +.TH ecvt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ecvt, fcvt \- convert a floating-point number to a string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ecvt_r.3 b/upstream/fedora-rawhide/man3/ecvt_r.3 index 888c9612..30c1fc60 100644 --- a/upstream/fedora-rawhide/man3/ecvt_r.3 +++ b/upstream/fedora-rawhide/man3/ecvt_r.3 @@ -8,7 +8,7 @@ .\" .\" Corrected return types; from Fabian; 2004-10-05 .\" -.TH ecvt_r 3 2023-10-31 "Linux man-pages 6.06" +.TH ecvt_r 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ecvt_r, fcvt_r, qecvt_r, qfcvt_r \- convert a floating-point number to a string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/encrypt.3 b/upstream/fedora-rawhide/man3/encrypt.3 index 33342c7a..58c61b31 100644 --- a/upstream/fedora-rawhide/man3/encrypt.3 +++ b/upstream/fedora-rawhide/man3/encrypt.3 @@ -9,7 +9,7 @@ .\" .\" Modified 2003-04-04, aeb .\" -.TH encrypt 3 2023-10-31 "Linux man-pages 6.06" +.TH encrypt 3 2024-02-26 "Linux man-pages 6.7" .SH NAME encrypt, setkey, encrypt_r, setkey_r \- encrypt 64-bit messages .SH LIBRARY @@ -155,7 +155,7 @@ See .SS Features in glibc In glibc 2.2, these functions use the DES algorithm. .SH EXAMPLES -.\" [[deprecated]] SRC BEGIN (encrypt.c) +.\" SRC BEGIN (encrypt.c) .EX #define _XOPEN_SOURCE #include <crypt.h> diff --git a/upstream/fedora-rawhide/man3/end.3 b/upstream/fedora-rawhide/man3/end.3 index 26488457..1eb07fd3 100644 --- a/upstream/fedora-rawhide/man3/end.3 +++ b/upstream/fedora-rawhide/man3/end.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH end 3 2023-10-31 "Linux man-pages 6.06" +.TH end 3 2023-10-31 "Linux man-pages 6.7" .SH NAME etext, edata, end \- end of program segments .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man3/endian.3 b/upstream/fedora-rawhide/man3/endian.3 index 82ccd73b..8de4974e 100644 --- a/upstream/fedora-rawhide/man3/endian.3 +++ b/upstream/fedora-rawhide/man3/endian.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH endian 3 2023-10-31 "Linux man-pages 6.06" +.TH endian 3 2023-10-31 "Linux man-pages 6.7" .SH NAME htobe16, htole16, be16toh, le16toh, htobe32, htole32, be32toh, le32toh, htobe64, htole64, be64toh, le64toh \- diff --git a/upstream/fedora-rawhide/man3/envz_add.3 b/upstream/fedora-rawhide/man3/envz_add.3 index 4d892578..ec2f658b 100644 --- a/upstream/fedora-rawhide/man3/envz_add.3 +++ b/upstream/fedora-rawhide/man3/envz_add.3 @@ -6,7 +6,7 @@ .\" based on the description in glibc source and infopages .\" .\" Corrections and additions, aeb -.TH envz_add 3 2023-10-31 "Linux man-pages 6.06" +.TH envz_add 3 2023-10-31 "Linux man-pages 6.7" .SH NAME envz_add, envz_entry, envz_get, envz_merge, envz_remove, envz_strip \- environment string support diff --git a/upstream/fedora-rawhide/man3/erf.3 b/upstream/fedora-rawhide/man3/erf.3 index 7672524a..1e12bbae 100644 --- a/upstream/fedora-rawhide/man3/erf.3 +++ b/upstream/fedora-rawhide/man3/erf.3 @@ -13,7 +13,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH erf 3 2023-10-31 "Linux man-pages 6.06" +.TH erf 3 2023-10-31 "Linux man-pages 6.7" .SH NAME erf, erff, erfl \- error function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/erfc.3 b/upstream/fedora-rawhide/man3/erfc.3 index 72e5d28b..658e1bbb 100644 --- a/upstream/fedora-rawhide/man3/erfc.3 +++ b/upstream/fedora-rawhide/man3/erfc.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH erfc 3 2023-10-31 "Linux man-pages 6.06" +.TH erfc 3 2023-10-31 "Linux man-pages 6.7" .SH NAME erfc, erfcf, erfcl \- complementary error function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/err.3 b/upstream/fedora-rawhide/man3/err.3 index f52c69ad..01a88ecd 100644 --- a/upstream/fedora-rawhide/man3/err.3 +++ b/upstream/fedora-rawhide/man3/err.3 @@ -9,7 +9,7 @@ .\" .\" 2011-09-10, mtk, Converted from mdoc to man macros .\" -.TH err 3 2023-10-31 "Linux man-pages 6.06" +.TH err 3 2023-10-31 "Linux man-pages 6.7" .SH NAME err, verr, errx, verrx, warn, vwarn, warnx, vwarnx \- formatted error messages .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/errno.3 b/upstream/fedora-rawhide/man3/errno.3 index b8171a71..335bb9c2 100644 --- a/upstream/fedora-rawhide/man3/errno.3 +++ b/upstream/fedora-rawhide/man3/errno.3 @@ -9,7 +9,7 @@ .\" 2006-02-09 Kurt Wall, mtk .\" Added non-POSIX errors .\" -.TH errno 3 2023-10-31 "Linux man-pages 6.06" +.TH errno 3 2023-10-31 "Linux man-pages 6.7" .SH NAME errno \- number of last error .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/error.3 b/upstream/fedora-rawhide/man3/error.3 index 34d8c016..fce50fa8 100644 --- a/upstream/fedora-rawhide/man3/error.3 +++ b/upstream/fedora-rawhide/man3/error.3 @@ -25,7 +25,7 @@ .\" .\" References: .\" glibc manual and source -.TH error 3 2023-10-31 "Linux man-pages 6.06" +.TH error 3 2023-10-31 "Linux man-pages 6.7" .SH NAME error, error_at_line, error_message_count, error_one_per_line, error_print_progname \- glibc error reporting functions diff --git a/upstream/fedora-rawhide/man3/ether_aton.3 b/upstream/fedora-rawhide/man3/ether_aton.3 index ead04f39..8181dd54 100644 --- a/upstream/fedora-rawhide/man3/ether_aton.3 +++ b/upstream/fedora-rawhide/man3/ether_aton.3 @@ -9,7 +9,7 @@ .\" .\" Minor additions, aeb, 2013-06-21 .\" -.TH ether_aton 3 2023-10-31 "Linux man-pages 6.06" +.TH ether_aton 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ether_aton, ether_ntoa, ether_ntohost, ether_hostton, ether_line, ether_ntoa_r, ether_aton_r \- Ethernet address manipulation routines diff --git a/upstream/fedora-rawhide/man3/euidaccess.3 b/upstream/fedora-rawhide/man3/euidaccess.3 index f9aa13ce..c4fcc0e3 100644 --- a/upstream/fedora-rawhide/man3/euidaccess.3 +++ b/upstream/fedora-rawhide/man3/euidaccess.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH euidaccess 3 2023-10-31 "Linux man-pages 6.06" +.TH euidaccess 3 2023-10-31 "Linux man-pages 6.7" .SH NAME euidaccess, eaccess \- check effective user's permissions for a file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/exec.3 b/upstream/fedora-rawhide/man3/exec.3 index 41256723..caf6d6a0 100644 --- a/upstream/fedora-rawhide/man3/exec.3 +++ b/upstream/fedora-rawhide/man3/exec.3 @@ -11,7 +11,7 @@ .\" Modified, 24 Jun 2004, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added note on casting NULL .\" -.TH exec 3 2023-10-31 "Linux man-pages 6.06" +.TH exec 3 2023-10-31 "Linux man-pages 6.7" .SH NAME execl, execlp, execle, execv, execvp, execvpe \- execute a file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/exit.3 b/upstream/fedora-rawhide/man3/exit.3 index abde10d1..0b8bab24 100644 --- a/upstream/fedora-rawhide/man3/exit.3 +++ b/upstream/fedora-rawhide/man3/exit.3 @@ -7,7 +7,7 @@ .\" could be listed on this page. See, for example, the list in the .\" POSIX exit(3p) page. .\" -.TH exit 3 2023-10-31 "Linux man-pages 6.06" +.TH exit 3 2023-10-31 "Linux man-pages 6.7" .SH NAME exit \- cause normal process termination .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/exp.3 b/upstream/fedora-rawhide/man3/exp.3 index 80f842c3..bdfd95b3 100644 --- a/upstream/fedora-rawhide/man3/exp.3 +++ b/upstream/fedora-rawhide/man3/exp.3 @@ -14,7 +14,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH exp 3 2023-10-31 "Linux man-pages 6.06" +.TH exp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME exp, expf, expl \- base-e exponential function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/exp10.3 b/upstream/fedora-rawhide/man3/exp10.3 index d20aa3be..1d858718 100644 --- a/upstream/fedora-rawhide/man3/exp10.3 +++ b/upstream/fedora-rawhide/man3/exp10.3 @@ -13,7 +13,7 @@ .\" Modified 1995-08-14 by Arnt Gulbrandsen <agulbra@troll.no> .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) -.TH exp10 3 2023-10-31 "Linux man-pages 6.06" +.TH exp10 3 2023-10-31 "Linux man-pages 6.7" .SH NAME exp10, exp10f, exp10l \- base-10 exponential function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/exp2.3 b/upstream/fedora-rawhide/man3/exp2.3 index f42f2c75..1cf5ead1 100644 --- a/upstream/fedora-rawhide/man3/exp2.3 +++ b/upstream/fedora-rawhide/man3/exp2.3 @@ -14,7 +14,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH exp2 3 2023-10-31 "Linux man-pages 6.06" +.TH exp2 3 2023-10-31 "Linux man-pages 6.7" .SH NAME exp2, exp2f, exp2l \- base-2 exponential function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/expm1.3 b/upstream/fedora-rawhide/man3/expm1.3 index 1d50e645..32b9767b 100644 --- a/upstream/fedora-rawhide/man3/expm1.3 +++ b/upstream/fedora-rawhide/man3/expm1.3 @@ -8,7 +8,7 @@ .\" Modified 2002-07-27 Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH expm1 3 2023-10-31 "Linux man-pages 6.06" +.TH expm1 3 2023-10-31 "Linux man-pages 6.7" .SH NAME expm1, expm1f, expm1l \- exponential minus 1 .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fabs.3 b/upstream/fedora-rawhide/man3/fabs.3 index 04132a74..ed1c83dc 100644 --- a/upstream/fedora-rawhide/man3/fabs.3 +++ b/upstream/fedora-rawhide/man3/fabs.3 @@ -10,7 +10,7 @@ .\" Modified Sat Jul 24 19:42:04 1993 by Rik Faith (faith@cs.unc.edu) .\" Added fabsl, fabsf, aeb, 2001-06-07 .\" -.TH fabs 3 2023-10-31 "Linux man-pages 6.06" +.TH fabs 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fabs, fabsf, fabsl \- absolute value of floating-point number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fclose.3 b/upstream/fedora-rawhide/man3/fclose.3 index befd9040..651850a6 100644 --- a/upstream/fedora-rawhide/man3/fclose.3 +++ b/upstream/fedora-rawhide/man3/fclose.3 @@ -14,7 +14,7 @@ .\" .\" Modified 2000-07-22 by Nicolás Lichtmaier <nick@debian.org> .\" -.TH fclose 3 2023-10-31 "Linux man-pages 6.06" +.TH fclose 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fclose \- close a stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fcloseall.3 b/upstream/fedora-rawhide/man3/fcloseall.3 index 71ae9807..d56f4cbc 100644 --- a/upstream/fedora-rawhide/man3/fcloseall.3 +++ b/upstream/fedora-rawhide/man3/fcloseall.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH fcloseall 3 2023-10-31 "Linux man-pages 6.06" +.TH fcloseall 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fcloseall \- close all open streams .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fdim.3 b/upstream/fedora-rawhide/man3/fdim.3 index e550acbe..37ad6212 100644 --- a/upstream/fedora-rawhide/man3/fdim.3 +++ b/upstream/fedora-rawhide/man3/fdim.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH fdim 3 2023-10-31 "Linux man-pages 6.06" +.TH fdim 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fdim, fdimf, fdiml \- positive difference .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fenv.3 b/upstream/fedora-rawhide/man3/fenv.3 index b867cbf2..6e2bf45d 100644 --- a/upstream/fedora-rawhide/man3/fenv.3 +++ b/upstream/fedora-rawhide/man3/fenv.3 @@ -6,7 +6,7 @@ .\" 2000-08-14 added GNU additions from Andreas Jaeger .\" 2000-12-05 some changes inspired by acahalan's remarks .\" -.TH fenv 3 2023-10-31 "Linux man-pages 6.06" +.TH fenv 3 2023-10-31 "Linux man-pages 6.7" .SH NAME feclearexcept, fegetexceptflag, feraiseexcept, fesetexceptflag, fetestexcept, fegetenv, fegetround, feholdexcept, fesetround, diff --git a/upstream/fedora-rawhide/man3/ferror.3 b/upstream/fedora-rawhide/man3/ferror.3 index ec339507..3bb3390d 100644 --- a/upstream/fedora-rawhide/man3/ferror.3 +++ b/upstream/fedora-rawhide/man3/ferror.3 @@ -14,7 +14,7 @@ .\" .\" Converted for Linux, Mon Nov 29 14:24:40 1993, faith@cs.unc.edu .\" -.TH ferror 3 2023-10-31 "Linux man-pages 6.06" +.TH ferror 3 2023-10-31 "Linux man-pages 6.7" .SH NAME clearerr, feof, ferror \- check and reset stream status .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fexecve.3 b/upstream/fedora-rawhide/man3/fexecve.3 index e3dcb4ef..51d3d0fe 100644 --- a/upstream/fedora-rawhide/man3/fexecve.3 +++ b/upstream/fedora-rawhide/man3/fexecve.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH fexecve 3 2023-10-31 "Linux man-pages 6.06" +.TH fexecve 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fexecve \- execute program specified via file descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fflush.3 b/upstream/fedora-rawhide/man3/fflush.3 index b634dbb8..25aa47c4 100644 --- a/upstream/fedora-rawhide/man3/fflush.3 +++ b/upstream/fedora-rawhide/man3/fflush.3 @@ -15,7 +15,7 @@ .\" Modified 2000-07-22 by Nicolás Lichtmaier <nick@debian.org> .\" Modified 2001-10-16 by John Levon <moz@compsoc.man.ac.uk> .\" -.TH fflush 3 2023-10-31 "Linux man-pages 6.06" +.TH fflush 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fflush \- flush a stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ffs.3 b/upstream/fedora-rawhide/man3/ffs.3 index 86dd7385..00c8aade 100644 --- a/upstream/fedora-rawhide/man3/ffs.3 +++ b/upstream/fedora-rawhide/man3/ffs.3 @@ -11,7 +11,7 @@ .\" .\" Modified 2003 Walter Harms (walter.harms@informatik.uni-oldenburg.de) .\" -.TH ffs 3 2023-11-19 "Linux man-pages 6.06" +.TH ffs 3 2023-11-19 "Linux man-pages 6.7" .SH NAME ffs, ffsl, ffsll \- find first bit set in a word .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fgetc.3 b/upstream/fedora-rawhide/man3/fgetc.3 index 003befc8..1f820f88 100644 --- a/upstream/fedora-rawhide/man3/fgetc.3 +++ b/upstream/fedora-rawhide/man3/fgetc.3 @@ -5,7 +5,7 @@ .\" .\" Modified Wed Jul 28 11:12:07 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Fri Sep 8 15:48:13 1995 by Andries Brouwer (aeb@cwi.nl) -.TH fgetc 3 2023-10-31 "Linux man-pages 6.06" +.TH fgetc 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fgetc, fgets, getc, getchar, ungetc \- input of characters and strings .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fgetgrent.3 b/upstream/fedora-rawhide/man3/fgetgrent.3 index 239ad7df..cba26b2a 100644 --- a/upstream/fedora-rawhide/man3/fgetgrent.3 +++ b/upstream/fedora-rawhide/man3/fgetgrent.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:38:44 1993 by Rik Faith (faith@cs.unc.edu) -.TH fgetgrent 3 2023-10-31 "Linux man-pages 6.06" +.TH fgetgrent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fgetgrent \- get group file entry .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fgetpwent.3 b/upstream/fedora-rawhide/man3/fgetpwent.3 index 546e60b8..b27f6167 100644 --- a/upstream/fedora-rawhide/man3/fgetpwent.3 +++ b/upstream/fedora-rawhide/man3/fgetpwent.3 @@ -11,7 +11,7 @@ .\" Modified Sat Jul 24 19:37:37 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Mon May 27 22:40:48 1996 by Martin Schulze (joey@linux.de) .\" -.TH fgetpwent 3 2023-10-31 "Linux man-pages 6.06" +.TH fgetpwent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fgetpwent \- get password file entry .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fgetwc.3 b/upstream/fedora-rawhide/man3/fgetwc.3 index 575948e4..28737543 100644 --- a/upstream/fedora-rawhide/man3/fgetwc.3 +++ b/upstream/fedora-rawhide/man3/fgetwc.3 @@ -11,7 +11,7 @@ .\" ISO/IEC 9899:1999 .\" .\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk> -.TH fgetwc 3 2023-10-31 "Linux man-pages 6.06" +.TH fgetwc 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fgetwc, getwc \- read a wide character from a FILE stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fgetws.3 b/upstream/fedora-rawhide/man3/fgetws.3 index 537a834c..a9fdfcab 100644 --- a/upstream/fedora-rawhide/man3/fgetws.3 +++ b/upstream/fedora-rawhide/man3/fgetws.3 @@ -11,7 +11,7 @@ .\" ISO/IEC 9899:1999 .\" .\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk> -.TH fgetws 3 2023-10-31 "Linux man-pages 6.06" +.TH fgetws 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fgetws \- read a wide-character string from a FILE stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fileno.3 b/upstream/fedora-rawhide/man3/fileno.3 index f749e326..5c5a7178 100644 --- a/upstream/fedora-rawhide/man3/fileno.3 +++ b/upstream/fedora-rawhide/man3/fileno.3 @@ -12,7 +12,7 @@ .\" Converted for Linux, Mon Nov 29 14:24:40 1993, faith@cs.unc.edu .\" Added remark on EBADF for fileno, aeb, 2001-03-22 .\" -.TH fileno 3 2023-10-31 "Linux man-pages 6.06" +.TH fileno 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fileno \- obtain file descriptor of a stdio stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/finite.3 b/upstream/fedora-rawhide/man3/finite.3 index f448a8d6..bad355f3 100644 --- a/upstream/fedora-rawhide/man3/finite.3 +++ b/upstream/fedora-rawhide/man3/finite.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH finite 3 2023-10-31 "Linux man-pages 6.06" +.TH finite 3 2023-10-31 "Linux man-pages 6.7" .SH NAME finite, finitef, finitel, isinf, isinff, isinfl, isnan, isnanf, isnanl \- BSD floating-point classification functions diff --git a/upstream/fedora-rawhide/man3/flockfile.3 b/upstream/fedora-rawhide/man3/flockfile.3 index d1b5670b..911f8de6 100644 --- a/upstream/fedora-rawhide/man3/flockfile.3 +++ b/upstream/fedora-rawhide/man3/flockfile.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH flockfile 3 2023-10-31 "Linux man-pages 6.06" +.TH flockfile 3 2023-10-31 "Linux man-pages 6.7" .SH NAME flockfile, ftrylockfile, funlockfile \- lock FILE for stdio .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/floor.3 b/upstream/fedora-rawhide/man3/floor.3 index 7246d9d6..0f2731c7 100644 --- a/upstream/fedora-rawhide/man3/floor.3 +++ b/upstream/fedora-rawhide/man3/floor.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH floor 3 2023-10-31 "Linux man-pages 6.06" +.TH floor 3 2023-10-31 "Linux man-pages 6.7" .SH NAME floor, floorf, floorl \- largest integral value not greater than argument .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fma.3 b/upstream/fedora-rawhide/man3/fma.3 index a8497ee0..a93042b7 100644 --- a/upstream/fedora-rawhide/man3/fma.3 +++ b/upstream/fedora-rawhide/man3/fma.3 @@ -8,7 +8,7 @@ .\" Modified 2004-11-15, Added further text on FLT_ROUNDS .\" as suggested by AEB and Fabian Kreutz .\" -.TH fma 3 2023-10-31 "Linux man-pages 6.06" +.TH fma 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fma, fmaf, fmal \- floating-point multiply and add .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fmax.3 b/upstream/fedora-rawhide/man3/fmax.3 index 1b5ac673..8f502dd2 100644 --- a/upstream/fedora-rawhide/man3/fmax.3 +++ b/upstream/fedora-rawhide/man3/fmax.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH fmax 3 2023-10-31 "Linux man-pages 6.06" +.TH fmax 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fmax, fmaxf, fmaxl \- determine maximum of two floating-point numbers .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fmemopen.3 b/upstream/fedora-rawhide/man3/fmemopen.3 index 2bf1a0c1..93f3a12f 100644 --- a/upstream/fedora-rawhide/man3/fmemopen.3 +++ b/upstream/fedora-rawhide/man3/fmemopen.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH fmemopen 3 2023-10-31 "Linux man-pages 6.06" +.TH fmemopen 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fmemopen \- open memory as stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fmin.3 b/upstream/fedora-rawhide/man3/fmin.3 index 3722a398..c6011952 100644 --- a/upstream/fedora-rawhide/man3/fmin.3 +++ b/upstream/fedora-rawhide/man3/fmin.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH fmin 3 2023-10-31 "Linux man-pages 6.06" +.TH fmin 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fmin, fminf, fminl \- determine minimum of two floating-point numbers .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fmod.3 b/upstream/fedora-rawhide/man3/fmod.3 index cdcdee11..dfca42ef 100644 --- a/upstream/fedora-rawhide/man3/fmod.3 +++ b/upstream/fedora-rawhide/man3/fmod.3 @@ -13,7 +13,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH fmod 3 2023-10-31 "Linux man-pages 6.06" +.TH fmod 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fmod, fmodf, fmodl \- floating-point remainder function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fmtmsg.3 b/upstream/fedora-rawhide/man3/fmtmsg.3 index cc8e994f..ca211085 100644 --- a/upstream/fedora-rawhide/man3/fmtmsg.3 +++ b/upstream/fedora-rawhide/man3/fmtmsg.3 @@ -9,7 +9,7 @@ .\" The function is quite complex and deserves an example .\" .\" Polished, aeb, 2003-11-01 -.TH fmtmsg 3 2023-10-31 "Linux man-pages 6.06" +.TH fmtmsg 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fmtmsg \- print formatted error messages .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fnmatch.3 b/upstream/fedora-rawhide/man3/fnmatch.3 index b6b9ca68..c834ac9f 100644 --- a/upstream/fedora-rawhide/man3/fnmatch.3 +++ b/upstream/fedora-rawhide/man3/fnmatch.3 @@ -6,7 +6,7 @@ .\" Modified Sat Jul 24 19:35:54 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Mon Oct 16 00:16:29 2000 following Joseph S. Myers .\" -.TH fnmatch 3 2023-10-31 "Linux man-pages 6.06" +.TH fnmatch 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fnmatch \- match filename or pathname .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fopen.3 b/upstream/fedora-rawhide/man3/fopen.3 index 1b06259c..654c697a 100644 --- a/upstream/fedora-rawhide/man3/fopen.3 +++ b/upstream/fedora-rawhide/man3/fopen.3 @@ -14,7 +14,7 @@ .\" Modified, aeb, 960421, 970806 .\" Modified, joey, aeb, 2002-01-03 .\" -.TH fopen 3 2023-10-31 "Linux man-pages 6.06" +.TH fopen 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fopen, fdopen, freopen \- stream open functions .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fopencookie.3 b/upstream/fedora-rawhide/man3/fopencookie.3 index 366b822e..5d5d1d39 100644 --- a/upstream/fedora-rawhide/man3/fopencookie.3 +++ b/upstream/fedora-rawhide/man3/fopencookie.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH fopencookie 3 2023-12-29 "Linux man-pages 6.06" +.TH fopencookie 3 2023-12-29 "Linux man-pages 6.7" .SH NAME fopencookie \- open a custom stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fpathconf.3 b/upstream/fedora-rawhide/man3/fpathconf.3 index f510736f..af993ed0 100644 --- a/upstream/fedora-rawhide/man3/fpathconf.3 +++ b/upstream/fedora-rawhide/man3/fpathconf.3 @@ -20,7 +20,7 @@ .\" _PC_SYMLINK_MAX, .\" _PC_2_SYMLINKS .\" -.TH fpathconf 3 2023-10-31 "Linux man-pages 6.06" +.TH fpathconf 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fpathconf, pathconf \- get configuration values for files .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fpclassify.3 b/upstream/fedora-rawhide/man3/fpclassify.3 index a520dd07..8e72dd3e 100644 --- a/upstream/fedora-rawhide/man3/fpclassify.3 +++ b/upstream/fedora-rawhide/man3/fpclassify.3 @@ -6,7 +6,7 @@ .\" This was done with the help of the glibc manual. .\" .\" 2004-10-31, aeb, corrected -.TH fpclassify 3 2023-10-31 "Linux man-pages 6.06" +.TH fpclassify 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fpclassify, isfinite, isnormal, isnan, isinf \- floating-point classification macros diff --git a/upstream/fedora-rawhide/man3/fpurge.3 b/upstream/fedora-rawhide/man3/fpurge.3 index 996cd9c4..c3fbdb9d 100644 --- a/upstream/fedora-rawhide/man3/fpurge.3 +++ b/upstream/fedora-rawhide/man3/fpurge.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH fpurge 3 2023-10-31 "Linux man-pages 6.06" +.TH fpurge 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fpurge, __fpurge \- purge a stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fputwc.3 b/upstream/fedora-rawhide/man3/fputwc.3 index 816feeba..3fe0b2e4 100644 --- a/upstream/fedora-rawhide/man3/fputwc.3 +++ b/upstream/fedora-rawhide/man3/fputwc.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH fputwc 3 2023-10-31 "Linux man-pages 6.06" +.TH fputwc 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fputwc, putwc \- write a wide character to a FILE stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fputws.3 b/upstream/fedora-rawhide/man3/fputws.3 index 7db42a9e..431ab5d4 100644 --- a/upstream/fedora-rawhide/man3/fputws.3 +++ b/upstream/fedora-rawhide/man3/fputws.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH fputws 3 2023-10-31 "Linux man-pages 6.06" +.TH fputws 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fputws \- write a wide-character string to a FILE stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fread.3 b/upstream/fedora-rawhide/man3/fread.3 index f89c1742..34b11b3d 100644 --- a/upstream/fedora-rawhide/man3/fread.3 +++ b/upstream/fedora-rawhide/man3/fread.3 @@ -16,7 +16,7 @@ .\" Modified Thu Apr 20 20:43:53 1995 by Jim Van Zandt <jrv@vanzandt.mv.com> .\" Modified Fri May 17 10:21:51 1996 by Martin Schulze <joey@infodrom.north.de> .\" -.TH fread 3 2023-10-31 "Linux man-pages 6.06" +.TH fread 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fread, fwrite \- binary stream input/output .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/frexp.3 b/upstream/fedora-rawhide/man3/frexp.3 index 30e16a8b..9a5ab0d8 100644 --- a/upstream/fedora-rawhide/man3/frexp.3 +++ b/upstream/fedora-rawhide/man3/frexp.3 @@ -11,7 +11,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH frexp 3 2024-01-29 "Linux man-pages 6.06" +.TH frexp 3 2024-01-29 "Linux man-pages 6.7" .SH NAME frexp, frexpf, frexpl \- convert floating-point number to fractional and integral components diff --git a/upstream/fedora-rawhide/man3/fseek.3 b/upstream/fedora-rawhide/man3/fseek.3 index 3217f03f..c97c4d73 100644 --- a/upstream/fedora-rawhide/man3/fseek.3 +++ b/upstream/fedora-rawhide/man3/fseek.3 @@ -12,7 +12,7 @@ .\" .\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu .\" -.TH fseek 3 2023-10-31 "Linux man-pages 6.06" +.TH fseek 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fgetpos, fseek, fsetpos, ftell, rewind \- reposition a stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fseeko.3 b/upstream/fedora-rawhide/man3/fseeko.3 index 9d4e631f..fe35c976 100644 --- a/upstream/fedora-rawhide/man3/fseeko.3 +++ b/upstream/fedora-rawhide/man3/fseeko.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH fseeko 3 2023-10-31 "Linux man-pages 6.06" +.TH fseeko 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fseeko, ftello \- seek to or report file position .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ftime.3 b/upstream/fedora-rawhide/man3/ftime.3 index c7b78538..a810b36d 100644 --- a/upstream/fedora-rawhide/man3/ftime.3 +++ b/upstream/fedora-rawhide/man3/ftime.3 @@ -9,7 +9,7 @@ .\" Modified Sun Oct 18 17:31:43 1998 by Andries Brouwer (aeb@cwi.nl) .\" 2008-06-23, mtk, minor rewrites, added some details .\" -.TH ftime 3 2023-10-31 "Linux man-pages 6.06" +.TH ftime 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ftime \- return date and time .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ftok.3 b/upstream/fedora-rawhide/man3/ftok.3 index 781a2569..258276ca 100644 --- a/upstream/fedora-rawhide/man3/ftok.3 +++ b/upstream/fedora-rawhide/man3/ftok.3 @@ -7,7 +7,7 @@ .\" Changed data type of proj_id; minor fixes .\" aeb: further fixes; added notes. .\" -.TH ftok 3 2023-10-31 "Linux man-pages 6.06" +.TH ftok 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ftok \- convert a pathname and a project identifier to a System V IPC key .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fts.3 b/upstream/fedora-rawhide/man3/fts.3 index a67d94d5..fa33766a 100644 --- a/upstream/fedora-rawhide/man3/fts.3 +++ b/upstream/fedora-rawhide/man3/fts.3 @@ -10,7 +10,7 @@ .\" .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH fts 3 2024-01-16 "Linux man-pages 6.06" +.TH fts 3 2024-01-16 "Linux man-pages 6.7" .SH NAME fts, fts_open, fts_read, fts_children, fts_set, fts_close \- \ traverse a file hierarchy diff --git a/upstream/fedora-rawhide/man3/ftw.3 b/upstream/fedora-rawhide/man3/ftw.3 index 0ca77929..1488b92b 100644 --- a/upstream/fedora-rawhide/man3/ftw.3 +++ b/upstream/fedora-rawhide/man3/ftw.3 @@ -15,7 +15,7 @@ .\" 2006-05-24, Michael Kerrisk <mtk.manpages@gmail.com> .\" Added an example program. .\" -.TH ftw 3 2023-10-31 "Linux man-pages 6.06" +.TH ftw 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ftw, nftw \- file tree walk .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/futimes.3 b/upstream/fedora-rawhide/man3/futimes.3 index bb07d039..f0085262 100644 --- a/upstream/fedora-rawhide/man3/futimes.3 +++ b/upstream/fedora-rawhide/man3/futimes.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH futimes 3 2023-10-31 "Linux man-pages 6.06" +.TH futimes 3 2023-10-31 "Linux man-pages 6.7" .SH NAME futimes, lutimes \- change file timestamps .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/fwide.3 b/upstream/fedora-rawhide/man3/fwide.3 index 04944ddb..b833b57a 100644 --- a/upstream/fedora-rawhide/man3/fwide.3 +++ b/upstream/fedora-rawhide/man3/fwide.3 @@ -8,7 +8,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH fwide 3 2023-10-31 "Linux man-pages 6.06" +.TH fwide 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fwide \- set and determine the orientation of a FILE stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/gamma.3 b/upstream/fedora-rawhide/man3/gamma.3 index c1a1589d..30806249 100644 --- a/upstream/fedora-rawhide/man3/gamma.3 +++ b/upstream/fedora-rawhide/man3/gamma.3 @@ -5,7 +5,7 @@ .\" .\" Modified 2003-11-18, aeb: historical remarks .\" -.TH gamma 3 2023-10-31 "Linux man-pages 6.06" +.TH gamma 3 2023-10-31 "Linux man-pages 6.7" .SH NAME gamma, gammaf, gammal \- (logarithm of the) gamma function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/gcvt.3 b/upstream/fedora-rawhide/man3/gcvt.3 index 5945e78c..54d4943b 100644 --- a/upstream/fedora-rawhide/man3/gcvt.3 +++ b/upstream/fedora-rawhide/man3/gcvt.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:32:25 1993 by Rik Faith (faith@cs.unc.edu) -.TH gcvt 3 2023-10-31 "Linux man-pages 6.06" +.TH gcvt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME gcvt \- convert a floating-point number to a string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/get_nprocs.3 b/upstream/fedora-rawhide/man3/get_nprocs.3 index 3cc99d7f..b07bed36 100644 --- a/upstream/fedora-rawhide/man3/get_nprocs.3 +++ b/upstream/fedora-rawhide/man3/get_nprocs.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH get_nprocs 3 2023-10-31 "Linux man-pages 6.06" +.TH get_nprocs 3 2023-10-31 "Linux man-pages 6.7" .SH NAME get_nprocs, get_nprocs_conf \- get number of processors .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/get_phys_pages.3 b/upstream/fedora-rawhide/man3/get_phys_pages.3 index 6ace9a7a..714e397f 100644 --- a/upstream/fedora-rawhide/man3/get_phys_pages.3 +++ b/upstream/fedora-rawhide/man3/get_phys_pages.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH get_phys_pages 3 2023-10-31 "Linux man-pages 6.06" +.TH get_phys_pages 3 2023-10-31 "Linux man-pages 6.7" .SH NAME get_phys_pages, get_avphys_pages \- get total and available physical page counts diff --git a/upstream/fedora-rawhide/man3/getaddrinfo.3 b/upstream/fedora-rawhide/man3/getaddrinfo.3 index 7b421486..e036e943 100644 --- a/upstream/fedora-rawhide/man3/getaddrinfo.3 +++ b/upstream/fedora-rawhide/man3/getaddrinfo.3 @@ -22,7 +22,7 @@ .\" FIXME . glibc's 2.9 NEWS file documents DCCP and UDP-lite support .\" and is SCTP support now also there? .\" -.TH getaddrinfo 3 2023-10-31 "Linux man-pages 6.06" +.TH getaddrinfo 3 2024-02-18 "Linux man-pages 6.7" .SH NAME getaddrinfo, freeaddrinfo, gai_strerror \- network address and service translation @@ -501,7 +501,7 @@ contains invalid flags; or, included .B AI_CANONNAME and -.I name +.I node was NULL. .TP .B EAI_FAIL diff --git a/upstream/fedora-rawhide/man3/getaddrinfo_a.3 b/upstream/fedora-rawhide/man3/getaddrinfo_a.3 index fa1b6c3b..fe27b6c4 100644 --- a/upstream/fedora-rawhide/man3/getaddrinfo_a.3 +++ b/upstream/fedora-rawhide/man3/getaddrinfo_a.3 @@ -8,7 +8,7 @@ .\" References: http://people.redhat.com/drepper/asynchnl.pdf, .\" http://www.imperialviolet.org/2005/06/01/asynchronous-dns-lookups-with-glibc.html .\" -.TH getaddrinfo_a 3 2023-10-31 "Linux man-pages 6.06" +.TH getaddrinfo_a 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getaddrinfo_a, gai_suspend, gai_error, gai_cancel \- asynchronous network address and service translation diff --git a/upstream/fedora-rawhide/man3/getauxval.3 b/upstream/fedora-rawhide/man3/getauxval.3 index d4fbc1e8..c41cce0a 100644 --- a/upstream/fedora-rawhide/man3/getauxval.3 +++ b/upstream/fedora-rawhide/man3/getauxval.3 @@ -5,7 +5,7 @@ .\" .\" See also https://lwn.net/Articles/519085/ .\" -.TH getauxval 3 2023-10-31 "Linux man-pages 6.06" +.TH getauxval 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getauxval \- retrieve a value from the auxiliary vector .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getcontext.3 b/upstream/fedora-rawhide/man3/getcontext.3 index 246d3dfc..65150757 100644 --- a/upstream/fedora-rawhide/man3/getcontext.3 +++ b/upstream/fedora-rawhide/man3/getcontext.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getcontext 3 2023-10-31 "Linux man-pages 6.06" +.TH getcontext 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getcontext, setcontext \- get or set the user context .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getcwd.3 b/upstream/fedora-rawhide/man3/getcwd.3 index db0f981d..10044585 100644 --- a/upstream/fedora-rawhide/man3/getcwd.3 +++ b/upstream/fedora-rawhide/man3/getcwd.3 @@ -10,7 +10,7 @@ .\" Modified Mon Dec 11 13:32:51 MET 2000 by aeb .\" Modified Thu Apr 22 03:49:15 CEST 2002 by Roger Luethi <rl@hellgate.ch> .\" -.TH getcwd 3 2023-10-31 "Linux man-pages 6.06" +.TH getcwd 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getcwd, getwd, get_current_dir_name \- get current working directory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getdate.3 b/upstream/fedora-rawhide/man3/getdate.3 index abb4480f..fe15e6bd 100644 --- a/upstream/fedora-rawhide/man3/getdate.3 +++ b/upstream/fedora-rawhide/man3/getdate.3 @@ -8,7 +8,7 @@ .\" Modified, 2001-12-26, aeb .\" 2008-09-07, mtk, Various rewrites; added an example program. .\" -.TH getdate 3 2023-10-31 "Linux man-pages 6.06" +.TH getdate 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getdate, getdate_r \- convert a date-plus-time string to broken-down time .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getdirentries.3 b/upstream/fedora-rawhide/man3/getdirentries.3 index 48c29037..78fcf255 100644 --- a/upstream/fedora-rawhide/man3/getdirentries.3 +++ b/upstream/fedora-rawhide/man3/getdirentries.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getdirentries 3 2023-10-31 "Linux man-pages 6.06" +.TH getdirentries 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getdirentries \- get directory entries in a filesystem-independent format .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getdtablesize.3 b/upstream/fedora-rawhide/man3/getdtablesize.3 index b938a4c6..b792ea9a 100644 --- a/upstream/fedora-rawhide/man3/getdtablesize.3 +++ b/upstream/fedora-rawhide/man3/getdtablesize.3 @@ -5,7 +5,7 @@ .\" .\" Modified 2002-04-15 by Roger Luethi <rl@hellgate.ch> and aeb .\" -.TH getdtablesize 3 2023-10-31 "Linux man-pages 6.06" +.TH getdtablesize 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getdtablesize \- get file descriptor table size .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getentropy.3 b/upstream/fedora-rawhide/man3/getentropy.3 index 7d6c5aba..7c70623c 100644 --- a/upstream/fedora-rawhide/man3/getentropy.3 +++ b/upstream/fedora-rawhide/man3/getentropy.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getentropy 3 2023-10-31 "Linux man-pages 6.06" +.TH getentropy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getentropy \- fill a buffer with random bytes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getenv.3 b/upstream/fedora-rawhide/man3/getenv.3 index 5e4280f3..50b17cf4 100644 --- a/upstream/fedora-rawhide/man3/getenv.3 +++ b/upstream/fedora-rawhide/man3/getenv.3 @@ -11,7 +11,7 @@ .\" Modified Sat Jul 24 19:30:29 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Fri Feb 14 21:47:50 1997 by Andries Brouwer (aeb@cwi.nl) .\" -.TH getenv 3 2023-10-31 "Linux man-pages 6.06" +.TH getenv 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getenv, secure_getenv \- get an environment variable .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getfsent.3 b/upstream/fedora-rawhide/man3/getfsent.3 index d866e4b7..2bcb9585 100644 --- a/upstream/fedora-rawhide/man3/getfsent.3 +++ b/upstream/fedora-rawhide/man3/getfsent.3 @@ -5,7 +5,7 @@ .\" .\" Inspired by a page written by Walter Harms. .\" -.TH getfsent 3 2023-10-31 "Linux man-pages 6.06" +.TH getfsent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getfsent, getfsspec, getfsfile, setfsent, endfsent \- handle fstab entries .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getgrent.3 b/upstream/fedora-rawhide/man3/getgrent.3 index f9abfdcb..66c478a7 100644 --- a/upstream/fedora-rawhide/man3/getgrent.3 +++ b/upstream/fedora-rawhide/man3/getgrent.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:29:54 1993 by Rik Faith (faith@cs.unc.edu) -.TH getgrent 3 2023-10-31 "Linux man-pages 6.06" +.TH getgrent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getgrent, setgrent, endgrent \- get group file entry .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getgrent_r.3 b/upstream/fedora-rawhide/man3/getgrent_r.3 index 80ef3539..f4a2b5b0 100644 --- a/upstream/fedora-rawhide/man3/getgrent_r.3 +++ b/upstream/fedora-rawhide/man3/getgrent_r.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH getgrent_r 3 2023-10-31 "Linux man-pages 6.06" +.TH getgrent_r 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getgrent_r, fgetgrent_r \- get group file entry reentrantly .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getgrnam.3 b/upstream/fedora-rawhide/man3/getgrnam.3 index 81eb1398..fb53c6e6 100644 --- a/upstream/fedora-rawhide/man3/getgrnam.3 +++ b/upstream/fedora-rawhide/man3/getgrnam.3 @@ -11,7 +11,7 @@ .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2003-11-15 by aeb .\" -.TH getgrnam 3 2023-10-31 "Linux man-pages 6.06" +.TH getgrnam 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getgrnam, getgrnam_r, getgrgid, getgrgid_r \- get group file entry .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getgrouplist.3 b/upstream/fedora-rawhide/man3/getgrouplist.3 index 2852a9e2..33e344df 100644 --- a/upstream/fedora-rawhide/man3/getgrouplist.3 +++ b/upstream/fedora-rawhide/man3/getgrouplist.3 @@ -7,7 +7,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getgrouplist 3 2023-10-31 "Linux man-pages 6.06" +.TH getgrouplist 3 2024-03-16 "Linux man-pages 6.7" .SH NAME getgrouplist \- get list of groups to which a user belongs .SH LIBRARY @@ -142,10 +142,10 @@ ngroups = 3 int main(int argc, char *argv[]) { - int ngroups; - struct passwd *pw; - struct group *gr; - gid_t *groups; + int ngroups; + gid_t *groups; + struct group *gr; + struct passwd *pw; \& if (argc != 3) { fprintf(stderr, "Usage: %s <user> <ngroups>\en", argv[0]); @@ -179,7 +179,7 @@ main(int argc, char *argv[]) /* Display list of retrieved groups, along with group names. */ \& fprintf(stderr, "ngroups = %d\en", ngroups); - for (size_t j = 0; j < ngroups; j++) { + for (int j = 0; j < ngroups; j++) { printf("%d", groups[j]); gr = getgrgid(groups[j]); if (gr != NULL) diff --git a/upstream/fedora-rawhide/man3/gethostbyname.3 b/upstream/fedora-rawhide/man3/gethostbyname.3 index a9d1dacb..01cc0f74 100644 --- a/upstream/fedora-rawhide/man3/gethostbyname.3 +++ b/upstream/fedora-rawhide/man3/gethostbyname.3 @@ -16,7 +16,7 @@ .\" Modified 2002-08-05, Michael Kerrisk .\" Modified 2004-10-31, Andries Brouwer .\" -.TH gethostbyname 3 2023-10-31 "Linux man-pages 6.06" +.TH gethostbyname 3 2023-10-31 "Linux man-pages 6.7" .SH NAME gethostbyname, gethostbyaddr, sethostent, gethostent, endhostent, h_errno, diff --git a/upstream/fedora-rawhide/man3/gethostid.3 b/upstream/fedora-rawhide/man3/gethostid.3 index 13246b3b..79304974 100644 --- a/upstream/fedora-rawhide/man3/gethostid.3 +++ b/upstream/fedora-rawhide/man3/gethostid.3 @@ -7,7 +7,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond <esr@thyrsus.com> -.TH gethostid 3 2023-10-31 "Linux man-pages 6.06" +.TH gethostid 3 2023-10-31 "Linux man-pages 6.7" .SH NAME gethostid, sethostid \- get or set the unique identifier of the current host .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getifaddrs.3 b/upstream/fedora-rawhide/man3/getifaddrs.3 index b8146be5..e8c2bde2 100644 --- a/upstream/fedora-rawhide/man3/getifaddrs.3 +++ b/upstream/fedora-rawhide/man3/getifaddrs.3 @@ -14,7 +14,7 @@ .\" for glibc specificities, provide an example. .\" 2009-01-14 mtk, many edits and changes, rewrote example program. .\" -.TH getifaddrs 3 2023-10-31 "Linux man-pages 6.06" +.TH getifaddrs 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getifaddrs, freeifaddrs \- get interface addresses .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getipnodebyname.3 b/upstream/fedora-rawhide/man3/getipnodebyname.3 index a336a2a7..23bb9589 100644 --- a/upstream/fedora-rawhide/man3/getipnodebyname.3 +++ b/upstream/fedora-rawhide/man3/getipnodebyname.3 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" References: RFC 2553 -.TH getipnodebyname 3 2023-10-31 "Linux man-pages 6.06" +.TH getipnodebyname 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getipnodebyname, getipnodebyaddr, freehostent \- get network hostnames and addresses diff --git a/upstream/fedora-rawhide/man3/getline.3 b/upstream/fedora-rawhide/man3/getline.3 index 863860f8..991993ea 100644 --- a/upstream/fedora-rawhide/man3/getline.3 +++ b/upstream/fedora-rawhide/man3/getline.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getline 3 2023-10-31 "Linux man-pages 6.06" +.TH getline 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getline, getdelim \- delimited string input .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getloadavg.3 b/upstream/fedora-rawhide/man3/getloadavg.3 index 643b7f90..e3282824 100644 --- a/upstream/fedora-rawhide/man3/getloadavg.3 +++ b/upstream/fedora-rawhide/man3/getloadavg.3 @@ -8,7 +8,7 @@ .\" .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH getloadavg 3 2023-10-31 "Linux man-pages 6.06" +.TH getloadavg 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getloadavg \- get system load averages .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getlogin.3 b/upstream/fedora-rawhide/man3/getlogin.3 index 48ec6344..bdf83764 100644 --- a/upstream/fedora-rawhide/man3/getlogin.3 +++ b/upstream/fedora-rawhide/man3/getlogin.3 @@ -6,7 +6,7 @@ .\" Changed Tue Sep 19 01:49:29 1995, aeb: moved from man2 to man3 .\" added ref to /etc/utmp, added BUGS section, etc. .\" modified 2003 Walter Harms, aeb - added getlogin_r, note on stdin use -.TH getlogin 3 2023-10-31 "Linux man-pages 6.06" +.TH getlogin 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getlogin, getlogin_r, cuserid \- get username .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getmntent.3 b/upstream/fedora-rawhide/man3/getmntent.3 index 67fb0925..cf90b174 100644 --- a/upstream/fedora-rawhide/man3/getmntent.3 +++ b/upstream/fedora-rawhide/man3/getmntent.3 @@ -10,7 +10,7 @@ .\" Modified Sat Jul 24 21:46:57 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 961109, 031115, aeb .\" -.TH getmntent 3 2023-10-31 "Linux man-pages 6.06" +.TH getmntent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getmntent, setmntent, addmntent, endmntent, hasmntopt, getmntent_r \- get filesystem descriptor file entry diff --git a/upstream/fedora-rawhide/man3/getnameinfo.3 b/upstream/fedora-rawhide/man3/getnameinfo.3 index ed2c4f9e..c1453ba0 100644 --- a/upstream/fedora-rawhide/man3/getnameinfo.3 +++ b/upstream/fedora-rawhide/man3/getnameinfo.3 @@ -8,7 +8,7 @@ .\" 2004-12-14, mtk, Added EAI_OVERFLOW error .\" 2004-12-14 Fixed description of error return .\" -.TH getnameinfo 3 2023-10-31 "Linux man-pages 6.06" +.TH getnameinfo 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getnameinfo \- address-to-name translation in protocol-independent manner .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getnetent.3 b/upstream/fedora-rawhide/man3/getnetent.3 index cbfaadea..4ec28e18 100644 --- a/upstream/fedora-rawhide/man3/getnetent.3 +++ b/upstream/fedora-rawhide/man3/getnetent.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 21:48:06 1993 by Rik Faith (faith@cs.unc.edu) -.TH getnetent 3 2023-10-31 "Linux man-pages 6.06" +.TH getnetent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent \- get network entry diff --git a/upstream/fedora-rawhide/man3/getnetent_r.3 b/upstream/fedora-rawhide/man3/getnetent_r.3 index e3021430..fabb4c52 100644 --- a/upstream/fedora-rawhide/man3/getnetent_r.3 +++ b/upstream/fedora-rawhide/man3/getnetent_r.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getnetent_r 3 2023-10-31 "Linux man-pages 6.06" +.TH getnetent_r 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getnetent_r, getnetbyname_r, getnetbyaddr_r \- get network entry (reentrant) diff --git a/upstream/fedora-rawhide/man3/getopt.3 b/upstream/fedora-rawhide/man3/getopt.3 index d3a1bc93..71c36754 100644 --- a/upstream/fedora-rawhide/man3/getopt.3 +++ b/upstream/fedora-rawhide/man3/getopt.3 @@ -20,7 +20,7 @@ .\" the start of optstring .\" Modified 2006-12-15, mtk, Added getopt() example program. .\" -.TH getopt 3 2023-10-31 "Linux man-pages 6.06" +.TH getopt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getopt, getopt_long, getopt_long_only, optarg, optind, opterr, optopt \- Parse command-line options diff --git a/upstream/fedora-rawhide/man3/getpass.3 b/upstream/fedora-rawhide/man3/getpass.3 index 661693f7..40420c9f 100644 --- a/upstream/fedora-rawhide/man3/getpass.3 +++ b/upstream/fedora-rawhide/man3/getpass.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH getpass 3 2023-10-31 "Linux man-pages 6.06" +.TH getpass 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getpass \- get a password .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getprotoent.3 b/upstream/fedora-rawhide/man3/getprotoent.3 index c65939b5..1eb97739 100644 --- a/upstream/fedora-rawhide/man3/getprotoent.3 +++ b/upstream/fedora-rawhide/man3/getprotoent.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:26:03 1993 by Rik Faith (faith@cs.unc.edu) -.TH getprotoent 3 2023-10-31 "Linux man-pages 6.06" +.TH getprotoent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent \- get protocol entry diff --git a/upstream/fedora-rawhide/man3/getprotoent_r.3 b/upstream/fedora-rawhide/man3/getprotoent_r.3 index 0868e79e..d802b4c4 100644 --- a/upstream/fedora-rawhide/man3/getprotoent_r.3 +++ b/upstream/fedora-rawhide/man3/getprotoent_r.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getprotoent_r 3 2023-10-31 "Linux man-pages 6.06" +.TH getprotoent_r 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getprotoent_r, getprotobyname_r, getprotobynumber_r \- get protocol entry (reentrant) diff --git a/upstream/fedora-rawhide/man3/getpt.3 b/upstream/fedora-rawhide/man3/getpt.3 index 3483495e..fa6cd1c6 100644 --- a/upstream/fedora-rawhide/man3/getpt.3 +++ b/upstream/fedora-rawhide/man3/getpt.3 @@ -5,7 +5,7 @@ .\" Redistribute and modify at will. .\" %%%LICENSE_END .\" -.TH getpt 3 2023-10-31 "Linux man-pages 6.06" +.TH getpt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getpt \- open a new pseudoterminal master .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getpw.3 b/upstream/fedora-rawhide/man3/getpw.3 index 544dcaeb..70b53ec5 100644 --- a/upstream/fedora-rawhide/man3/getpw.3 +++ b/upstream/fedora-rawhide/man3/getpw.3 @@ -10,7 +10,7 @@ .\" Modified Sat Jul 24 19:23:25 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Mon May 27 21:37:47 1996 by Martin Schulze (joey@linux.de) .\" -.TH getpw 3 2023-10-31 "Linux man-pages 6.06" +.TH getpw 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getpw \- reconstruct password line entry .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getpwent.3 b/upstream/fedora-rawhide/man3/getpwent.3 index 0e34f603..cd8ba998 100644 --- a/upstream/fedora-rawhide/man3/getpwent.3 +++ b/upstream/fedora-rawhide/man3/getpwent.3 @@ -11,7 +11,7 @@ .\" Modified Sat Jul 24 19:22:14 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Mon May 27 21:37:47 1996 by Martin Schulze (joey@linux.de) .\" -.TH getpwent 3 2023-10-31 "Linux man-pages 6.06" +.TH getpwent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getpwent, setpwent, endpwent \- get password file entry .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getpwent_r.3 b/upstream/fedora-rawhide/man3/getpwent_r.3 index 5cdbec48..6b4b34a9 100644 --- a/upstream/fedora-rawhide/man3/getpwent_r.3 +++ b/upstream/fedora-rawhide/man3/getpwent_r.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH getpwent_r 3 2023-10-31 "Linux man-pages 6.06" +.TH getpwent_r 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getpwent_r, fgetpwent_r \- get passwd file entry reentrantly .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getpwnam.3 b/upstream/fedora-rawhide/man3/getpwnam.3 index 9d13d032..424ee557 100644 --- a/upstream/fedora-rawhide/man3/getpwnam.3 +++ b/upstream/fedora-rawhide/man3/getpwnam.3 @@ -15,7 +15,7 @@ .\" Modified 2003-11-15 by aeb .\" 2008-11-07, mtk, Added an example program for getpwnam_r(). .\" -.TH getpwnam 3 2023-10-31 "Linux man-pages 6.06" +.TH getpwnam 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getpwnam, getpwnam_r, getpwuid, getpwuid_r \- get password file entry .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getrpcent.3 b/upstream/fedora-rawhide/man3/getrpcent.3 index 5193b654..253b7caa 100644 --- a/upstream/fedora-rawhide/man3/getrpcent.3 +++ b/upstream/fedora-rawhide/man3/getrpcent.3 @@ -6,7 +6,7 @@ .\" %%%LICENSE_END .\" .\" @(#)getrpcent.3n 2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI -.TH getrpcent 3 2023-10-31 "Linux man-pages 6.06" +.TH getrpcent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent \- get RPC entry diff --git a/upstream/fedora-rawhide/man3/getrpcent_r.3 b/upstream/fedora-rawhide/man3/getrpcent_r.3 index a2175532..c33f3b6c 100644 --- a/upstream/fedora-rawhide/man3/getrpcent_r.3 +++ b/upstream/fedora-rawhide/man3/getrpcent_r.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getrpcent_r 3 2023-10-31 "Linux man-pages 6.06" +.TH getrpcent_r 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getrpcent_r, getrpcbyname_r, getrpcbynumber_r \- get RPC entry (reentrant) diff --git a/upstream/fedora-rawhide/man3/getrpcport.3 b/upstream/fedora-rawhide/man3/getrpcport.3 index 87d20dbd..aa7623c8 100644 --- a/upstream/fedora-rawhide/man3/getrpcport.3 +++ b/upstream/fedora-rawhide/man3/getrpcport.3 @@ -6,7 +6,7 @@ .\" %%%LICENSE_END .\" .\" @(#)getrpcport.3r 2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI -.TH getrpcport 3 2023-10-31 "Linux man-pages 6.06" +.TH getrpcport 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getrpcport \- get RPC port number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/gets.3 b/upstream/fedora-rawhide/man3/gets.3 index d3e1a306..e0cb43bb 100644 --- a/upstream/fedora-rawhide/man3/gets.3 +++ b/upstream/fedora-rawhide/man3/gets.3 @@ -7,7 +7,7 @@ .\" Modified Fri Sep 8 15:48:13 1995 by Andries Brouwer (aeb@cwi.nl) .\" Modified 2013-12-31, David Malcolm <dmalcolm@redhat.com> .\" Split gets(3) into its own page; fgetc() et al. move to fgetc(3) -.TH gets 3 2023-10-31 "Linux man-pages 6.06" +.TH gets 3 2023-10-31 "Linux man-pages 6.7" .SH NAME gets \- get a string from standard input (DEPRECATED) .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getservent.3 b/upstream/fedora-rawhide/man3/getservent.3 index 5d52bcb8..ce650aa0 100644 --- a/upstream/fedora-rawhide/man3/getservent.3 +++ b/upstream/fedora-rawhide/man3/getservent.3 @@ -12,7 +12,7 @@ .\" Modified Mon Apr 22 01:50:54 1996 by Martin Schulze <joey@infodrom.north.de> .\" 2001-07-25 added a clause about NULL proto (Martin Michlmayr or David N. Welton) .\" -.TH getservent 3 2023-10-31 "Linux man-pages 6.06" +.TH getservent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getservent, getservbyname, getservbyport, setservent, endservent \- get service entry diff --git a/upstream/fedora-rawhide/man3/getservent_r.3 b/upstream/fedora-rawhide/man3/getservent_r.3 index 4606a7f8..76c42f3e 100644 --- a/upstream/fedora-rawhide/man3/getservent_r.3 +++ b/upstream/fedora-rawhide/man3/getservent_r.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getservent_r 3 2023-10-31 "Linux man-pages 6.06" +.TH getservent_r 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getservent_r, getservbyname_r, getservbyport_r \- get service entry (reentrant) diff --git a/upstream/fedora-rawhide/man3/getspnam.3 b/upstream/fedora-rawhide/man3/getspnam.3 index 1ec493c7..d3f96260 100644 --- a/upstream/fedora-rawhide/man3/getspnam.3 +++ b/upstream/fedora-rawhide/man3/getspnam.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH getspnam 3 2023-10-31 "Linux man-pages 6.06" +.TH getspnam 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getspnam, getspnam_r, getspent, getspent_r, setspent, endspent, fgetspent, fgetspent_r, sgetspent, sgetspent_r, putspent, diff --git a/upstream/fedora-rawhide/man3/getsubopt.3 b/upstream/fedora-rawhide/man3/getsubopt.3 index 7c3e2c4e..caf03a24 100644 --- a/upstream/fedora-rawhide/man3/getsubopt.3 +++ b/upstream/fedora-rawhide/man3/getsubopt.3 @@ -23,7 +23,7 @@ .\" SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. .\" %%%LICENSE_END .\" -.TH getsubopt 3 2023-10-31 "Linux man-pages 6.06" +.TH getsubopt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getsubopt \- parse suboption arguments from a string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/gettext.3 b/upstream/fedora-rawhide/man3/gettext.3 index 19db8b9d..968ab72f 100644 --- a/upstream/fedora-rawhide/man3/gettext.3 +++ b/upstream/fedora-rawhide/man3/gettext.3 @@ -10,7 +10,7 @@ .\" GNU gettext source code and manual .\" LI18NUX 2000 Globalization Specification .\" -.TH GETTEXT 3 "May 2001" "GNU gettext 0.22.2" +.TH GETTEXT 3 "May 2001" "GNU gettext 0.22.5" .SH NAME gettext, dgettext, dcgettext \- translate message .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man3/getttyent.3 b/upstream/fedora-rawhide/man3/getttyent.3 index 7ed4fd03..aeb87ac6 100644 --- a/upstream/fedora-rawhide/man3/getttyent.3 +++ b/upstream/fedora-rawhide/man3/getttyent.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH getttyent 3 2023-10-31 "Linux man-pages 6.06" +.TH getttyent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getttyent, getttynam, setttyent, endttyent \- get ttys file entry .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getusershell.3 b/upstream/fedora-rawhide/man3/getusershell.3 index 3c2a09f5..41c5a684 100644 --- a/upstream/fedora-rawhide/man3/getusershell.3 +++ b/upstream/fedora-rawhide/man3/getusershell.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 19:17:53 1993 by Rik Faith (faith@cs.unc.edu) -.TH getusershell 3 2023-10-31 "Linux man-pages 6.06" +.TH getusershell 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getusershell, setusershell, endusershell \- get permitted user shells .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getutent.3 b/upstream/fedora-rawhide/man3/getutent.3 index d04ebbc3..f55286f8 100644 --- a/upstream/fedora-rawhide/man3/getutent.3 +++ b/upstream/fedora-rawhide/man3/getutent.3 @@ -10,7 +10,7 @@ .\" Modified Thu Jul 25 14:43:46 MET DST 1996 by Michael Haardt .\" <michael@cantor.informatik.rwth-aachen.de> .\" -.TH getutent 3 2023-10-31 "Linux man-pages 6.06" +.TH getutent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getutent, getutid, getutline, pututline, setutent, endutent, utmpname \- access utmp file entries diff --git a/upstream/fedora-rawhide/man3/getutmp.3 b/upstream/fedora-rawhide/man3/getutmp.3 index 3b48e875..6694c1ae 100644 --- a/upstream/fedora-rawhide/man3/getutmp.3 +++ b/upstream/fedora-rawhide/man3/getutmp.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getutmp 3 2023-10-31 "Linux man-pages 6.06" +.TH getutmp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getutmp, getutmpx \- copy utmp structure to utmpx, and vice versa .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getw.3 b/upstream/fedora-rawhide/man3/getw.3 index 00d0322c..a19baced 100644 --- a/upstream/fedora-rawhide/man3/getw.3 +++ b/upstream/fedora-rawhide/man3/getw.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH getw 3 2023-10-31 "Linux man-pages 6.06" +.TH getw 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getw, putw \- input and output of words (ints) .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/getwchar.3 b/upstream/fedora-rawhide/man3/getwchar.3 index 77a421c9..d8468046 100644 --- a/upstream/fedora-rawhide/man3/getwchar.3 +++ b/upstream/fedora-rawhide/man3/getwchar.3 @@ -10,7 +10,7 @@ .\" http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH getwchar 3 2023-10-31 "Linux man-pages 6.06" +.TH getwchar 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getwchar \- read a wide character from standard input .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/glob.3 b/upstream/fedora-rawhide/man3/glob.3 index 53dacacd..9457de62 100644 --- a/upstream/fedora-rawhide/man3/glob.3 +++ b/upstream/fedora-rawhide/man3/glob.3 @@ -12,7 +12,7 @@ .\" Expanded the description of various flags .\" Various wording fixes. .\" -.TH glob 3 2023-10-31 "Linux man-pages 6.06" +.TH glob 3 2023-10-31 "Linux man-pages 6.7" .SH NAME glob, globfree \- find pathnames matching a pattern, free memory from glob() .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/gnu_get_libc_version.3 b/upstream/fedora-rawhide/man3/gnu_get_libc_version.3 index b5d23fce..e02390e8 100644 --- a/upstream/fedora-rawhide/man3/gnu_get_libc_version.3 +++ b/upstream/fedora-rawhide/man3/gnu_get_libc_version.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH gnu_get_libc_version 3 2023-10-31 "Linux man-pages 6.06" +.TH gnu_get_libc_version 3 2023-10-31 "Linux man-pages 6.7" .SH NAME gnu_get_libc_version, gnu_get_libc_release \- get glibc version and release .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/grantpt.3 b/upstream/fedora-rawhide/man3/grantpt.3 index 89735e8e..8f1aca05 100644 --- a/upstream/fedora-rawhide/man3/grantpt.3 +++ b/upstream/fedora-rawhide/man3/grantpt.3 @@ -3,7 +3,7 @@ .\" This page is in the public domain. - aeb .\" %%%LICENSE_END .\" -.TH grantpt 3 2023-10-31 "Linux man-pages 6.06" +.TH grantpt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME grantpt \- grant access to the slave pseudoterminal .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/group_member.3 b/upstream/fedora-rawhide/man3/group_member.3 index b6012622..688b9cb5 100644 --- a/upstream/fedora-rawhide/man3/group_member.3 +++ b/upstream/fedora-rawhide/man3/group_member.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH group_member 3 2023-10-31 "Linux man-pages 6.06" +.TH group_member 3 2023-10-31 "Linux man-pages 6.7" .SH NAME group_member \- test whether a process is in a group .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/grub2-get-kernel-settings.3 b/upstream/fedora-rawhide/man3/grub2-get-kernel-settings.3 index b680c33b..13da0680 100644 --- a/upstream/fedora-rawhide/man3/grub2-get-kernel-settings.3 +++ b/upstream/fedora-rawhide/man3/grub2-get-kernel-settings.3 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-GET-KERNEL-SETTINGS "3" "February 2024" "GRUB 2.06" "User Commands" +.TH GRUB-GET-KERNEL-SETTINGS "3" "May 2024" "GRUB 2.06" "User Commands" .SH NAME grub-get-kernel-settings \- Evaluate the system's kernel installation settings for use while making a grub configuration file .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man3/gsignal.3 b/upstream/fedora-rawhide/man3/gsignal.3 index 1270baff..4c41dbdd 100644 --- a/upstream/fedora-rawhide/man3/gsignal.3 +++ b/upstream/fedora-rawhide/man3/gsignal.3 @@ -5,7 +5,7 @@ .\" .\" This replaces an earlier man page written by Walter Harms .\" <walter.harms@informatik.uni-oldenburg.de>. -.TH gsignal 3 2023-10-31 "Linux man-pages 6.06" +.TH gsignal 3 2023-10-31 "Linux man-pages 6.7" .SH NAME gsignal, ssignal \- software signal facility .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/hsearch.3 b/upstream/fedora-rawhide/man3/hsearch.3 index 2c3f7bb4..93e6794c 100644 --- a/upstream/fedora-rawhide/man3/hsearch.3 +++ b/upstream/fedora-rawhide/man3/hsearch.3 @@ -14,7 +14,7 @@ .\" 2008-09-03, mtk, restructured somewhat, in part after suggestions from .\" Timothy S. Nelson <wayland@wayland.id.au> .\" -.TH hsearch 3 2023-10-31 "Linux man-pages 6.06" +.TH hsearch 3 2023-10-31 "Linux man-pages 6.7" .SH NAME hcreate, hdestroy, hsearch, hcreate_r, hdestroy_r, hsearch_r \- hash table management diff --git a/upstream/fedora-rawhide/man3/hypot.3 b/upstream/fedora-rawhide/man3/hypot.3 index 16b8a85d..a7d45637 100644 --- a/upstream/fedora-rawhide/man3/hypot.3 +++ b/upstream/fedora-rawhide/man3/hypot.3 @@ -11,7 +11,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH hypot 3 2023-10-31 "Linux man-pages 6.06" +.TH hypot 3 2023-10-31 "Linux man-pages 6.7" .SH NAME hypot, hypotf, hypotl \- Euclidean distance function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iconv.3 b/upstream/fedora-rawhide/man3/iconv.3 index fcd3024a..1f9f96f4 100644 --- a/upstream/fedora-rawhide/man3/iconv.3 +++ b/upstream/fedora-rawhide/man3/iconv.3 @@ -11,7 +11,7 @@ .\" 2000-06-30 correction by Yuichi SATO <sato@complex.eng.hokudai.ac.jp> .\" 2000-11-15 aeb, fixed prototype .\" -.TH iconv 3 2023-10-31 "Linux man-pages 6.06" +.TH iconv 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iconv \- perform character set conversion .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iconv_close.3 b/upstream/fedora-rawhide/man3/iconv_close.3 index b5bb16b8..85ba8465 100644 --- a/upstream/fedora-rawhide/man3/iconv_close.3 +++ b/upstream/fedora-rawhide/man3/iconv_close.3 @@ -7,7 +7,7 @@ .\" GNU glibc-2 source code and manual .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH iconv_close 3 2023-10-31 "Linux man-pages 6.06" +.TH iconv_close 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iconv_close \- deallocate descriptor for character set conversion .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iconv_open.3 b/upstream/fedora-rawhide/man3/iconv_open.3 index 24e18ae9..f6a64b94 100644 --- a/upstream/fedora-rawhide/man3/iconv_open.3 +++ b/upstream/fedora-rawhide/man3/iconv_open.3 @@ -11,7 +11,7 @@ .\" 2007-03-31 Bruno Haible, Describe the glibc/libiconv //TRANSLIT .\" and //IGNORE extensions for 'tocode'. .\" -.TH iconv_open 3 2023-10-31 "Linux man-pages 6.06" +.TH iconv_open 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iconv_open \- allocate descriptor for character set conversion .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/if_nameindex.3 b/upstream/fedora-rawhide/man3/if_nameindex.3 index 63f3c10c..7f4c42ed 100644 --- a/upstream/fedora-rawhide/man3/if_nameindex.3 +++ b/upstream/fedora-rawhide/man3/if_nameindex.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH if_nameindex 3 2023-10-31 "Linux man-pages 6.06" +.TH if_nameindex 3 2023-10-31 "Linux man-pages 6.7" .SH NAME if_nameindex, if_freenameindex \- get network interface names and indexes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/if_nametoindex.3 b/upstream/fedora-rawhide/man3/if_nametoindex.3 index 87fc5b19..e4e183ea 100644 --- a/upstream/fedora-rawhide/man3/if_nametoindex.3 +++ b/upstream/fedora-rawhide/man3/if_nametoindex.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH if_nametoindex 3 2023-10-31 "Linux man-pages 6.06" +.TH if_nametoindex 3 2023-10-31 "Linux man-pages 6.7" .SH NAME if_nametoindex, if_indextoname \- mappings between network interface names and indexes diff --git a/upstream/fedora-rawhide/man3/ilogb.3 b/upstream/fedora-rawhide/man3/ilogb.3 index c819b085..69ce0a45 100644 --- a/upstream/fedora-rawhide/man3/ilogb.3 +++ b/upstream/fedora-rawhide/man3/ilogb.3 @@ -7,7 +7,7 @@ .\" .\" Inspired by a page by Walter Harms created 2002-08-10 .\" -.TH ilogb 3 2023-10-31 "Linux man-pages 6.06" +.TH ilogb 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ilogb, ilogbf, ilogbl \- get integer exponent of a floating-point value .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/index.3 b/upstream/fedora-rawhide/man3/index.3 index 94739e8b..ebccd46d 100644 --- a/upstream/fedora-rawhide/man3/index.3 +++ b/upstream/fedora-rawhide/man3/index.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH index 3 2023-10-31 "Linux man-pages 6.06" +.TH index 3 2023-10-31 "Linux man-pages 6.7" .SH NAME index, rindex \- locate character in string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/inet.3 b/upstream/fedora-rawhide/man3/inet.3 index e7794341..554fd11c 100644 --- a/upstream/fedora-rawhide/man3/inet.3 +++ b/upstream/fedora-rawhide/man3/inet.3 @@ -20,7 +20,7 @@ .\" Add discussion of Classful Addressing, noting that it is obsolete. .\" Added an EXAMPLE program. .\" -.TH inet 3 2023-10-31 "Linux man-pages 6.06" +.TH inet 3 2023-10-31 "Linux man-pages 6.7" .SH NAME inet_aton, inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet_lnaof, inet_netof \- Internet address manipulation routines diff --git a/upstream/fedora-rawhide/man3/inet_net_pton.3 b/upstream/fedora-rawhide/man3/inet_net_pton.3 index 7c1ba43b..e8264e8a 100644 --- a/upstream/fedora-rawhide/man3/inet_net_pton.3 +++ b/upstream/fedora-rawhide/man3/inet_net_pton.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH inet_net_pton 3 2023-10-31 "Linux man-pages 6.06" +.TH inet_net_pton 3 2023-10-31 "Linux man-pages 6.7" .SH NAME inet_net_pton, inet_net_ntop \- Internet network number conversion .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/inet_ntop.3 b/upstream/fedora-rawhide/man3/inet_ntop.3 index 9f7df8f6..3d2d78bb 100644 --- a/upstream/fedora-rawhide/man3/inet_ntop.3 +++ b/upstream/fedora-rawhide/man3/inet_ntop.3 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" References: RFC 2553 -.TH inet_ntop 3 2023-10-31 "Linux man-pages 6.06" +.TH inet_ntop 3 2023-10-31 "Linux man-pages 6.7" .SH NAME inet_ntop \- convert IPv4 and IPv6 addresses from binary to text form .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/inet_pton.3 b/upstream/fedora-rawhide/man3/inet_pton.3 index f3176247..37eb97cd 100644 --- a/upstream/fedora-rawhide/man3/inet_pton.3 +++ b/upstream/fedora-rawhide/man3/inet_pton.3 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" References: RFC 2553 -.TH inet_pton 3 2023-10-31 "Linux man-pages 6.06" +.TH inet_pton 3 2023-10-31 "Linux man-pages 6.7" .SH NAME inet_pton \- convert IPv4 and IPv6 addresses from text to binary form .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/initgroups.3 b/upstream/fedora-rawhide/man3/initgroups.3 index 7e2fd08b..b389f2b8 100644 --- a/upstream/fedora-rawhide/man3/initgroups.3 +++ b/upstream/fedora-rawhide/man3/initgroups.3 @@ -10,7 +10,7 @@ .\" Modified 1993-07-24 by Rik Faith <faith@cs.unc.edu> .\" Modified 2004-10-10 by aeb .\" -.TH initgroups 3 2023-10-31 "Linux man-pages 6.06" +.TH initgroups 3 2023-10-31 "Linux man-pages 6.7" .SH NAME initgroups \- initialize the supplementary group access list .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/insque.3 b/upstream/fedora-rawhide/man3/insque.3 index 49504941..dba8dfb3 100644 --- a/upstream/fedora-rawhide/man3/insque.3 +++ b/upstream/fedora-rawhide/man3/insque.3 @@ -14,7 +14,7 @@ .\" mtk, 2010-09-09: Noted glibc 2.4 bug, added info on circular .\" lists, added example program .\" -.TH insque 3 2023-10-31 "Linux man-pages 6.06" +.TH insque 3 2023-10-31 "Linux man-pages 6.7" .SH NAME insque, remque \- insert/remove an item from a queue .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/intro.3 b/upstream/fedora-rawhide/man3/intro.3 index e9f0e0e7..f7146146 100644 --- a/upstream/fedora-rawhide/man3/intro.3 +++ b/upstream/fedora-rawhide/man3/intro.3 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" 2007-10-23 mtk, Nearly a complete rewrite of the earlier page. -.TH intro 3 2023-10-31 "Linux man-pages 6.06" +.TH intro 3 2023-10-31 "Linux man-pages 6.7" .SH NAME intro \- introduction to library functions .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man3/isalpha.3 b/upstream/fedora-rawhide/man3/isalpha.3 index 076ab191..68afb7a7 100644 --- a/upstream/fedora-rawhide/man3/isalpha.3 +++ b/upstream/fedora-rawhide/man3/isalpha.3 @@ -8,7 +8,7 @@ .\" Modified Sat Sep 2 21:52:01 1995 by Jim Van Zandt <jrv@vanzandt.mv.com> .\" Modified Mon May 27 22:55:26 1996 by Martin Schulze (joey@linux.de) .\" -.TH isalpha 3 2023-10-31 "Linux man-pages 6.06" +.TH isalpha 3 2024-02-25 "Linux man-pages 6.7" .SH NAME isalnum, isalpha, isascii, isblank, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, isxdigit, @@ -170,9 +170,9 @@ alphanumeric character. .BR isspace () checks for white-space characters. In the -.B """C""" +.B \[dq]C\[dq] and -.B """POSIX""" +.B \[dq]POSIX\[dq] locales, these are: space, form-feed .RB ( \[aq]\ef\[aq] ), newline diff --git a/upstream/fedora-rawhide/man3/isatty.3 b/upstream/fedora-rawhide/man3/isatty.3 index 13933e3b..22765509 100644 --- a/upstream/fedora-rawhide/man3/isatty.3 +++ b/upstream/fedora-rawhide/man3/isatty.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH isatty 3 2023-10-31 "Linux man-pages 6.06" +.TH isatty 3 2023-10-31 "Linux man-pages 6.7" .SH NAME isatty \- test whether a file descriptor refers to a terminal .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/isfdtype.3 b/upstream/fedora-rawhide/man3/isfdtype.3 index f5b64bb3..1717a1cc 100644 --- a/upstream/fedora-rawhide/man3/isfdtype.3 +++ b/upstream/fedora-rawhide/man3/isfdtype.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH isfdtype 3 2023-10-31 "Linux man-pages 6.06" +.TH isfdtype 3 2023-10-31 "Linux man-pages 6.7" .SH NAME isfdtype \- test file type of a file descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/isgreater.3 b/upstream/fedora-rawhide/man3/isgreater.3 index 82dff9b5..e0975239 100644 --- a/upstream/fedora-rawhide/man3/isgreater.3 +++ b/upstream/fedora-rawhide/man3/isgreater.3 @@ -6,7 +6,7 @@ .\" 2002-07-27 Walter Harms .\" this was done with the help of the glibc manual .\" -.TH isgreater 3 2023-10-31 "Linux man-pages 6.06" +.TH isgreater 3 2023-10-31 "Linux man-pages 6.7" .SH NAME isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered \- floating-point relational tests without exception for NaN diff --git a/upstream/fedora-rawhide/man3/iswalnum.3 b/upstream/fedora-rawhide/man3/iswalnum.3 index fae45e35..20109874 100644 --- a/upstream/fedora-rawhide/man3/iswalnum.3 +++ b/upstream/fedora-rawhide/man3/iswalnum.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswalnum 3 2023-10-31 "Linux man-pages 6.06" +.TH iswalnum 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswalnum \- test for alphanumeric wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iswalpha.3 b/upstream/fedora-rawhide/man3/iswalpha.3 index 2f0d74f7..612a8d8f 100644 --- a/upstream/fedora-rawhide/man3/iswalpha.3 +++ b/upstream/fedora-rawhide/man3/iswalpha.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswalpha 3 2023-10-31 "Linux man-pages 6.06" +.TH iswalpha 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswalpha \- test for alphabetic wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iswblank.3 b/upstream/fedora-rawhide/man3/iswblank.3 index fc6d96d9..d50034c3 100644 --- a/upstream/fedora-rawhide/man3/iswblank.3 +++ b/upstream/fedora-rawhide/man3/iswblank.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswblank 3 2023-10-31 "Linux man-pages 6.06" +.TH iswblank 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswblank \- test for whitespace wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iswcntrl.3 b/upstream/fedora-rawhide/man3/iswcntrl.3 index 3f8fc550..bd1a3df1 100644 --- a/upstream/fedora-rawhide/man3/iswcntrl.3 +++ b/upstream/fedora-rawhide/man3/iswcntrl.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswcntrl 3 2023-10-31 "Linux man-pages 6.06" +.TH iswcntrl 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswcntrl \- test for control wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iswctype.3 b/upstream/fedora-rawhide/man3/iswctype.3 index 177f8120..78e96865 100644 --- a/upstream/fedora-rawhide/man3/iswctype.3 +++ b/upstream/fedora-rawhide/man3/iswctype.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswctype 3 2023-10-31 "Linux man-pages 6.06" +.TH iswctype 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswctype \- wide-character classification .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iswdigit.3 b/upstream/fedora-rawhide/man3/iswdigit.3 index 07226801..c0559192 100644 --- a/upstream/fedora-rawhide/man3/iswdigit.3 +++ b/upstream/fedora-rawhide/man3/iswdigit.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswdigit 3 2023-10-31 "Linux man-pages 6.06" +.TH iswdigit 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswdigit \- test for decimal digit wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iswgraph.3 b/upstream/fedora-rawhide/man3/iswgraph.3 index 5a7e145c..35ee1a3c 100644 --- a/upstream/fedora-rawhide/man3/iswgraph.3 +++ b/upstream/fedora-rawhide/man3/iswgraph.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswgraph 3 2023-10-31 "Linux man-pages 6.06" +.TH iswgraph 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswgraph \- test for graphic wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iswlower.3 b/upstream/fedora-rawhide/man3/iswlower.3 index c36aa060..8aa77424 100644 --- a/upstream/fedora-rawhide/man3/iswlower.3 +++ b/upstream/fedora-rawhide/man3/iswlower.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswlower 3 2023-10-31 "Linux man-pages 6.06" +.TH iswlower 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswlower \- test for lowercase wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iswprint.3 b/upstream/fedora-rawhide/man3/iswprint.3 index 67fe6c19..bc58b25a 100644 --- a/upstream/fedora-rawhide/man3/iswprint.3 +++ b/upstream/fedora-rawhide/man3/iswprint.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswprint 3 2023-10-31 "Linux man-pages 6.06" +.TH iswprint 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswprint \- test for printing wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iswpunct.3 b/upstream/fedora-rawhide/man3/iswpunct.3 index 535f133d..6e74b609 100644 --- a/upstream/fedora-rawhide/man3/iswpunct.3 +++ b/upstream/fedora-rawhide/man3/iswpunct.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswpunct 3 2023-10-31 "Linux man-pages 6.06" +.TH iswpunct 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswpunct \- test for punctuation or symbolic wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iswspace.3 b/upstream/fedora-rawhide/man3/iswspace.3 index 1bdd9beb..e87b80af 100644 --- a/upstream/fedora-rawhide/man3/iswspace.3 +++ b/upstream/fedora-rawhide/man3/iswspace.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswspace 3 2023-10-31 "Linux man-pages 6.06" +.TH iswspace 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswspace \- test for whitespace wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iswupper.3 b/upstream/fedora-rawhide/man3/iswupper.3 index d6413621..82ec81b9 100644 --- a/upstream/fedora-rawhide/man3/iswupper.3 +++ b/upstream/fedora-rawhide/man3/iswupper.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswupper 3 2023-10-31 "Linux man-pages 6.06" +.TH iswupper 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswupper \- test for uppercase wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/iswxdigit.3 b/upstream/fedora-rawhide/man3/iswxdigit.3 index 5e76e39f..5eb226b1 100644 --- a/upstream/fedora-rawhide/man3/iswxdigit.3 +++ b/upstream/fedora-rawhide/man3/iswxdigit.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH iswxdigit 3 2023-10-31 "Linux man-pages 6.06" +.TH iswxdigit 3 2023-10-31 "Linux man-pages 6.7" .SH NAME iswxdigit \- test for hexadecimal digit wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/j0.3 b/upstream/fedora-rawhide/man3/j0.3 index fcff0703..919c256a 100644 --- a/upstream/fedora-rawhide/man3/j0.3 +++ b/upstream/fedora-rawhide/man3/j0.3 @@ -14,7 +14,7 @@ .\" Modified 2004-11-12 as per suggestion by Fabian Kreutz/AEB .\" 2008-07-24, mtk, moved yxx() material into separate y0.3 page .\" -.TH j0 3 2023-10-31 "Linux man-pages 6.06" +.TH j0 3 2023-10-31 "Linux man-pages 6.7" .SH NAME j0, j0f, j0l, j1, j1f, j1l, jn, jnf, jnl \- Bessel functions of the first kind diff --git a/upstream/fedora-rawhide/man3/key_setsecret.3 b/upstream/fedora-rawhide/man3/key_setsecret.3 index 0025b6a8..a8c4470d 100644 --- a/upstream/fedora-rawhide/man3/key_setsecret.3 +++ b/upstream/fedora-rawhide/man3/key_setsecret.3 @@ -5,7 +5,7 @@ .\" .\" I had no way the check the functions out .\" be careful -.TH key_setsecret 3 2023-10-31 "Linux man-pages 6.06" +.TH key_setsecret 3 2023-10-31 "Linux man-pages 6.7" .SH NAME key_decryptsession, key_encryptsession, key_setsecret, key_gendes, key_secretkey_is_set \- interfaces to rpc keyserver daemon diff --git a/upstream/fedora-rawhide/man3/killpg.3 b/upstream/fedora-rawhide/man3/killpg.3 index 49fdcb89..14533efa 100644 --- a/upstream/fedora-rawhide/man3/killpg.3 +++ b/upstream/fedora-rawhide/man3/killpg.3 @@ -11,7 +11,7 @@ .\" Added notes on CAP_KILL .\" Modified 2004-06-21 by aeb .\" -.TH killpg 3 2023-10-31 "Linux man-pages 6.06" +.TH killpg 3 2023-10-31 "Linux man-pages 6.7" .SH NAME killpg \- send signal to a process group .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ldexp.3 b/upstream/fedora-rawhide/man3/ldexp.3 index 070e92ad..926aa47f 100644 --- a/upstream/fedora-rawhide/man3/ldexp.3 +++ b/upstream/fedora-rawhide/man3/ldexp.3 @@ -12,7 +12,7 @@ .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2004-10-31 by aeb .\" -.TH ldexp 3 2023-10-31 "Linux man-pages 6.06" +.TH ldexp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ldexp, ldexpf, ldexpl \- multiply floating-point number by integral power of 2 .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/lgamma.3 b/upstream/fedora-rawhide/man3/lgamma.3 index a08e2d87..cd4d57a1 100644 --- a/upstream/fedora-rawhide/man3/lgamma.3 +++ b/upstream/fedora-rawhide/man3/lgamma.3 @@ -6,7 +6,7 @@ .\" .\" based on glibc infopages .\" -.TH lgamma 3 2023-10-31 "Linux man-pages 6.06" +.TH lgamma 3 2023-10-31 "Linux man-pages 6.7" .SH NAME lgamma, lgammaf, lgammal, lgamma_r, lgammaf_r, lgammal_r, signgam \- log gamma function diff --git a/upstream/fedora-rawhide/man3/libsystemd.3 b/upstream/fedora-rawhide/man3/libsystemd.3 index 73f6ab4e..d917a4f8 100644 --- a/upstream/fedora-rawhide/man3/libsystemd.3 +++ b/upstream/fedora-rawhide/man3/libsystemd.3 @@ -1,5 +1,5 @@ '\" t -.TH "LIBSYSTEMD" "3" "" "systemd 255" "libsystemd" +.TH "LIBSYSTEMD" "3" "" "systemd 256~rc3" "libsystemd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -77,10 +77,7 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBlibudev\fR(1), -\fBpkg-config\fR(1), -\m[blue]\fBInterface Portability and Stability Promise\fR\m[]\&\s-2\u[1]\d\s+2 +\fBsystemd\fR(1), \fBlibudev\fR(1), \fBpkg-config\fR(1), \m[blue]\fBInterface Portability and Stability Promise\fR\m[]\&\s-2\u[1]\d\s+2 .SH "NOTES" .IP " 1." 4 Interface Portability and Stability Promise diff --git a/upstream/fedora-rawhide/man3/libudev.3 b/upstream/fedora-rawhide/man3/libudev.3 index ebc82bdb..3aeb3739 100644 --- a/upstream/fedora-rawhide/man3/libudev.3 +++ b/upstream/fedora-rawhide/man3/libudev.3 @@ -1,5 +1,5 @@ '\" t -.TH "LIBUDEV" "3" "" "systemd 255" "libudev" +.TH "LIBUDEV" "3" "" "systemd 256~rc3" "libudev" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -72,12 +72,4 @@ API instead) and the object to query the udev daemon (which should not be used by new software at all)\&. .SH "SEE ALSO" .PP -\fBudev_new\fR(3), -\fBudev_device_new_from_syspath\fR(3), -\fBudev_enumerate_new\fR(3), -\fBudev_monitor_new_from_netlink\fR(3), -\fBudev_list_entry\fR(3), -\fBsystemd\fR(1), -\fBsd-device\fR(3), -\fBsd-hwdb\fR(3), -\fBpkg-config\fR(1) +\fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_enumerate_new\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBudev_list_entry\fR(3), \fBsystemd\fR(1), \fBsd-device\fR(3), \fBsd-hwdb\fR(3), \fBpkg-config\fR(1) diff --git a/upstream/fedora-rawhide/man3/lio_listio.3 b/upstream/fedora-rawhide/man3/lio_listio.3 index 5439e8b5..18293587 100644 --- a/upstream/fedora-rawhide/man3/lio_listio.3 +++ b/upstream/fedora-rawhide/man3/lio_listio.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH lio_listio 3 2023-10-31 "Linux man-pages 6.06" +.TH lio_listio 3 2023-10-31 "Linux man-pages 6.7" .SH NAME lio_listio \- initiate a list of I/O requests .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/list.3 b/upstream/fedora-rawhide/man3/list.3 index f5ce0fd9..cc77bde8 100644 --- a/upstream/fedora-rawhide/man3/list.3 +++ b/upstream/fedora-rawhide/man3/list.3 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: BSD-3-Clause .\" .\" -.TH LIST 3 2023-10-31 "Linux man-pages 6.06" +.TH LIST 3 2023-10-31 "Linux man-pages 6.7" .SH NAME LIST_EMPTY, LIST_ENTRY, diff --git a/upstream/fedora-rawhide/man3/localeconv.3 b/upstream/fedora-rawhide/man3/localeconv.3 index 5cd8ec49..a4b17a93 100644 --- a/upstream/fedora-rawhide/man3/localeconv.3 +++ b/upstream/fedora-rawhide/man3/localeconv.3 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified Sat Jul 24 19:01:20 1993 by Rik Faith (faith@cs.unc.edu) -.TH localeconv 3 2023-10-31 "Linux man-pages 6.06" +.TH localeconv 3 2023-10-31 "Linux man-pages 6.7" .SH NAME localeconv \- get numeric formatting information .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/lockf.3 b/upstream/fedora-rawhide/man3/lockf.3 index fee68f61..f8b005f4 100644 --- a/upstream/fedora-rawhide/man3/lockf.3 +++ b/upstream/fedora-rawhide/man3/lockf.3 @@ -7,7 +7,7 @@ .\" Added section stuff, aeb, 2002-04-22. .\" Corrected include file, drepper, 2003-06-15. .\" -.TH lockf 3 2023-10-31 "Linux man-pages 6.06" +.TH lockf 3 2024-03-03 "Linux man-pages 6.7" .SH NAME lockf \- apply, test or remove a POSIX lock on an open file .SH LIBRARY @@ -17,7 +17,7 @@ Standard C library .nf .B #include <unistd.h> .P -.BI "int lockf(int " fd ", int " cmd ", off_t " len ); +.BI "int lockf(int " fd ", int " op ", off_t " len ); .fi .P .RS -4 @@ -37,7 +37,7 @@ Apply, test, or remove a POSIX lock on a section of an open file. The file is specified by .IR fd , a file descriptor open for writing, the action by -.IR cmd , +.IR op , and the section consists of byte positions .IR pos .. pos + len \-1 if @@ -118,7 +118,7 @@ been memory-mapped by another process. .B EBADF .I fd is not an open file descriptor; or -.I cmd +.I op is .B F_LOCK or @@ -128,7 +128,8 @@ and is not a writable file descriptor. .TP .B EDEADLK -The command was +.I op +was .B F_LOCK and this lock operation would cause a deadlock. .TP @@ -139,7 +140,7 @@ delivery of a signal caught by a handler; see .TP .B EINVAL An invalid operation was specified in -.IR cmd . +.IR op . .TP .B ENOLCK Too many segment locks open, lock table is full. diff --git a/upstream/fedora-rawhide/man3/log.3 b/upstream/fedora-rawhide/man3/log.3 index 392e4a01..89d30752 100644 --- a/upstream/fedora-rawhide/man3/log.3 +++ b/upstream/fedora-rawhide/man3/log.3 @@ -14,7 +14,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH log 3 2023-10-31 "Linux man-pages 6.06" +.TH log 3 2023-10-31 "Linux man-pages 6.7" .SH NAME log, logf, logl \- natural logarithmic function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/log10.3 b/upstream/fedora-rawhide/man3/log10.3 index 6f80e5ff..3090864c 100644 --- a/upstream/fedora-rawhide/man3/log10.3 +++ b/upstream/fedora-rawhide/man3/log10.3 @@ -14,7 +14,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH log10 3 2023-10-31 "Linux man-pages 6.06" +.TH log10 3 2024-03-12 "Linux man-pages 6.7" .SH NAME log10, log10f, log10l \- base-10 logarithmic function .SH LIBRARY @@ -42,10 +42,10 @@ Feature Test Macro Requirements for glibc (see || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE .fi .SH DESCRIPTION -These functions return the base 10 logarithm of +These functions return the base-10 logarithm of .IR x . .SH RETURN VALUE -On success, these functions return the base 10 logarithm of +On success, these functions return the base-10 logarithm of .IR x . .P For special cases, including where diff --git a/upstream/fedora-rawhide/man3/log1p.3 b/upstream/fedora-rawhide/man3/log1p.3 index 44249631..dff3b5b3 100644 --- a/upstream/fedora-rawhide/man3/log1p.3 +++ b/upstream/fedora-rawhide/man3/log1p.3 @@ -7,7 +7,7 @@ .\" .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) -.TH log1p 3 2023-10-31 "Linux man-pages 6.06" +.TH log1p 3 2023-10-31 "Linux man-pages 6.7" .SH NAME log1p, log1pf, log1pl \- logarithm of 1 plus argument .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/log2.3 b/upstream/fedora-rawhide/man3/log2.3 index 41edf923..29cc1ef6 100644 --- a/upstream/fedora-rawhide/man3/log2.3 +++ b/upstream/fedora-rawhide/man3/log2.3 @@ -14,7 +14,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH log2 3 2023-10-31 "Linux man-pages 6.06" +.TH log2 3 2024-03-12 "Linux man-pages 6.7" .SH NAME log2, log2f, log2l \- base-2 logarithmic function .SH LIBRARY @@ -41,10 +41,10 @@ Feature Test Macro Requirements for glibc (see _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L .fi .SH DESCRIPTION -These functions return the base 2 logarithm of +These functions return the base-2 logarithm of .IR x . .SH RETURN VALUE -On success, these functions return the base 2 logarithm of +On success, these functions return the base-2 logarithm of .IR x . .P For special cases, including where diff --git a/upstream/fedora-rawhide/man3/logb.3 b/upstream/fedora-rawhide/man3/logb.3 index c74184ea..1319d940 100644 --- a/upstream/fedora-rawhide/man3/logb.3 +++ b/upstream/fedora-rawhide/man3/logb.3 @@ -7,7 +7,7 @@ .\" .\" Inspired by a page by Walter Harms created 2002-08-10 .\" -.TH logb 3 2023-10-31 "Linux man-pages 6.06" +.TH logb 3 2024-03-12 "Linux man-pages 6.7" .SH NAME logb, logbf, logbl \- get exponent of a floating-point value .SH LIBRARY @@ -57,9 +57,10 @@ If .B FLT_RADIX is 2, .BI logb( x ) -is equal to -.BI floor(log2( x ))\fR, -except that it is probably faster. +is similar to +.BI floor(log2(fabs( x )))\f[R],\f[] +except that the latter may give an incorrect integer +due to intermediate rounding. .P If .I x diff --git a/upstream/fedora-rawhide/man3/login.3 b/upstream/fedora-rawhide/man3/login.3 index edf30ef1..a77a7280 100644 --- a/upstream/fedora-rawhide/man3/login.3 +++ b/upstream/fedora-rawhide/man3/login.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH login 3 2023-10-31 "Linux man-pages 6.06" +.TH login 3 2023-10-31 "Linux man-pages 6.7" .SH NAME login, logout \- write utmp and wtmp entries .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/lrint.3 b/upstream/fedora-rawhide/man3/lrint.3 index fa346fa8..af429304 100644 --- a/upstream/fedora-rawhide/man3/lrint.3 +++ b/upstream/fedora-rawhide/man3/lrint.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH lrint 3 2023-10-31 "Linux man-pages 6.06" +.TH lrint 3 2023-10-31 "Linux man-pages 6.7" .SH NAME lrint, lrintf, lrintl, llrint, llrintf, llrintl \- round to nearest integer .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/lround.3 b/upstream/fedora-rawhide/man3/lround.3 index 9cd2d154..1e947ffc 100644 --- a/upstream/fedora-rawhide/man3/lround.3 +++ b/upstream/fedora-rawhide/man3/lround.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH lround 3 2023-10-31 "Linux man-pages 6.06" +.TH lround 3 2023-10-31 "Linux man-pages 6.7" .SH NAME lround, lroundf, lroundl, llround, llroundf, llroundl \- round to nearest integer diff --git a/upstream/fedora-rawhide/man3/lsearch.3 b/upstream/fedora-rawhide/man3/lsearch.3 index e568df94..211f41cc 100644 --- a/upstream/fedora-rawhide/man3/lsearch.3 +++ b/upstream/fedora-rawhide/man3/lsearch.3 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Corrected prototype and include, aeb, 990927 -.TH lsearch 3 2023-10-31 "Linux man-pages 6.06" +.TH lsearch 3 2023-10-31 "Linux man-pages 6.7" .SH NAME lfind, lsearch \- linear search of an array .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/lseek64.3 b/upstream/fedora-rawhide/man3/lseek64.3 index 981135da..9e2801f7 100644 --- a/upstream/fedora-rawhide/man3/lseek64.3 +++ b/upstream/fedora-rawhide/man3/lseek64.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH lseek64 3 2023-10-31 "Linux man-pages 6.06" +.TH lseek64 3 2023-10-31 "Linux man-pages 6.7" .SH NAME lseek64 \- reposition 64-bit read/write file offset .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/makecontext.3 b/upstream/fedora-rawhide/man3/makecontext.3 index cc6d6df8..5fc342fc 100644 --- a/upstream/fedora-rawhide/man3/makecontext.3 +++ b/upstream/fedora-rawhide/man3/makecontext.3 @@ -6,7 +6,7 @@ .\" .\" 2006-08-02, mtk, Added example program .\" -.TH makecontext 3 2023-10-31 "Linux man-pages 6.06" +.TH makecontext 3 2023-10-31 "Linux man-pages 6.7" .SH NAME makecontext, swapcontext \- manipulate user context .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/makedev.3 b/upstream/fedora-rawhide/man3/makedev.3 index fde31518..dbf851aa 100644 --- a/upstream/fedora-rawhide/man3/makedev.3 +++ b/upstream/fedora-rawhide/man3/makedev.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH makedev 3 2023-10-31 "Linux man-pages 6.06" +.TH makedev 3 2023-10-31 "Linux man-pages 6.7" .SH NAME makedev, major, minor \- manage a device number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mallinfo.3 b/upstream/fedora-rawhide/man3/mallinfo.3 index f33c67c0..dcac910e 100644 --- a/upstream/fedora-rawhide/man3/mallinfo.3 +++ b/upstream/fedora-rawhide/man3/mallinfo.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mallinfo 3 2023-10-31 "Linux man-pages 6.06" +.TH mallinfo 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mallinfo, mallinfo2 \- obtain memory allocation information .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/malloc.3 b/upstream/fedora-rawhide/man3/malloc.3 index 748a0f30..0ef2cc91 100644 --- a/upstream/fedora-rawhide/man3/malloc.3 +++ b/upstream/fedora-rawhide/man3/malloc.3 @@ -12,7 +12,7 @@ .\" FIXME . Review http://austingroupbugs.net/view.php?id=374 .\" to see what changes are required on this page. .\" -.TH malloc 3 2023-10-31 "Linux man-pages 6.06" +.TH malloc 3 2023-10-31 "Linux man-pages 6.7" .SH NAME malloc, free, calloc, realloc, reallocarray \- allocate and free dynamic memory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/malloc_get_state.3 b/upstream/fedora-rawhide/man3/malloc_get_state.3 index f9c6ee31..bf6fe5e0 100644 --- a/upstream/fedora-rawhide/man3/malloc_get_state.3 +++ b/upstream/fedora-rawhide/man3/malloc_get_state.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH malloc_get_state 3 2023-11-01 "Linux man-pages 6.06" +.TH malloc_get_state 3 2023-11-01 "Linux man-pages 6.7" .SH NAME malloc_get_state, malloc_set_state \- record and restore state of malloc implementation diff --git a/upstream/fedora-rawhide/man3/malloc_hook.3 b/upstream/fedora-rawhide/man3/malloc_hook.3 index 69405ddb..bb1aa69f 100644 --- a/upstream/fedora-rawhide/man3/malloc_hook.3 +++ b/upstream/fedora-rawhide/man3/malloc_hook.3 @@ -5,7 +5,7 @@ .\" Heavily based on glibc documentation .\" Polished, added docs, removed glibc doc bug, 2002-07-20, aeb .\" -.TH __malloc_hook 3 2023-10-31 "Linux man-pages 6.06" +.TH __malloc_hook 3 2023-10-31 "Linux man-pages 6.7" .SH NAME __malloc_hook, __malloc_initialize_hook, __memalign_hook, __free_hook, __realloc_hook, diff --git a/upstream/fedora-rawhide/man3/malloc_info.3 b/upstream/fedora-rawhide/man3/malloc_info.3 index 109adb1e..9df31cf3 100644 --- a/upstream/fedora-rawhide/man3/malloc_info.3 +++ b/upstream/fedora-rawhide/man3/malloc_info.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH malloc_info 3 2023-10-31 "Linux man-pages 6.06" +.TH malloc_info 3 2024-02-26 "Linux man-pages 6.7" .SH NAME malloc_info \- export malloc state to a stream .SH LIBRARY @@ -162,7 +162,7 @@ glibc 2.13 .EE .in .SS Program source -.\" [[memory leak]] SRC BEGIN (malloc_info.c) +.\" SRC BEGIN (malloc_info.c) .EX #include <err.h> #include <errno.h> diff --git a/upstream/fedora-rawhide/man3/malloc_stats.3 b/upstream/fedora-rawhide/man3/malloc_stats.3 index 47c14f95..95980e5c 100644 --- a/upstream/fedora-rawhide/man3/malloc_stats.3 +++ b/upstream/fedora-rawhide/man3/malloc_stats.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH malloc_stats 3 2023-10-31 "Linux man-pages 6.06" +.TH malloc_stats 3 2023-10-31 "Linux man-pages 6.7" .SH NAME malloc_stats \- print memory allocation statistics .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/malloc_trim.3 b/upstream/fedora-rawhide/man3/malloc_trim.3 index 46eeb10e..02dba1e4 100644 --- a/upstream/fedora-rawhide/man3/malloc_trim.3 +++ b/upstream/fedora-rawhide/man3/malloc_trim.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH malloc_trim 3 2023-10-31 "Linux man-pages 6.06" +.TH malloc_trim 3 2023-10-31 "Linux man-pages 6.7" .SH NAME malloc_trim \- release free memory from the heap .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/malloc_usable_size.3 b/upstream/fedora-rawhide/man3/malloc_usable_size.3 index 174d5a17..3c30aaeb 100644 --- a/upstream/fedora-rawhide/man3/malloc_usable_size.3 +++ b/upstream/fedora-rawhide/man3/malloc_usable_size.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH malloc_usable_size 3 2023-10-31 "Linux man-pages 6.06" +.TH malloc_usable_size 3 2023-10-31 "Linux man-pages 6.7" .SH NAME malloc_usable_size \- obtain size of block of memory allocated from heap .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mallopt.3 b/upstream/fedora-rawhide/man3/mallopt.3 index d6557680..6922b0fa 100644 --- a/upstream/fedora-rawhide/man3/mallopt.3 +++ b/upstream/fedora-rawhide/man3/mallopt.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mallopt 3 2023-10-31 "Linux man-pages 6.06" +.TH mallopt 3 2024-02-26 "Linux man-pages 6.7" .SH NAME mallopt \- set memory allocation parameters .SH LIBRARY @@ -569,7 +569,7 @@ main(): returned from second free() call .in .SS Program source \& -.\" [[memory leak]] SRC BEGIN (mallopt.c) +.\" SRC BEGIN (mallopt.c) .EX #include <malloc.h> #include <stdio.h> diff --git a/upstream/fedora-rawhide/man3/matherr.3 b/upstream/fedora-rawhide/man3/matherr.3 index d8ac97c5..351baf51 100644 --- a/upstream/fedora-rawhide/man3/matherr.3 +++ b/upstream/fedora-rawhide/man3/matherr.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH matherr 3 2023-10-31 "Linux man-pages 6.06" +.TH matherr 3 2024-02-26 "Linux man-pages 6.7" .SH NAME matherr \- SVID math library exception handling .SH LIBRARY @@ -357,7 +357,7 @@ x=12345.000000 .in .SS Program source \& -.\" [[deprecated]] SRC BEGIN (matherr.c) +.\" SRC BEGIN (matherr.c) .EX #define _SVID_SOURCE #include <errno.h> diff --git a/upstream/fedora-rawhide/man3/mblen.3 b/upstream/fedora-rawhide/man3/mblen.3 index 888f9d94..6946b00e 100644 --- a/upstream/fedora-rawhide/man3/mblen.3 +++ b/upstream/fedora-rawhide/man3/mblen.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH mblen 3 2023-10-31 "Linux man-pages 6.06" +.TH mblen 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mblen \- determine number of bytes in next multibyte character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mbrlen.3 b/upstream/fedora-rawhide/man3/mbrlen.3 index dc43678a..a444a6a1 100644 --- a/upstream/fedora-rawhide/man3/mbrlen.3 +++ b/upstream/fedora-rawhide/man3/mbrlen.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH mbrlen 3 2023-10-31 "Linux man-pages 6.06" +.TH mbrlen 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mbrlen \- determine number of bytes in next multibyte character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mbrtowc.3 b/upstream/fedora-rawhide/man3/mbrtowc.3 index 000d4564..c35f5405 100644 --- a/upstream/fedora-rawhide/man3/mbrtowc.3 +++ b/upstream/fedora-rawhide/man3/mbrtowc.3 @@ -10,7 +10,7 @@ .\" http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH mbrtowc 3 2023-10-31 "Linux man-pages 6.06" +.TH mbrtowc 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mbrtowc \- convert a multibyte sequence to a wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mbsinit.3 b/upstream/fedora-rawhide/man3/mbsinit.3 index 3b6811c8..fc76d623 100644 --- a/upstream/fedora-rawhide/man3/mbsinit.3 +++ b/upstream/fedora-rawhide/man3/mbsinit.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH mbsinit 3 2024-01-28 "Linux man-pages 6.06" +.TH mbsinit 3 2024-01-28 "Linux man-pages 6.7" .SH NAME mbsinit \- test for initial shift state .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mbsnrtowcs.3 b/upstream/fedora-rawhide/man3/mbsnrtowcs.3 index f5207b9c..5d683a01 100644 --- a/upstream/fedora-rawhide/man3/mbsnrtowcs.3 +++ b/upstream/fedora-rawhide/man3/mbsnrtowcs.3 @@ -8,7 +8,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH mbsnrtowcs 3 2023-10-31 "Linux man-pages 6.06" +.TH mbsnrtowcs 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mbsnrtowcs \- convert a multibyte string to a wide-character string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mbsrtowcs.3 b/upstream/fedora-rawhide/man3/mbsrtowcs.3 index 0ac883a7..6844536c 100644 --- a/upstream/fedora-rawhide/man3/mbsrtowcs.3 +++ b/upstream/fedora-rawhide/man3/mbsrtowcs.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH mbsrtowcs 3 2023-11-19 "Linux man-pages 6.06" +.TH mbsrtowcs 3 2024-02-26 "Linux man-pages 6.7" .SH NAME mbsrtowcs \- convert a multibyte string to a wide-character string (restartable) .SH LIBRARY @@ -19,7 +19,8 @@ Standard C library .nf .B #include <wchar.h> .P -.BI "size_t mbsrtowcs(wchar_t " dest "[restrict ." dsize "], const char **restrict " src , +.BI "size_t mbsrtowcs(wchar_t " dest "[restrict ." dsize ], +.BI " const char **restrict " src , .BI " size_t " dsize ", mbstate_t *restrict " ps ); .fi .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man3/mbstowcs.3 b/upstream/fedora-rawhide/man3/mbstowcs.3 index d26ef0e3..6a0d6559 100644 --- a/upstream/fedora-rawhide/man3/mbstowcs.3 +++ b/upstream/fedora-rawhide/man3/mbstowcs.3 @@ -10,7 +10,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH mbstowcs 3 2023-11-14 "Linux man-pages 6.06" +.TH mbstowcs 3 2023-11-14 "Linux man-pages 6.7" .SH NAME mbstowcs \- convert a multibyte string to a wide-character string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mbtowc.3 b/upstream/fedora-rawhide/man3/mbtowc.3 index e095321e..0e071443 100644 --- a/upstream/fedora-rawhide/man3/mbtowc.3 +++ b/upstream/fedora-rawhide/man3/mbtowc.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH mbtowc 3 2023-10-31 "Linux man-pages 6.06" +.TH mbtowc 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mbtowc \- convert a multibyte sequence to a wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mcheck.3 b/upstream/fedora-rawhide/man3/mcheck.3 index 6ad4241d..7b6c7dab 100644 --- a/upstream/fedora-rawhide/man3/mcheck.3 +++ b/upstream/fedora-rawhide/man3/mcheck.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mcheck 3 2023-10-31 "Linux man-pages 6.06" +.TH mcheck 3 2024-02-26 "Linux man-pages 6.7" .SH NAME mcheck, mcheck_check_all, mcheck_pedantic, mprobe \- heap consistency checking .SH LIBRARY @@ -179,7 +179,7 @@ Aborted (core dumped) .in .SS Program source \& -.\" [[memory leak]] SRC BEGIN (mcheck.c) +.\" SRC BEGIN (mcheck.c) .EX #include <mcheck.h> #include <stdio.h> diff --git a/upstream/fedora-rawhide/man3/memccpy.3 b/upstream/fedora-rawhide/man3/memccpy.3 index dfb3b1b1..71e4fcec 100644 --- a/upstream/fedora-rawhide/man3/memccpy.3 +++ b/upstream/fedora-rawhide/man3/memccpy.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:57:24 1993 by Rik Faith (faith@cs.unc.edu) -.TH memccpy 3 2023-10-31 "Linux man-pages 6.06" +.TH memccpy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME memccpy \- copy memory area .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/memchr.3 b/upstream/fedora-rawhide/man3/memchr.3 index 5cbeed47..716fabcf 100644 --- a/upstream/fedora-rawhide/man3/memchr.3 +++ b/upstream/fedora-rawhide/man3/memchr.3 @@ -10,7 +10,7 @@ .\" Modified Wed Feb 20 21:09:36 2002, Ian Redfern (redferni@logica.com) .\" 2008-07-09, mtk, add rawmemchr() .\" -.TH memchr 3 2023-10-31 "Linux man-pages 6.06" +.TH memchr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME memchr, memrchr, rawmemchr \- scan memory for a character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/memcmp.3 b/upstream/fedora-rawhide/man3/memcmp.3 index b00efd04..76a8934f 100644 --- a/upstream/fedora-rawhide/man3/memcmp.3 +++ b/upstream/fedora-rawhide/man3/memcmp.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:55:27 1993 by Rik Faith (faith@cs.unc.edu) -.TH memcmp 3 2023-10-31 "Linux man-pages 6.06" +.TH memcmp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME memcmp \- compare memory areas .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/memcpy.3 b/upstream/fedora-rawhide/man3/memcpy.3 index b1e7168c..553a2618 100644 --- a/upstream/fedora-rawhide/man3/memcpy.3 +++ b/upstream/fedora-rawhide/man3/memcpy.3 @@ -9,7 +9,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sun Jul 25 10:41:09 1993 by Rik Faith (faith@cs.unc.edu) -.TH memcpy 3 2023-10-31 "Linux man-pages 6.06" +.TH memcpy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME memcpy \- copy memory area .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/memfrob.3 b/upstream/fedora-rawhide/man3/memfrob.3 index d4012ea2..7f7e3442 100644 --- a/upstream/fedora-rawhide/man3/memfrob.3 +++ b/upstream/fedora-rawhide/man3/memfrob.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:54:45 1993 by Rik Faith (faith@cs.unc.edu) -.TH memfrob 3 2023-10-31 "Linux man-pages 6.06" +.TH memfrob 3 2023-10-31 "Linux man-pages 6.7" .SH NAME memfrob \- frobnicate (obfuscate) a memory area .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/memmem.3 b/upstream/fedora-rawhide/man3/memmem.3 index 64f145e7..711361db 100644 --- a/upstream/fedora-rawhide/man3/memmem.3 +++ b/upstream/fedora-rawhide/man3/memmem.3 @@ -8,7 +8,7 @@ .\" 386BSD man pages .\" Modified Sat Jul 24 18:50:48 1993 by Rik Faith (faith@cs.unc.edu) .\" Interchanged 'needle' and 'haystack'; added history, aeb, 980113. -.TH memmem 3 2023-10-31 "Linux man-pages 6.06" +.TH memmem 3 2023-10-31 "Linux man-pages 6.7" .SH NAME memmem \- locate a substring .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/memmove.3 b/upstream/fedora-rawhide/man3/memmove.3 index b05cdd0c..f0e3e9fc 100644 --- a/upstream/fedora-rawhide/man3/memmove.3 +++ b/upstream/fedora-rawhide/man3/memmove.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:49:59 1993 by Rik Faith (faith@cs.unc.edu) -.TH memmove 3 2023-10-31 "Linux man-pages 6.06" +.TH memmove 3 2023-10-31 "Linux man-pages 6.7" .SH NAME memmove \- copy memory area .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mempcpy.3 b/upstream/fedora-rawhide/man3/mempcpy.3 index 2c3d8086..376636f7 100644 --- a/upstream/fedora-rawhide/man3/mempcpy.3 +++ b/upstream/fedora-rawhide/man3/mempcpy.3 @@ -6,7 +6,7 @@ .\" Heavily based on glibc infopages, copyright Free Software Foundation .\" .\" aeb, 2003, polished a little -.TH mempcpy 3 2023-10-31 "Linux man-pages 6.06" +.TH mempcpy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mempcpy, wmempcpy \- copy memory area .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/memset.3 b/upstream/fedora-rawhide/man3/memset.3 index bf6b7ab1..64eb203f 100644 --- a/upstream/fedora-rawhide/man3/memset.3 +++ b/upstream/fedora-rawhide/man3/memset.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:49:23 1993 by Rik Faith (faith@cs.unc.edu) -.TH memset 3 2023-10-31 "Linux man-pages 6.06" +.TH memset 3 2023-10-31 "Linux man-pages 6.7" .SH NAME memset \- fill memory with a constant byte .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mkdtemp.3 b/upstream/fedora-rawhide/man3/mkdtemp.3 index 913103b0..d7daaee3 100644 --- a/upstream/fedora-rawhide/man3/mkdtemp.3 +++ b/upstream/fedora-rawhide/man3/mkdtemp.3 @@ -4,7 +4,7 @@ .\" and GNU libc documentation .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH mkdtemp 3 2023-10-31 "Linux man-pages 6.06" +.TH mkdtemp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mkdtemp \- create a unique temporary directory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mkfifo.3 b/upstream/fedora-rawhide/man3/mkfifo.3 index 273517f0..0f5c21cb 100644 --- a/upstream/fedora-rawhide/man3/mkfifo.3 +++ b/upstream/fedora-rawhide/man3/mkfifo.3 @@ -6,7 +6,7 @@ .\" .\" changed section from 2 to 3, aeb, 950919 .\" -.TH mkfifo 3 2023-10-31 "Linux man-pages 6.06" +.TH mkfifo 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mkfifo, mkfifoat \- make a FIFO special file (a named pipe) .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mkstemp.3 b/upstream/fedora-rawhide/man3/mkstemp.3 index 08649356..2b7a986a 100644 --- a/upstream/fedora-rawhide/man3/mkstemp.3 +++ b/upstream/fedora-rawhide/man3/mkstemp.3 @@ -13,7 +13,7 @@ .\" Modified 990328, aeb .\" 2008-06-19, mtk, Added mkostemp(); various other changes .\" -.TH mkstemp 3 2023-10-31 "Linux man-pages 6.06" +.TH mkstemp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mkstemp, mkostemp, mkstemps, mkostemps \- create a unique temporary file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mktemp.3 b/upstream/fedora-rawhide/man3/mktemp.3 index dbc7d0e8..fb405940 100644 --- a/upstream/fedora-rawhide/man3/mktemp.3 +++ b/upstream/fedora-rawhide/man3/mktemp.3 @@ -12,7 +12,7 @@ .\" (prompted by Scott Burkett <scottb@IntNet.net>) .\" Modified Sun Mar 28 23:44:38 1999 by Andries Brouwer (aeb@cwi.nl) .\" -.TH mktemp 3 2023-10-31 "Linux man-pages 6.06" +.TH mktemp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mktemp \- make a unique temporary filename .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/modf.3 b/upstream/fedora-rawhide/man3/modf.3 index b5c88f61..c510733d 100644 --- a/upstream/fedora-rawhide/man3/modf.3 +++ b/upstream/fedora-rawhide/man3/modf.3 @@ -11,7 +11,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH modf 3 2023-10-31 "Linux man-pages 6.06" +.TH modf 3 2023-10-31 "Linux man-pages 6.7" .SH NAME modf, modff, modfl \- extract signed integral and fractional values from floating-point number diff --git a/upstream/fedora-rawhide/man3/mq_close.3 b/upstream/fedora-rawhide/man3/mq_close.3 index 7640af41..1f121654 100644 --- a/upstream/fedora-rawhide/man3/mq_close.3 +++ b/upstream/fedora-rawhide/man3/mq_close.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mq_close 3 2023-10-31 "Linux man-pages 6.06" +.TH mq_close 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mq_close \- close a message queue descriptor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mq_getattr.3 b/upstream/fedora-rawhide/man3/mq_getattr.3 index 7737679a..7c124eaa 100644 --- a/upstream/fedora-rawhide/man3/mq_getattr.3 +++ b/upstream/fedora-rawhide/man3/mq_getattr.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mq_getattr 3 2023-10-31 "Linux man-pages 6.06" +.TH mq_getattr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mq_getattr, mq_setattr \- get/set message queue attributes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mq_notify.3 b/upstream/fedora-rawhide/man3/mq_notify.3 index c3ba915d..591eb323 100644 --- a/upstream/fedora-rawhide/man3/mq_notify.3 +++ b/upstream/fedora-rawhide/man3/mq_notify.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mq_notify 3 2023-10-31 "Linux man-pages 6.06" +.TH mq_notify 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mq_notify \- register for notification when a message is available .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mq_open.3 b/upstream/fedora-rawhide/man3/mq_open.3 index 5a61f3d5..09b112fd 100644 --- a/upstream/fedora-rawhide/man3/mq_open.3 +++ b/upstream/fedora-rawhide/man3/mq_open.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mq_open 3 2023-10-31 "Linux man-pages 6.06" +.TH mq_open 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mq_open \- open a message queue .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mq_receive.3 b/upstream/fedora-rawhide/man3/mq_receive.3 index 62459e53..aa90aaa7 100644 --- a/upstream/fedora-rawhide/man3/mq_receive.3 +++ b/upstream/fedora-rawhide/man3/mq_receive.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mq_receive 3 2023-10-31 "Linux man-pages 6.06" +.TH mq_receive 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mq_receive, mq_timedreceive \- receive a message from a message queue .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mq_send.3 b/upstream/fedora-rawhide/man3/mq_send.3 index 701abf31..a083dbeb 100644 --- a/upstream/fedora-rawhide/man3/mq_send.3 +++ b/upstream/fedora-rawhide/man3/mq_send.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mq_send 3 2023-10-31 "Linux man-pages 6.06" +.TH mq_send 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mq_send, mq_timedsend \- send a message to a message queue .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mq_unlink.3 b/upstream/fedora-rawhide/man3/mq_unlink.3 index c68e663b..819dd21c 100644 --- a/upstream/fedora-rawhide/man3/mq_unlink.3 +++ b/upstream/fedora-rawhide/man3/mq_unlink.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mq_unlink 3 2023-10-31 "Linux man-pages 6.06" +.TH mq_unlink 3 2023-10-31 "Linux man-pages 6.7" .SH NAME mq_unlink \- remove a message queue .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/mtrace.3 b/upstream/fedora-rawhide/man3/mtrace.3 index 8a98fae2..61e8251d 100644 --- a/upstream/fedora-rawhide/man3/mtrace.3 +++ b/upstream/fedora-rawhide/man3/mtrace.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mtrace 3 2023-10-31 "Linux man-pages 6.06" +.TH mtrace 3 2024-02-26 "Linux man-pages 6.7" .SH NAME mtrace, muntrace \- malloc tracing .SH LIBRARY @@ -124,7 +124,7 @@ The demonstration uses the following program: .P .in +4n .RB "$ " "cat t_mtrace.c" -.\" [[memory leak]] SRC BEGIN (t_mtrace.c) +.\" SRC BEGIN (t_mtrace.c) .EX #include <mcheck.h> #include <stdio.h> diff --git a/upstream/fedora-rawhide/man3/nan.3 b/upstream/fedora-rawhide/man3/nan.3 index 4ee2f7cd..67739529 100644 --- a/upstream/fedora-rawhide/man3/nan.3 +++ b/upstream/fedora-rawhide/man3/nan.3 @@ -7,7 +7,7 @@ .\" .\" Corrections by aeb .\" -.TH nan 3 2023-10-31 "Linux man-pages 6.06" +.TH nan 3 2023-10-31 "Linux man-pages 6.7" .SH NAME nan, nanf, nanl \- return 'Not a Number' .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/netlink.3 b/upstream/fedora-rawhide/man3/netlink.3 index 4f964418..5040521b 100644 --- a/upstream/fedora-rawhide/man3/netlink.3 +++ b/upstream/fedora-rawhide/man3/netlink.3 @@ -5,7 +5,7 @@ .\" Based on the original comments from Alexey Kuznetsov .\" $Id: netlink.3,v 1.1 1999/05/14 17:17:24 freitag Exp $ .\" -.TH netlink 3 2023-10-31 "Linux man-pages 6.06" +.TH netlink 3 2023-10-31 "Linux man-pages 6.7" .SH NAME netlink \- Netlink macros .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/newlocale.3 b/upstream/fedora-rawhide/man3/newlocale.3 index 40d53798..4bbaf149 100644 --- a/upstream/fedora-rawhide/man3/newlocale.3 +++ b/upstream/fedora-rawhide/man3/newlocale.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH newlocale 3 2023-10-31 "Linux man-pages 6.06" +.TH newlocale 3 2023-10-31 "Linux man-pages 6.7" .SH NAME newlocale, freelocale \- create, modify, and free a locale object .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/nextafter.3 b/upstream/fedora-rawhide/man3/nextafter.3 index 589b4892..51b770ff 100644 --- a/upstream/fedora-rawhide/man3/nextafter.3 +++ b/upstream/fedora-rawhide/man3/nextafter.3 @@ -7,7 +7,7 @@ .\" .\" Based on glibc infopages .\" -.TH nextafter 3 2023-10-31 "Linux man-pages 6.06" +.TH nextafter 3 2023-10-31 "Linux man-pages 6.7" .SH NAME nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl \- floating-point number manipulation diff --git a/upstream/fedora-rawhide/man3/nextup.3 b/upstream/fedora-rawhide/man3/nextup.3 index b1594f9c..422143dd 100644 --- a/upstream/fedora-rawhide/man3/nextup.3 +++ b/upstream/fedora-rawhide/man3/nextup.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH nextup 3 2023-10-31 "Linux man-pages 6.06" +.TH nextup 3 2023-10-31 "Linux man-pages 6.7" .SH NAME nextup, nextupf, nextupl, nextdown, nextdownf, nextdownl \- return next floating-point number toward positive/negative infinity diff --git a/upstream/fedora-rawhide/man3/ngettext.3 b/upstream/fedora-rawhide/man3/ngettext.3 index 9f687cb8..d6f9283f 100644 --- a/upstream/fedora-rawhide/man3/ngettext.3 +++ b/upstream/fedora-rawhide/man3/ngettext.3 @@ -10,7 +10,7 @@ .\" GNU gettext source code and manual .\" LI18NUX 2000 Globalization Specification .\" -.TH NGETTEXT 3 "May 2001" "GNU gettext 0.22.2" +.TH NGETTEXT 3 "May 2001" "GNU gettext 0.22.5" .SH NAME ngettext, dngettext, dcngettext \- translate message and choose plural form .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man3/nl_langinfo.3 b/upstream/fedora-rawhide/man3/nl_langinfo.3 index a605b8e3..2b9fa512 100644 --- a/upstream/fedora-rawhide/man3/nl_langinfo.3 +++ b/upstream/fedora-rawhide/man3/nl_langinfo.3 @@ -11,7 +11,7 @@ .\" .\" Corrected prototype, 2002-10-18, aeb .\" -.TH nl_langinfo 3 2024-01-28 "Linux man-pages 6.06" +.TH nl_langinfo 3 2024-01-28 "Linux man-pages 6.7" .SH NAME nl_langinfo, nl_langinfo_l \- query language and locale information .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ntp_gettime.3 b/upstream/fedora-rawhide/man3/ntp_gettime.3 index 1bc71f76..cb1f4f1d 100644 --- a/upstream/fedora-rawhide/man3/ntp_gettime.3 +++ b/upstream/fedora-rawhide/man3/ntp_gettime.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH ntp_gettime 3 2023-10-31 "Linux man-pages 6.06" +.TH ntp_gettime 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ntp_gettime, ntp_gettimex \- get time parameters (NTP daemon interface) .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/offsetof.3 b/upstream/fedora-rawhide/man3/offsetof.3 index b63e94f5..3cf03010 100644 --- a/upstream/fedora-rawhide/man3/offsetof.3 +++ b/upstream/fedora-rawhide/man3/offsetof.3 @@ -25,7 +25,7 @@ .\" References: .\" /usr/lib/gcc/i486-linux-gnu/4.1.1/include/stddef.h .\" glibc-doc -.TH offsetof 3 2023-10-31 "Linux man-pages 6.06" +.TH offsetof 3 2023-10-31 "Linux man-pages 6.7" .SH NAME offsetof \- offset of a structure member .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/on_exit.3 b/upstream/fedora-rawhide/man3/on_exit.3 index ad3402a6..1f5a33a4 100644 --- a/upstream/fedora-rawhide/man3/on_exit.3 +++ b/upstream/fedora-rawhide/man3/on_exit.3 @@ -9,7 +9,7 @@ .\" 386BSD man pages .\" Modified 1993-04-02, David Metcalfe .\" Modified 1993-07-25, Rik Faith (faith@cs.unc.edu) -.TH on_exit 3 2023-10-31 "Linux man-pages 6.06" +.TH on_exit 3 2023-10-31 "Linux man-pages 6.7" .SH NAME on_exit \- register a function to be called at normal process termination .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/open_memstream.3 b/upstream/fedora-rawhide/man3/open_memstream.3 index f7e928e9..ce5ad7cb 100644 --- a/upstream/fedora-rawhide/man3/open_memstream.3 +++ b/upstream/fedora-rawhide/man3/open_memstream.3 @@ -5,7 +5,7 @@ .\" .\" 2008-12-04, Petr Baudis <pasky@suse.cz>: Document open_wmemstream() .\" -.TH open_memstream 3 2023-12-28 "Linux man-pages 6.06" +.TH open_memstream 3 2023-12-28 "Linux man-pages 6.7" .SH NAME open_memstream, open_wmemstream \- open a dynamic memory buffer stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/opendir.3 b/upstream/fedora-rawhide/man3/opendir.3 index 1bbe0e44..5c8fcca2 100644 --- a/upstream/fedora-rawhide/man3/opendir.3 +++ b/upstream/fedora-rawhide/man3/opendir.3 @@ -10,7 +10,7 @@ .\" Modified Sat Jul 24 18:46:01 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 11 June 1995 by Andries Brouwer (aeb@cwi.nl) .\" 2007-07-30 Ulrich Drepper <drepper@redhat.com>: document fdopendir(). -.TH opendir 3 2023-10-31 "Linux man-pages 6.06" +.TH opendir 3 2023-10-31 "Linux man-pages 6.7" .SH NAME opendir, fdopendir \- open a directory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/openpty.3 b/upstream/fedora-rawhide/man3/openpty.3 index 32081d28..505c4814 100644 --- a/upstream/fedora-rawhide/man3/openpty.3 +++ b/upstream/fedora-rawhide/man3/openpty.3 @@ -8,7 +8,7 @@ .\" .\" Added -lutil remark, 030718 .\" -.TH openpty 3 2023-10-31 "Linux man-pages 6.06" +.TH openpty 3 2023-10-31 "Linux man-pages 6.7" .SH NAME openpty, login_tty, forkpty \- terminal utility functions .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/perror.3 b/upstream/fedora-rawhide/man3/perror.3 index 7dd1fff5..2bd83c25 100644 --- a/upstream/fedora-rawhide/man3/perror.3 +++ b/upstream/fedora-rawhide/man3/perror.3 @@ -10,7 +10,7 @@ .\" (msmith@falcon.mercer.peachnet.edu) and various other changes. .\" Modified 1996-05-16 by Martin Schulze (joey@infodrom.north.de) .\" -.TH perror 3 2023-10-31 "Linux man-pages 6.06" +.TH perror 3 2023-10-31 "Linux man-pages 6.7" .SH NAME perror \- print a system error message .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/popen.3 b/upstream/fedora-rawhide/man3/popen.3 index a02754b9..6c2cd00a 100644 --- a/upstream/fedora-rawhide/man3/popen.3 +++ b/upstream/fedora-rawhide/man3/popen.3 @@ -10,7 +10,7 @@ .\" Modified Sat May 18 20:37:44 1996 by Martin Schulze (joey@linux.de) .\" Modified 7 May 1998 by Joseph S. Myers (jsm28@cam.ac.uk) .\" -.TH popen 3 2023-10-31 "Linux man-pages 6.06" +.TH popen 3 2023-10-31 "Linux man-pages 6.7" .SH NAME popen, pclose \- pipe stream to or from a process .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/posix_fallocate.3 b/upstream/fedora-rawhide/man3/posix_fallocate.3 index fad84750..f70d27c0 100644 --- a/upstream/fedora-rawhide/man3/posix_fallocate.3 +++ b/upstream/fedora-rawhide/man3/posix_fallocate.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH posix_fallocate 3 2023-10-31 "Linux man-pages 6.06" +.TH posix_fallocate 3 2023-10-31 "Linux man-pages 6.7" .SH NAME posix_fallocate \- allocate file space .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/posix_madvise.3 b/upstream/fedora-rawhide/man3/posix_madvise.3 index 4ccffc0c..440feb4e 100644 --- a/upstream/fedora-rawhide/man3/posix_madvise.3 +++ b/upstream/fedora-rawhide/man3/posix_madvise.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH posix_madvise 3 2023-10-31 "Linux man-pages 6.06" +.TH posix_madvise 3 2023-10-31 "Linux man-pages 6.7" .SH NAME posix_madvise \- give advice about patterns of memory usage .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/posix_memalign.3 b/upstream/fedora-rawhide/man3/posix_memalign.3 index 903704ad..194c55a0 100644 --- a/upstream/fedora-rawhide/man3/posix_memalign.3 +++ b/upstream/fedora-rawhide/man3/posix_memalign.3 @@ -7,7 +7,7 @@ .\" 2001-10-11, 2003-08-22, aeb, added some details .\" 2012-03-23, Michael Kerrisk <mtk.manpages@mail.com> .\" Document pvalloc() and aligned_alloc() -.TH posix_memalign 3 2023-11-24 "Linux man-pages 6.06" +.TH posix_memalign 3 2023-11-24 "Linux man-pages 6.7" .SH NAME posix_memalign, aligned_alloc, memalign, valloc, pvalloc \- allocate aligned memory diff --git a/upstream/fedora-rawhide/man3/posix_openpt.3 b/upstream/fedora-rawhide/man3/posix_openpt.3 index 79f6af9b..8d255578 100644 --- a/upstream/fedora-rawhide/man3/posix_openpt.3 +++ b/upstream/fedora-rawhide/man3/posix_openpt.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH posix_openpt 3 2023-10-31 "Linux man-pages 6.06" +.TH posix_openpt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME posix_openpt \- open a pseudoterminal device .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/posix_spawn.3 b/upstream/fedora-rawhide/man3/posix_spawn.3 index 6b3fcd5f..8fa746f8 100644 --- a/upstream/fedora-rawhide/man3/posix_spawn.3 +++ b/upstream/fedora-rawhide/man3/posix_spawn.3 @@ -8,7 +8,7 @@ .\" POSIX 1003.1-2004 documentation .\" (http://www.opengroup.org/onlinepubs/009695399) .\" -.TH posix_spawn 3 2023-10-31 "Linux man-pages 6.06" +.TH posix_spawn 3 2023-10-31 "Linux man-pages 6.7" .SH NAME posix_spawn, posix_spawnp \- spawn a process .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pow.3 b/upstream/fedora-rawhide/man3/pow.3 index 3703978b..83fd8fb6 100644 --- a/upstream/fedora-rawhide/man3/pow.3 +++ b/upstream/fedora-rawhide/man3/pow.3 @@ -13,7 +13,7 @@ .\" Modified 1995-08-14 by Arnt Gulbrandsen <agulbra@troll.no> .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) -.TH pow 3 2023-10-31 "Linux man-pages 6.06" +.TH pow 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pow, powf, powl \- power functions .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pow10.3 b/upstream/fedora-rawhide/man3/pow10.3 index 0f9a03eb..0a0bdacb 100644 --- a/upstream/fedora-rawhide/man3/pow10.3 +++ b/upstream/fedora-rawhide/man3/pow10.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pow10 3 2023-10-31 "Linux man-pages 6.06" +.TH pow10 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pow10, pow10f, pow10l \- base-10 power functions .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/powerof2.3 b/upstream/fedora-rawhide/man3/powerof2.3 index cd8965f4..cc21e4de 100644 --- a/upstream/fedora-rawhide/man3/powerof2.3 +++ b/upstream/fedora-rawhide/man3/powerof2.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH powerof2 3 2023-10-31 "Linux man-pages 6.06" +.TH powerof2 3 2023-10-31 "Linux man-pages 6.7" .SH NAME powerof2 \- test if a value is a power of 2 .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/printf.3 b/upstream/fedora-rawhide/man3/printf.3 index 1cee91c6..205bf9be 100644 --- a/upstream/fedora-rawhide/man3/printf.3 +++ b/upstream/fedora-rawhide/man3/printf.3 @@ -13,7 +13,7 @@ .\" 2000-07-26 jsm28@hermes.cam.ac.uk - three small fixes .\" 2000-10-16 jsm28@hermes.cam.ac.uk - more fixes .\" -.TH printf 3 2023-10-31 "Linux man-pages 6.06" +.TH printf 3 2024-03-16 "Linux man-pages 6.7" .SH NAME printf, fprintf, dprintf, sprintf, snprintf, vprintf, vfprintf, vdprintf, vsprintf, vsnprintf \- formatted output conversion @@ -875,7 +875,7 @@ No argument is converted. The complete conversion specification is \[aq]%%\[aq]. .SH RETURN VALUE -Upon successful return, these functions return the number of characters +Upon successful return, these functions return the number of bytes printed (excluding the null byte used to end output to strings). .P The functions diff --git a/upstream/fedora-rawhide/man3/profil.3 b/upstream/fedora-rawhide/man3/profil.3 index c247d225..6bdb2e37 100644 --- a/upstream/fedora-rawhide/man3/profil.3 +++ b/upstream/fedora-rawhide/man3/profil.3 @@ -6,7 +6,7 @@ .\" Modified Fri Jun 23 01:35:19 1995 Andries Brouwer <aeb@cwi.nl> .\" (prompted by Bas V. de Bakker <bas@phys.uva.nl>) .\" Corrected (and moved to man3), 980612, aeb -.TH profil 3 2023-10-31 "Linux man-pages 6.06" +.TH profil 3 2023-10-31 "Linux man-pages 6.7" .SH NAME profil \- execution time profile .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/program_invocation_name.3 b/upstream/fedora-rawhide/man3/program_invocation_name.3 index aec726d0..b840adaa 100644 --- a/upstream/fedora-rawhide/man3/program_invocation_name.3 +++ b/upstream/fedora-rawhide/man3/program_invocation_name.3 @@ -21,7 +21,7 @@ .\" SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. .\" %%%LICENSE_END .\" -.TH program_invocation_name 3 2023-10-31 "Linux man-pages 6.06" +.TH program_invocation_name 3 2023-10-31 "Linux man-pages 6.7" .SH NAME program_invocation_name, program_invocation_short_name \- \ obtain name used to invoke calling program diff --git a/upstream/fedora-rawhide/man3/psignal.3 b/upstream/fedora-rawhide/man3/psignal.3 index a1884fb6..011f44c8 100644 --- a/upstream/fedora-rawhide/man3/psignal.3 +++ b/upstream/fedora-rawhide/man3/psignal.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:45:17 1993 by Rik Faith (faith@cs.unc.edu) -.TH psignal 3 2023-10-31 "Linux man-pages 6.06" +.TH psignal 3 2023-10-31 "Linux man-pages 6.7" .SH NAME psignal, psiginfo \- print signal description .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_atfork.3 b/upstream/fedora-rawhide/man3/pthread_atfork.3 index d711959e..0c019045 100644 --- a/upstream/fedora-rawhide/man3/pthread_atfork.3 +++ b/upstream/fedora-rawhide/man3/pthread_atfork.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_atfork 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_atfork 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_atfork \- register fork handlers .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_attr_init.3 b/upstream/fedora-rawhide/man3/pthread_attr_init.3 index d11dbf3e..2f23061d 100644 --- a/upstream/fedora-rawhide/man3/pthread_attr_init.3 +++ b/upstream/fedora-rawhide/man3/pthread_attr_init.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_attr_init 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_attr_init 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_attr_init, pthread_attr_destroy \- initialize and destroy thread attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_attr_setaffinity_np.3 b/upstream/fedora-rawhide/man3/pthread_attr_setaffinity_np.3 index 71d52a58..0ab22249 100644 --- a/upstream/fedora-rawhide/man3/pthread_attr_setaffinity_np.3 +++ b/upstream/fedora-rawhide/man3/pthread_attr_setaffinity_np.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_attr_setaffinity_np 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_attr_setaffinity_np 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_attr_setaffinity_np, pthread_attr_getaffinity_np \- set/get CPU affinity attribute in thread attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_attr_setdetachstate.3 b/upstream/fedora-rawhide/man3/pthread_attr_setdetachstate.3 index 12a6db12..2fcf6e00 100644 --- a/upstream/fedora-rawhide/man3/pthread_attr_setdetachstate.3 +++ b/upstream/fedora-rawhide/man3/pthread_attr_setdetachstate.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_attr_setdetachstate 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_attr_setdetachstate 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_attr_setdetachstate, pthread_attr_getdetachstate \- set/get detach state attribute in thread attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_attr_setguardsize.3 b/upstream/fedora-rawhide/man3/pthread_attr_setguardsize.3 index 9cabd8cc..b4362605 100644 --- a/upstream/fedora-rawhide/man3/pthread_attr_setguardsize.3 +++ b/upstream/fedora-rawhide/man3/pthread_attr_setguardsize.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_attr_setguardsize 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_attr_setguardsize 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_attr_setguardsize, pthread_attr_getguardsize \- set/get guard size attribute in thread attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_attr_setinheritsched.3 b/upstream/fedora-rawhide/man3/pthread_attr_setinheritsched.3 index 3753a834..218522e5 100644 --- a/upstream/fedora-rawhide/man3/pthread_attr_setinheritsched.3 +++ b/upstream/fedora-rawhide/man3/pthread_attr_setinheritsched.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_attr_setinheritsched 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_attr_setinheritsched 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_attr_setinheritsched, pthread_attr_getinheritsched \- set/get inherit-scheduler attribute in thread attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_attr_setschedparam.3 b/upstream/fedora-rawhide/man3/pthread_attr_setschedparam.3 index 2cb2afc8..b01f0f98 100644 --- a/upstream/fedora-rawhide/man3/pthread_attr_setschedparam.3 +++ b/upstream/fedora-rawhide/man3/pthread_attr_setschedparam.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_attr_setschedparam 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_attr_setschedparam 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_attr_setschedparam, pthread_attr_getschedparam \- set/get scheduling parameter attributes in thread attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_attr_setschedpolicy.3 b/upstream/fedora-rawhide/man3/pthread_attr_setschedpolicy.3 index bff4b4c6..cbd630f8 100644 --- a/upstream/fedora-rawhide/man3/pthread_attr_setschedpolicy.3 +++ b/upstream/fedora-rawhide/man3/pthread_attr_setschedpolicy.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_attr_setschedpolicy 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_attr_setschedpolicy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_attr_setschedpolicy, pthread_attr_getschedpolicy \- set/get scheduling policy attribute in thread attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_attr_setscope.3 b/upstream/fedora-rawhide/man3/pthread_attr_setscope.3 index 37ab1046..024efa55 100644 --- a/upstream/fedora-rawhide/man3/pthread_attr_setscope.3 +++ b/upstream/fedora-rawhide/man3/pthread_attr_setscope.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_attr_setscope 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_attr_setscope 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_attr_setscope, pthread_attr_getscope \- set/get contention scope attribute in thread attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_attr_setsigmask_np.3 b/upstream/fedora-rawhide/man3/pthread_attr_setsigmask_np.3 index 5271074b..0ff9beea 100644 --- a/upstream/fedora-rawhide/man3/pthread_attr_setsigmask_np.3 +++ b/upstream/fedora-rawhide/man3/pthread_attr_setsigmask_np.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_attr_setsigmask_np 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_attr_setsigmask_np 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_attr_setsigmask_np, pthread_attr_getsigmask_np \- set/get signal mask attribute in thread attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_attr_setstack.3 b/upstream/fedora-rawhide/man3/pthread_attr_setstack.3 index 31ec24ca..1cf976bc 100644 --- a/upstream/fedora-rawhide/man3/pthread_attr_setstack.3 +++ b/upstream/fedora-rawhide/man3/pthread_attr_setstack.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_attr_setstack 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_attr_setstack 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_attr_setstack, pthread_attr_getstack \- set/get stack attributes in thread attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_attr_setstackaddr.3 b/upstream/fedora-rawhide/man3/pthread_attr_setstackaddr.3 index 8503c42c..7e9c2cc2 100644 --- a/upstream/fedora-rawhide/man3/pthread_attr_setstackaddr.3 +++ b/upstream/fedora-rawhide/man3/pthread_attr_setstackaddr.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_attr_setstackaddr 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_attr_setstackaddr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_attr_setstackaddr, pthread_attr_getstackaddr \- set/get stack address attribute in thread attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_attr_setstacksize.3 b/upstream/fedora-rawhide/man3/pthread_attr_setstacksize.3 index 791bcb8c..466a6ee9 100644 --- a/upstream/fedora-rawhide/man3/pthread_attr_setstacksize.3 +++ b/upstream/fedora-rawhide/man3/pthread_attr_setstacksize.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_attr_setstacksize 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_attr_setstacksize 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_attr_setstacksize, pthread_attr_getstacksize \- set/get stack size attribute in thread attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_cancel.3 b/upstream/fedora-rawhide/man3/pthread_cancel.3 index 10a43e18..c1a160be 100644 --- a/upstream/fedora-rawhide/man3/pthread_cancel.3 +++ b/upstream/fedora-rawhide/man3/pthread_cancel.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_cancel 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_cancel 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_cancel \- send a cancelation request to a thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_cleanup_push.3 b/upstream/fedora-rawhide/man3/pthread_cleanup_push.3 index 106154b5..eec8c8e2 100644 --- a/upstream/fedora-rawhide/man3/pthread_cleanup_push.3 +++ b/upstream/fedora-rawhide/man3/pthread_cleanup_push.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_cleanup_push 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_cleanup_push 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_cleanup_push, pthread_cleanup_pop \- push and pop thread cancelation clean-up handlers diff --git a/upstream/fedora-rawhide/man3/pthread_cleanup_push_defer_np.3 b/upstream/fedora-rawhide/man3/pthread_cleanup_push_defer_np.3 index 0a2a374e..ca0e3d47 100644 --- a/upstream/fedora-rawhide/man3/pthread_cleanup_push_defer_np.3 +++ b/upstream/fedora-rawhide/man3/pthread_cleanup_push_defer_np.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_cleanup_push_defer_np 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_cleanup_push_defer_np 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_cleanup_push_defer_np, pthread_cleanup_pop_restore_np \- push and pop thread cancelation clean-up handlers while saving cancelability type diff --git a/upstream/fedora-rawhide/man3/pthread_cond_init.3 b/upstream/fedora-rawhide/man3/pthread_cond_init.3 index cfe5dbaa..7fff419e 100644 --- a/upstream/fedora-rawhide/man3/pthread_cond_init.3 +++ b/upstream/fedora-rawhide/man3/pthread_cond_init.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_cond_init 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_cond_init 3 2024-02-26 "Linux man-pages 6.7" . . .SH NAME @@ -110,12 +110,12 @@ except checking that the condition has no waiting threads. . .SH CANCELLATION \fBpthread_cond_wait\fP and \fBpthread_cond_timedwait\fP -are cancellation points. +are cancelation points. If a thread is cancelled while suspended in one of these functions, the thread immediately resumes execution, then locks again the \fImutex\fP argument to \fBpthread_cond_wait\fP and \fBpthread_cond_timedwait\fP, -and finally executes the cancellation. +and finally executes the cancelation. Consequently, cleanup handlers are assured that \fImutex\fP is locked when they are called. diff --git a/upstream/fedora-rawhide/man3/pthread_condattr_init.3 b/upstream/fedora-rawhide/man3/pthread_condattr_init.3 index 2fda7f3e..bed354c3 100644 --- a/upstream/fedora-rawhide/man3/pthread_condattr_init.3 +++ b/upstream/fedora-rawhide/man3/pthread_condattr_init.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_condattr_init 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_condattr_init 3 2023-10-31 "Linux man-pages 6.7" . . .SH NAME diff --git a/upstream/fedora-rawhide/man3/pthread_create.3 b/upstream/fedora-rawhide/man3/pthread_create.3 index c592e1b9..beba117b 100644 --- a/upstream/fedora-rawhide/man3/pthread_create.3 +++ b/upstream/fedora-rawhide/man3/pthread_create.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_create 3 2024-02-12 "Linux man-pages 6.06" +.TH pthread_create 3 2024-02-12 "Linux man-pages 6.7" .SH NAME pthread_create \- create a new thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_detach.3 b/upstream/fedora-rawhide/man3/pthread_detach.3 index 336a0707..25b588aa 100644 --- a/upstream/fedora-rawhide/man3/pthread_detach.3 +++ b/upstream/fedora-rawhide/man3/pthread_detach.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_detach 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_detach 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_detach \- detach a thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_equal.3 b/upstream/fedora-rawhide/man3/pthread_equal.3 index 754b558f..5046d8e9 100644 --- a/upstream/fedora-rawhide/man3/pthread_equal.3 +++ b/upstream/fedora-rawhide/man3/pthread_equal.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_equal 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_equal 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_equal \- compare thread IDs .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_exit.3 b/upstream/fedora-rawhide/man3/pthread_exit.3 index 5a693541..edd6f90e 100644 --- a/upstream/fedora-rawhide/man3/pthread_exit.3 +++ b/upstream/fedora-rawhide/man3/pthread_exit.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_exit 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_exit 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_exit \- terminate calling thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_getattr_default_np.3 b/upstream/fedora-rawhide/man3/pthread_getattr_default_np.3 index c18761eb..ac8ee10e 100644 --- a/upstream/fedora-rawhide/man3/pthread_getattr_default_np.3 +++ b/upstream/fedora-rawhide/man3/pthread_getattr_default_np.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_getattr_default_np 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_getattr_default_np 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_getattr_default_np, pthread_setattr_default_np, \- get or set default thread-creation attributes diff --git a/upstream/fedora-rawhide/man3/pthread_getattr_np.3 b/upstream/fedora-rawhide/man3/pthread_getattr_np.3 index 1069b0c0..02a621f4 100644 --- a/upstream/fedora-rawhide/man3/pthread_getattr_np.3 +++ b/upstream/fedora-rawhide/man3/pthread_getattr_np.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_getattr_np 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_getattr_np 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_getattr_np \- get attributes of created thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_getcpuclockid.3 b/upstream/fedora-rawhide/man3/pthread_getcpuclockid.3 index 60389446..872134c5 100644 --- a/upstream/fedora-rawhide/man3/pthread_getcpuclockid.3 +++ b/upstream/fedora-rawhide/man3/pthread_getcpuclockid.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_getcpuclockid 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_getcpuclockid 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_getcpuclockid \- retrieve ID of a thread's CPU time clock .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_join.3 b/upstream/fedora-rawhide/man3/pthread_join.3 index 5ae8658f..f063a79f 100644 --- a/upstream/fedora-rawhide/man3/pthread_join.3 +++ b/upstream/fedora-rawhide/man3/pthread_join.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_join 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_join 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_join \- join with a terminated thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_key_create.3 b/upstream/fedora-rawhide/man3/pthread_key_create.3 index 75ad8f47..1e7d6807 100644 --- a/upstream/fedora-rawhide/man3/pthread_key_create.3 +++ b/upstream/fedora-rawhide/man3/pthread_key_create.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_key_create 3 2023-11-24 "Linux man-pages 6.06" +.TH pthread_key_create 3 2024-02-26 "Linux man-pages 6.7" . . .SH NAME @@ -59,7 +59,7 @@ is \fBNULL\fP in all currently executing threads. The \fIdestr_function\fP argument, if not \fBNULL\fP, specifies a destructor function associated with the key. -When a thread terminates via \fBpthread_exit\fP or by cancellation, +When a thread terminates via \fBpthread_exit\fP or by cancelation, \fIdestr_function\fP is called with arguments the value associated with the key in that thread. The \fIdestr_function\fP is not called if that value is \fBNULL\fP. diff --git a/upstream/fedora-rawhide/man3/pthread_kill.3 b/upstream/fedora-rawhide/man3/pthread_kill.3 index 9adc7849..659b0db0 100644 --- a/upstream/fedora-rawhide/man3/pthread_kill.3 +++ b/upstream/fedora-rawhide/man3/pthread_kill.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_kill 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_kill 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_kill \- send a signal to a thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_kill_other_threads_np.3 b/upstream/fedora-rawhide/man3/pthread_kill_other_threads_np.3 index cc1b3544..b9242736 100644 --- a/upstream/fedora-rawhide/man3/pthread_kill_other_threads_np.3 +++ b/upstream/fedora-rawhide/man3/pthread_kill_other_threads_np.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_kill_other_threads_np 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_kill_other_threads_np 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_kill_other_threads_np \- terminate all other threads in process .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_mutex_consistent.3 b/upstream/fedora-rawhide/man3/pthread_mutex_consistent.3 index 822602a8..54cdc517 100644 --- a/upstream/fedora-rawhide/man3/pthread_mutex_consistent.3 +++ b/upstream/fedora-rawhide/man3/pthread_mutex_consistent.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_mutex_consistent 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_mutex_consistent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_mutex_consistent \- make a robust mutex consistent .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_mutex_init.3 b/upstream/fedora-rawhide/man3/pthread_mutex_init.3 index 1574489c..8d9abf9d 100644 --- a/upstream/fedora-rawhide/man3/pthread_mutex_init.3 +++ b/upstream/fedora-rawhide/man3/pthread_mutex_init.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_mutex_init 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_mutex_init 3 2024-02-26 "Linux man-pages 6.7" . . .SH NAME @@ -130,16 +130,16 @@ except checking that the mutex is unlocked. . . .SH CANCELLATION -None of the mutex functions is a cancellation point, +None of the mutex functions is a cancelation point, not even \fBpthread_mutex_lock\fP, in spite of the fact that it can suspend a thread for arbitrary durations. This way, -the status of mutexes at cancellation points is predictable, -allowing cancellation handlers +the status of mutexes at cancelation points is predictable, +allowing cancelation handlers to unlock precisely those mutexes that need to be unlocked before the thread stops executing. Consequently, -threads using deferred cancellation +threads using deferred cancelation should never hold a mutex for extended periods of time. . . diff --git a/upstream/fedora-rawhide/man3/pthread_mutexattr_getpshared.3 b/upstream/fedora-rawhide/man3/pthread_mutexattr_getpshared.3 index eeab6751..47fe8dd4 100644 --- a/upstream/fedora-rawhide/man3/pthread_mutexattr_getpshared.3 +++ b/upstream/fedora-rawhide/man3/pthread_mutexattr_getpshared.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_mutexattr_getpshared 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_mutexattr_getpshared 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_mutexattr_getpshared, pthread_mutexattr_setpshared \- get/set process-shared mutex attribute diff --git a/upstream/fedora-rawhide/man3/pthread_mutexattr_init.3 b/upstream/fedora-rawhide/man3/pthread_mutexattr_init.3 index 29abfd0e..4b09f5bd 100644 --- a/upstream/fedora-rawhide/man3/pthread_mutexattr_init.3 +++ b/upstream/fedora-rawhide/man3/pthread_mutexattr_init.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_mutexattr_init 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_mutexattr_init 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_mutexattr_init, pthread_mutexattr_destroy \- initialize and destroy a mutex attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_mutexattr_setkind_np.3 b/upstream/fedora-rawhide/man3/pthread_mutexattr_setkind_np.3 index 641ba536..ca6a64e6 100644 --- a/upstream/fedora-rawhide/man3/pthread_mutexattr_setkind_np.3 +++ b/upstream/fedora-rawhide/man3/pthread_mutexattr_setkind_np.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_mutexattr_setkind_np 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_mutexattr_setkind_np 3 2023-10-31 "Linux man-pages 6.7" . . .SH NAME diff --git a/upstream/fedora-rawhide/man3/pthread_mutexattr_setrobust.3 b/upstream/fedora-rawhide/man3/pthread_mutexattr_setrobust.3 index e412307d..802b400a 100644 --- a/upstream/fedora-rawhide/man3/pthread_mutexattr_setrobust.3 +++ b/upstream/fedora-rawhide/man3/pthread_mutexattr_setrobust.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_mutexattr_setrobust 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_mutexattr_setrobust 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_mutexattr_getrobust, pthread_mutexattr_setrobust \- get and set the robustness attribute of a mutex attributes object diff --git a/upstream/fedora-rawhide/man3/pthread_once.3 b/upstream/fedora-rawhide/man3/pthread_once.3 index 14bad388..852dffaa 100644 --- a/upstream/fedora-rawhide/man3/pthread_once.3 +++ b/upstream/fedora-rawhide/man3/pthread_once.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_once 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_once 3 2023-10-31 "Linux man-pages 6.7" . . .SH NAME diff --git a/upstream/fedora-rawhide/man3/pthread_rwlockattr_setkind_np.3 b/upstream/fedora-rawhide/man3/pthread_rwlockattr_setkind_np.3 index 703deaa8..f2998caf 100644 --- a/upstream/fedora-rawhide/man3/pthread_rwlockattr_setkind_np.3 +++ b/upstream/fedora-rawhide/man3/pthread_rwlockattr_setkind_np.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_rwlockattr_setkind_np 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_rwlockattr_setkind_np 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_rwlockattr_setkind_np, pthread_rwlockattr_getkind_np \- set/get the read-write lock kind of the thread read-write lock attribute object diff --git a/upstream/fedora-rawhide/man3/pthread_self.3 b/upstream/fedora-rawhide/man3/pthread_self.3 index 2477a9d6..7d703dd8 100644 --- a/upstream/fedora-rawhide/man3/pthread_self.3 +++ b/upstream/fedora-rawhide/man3/pthread_self.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_self 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_self 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_self \- obtain ID of the calling thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_setaffinity_np.3 b/upstream/fedora-rawhide/man3/pthread_setaffinity_np.3 index 5ec71657..cf91c599 100644 --- a/upstream/fedora-rawhide/man3/pthread_setaffinity_np.3 +++ b/upstream/fedora-rawhide/man3/pthread_setaffinity_np.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_setaffinity_np 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_setaffinity_np 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_setaffinity_np, pthread_getaffinity_np \- set/get CPU affinity of a thread diff --git a/upstream/fedora-rawhide/man3/pthread_setcancelstate.3 b/upstream/fedora-rawhide/man3/pthread_setcancelstate.3 index 28cb353a..40b0a6ea 100644 --- a/upstream/fedora-rawhide/man3/pthread_setcancelstate.3 +++ b/upstream/fedora-rawhide/man3/pthread_setcancelstate.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_setcancelstate 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_setcancelstate 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_setcancelstate, pthread_setcanceltype \- set cancelability state and type diff --git a/upstream/fedora-rawhide/man3/pthread_setconcurrency.3 b/upstream/fedora-rawhide/man3/pthread_setconcurrency.3 index 5e39e8b9..0c2ffd06 100644 --- a/upstream/fedora-rawhide/man3/pthread_setconcurrency.3 +++ b/upstream/fedora-rawhide/man3/pthread_setconcurrency.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_setconcurrency 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_setconcurrency 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_setconcurrency, pthread_getconcurrency \- set/get the concurrency level diff --git a/upstream/fedora-rawhide/man3/pthread_setname_np.3 b/upstream/fedora-rawhide/man3/pthread_setname_np.3 index fca43314..4ff9f063 100644 --- a/upstream/fedora-rawhide/man3/pthread_setname_np.3 +++ b/upstream/fedora-rawhide/man3/pthread_setname_np.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_setname_np 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_setname_np 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_setname_np, pthread_getname_np \- set/get the name of a thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_setschedparam.3 b/upstream/fedora-rawhide/man3/pthread_setschedparam.3 index 4c420d8c..5fdb307e 100644 --- a/upstream/fedora-rawhide/man3/pthread_setschedparam.3 +++ b/upstream/fedora-rawhide/man3/pthread_setschedparam.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_setschedparam 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_setschedparam 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_setschedparam, pthread_getschedparam \- set/get scheduling policy and parameters of a thread diff --git a/upstream/fedora-rawhide/man3/pthread_setschedprio.3 b/upstream/fedora-rawhide/man3/pthread_setschedprio.3 index e70fb1d3..acc752d3 100644 --- a/upstream/fedora-rawhide/man3/pthread_setschedprio.3 +++ b/upstream/fedora-rawhide/man3/pthread_setschedprio.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_setschedprio 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_setschedprio 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_setschedprio \- set scheduling priority of a thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_sigmask.3 b/upstream/fedora-rawhide/man3/pthread_sigmask.3 index 343c2d33..fb923a8b 100644 --- a/upstream/fedora-rawhide/man3/pthread_sigmask.3 +++ b/upstream/fedora-rawhide/man3/pthread_sigmask.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_sigmask 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_sigmask 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_sigmask \- examine and change mask of blocked signals .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_sigqueue.3 b/upstream/fedora-rawhide/man3/pthread_sigqueue.3 index 3fd51d1b..62a1b18a 100644 --- a/upstream/fedora-rawhide/man3/pthread_sigqueue.3 +++ b/upstream/fedora-rawhide/man3/pthread_sigqueue.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_sigqueue 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_sigqueue 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_sigqueue \- queue a signal and data to a thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_spin_init.3 b/upstream/fedora-rawhide/man3/pthread_spin_init.3 index b7676d76..57ccb88c 100644 --- a/upstream/fedora-rawhide/man3/pthread_spin_init.3 +++ b/upstream/fedora-rawhide/man3/pthread_spin_init.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_spin_init 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_spin_init 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_spin_init, pthread_spin_destroy \- initialize or destroy a spin lock .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_spin_lock.3 b/upstream/fedora-rawhide/man3/pthread_spin_lock.3 index 1717e939..65e4d45f 100644 --- a/upstream/fedora-rawhide/man3/pthread_spin_lock.3 +++ b/upstream/fedora-rawhide/man3/pthread_spin_lock.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_spin_lock 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_spin_lock 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_spin_lock, pthread_spin_trylock, pthread_spin_unlock \- lock and unlock a spin lock diff --git a/upstream/fedora-rawhide/man3/pthread_testcancel.3 b/upstream/fedora-rawhide/man3/pthread_testcancel.3 index d654aca6..796c7a39 100644 --- a/upstream/fedora-rawhide/man3/pthread_testcancel.3 +++ b/upstream/fedora-rawhide/man3/pthread_testcancel.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_testcancel 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_testcancel 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_testcancel \- request delivery of any pending cancelation request .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/pthread_tryjoin_np.3 b/upstream/fedora-rawhide/man3/pthread_tryjoin_np.3 index b2d60ab4..59d622e4 100644 --- a/upstream/fedora-rawhide/man3/pthread_tryjoin_np.3 +++ b/upstream/fedora-rawhide/man3/pthread_tryjoin_np.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_tryjoin_np 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_tryjoin_np 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_tryjoin_np, pthread_timedjoin_np \- try to join with a terminated thread diff --git a/upstream/fedora-rawhide/man3/pthread_yield.3 b/upstream/fedora-rawhide/man3/pthread_yield.3 index abbc4b2c..34d2bad3 100644 --- a/upstream/fedora-rawhide/man3/pthread_yield.3 +++ b/upstream/fedora-rawhide/man3/pthread_yield.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthread_yield 3 2023-10-31 "Linux man-pages 6.06" +.TH pthread_yield 3 2023-10-31 "Linux man-pages 6.7" .SH NAME pthread_yield \- yield the processor .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ptsname.3 b/upstream/fedora-rawhide/man3/ptsname.3 index 4a3a10a3..e7887e9c 100644 --- a/upstream/fedora-rawhide/man3/ptsname.3 +++ b/upstream/fedora-rawhide/man3/ptsname.3 @@ -5,7 +5,7 @@ .\" .\" 2004-12-17, mtk, added description of ptsname_r() + ERRORS .\" -.TH ptsname 3 2023-10-31 "Linux man-pages 6.06" +.TH ptsname 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ptsname, ptsname_r \- get the name of the slave pseudoterminal .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/putenv.3 b/upstream/fedora-rawhide/man3/putenv.3 index 30abe807..c63d5e4a 100644 --- a/upstream/fedora-rawhide/man3/putenv.3 +++ b/upstream/fedora-rawhide/man3/putenv.3 @@ -14,7 +14,7 @@ .\" Modified Mon Oct 11 11:11:11 1999 by Andries Brouwer (aeb@cwi.nl) .\" Modified Wed Nov 10 00:02:26 1999 by Andries Brouwer (aeb@cwi.nl) .\" Modified Sun May 20 22:17:20 2001 by Andries Brouwer (aeb@cwi.nl) -.TH putenv 3 2023-10-31 "Linux man-pages 6.06" +.TH putenv 3 2023-10-31 "Linux man-pages 6.7" .SH NAME putenv \- change or add an environment variable .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/putgrent.3 b/upstream/fedora-rawhide/man3/putgrent.3 index 85f78553..1de20846 100644 --- a/upstream/fedora-rawhide/man3/putgrent.3 +++ b/upstream/fedora-rawhide/man3/putgrent.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH putgrent 3 2023-10-31 "Linux man-pages 6.06" +.TH putgrent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME putgrent \- write a group database entry to a file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/putpwent.3 b/upstream/fedora-rawhide/man3/putpwent.3 index dae023b9..645e8be9 100644 --- a/upstream/fedora-rawhide/man3/putpwent.3 +++ b/upstream/fedora-rawhide/man3/putpwent.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:43:46 1993 by Rik Faith (faith@cs.unc.edu) -.TH putpwent 3 2023-10-31 "Linux man-pages 6.06" +.TH putpwent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME putpwent \- write a password file entry .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/puts.3 b/upstream/fedora-rawhide/man3/puts.3 index 33361bfd..dd50c520 100644 --- a/upstream/fedora-rawhide/man3/puts.3 +++ b/upstream/fedora-rawhide/man3/puts.3 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified Sat Jul 24 18:42:59 1993 by Rik Faith (faith@cs.unc.edu) -.TH puts 3 2023-10-31 "Linux man-pages 6.06" +.TH puts 3 2023-10-31 "Linux man-pages 6.7" .SH NAME fputc, fputs, putc, putchar, puts \- output of characters and strings .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/putwchar.3 b/upstream/fedora-rawhide/man3/putwchar.3 index a98ca979..af64cbae 100644 --- a/upstream/fedora-rawhide/man3/putwchar.3 +++ b/upstream/fedora-rawhide/man3/putwchar.3 @@ -10,7 +10,7 @@ .\" http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH putwchar 3 2023-10-31 "Linux man-pages 6.06" +.TH putwchar 3 2023-10-31 "Linux man-pages 6.7" .SH NAME putwchar \- write a wide character to standard output .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/qecvt.3 b/upstream/fedora-rawhide/man3/qecvt.3 index d6ae1e70..a9aeed8b 100644 --- a/upstream/fedora-rawhide/man3/qecvt.3 +++ b/upstream/fedora-rawhide/man3/qecvt.3 @@ -6,7 +6,7 @@ .\" This replaces an earlier man page written by Walter Harms .\" <walter.harms@informatik.uni-oldenburg.de>. .\" -.TH qecvt 3 2023-10-31 "Linux man-pages 6.06" +.TH qecvt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME qecvt, qfcvt, qgcvt \- convert a floating-point number to a string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/qsort.3 b/upstream/fedora-rawhide/man3/qsort.3 index 19e4e333..6959a9ac 100644 --- a/upstream/fedora-rawhide/man3/qsort.3 +++ b/upstream/fedora-rawhide/man3/qsort.3 @@ -15,7 +15,7 @@ .\" and Ben Bacarisse <software@bsb.me.uk> .\" Document qsort_r() .\" -.TH qsort 3 2023-10-31 "Linux man-pages 6.06" +.TH qsort 3 2023-10-31 "Linux man-pages 6.7" .SH NAME qsort, qsort_r \- sort an array .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/raise.3 b/upstream/fedora-rawhide/man3/raise.3 index 0a72a76c..9fb5c726 100644 --- a/upstream/fedora-rawhide/man3/raise.3 +++ b/upstream/fedora-rawhide/man3/raise.3 @@ -7,7 +7,7 @@ .\" Modified Sat Jul 24 18:40:56 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 1995 by Mike Battersby (mib@deakin.edu.au) .\" -.TH raise 3 2023-10-31 "Linux man-pages 6.06" +.TH raise 3 2023-10-31 "Linux man-pages 6.7" .SH NAME raise \- send a signal to the caller .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/rand.3 b/upstream/fedora-rawhide/man3/rand.3 index 7b1242b6..681a5f79 100644 --- a/upstream/fedora-rawhide/man3/rand.3 +++ b/upstream/fedora-rawhide/man3/rand.3 @@ -19,7 +19,7 @@ .\" Modified 2003-11-15, aeb, added rand_r .\" 2010-09-13, mtk, added example program .\" -.TH rand 3 2023-10-31 "Linux man-pages 6.06" +.TH rand 3 2023-10-31 "Linux man-pages 6.7" .SH NAME rand, rand_r, srand \- pseudo-random number generator .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/random.3 b/upstream/fedora-rawhide/man3/random.3 index 0effb243..3d1c4dd7 100644 --- a/upstream/fedora-rawhide/man3/random.3 +++ b/upstream/fedora-rawhide/man3/random.3 @@ -11,7 +11,7 @@ .\" Modified Sat Jul 24 18:13:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Sun Aug 20 21:47:07 2000, aeb .\" -.TH random 3 2023-10-31 "Linux man-pages 6.06" +.TH random 3 2023-10-31 "Linux man-pages 6.7" .SH NAME random, srandom, initstate, setstate \- random number generator .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/random_r.3 b/upstream/fedora-rawhide/man3/random_r.3 index ec360248..f1647f83 100644 --- a/upstream/fedora-rawhide/man3/random_r.3 +++ b/upstream/fedora-rawhide/man3/random_r.3 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH random_r 3 2023-10-31 "Linux man-pages 6.06" +.TH random_r 3 2023-10-31 "Linux man-pages 6.7" .SH NAME random_r, srandom_r, initstate_r, setstate_r \- reentrant random number generator diff --git a/upstream/fedora-rawhide/man3/rcmd.3 b/upstream/fedora-rawhide/man3/rcmd.3 index ddea6ae3..012dc622 100644 --- a/upstream/fedora-rawhide/man3/rcmd.3 +++ b/upstream/fedora-rawhide/man3/rcmd.3 @@ -13,7 +13,7 @@ .\" .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH rcmd 3 2023-10-31 "Linux man-pages 6.06" +.TH rcmd 3 2023-10-31 "Linux man-pages 6.7" .SH NAME rcmd, rresvport, iruserok, ruserok, rcmd_af, rresvport_af, iruserok_af, ruserok_af \- routines for returning a diff --git a/upstream/fedora-rawhide/man3/re_comp.3 b/upstream/fedora-rawhide/man3/re_comp.3 index c2d4024c..038dc969 100644 --- a/upstream/fedora-rawhide/man3/re_comp.3 +++ b/upstream/fedora-rawhide/man3/re_comp.3 @@ -5,7 +5,7 @@ .\" .\" Wed Jun 14 16:10:28 BST 1995 Wilf. (G.Wilford@@ee.surrey.ac.uk) .\" -.TH re_comp 3 2023-10-31 "Linux man-pages 6.06" +.TH re_comp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME re_comp, re_exec \- BSD regex functions .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/readdir.3 b/upstream/fedora-rawhide/man3/readdir.3 index c41afede..9b61aaf5 100644 --- a/upstream/fedora-rawhide/man3/readdir.3 +++ b/upstream/fedora-rawhide/man3/readdir.3 @@ -14,7 +14,7 @@ .\" 2007-07-30 Ulrich Drepper <drepper@redhat.com>, mtk: .\" Rework discussion of nonstandard structure fields. .\" -.TH readdir 3 2023-10-31 "Linux man-pages 6.06" +.TH readdir 3 2023-10-31 "Linux man-pages 6.7" .SH NAME readdir \- read a directory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/readdir_r.3 b/upstream/fedora-rawhide/man3/readdir_r.3 index 7eff5847..f90a70b7 100644 --- a/upstream/fedora-rawhide/man3/readdir_r.3 +++ b/upstream/fedora-rawhide/man3/readdir_r.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH readdir_r 3 2023-10-31 "Linux man-pages 6.06" +.TH readdir_r 3 2023-10-31 "Linux man-pages 6.7" .SH NAME readdir_r \- read a directory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/realpath.3 b/upstream/fedora-rawhide/man3/realpath.3 index fa714077..dc1ec7fb 100644 --- a/upstream/fedora-rawhide/man3/realpath.3 +++ b/upstream/fedora-rawhide/man3/realpath.3 @@ -6,7 +6,7 @@ .\" Rewritten old page, 990824, aeb@cwi.nl .\" 2004-12-14, mtk, added discussion of resolved_path == NULL .\" -.TH realpath 3 2023-10-31 "Linux man-pages 6.06" +.TH realpath 3 2023-10-31 "Linux man-pages 6.7" .SH NAME realpath \- return the canonicalized absolute pathname .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/regex.3 b/upstream/fedora-rawhide/man3/regex.3 index be71ab02..fb641efb 100644 --- a/upstream/fedora-rawhide/man3/regex.3 +++ b/upstream/fedora-rawhide/man3/regex.3 @@ -10,7 +10,7 @@ .\" Modified 8 May 1998 by Joseph S. Myers (jsm28@cam.ac.uk) .\" .\" show the synopsis section nicely -.TH regex 3 2023-10-31 "Linux man-pages 6.06" +.TH regex 3 2023-10-31 "Linux man-pages 6.7" .SH NAME regcomp, regexec, regerror, regfree \- POSIX regex functions .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/remainder.3 b/upstream/fedora-rawhide/man3/remainder.3 index 07d697e7..774b355f 100644 --- a/upstream/fedora-rawhide/man3/remainder.3 +++ b/upstream/fedora-rawhide/man3/remainder.3 @@ -15,7 +15,7 @@ .\" (walter.harms@informatik.uni-oldenburg.de) .\" Modified 2003-11-18, 2004-10-05 aeb .\" -.TH remainder 3 2023-10-31 "Linux man-pages 6.06" +.TH remainder 3 2023-10-31 "Linux man-pages 6.7" .SH NAME drem, dremf, dreml, remainder, remainderf, remainderl \- \ floating-point remainder function diff --git a/upstream/fedora-rawhide/man3/remove.3 b/upstream/fedora-rawhide/man3/remove.3 index 0dfa4d36..48ca0a6b 100644 --- a/upstream/fedora-rawhide/man3/remove.3 +++ b/upstream/fedora-rawhide/man3/remove.3 @@ -9,7 +9,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH remove 3 2023-10-31 "Linux man-pages 6.06" +.TH remove 3 2023-10-31 "Linux man-pages 6.7" .SH NAME remove \- remove a file or directory .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/remquo.3 b/upstream/fedora-rawhide/man3/remquo.3 index 0424af68..8dcfec02 100644 --- a/upstream/fedora-rawhide/man3/remquo.3 +++ b/upstream/fedora-rawhide/man3/remquo.3 @@ -8,7 +8,7 @@ .\" based on glibc infopages .\" polished, aeb .\" -.TH remquo 3 2023-10-31 "Linux man-pages 6.06" +.TH remquo 3 2023-10-31 "Linux man-pages 6.7" .SH NAME remquo, remquof, remquol \- remainder and part of quotient .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/resolver.3 b/upstream/fedora-rawhide/man3/resolver.3 index 4759d97c..f44c51bc 100644 --- a/upstream/fedora-rawhide/man3/resolver.3 +++ b/upstream/fedora-rawhide/man3/resolver.3 @@ -11,7 +11,7 @@ .\" Modified 1993-07-25 by Rik Faith (faith@cs.unc.edu) .\" Modified 2004-10-31 by aeb .\" -.TH resolver 3 2023-10-31 "Linux man-pages 6.06" +.TH resolver 3 2023-10-31 "Linux man-pages 6.7" .SH NAME res_ninit, res_nquery, res_nsearch, res_nquerydomain, res_nmkquery, res_nsend, res_nclose, diff --git a/upstream/fedora-rawhide/man3/rewinddir.3 b/upstream/fedora-rawhide/man3/rewinddir.3 index e14a7b54..fbc8b1a7 100644 --- a/upstream/fedora-rawhide/man3/rewinddir.3 +++ b/upstream/fedora-rawhide/man3/rewinddir.3 @@ -9,7 +9,7 @@ .\" 386BSD man pages .\" Modified Sat Jul 24 18:29:11 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 11 June 1995 by Andries Brouwer (aeb@cwi.nl) -.TH rewinddir 3 2023-10-31 "Linux man-pages 6.06" +.TH rewinddir 3 2023-10-31 "Linux man-pages 6.7" .SH NAME rewinddir \- reset directory stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/rexec.3 b/upstream/fedora-rawhide/man3/rexec.3 index 238de2bc..ca680d30 100644 --- a/upstream/fedora-rawhide/man3/rexec.3 +++ b/upstream/fedora-rawhide/man3/rexec.3 @@ -11,7 +11,7 @@ .\" .\" 2013-06-21, mtk, Converted from mdoc to man macros .\" -.TH rexec 3 2023-10-31 "Linux man-pages 6.06" +.TH rexec 3 2023-10-31 "Linux man-pages 6.7" .SH NAME rexec, rexec_af \- return stream to a remote command .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/rint.3 b/upstream/fedora-rawhide/man3/rint.3 index cfb60ccd..812d6ae6 100644 --- a/upstream/fedora-rawhide/man3/rint.3 +++ b/upstream/fedora-rawhide/man3/rint.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH rint 3 2023-10-31 "Linux man-pages 6.06" +.TH rint 3 2023-10-31 "Linux man-pages 6.7" .SH NAME nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl \- round to nearest integer diff --git a/upstream/fedora-rawhide/man3/round.3 b/upstream/fedora-rawhide/man3/round.3 index a96e9420..4e27fd66 100644 --- a/upstream/fedora-rawhide/man3/round.3 +++ b/upstream/fedora-rawhide/man3/round.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH round 3 2023-10-31 "Linux man-pages 6.06" +.TH round 3 2023-10-31 "Linux man-pages 6.7" .SH NAME round, roundf, roundl \- round to nearest integer, away from zero .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/roundup.3 b/upstream/fedora-rawhide/man3/roundup.3 index d7f69796..bcde64a1 100644 --- a/upstream/fedora-rawhide/man3/roundup.3 +++ b/upstream/fedora-rawhide/man3/roundup.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH roundup 3 2023-10-31 "Linux man-pages 6.06" +.TH roundup 3 2023-10-31 "Linux man-pages 6.7" .SH NAME roundup \- round up in steps .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/rpc.3 b/upstream/fedora-rawhide/man3/rpc.3 index 1359bb8a..b5d238c0 100644 --- a/upstream/fedora-rawhide/man3/rpc.3 +++ b/upstream/fedora-rawhide/man3/rpc.3 @@ -9,7 +9,7 @@ .\" .\" 2007-12-30, mtk, Convert function prototypes to modern C syntax .\" -.TH rpc 3 2023-10-31 "Linux man-pages 6.06" +.TH rpc 3 2023-10-31 "Linux man-pages 6.7" .SH NAME rpc \- library routines for remote procedure calls .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/rpmatch.3 b/upstream/fedora-rawhide/man3/rpmatch.3 index d2958a57..dac24744 100644 --- a/upstream/fedora-rawhide/man3/rpmatch.3 +++ b/upstream/fedora-rawhide/man3/rpmatch.3 @@ -27,7 +27,7 @@ .\" .\" 2006-05-19, mtk, various edits and example program .\" -.TH rpmatch 3 2023-10-31 "Linux man-pages 6.06" +.TH rpmatch 3 2023-10-31 "Linux man-pages 6.7" .SH NAME rpmatch \- determine if the answer to a question is affirmative or negative .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/rtime.3 b/upstream/fedora-rawhide/man3/rtime.3 index 7b6b9ca1..4d1a4a03 100644 --- a/upstream/fedora-rawhide/man3/rtime.3 +++ b/upstream/fedora-rawhide/man3/rtime.3 @@ -8,7 +8,7 @@ .\" .\" Slightly polished, aeb, 2003-04-06 .\" -.TH rtime 3 2023-10-31 "Linux man-pages 6.06" +.TH rtime 3 2023-10-31 "Linux man-pages 6.7" .SH NAME rtime \- get time from a remote machine .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/rtnetlink.3 b/upstream/fedora-rawhide/man3/rtnetlink.3 index 94a9a910..b0f9f43b 100644 --- a/upstream/fedora-rawhide/man3/rtnetlink.3 +++ b/upstream/fedora-rawhide/man3/rtnetlink.3 @@ -4,7 +4,7 @@ .\" .\" $Id: rtnetlink.3,v 1.2 1999/05/18 10:35:10 freitag Exp $ .\" -.TH rtnetlink 3 2023-10-31 "Linux man-pages 6.06" +.TH rtnetlink 3 2023-10-31 "Linux man-pages 6.7" .SH NAME rtnetlink \- macros to manipulate rtnetlink messages .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/scalb.3 b/upstream/fedora-rawhide/man3/scalb.3 index 88cd14b4..f99fd2df 100644 --- a/upstream/fedora-rawhide/man3/scalb.3 +++ b/upstream/fedora-rawhide/man3/scalb.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH scalb 3 2023-10-31 "Linux man-pages 6.06" +.TH scalb 3 2023-10-31 "Linux man-pages 6.7" .SH NAME scalb, scalbf, scalbl \- multiply floating-point number by integral power of radix (OBSOLETE) diff --git a/upstream/fedora-rawhide/man3/scalbln.3 b/upstream/fedora-rawhide/man3/scalbln.3 index 043b7f67..beeeff42 100644 --- a/upstream/fedora-rawhide/man3/scalbln.3 +++ b/upstream/fedora-rawhide/man3/scalbln.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH scalbln 3 2023-10-31 "Linux man-pages 6.06" +.TH scalbln 3 2023-10-31 "Linux man-pages 6.7" .SH NAME scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl \- multiply floating-point number by integral power of radix diff --git a/upstream/fedora-rawhide/man3/scandir.3 b/upstream/fedora-rawhide/man3/scandir.3 index 1f3ec156..eeab2563 100644 --- a/upstream/fedora-rawhide/man3/scandir.3 +++ b/upstream/fedora-rawhide/man3/scandir.3 @@ -21,7 +21,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH scandir 3 2023-10-31 "Linux man-pages 6.06" +.TH scandir 3 2023-10-31 "Linux man-pages 6.7" .SH NAME scandir, scandirat, alphasort, versionsort \- scan a directory for matching entries diff --git a/upstream/fedora-rawhide/man3/scanf.3 b/upstream/fedora-rawhide/man3/scanf.3 index 17a7db08..3ac97c04 100644 --- a/upstream/fedora-rawhide/man3/scanf.3 +++ b/upstream/fedora-rawhide/man3/scanf.3 @@ -2,7 +2,7 @@ .\" Copyright 2022 Alejandro Colomar <alx@kernel.org> .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH scanf 3 2023-12-09 "Linux man-pages 6.06" +.TH scanf 3 2023-12-09 "Linux man-pages 6.7" .SH NAME scanf, fscanf, vscanf, vfscanf \- input FILE format conversion .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sched_getcpu.3 b/upstream/fedora-rawhide/man3/sched_getcpu.3 index 36f4546c..ee7ff51a 100644 --- a/upstream/fedora-rawhide/man3/sched_getcpu.3 +++ b/upstream/fedora-rawhide/man3/sched_getcpu.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sched_getcpu 3 2024-01-01 "Linux man-pages 6.06" +.TH sched_getcpu 3 2024-01-01 "Linux man-pages 6.7" .SH NAME sched_getcpu \- determine CPU on which the calling thread is running .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sd-bus-errors.3 b/upstream/fedora-rawhide/man3/sd-bus-errors.3 index dcf5f0db..2d002d98 100644 --- a/upstream/fedora-rawhide/man3/sd-bus-errors.3 +++ b/upstream/fedora-rawhide/man3/sd-bus-errors.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD\-BUS\-ERRORS" "3" "" "systemd 255" "sd-bus-errors" +.TH "SD\-BUS\-ERRORS" "3" "" "systemd 256~rc3" "sd-bus-errors" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -309,10 +309,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBlibsystemd\fR(3), -\fBsd-bus\fR(3), -\fBsd_bus_error\fR(3), -\fBsd_bus_message_set_allow_interactive_authorization\fR(3), -\fBerrno\fR(3), -\fBstrerror_r\fR(3) +\fBsystemd\fR(1), \fBlibsystemd\fR(3), \fBsd-bus\fR(3), \fBsd_bus_error\fR(3), \fBsd_bus_message_set_allow_interactive_authorization\fR(3), \fBerrno\fR(3), \fBstrerror_r\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd-bus.3 b/upstream/fedora-rawhide/man3/sd-bus.3 index e3e96064..5f0b7e96 100644 --- a/upstream/fedora-rawhide/man3/sd-bus.3 +++ b/upstream/fedora-rawhide/man3/sd-bus.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD\-BUS" "3" "" "systemd 255" "sd-bus" +.TH "SD\-BUS" "3" "" "systemd 256~rc3" "sd-bus" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -40,151 +40,411 @@ and provides an implementation of a D\-Bus IPC client\&. See for more information about D\-Bus IPC\&. .PP See -.sp -.if n \{\ .RS 4 -.\} -.nf \fBsd_bus_add_match\fR(3), +.RE +.RS 4 \fBsd_bus_add_object\fR(3), +.RE +.RS 4 \fBsd_bus_add_object_manager\fR(3), +.RE +.RS 4 \fBsd_bus_add_object_vtable\fR(3), +.RE +.RS 4 \fBsd_bus_add_fallback\fR(3), +.RE +.RS 4 \fBsd_bus_add_fallback_vtable\fR(3), +.RE +.RS 4 \fBsd_bus_add_filter\fR(3), +.RE +.RS 4 \fBsd_bus_add_node_enumerator\fR(3), +.RE +.RS 4 \fBsd_bus_attach_event\fR(3), +.RE +.RS 4 \fBsd_bus_call\fR(3), +.RE +.RS 4 \fBsd_bus_call_async\fR(3), +.RE +.RS 4 \fBsd_bus_call_method\fR(3), +.RE +.RS 4 \fBsd_bus_call_method_async\fR(3), +.RE +.RS 4 \fBsd_bus_can_send\fR(3), +.RE +.RS 4 \fBsd_bus_close\fR(3), +.RE +.RS 4 \fBsd_bus_creds_get_pid\fR(3), +.RE +.RS 4 \fBsd_bus_creds_new_from_pid\fR(3), +.RE +.RS 4 \fBsd_bus_default\fR(3), +.RE +.RS 4 \fBsd_bus_emit_interfaces_added\fR(3), +.RE +.RS 4 \fBsd_bus_emit_interfaces_added_strv\fR(3), +.RE +.RS 4 \fBsd_bus_emit_interfaces_removed\fR(3), +.RE +.RS 4 \fBsd_bus_emit_interfaces_removed_strv\fR(3), +.RE +.RS 4 \fBsd_bus_emit_object_added\fR(3), +.RE +.RS 4 \fBsd_bus_emit_object_removed\fR(3), +.RE +.RS 4 \fBsd_bus_emit_properties_changed\fR(3), +.RE +.RS 4 \fBsd_bus_emit_properties_changed_strv\fR(3), +.RE +.RS 4 \fBsd_bus_emit_signal\fR(3), +.RE +.RS 4 \fBsd_bus_emit_signalv\fR(3), +.RE +.RS 4 \fBsd_bus_emit_signal_to\fR(3), +.RE +.RS 4 \fBsd_bus_emit_signal_tov\fR(3), +.RE +.RS 4 \fBsd-bus-errors\fR(3), +.RE +.RS 4 \fBsd_bus_error\fR(3), +.RE +.RS 4 \fBsd_bus_error_add_map\fR(3), +.RE +.RS 4 \fBsd_bus_get_address\fR(3), +.RE +.RS 4 \fBsd_bus_get_allow_interactive_authorization\fR(3), +.RE +.RS 4 \fBsd_bus_get_bus_id\fR(3), +.RE +.RS 4 \fBsd_bus_get_creds_mask\fR(3), +.RE +.RS 4 \fBsd_bus_get_current_handler\fR(3), +.RE +.RS 4 \fBsd_bus_get_current_message\fR(3), +.RE +.RS 4 \fBsd_bus_get_current_slot\fR(3), +.RE +.RS 4 \fBsd_bus_get_current_userdata\fR(3), +.RE +.RS 4 \fBsd_bus_get_exit_on_disconnect\fR(3), +.RE +.RS 4 \fBsd_bus_get_fd\fR(3), +.RE +.RS 4 \fBsd_bus_get_method_call_timeout\fR(3), +.RE +.RS 4 \fBsd_bus_get_n_queued_read\fR(3), +.RE +.RS 4 \fBsd_bus_get_name_creds\fR(3), +.RE +.RS 4 \fBsd_bus_get_name_machine_id\fR(3), +.RE +.RS 4 \fBsd_bus_get_owner_creds\fR(3), +.RE +.RS 4 \fBsd_bus_get_property\fR(3), +.RE +.RS 4 \fBsd_bus_get_property_string\fR(3), +.RE +.RS 4 \fBsd_bus_get_property_strv\fR(3), +.RE +.RS 4 \fBsd_bus_get_property_trivial\fR(3), +.RE +.RS 4 \fBsd_bus_get_scope\fR(3), +.RE +.RS 4 \fBsd_bus_get_tid\fR(3), +.RE +.RS 4 \fBsd_bus_get_unique_name\fR(3), +.RE +.RS 4 \fBsd_bus_interface_name_is_valid\fR(3), +.RE +.RS 4 \fBsd_bus_is_bus_client\fR(3), +.RE +.RS 4 \fBsd_bus_is_monitor\fR(3), +.RE +.RS 4 \fBsd_bus_is_server\fR(3), +.RE +.RS 4 \fBsd_bus_list_names\fR(3), +.RE +.RS 4 \fBsd_bus_message_append\fR(3), +.RE +.RS 4 \fBsd_bus_message_append_array\fR(3), +.RE +.RS 4 \fBsd_bus_message_append_basic\fR(3), +.RE +.RS 4 \fBsd_bus_message_append_string_memfd\fR(3), +.RE +.RS 4 \fBsd_bus_message_append_strv\fR(3), +.RE +.RS 4 \fBsd_bus_message_at_end\fR(3), +.RE +.RS 4 \fBsd_bus_message_close_container\fR(3), +.RE +.RS 4 \fBsd_bus_message_copy\fR(3), +.RE +.RS 4 \fBsd_bus_message_dump\fR(3), +.RE +.RS 4 \fBsd_bus_message_enter_container\fR(3), +.RE +.RS 4 \fBsd_bus_message_exit_container\fR(3), +.RE +.RS 4 \fBsd_bus_message_get_allow_interactive_authorization\fR(3), +.RE +.RS 4 \fBsd_bus_message_get_cookie\fR(3), +.RE +.RS 4 \fBsd_bus_message_get_creds\fR(3), +.RE +.RS 4 \fBsd_bus_message_get_errno\fR(3), +.RE +.RS 4 \fBsd_bus_message_get_error\fR(3), +.RE +.RS 4 \fBsd_bus_message_get_monotonic_usec\fR(3), +.RE +.RS 4 \fBsd_bus_message_get_sender\fR(3), +.RE +.RS 4 \fBsd_bus_message_get_signature\fR(3), +.RE +.RS 4 \fBsd_bus_message_get_type\fR(3), +.RE +.RS 4 \fBsd_bus_message_new\fR(3), +.RE +.RS 4 \fBsd_bus_message_new_method_call\fR(3), +.RE +.RS 4 \fBsd_bus_message_new_method_error\fR(3), +.RE +.RS 4 \fBsd_bus_message_new_signal\fR(3), +.RE +.RS 4 \fBsd_bus_message_new_signal_to\fR(3), +.RE +.RS 4 \fBsd_bus_message_open_container\fR(3), +.RE +.RS 4 \fBsd_bus_message_peek_type\fR(3), +.RE +.RS 4 \fBsd_bus_message_read\fR(3), +.RE +.RS 4 \fBsd_bus_message_read_array\fR(3), +.RE +.RS 4 \fBsd_bus_message_read_basic\fR(3), +.RE +.RS 4 \fBsd_bus_message_read_strv\fR(3), +.RE +.RS 4 \fBsd_bus_message_rewind\fR(3), +.RE +.RS 4 \fBsd_bus_message_seal\fR(3), +.RE +.RS 4 \fBsd_bus_message_send\fR(3), +.RE +.RS 4 \fBsd_bus_message_set_allow_interactive_authorization\fR(3), +.RE +.RS 4 \fBsd_bus_message_set_destination\fR(3), +.RE +.RS 4 \fBsd_bus_message_set_expect_reply\fR(3), +.RE +.RS 4 \fBsd_bus_message_set_sender\fR(3), +.RE +.RS 4 \fBsd_bus_message_skip\fR(3), +.RE +.RS 4 \fBsd_bus_message_verify_type\fR(3), +.RE +.RS 4 \fBsd_bus_negotiate_fds\fR(3), +.RE +.RS 4 \fBsd_bus_new\fR(3), +.RE +.RS 4 \fBsd_bus_path_encode\fR(3), +.RE +.RS 4 \fBsd_bus_process\fR(3), +.RE +.RS 4 \fBsd_bus_query_sender_creds\fR(3), +.RE +.RS 4 \fBsd_bus_query_sender_privilege\fR(3), +.RE +.RS 4 \fBsd_bus_reply_method_error\fR(3), +.RE +.RS 4 \fBsd_bus_reply_method_return\fR(3), +.RE +.RS 4 \fBsd_bus_request_name\fR(3), +.RE +.RS 4 \fBsd_bus_send\fR(3), +.RE +.RS 4 \fBsd_bus_send_to\fR(3), +.RE +.RS 4 \fBsd_bus_set_address\fR(3), +.RE +.RS 4 \fBsd_bus_set_allow_interactive_authorization\fR(3), +.RE +.RS 4 \fBsd_bus_set_bus_client\fR(3), +.RE +.RS 4 \fBsd_bus_set_close_on_exit\fR(3), +.RE +.RS 4 \fBsd_bus_set_connected_signal\fR(3), +.RE +.RS 4 \fBsd_bus_set_description\fR(3), +.RE +.RS 4 \fBsd_bus_set_exit_on_disconnect\fR(3), +.RE +.RS 4 \fBsd_bus_set_method_call_timeout\fR(3), +.RE +.RS 4 \fBsd_bus_set_monitor\fR(3), +.RE +.RS 4 \fBsd_bus_set_property\fR(3), +.RE +.RS 4 \fBsd_bus_set_propertyv\fR(3), +.RE +.RS 4 \fBsd_bus_set_sender\fR(3), +.RE +.RS 4 \fBsd_bus_set_server\fR(3), +.RE +.RS 4 \fBsd_bus_set_watch_bind\fR(3) +.RE +.RS 4 \fBsd_bus_slot_get_current_handler\fR(3), +.RE +.RS 4 \fBsd_bus_slot_get_current_message\fR(3), +.RE +.RS 4 \fBsd_bus_slot_get_current_userdata\fR(3), +.RE +.RS 4 \fBsd_bus_slot_set_description\fR(3), +.RE +.RS 4 \fBsd_bus_slot_set_destroy_callback\fR(3), +.RE +.RS 4 \fBsd_bus_slot_set_floating\fR(3), +.RE +.RS 4 \fBsd_bus_slot_set_userdata\fR(3), +.RE +.RS 4 \fBsd_bus_start\fR(3), +.RE +.RS 4 \fBsd_bus_track_add_name\fR(3), +.RE +.RS 4 \fBsd_bus_track_new\fR(3) -.fi -.if n \{\ .RE -.\} -.sp for more information about the functions available\&. .SH "NOTES" .PP @@ -200,8 +460,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBbusctl\fR(1), -\fBdbus-daemon\fR(1), -\fBdbus-send\fR(1) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBbusctl\fR(1), \fBdbus-daemon\fR(1), \fBdbus-send\fR(1) diff --git a/upstream/fedora-rawhide/man3/sd-daemon.3 b/upstream/fedora-rawhide/man3/sd-daemon.3 index c8fbe51b..4acf88a6 100644 --- a/upstream/fedora-rawhide/man3/sd-daemon.3 +++ b/upstream/fedora-rawhide/man3/sd-daemon.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD\-DAEMON" "3" "" "systemd 255" "sd-daemon" +.TH "SD\-DAEMON" "3" "" "systemd 256~rc3" "sd-daemon" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -104,14 +104,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd_listen_fds\fR(3), -\fBsd_notify\fR(3), -\fBsd_booted\fR(3), -\fBsd_is_fifo\fR(3), -\fBsd_watchdog_enabled\fR(3), -\fBdaemon\fR(7), -\fBsystemd.service\fR(5), -\fBsystemd.socket\fR(5), -\fBfprintf\fR(3), -\fBpkg-config\fR(1) +\fBsystemd\fR(1), \fBsd_listen_fds\fR(3), \fBsd_notify\fR(3), \fBsd_booted\fR(3), \fBsd_is_fifo\fR(3), \fBsd_watchdog_enabled\fR(3), \fBdaemon\fR(7), \fBsystemd.service\fR(5), \fBsystemd.socket\fR(5), \fBfprintf\fR(3), \fBpkg-config\fR(1) diff --git a/upstream/fedora-rawhide/man3/sd-device.3 b/upstream/fedora-rawhide/man3/sd-device.3 index b45ffc34..bd88494e 100644 --- a/upstream/fedora-rawhide/man3/sd-device.3 +++ b/upstream/fedora-rawhide/man3/sd-device.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD\-DEVICE" "3" "" "systemd 255" "sd-device" +.TH "SD\-DEVICE" "3" "" "systemd 256~rc3" "sd-device" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -42,18 +42,12 @@ and libudev\&.h\&. .PP See -.sp -.if n \{\ .RS 4 -.\} -.nf \fBsd_device_get_syspath\fR(3), +.RE +.RS 4 \fBsd_device_ref\fR(3) -.fi -.if n \{\ .RE -.\} -.sp for more information about the functions available\&. .SH "NOTES" .PP @@ -69,6 +63,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBudevadm\fR(8) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBudevadm\fR(8) diff --git a/upstream/fedora-rawhide/man3/sd-event.3 b/upstream/fedora-rawhide/man3/sd-event.3 index b90da13b..15245b2e 100644 --- a/upstream/fedora-rawhide/man3/sd-event.3 +++ b/upstream/fedora-rawhide/man3/sd-event.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD\-EVENT" "3" "" "systemd 255" "sd-event" +.TH "SD\-EVENT" "3" "" "systemd 256~rc3" "sd-event" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -192,31 +192,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd_event_new\fR(3), -\fBsd_event_run\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_add_memory_pressure\fR(3), -\fBsd_event_source_unref\fR(3), -\fBsd_event_source_set_priority\fR(3), -\fBsd_event_source_set_enabled\fR(3), -\fBsd_event_source_set_userdata\fR(3), -\fBsd_event_source_get_event\fR(3), -\fBsd_event_source_get_pending\fR(3), -\fBsd_event_source_set_description\fR(3), -\fBsd_event_source_set_prepare\fR(3), -\fBsd_event_source_set_ratelimit\fR(3), -\fBsd_event_wait\fR(3), -\fBsd_event_get_fd\fR(3), -\fBsd_event_set_watchdog\fR(3), -\fBsd_event_exit\fR(3), -\fBsd_event_now\fR(3), -\fBepoll\fR(7), -\fBtimerfd_create\fR(2), -\fBsignalfd\fR(2), -\fBwaitid\fR(2) +\fBsystemd\fR(1), \fBsd_event_new\fR(3), \fBsd_event_run\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_add_memory_pressure\fR(3), \fBsd_event_source_unref\fR(3), \fBsd_event_source_set_priority\fR(3), \fBsd_event_source_set_enabled\fR(3), \fBsd_event_source_set_userdata\fR(3), \fBsd_event_source_get_event\fR(3), \fBsd_event_source_get_pending\fR(3), \fBsd_event_source_set_description\fR(3), \fBsd_event_source_set_prepare\fR(3), \fBsd_event_source_set_ratelimit\fR(3), \fBsd_event_wait\fR(3), \fBsd_event_get_fd\fR(3), \fBsd_event_set_watchdog\fR(3), \fBsd_event_exit\fR(3), \fBsd_event_now\fR(3), \fBepoll\fR(7), \fBtimerfd_create\fR(2), \fBsignalfd\fR(2), \fBwaitid\fR(2) diff --git a/upstream/fedora-rawhide/man3/sd-hwdb.3 b/upstream/fedora-rawhide/man3/sd-hwdb.3 index e286d2c7..e2d2b372 100644 --- a/upstream/fedora-rawhide/man3/sd-hwdb.3 +++ b/upstream/fedora-rawhide/man3/sd-hwdb.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD\-HWDB" "3" "" "systemd 255" "sd-hwdb" +.TH "SD\-HWDB" "3" "" "systemd 256~rc3" "sd-hwdb" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -60,5 +60,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-udevd.service\fR(8) +\fBsystemd\fR(1), \fBsystemd-udevd.service\fR(8) diff --git a/upstream/fedora-rawhide/man3/sd-id128.3 b/upstream/fedora-rawhide/man3/sd-id128.3 index b8034c90..247270e4 100644 --- a/upstream/fedora-rawhide/man3/sd-id128.3 +++ b/upstream/fedora-rawhide/man3/sd-id128.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD\-ID128" "3" "" "systemd 255" "sd-id128" +.TH "SD\-ID128" "3" "" "systemd 256~rc3" "sd-id128" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -57,7 +57,7 @@ sd-id128, SD_ID128_ALLF, SD_ID128_CONST_STR, SD_ID128_FORMAT_STR, SD_ID128_FORMA .HP \w'int\ sd_id128_in_setv('u .BI "int sd_id128_in_setv(sd_id128_t\ " "id" ", va_list\ " "ap" ");" .HP \w'int\ sd_id128_in_set_sentinel('u -.BI "int sd_id128_in_set_sentinel(sd_id128_t\ " "id" ", \&..., \fBSD_ID128_NULL\fR);" +.BI "int sd_id128_in_set_sentinel(sd_id128_t\ " "id" ", \&..., " "\fBSD_ID128_NULL\fR" ");" .HP \w'int\ sd_id128_in_set('u .BI "int sd_id128_in_set(sd_id128_t\ " "id" ", \&...);" .HP \w'\fBpkg\-config\ \-\-cflags\ \-\-libs\ libsystemd\fR\ 'u @@ -320,15 +320,7 @@ from an early phase of the program when no other threads have been started\&. were added in version 252\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd_id128_to_string\fR(3), -\fBsd_id128_randomize\fR(3), -\fBsd_id128_get_machine\fR(3), -\fBprintf\fR(3), -\fBjournalctl\fR(1), -\fBsd-journal\fR(7), -\fBpkg-config\fR(1), -\fBmachine-id\fR(5) +\fBsystemd\fR(1), \fBsd_id128_to_string\fR(3), \fBsd_id128_randomize\fR(3), \fBsd_id128_get_machine\fR(3), \fBprintf\fR(3), \fBjournalctl\fR(1), \fBsd-journal\fR(7), \fBpkg-config\fR(1), \fBmachine-id\fR(5) .SH "NOTES" .IP " 1." 4 RFC 4122 diff --git a/upstream/fedora-rawhide/man3/sd-journal.3 b/upstream/fedora-rawhide/man3/sd-journal.3 index af00781e..1e58cf74 100644 --- a/upstream/fedora-rawhide/man3/sd-journal.3 +++ b/upstream/fedora-rawhide/man3/sd-journal.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD\-JOURNAL" "3" "" "systemd 255" "sd-journal" +.TH "SD\-JOURNAL" "3" "" "systemd 256~rc3" "sd-journal" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -77,6 +77,12 @@ and similar, or those that are used to retrieve global information like and \fBsd_journal_get_catalog_for_message_id\fR(3) \(em are fully thread\-safe and may be called from multiple threads in parallel\&. +.SH "OPTIONAL DEPENDENCIES" +.PP +Depending on which build\-time options are enabled, functions that operate on +sd_journal +objects might cause optional shared libraries to be dynamically loaded via +\fBdlopen\fR(3), such as decompression libraries (xz, lz4, zstd) or cryptographic libraries (gcrypt)\&. .SH "NOTES" .PP Functions described here are available as a shared library, which can be compiled against and linked to with the @@ -91,25 +97,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd_journal_print\fR(3), -\fBsd_journal_stream_fd\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_next\fR(3), -\fBsd_journal_get_data\fR(3), -\fBsd_journal_get_realtime_usec\fR(3), -\fBsd_journal_add_match\fR(3), -\fBsd_journal_seek_head\fR(3), -\fBsd_journal_enumerate_fields\fR(3), -\fBsd_journal_get_cursor\fR(3), -\fBsd_journal_get_cutoff_realtime_usec\fR(3), -\fBsd_journal_get_cutoff_monotonic_usec\fR(3), -\fBsd_journal_get_usage\fR(3), -\fBsd_journal_get_fd\fR(3), -\fBsd_journal_query_unique\fR(3), -\fBsd_journal_get_catalog\fR(3), -\fBsd_journal_has_runtime_files\fR(3), -\fBsd_journal_has_persistent_files\fR(3), -\fBjournalctl\fR(1), -\fBsd-id128\fR(3), -\fBpkg-config\fR(1) +\fBsystemd\fR(1), \fBsd_journal_print\fR(3), \fBsd_journal_stream_fd\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_next\fR(3), \fBsd_journal_get_data\fR(3), \fBsd_journal_get_realtime_usec\fR(3), \fBsd_journal_add_match\fR(3), \fBsd_journal_seek_head\fR(3), \fBsd_journal_enumerate_fields\fR(3), \fBsd_journal_get_cursor\fR(3), \fBsd_journal_get_cutoff_realtime_usec\fR(3), \fBsd_journal_get_cutoff_monotonic_usec\fR(3), \fBsd_journal_get_usage\fR(3), \fBsd_journal_get_fd\fR(3), \fBsd_journal_query_unique\fR(3), \fBsd_journal_get_catalog\fR(3), \fBsd_journal_has_runtime_files\fR(3), \fBsd_journal_has_persistent_files\fR(3), \fBjournalctl\fR(1), \fBsd-id128\fR(3), \fBpkg-config\fR(1) diff --git a/upstream/fedora-rawhide/man3/sd-login.3 b/upstream/fedora-rawhide/man3/sd-login.3 index c1ff474a..f6401a2a 100644 --- a/upstream/fedora-rawhide/man3/sd-login.3 +++ b/upstream/fedora-rawhide/man3/sd-login.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD\-LOGIN" "3" "" "systemd 255" "sd-login" +.TH "SD\-LOGIN" "3" "" "systemd 256~rc3" "sd-login" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -182,15 +182,7 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd_pid_get_session\fR(3), -\fBsd_uid_get_state\fR(3), -\fBsd_session_is_active\fR(3), -\fBsd_seat_get_active\fR(3), -\fBsd_get_seats\fR(3), -\fBsd_login_monitor_new\fR(3), -\fBsd-daemon\fR(3), -\fBpkg-config\fR(1) +\fBsystemd\fR(1), \fBsd_pid_get_session\fR(3), \fBsd_uid_get_state\fR(3), \fBsd_session_is_active\fR(3), \fBsd_seat_get_active\fR(3), \fBsd_get_seats\fR(3), \fBsd_login_monitor_new\fR(3), \fBsd-daemon\fR(3), \fBpkg-config\fR(1) .PP \m[blue]\fBMulti\-Seat on Linux\fR\m[]\&\s-2\u[1]\d\s+2 may also be of historical interest\&. diff --git a/upstream/fedora-rawhide/man3/sd_booted.3 b/upstream/fedora-rawhide/man3/sd_booted.3 index 6a022baa..ad3a430f 100644 --- a/upstream/fedora-rawhide/man3/sd_booted.3 +++ b/upstream/fedora-rawhide/man3/sd_booted.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BOOTED" "3" "" "systemd 255" "sd_booted" +.TH "SD_BOOTED" "3" "" "systemd 256~rc3" "sd_booted" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -48,5 +48,4 @@ Internally, this function checks whether the directory exists\&. A simple check like this can also be implemented trivially in shell or any other language\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-daemon\fR(3) +\fBsystemd\fR(1), \fBsd-daemon\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_add_match.3 b/upstream/fedora-rawhide/man3/sd_bus_add_match.3 index 26a1a815..d6e85fc4 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_add_match.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_add_match.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_ADD_MATCH" "3" "" "systemd 255" "sd_bus_add_match" +.TH "SD_BUS_ADD_MATCH" "3" "" "systemd 256~rc3" "sd_bus_add_match" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -125,7 +125,7 @@ from an early phase of the program when no other threads have been started\&. \fBsd_bus_add_match()\fR and \fBsd_bus_message_handler_t()\fR -were added in version 231\&. +were added in version 221\&. .PP \fBsd_bus_add_match_async()\fR, \fBsd_bus_match_signal()\fR, and @@ -133,12 +133,7 @@ were added in version 231\&. were added in version 237\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_slot_unref\fR(3), -\fBsd_bus_message_ref\fR(3), -\fBsd_bus_set_bus_client\fR(3), -\fBsd_bus_slot_set_floating\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_slot_unref\fR(3), \fBsd_bus_message_ref\fR(3), \fBsd_bus_set_bus_client\fR(3), \fBsd_bus_slot_set_floating\fR(3) .SH "NOTES" .IP " 1." 4 D-Bus Specification diff --git a/upstream/fedora-rawhide/man3/sd_bus_add_node_enumerator.3 b/upstream/fedora-rawhide/man3/sd_bus_add_node_enumerator.3 index f5de96d0..1edfd738 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_add_node_enumerator.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_add_node_enumerator.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_ADD_NODE_ENUMERATOR" "3" "" "systemd 255" "sd_bus_add_node_enumerator" +.TH "SD_BUS_ADD_NODE_ENUMERATOR" "3" "" "systemd 256~rc3" "sd_bus_add_node_enumerator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -80,29 +80,21 @@ One of the required parameters is or \fIpath\fR is not a valid object path\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOPKG\fR .RS 4 The bus cannot be resolved\&. -.sp -Added in version 246\&. .RE .PP \fB\-ECHILD\fR .RS 4 The bus was created in a different process, library or module instance\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOMEM\fR .RS 4 Memory allocation failed\&. -.sp -Added in version 246\&. .RE .SH "NOTES" .PP @@ -121,10 +113,7 @@ from an early phase of the program when no other threads have been started\&. \fBsd_bus_node_enumerator_t()\fR and \fBsd_bus_add_node_enumerator()\fR -were added in version 246\&. +were added in version 221\&. .SH "SEE ALSO" .PP -\fBsd-bus\fR(3), -\fBbusctl\fR(1), -\fBsd_bus_add_fallback_vtable\fR(3), -\fBsd_bus_slot_unref\fR(3) +\fBsd-bus\fR(3), \fBbusctl\fR(1), \fBsd_bus_add_fallback_vtable\fR(3), \fBsd_bus_slot_unref\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_add_object.3 b/upstream/fedora-rawhide/man3/sd_bus_add_object.3 index 559034e1..e71906e3 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_add_object.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_add_object.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_ADD_OBJECT" "3" "" "systemd 255" "sd_bus_add_object" +.TH "SD_BUS_ADD_OBJECT" "3" "" "systemd 256~rc3" "sd_bus_add_object" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -28,7 +28,6 @@ sd_bus_add_object, sd_bus_add_fallback, sd_bus_add_object_vtable, sd_bus_add_fal #include <systemd/sd\-bus\-vtable\&.h> .fi .ft -.sp .HP \w'typedef\ int\ (*sd_bus_message_handler_t)('u .BI "typedef int (*sd_bus_message_handler_t)(sd_bus_message\ *" "m" ", void\ *" "userdata" ", sd_bus_error\ *" "ret_error" ");" .HP \w'typedef\ int\ (*sd_bus_property_get_t)('u @@ -234,8 +233,6 @@ is a combination of flags, see below\&. is a shorthand for calling \fBSD_BUS_METHOD_WITH_ARGS_OFFSET()\fR with an offset of zero\&. -.sp -Added in version 246\&. .RE .PP \fBSD_BUS_METHOD_WITH_NAMES_OFFSET()\fR, \fBSD_BUS_METHOD_WITH_NAMES()\fR, \fBSD_BUS_METHOD_WITH_OFFSET()\fR, \fBSD_BUS_METHOD()\fR @@ -267,8 +264,6 @@ Prefer using and \fBSD_BUS_METHOD_WITH_ARGS()\fR over these macros as they allow specifying argument types and names next to each other which is less error\-prone than first specifying all argument types followed by specifying all argument names\&. -.sp -Added in version 246\&. .RE .PP \fBSD_BUS_SIGNAL_WITH_ARGS()\fR @@ -287,8 +282,6 @@ to \fIargs\fR\&. The elements at uneven indices describe the names of the signal\*(Aqs arguments\&. Parameter \fIflags\fR is a combination of flags\&. See below for a complete example\&. -.sp -Added in version 246\&. .RE .PP \fBSD_BUS_SIGNAL_WITH_NAMES()\fR, \fBSD_BUS_SIGNAL()\fR @@ -314,8 +307,6 @@ parameter unset (i\&.e\&. no parameter names)\&. Prefer using \fBSD_BUS_SIGNAL_WITH_ARGS()\fR over these macros as it allows specifying argument types and names next to each other which is less error\-prone than first specifying all argument types followed by specifying all argument names\&. -.sp -Added in version 246\&. .RE .PP \fBSD_BUS_WRITABLE_PROPERTY()\fR, \fBSD_BUS_PROPERTY()\fR @@ -346,15 +337,11 @@ parameters must together point to a valid variable of the corresponding type\&. .sp \fBSD_BUS_PROPERTY()\fR is used to define a read\-only property\&. -.sp -Added in version 246\&. .RE .PP \fBSD_BUS_PARAM()\fR .RS 4 Parameter names should be wrapped in this macro, see the example below\&. -.sp -Added in version 246\&. .RE .SS "Flags" .PP @@ -369,16 +356,12 @@ Mark this vtable entry as deprecated using the \fBorg\&.freedesktop\&.DBus\&.Deprecated\fR annotation in introspection data\&. If specified for \fBSD_BUS_VTABLE_START()\fR, the annotation is applied to the enclosing interface\&. -.sp -Added in version 246\&. .RE .PP \fBSD_BUS_VTABLE_HIDDEN\fR .RS 4 Make this vtable entry hidden\&. It will not be shown in introspection data\&. If specified for \fBSD_BUS_VTABLE_START()\fR, all entries in the array are hidden\&. -.sp -Added in version 246\&. .RE .PP \fBSD_BUS_VTABLE_METHOD_NO_REPLY\fR @@ -386,8 +369,6 @@ Added in version 246\&. Mark this vtable entry as a method that will not return a reply using the \fBorg\&.freedesktop\&.DBus\&.Method\&.NoReply\fR annotation in introspection data\&. -.sp -Added in version 246\&. .RE .PP \fBSD_BUS_VTABLE_PROPERTY_CONST\fR, \fBSD_BUS_VTABLE_PROPERTY_EMITS_CHANGE\fR, \fBSD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION\fR @@ -409,8 +390,6 @@ and means that the signal is emitted\&. corresponds to \fBinvalidates\fR and means that the signal is emitted, but the value is not included in the signal\&. -.sp -Added in version 246\&. .RE .PP \fBSD_BUS_VTABLE_PROPERTY_EXPLICIT\fR @@ -420,23 +399,17 @@ Mark this vtable property entry as requiring explicit request to for the value t \fBbusctl introspect\fR)\&. This corresponds to the \fBorg\&.freedesktop\&.systemd1\&.Explicit\fR annotation in introspection data\&. -.sp -Added in version 246\&. .RE .PP \fBSD_BUS_VTABLE_SENSITIVE\fR .RS 4 Mark this vtable method entry as processing sensitive data\&. When set, incoming method call messages and their outgoing reply messages are marked as sensitive using \fBsd_bus_message_sensitive\fR(3), so that they are erased from memory when freed\&. -.sp -Added in version 246\&. .RE .PP \fBSD_BUS_VTABLE_ABSOLUTE_OFFSET\fR .RS 4 Mark this vtable method or property entry so that the user data pointer passed to its associated handler functions is determined slightly differently: instead of adding the offset parameter of the entry to the user data pointer specified during vtable registration, the offset is passed directly, converted to a pointer, without taking the user data pointer specified during vtable registration into account\&. -.sp -Added in version 246\&. .RE .PP \fBSD_BUS_VTABLE_CAPABILITY(\fR\fB\fIcapability\fR\fR\fB)\fR @@ -453,8 +426,6 @@ for information about capabilities\&. Note that vtable entries may be marked as unprivileged and the whole bus may be marked as trusted, see the discussion of \fBSD_BUS_VTABLE_UNPRIVILEGED\fR below\&. -.sp -Added in version 251\&. .RE .PP \fBSD_BUS_VTABLE_UNPRIVILEGED\fR @@ -475,8 +446,6 @@ will be shown in introspection data\&. .sp Note that this page describes checks implemented in the D\-Bus client\&. The D\-Bus server has an additional policy that may permit or deny connections, see "CONFIGURATION FILE" in \fBdbus-daemon\fR(1)\&. -.sp -Added in version 246\&. .RE .SH "EXAMPLES" .PP @@ -488,6 +457,7 @@ Added in version 246\&. .nf /* SPDX\-License\-Identifier: MIT\-0 */ +#define _GNU_SOURCE 1 #include <errno\&.h> #include <stdbool\&.h> #include <stddef\&.h> @@ -497,20 +467,14 @@ Added in version 246\&. #define _cleanup_(f) __attribute__((cleanup(f))) -#define check(x) ({ \e - int r = (x); \e - errno = r < 0 ? \-r : 0; \e - printf(#x ": %m\en"); \e - if (r < 0) \e - return EXIT_FAILURE; \e - }) - typedef struct object { char *name; uint32_t number; } object; static int method(sd_bus_message *m, void *userdata, sd_bus_error *error) { + int r; + printf("Got called with userdata=%p\en", userdata); if (sd_bus_message_is_method_call(m, @@ -519,8 +483,17 @@ static int method(sd_bus_message *m, void *userdata, sd_bus_error *error) { return 1; const char *string; - check(sd_bus_message_read(m, "s", &string)); - check(sd_bus_reply_method_return(m, "s", string)); + r = sd_bus_message_read(m, "s", &string); + if (r < 0) { + fprintf(stderr, "sd_bus_message_read() failed: %s\en", strerror(\-r)); + return 0; + } + + r = sd_bus_reply_method_return(m, "s", string); + if (r < 0) { + fprintf(stderr, "sd_bus_reply_method_return() failed: %s\en", strerror(\-r)); + return 0; + } return 1; } @@ -572,28 +545,55 @@ static const sd_bus_vtable vtable[] = { int main(int argc, char **argv) { _cleanup_(sd_bus_flush_close_unrefp) sd_bus *bus = NULL; + int r; sd_bus_default(&bus); object object = { \&.number = 666 }; - check((object\&.name = strdup("name")) != NULL); + object\&.name = strdup("name"); + if (!object\&.name) { + fprintf(stderr, "OOM\en"); + return EXIT_FAILURE; + } - check(sd_bus_add_object_vtable(bus, NULL, - "/org/freedesktop/systemd/VtableExample", - "org\&.freedesktop\&.systemd\&.VtableExample", - vtable, - &object)); + r = sd_bus_add_object_vtable(bus, NULL, + "/org/freedesktop/systemd/VtableExample", + "org\&.freedesktop\&.systemd\&.VtableExample", + vtable, + &object); + if (r < 0) { + fprintf(stderr, "sd_bus_add_object_vtable() failed: %s\en", strerror(\-r)); + return EXIT_FAILURE; + } - check(sd_bus_request_name(bus, - "org\&.freedesktop\&.systemd\&.VtableExample", - 0)); + r = sd_bus_request_name(bus, + "org\&.freedesktop\&.systemd\&.VtableExample", + 0); + if (r < 0) { + fprintf(stderr, "sd_bus_request_name() failed: %s\en", strerror(\-r)); + return EXIT_FAILURE; + } for (;;) { - check(sd_bus_wait(bus, UINT64_MAX)); - check(sd_bus_process(bus, NULL)); + r = sd_bus_wait(bus, UINT64_MAX); + if (r < 0) { + fprintf(stderr, "sd_bus_wait() failed: %s\en", strerror(\-r)); + return EXIT_FAILURE; + } + + r = sd_bus_process(bus, NULL); + if (r < 0) { + fprintf(stderr, "sd_bus_process() failed: %s\en", strerror(\-r)); + return EXIT_FAILURE; + } + } + + r = sd_bus_release_name(bus, "org\&.freedesktop\&.systemd\&.VtableExample"); + if (r < 0) { + fprintf(stderr, "sd_bus_release_name() failed: %s\en", strerror(\-r)); + return EXIT_FAILURE; } - check(sd_bus_release_name(bus, "org\&.freedesktop\&.systemd\&.VtableExample")); free(object\&.name); return 0; @@ -688,29 +688,21 @@ One of the required parameters is or invalid\&. A reserved D\-Bus interface was passed as the \fIinterface\fR parameter\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOPKG\fR .RS 4 The bus cannot be resolved\&. -.sp -Added in version 246\&. .RE .PP \fB\-ECHILD\fR .RS 4 The bus was created in a different process, library or module instance\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOMEM\fR .RS 4 Memory allocation failed\&. -.sp -Added in version 246\&. .RE .PP \fB\-EPROTOTYPE\fR @@ -719,8 +711,6 @@ Added in version 246\&. and \fBsd_bus_add_fallback_vtable()\fR have been both called for the same bus object path, which is not allowed\&. -.sp -Added in version 246\&. .RE .PP \fB\-EEXIST\fR @@ -729,8 +719,6 @@ This vtable has already been registered for this \fIinterface\fR and \fIpath\fR\&. -.sp -Added in version 246\&. .RE .SH "NOTES" .PP @@ -754,13 +742,10 @@ from an early phase of the program when no other threads have been started\&. \fBsd_bus_add_object_vtable()\fR, \fBsd_bus_add_fallback_vtable()\fR, and \fBsd_bus_add_filter()\fR -were added in version 246\&. +were added in version 221\&. .SH "SEE ALSO" .PP -\fBsd-bus\fR(3), -\fBbusctl\fR(1), -\fBsd_bus_emit_properties_changed\fR(3), -\fBsd_bus_emit_object_added\fR(3) +\fBsd-bus\fR(3), \fBbusctl\fR(1), \fBsd_bus_emit_properties_changed\fR(3), \fBsd_bus_emit_object_added\fR(3) .SH "NOTES" .IP " 1." 4 D-Bus annotations diff --git a/upstream/fedora-rawhide/man3/sd_bus_add_object_manager.3 b/upstream/fedora-rawhide/man3/sd_bus_add_object_manager.3 index 63d8068c..8af59fe9 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_add_object_manager.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_add_object_manager.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_ADD_OBJECT_MANAGER" "3" "" "systemd 255" "sd_bus_add_object_manager" +.TH "SD_BUS_ADD_OBJECT_MANAGER" "3" "" "systemd 256~rc3" "sd_bus_add_object_manager" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -77,29 +77,21 @@ One of the required parameters is or \fIpath\fR is not a valid object path\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOPKG\fR .RS 4 The bus cannot be resolved\&. -.sp -Added in version 246\&. .RE .PP \fB\-ECHILD\fR .RS 4 The bus was created in a different process, library or module instance\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOMEM\fR .RS 4 Memory allocation failed\&. -.sp -Added in version 246\&. .RE .SH "NOTES" .PP @@ -116,14 +108,10 @@ from an early phase of the program when no other threads have been started\&. .SH "HISTORY" .PP \fBsd_bus_add_object_manager()\fR -was added in version 246\&. +was added in version 221\&. .SH "SEE ALSO" .PP -\fBsd-bus\fR(3), -\fBbusctl\fR(1), -\fBsd_bus_add_object_vtable\fR(3), -\fBsd_bus_emit_interfaces_added\fR(3), -\fBsd_bus_slot_unref\fR(3) +\fBsd-bus\fR(3), \fBbusctl\fR(1), \fBsd_bus_add_object_vtable\fR(3), \fBsd_bus_emit_interfaces_added\fR(3), \fBsd_bus_slot_unref\fR(3) .SH "NOTES" .IP " 1." 4 org.freedesktop.DBus.ObjectManager diff --git a/upstream/fedora-rawhide/man3/sd_bus_attach_event.3 b/upstream/fedora-rawhide/man3/sd_bus_attach_event.3 index d73c3ed8..9b4cb6dd 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_attach_event.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_attach_event.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_ATTACH_EVENT" "3" "" "systemd 255" "sd_bus_attach_event" +.TH "SD_BUS_ATTACH_EVENT" "3" "" "systemd 256~rc3" "sd_bus_attach_event" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -101,13 +101,7 @@ from an early phase of the program when no other threads have been started\&. \fBsd_bus_attach_event()\fR, \fBsd_bus_detach_event()\fR, and \fBsd_bus_get_event()\fR -were added in version 240\&. +were added in version 221\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd-event\fR(3), -\fBsd_event_source_set_priority\fR(3), -\fBsd_bus_set_close_on_exit\fR(3), -\fBsd_bus_wait\fR(3), -\fBsd_bus_get_fd\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd-event\fR(3), \fBsd_event_source_set_priority\fR(3), \fBsd_bus_set_close_on_exit\fR(3), \fBsd_bus_wait\fR(3), \fBsd_bus_get_fd\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_call.3 b/upstream/fedora-rawhide/man3/sd_bus_call.3 index c142ae6a..7e9e58f3 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_call.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_call.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_CALL" "3" "" "systemd 255" "sd_bus_call" +.TH "SD_BUS_CALL" "3" "" "systemd 256~rc3" "sd_bus_call" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -130,16 +130,17 @@ The input parameter is \fBNULL\fR\&. .sp -Added in version 246\&. The input parameter \fIm\fR is not a D\-Bus method call\&. To create a new D\-Bus method call, use \fBsd_bus_message_new_method_call\fR(3)\&. +.sp The input parameter \fIm\fR has the \fBBUS_MESSAGE_NO_REPLY_EXPECTED\fR flag set\&. +.sp The input parameter \fIerror\fR is non\-\fBNULL\fR @@ -151,8 +152,6 @@ but was not set to .RS 4 The bus connection was allocated in a parent process and is being reused in a child process after \fBfork()\fR\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOTCONN\fR @@ -162,22 +161,16 @@ The input parameter is \fBNULL\fR or the bus is not connected\&. -.sp -Added in version 246\&. .RE .PP \fB\-ECONNRESET\fR .RS 4 The bus connection was closed while waiting for the response\&. -.sp -Added in version 246\&. .RE .PP \fB\-ETIMEDOUT\fR .RS 4 A response was not received within the given timeout\&. -.sp -Added in version 246\&. .RE .PP \fB\-ELOOP\fR @@ -185,15 +178,11 @@ Added in version 246\&. The message \fIm\fR is addressed to its own client\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOMEM\fR .RS 4 Memory allocation failed\&. -.sp -Added in version 246\&. .RE .SH "NOTES" .PP @@ -212,13 +201,7 @@ from an early phase of the program when no other threads have been started\&. \fBsd_bus_call()\fR and \fBsd_bus_call_async()\fR -were added in version 246\&. +were added in version 221\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_call_method\fR(3), -\fBsd_bus_call_method_async\fR(3), -\fBsd_bus_message_new_method_call\fR(3), -\fBsd_bus_message_append\fR(3), -\fBsd_bus_error\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_call_method\fR(3), \fBsd_bus_call_method_async\fR(3), \fBsd_bus_message_new_method_call\fR(3), \fBsd_bus_message_append\fR(3), \fBsd_bus_error\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_call_method.3 b/upstream/fedora-rawhide/man3/sd_bus_call_method.3 index 6690ecbf..70527f91 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_call_method.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_call_method.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_CALL_METHOD" "3" "" "systemd 255" "sd_bus_call_method" +.TH "SD_BUS_CALL_METHOD" "3" "" "systemd 256~rc3" "sd_bus_call_method" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -110,8 +110,7 @@ from an early phase of the program when no other threads have been started\&. #define MEMBER "GetUnitByPID" static int log_error(int error, const char *message) { - errno = \-error; - fprintf(stderr, "%s: %m\en", message); + fprintf(stderr, "%s: %s\en", message, strerror(\-error)); return error; } @@ -146,17 +145,13 @@ int main(int argc, char **argv) { This defines a minimally useful program that will open a connection to the bus, call a method, wait for the reply, and finally extract and print the answer\&. It does error handling and proper memory management\&. .SH "HISTORY" .PP -\fBsd_bus_call_method()\fR, +\fBsd_bus_call_method()\fR, and +\fBsd_bus_call_method_async()\fR +were added in version 221\&. +.PP \fBsd_bus_call_methodv()\fR, -\fBsd_bus_call_method_async()\fR, and \fBsd_bus_call_method_asyncv()\fR were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_new_method_call\fR(3), -\fBsd_bus_message_append\fR(3), -\fBsd_bus_call\fR(3), -\fBsd_bus_set_property\fR(3), -\fBsd_bus_emit_signal\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_new_method_call\fR(3), \fBsd_bus_message_append\fR(3), \fBsd_bus_call\fR(3), \fBsd_bus_set_property\fR(3), \fBsd_bus_emit_signal\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_can_send.3 b/upstream/fedora-rawhide/man3/sd_bus_can_send.3 index 08367633..c12b9c5d 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_can_send.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_can_send.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_CAN_SEND" "3" "" "systemd 255" "sd_bus_can_send" +.TH "SD_BUS_CAN_SEND" "3" "" "systemd 256~rc3" "sd_bus_can_send" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -52,8 +52,6 @@ Returned errors may indicate the following problems: The bus object \fIbus\fR could not be resolved\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOTCONN\fR @@ -63,8 +61,6 @@ The input parameter is \fBNULL\fR or the bus is not connected\&. -.sp -Added in version 246\&. .RE .PP \fB\-ECHILD\fR @@ -72,8 +68,6 @@ Added in version 246\&. The bus object \fIbus\fR was created in a different process\&. -.sp -Added in version 246\&. .RE .SH "NOTES" .PP @@ -90,8 +84,7 @@ from an early phase of the program when no other threads have been started\&. .SH "HISTORY" .PP \fBsd_bus_can_send()\fR -was added in version 246\&. +was added in version 221\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_close.3 b/upstream/fedora-rawhide/man3/sd_bus_close.3 index 04ff003c..2eb7daa8 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_close.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_close.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_CLOSE" "3" "" "systemd 255" "sd_bus_close" +.TH "SD_BUS_CLOSE" "3" "" "systemd 256~rc3" "sd_bus_close" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -92,13 +92,10 @@ from an early phase of the program when no other threads have been started\&. \fBsd_bus_close()\fR and \fBsd_bus_flush()\fR -were added in version 240\&. +were added in version 221\&. .PP \fBsd_bus_default_flush_close()\fR -was added in version 246\&. +was added in version 227\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_unref\fR(3), -\fBsd_bus_set_close_on_exit\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_unref\fR(3), \fBsd_bus_set_close_on_exit\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_creds_get_pid.3 b/upstream/fedora-rawhide/man3/sd_bus_creds_get_pid.3 index 6974f99f..eb82db0f 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_creds_get_pid.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_creds_get_pid.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_CREDS_GET_PID" "3" "" "systemd 255" "sd_bus_creds_get_pid" +.TH "SD_BUS_CREDS_GET_PID" "3" "" "systemd 256~rc3" "sd_bus_creds_get_pid" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,7 +20,7 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -sd_bus_creds_get_pid, sd_bus_creds_get_ppid, sd_bus_creds_get_tid, sd_bus_creds_get_uid, sd_bus_creds_get_euid, sd_bus_creds_get_suid, sd_bus_creds_get_fsuid, sd_bus_creds_get_gid, sd_bus_creds_get_egid, sd_bus_creds_get_sgid, sd_bus_creds_get_fsgid, sd_bus_creds_get_supplementary_gids, sd_bus_creds_get_comm, sd_bus_creds_get_tid_comm, sd_bus_creds_get_exe, sd_bus_creds_get_cmdline, sd_bus_creds_get_cgroup, sd_bus_creds_get_unit, sd_bus_creds_get_slice, sd_bus_creds_get_user_unit, sd_bus_creds_get_user_slice, sd_bus_creds_get_session, sd_bus_creds_get_owner_uid, sd_bus_creds_has_effective_cap, sd_bus_creds_has_permitted_cap, sd_bus_creds_has_inheritable_cap, sd_bus_creds_has_bounding_cap, sd_bus_creds_get_selinux_context, sd_bus_creds_get_audit_session_id, sd_bus_creds_get_audit_login_uid, sd_bus_creds_get_tty, sd_bus_creds_get_unique_name, sd_bus_creds_get_well_known_names, sd_bus_creds_get_description \- Retrieve fields from a credentials object +sd_bus_creds_get_pid, sd_bus_creds_get_pidfd_dup, sd_bus_creds_get_ppid, sd_bus_creds_get_tid, sd_bus_creds_get_uid, sd_bus_creds_get_euid, sd_bus_creds_get_suid, sd_bus_creds_get_fsuid, sd_bus_creds_get_gid, sd_bus_creds_get_egid, sd_bus_creds_get_sgid, sd_bus_creds_get_fsgid, sd_bus_creds_get_supplementary_gids, sd_bus_creds_get_comm, sd_bus_creds_get_tid_comm, sd_bus_creds_get_exe, sd_bus_creds_get_cmdline, sd_bus_creds_get_cgroup, sd_bus_creds_get_unit, sd_bus_creds_get_slice, sd_bus_creds_get_user_unit, sd_bus_creds_get_user_slice, sd_bus_creds_get_session, sd_bus_creds_get_owner_uid, sd_bus_creds_has_effective_cap, sd_bus_creds_has_permitted_cap, sd_bus_creds_has_inheritable_cap, sd_bus_creds_has_bounding_cap, sd_bus_creds_get_selinux_context, sd_bus_creds_get_audit_session_id, sd_bus_creds_get_audit_login_uid, sd_bus_creds_get_tty, sd_bus_creds_get_unique_name, sd_bus_creds_get_well_known_names, sd_bus_creds_get_description \- Retrieve fields from a credentials object .SH "SYNOPSIS" .sp .ft B @@ -30,6 +30,8 @@ sd_bus_creds_get_pid, sd_bus_creds_get_ppid, sd_bus_creds_get_tid, sd_bus_creds_ .ft .HP \w'int\ sd_bus_creds_get_pid('u .BI "int sd_bus_creds_get_pid(sd_bus_creds\ *" "c" ", pid_t\ *" "pid" ");" +.HP \w'int\ sd_bus_creds_get_pidfd_dup('u +.BI "int sd_bus_creds_get_pidfd_dup(sd_bus_creds\ *" "c" ", int\ *" "ret_fd" ");" .HP \w'int\ sd_bus_creds_get_ppid('u .BI "int sd_bus_creds_get_ppid(sd_bus_creds\ *" "c" ", pid_t\ *" "ppid" ");" .HP \w'int\ sd_bus_creds_get_tid('u @@ -117,6 +119,11 @@ will retrieve the PID (process identifier)\&. Similarly, \fBsd_bus_creds_get_ppid()\fR will retrieve the parent PID\&. Note that PID 1 has no parent process, in which case \-ENXIO is returned\&. .PP +\fBsd_bus_creds_get_pidfd_dup()\fR +will retrieve the PID file descriptor (pidfd), see +\fBpidfd_open\fR(2) +for details\&. The file descriptor is duplicated and thus must be closed by the caller\&. +.PP \fBsd_bus_creds_get_tid()\fR will retrieve the TID (thread identifier)\&. .PP @@ -329,10 +336,8 @@ from an early phase of the program when no other threads have been started\&. \fBsd_bus_creds_get_selinux_context()\fR, \fBsd_bus_creds_get_audit_session_id()\fR, \fBsd_bus_creds_get_audit_login_uid()\fR, -\fBsd_bus_creds_get_unique_name()\fR, and -\fBsd_bus_creds_get_well_known_names()\fR -were added in version 209\&. -.PP +\fBsd_bus_creds_get_unique_name()\fR, +\fBsd_bus_creds_get_well_known_names()\fR, \fBsd_bus_creds_get_ppid()\fR, \fBsd_bus_creds_get_uid()\fR, \fBsd_bus_creds_get_euid()\fR, @@ -342,23 +347,16 @@ were added in version 209\&. \fBsd_bus_creds_get_sgid()\fR, \fBsd_bus_creds_get_fsgid()\fR, \fBsd_bus_creds_get_supplementary_gids()\fR, -\fBsd_bus_creds_get_tty()\fR, and -\fBsd_bus_creds_get_description()\fR -were added in version 220\&. -.PP +\fBsd_bus_creds_get_tty()\fR, +\fBsd_bus_creds_get_description()\fR, and \fBsd_bus_creds_get_user_slice()\fR -was added in version 223\&. +were added in version 221\&. +.PP +\fBsd_bus_creds_get_pidfd_dup()\fR +was added in version 256\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_creds_new_from_pid\fR(2), -\fBfork\fR(2), -\fBexecve\fR(2), -\fBcredentials\fR(7), -\fBfree\fR(3), -\fBproc\fR(5), -\fBsystemd.journal-fields\fR(7) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_creds_new_from_pid\fR(2), \fBfork\fR(2), \fBexecve\fR(2), \fBcredentials\fR(7), \fBfree\fR(3), \fBproc\fR(5), \fBsystemd.journal-fields\fR(7) .SH "NOTES" .IP " 1." 4 Control Groups v2 diff --git a/upstream/fedora-rawhide/man3/sd_bus_creds_new_from_pid.3 b/upstream/fedora-rawhide/man3/sd_bus_creds_new_from_pid.3 index 64aefe35..4ee55298 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_creds_new_from_pid.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_creds_new_from_pid.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_CREDS_NEW_FROM_PID" "3" "" "systemd 255" "sd_bus_creds_new_from_pid" +.TH "SD_BUS_CREDS_NEW_FROM_PID" "3" "" "systemd 256~rc3" "sd_bus_creds_new_from_pid" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,7 +20,7 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -sd_bus_creds_new_from_pid, sd_bus_creds_get_mask, sd_bus_creds_get_augmented_mask, sd_bus_creds_ref, sd_bus_creds_unref, sd_bus_creds_unrefp \- Retrieve credentials object for the specified PID +sd_bus_creds_new_from_pid, sd_bus_creds_new_from_pidfd, sd_bus_creds_get_mask, sd_bus_creds_get_augmented_mask, sd_bus_creds_ref, sd_bus_creds_unref, sd_bus_creds_unrefp \- Retrieve credentials object for the specified PID .SH "SYNOPSIS" .sp .ft B @@ -30,6 +30,8 @@ sd_bus_creds_new_from_pid, sd_bus_creds_get_mask, sd_bus_creds_get_augmented_mas .ft .HP \w'int\ sd_bus_creds_new_from_pid('u .BI "int sd_bus_creds_new_from_pid(pid_t\ " "pid" ", uint64_t\ " "creds_mask" ", sd_bus_creds\ **" "ret" ");" +.HP \w'int\ sd_bus_creds_new_from_pidfd('u +.BI "int sd_bus_creds_new_from_pidfd(int\ " "pidfd" ", uint64_t\ " "creds_mask" ", sd_bus_creds\ **" "ret" ");" .HP \w'uint64_t\ sd_bus_creds_get_mask('u .BI "uint64_t sd_bus_creds_get_mask(sd_bus_creds\ *" "c" ");" .HP \w'uint64_t\ sd_bus_creds_get_augmented_mask('u @@ -75,6 +77,7 @@ sd_bus_creds_new_from_pid, sd_bus_creds_get_mask, sd_bus_creds_get_augmented_mas \fBSD_BUS_CREDS_UNIQUE_NAME\fR, \fBSD_BUS_CREDS_WELL_KNOWN_NAMES\fR, \fBSD_BUS_CREDS_DESCRIPTION\fR, +\fBSD_BUS_CREDS_PIDFD\fR, \fBSD_BUS_CREDS_AUGMENT\fR, \fB_SD_BUS_CREDS_ALL\fR .SH "DESCRIPTION" @@ -89,6 +92,11 @@ pointer\&. Note that credential objects may also be created and retrieved via and \fBsd_bus_message_get_creds\fR(3)\&. .PP +\fBsd_bus_creds_new_from_pidfd()\fR +is identical to +\fBsd_bus_creds_new_from_pid()\fR, but takes a PID file descriptor rather than a numeric PID as reference to the process\&. See +\fBpidfd_open\fR(2)\&. +.PP The information that will be stored is determined by \fIcreds_mask\fR\&. It may contain a subset of ORed constants \fBSD_BUS_CREDS_PID\fR, @@ -123,13 +131,16 @@ The information that will be stored is determined by \fBSD_BUS_CREDS_AUDIT_LOGIN_UID\fR, \fBSD_BUS_CREDS_TTY\fR, \fBSD_BUS_CREDS_UNIQUE_NAME\fR, -\fBSD_BUS_CREDS_WELL_KNOWN_NAMES\fR, and -\fBSD_BUS_CREDS_DESCRIPTION\fR\&. Use the special value +\fBSD_BUS_CREDS_WELL_KNOWN_NAMES\fR, +\fBSD_BUS_CREDS_DESCRIPTION\fR, and +\fBSD_BUS_CREDS_PIDFD\fR\&. Use the special value \fB_SD_BUS_CREDS_ALL\fR to request all supported fields\&. The \fBSD_BUS_CREDS_AUGMENT\fR constant may not be ORed into the mask for invocations of -\fBsd_bus_creds_new_from_pid()\fR\&. +\fBsd_bus_creds_new_from_pid()\fR +or +\fBsd_bus_creds_new_from_pidfd()\fR\&. .PP Fields can be retrieved from the credentials object using \fBsd_bus_creds_get_pid\fR(3) @@ -137,14 +148,18 @@ and other functions which correspond directly to the constants listed above\&. .PP A mask of fields which were actually successfully retrieved can be retrieved with \fBsd_bus_creds_get_mask()\fR\&. If the credentials object was created with -\fBsd_bus_creds_new_from_pid()\fR, this will be a subset of fields requested in +\fBsd_bus_creds_new_from_pid()\fR +or +\fBsd_bus_creds_new_from_pidfd()\fR, this will be a subset of fields requested in \fIcreds_mask\fR\&. .PP Similar to \fBsd_bus_creds_get_mask()\fR, the function \fBsd_bus_creds_get_augmented_mask()\fR returns a bitmask of field constants\&. The mask indicates which credential fields have been retrieved in a non\-atomic fashion\&. For credential objects created via -\fBsd_bus_creds_new_from_pid()\fR, this mask will be identical to the mask returned by +\fBsd_bus_creds_new_from_pid()\fR +or +\fBsd_bus_creds_new_from_pidfd()\fR, this mask will be identical to the mask returned by \fBsd_bus_creds_get_mask()\fR\&. However, for credential objects retrieved via \fBsd_bus_get_name_creds()\fR, this mask will be set for the credential fields that could not be determined atomically at peer connection time, and which were later added by reading augmenting credential data from /proc/\&. Similarly, for credential objects retrieved via @@ -189,7 +204,9 @@ execute no operation if the passed in bus credentials object is .PP On success, \fBsd_bus_creds_new_from_pid()\fR -returns 0 or a positive integer\&. On failure, it returns a negative errno\-style error code\&. +and +\fBsd_bus_creds_new_from_pidfd()\fR +return 0 or a positive integer\&. On failure, they return a negative errno\-style error code\&. .PP \fBsd_bus_creds_get_mask()\fR returns the mask of successfully acquired fields\&. @@ -206,9 +223,11 @@ always returns \fBNULL\fR\&. .SH "REFERENCE OWNERSHIP" .PP -Function +The functions \fBsd_bus_creds_new_from_pid()\fR -creates a new object and the caller owns the sole reference\&. When not needed anymore, this reference should be destroyed with +and +\fBsd_bus_creds_new_from_pidfd()\fR +create a new object and the caller owns the sole reference\&. When not needed anymore, this reference should be destroyed with \fBsd_bus_creds_unref\fR(3)\&. .SS "Errors" .PP @@ -252,23 +271,19 @@ from an early phase of the program when no other threads have been started\&. .PP \fBsd_bus_creds_new_from_pid()\fR, \fBsd_bus_creds_get_mask()\fR, -\fBsd_bus_creds_ref()\fR, and -\fBsd_bus_creds_unref()\fR -were added in version 209\&. -.PP +\fBsd_bus_creds_ref()\fR, +\fBsd_bus_creds_unref()\fR, and \fBsd_bus_creds_get_augmented_mask()\fR -was added in version 223\&. +were added in version 221\&. .PP \fBsd_bus_creds_unrefp()\fR was added in version 229\&. +.PP +\fBsd_bus_creds_new_from_pidfd()\fR +was added in version 256\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_creds_get_pid\fR(3), -\fBsd_bus_get_name_creds\fR(3), -\fBsd_bus_get_owner_creds\fR(3), -\fBsd_bus_message_get_creds\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_creds_get_pid\fR(3), \fBsd_bus_get_name_creds\fR(3), \fBsd_bus_get_owner_creds\fR(3), \fBsd_bus_message_get_creds\fR(3) .SH "NOTES" .IP " 1." 4 Clean-up Variable Attribute diff --git a/upstream/fedora-rawhide/man3/sd_bus_default.3 b/upstream/fedora-rawhide/man3/sd_bus_default.3 index 188a6080..f28a7c04 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_default.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_default.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_DEFAULT" "3" "" "systemd 255" "sd_bus_default" +.TH "SD_BUS_DEFAULT" "3" "" "systemd 256~rc3" "sd_bus_default" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -221,8 +221,6 @@ The specified parameters are invalid\&. The requested bus type is not available because of invalid environment (for example the user session bus is not available because \fI$XDG_RUNTIME_DIR\fR is not set)\&. -.sp -Added in version 247\&. .RE .PP \fB\-ENOMEM\fR @@ -259,23 +257,15 @@ from an early phase of the program when no other threads have been started\&. \fBsd_bus_open_system()\fR, \fBsd_bus_open_system_remote()\fR, and \fBsd_bus_open_system_machine()\fR -were added in version 220\&. +were added in version 221\&. .PP \fBsd_bus_open_with_description()\fR, \fBsd_bus_open_user_with_description()\fR, and \fBsd_bus_open_system_with_description()\fR -were added in version 240\&. +were added in version 239\&. .PP \fBsd_bus_open_user_machine()\fR was added in version 248\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_new\fR(3), -\fBsd_bus_ref\fR(3), -\fBsd_bus_unref\fR(3), -\fBsd_bus_close\fR(3), -\fBssh\fR(1), -\fBsystemd-machined.service\fR(8), -\fBmachinectl\fR(1) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_new\fR(3), \fBsd_bus_ref\fR(3), \fBsd_bus_unref\fR(3), \fBsd_bus_close\fR(3), \fBssh\fR(1), \fBsystemd-machined.service\fR(8), \fBmachinectl\fR(1) diff --git a/upstream/fedora-rawhide/man3/sd_bus_emit_signal.3 b/upstream/fedora-rawhide/man3/sd_bus_emit_signal.3 index 9b4aa7c6..dd5ec156 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_emit_signal.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_emit_signal.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_EMIT_SIGNAL" "3" "" "systemd 255" "sd_bus_emit_signal" +.TH "SD_BUS_EMIT_SIGNAL" "3" "" "systemd 256~rc3" "sd_bus_emit_signal" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -146,29 +146,21 @@ One of the required parameters is or invalid\&. A reserved D\-Bus interface was passed as the \fIinterface\fR parameter\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOPKG\fR .RS 4 The bus cannot be resolved\&. -.sp -Added in version 246\&. .RE .PP \fB\-ECHILD\fR .RS 4 The bus was created in a different process, library or module instance\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOMEM\fR .RS 4 Memory allocation failed\&. -.sp -Added in version 246\&. .RE .PP \fB\-ESRCH\fR @@ -180,8 +172,6 @@ One of or \fBsd_bus_emit_object_removed()\fR was called on an object without an object manager registered on its own object path or one of its parent object paths\&. -.sp -Added in version 246\&. .RE .PP See the man pages of @@ -205,16 +195,19 @@ from an early phase of the program when no other threads have been started\&. .SH "HISTORY" .PP \fBsd_bus_emit_signal()\fR, -\fBsd_bus_emit_signalv()\fR, \fBsd_bus_emit_interfaces_added()\fR, \fBsd_bus_emit_interfaces_added_strv()\fR, \fBsd_bus_emit_interfaces_removed()\fR, \fBsd_bus_emit_interfaces_removed_strv()\fR, \fBsd_bus_emit_properties_changed()\fR, -\fBsd_bus_emit_properties_changed_strv()\fR, +\fBsd_bus_emit_properties_changed_strv()\fR, were added in version 221\&. +.PP \fBsd_bus_emit_object_added()\fR, and \fBsd_bus_emit_object_removed()\fR -were added in version 246\&. +were added in version 222\&. +.PP +\fBsd_bus_emit_signalv()\fR +was added in version 246\&. .PP \fBsd_bus_emit_signal_to()\fR and @@ -222,9 +215,4 @@ and were added in version 253\&. .SH "SEE ALSO" .PP -\fBsd-bus\fR(3), -\fBbusctl\fR(1), -\fBsd_bus_message_new_signal\fR(3), -\fBsd_bus_message_append\fR(3), -\fBsd_bus_send\fR(3), -\fBsd_bus_call_method\fR(3) +\fBsd-bus\fR(3), \fBbusctl\fR(1), \fBsd_bus_message_new_signal\fR(3), \fBsd_bus_message_append\fR(3), \fBsd_bus_send\fR(3), \fBsd_bus_call_method\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_enqueue_for_read.3 b/upstream/fedora-rawhide/man3/sd_bus_enqueue_for_read.3 index 793b0579..6ec2c2cd 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_enqueue_for_read.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_enqueue_for_read.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_ENQUEUE_FOR_READ" "3" "" "systemd 255" "sd_bus_enqueue_for_read" +.TH "SD_BUS_ENQUEUE_FOR_READ" "3" "" "systemd 256~rc3" "sd_bus_enqueue_for_read" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -46,8 +46,6 @@ Returned errors may indicate the following problems: \fB\-ECHILD\fR .RS 4 The bus connection has been created in a different process, library or module instance\&. -.sp -Added in version 245\&. .RE .SH "NOTES" .PP @@ -67,6 +65,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 245\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_send\fR(3), +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_send\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_error.3 b/upstream/fedora-rawhide/man3/sd_bus_error.3 index dba26b16..7c95f0c0 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_error.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_error.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_ERROR" "3" "" "systemd 255" "sd_bus_error" +.TH "SD_BUS_ERROR" "3" "" "systemd 256~rc3" "sd_bus_error" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -437,7 +437,7 @@ or unset\&. D\-Bus errors are converted to the integral #include <errno\&.h> #include <string\&.h> #include <unistd\&.h> -#include <sd\-bus\&.h> +#include <systemd/sd\-bus\&.h> int writer_with_negative_errno_return(int fd, sd_bus_error *error) { const char *message = "Hello, World!\en"; @@ -448,7 +448,7 @@ int writer_with_negative_errno_return(int fd, sd_bus_error *error) { /* On error, initialize the error structure, and also propagate the errno * value that write(2) set for us\&. */ - return sd_bus_error_set_errnof(error, errno, "Failed to write to fd %i: %m", fd); + return sd_bus_error_set_errnof(error, errno, "Failed to write to fd %i: %s", fd, strerror(errno)); } .fi .if n \{\ @@ -474,14 +474,12 @@ from an early phase of the program when no other threads have been started\&. \fBsd_bus_error_set_const()\fR, \fBsd_bus_error_set_errno()\fR, \fBsd_bus_error_set_errnof()\fR, +\fBsd_bus_error_set_errnofv()\fR, \fBsd_bus_error_get_errno()\fR, \fBsd_bus_error_copy()\fR, \fBsd_bus_error_is_set()\fR, and \fBsd_bus_error_has_name()\fR -were added in version 209\&. -.PP -\fBsd_bus_error_set_errnofv()\fR -was added in version 223\&. +were added in version 221\&. .PP \fBsd_bus_error_move()\fR was added in version 240\&. @@ -493,12 +491,7 @@ was added in version 247\&. was added in version 252\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd-bus-errors\fR(3), -\fBsd_bus_error_add_map\fR(3), -\fBerrno\fR(3), -\fBstrerror_r\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd-bus-errors\fR(3), \fBsd_bus_error_add_map\fR(3), \fBerrno\fR(3), \fBstrerror_r\fR(3) .SH "NOTES" .IP " 1." 4 Valid D-Bus Names diff --git a/upstream/fedora-rawhide/man3/sd_bus_error_add_map.3 b/upstream/fedora-rawhide/man3/sd_bus_error_add_map.3 index 643d2234..3031078c 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_error_add_map.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_error_add_map.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_ERROR_ADD_MAP" "3" "" "systemd 255" "sd_bus_error_add_map" +.TH "SD_BUS_ERROR_ADD_MAP" "3" "" "systemd 256~rc3" "sd_bus_error_add_map" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -110,12 +110,7 @@ from an early phase of the program when no other threads have been started\&. .SH "HISTORY" .PP \fBsd_bus_error_add_map()\fR -was added in version 223\&. +was added in version 221\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_error\fR(3), -\fBsd-bus-errors\fR(3), -\fBerrno\fR(3), -\fBstrerror_r\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_error\fR(3), \fBsd-bus-errors\fR(3), \fBerrno\fR(3), \fBstrerror_r\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_get_current_handler.3 b/upstream/fedora-rawhide/man3/sd_bus_get_current_handler.3 index e0cf4e95..586fe233 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_get_current_handler.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_get_current_handler.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_GET_CURRENT_HANDLER" "3" "" "systemd 255" "sd_bus_get_current_handler" +.TH "SD_BUS_GET_CURRENT_HANDLER" "3" "" "systemd 256~rc3" "sd_bus_get_current_handler" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -72,8 +72,7 @@ from an early phase of the program when no other threads have been started\&. \fBsd_bus_get_current_message()\fR, \fBsd_bus_get_current_slot()\fR, and \fBsd_bus_get_current_userdata()\fR -were added in version 246\&. +were added in version 221\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_get_fd.3 b/upstream/fedora-rawhide/man3/sd_bus_get_fd.3 index 5a7e9d0d..aed625fc 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_get_fd.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_get_fd.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_GET_FD" "3" "" "systemd 255" "sd_bus_get_fd" +.TH "SD_BUS_GET_FD" "3" "" "systemd 256~rc3" "sd_bus_get_fd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -128,8 +128,6 @@ cannot return\&. \fB\-ENOPKG\fR .RS 4 The bus cannot be resolved\&. -.sp -Added in version 246\&. .RE .SH "NOTES" .PP @@ -145,19 +143,10 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "HISTORY" .PP -\fBsd_bus_get_fd()\fR -was added in version 231\&. -.PP -\fBsd_bus_get_events()\fR -and +\fBsd_bus_get_fd()\fR, +\fBsd_bus_get_events()\fR, and \fBsd_bus_get_timeout()\fR -were added in version 240\&. +were added in version 221\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_process\fR(3), -\fBsd_bus_attach_event\fR(3), -\fBsd_bus_wait\fR(3), -\fBsd_bus_set_fd\fR(3), -\fBpoll\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_process\fR(3), \fBsd_bus_attach_event\fR(3), \fBsd_bus_wait\fR(3), \fBsd_bus_set_fd\fR(3), \fBpoll\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_get_n_queued_read.3 b/upstream/fedora-rawhide/man3/sd_bus_get_n_queued_read.3 index b03f7778..7279dedb 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_get_n_queued_read.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_get_n_queued_read.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_GET_N_QUEUED_READ" "3" "" "systemd 255" "sd_bus_get_fd" +.TH "SD_BUS_GET_N_QUEUED_READ" "3" "" "systemd 256~rc3" "sd_bus_get_fd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -68,8 +68,4 @@ and were added in version 238\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_process\fR(3), -\fBsd_bus_send\fR(3), -\fBsd_bus_flush\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_process\fR(3), \fBsd_bus_send\fR(3), \fBsd_bus_flush\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_get_name_creds.3 b/upstream/fedora-rawhide/man3/sd_bus_get_name_creds.3 index 86ff160e..19245262 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_get_name_creds.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_get_name_creds.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_GET_NAME_CREDS" "3" "" "systemd 255" "sd_bus_get_name_creds" +.TH "SD_BUS_GET_NAME_CREDS" "3" "" "systemd 256~rc3" "sd_bus_get_name_creds" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -66,36 +66,26 @@ Returned errors may indicate the following problems: \fB\-EINVAL\fR .RS 4 An argument is invalid\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOPKG\fR .RS 4 The bus cannot be resolved\&. -.sp -Added in version 246\&. .RE .PP \fB\-EPERM\fR .RS 4 The bus has already been started\&. -.sp -Added in version 246\&. .RE .PP \fB\-ECHILD\fR .RS 4 The bus was created in a different process, library or module instance\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOMEM\fR .RS 4 Memory allocation failed\&. -.sp -Added in version 246\&. .RE .SH "NOTES" .PP @@ -114,9 +104,7 @@ from an early phase of the program when no other threads have been started\&. \fBsd_bus_get_name_creds()\fR and \fBsd_bus_get_owner_creds()\fR -were added in version 246\&. +were added in version 221\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_creds_unref\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_creds_unref\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_get_name_machine_id.3 b/upstream/fedora-rawhide/man3/sd_bus_get_name_machine_id.3 index 5acd64c3..6ad23af3 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_get_name_machine_id.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_get_name_machine_id.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_GET_NAME_MACHINE_ID" "3" "" "systemd 255" "sd_bus_get_name_machine_id" +.TH "SD_BUS_GET_NAME_MACHINE_ID" "3" "" "systemd 256~rc3" "sd_bus_get_name_machine_id" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -52,29 +52,21 @@ Returned errors may indicate the following problems: \fB\-EINVAL\fR .RS 4 An argument is invalid\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOPKG\fR .RS 4 The bus cannot be resolved\&. -.sp -Added in version 246\&. .RE .PP \fB\-ECHILD\fR .RS 4 The bus was created in a different process, library or module instance\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOMEM\fR .RS 4 Memory allocation failed\&. -.sp -Added in version 246\&. .RE .SH "NOTES" .PP @@ -91,8 +83,7 @@ from an early phase of the program when no other threads have been started\&. .SH "HISTORY" .PP \fBsd_bus_get_name_machine_id()\fR -was added in version 246\&. +was added in version 221\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_interface_name_is_valid.3 b/upstream/fedora-rawhide/man3/sd_bus_interface_name_is_valid.3 index f4b88a98..2bacb8b9 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_interface_name_is_valid.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_interface_name_is_valid.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_INTERFACE_NAME_IS_VALID" "3" "" "systemd 255" "sd_bus_interface_name_is_valid" +.TH "SD_BUS_INTERFACE_NAME_IS_VALID" "3" "" "systemd 256~rc3" "sd_bus_interface_name_is_valid" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -62,8 +62,6 @@ The \fIp\fR parameter is \fBNULL\fR\&. -.sp -Added in version 246\&. .RE .SH "NOTES" .PP @@ -86,6 +84,4 @@ from an early phase of the program when no other threads have been started\&. were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_call_method\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_call_method\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_is_open.3 b/upstream/fedora-rawhide/man3/sd_bus_is_open.3 index 97f2500d..09bd2d34 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_is_open.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_is_open.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_IS_OPEN" "3" "" "systemd 255" "sd_bus_is_open" +.TH "SD_BUS_IS_OPEN" "3" "" "systemd 256~rc3" "sd_bus_is_open" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -89,13 +89,10 @@ from an early phase of the program when no other threads have been started\&. .SH "HISTORY" .PP \fBsd_bus_is_open()\fR -and +was added in version 221\&. +.PP \fBsd_bus_is_ready()\fR -were added in version 237\&. +was added in version 237\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_start\fR(3), -\fBsd_bus_close\fR(3), -\fBsd_bus_set_connected_signal\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_start\fR(3), \fBsd_bus_close\fR(3), \fBsd_bus_set_connected_signal\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_list_names.3 b/upstream/fedora-rawhide/man3/sd_bus_list_names.3 index c2f13689..6428d004 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_list_names.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_list_names.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_LIST_NAMES" "3" "" "systemd 255" "sd_bus_list_names" +.TH "SD_BUS_LIST_NAMES" "3" "" "systemd 256~rc3" "sd_bus_list_names" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -68,36 +68,26 @@ and \fIactivatable\fR were \fBNULL\fR\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOPKG\fR .RS 4 The bus cannot be resolved\&. -.sp -Added in version 246\&. .RE .PP \fB\-ECHILD\fR .RS 4 The bus was created in a different process, library or module instance\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOMEM\fR .RS 4 Memory allocation failed\&. -.sp -Added in version 246\&. .RE .PP \fB\-ENOTCONN\fR .RS 4 The bus is not connected\&. -.sp -Added in version 246\&. .RE .SH "NOTES" .PP @@ -114,11 +104,10 @@ from an early phase of the program when no other threads have been started\&. .SH "HISTORY" .PP \fBsd_bus_list_names()\fR -was added in version 246\&. +was added in version 221\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3) .SH "NOTES" .IP " 1." 4 org.freedesktop.DBus.ListNames diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_append.3 b/upstream/fedora-rawhide/man3/sd_bus_message_append.3 index 3b42c1ba..4c30f856 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_append.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_append.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_APPEND" "3" "" "systemd 255" "sd_bus_message_append" +.TH "SD_BUS_MESSAGE_APPEND" "3" "" "systemd 256~rc3" "sd_bus_message_append" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -484,11 +484,7 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_append_basic\fR(3), -\fBsd_bus_message_append_array\fR(3), -\fBsd_bus_message_open_container\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_append_basic\fR(3), \fBsd_bus_message_append_array\fR(3), \fBsd_bus_message_open_container\fR(3) .SH "NOTES" .IP " 1." 4 D-Bus Specification diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_append_array.3 b/upstream/fedora-rawhide/man3/sd_bus_message_append_array.3 index ad428ccb..6c65e801 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_append_array.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_append_array.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_APPEND_ARRAY" "3" "" "systemd 255" "sd_bus_message_append_array" +.TH "SD_BUS_MESSAGE_APPEND_ARRAY" "3" "" "systemd 256~rc3" "sd_bus_message_append_array" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -161,12 +161,7 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_append\fR(3), -\fBsd_bus_message_append_basic\fR(3), -\fBmemfd_create\fR(2), -\m[blue]\fBThe D\-Bus specification\fR\m[]\&\s-2\u[2]\d\s+2 +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_append\fR(3), \fBsd_bus_message_append_basic\fR(3), \fBmemfd_create\fR(2), \m[blue]\fBThe D\-Bus specification\fR\m[]\&\s-2\u[2]\d\s+2 .SH "NOTES" .IP " 1." 4 Basic D-Bus Types diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_append_basic.3 b/upstream/fedora-rawhide/man3/sd_bus_message_append_basic.3 index bd357ba8..0743c5f7 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_append_basic.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_append_basic.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_APPEND_BASIC" "3" "" "systemd 255" "sd_bus_message_append_basic" +.TH "SD_BUS_MESSAGE_APPEND_BASIC" "3" "" "systemd 256~rc3" "sd_bus_message_append_basic" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -283,11 +283,7 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_read_basic\fR(3), -\fBsd_bus_message_append\fR(3), -\m[blue]\fBThe D\-Bus specification\fR\m[]\&\s-2\u[2]\d\s+2 +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_read_basic\fR(3), \fBsd_bus_message_append\fR(3), \m[blue]\fBThe D\-Bus specification\fR\m[]\&\s-2\u[2]\d\s+2 .SH "NOTES" .IP " 1." 4 Basic Types diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_append_string_memfd.3 b/upstream/fedora-rawhide/man3/sd_bus_message_append_string_memfd.3 index 69357616..0b641537 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_append_string_memfd.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_append_string_memfd.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_APPEND_STRING_MEMFD" "3" "" "systemd 255" "sd_bus_message_append_string_memfd" +.TH "SD_BUS_MESSAGE_APPEND_STRING_MEMFD" "3" "" "systemd 256~rc3" "sd_bus_message_append_string_memfd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -130,10 +130,7 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_append_basic\fR(3), -\m[blue]\fBThe D\-Bus specification\fR\m[]\&\s-2\u[1]\d\s+2 +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_append_basic\fR(3), \m[blue]\fBThe D\-Bus specification\fR\m[]\&\s-2\u[1]\d\s+2 .SH "NOTES" .IP " 1." 4 The D-Bus specification diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_append_strv.3 b/upstream/fedora-rawhide/man3/sd_bus_message_append_strv.3 index e7253a04..316bafba 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_append_strv.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_append_strv.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_APPEND_STRV" "3" "" "systemd 255" "sd_bus_message_append_strv" +.TH "SD_BUS_MESSAGE_APPEND_STRV" "3" "" "systemd 256~rc3" "sd_bus_message_append_strv" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -95,11 +95,7 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_append\fR(3), -\fBsd_bus_message_append_array\fR(3), -\m[blue]\fBThe D\-Bus specification\fR\m[]\&\s-2\u[1]\d\s+2 +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_append\fR(3), \fBsd_bus_message_append_array\fR(3), \m[blue]\fBThe D\-Bus specification\fR\m[]\&\s-2\u[1]\d\s+2 .SH "NOTES" .IP " 1." 4 The D-Bus specification diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_at_end.3 b/upstream/fedora-rawhide/man3/sd_bus_message_at_end.3 index ddacef5a..929872ff 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_at_end.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_at_end.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_AT_END" "3" "" "systemd 255" "sd_bus_message_at_end" +.TH "SD_BUS_MESSAGE_AT_END" "3" "" "systemd 256~rc3" "sd_bus_message_at_end" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -88,6 +88,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_read\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_read\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_copy.3 b/upstream/fedora-rawhide/man3/sd_bus_message_copy.3 index d4bdc194..a17da8e7 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_copy.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_copy.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_COPY" "3" "" "systemd 255" "sd_bus_message_copy" +.TH "SD_BUS_MESSAGE_COPY" "3" "" "systemd 256~rc3" "sd_bus_message_copy" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -97,6 +97,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_append\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_append\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_dump.3 b/upstream/fedora-rawhide/man3/sd_bus_message_dump.3 index 6acfc736..83a74b29 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_dump.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_dump.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_DUMP" "3" "" "systemd 255" "sd_bus_message_dump" +.TH "SD_BUS_MESSAGE_DUMP" "3" "" "systemd 256~rc3" "sd_bus_message_dump" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -105,5 +105,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_get_cookie.3 b/upstream/fedora-rawhide/man3/sd_bus_message_get_cookie.3 index 661c869e..1ad81ade 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_get_cookie.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_get_cookie.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_GET_COOKIE" "3" "" "systemd 255" "sd_bus_message_get_cookie" +.TH "SD_BUS_MESSAGE_GET_COOKIE" "3" "" "systemd 256~rc3" "sd_bus_message_get_cookie" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -79,6 +79,4 @@ and were added in version 209\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_new\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_new\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_get_monotonic_usec.3 b/upstream/fedora-rawhide/man3/sd_bus_message_get_monotonic_usec.3 index 6f101bd3..99eb7609 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_get_monotonic_usec.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_get_monotonic_usec.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_GET_MONOTONIC_USEC" "3" "" "systemd 255" "sd_bus_message_get_monotonic_usec" +.TH "SD_BUS_MESSAGE_GET_MONOTONIC_USEC" "3" "" "systemd 256~rc3" "sd_bus_message_get_monotonic_usec" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -99,9 +99,4 @@ from an early phase of the program when no other threads have been started\&. were added in version 209\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_new\fR(3), -\fBsd_bus_negotiate_timestamp\fR(3), -\fBclock_gettime\fR(2), -\fBsd_id128_get_boot\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_new\fR(3), \fBsd_bus_negotiate_timestamp\fR(3), \fBclock_gettime\fR(2), \fBsd_id128_get_boot\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_get_signature.3 b/upstream/fedora-rawhide/man3/sd_bus_message_get_signature.3 index 590fed11..eaf3ba2c 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_get_signature.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_get_signature.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_GET_SIGNATURE" "3" "" "systemd 255" "sd_bus_message_get_signature" +.TH "SD_BUS_MESSAGE_GET_SIGNATURE" "3" "" "systemd 256~rc3" "sd_bus_message_get_signature" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -102,6 +102,4 @@ from an early phase of the program when no other threads have been started\&. were added in version 240\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_new\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_new\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_get_type.3 b/upstream/fedora-rawhide/man3/sd_bus_message_get_type.3 index 622f5376..f2fe0471 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_get_type.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_get_type.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_GET_TYPE" "3" "" "systemd 255" "sd_bus_message_get_type" +.TH "SD_BUS_MESSAGE_GET_TYPE" "3" "" "systemd 256~rc3" "sd_bus_message_get_type" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -146,9 +146,4 @@ were added in version 240\&. were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_new\fR(3), -\fBsd_bus_message_set_destination\fR(3), -\fBsd-bus-errors\fR(3), -\fBsd_bus_error_add_map\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_new\fR(3), \fBsd_bus_message_set_destination\fR(3), \fBsd-bus-errors\fR(3), \fBsd_bus_error_add_map\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_new.3 b/upstream/fedora-rawhide/man3/sd_bus_message_new.3 index dc726da5..378dbb2d 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_new.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_new.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_NEW" "3" "" "systemd 255" "sd_bus_message_new" +.TH "SD_BUS_MESSAGE_NEW" "3" "" "systemd 256~rc3" "sd_bus_message_new" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -181,13 +181,7 @@ from an early phase of the program when no other threads have been started\&. were added in version 240\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_new\fR(3), -\fBsd_bus_message_new_method_call\fR(3), -\fBsd_bus_message_new_method_error\fR(3), -\fBsd_bus_message_new_method_return\fR(3), -\fBsd_bus_message_new_signal\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_new\fR(3), \fBsd_bus_message_new_method_call\fR(3), \fBsd_bus_message_new_method_error\fR(3), \fBsd_bus_message_new_method_return\fR(3), \fBsd_bus_message_new_signal\fR(3) .SH "NOTES" .IP " 1." 4 Clean-up Variable Attribute diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_new_method_call.3 b/upstream/fedora-rawhide/man3/sd_bus_message_new_method_call.3 index e45a6f88..985179d6 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_new_method_call.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_new_method_call.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_NEW_METHOD_CALL" "3" "" "systemd 255" "sd_bus_message_new_method_call" +.TH "SD_BUS_MESSAGE_NEW_METHOD_CALL" "3" "" "systemd 256~rc3" "sd_bus_message_new_method_call" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -178,8 +178,7 @@ from an early phase of the program when no other threads have been started\&. #define MEMBER "GetUnitByPID" static int log_error(int error, const char *message) { - errno = \-error; - fprintf(stderr, "%s: %m\en", message); + fprintf(stderr, "%s: %s\en", message, strerror(\-error)); return error; } @@ -229,11 +228,7 @@ and were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_call\fR(3), -\fBsd_bus_call_method\fR(3), -\fBsd_bus_path_encode\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_call\fR(3), \fBsd_bus_call_method\fR(3), \fBsd_bus_path_encode\fR(3) .SH "NOTES" .IP " 1." 4 D-Bus Tutorial diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_new_method_error.3 b/upstream/fedora-rawhide/man3/sd_bus_message_new_method_error.3 index 8df78b12..d9a19cab 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_new_method_error.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_new_method_error.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_NEW_METHOD_ERROR" "3" "" "systemd 255" "sd_bus_message_new_method_error" +.TH "SD_BUS_MESSAGE_NEW_METHOD_ERROR" "3" "" "systemd 256~rc3" "sd_bus_message_new_method_error" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -174,5 +174,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_new_signal.3 b/upstream/fedora-rawhide/man3/sd_bus_message_new_signal.3 index d90bd9d7..51d48bc2 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_new_signal.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_new_signal.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_NEW_SIGNAL" "3" "" "systemd 255" "sd_bus_message_new_signal" +.TH "SD_BUS_MESSAGE_NEW_SIGNAL" "3" "" "systemd 256~rc3" "sd_bus_message_new_signal" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -138,7 +138,4 @@ This function in systemd sources is used to emit the signal when the unit files have been changed\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_emit_signal\fR(3) -\fBsd_bus_message_set_destination\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_emit_signal\fR(3), \fBsd_bus_message_set_destination\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_open_container.3 b/upstream/fedora-rawhide/man3/sd_bus_message_open_container.3 index f73954cc..9dc59cdf 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_open_container.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_open_container.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_OPEN_CONTAINER" "3" "" "systemd 255" "sd_bus_message_open_container" +.TH "SD_BUS_MESSAGE_OPEN_CONTAINER" "3" "" "systemd 256~rc3" "sd_bus_message_open_container" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -204,13 +204,14 @@ from an early phase of the program when no other threads have been started\&. #include <systemd/sd\-bus\&.h> int append_strings_to_message(sd_bus_message *m, const char *const *arr) { + const char *s; int r; r = sd_bus_message_open_container(m, \*(Aqa\*(Aq, "s"); if (r < 0) return r; - for (const char *s = *arr; *s; s++) { + for (s = *arr; *s; s++) { r = sd_bus_message_append(m, "s", s); if (r < 0) return r; @@ -262,12 +263,7 @@ int read_strings_from_message(sd_bus_message *m) { .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_append\fR(3), -\fBsd_bus_message_read\fR(3), -\fBsd_bus_message_skip\fR(3), -\m[blue]\fBThe D\-Bus specification\fR\m[]\&\s-2\u[1]\d\s+2 +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_append\fR(3), \fBsd_bus_message_read\fR(3), \fBsd_bus_message_skip\fR(3), \m[blue]\fBThe D\-Bus specification\fR\m[]\&\s-2\u[1]\d\s+2 .SH "NOTES" .IP " 1." 4 The D-Bus specification diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_read.3 b/upstream/fedora-rawhide/man3/sd_bus_message_read.3 index 1d0e4b00..ae5cc1f2 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_read.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_read.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_READ" "3" "" "systemd 255" "sd_bus_message_read" +.TH "SD_BUS_MESSAGE_READ" "3" "" "systemd 256~rc3" "sd_bus_message_read" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -503,9 +503,4 @@ were added in version 240\&. was added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_read_basic\fR(3), -\fBsd_bus_message_skip\fR(3), -\fBsd_bus_message_append\fR(3), -\fBsd_bus_message_enter_container\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_read_basic\fR(3), \fBsd_bus_message_skip\fR(3), \fBsd_bus_message_append\fR(3), \fBsd_bus_message_enter_container\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_read_array.3 b/upstream/fedora-rawhide/man3/sd_bus_message_read_array.3 index 8916c61a..f8621a27 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_read_array.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_read_array.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_READ_ARRAY" "3" "" "systemd 255" "sd_bus_message_read_array" +.TH "SD_BUS_MESSAGE_READ_ARRAY" "3" "" "systemd 256~rc3" "sd_bus_message_read_array" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -84,7 +84,4 @@ The message cannot be parsed\&. was added in version 240\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_read\fR(3), -\fBsd_bus_message_read_strv\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_read\fR(3), \fBsd_bus_message_read_strv\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_read_basic.3 b/upstream/fedora-rawhide/man3/sd_bus_message_read_basic.3 index e896b6f7..536c7d74 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_read_basic.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_read_basic.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_READ_BASIC" "3" "" "systemd 255" "sd_bus_message_read_basic" +.TH "SD_BUS_MESSAGE_READ_BASIC" "3" "" "systemd 256~rc3" "sd_bus_message_read_basic" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -241,14 +241,10 @@ The message cannot be parsed\&. .SH "HISTORY" .PP \fBsd_bus_message_read_basic()\fR -was added in version 231\&. +was added in version 221\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_append_basic\fR(3), -\fBsd_bus_message_skip\fR(3), -\fBsd_bus_message_read\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_append_basic\fR(3), \fBsd_bus_message_skip\fR(3), \fBsd_bus_message_read\fR(3) .SH "NOTES" .IP " 1." 4 D-Bus Specification diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_read_strv.3 b/upstream/fedora-rawhide/man3/sd_bus_message_read_strv.3 index c4423644..36752996 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_read_strv.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_read_strv.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_READ_STRV" "3" "" "systemd 255" "sd_bus_message_read_strv" +.TH "SD_BUS_MESSAGE_READ_STRV" "3" "" "systemd 256~rc3" "sd_bus_message_read_strv" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -98,6 +98,4 @@ was added in version 246\&. was added in version 252\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_read\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_read\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_rewind.3 b/upstream/fedora-rawhide/man3/sd_bus_message_rewind.3 index 33beb067..e168138d 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_rewind.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_rewind.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_REWIND" "3" "" "systemd 255" "sd_bus_message_rewind" +.TH "SD_BUS_MESSAGE_REWIND" "3" "" "systemd 256~rc3" "sd_bus_message_rewind" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -79,6 +79,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 240\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_read\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_read\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_seal.3 b/upstream/fedora-rawhide/man3/sd_bus_message_seal.3 index 00f4e1ad..7d2b456b 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_seal.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_seal.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_SEAL" "3" "" "systemd 255" "sd_bus_message_seal" +.TH "SD_BUS_MESSAGE_SEAL" "3" "" "systemd 256~rc3" "sd_bus_message_seal" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -100,8 +100,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_call\fR(3), -\fBsd_bus_call_async\fR(3), -\fBsd_bus_send\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_call\fR(3), \fBsd_bus_call_async\fR(3), \fBsd_bus_send\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_sensitive.3 b/upstream/fedora-rawhide/man3/sd_bus_message_sensitive.3 index 67d9c068..06ba7bed 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_sensitive.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_sensitive.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_SENSITIVE" "3" "" "systemd 255" "sd_bus_message_sensitive" +.TH "SD_BUS_MESSAGE_SENSITIVE" "3" "" "systemd 256~rc3" "sd_bus_message_sensitive" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -70,6 +70,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 245\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_new_method_call\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_new_method_call\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_set_destination.3 b/upstream/fedora-rawhide/man3/sd_bus_message_set_destination.3 index 94e2b708..34da3bbd 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_set_destination.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_set_destination.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_SET_DESTINATION" "3" "" "systemd 255" "sd_bus_message_set_destination" +.TH "SD_BUS_MESSAGE_SET_DESTINATION" "3" "" "systemd 256~rc3" "sd_bus_message_set_destination" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -129,7 +129,4 @@ were added in version 237\&. were added in version 240\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_new\fR(3), -\fBsd_bus_set_sender\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_new\fR(3), \fBsd_bus_set_sender\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_set_expect_reply.3 b/upstream/fedora-rawhide/man3/sd_bus_message_set_expect_reply.3 index 4be32b34..5aa52de7 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_set_expect_reply.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_set_expect_reply.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_SET_EXPECT_REPLY" "3" "" "systemd 255" "sd_bus_message_set_expect_reply" +.TH "SD_BUS_MESSAGE_SET_EXPECT_REPLY" "3" "" "systemd 256~rc3" "sd_bus_message_set_expect_reply" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -154,6 +154,4 @@ and were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_set_description\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_set_description\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_skip.3 b/upstream/fedora-rawhide/man3/sd_bus_message_skip.3 index db63d196..08a92e87 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_skip.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_skip.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_SKIP" "3" "" "systemd 255" "sd_bus_message_skip" +.TH "SD_BUS_MESSAGE_SKIP" "3" "" "systemd 256~rc3" "sd_bus_message_skip" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -95,7 +95,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 240\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_read\fR(3), -\fBsd_bus_message_read_basic\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_read\fR(3), \fBsd_bus_message_read_basic\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_message_verify_type.3 b/upstream/fedora-rawhide/man3/sd_bus_message_verify_type.3 index 913e65aa..47d4bf1e 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_message_verify_type.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_message_verify_type.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_MESSAGE_VERIFY_TYPE" "3" "" "systemd 255" "sd_bus_message_verify_type" +.TH "SD_BUS_MESSAGE_VERIFY_TYPE" "3" "" "systemd 256~rc3" "sd_bus_message_verify_type" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -98,6 +98,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_append\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_append\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_negotiate_fds.3 b/upstream/fedora-rawhide/man3/sd_bus_negotiate_fds.3 index cf21736c..3c94330b 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_negotiate_fds.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_negotiate_fds.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_NEGOTIATE_FDS" "3" "" "systemd 255" "sd_bus_negotiate_fds" +.TH "SD_BUS_NEGOTIATE_FDS" "3" "" "systemd 256~rc3" "sd_bus_negotiate_fds" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -128,11 +128,4 @@ were added in version 212\&. was added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_start\fR(3), -\fBsd_bus_can_send\fR(3), -\fBsd_bus_message_get_monotonic_usec\fR(3), -\fBsd_bus_message_get_realtime_usec\fR(3), -\fBsd_bus_message_get_seqnum\fR(3), -\fBsd_bus_message_get_creds\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_start\fR(3), \fBsd_bus_can_send\fR(3), \fBsd_bus_message_get_monotonic_usec\fR(3), \fBsd_bus_message_get_realtime_usec\fR(3), \fBsd_bus_message_get_seqnum\fR(3), \fBsd_bus_message_get_creds\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_new.3 b/upstream/fedora-rawhide/man3/sd_bus_new.3 index 1c91ec69..3f781c4b 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_new.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_new.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_NEW" "3" "" "systemd 255" "sd_bus_new" +.TH "SD_BUS_NEW" "3" "" "systemd 256~rc3" "sd_bus_new" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -189,13 +189,7 @@ and were added in version 241\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_default_user\fR(3), -\fBsd_bus_default_system\fR(3), -\fBsd_bus_open_user\fR(3), -\fBsd_bus_open_system\fR(3), -\fBsd_bus_close\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_default_user\fR(3), \fBsd_bus_default_system\fR(3), \fBsd_bus_open_user\fR(3), \fBsd_bus_open_system\fR(3), \fBsd_bus_close\fR(3) .SH "NOTES" .IP " 1." 4 Clean-up Variable Attribute diff --git a/upstream/fedora-rawhide/man3/sd_bus_path_encode.3 b/upstream/fedora-rawhide/man3/sd_bus_path_encode.3 index d3e3885a..ab8eba09 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_path_encode.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_path_encode.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_PATH_ENCODE" "3" "" "systemd 255" "sd_bus_path_encode" +.TH "SD_BUS_PATH_ENCODE" "3" "" "systemd 256~rc3" "sd_bus_path_encode" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -111,6 +111,4 @@ and were added in version 227\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBfree\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBfree\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_process.3 b/upstream/fedora-rawhide/man3/sd_bus_process.3 index ae119342..52ce8f9b 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_process.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_process.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_PROCESS" "3" "" "systemd 255" "sd_bus_process" +.TH "SD_BUS_PROCESS" "3" "" "systemd 256~rc3" "sd_bus_process" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -114,13 +114,7 @@ from an early phase of the program when no other threads have been started\&. .SH "HISTORY" .PP \fBsd_bus_process()\fR -was added in version 231\&. +was added in version 221\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_wait\fR(3), -\fBsd_bus_get_fd\fR(3), -\fBsd_bus_message_unref\fR(3), -\fBsd-event\fR(3), -\fBsd_bus_attach_event\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_wait\fR(3), \fBsd_bus_get_fd\fR(3), \fBsd_bus_message_unref\fR(3), \fBsd-event\fR(3), \fBsd_bus_attach_event\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_query_sender_creds.3 b/upstream/fedora-rawhide/man3/sd_bus_query_sender_creds.3 index 9d8f1374..fc6b7806 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_query_sender_creds.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_query_sender_creds.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_QUERY_SENDER_CREDS" "3" "" "systemd 255" "sd_bus_query_sender_creds" +.TH "SD_BUS_QUERY_SENDER_CREDS" "3" "" "systemd 256~rc3" "sd_bus_query_sender_creds" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -127,10 +127,4 @@ and were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_creds_new_from_pid\fR(3), -\fBsd_bus_get_name_creds\fR(3), -\fBsd_bus_get_owner_creds\fR(3), -\fBsd_bus_creds_unref\fR(3), -\fBcapabilities\fR(7) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_creds_new_from_pid\fR(3), \fBsd_bus_get_name_creds\fR(3), \fBsd_bus_get_owner_creds\fR(3), \fBsd_bus_creds_unref\fR(3), \fBcapabilities\fR(7) diff --git a/upstream/fedora-rawhide/man3/sd_bus_reply_method_error.3 b/upstream/fedora-rawhide/man3/sd_bus_reply_method_error.3 index 83b31cd1..5675650b 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_reply_method_error.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_reply_method_error.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_REPLY_METHOD_ERROR" "3" "" "systemd 255" "sd_bus_reply_method_error" +.TH "SD_BUS_REPLY_METHOD_ERROR" "3" "" "systemd 256~rc3" "sd_bus_reply_method_error" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -146,6 +146,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_new_method_error\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_new_method_error\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_reply_method_return.3 b/upstream/fedora-rawhide/man3/sd_bus_reply_method_return.3 index e8981818..80c18de9 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_reply_method_return.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_reply_method_return.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_REPLY_METHOD_RETURN" "3" "" "systemd 255" "sd_bus_reply_method_return" +.TH "SD_BUS_REPLY_METHOD_RETURN" "3" "" "systemd 256~rc3" "sd_bus_reply_method_return" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -113,6 +113,4 @@ from a parallel thread\&. It is recommended to only do calls to from an early phase of the program when no other threads have been started\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_new_method_return\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_new_method_return\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_request_name.3 b/upstream/fedora-rawhide/man3/sd_bus_request_name.3 index bb652a8d..49f93b61 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_request_name.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_request_name.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_REQUEST_NAME" "3" "" "systemd 255" "sd_bus_request_name" +.TH "SD_BUS_REQUEST_NAME" "3" "" "systemd 256~rc3" "sd_bus_request_name" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -176,7 +176,4 @@ and were added in version 237\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_new\fR(3), -\fBsd_bus_slot_unref\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_new\fR(3), \fBsd_bus_slot_unref\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_send.3 b/upstream/fedora-rawhide/man3/sd_bus_send.3 index 81779d1b..69ef4149 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_send.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_send.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SEND" "3" "" "systemd 255" "sd_bus_send" +.TH "SD_BUS_SEND" "3" "" "systemd 256~rc3" "sd_bus_send" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -170,9 +170,4 @@ and were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_call_method\fR(3), -\fBsd_bus_message_set_destination\fR(3), -\fBsd_bus_reply_method_return\fR(3), -\fBsd_bus_process\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_call_method\fR(3), \fBsd_bus_message_set_destination\fR(3), \fBsd_bus_reply_method_return\fR(3), \fBsd_bus_process\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_set_address.3 b/upstream/fedora-rawhide/man3/sd_bus_set_address.3 index 82014c23..d7eb1be0 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_set_address.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_set_address.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SET_ADDRESS" "3" "" "systemd 255" "sd_bus_set_address" +.TH "SD_BUS_SET_ADDRESS" "3" "" "systemd 256~rc3" "sd_bus_set_address" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -130,7 +130,7 @@ is an identifier of the remote peer, in the syntax accepted by .PP Note that the addresses passed to \fBsd_bus_set_address()\fR -may not be verified immediately\&. If they are invalid, an error may be returned e\&.g\&. from a subsequent call to +might not be verified immediately\&. If they are invalid, an error may be returned e\&.g\&. from a subsequent call to \fBsd_bus_start\fR(3)\&. .PP \fBsd_bus_get_address()\fR @@ -221,9 +221,4 @@ from an early phase of the program when no other threads have been started\&. were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_new\fR(3), -\fBsd_bus_start\fR(3), -\fBsystemd-machined.service\fR(8), -\fBmachinectl\fR(1) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_new\fR(3), \fBsd_bus_start\fR(3), \fBsystemd-machined.service\fR(8), \fBmachinectl\fR(1) diff --git a/upstream/fedora-rawhide/man3/sd_bus_set_close_on_exit.3 b/upstream/fedora-rawhide/man3/sd_bus_set_close_on_exit.3 index 90fed345..fa340180 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_set_close_on_exit.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_set_close_on_exit.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SET_CLOSE_ON_EXIT" "3" "" "systemd 255" "sd_bus_set_close_on_exit" +.TH "SD_BUS_SET_CLOSE_ON_EXIT" "3" "" "systemd 256~rc3" "sd_bus_set_close_on_exit" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -82,9 +82,4 @@ and were added in version 240\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_flush\fR(3), -\fBsd_bus_attach_event\fR(3), -\fBsd-event\fR(3), -\fBsd_event_add_exit\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_flush\fR(3), \fBsd_bus_attach_event\fR(3), \fBsd-event\fR(3), \fBsd_event_add_exit\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_set_connected_signal.3 b/upstream/fedora-rawhide/man3/sd_bus_set_connected_signal.3 index 2ea199a6..1c9512b6 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_set_connected_signal.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_set_connected_signal.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SET_CONNECTED_SIGNAL" "3" "" "systemd 255" "sd_bus_set_connected_signal" +.TH "SD_BUS_SET_CONNECTED_SIGNAL" "3" "" "systemd 256~rc3" "sd_bus_set_connected_signal" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -97,8 +97,4 @@ and were added in version 237\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_match_signal_async\fR(3), -\fBsd_bus_set_watch_bind\fR(3), -\fBsd_bus_is_ready\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_match_signal_async\fR(3), \fBsd_bus_set_watch_bind\fR(3), \fBsd_bus_is_ready\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_set_description.3 b/upstream/fedora-rawhide/man3/sd_bus_set_description.3 index ee3a6951..617f05c4 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_set_description.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_set_description.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SET_DESCRIPTION" "3" "" "systemd 255" "sd_bus_set_description" +.TH "SD_BUS_SET_DESCRIPTION" "3" "" "systemd 256~rc3" "sd_bus_set_description" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -211,12 +211,7 @@ were added in version 240\&. were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_default_user\fR(3), -\fBsd_bus_default_system\fR(3), -\fBsd_bus_open_user\fR(3), -\fBsd_bus_open_system\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_default_user\fR(3), \fBsd_bus_default_system\fR(3), \fBsd_bus_open_user\fR(3), \fBsd_bus_open_system\fR(3) .SH "NOTES" .IP " 1." 4 D-Bus Authentication Mechanisms diff --git a/upstream/fedora-rawhide/man3/sd_bus_set_exit_on_disconnect.3 b/upstream/fedora-rawhide/man3/sd_bus_set_exit_on_disconnect.3 index 2cf206c7..38069752 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_set_exit_on_disconnect.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_set_exit_on_disconnect.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SET_EXIT_ON_DISCONNECT" "3" "" "systemd 255" "sd_bus_set_exit_on_disconnect" +.TH "SD_BUS_SET_EXIT_ON_DISCONNECT" "3" "" "systemd 256~rc3" "sd_bus_set_exit_on_disconnect" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -105,8 +105,4 @@ and were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_attach_event\fR(3), -\fBsd-event\fR(3), -\fBsd_event_exit\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_attach_event\fR(3), \fBsd-event\fR(3), \fBsd_event_exit\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_set_fd.3 b/upstream/fedora-rawhide/man3/sd_bus_set_fd.3 index 1dfeca3f..ddf7cd32 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_set_fd.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_set_fd.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SET_FD" "3" "" "systemd 255" "sd_bus_set_fd" +.TH "SD_BUS_SET_FD" "3" "" "systemd 256~rc3" "sd_bus_set_fd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -110,7 +110,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 248\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_get_fd\fR(3), -\fBsd_bus_start\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_get_fd\fR(3), \fBsd_bus_start\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_set_method_call_timeout.3 b/upstream/fedora-rawhide/man3/sd_bus_set_method_call_timeout.3 index 662628ba..be486cd3 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_set_method_call_timeout.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_set_method_call_timeout.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SET_METHOD_CALL_TIMEOUT" "3" "" "systemd 255" "sd_bus_set_method_call_timeout" +.TH "SD_BUS_SET_METHOD_CALL_TIMEOUT" "3" "" "systemd 256~rc3" "sd_bus_set_method_call_timeout" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -99,6 +99,4 @@ and were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_call\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_call\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_set_property.3 b/upstream/fedora-rawhide/man3/sd_bus_set_property.3 index 931e7d63..d59ccbfb 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_set_property.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_set_property.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SET_PROPERTY" "3" "" "systemd 255" "sd_bus_set_property" +.TH "SD_BUS_SET_PROPERTY" "3" "" "systemd 256~rc3" "sd_bus_set_property" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -117,6 +117,4 @@ from an early phase of the program when no other threads have been started\&. were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_call_method\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_call_method\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_set_sender.3 b/upstream/fedora-rawhide/man3/sd_bus_set_sender.3 index f4021f20..2bb9d164 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_set_sender.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_set_sender.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SET_SENDER" "3" "" "systemd 255" "sd_bus_set_sender" +.TH "SD_BUS_SET_SENDER" "3" "" "systemd 256~rc3" "sd_bus_set_sender" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -83,6 +83,4 @@ and were added in version 237\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_message_set_sender\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_message_set_sender\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_set_server.3 b/upstream/fedora-rawhide/man3/sd_bus_set_server.3 index 6f7da3f7..60580669 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_set_server.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_set_server.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SET_SERVER" "3" "" "systemd 255" "sd_bus_set_server" +.TH "SD_BUS_SET_SERVER" "3" "" "systemd 256~rc3" "sd_bus_set_server" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -173,8 +173,7 @@ from an early phase of the program when no other threads have been started\&. were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3) .SH "NOTES" .IP " 1." 4 The D-Bus specification diff --git a/upstream/fedora-rawhide/man3/sd_bus_set_watch_bind.3 b/upstream/fedora-rawhide/man3/sd_bus_set_watch_bind.3 index ac559757..f7ac69ff 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_set_watch_bind.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_set_watch_bind.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SET_WATCH_BIND" "3" "" "systemd 255" "sd_bus_set_watch_bind" +.TH "SD_BUS_SET_WATCH_BIND" "3" "" "systemd 256~rc3" "sd_bus_set_watch_bind" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -83,6 +83,296 @@ The code described here uses from a parallel thread\&. It is recommended to only do calls to \fBsetenv()\fR from an early phase of the program when no other threads have been started\&. +.SH "EXAMPLE" +.PP +\fBExample\ \&1.\ \&Create a simple system service that publishes a property on the system bus and can reconnect when D\-Bus disconnects and reconnects\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +/* SPDX\-License\-Identifier: MIT\-0 */ + +/* A D\-Bus service that automatically reconnects when the system bus is + * restarted\&. + * + * Compile with \*(Aqcc sd_bus_service_reconnect\&.c $(pkg\-config \-\-libs \-\-cflags libsystemd)\*(Aq + * + * To allow the program to take ownership of the name \*(Aqorg\&.freedesktop\&.ReconnectExample\*(Aq, + * add the following as /etc/dbus\-1/system\&.d/org\&.freedesktop\&.ReconnectExample\&.conf + * and then reload the broker with \*(Aqsystemctl reload dbus\*(Aq: + +<?xml version="1\&.0"?> <!\-\-*\-nxml\-*\-\-> +<!DOCTYPE busconfig PUBLIC "\-//freedesktop//DTD D\-BUS Bus Configuration 1\&.0//EN" + "http://www\&.freedesktop\&.org/standards/dbus/1\&.0/busconfig\&.dtd"> +<busconfig> + <policy user="root"> + <allow own="org\&.freedesktop\&.ReconnectExample"/> + <allow send_destination="org\&.freedesktop\&.ReconnectExample"/> + <allow receive_sender="org\&.freedesktop\&.ReconnectExample"/> + </policy> + + <policy context="default"> + <allow send_destination="org\&.freedesktop\&.ReconnectExample"/> + <allow receive_sender="org\&.freedesktop\&.ReconnectExample"/> + </policy> +</busconfig> + + * + * To get the property via busctl: + * + * $ busctl \-\-user get\-property org\&.freedesktop\&.ReconnectExample \e + * /org/freedesktop/ReconnectExample \e + * org\&.freedesktop\&.ReconnectExample \e + * Example + * s "example" + */ + +#include <errno\&.h> +#include <stdio\&.h> +#include <stdlib\&.h> +#include <systemd/sd\-bus\&.h> + +#define _cleanup_(f) __attribute__((cleanup(f))) + +static int log_error(int r, const char *str) { + fprintf(stderr, "%s failed: %s\en", str, strerror(\-r)); + return r; +} + +typedef struct object { + const char *example; + sd_bus **bus; + sd_event **event; +} object; + +static int property_get( + sd_bus *bus, + const char *path, + const char *interface, + const char *property, + sd_bus_message *reply, + void *userdata, + sd_bus_error *error) { + + object *o = userdata; + + if (strcmp(property, "Example") == 0) + return sd_bus_message_append(reply, "s", o\->example); + + return sd_bus_error_setf(error, + SD_BUS_ERROR_UNKNOWN_PROPERTY, + "Unknown property \*(Aq%s\*(Aq", + property); +} + +/* https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_add_object\&.html */ +static const sd_bus_vtable vtable[] = { + SD_BUS_VTABLE_START(0), + SD_BUS_PROPERTY( + "Example", "s", + property_get, + 0, + SD_BUS_VTABLE_PROPERTY_CONST), + SD_BUS_VTABLE_END +}; + +static int setup(object *o); + +static int on_disconnect(sd_bus_message *message, void *userdata, sd_bus_error *ret_error) { + int r; + + r = setup((object *)userdata); + if (r < 0) { + object *o = userdata; + r = sd_event_exit(*o\->event, r); + if (r < 0) + return log_error(r, "sd_event_exit()"); + } + + return 1; +} + +/* Ensure the event loop exits with a clear error if acquiring the well\-known + * service name fails */ +static int request_name_callback(sd_bus_message *m, void *userdata, sd_bus_error *ret_error) { + int r; + + if (!sd_bus_message_is_method_error(m, NULL)) + return 1; + + const sd_bus_error *error = sd_bus_message_get_error(m); + + if (sd_bus_error_has_names(error, SD_BUS_ERROR_TIMEOUT, SD_BUS_ERROR_NO_REPLY)) + return 1; /* The bus is not available, try again later */ + + fprintf(stderr, "Failed to request name: %s\en", error\->message); + object *o = userdata; + r = sd_event_exit(*o\->event, \-sd_bus_error_get_errno(error)); + if (r < 0) + return log_error(r, "sd_event_exit()"); + + return 1; +} + +static int setup(object *o) { + int r; + + /* If we are reconnecting, then the bus object needs to be closed, detached + * from the event loop and recreated\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_detach_event\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_close_unref\&.html + */ + if (*o\->bus) { + r = sd_bus_detach_event(*o\->bus); + if (r < 0) + return log_error(r, "sd_bus_detach_event()"); + *o\->bus = sd_bus_close_unref(*o\->bus); + } + + /* Set up a new bus object for the system bus, configure it to wait for D\-Bus + * to be available instead of failing if it is not, and start it\&. All the + * following operations are asynchronous and will not block waiting for D\-Bus + * to be available\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_new\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_set_address\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_set_bus_client\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_negotiate_creds\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_set_watch_bind\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_set_connected_signal\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_start\&.html + */ + r = sd_bus_new(o\->bus); + if (r < 0) + return log_error(r, "sd_bus_new()"); + r = sd_bus_set_address(*o\->bus, "unix:path=/run/dbus/system_bus_socket"); + if (r < 0) + return log_error(r, "sd_bus_set_address()"); + r = sd_bus_set_bus_client(*o\->bus, 1); + if (r < 0) + return log_error(r, "sd_bus_set_bus_client()"); + r = sd_bus_negotiate_creds(*o\->bus, 1, SD_BUS_CREDS_UID|SD_BUS_CREDS_EUID|SD_BUS_CREDS_EFFECTIVE_CAPS); + if (r < 0) + return log_error(r, "sd_bus_negotiate_creds()"); + r = sd_bus_set_watch_bind(*o\->bus, 1); + if (r < 0) + return log_error(r, "sd_bus_set_watch_bind()"); + r = sd_bus_start(*o\->bus); + if (r < 0) + return log_error(r, "sd_bus_start()"); + + /* Publish an interface on the bus, specifying our well\-known object access + * path and public interface name\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_add_object\&.html + * https://dbus\&.freedesktop\&.org/doc/dbus\-tutorial\&.html + */ + r = sd_bus_add_object_vtable(*o\->bus, + NULL, + "/org/freedesktop/ReconnectExample", + "org\&.freedesktop\&.ReconnectExample", + vtable, + o); + if (r < 0) + return log_error(r, "sd_bus_add_object_vtable()"); + /* By default the service is only assigned an ephemeral name\&. Also add a + * well\-known one, so that clients know whom to call\&. This needs to be + * asynchronous, as D\-Bus might not be yet available\&. The callback will check + * whether the error is expected or not, in case it fails\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_request_name\&.html + */ + r = sd_bus_request_name_async(*o\->bus, + NULL, + "org\&.freedesktop\&.ReconnectExample", + 0, + request_name_callback, + o); + if (r < 0) + return log_error(r, "sd_bus_request_name_async()"); + /* When D\-Bus is disconnected this callback will be invoked, which will set up + * the connection again\&. This needs to be asynchronous, as D\-Bus might not yet + * be available\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_match_signal_async\&.html + */ + r = sd_bus_match_signal_async(*o\->bus, + NULL, + "org\&.freedesktop\&.DBus\&.Local", + NULL, + "org\&.freedesktop\&.DBus\&.Local", + "Disconnected", + on_disconnect, + NULL, + o); + if (r < 0) + return log_error(r, "sd_bus_match_signal_async()"); + /* Attach the bus object to the event loop so that calls and signals are + * processed\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_attach_event\&.html + */ + r = sd_bus_attach_event(*o\->bus, *o\->event, 0); + if (r < 0) + return log_error(r, "sd_bus_attach_event()"); + + return 0; +} + +int main(int argc, char **argv) { + /* The bus should be relinquished before the program terminates\&. The cleanup + * attribute allows us to do it nicely and cleanly whenever we exit the block\&. + */ + _cleanup_(sd_bus_flush_close_unrefp) sd_bus *bus = NULL; + _cleanup_(sd_event_unrefp) sd_event *event = NULL; + object o = { + \&.example = "example", + \&.bus = &bus, + \&.event = &event, + }; + int r; + + /* Create an event loop data structure, with default parameters\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_event_default\&.html + */ + r = sd_event_default(&event); + if (r < 0) + return log_error(r, "sd_event_default()"); + + /* By default the event loop will terminate when all sources have disappeared, + * so we have to keep it \*(Aqoccupied\*(Aq\&. Register signal handling to do so\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_event_add_signal\&.html + */ + r = sd_event_add_signal(event, NULL, SIGINT|SD_EVENT_SIGNAL_PROCMASK, NULL, NULL); + if (r < 0) + return log_error(r, "sd_event_add_signal(SIGINT)"); + + r = sd_event_add_signal(event, NULL, SIGTERM|SD_EVENT_SIGNAL_PROCMASK, NULL, NULL); + if (r < 0) + return log_error(r, "sd_event_add_signal(SIGTERM)"); + + r = setup(&o); + if (r < 0) + return EXIT_FAILURE; + + /* Enter the main loop, it will exit only on sigint/sigterm\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_event_loop\&.html + */ + r = sd_event_loop(event); + if (r < 0) + return log_error(r, "sd_event_loop()"); + + /* https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_release_name\&.html */ + r = sd_bus_release_name(bus, "org\&.freedesktop\&.ReconnectExample"); + if (r < 0) + return log_error(r, "sd_bus_release_name()"); + + return 0; +} +.fi +.if n \{\ +.RE +.\} +.PP +This is particularly useful for services that are configured to survive a soft\-reboot, see +\fBsystemd-soft-reboot.service\fR(8) +for more details\&. .SH "HISTORY" .PP \fBsd_bus_set_watch_bind()\fR @@ -91,11 +381,4 @@ and were added in version 237\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBinotify\fR(7), -\fBsd_bus_call\fR(3), -\fBsd_bus_add_match\fR(3), -\fBsd_bus_request_name\fR(3), -\fBsd_bus_is_ready\fR(3), -\fBsd_bus_set_connected_signal\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBinotify\fR(7), \fBsd_bus_call\fR(3), \fBsd_bus_add_match\fR(3), \fBsd_bus_request_name\fR(3), \fBsd_bus_is_ready\fR(3), \fBsd_bus_set_connected_signal\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_slot_get_bus.3 b/upstream/fedora-rawhide/man3/sd_bus_slot_get_bus.3 index 13e790f0..d8692c01 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_slot_get_bus.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_slot_get_bus.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SLOT_GET_BUS" "3" "" "systemd 255" "sd_bus_slot_get_bus" +.TH "SD_BUS_SLOT_GET_BUS" "3" "" "systemd 256~rc3" "sd_bus_slot_get_bus" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -86,5 +86,4 @@ from an early phase of the program when no other threads have been started\&. were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), +\fBsystemd\fR(1), \fBsd-bus\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_slot_ref.3 b/upstream/fedora-rawhide/man3/sd_bus_slot_ref.3 index 21def369..8cddb478 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_slot_ref.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_slot_ref.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SLOT_REF" "3" "" "systemd 255" "sd_bus_slot_ref" +.TH "SD_BUS_SLOT_REF" "3" "" "systemd 256~rc3" "sd_bus_slot_ref" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -99,11 +99,7 @@ from an early phase of the program when no other threads have been started\&. were added in version 240\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_new\fR(3), -\fBsd_bus_message_new\fR(3), -\fBsd_bus_call_method_async\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_new\fR(3), \fBsd_bus_message_new\fR(3), \fBsd_bus_call_method_async\fR(3) .SH "NOTES" .IP " 1." 4 Clean-up Variable Attribute diff --git a/upstream/fedora-rawhide/man3/sd_bus_slot_set_description.3 b/upstream/fedora-rawhide/man3/sd_bus_slot_set_description.3 index ec823f77..1a2f7c42 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_slot_set_description.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_slot_set_description.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SLOT_SET_DESCRIPTION" "3" "" "systemd 255" "sd_bus_slot_set_description" +.TH "SD_BUS_SLOT_SET_DESCRIPTION" "3" "" "systemd 256~rc3" "sd_bus_slot_set_description" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -88,7 +88,4 @@ and were added in version 240\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3) -\fBsd_bus_slot_ref\fR(3), -\fBsd_bus_slot_set_userdata\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_slot_ref\fR(3), \fBsd_bus_slot_set_userdata\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_slot_set_destroy_callback.3 b/upstream/fedora-rawhide/man3/sd_bus_slot_set_destroy_callback.3 index 485a4a5a..0faef0f0 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_slot_set_destroy_callback.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_slot_set_destroy_callback.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SLOT_SET_DESTROY_CALLBACK" "3" "" "systemd 255" "sd_bus_slot_set_destroy_callback" +.TH "SD_BUS_SLOT_SET_DESTROY_CALLBACK" "3" "" "systemd 256~rc3" "sd_bus_slot_set_destroy_callback" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -117,10 +117,4 @@ from an early phase of the program when no other threads have been started\&. were added in version 239\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_slot_set_floating\fR(3), -\fBsd_bus_add_match\fR(3), -\fBsd_bus_track_new\fR(3), -\fBsd_bus_slot_set_userdata\fR(3), -\fBsd_bus_track_set_userdata\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_slot_set_floating\fR(3), \fBsd_bus_add_match\fR(3), \fBsd_bus_track_new\fR(3), \fBsd_bus_slot_set_userdata\fR(3), \fBsd_bus_track_set_userdata\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_slot_set_floating.3 b/upstream/fedora-rawhide/man3/sd_bus_slot_set_floating.3 index 35178b81..6d172497 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_slot_set_floating.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_slot_set_floating.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SLOT_SET_FLOATING" "3" "" "systemd 255" "sd_bus_slot_set_floating" +.TH "SD_BUS_SLOT_SET_FLOATING" "3" "" "systemd 256~rc3" "sd_bus_slot_set_floating" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -97,7 +97,4 @@ and were added in version 239\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_slot_set_destroy_callback\fR(3), -\fBsd_bus_add_match\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_slot_set_destroy_callback\fR(3), \fBsd_bus_add_match\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_slot_set_userdata.3 b/upstream/fedora-rawhide/man3/sd_bus_slot_set_userdata.3 index 58760e3c..f70dda5a 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_slot_set_userdata.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_slot_set_userdata.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_SLOT_SET_USERDATA" "3" "" "systemd 255" "sd_bus_slot_set_userdata" +.TH "SD_BUS_SLOT_SET_USERDATA" "3" "" "systemd 256~rc3" "sd_bus_slot_set_userdata" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -81,8 +81,4 @@ and were added in version 240\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_slot_set_destroy_callback\fR(3), -\fBsd_bus_add_match\fR(3), -\fBsd_bus_slot_get_current_userdata\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_slot_set_destroy_callback\fR(3), \fBsd_bus_add_match\fR(3), \fBsd_bus_slot_get_current_userdata\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_start.3 b/upstream/fedora-rawhide/man3/sd_bus_start.3 index 4cdec635..18610f9b 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_start.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_start.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_START" "3" "" "systemd 255" "sd_bus_start" +.TH "SD_BUS_START" "3" "" "systemd 256~rc3" "sd_bus_start" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -118,7 +118,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_default\fR(3), -\fBsd_bus_call_async\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_default\fR(3), \fBsd_bus_call_async\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_track_add_name.3 b/upstream/fedora-rawhide/man3/sd_bus_track_add_name.3 index 6cdb13e2..c3d89676 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_track_add_name.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_track_add_name.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_TRACK_ADD_NAME" "3" "" "systemd 255" "sd_bus_track_add_name" +.TH "SD_BUS_TRACK_ADD_NAME" "3" "" "systemd 256~rc3" "sd_bus_track_add_name" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -191,6 +191,4 @@ from an early phase of the program when no other threads have been started\&. were added in version 232\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_track_new\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_track_new\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_bus_track_new.3 b/upstream/fedora-rawhide/man3/sd_bus_track_new.3 index 6951181e..f9a01f10 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_track_new.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_track_new.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_TRACK_NEW" "3" "" "systemd 255" "sd_bus_track_new" +.TH "SD_BUS_TRACK_NEW" "3" "" "systemd 256~rc3" "sd_bus_track_new" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -205,9 +205,7 @@ from an early phase of the program when no other threads have been started\&. were added in version 232\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3) -\fBsd_bus_track_add_name\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_track_add_name\fR(3) .SH "NOTES" .IP " 1." 4 Clean-up Variable Attribute diff --git a/upstream/fedora-rawhide/man3/sd_bus_wait.3 b/upstream/fedora-rawhide/man3/sd_bus_wait.3 index 79012aba..916cdc1f 100644 --- a/upstream/fedora-rawhide/man3/sd_bus_wait.3 +++ b/upstream/fedora-rawhide/man3/sd_bus_wait.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_BUS_WAIT" "3" "" "systemd 255" "sd_bus_wait" +.TH "SD_BUS_WAIT" "3" "" "systemd 256~rc3" "sd_bus_wait" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -97,9 +97,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 240\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-bus\fR(3), -\fBsd_bus_process\fR(3), -\fBsd_bus_get_fd\fR(3), -\fBsd-event\fR(3), -\fBsd_bus_attach_event\fR(3) +\fBsystemd\fR(1), \fBsd-bus\fR(3), \fBsd_bus_process\fR(3), \fBsd_bus_get_fd\fR(3), \fBsd-event\fR(3), \fBsd_bus_attach_event\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_device_get_syspath.3 b/upstream/fedora-rawhide/man3/sd_device_get_syspath.3 index ebc385e1..19e60c04 100644 --- a/upstream/fedora-rawhide/man3/sd_device_get_syspath.3 +++ b/upstream/fedora-rawhide/man3/sd_device_get_syspath.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_DEVICE_GET_SYSPATH" "3" "" "systemd 255" "sd_device_get_syspath" +.TH "SD_DEVICE_GET_SYSPATH" "3" "" "systemd 256~rc3" "sd_device_get_syspath" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man3/sd_device_ref.3 b/upstream/fedora-rawhide/man3/sd_device_ref.3 index c80f8456..399ea897 100644 --- a/upstream/fedora-rawhide/man3/sd_device_ref.3 +++ b/upstream/fedora-rawhide/man3/sd_device_ref.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_DEVICE_REF" "3" "" "systemd 255" "sd_device_ref" +.TH "SD_DEVICE_REF" "3" "" "systemd 256~rc3" "sd_device_ref" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man3/sd_event_add_child.3 b/upstream/fedora-rawhide/man3/sd_event_add_child.3 index 736efa60..d13096d6 100644 --- a/upstream/fedora-rawhide/man3/sd_event_add_child.3 +++ b/upstream/fedora-rawhide/man3/sd_event_add_child.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_ADD_CHILD" "3" "" "systemd 255" "sd_event_add_child" +.TH "SD_EVENT_ADD_CHILD" "3" "" "systemd 256~rc3" "sd_event_add_child" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -265,10 +265,11 @@ from an early phase of the program when no other threads have been started\&. .nf /* SPDX\-License\-Identifier: MIT\-0 */ +#define _GNU_SOURCE 1 #include <assert\&.h> #include <stdio\&.h> #include <unistd\&.h> -#include <sd\-event\&.h> +#include <systemd/sd\-event\&.h> int main(int argc, char **argv) { pid_t pid = fork(); @@ -326,24 +327,4 @@ were added in version 217\&. were added in version 245\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_now\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_enabled\fR(3), -\fBsd_event_source_set_priority\fR(3), -\fBsd_event_source_set_userdata\fR(3), -\fBsd_event_source_set_description\fR(3), -\fBsd_event_source_set_floating\fR(3), -\fBwaitid\fR(2), -\fBsigprocmask\fR(2), -\fBpthread_sigmask\fR(3), -\fBpidfd_open\fR(2), -\fBpidfd_send_signal\fR(2), -\fBrt_sigqueueinfo\fR(2), -\fBkill\fR(2) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_now\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_enabled\fR(3), \fBsd_event_source_set_priority\fR(3), \fBsd_event_source_set_userdata\fR(3), \fBsd_event_source_set_description\fR(3), \fBsd_event_source_set_floating\fR(3), \fBwaitid\fR(2), \fBsigprocmask\fR(2), \fBpthread_sigmask\fR(3), \fBpidfd_open\fR(2), \fBpidfd_send_signal\fR(2), \fBrt_sigqueueinfo\fR(2), \fBkill\fR(2) diff --git a/upstream/fedora-rawhide/man3/sd_event_add_defer.3 b/upstream/fedora-rawhide/man3/sd_event_add_defer.3 index 3258d102..b6714b48 100644 --- a/upstream/fedora-rawhide/man3/sd_event_add_defer.3 +++ b/upstream/fedora-rawhide/man3/sd_event_add_defer.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_ADD_DEFER" "3" "" "systemd 255" "sd_event_add_defer" +.TH "SD_EVENT_ADD_DEFER" "3" "" "systemd 256~rc3" "sd_event_add_defer" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -153,18 +153,4 @@ from an early phase of the program when no other threads have been started\&. were added in version 217\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_now\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_source_set_enabled\fR(3), -\fBsd_event_source_set_priority\fR(3), -\fBsd_event_source_set_userdata\fR(3), -\fBsd_event_source_set_description\fR(3), -\fBsd_event_source_set_floating\fR(3), -\fBsd_event_exit\fR(3) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_now\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_source_set_enabled\fR(3), \fBsd_event_source_set_priority\fR(3), \fBsd_event_source_set_userdata\fR(3), \fBsd_event_source_set_description\fR(3), \fBsd_event_source_set_floating\fR(3), \fBsd_event_exit\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_add_inotify.3 b/upstream/fedora-rawhide/man3/sd_event_add_inotify.3 index cb5a643a..6bd6c615 100644 --- a/upstream/fedora-rawhide/man3/sd_event_add_inotify.3 +++ b/upstream/fedora-rawhide/man3/sd_event_add_inotify.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_ADD_INOTIFY" "3" "" "systemd 255" "sd_event_add_inotify" +.TH "SD_EVENT_ADD_INOTIFY" "3" "" "systemd 256~rc3" "sd_event_add_inotify" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,7 +20,7 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -sd_event_add_inotify, sd_event_add_inotify_fd, sd_event_source_get_inotify_mask, sd_event_inotify_handler_t \- Add an "inotify" file system inode event source to an event loop +sd_event_add_inotify, sd_event_add_inotify_fd, sd_event_source_get_inotify_mask, sd_event_source_get_inotify_path, sd_event_inotify_handler_t \- Add an "inotify" file system inode event source to an event loop .SH "SYNOPSIS" .sp .ft B @@ -41,7 +41,9 @@ typedef struct sd_event_source sd_event_source; .HP \w'int\ sd_event_add_inotify_fd('u .BI "int sd_event_add_inotify_fd(sd_event\ *" "event" ", sd_event_source\ **" "source" ", int\ " "fd" ", uint32_t\ " "mask" ", sd_event_inotify_handler_t\ " "handler" ", void\ *" "userdata" ");" .HP \w'int\ sd_event_source_get_inotify_mask('u -.BI "int sd_event_source_get_inotify_mask(sd_event_source\ *" "source" ", uint32_t\ *" "mask" ");" +.BI "int sd_event_source_get_inotify_mask(sd_event_source\ *" "source" ", uint32_t\ *" "ret" ");" +.HP \w'int\ sd_event_source_get_inotify_path('u +.BI "int sd_event_source_get_inotify_path(sd_event_source\ *" "source" ", const\ char\ **" "ret" ");" .SH "DESCRIPTION" .PP \fBsd_event_add_inotify()\fR @@ -126,6 +128,14 @@ retrieves the configured inotify watch mask of an event source created previousl parameter and a pointer to a \fBuint32_t\fR variable to return the mask in\&. +.PP +\fBsd_event_source_get_inotify_path()\fR +retrieves the target path of the configured inotify watch of an event source created previously with +\fBsd_event_add_inotify()\fR\&. It takes the event source object as the +\fIsource\fR +parameter and a pointer to a +\fBconst char **\fR +variable to return the path in\&. The caller must not free the returned path\&. .SH "RETURN VALUE" .PP On success, these functions return 0 or a positive integer\&. On failure, they return a negative errno\-style error code\&. @@ -147,7 +157,13 @@ set\&. .PP \fB\-ESTALE\fR .RS 4 -The event loop is already terminated\&. +Returned by +\fBsd_event_source_add_inotify()\fR +or +\fBsd_event_source_add_inotify_fd()\fR +when the event loop is already terminated\&. Returned by +\fBsd_event_source_get_inotify_path()\fR +when no active inode data is assigned to the event source, e\&.g\&. when the event source is disabled\&. .RE .PP \fB\-ECHILD\fR @@ -163,18 +179,16 @@ The passed event source is not an inotify process event source\&. \fB\-EBADF\fR .RS 4 The passed file descriptor is not valid\&. -.sp -Added in version 250\&. .RE .PP \fB\-ENOSYS\fR .RS 4 \fBsd_event_add_inotify_fd()\fR +or +\fBsd_event_source_get_inotify_path()\fR was called without /proc/ mounted\&. -.sp -Added in version 250\&. .RE .SH "EXAMPLES" .PP @@ -267,20 +281,9 @@ were added in version 239\&. .PP \fBsd_event_add_inotify_fd()\fR was added in version 250\&. +.PP +\fBsd_event_source_get_inotify_path()\fR +was added in version 256\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_now\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_source_set_enabled\fR(3), -\fBsd_event_source_set_priority\fR(3), -\fBsd_event_source_set_userdata\fR(3), -\fBsd_event_source_set_description\fR(3), -\fBsd_event_source_set_floating\fR(3), -\fBwaitid\fR(2) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_now\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_source_set_enabled\fR(3), \fBsd_event_source_set_priority\fR(3), \fBsd_event_source_set_userdata\fR(3), \fBsd_event_source_set_description\fR(3), \fBsd_event_source_set_floating\fR(3), \fBwaitid\fR(2) diff --git a/upstream/fedora-rawhide/man3/sd_event_add_io.3 b/upstream/fedora-rawhide/man3/sd_event_add_io.3 index 4cf99760..c844d100 100644 --- a/upstream/fedora-rawhide/man3/sd_event_add_io.3 +++ b/upstream/fedora-rawhide/man3/sd_event_add_io.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_ADD_IO" "3" "" "systemd 255" "sd_event_add_io" +.TH "SD_EVENT_ADD_IO" "3" "" "systemd 256~rc3" "sd_event_add_io" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -169,12 +169,14 @@ retrieves the UNIX file descriptor of an event source created previously with .PP \fBsd_event_source_set_io_fd()\fR changes the UNIX file descriptor of an I/O event source created previously with -\fBsd_event_add_io()\fR\&. It takes the event source object and the new file descriptor\&. +\fBsd_event_add_io()\fR\&. It takes the event source object and the new file descriptor as parameters\&. If the event source owned the previous file descriptor, that is if +\fBsd_event_source_set_io_fd_own()\fR +had been called for the event source with a non\-zero value, then the previous file descriptor will be closed and the event source will also take the ownership of the new file descriptor on success\&. .PP \fBsd_event_source_set_io_fd_own()\fR -controls whether the file descriptor of the event source shall be closed automatically when the event source is freed, i\&.e\&. whether it shall be considered \*(Aqowned\*(Aq by the event source object\&. By default it is not closed automatically, and the application has to do this on its own\&. The -\fIb\fR -parameter is a boolean parameter: if zero, the file descriptor is not closed automatically when the event source is freed, otherwise it is closed\&. +controls whether the file descriptor of the event source shall take ownership of the file descriptor\&. Takes a boolean parameter +\fIb\fR\&. When true (nonzero), the file descriptor will be closed automatically when the event source is freed or when the file descriptor is replaced by +\fBsd_event_source_set_io_fd()\fR\&. By default the descriptor is not owned by the event source, and the application has to do close it on its own if needed\&. .PP \fBsd_event_source_get_io_fd_own()\fR may be used to query the current setting of the file descriptor ownership boolean flag as set with @@ -250,20 +252,4 @@ and were added in version 239\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_now\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_enabled\fR(3), -\fBsd_event_source_set_priority\fR(3), -\fBsd_event_source_set_userdata\fR(3), -\fBsd_event_source_set_description\fR(3), -\fBsd_event_source_get_pending\fR(3), -\fBsd_event_source_set_floating\fR(3), -\fBepoll_ctl\fR(2), -\fBepoll\fR(7) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_now\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_enabled\fR(3), \fBsd_event_source_set_priority\fR(3), \fBsd_event_source_set_userdata\fR(3), \fBsd_event_source_set_description\fR(3), \fBsd_event_source_get_pending\fR(3), \fBsd_event_source_set_floating\fR(3), \fBepoll_ctl\fR(2), \fBepoll\fR(7) diff --git a/upstream/fedora-rawhide/man3/sd_event_add_memory_pressure.3 b/upstream/fedora-rawhide/man3/sd_event_add_memory_pressure.3 index d987ad19..f83a7cec 100644 --- a/upstream/fedora-rawhide/man3/sd_event_add_memory_pressure.3 +++ b/upstream/fedora-rawhide/man3/sd_event_add_memory_pressure.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_ADD_MEMORY_PRESSURE" "3" "" "systemd 255" "sd_event_add_memory_pressure" +.TH "SD_EVENT_ADD_MEMORY_PRESSURE" "3" "" "systemd 256~rc3" "sd_event_add_memory_pressure" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -319,18 +319,7 @@ from an early phase of the program when no other threads have been started\&. were added in version 254\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_enabled\fR(3), -\fBsd_event_source_set_description\fR(3), -\fBsd_event_source_set_userdata\fR(3), -\fBsd_event_source_set_floating\fR(3) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_enabled\fR(3), \fBsd_event_source_set_description\fR(3), \fBsd_event_source_set_userdata\fR(3), \fBsd_event_source_set_floating\fR(3) .SH "NOTES" .IP " 1." 4 Pressure Stall Information (PSI) diff --git a/upstream/fedora-rawhide/man3/sd_event_add_signal.3 b/upstream/fedora-rawhide/man3/sd_event_add_signal.3 index 2be85cf7..709aba88 100644 --- a/upstream/fedora-rawhide/man3/sd_event_add_signal.3 +++ b/upstream/fedora-rawhide/man3/sd_event_add_signal.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_ADD_SIGNAL" "3" "" "systemd 255" "sd_event_add_signal" +.TH "SD_EVENT_ADD_SIGNAL" "3" "" "systemd 256~rc3" "sd_event_add_signal" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -170,20 +170,4 @@ from an early phase of the program when no other threads have been started\&. were added in version 217\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_now\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_enabled\fR(3), -\fBsd_event_source_set_description\fR(3), -\fBsd_event_source_set_userdata\fR(3), -\fBsd_event_source_set_floating\fR(3), -\fBsignal\fR(7), -\fBsignalfd\fR(2), -\fBsigprocmask\fR(2), -\fBpthread_sigmask\fR(3) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_now\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_enabled\fR(3), \fBsd_event_source_set_description\fR(3), \fBsd_event_source_set_userdata\fR(3), \fBsd_event_source_set_floating\fR(3), \fBsignal\fR(7), \fBsignalfd\fR(2), \fBsigprocmask\fR(2), \fBpthread_sigmask\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_add_time.3 b/upstream/fedora-rawhide/man3/sd_event_add_time.3 index c6d4cc0a..f96e7515 100644 --- a/upstream/fedora-rawhide/man3/sd_event_add_time.3 +++ b/upstream/fedora-rawhide/man3/sd_event_add_time.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_ADD_TIME" "3" "" "systemd 255" "sd_event_add_time" +.TH "SD_EVENT_ADD_TIME" "3" "" "systemd 256~rc3" "sd_event_add_time" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -254,20 +254,4 @@ and were added in version 247\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_now\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_enabled\fR(3), -\fBsd_event_source_set_priority\fR(3), -\fBsd_event_source_set_userdata\fR(3), -\fBsd_event_source_set_description\fR(3), -\fBsd_event_source_set_floating\fR(3), -\fBclock_gettime\fR(2), -\fBtimerfd_create\fR(2), -\fBprctl\fR(2) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_now\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_enabled\fR(3), \fBsd_event_source_set_priority\fR(3), \fBsd_event_source_set_userdata\fR(3), \fBsd_event_source_set_description\fR(3), \fBsd_event_source_set_floating\fR(3), \fBclock_gettime\fR(2), \fBtimerfd_create\fR(2), \fBprctl\fR(2) diff --git a/upstream/fedora-rawhide/man3/sd_event_exit.3 b/upstream/fedora-rawhide/man3/sd_event_exit.3 index 822ef7f7..93d49168 100644 --- a/upstream/fedora-rawhide/man3/sd_event_exit.3 +++ b/upstream/fedora-rawhide/man3/sd_event_exit.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_EXIT" "3" "" "systemd 255" "sd_event_exit" +.TH "SD_EVENT_EXIT" "3" "" "systemd 256~rc3" "sd_event_exit" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -53,9 +53,17 @@ If is invoked a second time while the event loop is still processing exit event sources, the exit code stored in the event loop object is updated, but otherwise no further operation is executed\&. .PP \fBsd_event_get_exit_code()\fR -may be used to query the exit code passed into +may be used to query the exit code passed to an earlier call of +\fBsd_event_exit()\fR\&. The return parameter +\fIcode\fR +may be set to +\fBNULL\fR, in order to simply check if \fBsd_event_exit()\fR -earlier\&. +has been called before (as +\fBsd_event_get_exit_code()\fR +fails with +\fB\-ENODATA\fR +if that\*(Aqs not the case, see below)\&. .PP While the full positive and negative integer ranges may be used for the exit code, care should be taken not pick exit codes that conflict with regular exit codes returned by \fBsd_event_loop()\fR, if these exit codes shall be distinguishable\&. @@ -97,7 +105,9 @@ The event loop has exited already and all exit handlers are already processed\&. .PP \fB\-ENODATA\fR .RS 4 -The event loop has not been requested to exit yet\&. +Returned by +\fBsd_event_get_exit_code()\fR +in case the event loop has not been requested to exit yet\&. .RE .SH "NOTES" .PP @@ -119,12 +129,4 @@ and were added in version 229\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_add_exit\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_add_inotify\fR(3) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_add_exit\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_add_inotify\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_get_fd.3 b/upstream/fedora-rawhide/man3/sd_event_get_fd.3 index 3f10048a..095b0821 100644 --- a/upstream/fedora-rawhide/man3/sd_event_get_fd.3 +++ b/upstream/fedora-rawhide/man3/sd_event_get_fd.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_GET_FD" "3" "" "systemd 255" "sd_event_get_fd" +.TH "SD_EVENT_GET_FD" "3" "" "systemd 256~rc3" "sd_event_get_fd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -145,8 +145,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 217\&. .SH "SEE ALSO" .PP -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_wait\fR(3), -\fBepoll_ctl\fR(2), -\fBepoll\fR(7) +\fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_wait\fR(3), \fBepoll_ctl\fR(2), \fBepoll\fR(7) diff --git a/upstream/fedora-rawhide/man3/sd_event_new.3 b/upstream/fedora-rawhide/man3/sd_event_new.3 index c7f5b98e..b73df3b9 100644 --- a/upstream/fedora-rawhide/man3/sd_event_new.3 +++ b/upstream/fedora-rawhide/man3/sd_event_new.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_NEW" "3" "" "systemd 255" "sd_event_new" +.TH "SD_EVENT_NEW" "3" "" "systemd 256~rc3" "sd_event_new" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -180,16 +180,7 @@ and were added in version 229\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_run\fR(3), -\fBgettid\fR(2) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_run\fR(3), \fBgettid\fR(2) .SH "NOTES" .IP " 1." 4 Clean-up Variable Attribute diff --git a/upstream/fedora-rawhide/man3/sd_event_now.3 b/upstream/fedora-rawhide/man3/sd_event_now.3 index 8ecffe6a..0d4fd113 100644 --- a/upstream/fedora-rawhide/man3/sd_event_now.3 +++ b/upstream/fedora-rawhide/man3/sd_event_now.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_NOW" "3" "" "systemd 255" "sd_event_now" +.TH "SD_EVENT_NOW" "3" "" "systemd 256~rc3" "sd_event_now" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -95,8 +95,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 229\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_add_time\fR(3), -\fBclock_gettime\fR(2) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_add_time\fR(3), \fBclock_gettime\fR(2) diff --git a/upstream/fedora-rawhide/man3/sd_event_run.3 b/upstream/fedora-rawhide/man3/sd_event_run.3 index f3daf4ca..71ce1240 100644 --- a/upstream/fedora-rawhide/man3/sd_event_run.3 +++ b/upstream/fedora-rawhide/man3/sd_event_run.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_RUN" "3" "" "systemd 255" "sd_event_run" +.TH "SD_EVENT_RUN" "3" "" "systemd 256~rc3" "sd_event_run" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -130,19 +130,7 @@ and were added in version 220\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_exit\fR(3), -\fBsd_event_get_fd\fR(3), -\fBsd_event_wait\fR(3), -\m[blue]\fBGLib Main Event Loop\fR\m[]\&\s-2\u[1]\d\s+2 +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_exit\fR(3), \fBsd_event_get_fd\fR(3), \fBsd_event_wait\fR(3), \m[blue]\fBGLib Main Event Loop\fR\m[]\&\s-2\u[1]\d\s+2 .SH "NOTES" .IP " 1." 4 GLib Main Event Loop diff --git a/upstream/fedora-rawhide/man3/sd_event_set_signal_exit.3 b/upstream/fedora-rawhide/man3/sd_event_set_signal_exit.3 index 4ee150bc..8c30a616 100644 --- a/upstream/fedora-rawhide/man3/sd_event_set_signal_exit.3 +++ b/upstream/fedora-rawhide/man3/sd_event_set_signal_exit.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SET_SIGNAL_EXIT" "3" "" "systemd 255" "sd_event_set_signal_exit" +.TH "SD_EVENT_SET_SIGNAL_EXIT" "3" "" "systemd 256~rc3" "sd_event_set_signal_exit" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -88,7 +88,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 252\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_add_signal\fR(3) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_add_signal\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_set_watchdog.3 b/upstream/fedora-rawhide/man3/sd_event_set_watchdog.3 index 7e1bb798..d48d01bd 100644 --- a/upstream/fedora-rawhide/man3/sd_event_set_watchdog.3 +++ b/upstream/fedora-rawhide/man3/sd_event_set_watchdog.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SET_WATCHDOG" "3" "" "systemd 255" "sd_event_set_watchdog" +.TH "SD_EVENT_SET_WATCHDOG" "3" "" "systemd 256~rc3" "sd_event_set_watchdog" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -109,15 +109,4 @@ and were added in version 229\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_new\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_watchdog_enabled\fR(3), -\fBsd_notify\fR(3), -\fBsystemd.service\fR(5) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_watchdog_enabled\fR(3), \fBsd_notify\fR(3), \fBsystemd.service\fR(5) diff --git a/upstream/fedora-rawhide/man3/sd_event_source_get_event.3 b/upstream/fedora-rawhide/man3/sd_event_source_get_event.3 index a765ff57..e39e7c3a 100644 --- a/upstream/fedora-rawhide/man3/sd_event_source_get_event.3 +++ b/upstream/fedora-rawhide/man3/sd_event_source_get_event.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SOURCE_GET_EVENT" "3" "" "systemd 255" "sd_event_source_get_event" +.TH "SD_EVENT_SOURCE_GET_EVENT" "3" "" "systemd 256~rc3" "sd_event_source_get_event" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -63,11 +63,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 229\&. .SH "SEE ALSO" .PP -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_userdata\fR(3) +\fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_userdata\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_source_get_pending.3 b/upstream/fedora-rawhide/man3/sd_event_source_get_pending.3 index b8ed0b45..7635545f 100644 --- a/upstream/fedora-rawhide/man3/sd_event_source_get_pending.3 +++ b/upstream/fedora-rawhide/man3/sd_event_source_get_pending.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SOURCE_GET_PENDING" "3" "" "systemd 255" "sd_event_source_get_pending" +.TH "SD_EVENT_SOURCE_GET_PENDING" "3" "" "systemd 256~rc3" "sd_event_source_get_pending" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -108,11 +108,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 229\&. .SH "SEE ALSO" .PP -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_unref\fR(3) +\fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_unref\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_source_set_description.3 b/upstream/fedora-rawhide/man3/sd_event_source_set_description.3 index afc52c20..45e7e6b5 100644 --- a/upstream/fedora-rawhide/man3/sd_event_source_set_description.3 +++ b/upstream/fedora-rawhide/man3/sd_event_source_set_description.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SOURCE_SET_DESCRIPTION" "3" "" "systemd 255" "sd_event_source_set_description" +.TH "SD_EVENT_SOURCE_SET_DESCRIPTION" "3" "" "systemd 256~rc3" "sd_event_source_set_description" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -116,11 +116,4 @@ and were added in version 229\&. .SH "SEE ALSO" .PP -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_userdata\fR(3) +\fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_userdata\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_source_set_destroy_callback.3 b/upstream/fedora-rawhide/man3/sd_event_source_set_destroy_callback.3 index ea744bb2..75b4906b 100644 --- a/upstream/fedora-rawhide/man3/sd_event_source_set_destroy_callback.3 +++ b/upstream/fedora-rawhide/man3/sd_event_source_set_destroy_callback.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SOURCE_SET_DESTROY_CALLBACK" "3" "" "systemd 255" "sd_event_source_set_destroy_callback" +.TH "SD_EVENT_SOURCE_SET_DESTROY_CALLBACK" "3" "" "systemd 256~rc3" "sd_event_source_set_destroy_callback" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -97,12 +97,4 @@ from an early phase of the program when no other threads have been started\&. were added in version 239\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_userdata\fR(3) +\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_userdata\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_source_set_enabled.3 b/upstream/fedora-rawhide/man3/sd_event_source_set_enabled.3 index 6f0e6c12..37e10063 100644 --- a/upstream/fedora-rawhide/man3/sd_event_source_set_enabled.3 +++ b/upstream/fedora-rawhide/man3/sd_event_source_set_enabled.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SOURCE_SET_ENABLED" "3" "" "systemd 255" "sd_event_source_set_enabled" +.TH "SD_EVENT_SOURCE_SET_ENABLED" "3" "" "systemd 256~rc3" "sd_event_source_set_enabled" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -147,12 +147,4 @@ and were added in version 229\&. .SH "SEE ALSO" .PP -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_unref\fR(3), -\fBsd_event_source_set_ratelimit\fR(3) +\fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_unref\fR(3), \fBsd_event_source_set_ratelimit\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_source_set_exit_on_failure.3 b/upstream/fedora-rawhide/man3/sd_event_source_set_exit_on_failure.3 index 13460140..26b7e37f 100644 --- a/upstream/fedora-rawhide/man3/sd_event_source_set_exit_on_failure.3 +++ b/upstream/fedora-rawhide/man3/sd_event_source_set_exit_on_failure.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SOURCE_SET_EXIT_ON_FAILURE" "3" "" "systemd 255" "sd_event_source_set_exit_on_failure" +.TH "SD_EVENT_SOURCE_SET_EXIT_ON_FAILURE" "3" "" "systemd 256~rc3" "sd_event_source_set_exit_on_failure" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -90,10 +90,4 @@ and were added in version 247\&. .SH "SEE ALSO" .PP -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3) +\fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_source_set_floating.3 b/upstream/fedora-rawhide/man3/sd_event_source_set_floating.3 index ac7e179c..e4600d9a 100644 --- a/upstream/fedora-rawhide/man3/sd_event_source_set_floating.3 +++ b/upstream/fedora-rawhide/man3/sd_event_source_set_floating.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SOURCE_SET_FLOATING" "3" "" "systemd 255" "sd_event_source_set_floating" +.TH "SD_EVENT_SOURCE_SET_FLOATING" "3" "" "systemd 256~rc3" "sd_event_source_set_floating" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -94,12 +94,4 @@ and were added in version 244\&. .SH "SEE ALSO" .PP -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_description\fR(3), -\fBsd_event_source_set_priority\fR(3) +\fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_description\fR(3), \fBsd_event_source_set_priority\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_source_set_prepare.3 b/upstream/fedora-rawhide/man3/sd_event_source_set_prepare.3 index dde9fd4f..e7a1059b 100644 --- a/upstream/fedora-rawhide/man3/sd_event_source_set_prepare.3 +++ b/upstream/fedora-rawhide/man3/sd_event_source_set_prepare.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SOURCE_SET_PREPARE" "3" "" "systemd 255" "sd_event_source_set_prepare" +.TH "SD_EVENT_SOURCE_SET_PREPARE" "3" "" "systemd 256~rc3" "sd_event_source_set_prepare" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -107,13 +107,4 @@ and were added in version 229\&. .SH "SEE ALSO" .PP -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_enabled\fR(3), -\fBsd_event_source_set_priority\fR(3), -\fBsd_event_source_set_userdata\fR(3) +\fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_enabled\fR(3), \fBsd_event_source_set_priority\fR(3), \fBsd_event_source_set_userdata\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_source_set_priority.3 b/upstream/fedora-rawhide/man3/sd_event_source_set_priority.3 index 8b722557..a1b73b30 100644 --- a/upstream/fedora-rawhide/man3/sd_event_source_set_priority.3 +++ b/upstream/fedora-rawhide/man3/sd_event_source_set_priority.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SOURCE_SET_PRIORITY" "3" "" "systemd 255" "sd_event_source_set_priority" +.TH "SD_EVENT_SOURCE_SET_PRIORITY" "3" "" "systemd 256~rc3" "sd_event_source_set_priority" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -122,10 +122,4 @@ and were added in version 229\&. .SH "SEE ALSO" .PP -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3) +\fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_source_set_ratelimit.3 b/upstream/fedora-rawhide/man3/sd_event_source_set_ratelimit.3 index 749efcc2..46dc6362 100644 --- a/upstream/fedora-rawhide/man3/sd_event_source_set_ratelimit.3 +++ b/upstream/fedora-rawhide/man3/sd_event_source_set_ratelimit.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SOURCE_SET_RATELIMIT" "3" "" "systemd 255" "sd_event_source_set_ratelimit" +.TH "SD_EVENT_SOURCE_SET_RATELIMIT" "3" "" "systemd 256~rc3" "sd_event_source_set_ratelimit" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -138,10 +138,4 @@ was added in version 250\&. was added in version 254\&. .SH "SEE ALSO" .PP -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_enabled\fR(3) +\fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_enabled\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_source_set_userdata.3 b/upstream/fedora-rawhide/man3/sd_event_source_set_userdata.3 index b5692b7a..9cebda97 100644 --- a/upstream/fedora-rawhide/man3/sd_event_source_set_userdata.3 +++ b/upstream/fedora-rawhide/man3/sd_event_source_set_userdata.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SOURCE_SET_USERDATA" "3" "" "systemd 255" "sd_event_source_set_userdata" +.TH "SD_EVENT_SOURCE_SET_USERDATA" "3" "" "systemd 256~rc3" "sd_event_source_set_userdata" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -76,11 +76,4 @@ and were added in version 229\&. .SH "SEE ALSO" .PP -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_description\fR(3) +\fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_description\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_event_source_unref.3 b/upstream/fedora-rawhide/man3/sd_event_source_unref.3 index 5c16c29f..53b7a609 100644 --- a/upstream/fedora-rawhide/man3/sd_event_source_unref.3 +++ b/upstream/fedora-rawhide/man3/sd_event_source_unref.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_SOURCE_UNREF" "3" "" "systemd 255" "sd_event_source_unref" +.TH "SD_EVENT_SOURCE_UNREF" "3" "" "systemd 256~rc3" "sd_event_source_unref" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -124,14 +124,7 @@ and were added in version 243\&. .SH "SEE ALSO" .PP -\fBsd-event\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_source_set_enabled\fR(3) +\fBsd-event\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_enabled\fR(3) .SH "NOTES" .IP " 1." 4 Clean-up Variable Attribute diff --git a/upstream/fedora-rawhide/man3/sd_event_wait.3 b/upstream/fedora-rawhide/man3/sd_event_wait.3 index 8176dadb..81d8176d 100644 --- a/upstream/fedora-rawhide/man3/sd_event_wait.3 +++ b/upstream/fedora-rawhide/man3/sd_event_wait.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_EVENT_WAIT" "3" "" "systemd 255" "sd_event_wait" +.TH "SD_EVENT_WAIT" "3" "" "systemd 256~rc3" "sd_event_wait" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -286,25 +286,13 @@ from an early phase of the program when no other threads have been started\&. .SH "HISTORY" .PP \fBsd_event_prepare()\fR, -\fBsd_event_wait()\fR, and -\fBsd_event_dispatch()\fR -were added in version 220\&. -.PP +\fBsd_event_wait()\fR, +\fBsd_event_dispatch()\fR, and \fBsd_event_get_state()\fR -was added in version 229\&. +were added in version 221\&. .PP \fBsd_event_get_iteration()\fR was added in version 231\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd_event_new\fR(3), -\fBsd_event_add_io\fR(3), -\fBsd_event_add_time\fR(3), -\fBsd_event_add_signal\fR(3), -\fBsd_event_add_child\fR(3), -\fBsd_event_add_inotify\fR(3), -\fBsd_event_add_defer\fR(3), -\fBsd_event_run\fR(3), -\fBsd_event_get_fd\fR(3), -\fBsd_event_source_set_prepare\fR(3) +\fBsystemd\fR(1), \fBsd_event_new\fR(3), \fBsd_event_add_io\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_run\fR(3), \fBsd_event_get_fd\fR(3), \fBsd_event_source_set_prepare\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_get_seats.3 b/upstream/fedora-rawhide/man3/sd_get_seats.3 index a20ff52c..3f03e38b 100644 --- a/upstream/fedora-rawhide/man3/sd_get_seats.3 +++ b/upstream/fedora-rawhide/man3/sd_get_seats.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_GET_SEATS" "3" "" "systemd 255" "sd_get_seats" +.TH "SD_GET_SEATS" "3" "" "systemd 256~rc3" "sd_get_seats" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -94,6 +94,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 203\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-login\fR(3), -\fBsd_session_get_seat\fR(3) +\fBsystemd\fR(1), \fBsd-login\fR(3), \fBsd_session_get_seat\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_hwdb_get.3 b/upstream/fedora-rawhide/man3/sd_hwdb_get.3 index 2a6d51ee..d198bad8 100644 --- a/upstream/fedora-rawhide/man3/sd_hwdb_get.3 +++ b/upstream/fedora-rawhide/man3/sd_hwdb_get.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_HWDB_GET" "3" "" "systemd 255" "sd_hwdb_get" +.TH "SD_HWDB_GET" "3" "" "systemd 256~rc3" "sd_hwdb_get" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -140,18 +140,19 @@ from an early phase of the program when no other threads have been started\&. .nf /* SPDX\-License\-Identifier: MIT\-0 */ +#define _GNU_SOURCE 1 #include <stdio\&.h> #include <stdint\&.h> -#include <sd\-hwdb\&.h> +#include <systemd/sd\-hwdb\&.h> int print_usb_properties(uint16_t vid, uint16_t pid) { - char match[STRLEN("usb:vp") + DECIMAL_STR_MAX(uint16_t) * 2]; + char match[128]; sd_hwdb *hwdb; const char *key, *value; int r; /* Match this USB vendor and product ID combination */ - xsprintf(match, "usb:v%04Xp%04X", vid, pid); + snprintf(match, sizeof match, "usb:v%04Xp%04X", vid, pid); r = sd_hwdb_new(&hwdb); if (r < 0) @@ -184,7 +185,4 @@ The effect is similar to calling were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-udevd.service\fR(8), -\fBsd-hwdb\fR(3), -\fBsystemd-hwdb\fR(8) +\fBsystemd\fR(1), \fBsystemd-udevd.service\fR(8), \fBsd-hwdb\fR(3), \fBsystemd-hwdb\fR(8) diff --git a/upstream/fedora-rawhide/man3/sd_hwdb_new.3 b/upstream/fedora-rawhide/man3/sd_hwdb_new.3 index 11e62140..c9be4705 100644 --- a/upstream/fedora-rawhide/man3/sd_hwdb_new.3 +++ b/upstream/fedora-rawhide/man3/sd_hwdb_new.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_HWDB_NEW" "3" "" "systemd 255" "sd_hwdb_new" +.TH "SD_HWDB_NEW" "3" "" "systemd 256~rc3" "sd_hwdb_new" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -125,7 +125,4 @@ were added in version 246\&. was added in version 252\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-udevd.service\fR(8), -\fBsd-hwdb\fR(3), -\fBsystemd-hwdb\fR(3) +\fBsystemd\fR(1), \fBsystemd-udevd.service\fR(8), \fBsd-hwdb\fR(3), \fBsystemd-hwdb\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_id128_get_machine.3 b/upstream/fedora-rawhide/man3/sd_id128_get_machine.3 index dc12a935..dad65f5e 100644 --- a/upstream/fedora-rawhide/man3/sd_id128_get_machine.3 +++ b/upstream/fedora-rawhide/man3/sd_id128_get_machine.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_ID128_GET_MACHINE" "3" "" "systemd 255" "sd_id128_get_machine" +.TH "SD_ID128_GET_MACHINE" "3" "" "systemd 256~rc3" "sd_id128_get_machine" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -40,6 +40,8 @@ sd_id128_get_machine, sd_id128_get_app_specific, sd_id128_get_machine_app_specif .BI "int sd_id128_get_boot_app_specific(sd_id128_t\ " "app_id" ", sd_id128_t\ *" "ret" ");" .HP \w'int\ sd_id128_get_invocation('u .BI "int sd_id128_get_invocation(sd_id128_t\ *" "ret" ");" +.HP \w'int\ sd_id128_get_invocation_app_specific('u +.BI "int sd_id128_get_invocation_app_specific(sd_id128_t\ " "app_id" ", sd_id128_t\ *" "ret" ");" .SH "DESCRIPTION" .PP \fBsd_id128_get_machine()\fR @@ -120,11 +122,16 @@ See \fBsystemd.exec\fR(5) for details\&. The ID is cached internally\&. In future a different mechanism to determine the invocation ID may be added\&. .PP +\fBsd_id128_get_invocation_app_specific()\fR +derives an application\-specific ID from the invocation ID\&. +.PP Note that \fBsd_id128_get_machine_app_specific()\fR, \fBsd_id128_get_boot()\fR, -\fBsd_id128_get_boot_app_specific()\fR, and +\fBsd_id128_get_boot_app_specific()\fR, \fBsd_id128_get_invocation()\fR +and +\fBsd_id128_get_invocation_app_specific\fR always return UUID Variant 1 Version 4 compatible IDs\&. \fBsd_id128_get_machine()\fR will also return a UUID Variant 1 Version 4 compatible ID on new installations but might not on older\&. It is possible to convert the machine ID non\-reversibly into a UUID Variant 1 Version 4 compatible one\&. For more information, see @@ -306,15 +313,12 @@ was added in version 240\&. .PP \fBsd_id128_get_app_specific()\fR was added in version 255\&. +.PP +\fBsd_id128_get_invocation_app_specific()\fR +was added in version 256\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-id128\fR(1), -\fBsd-id128\fR(3), -\fBmachine-id\fR(5), -\fBsystemd.exec\fR(5), -\fBsd_id128_randomize\fR(3), -\fBrandom\fR(4) +\fBsystemd\fR(1), \fBsystemd-id128\fR(1), \fBsd-id128\fR(3), \fBmachine-id\fR(5), \fBsystemd.exec\fR(5), \fBsd_id128_randomize\fR(3), \fBrandom\fR(4) .SH "NOTES" .IP " 1." 4 RFC 4122 diff --git a/upstream/fedora-rawhide/man3/sd_id128_randomize.3 b/upstream/fedora-rawhide/man3/sd_id128_randomize.3 index 0292ec8e..3e2b011a 100644 --- a/upstream/fedora-rawhide/man3/sd_id128_randomize.3 +++ b/upstream/fedora-rawhide/man3/sd_id128_randomize.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_ID128_RANDOMIZE" "3" "" "systemd 255" "sd_id128_randomize" +.TH "SD_ID128_RANDOMIZE" "3" "" "systemd 256~rc3" "sd_id128_randomize" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -75,9 +75,4 @@ from an early phase of the program when no other threads have been started\&. was added in version 187\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-id128\fR(3), -\fBmachine-id\fR(5), -\fBgetrandom\fR(2), -\fBrandom\fR(4), -\fBsd_id128_get_machine\fR(3) +\fBsystemd\fR(1), \fBsd-id128\fR(3), \fBmachine-id\fR(5), \fBgetrandom\fR(2), \fBrandom\fR(4), \fBsd_id128_get_machine\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_id128_to_string.3 b/upstream/fedora-rawhide/man3/sd_id128_to_string.3 index 33161959..8ada42b6 100644 --- a/upstream/fedora-rawhide/man3/sd_id128_to_string.3 +++ b/upstream/fedora-rawhide/man3/sd_id128_to_string.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_ID128_TO_STRING" "3" "" "systemd 255" "sd_id128_to_string" +.TH "SD_ID128_TO_STRING" "3" "" "systemd 256~rc3" "sd_id128_to_string" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -133,9 +133,7 @@ were added in version 187\&. was added in version 251\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-id128\fR(3), -\fBprintf\fR(3) +\fBsystemd\fR(1), \fBsd-id128\fR(3), \fBprintf\fR(3) .SH "NOTES" .IP " 1." 4 RFC4122 diff --git a/upstream/fedora-rawhide/man3/sd_is_fifo.3 b/upstream/fedora-rawhide/man3/sd_is_fifo.3 index 76736e7d..fdce103e 100644 --- a/upstream/fedora-rawhide/man3/sd_is_fifo.3 +++ b/upstream/fedora-rawhide/man3/sd_is_fifo.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_IS_FIFO" "3" "" "systemd 255" "sd_is_fifo" +.TH "SD_IS_FIFO" "3" "" "systemd 256~rc3" "sd_is_fifo" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -156,14 +156,4 @@ was added in version 209\&. was added in version 233\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-daemon\fR(3), -\fBsd_listen_fds\fR(3), -\fBsystemd.service\fR(5), -\fBsystemd.socket\fR(5), -\fBip\fR(7), -\fBipv6\fR(7), -\fBunix\fR(7), -\fBfifo\fR(7), -\fBmq_overview\fR(7), -\fBsocket\fR(7)\&. +\fBsystemd\fR(1), \fBsd-daemon\fR(3), \fBsd_listen_fds\fR(3), \fBsystemd.service\fR(5), \fBsystemd.socket\fR(5), \fBip\fR(7), \fBipv6\fR(7), \fBunix\fR(7), \fBfifo\fR(7), \fBmq_overview\fR(7), \fBsocket\fR(7)\&. diff --git a/upstream/fedora-rawhide/man3/sd_journal_add_match.3 b/upstream/fedora-rawhide/man3/sd_journal_add_match.3 index c8221e50..ceb2a477 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_add_match.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_add_match.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_ADD_MATCH" "3" "" "systemd 255" "sd_journal_add_match" +.TH "SD_JOURNAL_ADD_MATCH" "3" "" "systemd 256~rc3" "sd_journal_add_match" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -152,9 +152,4 @@ were added in version 187\&. was added in version 202\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_next\fR(3), -\fBsd_journal_get_data\fR(3), -\fBsystemd.journal-fields\fR(7) +\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_next\fR(3), \fBsd_journal_get_data\fR(3), \fBsystemd.journal-fields\fR(7) diff --git a/upstream/fedora-rawhide/man3/sd_journal_enumerate_fields.3 b/upstream/fedora-rawhide/man3/sd_journal_enumerate_fields.3 index 27ab5f29..ad446470 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_enumerate_fields.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_enumerate_fields.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_ENUMERATE_FIELDS" "3" "" "systemd 255" "sd_journal_enumerate_fields" +.TH "SD_JOURNAL_ENUMERATE_FIELDS" "3" "" "systemd 256~rc3" "sd_journal_enumerate_fields" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -95,8 +95,7 @@ int main(int argc, char *argv[]) { r = sd_journal_open(&j, SD_JOURNAL_LOCAL_ONLY); if (r < 0) { - errno = \-r; - fprintf(stderr, "Failed to open journal: %m\en"); + fprintf(stderr, "Failed to open journal: %s\en", strerror(\-r)); return 1; } SD_JOURNAL_FOREACH_FIELD(j, field) @@ -116,10 +115,4 @@ int main(int argc, char *argv[]) { were added in version 229\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.journal-fields\fR(7), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_query_unique\fR(3), -\fBsd_journal_get_data\fR(3), -\fBsd_journal_add_match\fR(3) +\fBsystemd\fR(1), \fBsystemd.journal-fields\fR(7), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_query_unique\fR(3), \fBsd_journal_get_data\fR(3), \fBsd_journal_add_match\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_journal_get_catalog.3 b/upstream/fedora-rawhide/man3/sd_journal_get_catalog.3 index e352fafc..6c79581f 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_get_catalog.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_get_catalog.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_GET_CATALOG" "3" "" "systemd 255" "sd_journal_get_catalog" +.TH "SD_JOURNAL_GET_CATALOG" "3" "" "systemd 256~rc3" "sd_journal_get_catalog" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -79,13 +79,7 @@ and were added in version 196\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.journal-fields\fR(7), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_next\fR(3), -\fBsd_journal_get_data\fR(3), -\fBmalloc\fR(3) +\fBsystemd\fR(1), \fBsystemd.journal-fields\fR(7), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_next\fR(3), \fBsd_journal_get_data\fR(3), \fBmalloc\fR(3) .SH "NOTES" .IP " 1." 4 Journal Message Catalogs diff --git a/upstream/fedora-rawhide/man3/sd_journal_get_cursor.3 b/upstream/fedora-rawhide/man3/sd_journal_get_cursor.3 index 82d21b07..203a1341 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_get_cursor.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_get_cursor.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_GET_CURSOR" "3" "" "systemd 255" "sd_journal_get_cursor" +.TH "SD_JOURNAL_GET_CURSOR" "3" "" "systemd 256~rc3" "sd_journal_get_cursor" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -41,16 +41,17 @@ returns a cursor string for the current journal entry\&. A cursor is a serializa and should be freed after use with \fBfree\fR(3)\&. .PP +\fBsd_journal_test_cursor()\fR +may be used to check whether the current position in the journal matches the specified cursor\&. This is useful since cursor strings do not uniquely identify an entry: the same entry might be referred to by multiple different cursor strings, and hence string comparing cursors is not possible\&. Use this call to verify after an invocation of +\fBsd_journal_seek_cursor\fR(3), whether the entry being sought to was actually found in the journal or the next closest entry was used instead\&. +.PP Note that \fBsd_journal_get_cursor()\fR +and +\fBsd_journal_test_cursor()\fR will not work before \fBsd_journal_next\fR(3) -(or related call) has been called at least once, in order to position the read pointer at a valid entry\&. -.PP -\fBsd_journal_test_cursor()\fR -may be used to check whether the current position in the journal matches the specified cursor\&. This is useful since cursor strings do not uniquely identify an entry: the same entry might be referred to by multiple different cursor strings, and hence string comparing cursors is not possible\&. Use this call to verify after an invocation of -\fBsd_journal_seek_cursor\fR(3) -whether the entry being sought to was actually found in the journal or the next closest entry was used instead\&. +(or one of the other functions which move to an entry) has been called at least once to position the read pointer at a valid entry\&. .SH "RETURN VALUE" .PP \fBsd_journal_get_cursor()\fR @@ -73,7 +74,4 @@ was added in version 187\&. was added in version 195\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_seek_cursor\fR(3) +\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_seek_cursor\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_journal_get_cutoff_realtime_usec.3 b/upstream/fedora-rawhide/man3/sd_journal_get_cutoff_realtime_usec.3 index 6563d232..93ab4814 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_get_cutoff_realtime_usec.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_get_cutoff_realtime_usec.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_GET_CUTOFF_REALTIME_USEC" "3" "" "systemd 255" "sd_journal_get_cutoff_realtime_usec" +.TH "SD_JOURNAL_GET_CUTOFF_REALTIME_USEC" "3" "" "systemd 256~rc3" "sd_journal_get_cutoff_realtime_usec" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -85,9 +85,4 @@ and were added in version 187\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_get_realtime_usec\fR(3), -\fBsd_id128_get_boot\fR(3), -\fBclock_gettime\fR(2) +\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_get_realtime_usec\fR(3), \fBsd_id128_get_boot\fR(3), \fBclock_gettime\fR(2) diff --git a/upstream/fedora-rawhide/man3/sd_journal_get_data.3 b/upstream/fedora-rawhide/man3/sd_journal_get_data.3 index 4d46b1f5..ebafd301 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_get_data.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_get_data.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_GET_DATA" "3" "" "systemd 255" "sd_journal_get_data" +.TH "SD_JOURNAL_GET_DATA" "3" "" "systemd 256~rc3" "sd_journal_get_data" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -230,10 +230,4 @@ were added in version 196\&. was added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.journal-fields\fR(7), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_next\fR(3), -\fBsd_journal_get_realtime_usec\fR(3), -\fBsd_journal_query_unique\fR(3) +\fBsystemd\fR(1), \fBsystemd.journal-fields\fR(7), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_next\fR(3), \fBsd_journal_get_realtime_usec\fR(3), \fBsd_journal_query_unique\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_journal_get_fd.3 b/upstream/fedora-rawhide/man3/sd_journal_get_fd.3 index 1a48a211..9b6208e3 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_get_fd.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_get_fd.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_GET_FD" "3" "" "systemd 255" "sd_journal_get_fd" +.TH "SD_JOURNAL_GET_FD" "3" "" "systemd 256~rc3" "sd_journal_get_fd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -250,39 +250,38 @@ Iterating through the journal, in a live view tracking all changes: int main(int argc, char *argv[]) { int r; sd_journal *j; + r = sd_journal_open(&j, SD_JOURNAL_LOCAL_ONLY); if (r < 0) { - errno = \-r; - fprintf(stderr, "Failed to open journal: %m\en"); + fprintf(stderr, "Failed to open journal: %s\en", strerror(\-r)); return 1; } + for (;;) { const void *d; size_t l; r = sd_journal_next(j); if (r < 0) { - errno = \-r; - fprintf(stderr, "Failed to iterate to next entry: %m\en"); + fprintf(stderr, "Failed to iterate to next entry: %s\en", strerror(\-r)); break; } if (r == 0) { /* Reached the end, let\*(Aqs wait for changes, and try again */ r = sd_journal_wait(j, (uint64_t) \-1); if (r < 0) { - errno = \-r; - fprintf(stderr, "Failed to wait for changes: %m\en"); + fprintf(stderr, "Failed to wait for changes: %s\en", strerror(\-r)); break; } continue; } r = sd_journal_get_data(j, "MESSAGE", &d, &l); if (r < 0) { - errno = \-r; - fprintf(stderr, "Failed to read message field: %m\en"); + fprintf(stderr, "Failed to read message field: %s\en", strerror(\-r)); continue; } printf("%\&.*s\en", (int) l, (const char*) d); } + sd_journal_close(j); return 0; } @@ -301,6 +300,7 @@ Waiting with .nf /* SPDX\-License\-Identifier: MIT\-0 */ +#define _GNU_SOURCE 1 #include <poll\&.h> #include <time\&.h> #include <systemd/sd\-journal\&.h> @@ -346,9 +346,4 @@ and were added in version 201\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_next\fR(3), -\fBpoll\fR(2), -\fBclock_gettime\fR(2) +\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_next\fR(3), \fBpoll\fR(2), \fBclock_gettime\fR(2) diff --git a/upstream/fedora-rawhide/man3/sd_journal_get_realtime_usec.3 b/upstream/fedora-rawhide/man3/sd_journal_get_realtime_usec.3 index f894cc69..ab338944 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_get_realtime_usec.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_get_realtime_usec.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_GET_REALTIME_USEC" "3" "" "systemd 255" "sd_journal_get_realtime_usec" +.TH "SD_JOURNAL_GET_REALTIME_USEC" "3" "" "systemd 256~rc3" "sd_journal_get_realtime_usec" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -74,12 +74,4 @@ and were added in version 187\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_next\fR(3), -\fBsd_journal_get_data\fR(3), -\fBsd_journal_get_seqnum\fR(3), -\fBsd_id128_get_boot\fR(3), -\fBclock_gettime\fR(2), -\fBsd_journal_get_cutoff_realtime_usec\fR(3) +\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_next\fR(3), \fBsd_journal_get_data\fR(3), \fBsd_journal_get_seqnum\fR(3), \fBsd_id128_get_boot\fR(3), \fBclock_gettime\fR(2), \fBsd_journal_get_cutoff_realtime_usec\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_journal_get_seqnum.3 b/upstream/fedora-rawhide/man3/sd_journal_get_seqnum.3 index e29fd1b2..e6a6e6b4 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_get_seqnum.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_get_seqnum.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_GET_SEQNUM" "3" "" "systemd 255" "sd_journal_get_seqnum" +.TH "SD_JOURNAL_GET_SEQNUM" "3" "" "systemd 256~rc3" "sd_journal_get_seqnum" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -83,9 +83,4 @@ file\&. was added in version 254\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_next\fR(3), -\fBsd_journal_get_data\fR(3), -\fBsd_journal_get_monotonic_usec\fR(3) +\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_next\fR(3), \fBsd_journal_get_data\fR(3), \fBsd_journal_get_monotonic_usec\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_journal_get_usage.3 b/upstream/fedora-rawhide/man3/sd_journal_get_usage.3 index 9fc640d1..48682fd9 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_get_usage.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_get_usage.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_GET_USAGE" "3" "" "systemd 255" "sd_journal_get_usage" +.TH "SD_JOURNAL_GET_USAGE" "3" "" "systemd 256~rc3" "sd_journal_get_usage" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -53,6 +53,4 @@ file\&. was added in version 190\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), +\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_journal_has_runtime_files.3 b/upstream/fedora-rawhide/man3/sd_journal_has_runtime_files.3 index e577c467..44235a1f 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_has_runtime_files.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_has_runtime_files.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_HAS_RUNTIME_FILES" "3" "" "systemd 255" "sd_journal_has_runtime_files" +.TH "SD_JOURNAL_HAS_RUNTIME_FILES" "3" "" "systemd 256~rc3" "sd_journal_has_runtime_files" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man3/sd_journal_next.3 b/upstream/fedora-rawhide/man3/sd_journal_next.3 index 535266b6..fbb4bd6d 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_next.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_next.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_NEXT" "3" "" "systemd 255" "sd_journal_next" +.TH "SD_JOURNAL_NEXT" "3" "" "systemd 256~rc3" "sd_journal_next" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -129,10 +129,10 @@ Iterating through the journal: int main(int argc, char *argv[]) { int r; sd_journal *j; + r = sd_journal_open(&j, SD_JOURNAL_LOCAL_ONLY); if (r < 0) { - errno = \-r; - fprintf(stderr, "Failed to open journal: %m\en"); + fprintf(stderr, "Failed to open journal: %s\en", strerror(\-r)); return 1; } SD_JOURNAL_FOREACH(j) { @@ -141,8 +141,7 @@ int main(int argc, char *argv[]) { r = sd_journal_get_data(j, "MESSAGE", (const void **)&d, &l); if (r < 0) { - errno = \-r; - fprintf(stderr, "Failed to read message field: %m\en"); + fprintf(stderr, "Failed to read message field: %s\en", strerror(\-r)); continue; } @@ -169,9 +168,4 @@ were added in version 187\&. was added in version 254\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_get_data\fR(3), -\fBsd_journal_get_realtime_usec\fR(3), -\fBsd_journal_get_cursor\fR(3) +\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_get_data\fR(3), \fBsd_journal_get_realtime_usec\fR(3), \fBsd_journal_get_cursor\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_journal_open.3 b/upstream/fedora-rawhide/man3/sd_journal_open.3 index 9562a15c..c5400324 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_open.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_open.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_OPEN" "3" "" "systemd 255" "sd_journal_open" +.TH "SD_JOURNAL_OPEN" "3" "" "systemd 256~rc3" "sd_journal_open" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -192,8 +192,4 @@ were added in version 230\&. was added in version 245\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-journal\fR(3), -\fBsystemd-journald.service\fR(8), -\fBsd_journal_next\fR(3), -\fBsd_journal_get_data\fR(3) +\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsystemd-journald.service\fR(8), \fBsd_journal_next\fR(3), \fBsd_journal_get_data\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_journal_print.3 b/upstream/fedora-rawhide/man3/sd_journal_print.3 index 890816bb..63c9007d 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_print.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_print.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_PRINT" "3" "" "systemd 255" "sd_journal_print" +.TH "SD_JOURNAL_PRINT" "3" "" "systemd 256~rc3" "sd_journal_print" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -221,15 +221,7 @@ was added in version 188\&. were added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-journal\fR(3), -\fBsd_journal_stream_fd\fR(3), -\fBsyslog\fR(3), -\fBperror\fR(3), -\fBerrno\fR(3), -\fBsystemd.journal-fields\fR(7), -\fBsignal\fR(7), -\fBsocket\fR(7) +\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsd_journal_stream_fd\fR(3), \fBsyslog\fR(3), \fBperror\fR(3), \fBerrno\fR(3), \fBsystemd.journal-fields\fR(7), \fBsignal\fR(7), \fBsocket\fR(7) .SH "NOTES" .IP " 1." 4 Native Journal Protocol diff --git a/upstream/fedora-rawhide/man3/sd_journal_query_unique.3 b/upstream/fedora-rawhide/man3/sd_journal_query_unique.3 index bfedb59c..8164ace7 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_query_unique.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_query_unique.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_QUERY_UNIQUE" "3" "" "systemd 255" "sd_journal_query_unique" +.TH "SD_JOURNAL_QUERY_UNIQUE" "3" "" "systemd 256~rc3" "sd_journal_query_unique" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -191,14 +191,12 @@ int main(int argc, char *argv[]) { r = sd_journal_open(&j, SD_JOURNAL_LOCAL_ONLY); if (r < 0) { - errno = \-r; - fprintf(stderr, "Failed to open journal: %m\en"); + fprintf(stderr, "Failed to open journal: %s\en", strerror(\-r)); return 1; } r = sd_journal_query_unique(j, "_SYSTEMD_UNIT"); if (r < 0) { - errno = \-r; - fprintf(stderr, "Failed to query journal: %m\en"); + fprintf(stderr, "Failed to query journal: %s\en", strerror(\-r)); return 1; } SD_JOURNAL_FOREACH_UNIQUE(j, d, l) @@ -222,10 +220,4 @@ were added in version 195\&. was added in version 246\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.journal-fields\fR(7), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_enumerate_fields\fR(3), -\fBsd_journal_get_data\fR(3), -\fBsd_journal_add_match\fR(3) +\fBsystemd\fR(1), \fBsystemd.journal-fields\fR(7), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_enumerate_fields\fR(3), \fBsd_journal_get_data\fR(3), \fBsd_journal_add_match\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_journal_seek_head.3 b/upstream/fedora-rawhide/man3/sd_journal_seek_head.3 index 08c83b87..c4fe4fc9 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_seek_head.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_seek_head.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_SEEK_HEAD" "3" "" "systemd 255" "sd_journal_seek_head" +.TH "SD_JOURNAL_SEEK_HEAD" "3" "" "systemd 256~rc3" "sd_journal_seek_head" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -57,8 +57,7 @@ seeks to a position with the specified realtime (wallclock) timestamp, i\&.e\&. .PP \fBsd_journal_seek_cursor()\fR seeks to the position at the specified cursor string\&. For details on cursors, see -\fBsd_journal_get_cursor\fR(3)\&. If no entry matching the specified cursor is found the call will seek to the next closest entry (in terms of time) instead\&. To verify whether the newly selected entry actually matches the cursor, use -\fBsd_journal_test_cursor\fR(3)\&. +\fBsd_journal_get_cursor\fR(3)\&. If no entry matching the specified cursor is found the call will seek to the next closest entry (in terms of time) instead\&. .PP Note that these calls do not actually make any entry the new current entry, this needs to be done in a separate step with a subsequent \fBsd_journal_next\fR(3) @@ -70,6 +69,12 @@ or an entry cursor be retrieved via is used, the closest following entry will be sought to, if \fBsd_journal_previous\fR(3) is used the closest preceding entry is sought to\&. +.PP +After the seek is done, and +\fBsd_journal_next\fR(3) +or a similar call has been made, +\fBsd_journal_test_cursor\fR(3) +may be used to verify whether the newly selected entry actually matches the cursor\&. .SH "RETURN VALUE" .PP The functions return 0 on success or a negative errno\-style error code\&. @@ -90,10 +95,4 @@ file\&. were added in version 187\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-journal\fR(3), -\fBsd_journal_open\fR(3), -\fBsd_journal_next\fR(3), -\fBsd_journal_get_data\fR(3), -\fBsd_journal_get_cursor\fR(3), -\fBsd_journal_get_realtime_usec\fR(3) +\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_next\fR(3), \fBsd_journal_get_data\fR(3), \fBsd_journal_get_cursor\fR(3), \fBsd_journal_get_realtime_usec\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_journal_stream_fd.3 b/upstream/fedora-rawhide/man3/sd_journal_stream_fd.3 index f505e221..8642d2ef 100644 --- a/upstream/fedora-rawhide/man3/sd_journal_stream_fd.3 +++ b/upstream/fedora-rawhide/man3/sd_journal_stream_fd.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_JOURNAL_STREAM_FD" "3" "" "systemd 255" "sd_journal_stream_fd" +.TH "SD_JOURNAL_STREAM_FD" "3" "" "systemd 256~rc3" "sd_journal_stream_fd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,7 +20,7 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -sd_journal_stream_fd \- Create log stream file descriptor to the journal +sd_journal_stream_fd, sd_journal_stream_fd_with_namespace \- Create log stream file descriptor to the journal .SH "SYNOPSIS" .sp .ft B @@ -30,6 +30,8 @@ sd_journal_stream_fd \- Create log stream file descriptor to the journal .ft .HP \w'int\ sd_journal_stream_fd('u .BI "int sd_journal_stream_fd(const\ char\ *" "identifier" ", int\ " "priority" ", int\ " "level_prefix" ");" +.HP \w'int\ sd_journal_stream_fd_with_namespace('u +.BI "int sd_journal_stream_fd_with_namespace(const\ char\ *" "name_space" ", const\ char\ *" "identifier" ", int\ " "priority" ", int\ " "level_prefix" ");" .SH "DESCRIPTION" .PP \fBsd_journal_stream_fd()\fR @@ -54,11 +56,19 @@ for details\&. The third argument is a boolean: if true kernel\-style log level \fBsd-daemon\fR(3) for more information\&. .PP +\fBsd_journal_stream_fd_with_namespace()\fR +is similar to +\fBsd_journal_stream_fd()\fR, but takes an additional +\fIname_space\fR +parameter that specifies which journal namespace to operate on\&. If specified as +\fBNULL\fR +the call is identical to +\fBsd_journal_stream_fd()\fR\&. For details about journal namespaces, see +\fBsystemd-journald.service\fR(8)\&. +.PP It is recommended that applications log UTF\-8 messages only with this API, but this is not enforced\&. .PP -Each invocation of -\fBsd_journal_stream_fd()\fR -allocates a new log stream file descriptor, that is not shared with prior or later invocations\&. The file descriptor is write\-only (its reading direction is shut down), and +Each invocation of these functions allocates a new log stream file descriptor, that is not shared with prior or later invocations\&. The file descriptor is write\-only (its reading direction is shut down), and \fBO_NONBLOCK\fR is turned off initially\&. .SH "RETURN VALUE" @@ -67,7 +77,9 @@ The call returns a valid write\-only file descriptor on success or a negative er .SH "SIGNAL SAFETY" .PP \fBsd_journal_stream_fd()\fR -is "async signal safe" in the meaning of +and +\fBsd_journal_stream_fd_with_namespace()\fR +are "async signal safe" in the meaning of \fBsignal-safety\fR(7)\&. .SH "NOTES" .PP @@ -87,6 +99,7 @@ Creating a log stream suitable for .nf /* SPDX\-License\-Identifier: MIT\-0 */ +#define _GNU_SOURCE 1 #include <errno\&.h> #include <syslog\&.h> #include <stdio\&.h> @@ -97,15 +110,16 @@ Creating a log stream suitable for int main(int argc, char *argv[]) { int fd; FILE *log; + fd = sd_journal_stream_fd("test", LOG_INFO, 1); if (fd < 0) { - errno = \-fd; - fprintf(stderr, "Failed to create stream fd: %m\en"); + fprintf(stderr, "Failed to create stream fd: %s\en", strerror(\-fd)); return 1; } + log = fdopen(fd, "w"); if (!log) { - fprintf(stderr, "Failed to create file object: %m\en"); + fprintf(stderr, "Failed to create file object: %s\en", strerror(errno)); close(fd); return 1; } @@ -122,12 +136,9 @@ int main(int argc, char *argv[]) { .PP \fBsd_journal_stream_fd()\fR was added in version 187\&. +.PP +\fBsd_journal_stream_fd_with_namespace()\fR +was added in version 256\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-journal\fR(3), -\fBsd-daemon\fR(3), -\fBsd_journal_print\fR(3), -\fBsyslog\fR(3), -\fBfprintf\fR(3), -\fBsystemd.journal-fields\fR(7) +\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsd-daemon\fR(3), \fBsd_journal_print\fR(3), \fBsyslog\fR(3), \fBfprintf\fR(3), \fBsystemd.journal-fields\fR(7) diff --git a/upstream/fedora-rawhide/man3/sd_listen_fds.3 b/upstream/fedora-rawhide/man3/sd_listen_fds.3 index f57698b2..8ec70a2d 100644 --- a/upstream/fedora-rawhide/man3/sd_listen_fds.3 +++ b/upstream/fedora-rawhide/man3/sd_listen_fds.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_LISTEN_FDS" "3" "" "systemd 255" "sd_listen_fds" +.TH "SD_LISTEN_FDS" "3" "" "systemd 256~rc3" "sd_listen_fds" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -199,16 +199,7 @@ parses\&. See above for details\&. was added in version 227\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-daemon\fR(3), -\fBsd_is_fifo\fR(3), -\fBsd_is_socket\fR(3), -\fBsd_is_socket_inet\fR(3), -\fBsd_is_socket_unix\fR(3), -\fBsd_pid_notify_with_fds\fR(3), -\fBdaemon\fR(7), -\fBsystemd.service\fR(5), -\fBsystemd.socket\fR(5) +\fBsystemd\fR(1), \fBsd-daemon\fR(3), \fBsd_is_fifo\fR(3), \fBsd_is_socket\fR(3), \fBsd_is_socket_inet\fR(3), \fBsd_is_socket_unix\fR(3), \fBsd_pid_notify_with_fds\fR(3), \fBdaemon\fR(7), \fBsystemd.service\fR(5), \fBsystemd.socket\fR(5) .SH "NOTES" .IP " 1." 4 File Descriptor Store diff --git a/upstream/fedora-rawhide/man3/sd_login_monitor_new.3 b/upstream/fedora-rawhide/man3/sd_login_monitor_new.3 index ea4dafc0..b66134a7 100644 --- a/upstream/fedora-rawhide/man3/sd_login_monitor_new.3 +++ b/upstream/fedora-rawhide/man3/sd_login_monitor_new.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_LOGIN_MONITOR_NEW" "3" "" "systemd 255" "sd_login_monitor_new" +.TH "SD_LOGIN_MONITOR_NEW" "3" "" "systemd 256~rc3" "sd_login_monitor_new" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -218,11 +218,7 @@ were added in version 201\&. was added in version 229\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-login\fR(3), -\fBsd_get_seats\fR(3), -\fBpoll\fR(2), -\fBclock_gettime\fR(2) +\fBsystemd\fR(1), \fBsd-login\fR(3), \fBsd_get_seats\fR(3), \fBpoll\fR(2), \fBclock_gettime\fR(2) .SH "NOTES" .IP " 1." 4 Clean-up Variable Attribute diff --git a/upstream/fedora-rawhide/man3/sd_machine_get_class.3 b/upstream/fedora-rawhide/man3/sd_machine_get_class.3 index 82e402d3..108f96c6 100644 --- a/upstream/fedora-rawhide/man3/sd_machine_get_class.3 +++ b/upstream/fedora-rawhide/man3/sd_machine_get_class.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_MACHINE_GET_CLASS" "3" "" "systemd 255" "sd_machine_get_class" +.TH "SD_MACHINE_GET_CLASS" "3" "" "systemd 256~rc3" "sd_machine_get_class" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -96,7 +96,4 @@ and were added in version 217\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-login\fR(3), -\fBsystemd-machined.service\fR(8), -\fBsd_pid_get_machine_name\fR(3) +\fBsystemd\fR(1), \fBsd-login\fR(3), \fBsystemd-machined.service\fR(8), \fBsd_pid_get_machine_name\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_notify.3 b/upstream/fedora-rawhide/man3/sd_notify.3 index 204db883..dc26c47a 100644 --- a/upstream/fedora-rawhide/man3/sd_notify.3 +++ b/upstream/fedora-rawhide/man3/sd_notify.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_NOTIFY" "3" "" "systemd 255" "sd_notify" +.TH "SD_NOTIFY" "3" "" "systemd 256~rc3" "sd_notify" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -57,7 +57,7 @@ will unset the \fI$NOTIFY_SOCKET\fR environment variable before returning (regardless of whether the function call itself succeeded or not)\&. Further calls to \fBsd_notify()\fR -will then fail, and the variable is no longer inherited by child processes\&. +will then silently do nothing, and the variable is no longer inherited by child processes\&. .PP The \fIstate\fR @@ -223,7 +223,7 @@ The exit status of a service or the manager itself\&. Note that \fBsystemd\fR currently does not consume this value when sent by services, so this assignment is only informational\&. The manager will send this notification to \fIits\fR -notification socket, which may be used to to collect an exit status from the system (a container or VM) as it shuts down\&. For example, +notification socket, which may be used to collect an exit status from the system (a container or VM) as it shuts down\&. For example, \fBmkosi\fR(1) makes use of this\&. The value to return may be set via the \fBsystemctl\fR(1) @@ -367,7 +367,7 @@ Added in version 233\&. FDPOLL=0 .RS 4 When used in combination with -\fIFDSTORE=1\fR, disables polling of the stored file descriptors regardless of whether or not they are pollable\&. As this option disables automatic cleanup of the stored file descriptors on EPOLLERR and EPOLLHUP, care must be taken to ensure proper manual cleanup\&. Use of this option is not generally recommended except for when automatic cleanup has unwanted behavior such as prematurely discarding file descriptors from the store\&. +\fIFDSTORE=1\fR, disables polling of the submitted file descriptors regardless of whether or not they are pollable\&. As this option disables automatic cleanup of the submitted file descriptors on EPOLLERR and EPOLLHUP, care must be taken to ensure proper manual cleanup\&. Use of this option is not generally recommended except for when automatic cleanup has unwanted behavior such as prematurely discarding file descriptors from the store\&. .sp Added in version 246\&. .RE @@ -381,9 +381,13 @@ command will only happen after all previous notification messages sent before th Added in version 246\&. .RE .PP -The notification messages sent by services are interpreted by the service manager\&. Unknown assignments may be logged, but are otherwise ignored\&. Thus, it is not useful to send assignments which are not in this list\&. The service manager also sends some messages to +The notification messages sent by services are interpreted by the service manager\&. Unknown assignments are ignored\&. Thus, it is safe (but often without effect) to send assignments which are not in this list\&. The protocol is extensible, but care should be taken to ensure private extensions are recognizable as such\&. Specifically, it is recommend to prefix them with +"X_" +followed by some namespace identifier\&. The service manager also sends some messages to \fIits\fR -notification socket, which are then consumed by the machine or container manager\&. +notification socket, which may then consumed by a supervising machine or container manager further up the stack\&. The service manager sends a number of extension fields, for example +\fIX_SYSTEMD_UNIT_ACTIVE=\fR, for details see +\fBsystemd\fR(1)\&. .SH "RETURN VALUE" .PP On failure, these calls return a negative errno\-style error code\&. If @@ -422,9 +426,347 @@ address, which is useful for hypervisors/VMMs or other processes on the host to over \fBAF_VSOCK\fR, \fBSOCK_SEQPACKET\fR -will be used instead\&. The address should be in the form: +will be used instead\&. +"vsock\-stream", +"vsock\-dgram" +and +"vsock\-seqpacket" +can be used instead of +"vsock" +to force usage of the corresponding socket type\&. The address should be in the form: "vsock:CID:PORT"\&. Note that unlike other uses of vsock, the CID is mandatory and cannot be "VMADDR_CID_ANY"\&. Note that PID1 will send the VSOCK packets from a privileged port (i\&.e\&.: lower than 1024), as an attempt to address concerns that unprivileged processes in the guest might try to send malicious notifications to the host, driving it to make destructive decisions based on them\&. +.SS "Standalone Implementations" +.PP +Note that, while using this library should be preferred in order to avoid code duplication, it is also possible to reimplement the simple readiness notification protocol without external dependencies, as demonstrated in the following self\-contained examples from several languages: +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBC\fR +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +/* SPDX\-License\-Identifier: MIT\-0 */ + +/* Implement the systemd notify protocol without external dependencies\&. + * Supports both readiness notification on startup and on reloading, + * according to the protocol defined at: + * https://www\&.freedesktop\&.org/software/systemd/man/latest/sd_notify\&.html + * This protocol is guaranteed to be stable as per: + * https://systemd\&.io/PORTABILITY_AND_STABILITY/ */ + +#define _GNU_SOURCE 1 +#include <errno\&.h> +#include <inttypes\&.h> +#include <signal\&.h> +#include <stdbool\&.h> +#include <stddef\&.h> +#include <stdlib\&.h> +#include <stdio\&.h> +#include <sys/socket\&.h> +#include <sys/un\&.h> +#include <time\&.h> +#include <unistd\&.h> + +#define _cleanup_(f) __attribute__((cleanup(f))) + +static void closep(int *fd) { + if (!fd || *fd < 0) + return; + + close(*fd); + *fd = \-1; +} + +static int notify(const char *message) { + union sockaddr_union { + struct sockaddr sa; + struct sockaddr_un sun; + } socket_addr = { + \&.sun\&.sun_family = AF_UNIX, + }; + size_t path_length, message_length; + _cleanup_(closep) int fd = \-1; + const char *socket_path; + + /* Verify the argument first */ + if (!message) + return \-EINVAL; + + message_length = strlen(message); + if (message_length == 0) + return \-EINVAL; + + /* If the variable is not set, the protocol is a noop */ + socket_path = getenv("NOTIFY_SOCKET"); + if (!socket_path) + return 0; /* Not set? Nothing to do */ + + /* Only AF_UNIX is supported, with path or abstract sockets */ + if (socket_path[0] != \*(Aq/\*(Aq && socket_path[0] != \*(Aq@\*(Aq) + return \-EAFNOSUPPORT; + + path_length = strlen(socket_path); + /* Ensure there is room for NUL byte */ + if (path_length >= sizeof(socket_addr\&.sun\&.sun_path)) + return \-E2BIG; + + memcpy(socket_addr\&.sun\&.sun_path, socket_path, path_length); + + /* Support for abstract socket */ + if (socket_addr\&.sun\&.sun_path[0] == \*(Aq@\*(Aq) + socket_addr\&.sun\&.sun_path[0] = 0; + + fd = socket(AF_UNIX, SOCK_DGRAM|SOCK_CLOEXEC, 0); + if (fd < 0) + return \-errno; + + if (connect(fd, &socket_addr\&.sa, offsetof(struct sockaddr_un, sun_path) + path_length) != 0) + return \-errno; + + ssize_t written = write(fd, message, message_length); + if (written != (ssize_t) message_length) + return written < 0 ? \-errno : \-EPROTO; + + return 1; /* Notified! */ +} + +static int notify_ready(void) { + return notify("READY=1"); +} + +static int notify_reloading(void) { + /* A buffer with length sufficient to format the maximum UINT64 value\&. */ + char reload_message[sizeof("RELOADING=1\enMONOTONIC_USEC=18446744073709551615")]; + struct timespec ts; + uint64_t now; + + /* Notify systemd that we are reloading, including a CLOCK_MONOTONIC timestamp in usec + * so that the program is compatible with a Type=notify\-reload service\&. */ + + if (clock_gettime(CLOCK_MONOTONIC, &ts) < 0) + return \-errno; + + if (ts\&.tv_sec < 0 || ts\&.tv_nsec < 0 || + (uint64_t) ts\&.tv_sec > (UINT64_MAX \- (ts\&.tv_nsec / 1000ULL)) / 1000000ULL) + return \-EINVAL; + + now = (uint64_t) ts\&.tv_sec * 1000000ULL + (uint64_t) ts\&.tv_nsec / 1000ULL; + + if (snprintf(reload_message, sizeof(reload_message), "RELOADING=1\enMONOTONIC_USEC=%" PRIu64, now) < 0) + return \-EINVAL; + + return notify(reload_message); +} + +static int notify_stopping(void) { + return notify("STOPPING=1"); +} + +static volatile sig_atomic_t reloading = 0; +static volatile sig_atomic_t terminating = 0; + +static void signal_handler(int sig) { + if (sig == SIGHUP) + reloading = 1; + else if (sig == SIGINT || sig == SIGTERM) + terminating = 1; +} + +int main(int argc, char **argv) { + struct sigaction sa = { + \&.sa_handler = signal_handler, + \&.sa_flags = SA_RESTART, + }; + int r; + + /* Setup signal handlers */ + sigemptyset(&sa\&.sa_mask); + sigaction(SIGHUP, &sa, NULL); + sigaction(SIGINT, &sa, NULL); + sigaction(SIGTERM, &sa, NULL); + + /* Do more service initialization work here \&... */ + + /* Now that all the preparations steps are done, signal readiness */ + + r = notify_ready(); + if (r < 0) { + fprintf(stderr, "Failed to notify readiness to $NOTIFY_SOCKET: %s\en", strerror(\-r)); + return EXIT_FAILURE; + } + + while (!terminating) { + if (reloading) { + reloading = false; + + /* As a separate but related feature, we can also notify the manager + * when reloading configuration\&. This allows accurate state\-tracking, + * and also automated hook\-in of \*(Aqsystemctl reload\*(Aq without having to + * specify manually an ExecReload= line in the unit file\&. */ + + r = notify_reloading(); + if (r < 0) { + fprintf(stderr, "Failed to notify reloading to $NOTIFY_SOCKET: %s\en", strerror(\-r)); + return EXIT_FAILURE; + } + + /* Do some reconfiguration work here \&... */ + + r = notify_ready(); + if (r < 0) { + fprintf(stderr, "Failed to notify readiness to $NOTIFY_SOCKET: %s\en", strerror(\-r)); + return EXIT_FAILURE; + } + } + + /* Do some daemon work here \&... */ + sleep(5); + } + + r = notify_stopping(); + if (r < 0) { + fprintf(stderr, "Failed to report termination to $NOTIFY_SOCKET: %s\en", strerror(\-r)); + return EXIT_FAILURE; + } + + /* Do some shutdown work here \&... */ + + return EXIT_SUCCESS; +} +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBPython\fR +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +#!/usr/bin/env python3 +# SPDX\-License\-Identifier: MIT\-0 +# +# Implement the systemd notify protocol without external dependencies\&. +# Supports both readiness notification on startup and on reloading, +# according to the protocol defined at: +# https://www\&.freedesktop\&.org/software/systemd/man/latest/sd_notify\&.html +# This protocol is guaranteed to be stable as per: +# https://systemd\&.io/PORTABILITY_AND_STABILITY/ + +import errno +import os +import signal +import socket +import sys +import time + +reloading = False +terminating = False + +def notify(message): + if not message: + raise ValueError("notify() requires a message") + + socket_path = os\&.environ\&.get("NOTIFY_SOCKET") + if not socket_path: + return + + if socket_path[0] not in ("/", "@"): + raise OSError(errno\&.EAFNOSUPPORT, "Unsupported socket type") + + # Handle abstract socket\&. + if socket_path[0] == "@": + socket_path = "\e0" + socket_path[1:] + + with socket\&.socket(socket\&.AF_UNIX, socket\&.SOCK_DGRAM | socket\&.SOCK_CLOEXEC) as sock: + sock\&.connect(socket_path) + sock\&.sendall(message) + +def notify_ready(): + notify(b"READY=1") + +def notify_reloading(): + microsecs = time\&.clock_gettime_ns(time\&.CLOCK_MONOTONIC) // 1000 + notify(f"RELOADING=1\enMONOTONIC_USEC={microsecs}"\&.encode()) + +def notify_stopping(): + notify(b"STOPPING=1") + +def reload(signum, frame): + global reloading + reloading = True + +def terminate(signum, frame): + global terminating + terminating = True + +def main(): + print("Doing initial setup") + global reloading, terminating + + # Set up signal handlers\&. + print("Setting up signal handlers") + signal\&.signal(signal\&.SIGHUP, reload) + signal\&.signal(signal\&.SIGINT, terminate) + signal\&.signal(signal\&.SIGTERM, terminate) + + # Do any other setup work here\&. + + # Once all setup is done, signal readiness\&. + print("Done setting up") + notify_ready() + + print("Starting loop") + while not terminating: + if reloading: + print("Reloading") + reloading = False + + # Support notifying the manager when reloading configuration\&. + # This allows accurate state tracking as well as automatically + # enabling \*(Aqsystemctl reload\*(Aq without needing to manually + # specify an ExecReload= line in the unit file\&. + + notify_reloading() + + # Do some reconfiguration work here\&. + + print("Done reloading") + notify_ready() + + # Do the real work here \&.\&.\&. + + print("Sleeping for five seconds") + time\&.sleep(5) + + print("Terminating") + notify_stopping() + +if __name__ == "__main__": + sys\&.stdout\&.reconfigure(line_buffering=True) + print("Starting app") + main() + print("Stopped app") +.fi +.if n \{\ +.RE +.\} +.RE .SH "ENVIRONMENT" .PP \fI$NOTIFY_SOCKET\fR @@ -458,8 +800,8 @@ A service could send the following after completing initialization: .\} .nf sd_notifyf(0, "READY=1\en" - "STATUS=Processing requests\&...\en" - "MAINPID=%lu", + "STATUS=Processing requests\&...\en" + "MAINPID=%lu", (unsigned long) getpid()); .fi .if n \{\ @@ -475,7 +817,7 @@ A service could send the following shortly before exiting, on failure: .\} .nf sd_notifyf(0, "STATUS=Failed to start up: %s\en" - "ERRNO=%i", + "ERRNO=%i", strerror_r(errnum, (char[1024]){}, 1024), errnum); .fi @@ -532,13 +874,7 @@ and were added in version 254\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-daemon\fR(3), -\fBsd_listen_fds\fR(3), -\fBsd_listen_fds_with_names\fR(3), -\fBsd_watchdog_enabled\fR(3), -\fBdaemon\fR(7), -\fBsystemd.service\fR(5) +\fBsystemd\fR(1), \fBsd-daemon\fR(3), \fBsd_listen_fds\fR(3), \fBsd_listen_fds_with_names\fR(3), \fBsd_watchdog_enabled\fR(3), \fBdaemon\fR(7), \fBsystemd.service\fR(5) .SH "NOTES" .IP " 1." 4 File Descriptor Store diff --git a/upstream/fedora-rawhide/man3/sd_path_lookup.3 b/upstream/fedora-rawhide/man3/sd_path_lookup.3 index 7b5b0515..f98cc9fa 100644 --- a/upstream/fedora-rawhide/man3/sd_path_lookup.3 +++ b/upstream/fedora-rawhide/man3/sd_path_lookup.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_PATH_LOOKUP" "3" "" "systemd 255" "sd_path_lookup" +.TH "SD_PATH_LOOKUP" "3" "" "systemd 256~rc3" "sd_path_lookup" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -210,7 +210,7 @@ Added in version 246\&. #include <stdio\&.h> #include <stdlib\&.h> -#include <sd\-path\&.h> +#include <systemd/sd\-path\&.h> int main(void) { int r; diff --git a/upstream/fedora-rawhide/man3/sd_pid_get_owner_uid.3 b/upstream/fedora-rawhide/man3/sd_pid_get_owner_uid.3 index e3cb4cb7..3660f9d9 100644 --- a/upstream/fedora-rawhide/man3/sd_pid_get_owner_uid.3 +++ b/upstream/fedora-rawhide/man3/sd_pid_get_owner_uid.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_PID_GET_OWNER_UID" "3" "" "systemd 255" "sd_pid_get_owner_uid" +.TH "SD_PID_GET_OWNER_UID" "3" "" "systemd 256~rc3" "sd_pid_get_owner_uid" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -232,9 +232,4 @@ were added in version 236\&. were added in version 253\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-login\fR(3), -\fBsd_session_is_active\fR(3), -\fBgetsid\fR(2), -\fBsystemd.slice\fR(5), -\fBsystemd-machined.service\fR(8) +\fBsystemd\fR(1), \fBsd-login\fR(3), \fBsd_session_is_active\fR(3), \fBgetsid\fR(2), \fBsystemd.slice\fR(5), \fBsystemd-machined.service\fR(8) diff --git a/upstream/fedora-rawhide/man3/sd_seat_get_active.3 b/upstream/fedora-rawhide/man3/sd_seat_get_active.3 index eb1fb535..06bb9524 100644 --- a/upstream/fedora-rawhide/man3/sd_seat_get_active.3 +++ b/upstream/fedora-rawhide/man3/sd_seat_get_active.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_SEAT_GET_ACTIVE" "3" "" "systemd 255" "sd_seat_get_active" +.TH "SD_SEAT_GET_ACTIVE" "3" "" "systemd 256~rc3" "sd_seat_get_active" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -119,6 +119,4 @@ and were added in version 186\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-login\fR(3), -\fBsd_session_get_seat\fR(3) +\fBsystemd\fR(1), \fBsd-login\fR(3), \fBsd_session_get_seat\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_session_is_active.3 b/upstream/fedora-rawhide/man3/sd_session_is_active.3 index cc642e5b..6d406117 100644 --- a/upstream/fedora-rawhide/man3/sd_session_is_active.3 +++ b/upstream/fedora-rawhide/man3/sd_session_is_active.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_SESSION_IS_ACTIVE" "3" "" "systemd 255" "sd_session_is_active" +.TH "SD_SESSION_IS_ACTIVE" "3" "" "systemd 256~rc3" "sd_session_is_active" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -121,9 +121,15 @@ call after use\&. \fBsd_session_get_class()\fR may be used to determine the class of the session identified by the specified session identifier\&. The returned string is one of "user", +"user\-early", +"user\-incomplete", "greeter", -"lock\-screen", or -"background" +"lock\-screen", +"background", +"background\-light", +"manager" +or +"manager\-early" and needs to be freed with the libc \fBfree\fR(3) call after use\&. @@ -247,9 +253,7 @@ was added in version 217\&. were added in version 254\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-login\fR(3), -\fBsd_pid_get_session\fR(3) +\fBsystemd\fR(1), \fBsd-login\fR(3), \fBsd_pid_get_session\fR(3) .SH "NOTES" .IP " 1." 4 Desktop Entry Specification diff --git a/upstream/fedora-rawhide/man3/sd_uid_get_state.3 b/upstream/fedora-rawhide/man3/sd_uid_get_state.3 index de482df8..0073921f 100644 --- a/upstream/fedora-rawhide/man3/sd_uid_get_state.3 +++ b/upstream/fedora-rawhide/man3/sd_uid_get_state.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_UID_GET_STATE" "3" "" "systemd 255" "sd_uid_get_state" +.TH "SD_UID_GET_STATE" "3" "" "systemd 256~rc3" "sd_uid_get_state" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -153,6 +153,4 @@ was added in version 213\&. was added in version 254\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-login\fR(3), -\fBsd_pid_get_owner_uid\fR(3) +\fBsystemd\fR(1), \fBsd-login\fR(3), \fBsd_pid_get_owner_uid\fR(3) diff --git a/upstream/fedora-rawhide/man3/sd_watchdog_enabled.3 b/upstream/fedora-rawhide/man3/sd_watchdog_enabled.3 index 104bd692..ea82a277 100644 --- a/upstream/fedora-rawhide/man3/sd_watchdog_enabled.3 +++ b/upstream/fedora-rawhide/man3/sd_watchdog_enabled.3 @@ -1,5 +1,5 @@ '\" t -.TH "SD_WATCHDOG_ENABLED" "3" "" "systemd 255" "sd_watchdog_enabled" +.TH "SD_WATCHDOG_ENABLED" "3" "" "systemd 256~rc3" "sd_watchdog_enabled" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -118,9 +118,4 @@ Added in version 209\&. was added in version 209\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-daemon\fR(3), -\fBdaemon\fR(7), -\fBsystemd.service\fR(5), -\fBsd_notify\fR(3), -\fBsd_event_set_watchdog\fR(3) +\fBsystemd\fR(1), \fBsd-daemon\fR(3), \fBdaemon\fR(7), \fBsystemd.service\fR(5), \fBsd_notify\fR(3), \fBsd_event_set_watchdog\fR(3) diff --git a/upstream/fedora-rawhide/man3/seekdir.3 b/upstream/fedora-rawhide/man3/seekdir.3 index 70e535c3..500a6361 100644 --- a/upstream/fedora-rawhide/man3/seekdir.3 +++ b/upstream/fedora-rawhide/man3/seekdir.3 @@ -9,7 +9,7 @@ .\" 386BSD man pages .\" Modified Sat Jul 24 18:25:21 1993 by Rik Faith (faith@cs.unc.edu) .\" -.TH seekdir 3 2023-10-31 "Linux man-pages 6.06" +.TH seekdir 3 2023-10-31 "Linux man-pages 6.7" .SH NAME seekdir \- set the position of the next readdir() call in the directory stream. diff --git a/upstream/fedora-rawhide/man3/sem_close.3 b/upstream/fedora-rawhide/man3/sem_close.3 index e53abca5..c68c5021 100644 --- a/upstream/fedora-rawhide/man3/sem_close.3 +++ b/upstream/fedora-rawhide/man3/sem_close.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sem_close 3 2023-10-31 "Linux man-pages 6.06" +.TH sem_close 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sem_close \- close a named semaphore .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sem_destroy.3 b/upstream/fedora-rawhide/man3/sem_destroy.3 index 0df3e097..f7869063 100644 --- a/upstream/fedora-rawhide/man3/sem_destroy.3 +++ b/upstream/fedora-rawhide/man3/sem_destroy.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sem_destroy 3 2023-10-31 "Linux man-pages 6.06" +.TH sem_destroy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sem_destroy \- destroy an unnamed semaphore .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sem_getvalue.3 b/upstream/fedora-rawhide/man3/sem_getvalue.3 index cb155bd6..925a9bd6 100644 --- a/upstream/fedora-rawhide/man3/sem_getvalue.3 +++ b/upstream/fedora-rawhide/man3/sem_getvalue.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sem_getvalue 3 2023-10-31 "Linux man-pages 6.06" +.TH sem_getvalue 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sem_getvalue \- get the value of a semaphore .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sem_init.3 b/upstream/fedora-rawhide/man3/sem_init.3 index 904f32b6..0cae8963 100644 --- a/upstream/fedora-rawhide/man3/sem_init.3 +++ b/upstream/fedora-rawhide/man3/sem_init.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sem_init 3 2023-10-31 "Linux man-pages 6.06" +.TH sem_init 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sem_init \- initialize an unnamed semaphore .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sem_open.3 b/upstream/fedora-rawhide/man3/sem_open.3 index 7fc749dd..660daa97 100644 --- a/upstream/fedora-rawhide/man3/sem_open.3 +++ b/upstream/fedora-rawhide/man3/sem_open.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sem_open 3 2023-10-31 "Linux man-pages 6.06" +.TH sem_open 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sem_open \- initialize and open a named semaphore .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sem_post.3 b/upstream/fedora-rawhide/man3/sem_post.3 index 7fe204e4..1c06a81d 100644 --- a/upstream/fedora-rawhide/man3/sem_post.3 +++ b/upstream/fedora-rawhide/man3/sem_post.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sem_post 3 2023-10-31 "Linux man-pages 6.06" +.TH sem_post 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sem_post \- unlock a semaphore .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sem_unlink.3 b/upstream/fedora-rawhide/man3/sem_unlink.3 index c41f24b3..dd8d4021 100644 --- a/upstream/fedora-rawhide/man3/sem_unlink.3 +++ b/upstream/fedora-rawhide/man3/sem_unlink.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sem_unlink 3 2023-10-31 "Linux man-pages 6.06" +.TH sem_unlink 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sem_unlink \- remove a named semaphore .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sem_wait.3 b/upstream/fedora-rawhide/man3/sem_wait.3 index e6b9de57..aa4793cb 100644 --- a/upstream/fedora-rawhide/man3/sem_wait.3 +++ b/upstream/fedora-rawhide/man3/sem_wait.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sem_wait 3 2023-10-31 "Linux man-pages 6.06" +.TH sem_wait 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sem_wait, sem_timedwait, sem_trywait \- lock a semaphore .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/setaliasent.3 b/upstream/fedora-rawhide/man3/setaliasent.3 index fa022b87..acdad177 100644 --- a/upstream/fedora-rawhide/man3/setaliasent.3 +++ b/upstream/fedora-rawhide/man3/setaliasent.3 @@ -5,7 +5,7 @@ .\" .\" Polished a bit, added a little, aeb .\" -.TH setaliasent 3 2023-10-31 "Linux man-pages 6.06" +.TH setaliasent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME setaliasent, endaliasent, getaliasent, getaliasent_r, getaliasbyname, getaliasbyname_r \- read an alias entry diff --git a/upstream/fedora-rawhide/man3/setbuf.3 b/upstream/fedora-rawhide/man3/setbuf.3 index 80eee7ba..89865e2c 100644 --- a/upstream/fedora-rawhide/man3/setbuf.3 +++ b/upstream/fedora-rawhide/man3/setbuf.3 @@ -18,7 +18,7 @@ .\" Correction, 2000-03-03, Andreas Jaeger <aj@suse.de> .\" Added return value for setvbuf, aeb, .\" -.TH setbuf 3 2023-10-31 "Linux man-pages 6.06" +.TH setbuf 3 2024-02-26 "Linux man-pages 6.7" .SH NAME setbuf, setbuffer, setlinebuf, setvbuf \- stream buffering operations .SH LIBRARY @@ -201,7 +201,7 @@ points to still exists by the time is closed, which also happens at program termination. For example, the following is invalid: .P -.\" [[invalid]] SRC BEGIN (setbuf.c) +.\" SRC BEGIN (setbuf.c) .EX #include <stdio.h> \& diff --git a/upstream/fedora-rawhide/man3/setenv.3 b/upstream/fedora-rawhide/man3/setenv.3 index 7d7ed3d9..d51f0f84 100644 --- a/upstream/fedora-rawhide/man3/setenv.3 +++ b/upstream/fedora-rawhide/man3/setenv.3 @@ -15,7 +15,7 @@ .\" Noted nonstandard behavior of setenv() if name contains '=' .\" 2005-08-12, mtk, glibc 2.3.4 fixed the "name contains '='" bug .\" -.TH setenv 3 2023-10-31 "Linux man-pages 6.06" +.TH setenv 3 2023-10-31 "Linux man-pages 6.7" .SH NAME setenv \- change or add an environment variable .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/setjmp.3 b/upstream/fedora-rawhide/man3/setjmp.3 index babfc89d..18771aad 100644 --- a/upstream/fedora-rawhide/man3/setjmp.3 +++ b/upstream/fedora-rawhide/man3/setjmp.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH setjmp 3 2023-10-31 "Linux man-pages 6.06" +.TH setjmp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME setjmp, sigsetjmp, longjmp, siglongjmp \- performing a nonlocal goto .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/setlocale.3 b/upstream/fedora-rawhide/man3/setlocale.3 index a7fb1a52..50a36d8d 100644 --- a/upstream/fedora-rawhide/man3/setlocale.3 +++ b/upstream/fedora-rawhide/man3/setlocale.3 @@ -10,7 +10,7 @@ .\" Modified Tue Aug 24 17:11:01 1999 by Andries Brouwer (aeb@cwi.nl) .\" Modified Tue Feb 6 03:31:55 2001 by Andries Brouwer (aeb@cwi.nl) .\" -.TH setlocale 3 2024-01-28 "Linux man-pages 6.06" +.TH setlocale 3 2024-02-25 "Linux man-pages 6.7" .SH NAME setlocale \- set the current locale .SH LIBRARY @@ -92,7 +92,7 @@ Such a string is either a well-known constant like "C" or "da_DK" If .I locale is an empty string, -.BR """""" , +.BR \[dq]\[dq] , each part of the locale that should be modified is set according to the environment variables. The details are implementation-dependent. @@ -112,9 +112,9 @@ is unchanged, and returns NULL. .P The locale -.B """C""" +.B \[dq]C\[dq] or -.B """POSIX""" +.B \[dq]POSIX\[dq] is a portable locale; it exists on all conforming systems. .P @@ -138,7 +138,7 @@ If is NULL, the current locale is only queried, not modified. .P On startup of the main program, the portable -.B """C""" +.B \[dq]C\[dq] locale is selected as default. A program may be made portable to all locales by calling: .P diff --git a/upstream/fedora-rawhide/man3/setlogmask.3 b/upstream/fedora-rawhide/man3/setlogmask.3 index 863660fa..57fa9de6 100644 --- a/upstream/fedora-rawhide/man3/setlogmask.3 +++ b/upstream/fedora-rawhide/man3/setlogmask.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH setlogmask 3 2023-11-01 "Linux man-pages 6.06" +.TH setlogmask 3 2023-11-01 "Linux man-pages 6.7" .SH NAME setlogmask \- set log priority mask .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/setnetgrent.3 b/upstream/fedora-rawhide/man3/setnetgrent.3 index a4ea3272..ec6e6d68 100644 --- a/upstream/fedora-rawhide/man3/setnetgrent.3 +++ b/upstream/fedora-rawhide/man3/setnetgrent.3 @@ -6,7 +6,7 @@ .\" based on glibc infopages .\" polished - aeb .\" -.TH setnetgrent 3 2023-10-31 "Linux man-pages 6.06" +.TH setnetgrent 3 2023-10-31 "Linux man-pages 6.7" .SH NAME setnetgrent, endnetgrent, getnetgrent, getnetgrent_r, innetgr \- handle network group entries diff --git a/upstream/fedora-rawhide/man3/shm_open.3 b/upstream/fedora-rawhide/man3/shm_open.3 index dafc95d2..6d07292d 100644 --- a/upstream/fedora-rawhide/man3/shm_open.3 +++ b/upstream/fedora-rawhide/man3/shm_open.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH shm_open 3 2023-10-31 "Linux man-pages 6.06" +.TH shm_open 3 2023-10-31 "Linux man-pages 6.7" .SH NAME shm_open, shm_unlink \- create/open or unlink POSIX shared memory objects .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/siginterrupt.3 b/upstream/fedora-rawhide/man3/siginterrupt.3 index a1ab93a2..be7f0931 100644 --- a/upstream/fedora-rawhide/man3/siginterrupt.3 +++ b/upstream/fedora-rawhide/man3/siginterrupt.3 @@ -9,7 +9,7 @@ .\" 386BSD man pages .\" Modified Sun Jul 25 10:40:51 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Sun Apr 14 16:20:34 1996 by Andries Brouwer (aeb@cwi.nl) -.TH siginterrupt 3 2023-10-31 "Linux man-pages 6.06" +.TH siginterrupt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME siginterrupt \- allow signals to interrupt system calls .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/signbit.3 b/upstream/fedora-rawhide/man3/signbit.3 index 48ae0e21..ad7a1f46 100644 --- a/upstream/fedora-rawhide/man3/signbit.3 +++ b/upstream/fedora-rawhide/man3/signbit.3 @@ -7,7 +7,7 @@ .\" .\" Based on glibc infopages, copyright Free Software Foundation .\" -.TH signbit 3 2023-10-31 "Linux man-pages 6.06" +.TH signbit 3 2023-10-31 "Linux man-pages 6.7" .SH NAME signbit \- test sign of a real floating-point number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/significand.3 b/upstream/fedora-rawhide/man3/significand.3 index 3cea3113..dbd6f7ba 100644 --- a/upstream/fedora-rawhide/man3/significand.3 +++ b/upstream/fedora-rawhide/man3/significand.3 @@ -5,7 +5,7 @@ .\" .\" heavily based on glibc infopages, copyright Free Software Foundation .\" -.TH significand 3 2023-10-31 "Linux man-pages 6.06" +.TH significand 3 2024-03-12 "Linux man-pages 6.7" .SH NAME significand, significandf, significandl \- get mantissa of floating-point number @@ -36,7 +36,8 @@ Feature Test Macro Requirements for glibc (see .SH DESCRIPTION These functions return the mantissa of .I x -scaled to the range [1,2). +scaled to the range +.RB [ 1 ,\~ FLT_RADIX ). They are equivalent to .P .in +4n diff --git a/upstream/fedora-rawhide/man3/sigpause.3 b/upstream/fedora-rawhide/man3/sigpause.3 index 9e2305d3..062f0699 100644 --- a/upstream/fedora-rawhide/man3/sigpause.3 +++ b/upstream/fedora-rawhide/man3/sigpause.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sigpause 3 2023-10-31 "Linux man-pages 6.06" +.TH sigpause 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sigpause \- atomically release blocked signals and wait for interrupt .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sigqueue.3 b/upstream/fedora-rawhide/man3/sigqueue.3 index 90459043..99ea60f1 100644 --- a/upstream/fedora-rawhide/man3/sigqueue.3 +++ b/upstream/fedora-rawhide/man3/sigqueue.3 @@ -6,7 +6,7 @@ .\" added note on self-signaling, aeb, 2002-06-07 .\" added note on CAP_KILL, mtk, 2004-06-16 .\" -.TH sigqueue 3 2023-10-31 "Linux man-pages 6.06" +.TH sigqueue 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sigqueue \- queue a signal and data to a process .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sigset.3 b/upstream/fedora-rawhide/man3/sigset.3 index 588627ee..2d393d68 100644 --- a/upstream/fedora-rawhide/man3/sigset.3 +++ b/upstream/fedora-rawhide/man3/sigset.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sigset 3 2023-10-31 "Linux man-pages 6.06" +.TH sigset 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sigset, sighold, sigrelse, sigignore \- System V signal API .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sigsetops.3 b/upstream/fedora-rawhide/man3/sigsetops.3 index a998236f..7fc11409 100644 --- a/upstream/fedora-rawhide/man3/sigsetops.3 +++ b/upstream/fedora-rawhide/man3/sigsetops.3 @@ -9,7 +9,7 @@ .\" 2007-10-26 mdw added wording that a sigset_t must be initialized .\" prior to use .\" -.TH SIGSETOPS 3 2023-10-31 "Linux man-pages 6.06" +.TH SIGSETOPS 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sigemptyset, sigfillset, sigaddset, sigdelset, sigismember \- POSIX signal set operations diff --git a/upstream/fedora-rawhide/man3/sigvec.3 b/upstream/fedora-rawhide/man3/sigvec.3 index e7e1393c..d5ae4b0c 100644 --- a/upstream/fedora-rawhide/man3/sigvec.3 +++ b/upstream/fedora-rawhide/man3/sigvec.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sigvec 3 2023-10-31 "Linux man-pages 6.06" +.TH sigvec 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sigvec, sigblock, sigsetmask, siggetmask, sigmask \- BSD signal API .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sigwait.3 b/upstream/fedora-rawhide/man3/sigwait.3 index 9c0a1e77..2ac7d0e1 100644 --- a/upstream/fedora-rawhide/man3/sigwait.3 +++ b/upstream/fedora-rawhide/man3/sigwait.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sigwait 3 2023-10-31 "Linux man-pages 6.06" +.TH sigwait 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sigwait \- wait for a signal .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sin.3 b/upstream/fedora-rawhide/man3/sin.3 index 383839b7..1038af02 100644 --- a/upstream/fedora-rawhide/man3/sin.3 +++ b/upstream/fedora-rawhide/man3/sin.3 @@ -13,7 +13,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH sin 3 2023-10-31 "Linux man-pages 6.06" +.TH sin 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sin, sinf, sinl \- sine function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sincos.3 b/upstream/fedora-rawhide/man3/sincos.3 index f9b20ba5..1093c3bb 100644 --- a/upstream/fedora-rawhide/man3/sincos.3 +++ b/upstream/fedora-rawhide/man3/sincos.3 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH sincos 3 2023-10-31 "Linux man-pages 6.06" +.TH sincos 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sincos, sincosf, sincosl \- calculate sin and cos simultaneously .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sinh.3 b/upstream/fedora-rawhide/man3/sinh.3 index 269fee09..c9027d68 100644 --- a/upstream/fedora-rawhide/man3/sinh.3 +++ b/upstream/fedora-rawhide/man3/sinh.3 @@ -14,7 +14,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH sinh 3 2023-10-31 "Linux man-pages 6.06" +.TH sinh 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sinh, sinhf, sinhl \- hyperbolic sine function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sleep.3 b/upstream/fedora-rawhide/man3/sleep.3 index f8a0fdac..ae70958d 100644 --- a/upstream/fedora-rawhide/man3/sleep.3 +++ b/upstream/fedora-rawhide/man3/sleep.3 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" Modified Sat Jul 24 18:16:02 1993 by Rik Faith (faith@cs.unc.edu) -.TH sleep 3 2023-10-31 "Linux man-pages 6.06" +.TH sleep 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sleep \- sleep for a specified number of seconds .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/slist.3 b/upstream/fedora-rawhide/man3/slist.3 index 13f50bba..396b9cb6 100644 --- a/upstream/fedora-rawhide/man3/slist.3 +++ b/upstream/fedora-rawhide/man3/slist.3 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: BSD-3-Clause .\" .\" -.TH SLIST 3 2023-10-31 "Linux man-pages 6.06" +.TH SLIST 3 2023-10-31 "Linux man-pages 6.7" .SH NAME SLIST_EMPTY, SLIST_ENTRY, diff --git a/upstream/fedora-rawhide/man3/sockatmark.3 b/upstream/fedora-rawhide/man3/sockatmark.3 index a1ede91e..7d07791c 100644 --- a/upstream/fedora-rawhide/man3/sockatmark.3 +++ b/upstream/fedora-rawhide/man3/sockatmark.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sockatmark 3 2023-10-31 "Linux man-pages 6.06" +.TH sockatmark 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sockatmark \- determine whether socket is at out-of-band mark .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sqrt.3 b/upstream/fedora-rawhide/man3/sqrt.3 index 298f52a4..6c6e4696 100644 --- a/upstream/fedora-rawhide/man3/sqrt.3 +++ b/upstream/fedora-rawhide/man3/sqrt.3 @@ -12,7 +12,7 @@ .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) -.TH sqrt 3 2023-10-31 "Linux man-pages 6.06" +.TH sqrt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sqrt, sqrtf, sqrtl \- square root function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sscanf.3 b/upstream/fedora-rawhide/man3/sscanf.3 index b2759df7..7e0198cb 100644 --- a/upstream/fedora-rawhide/man3/sscanf.3 +++ b/upstream/fedora-rawhide/man3/sscanf.3 @@ -22,7 +22,7 @@ .\" Add ERRORS section. .\" Document the 'a' and 'm' modifiers for dynamic string allocation. .\" -.TH sscanf 3 2023-12-09 "Linux man-pages 6.06" +.TH sscanf 3 2023-12-09 "Linux man-pages 6.7" .SH NAME sscanf, vsscanf \- input string format conversion .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/stailq.3 b/upstream/fedora-rawhide/man3/stailq.3 index 37101ca2..367b2bfc 100644 --- a/upstream/fedora-rawhide/man3/stailq.3 +++ b/upstream/fedora-rawhide/man3/stailq.3 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: BSD-3-Clause .\" .\" -.TH STAILQ 3 2023-10-31 "Linux man-pages 6.06" +.TH STAILQ 3 2023-10-31 "Linux man-pages 6.7" .SH NAME .\"SIMPLEQ_CONCAT, SIMPLEQ_EMPTY, diff --git a/upstream/fedora-rawhide/man3/static_assert.3 b/upstream/fedora-rawhide/man3/static_assert.3 index dfc70520..a81306db 100644 --- a/upstream/fedora-rawhide/man3/static_assert.3 +++ b/upstream/fedora-rawhide/man3/static_assert.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH static_assert 3 2023-10-31 "Linux man-pages 6.06" +.TH static_assert 3 2023-10-31 "Linux man-pages 6.7" .SH NAME static_assert, _Static_assert \- fail compilation if assertion is false .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/statvfs.3 b/upstream/fedora-rawhide/man3/statvfs.3 index 58bc7f8f..7d5d9628 100644 --- a/upstream/fedora-rawhide/man3/statvfs.3 +++ b/upstream/fedora-rawhide/man3/statvfs.3 @@ -8,7 +8,7 @@ .\" .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH statvfs 3 2023-10-31 "Linux man-pages 6.06" +.TH statvfs 3 2023-10-31 "Linux man-pages 6.7" .SH NAME statvfs, fstatvfs \- get filesystem statistics .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/stdarg.3 b/upstream/fedora-rawhide/man3/stdarg.3 index 85fd684c..ce047041 100644 --- a/upstream/fedora-rawhide/man3/stdarg.3 +++ b/upstream/fedora-rawhide/man3/stdarg.3 @@ -13,7 +13,7 @@ .\" Converted for Linux, Mon Nov 29 15:11:11 1993, faith@cs.unc.edu .\" Additions, 2001-10-14, aeb .\" -.TH stdarg 3 2023-10-31 "Linux man-pages 6.06" +.TH stdarg 3 2023-10-31 "Linux man-pages 6.7" .SH NAME stdarg, va_start, va_arg, va_end, va_copy \- variable argument lists .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/stdin.3 b/upstream/fedora-rawhide/man3/stdin.3 index a94040a6..42ed937c 100644 --- a/upstream/fedora-rawhide/man3/stdin.3 +++ b/upstream/fedora-rawhide/man3/stdin.3 @@ -10,7 +10,7 @@ .\" 2005-06-16 mtk, mentioned freopen() .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH stdin 3 2023-10-31 "Linux man-pages 6.06" +.TH stdin 3 2023-10-31 "Linux man-pages 6.7" .SH NAME stdin, stdout, stderr \- standard I/O streams .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/stdio.3 b/upstream/fedora-rawhide/man3/stdio.3 index 08e3558c..73dfca2b 100644 --- a/upstream/fedora-rawhide/man3/stdio.3 +++ b/upstream/fedora-rawhide/man3/stdio.3 @@ -9,7 +9,7 @@ .\" Converted for Linux, Mon Nov 29 16:07:22 1993, faith@cs.unc.edu .\" Modified, 2001-12-26, aeb .\" -.TH stdio 3 2023-12-29 "Linux man-pages 6.06" +.TH stdio 3 2023-12-29 "Linux man-pages 6.7" .SH NAME stdio \- standard input/output library functions .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/stdio_ext.3 b/upstream/fedora-rawhide/man3/stdio_ext.3 index 133f3689..a98ffc5b 100644 --- a/upstream/fedora-rawhide/man3/stdio_ext.3 +++ b/upstream/fedora-rawhide/man3/stdio_ext.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH stdio_ext 3 2023-10-31 "Linux man-pages 6.06" +.TH stdio_ext 3 2023-10-31 "Linux man-pages 6.7" .SH NAME __fbufsize, __flbf, __fpending, __fpurge, __freadable, __freading, __fsetlocking, __fwritable, __fwriting, _flushlbf \- diff --git a/upstream/fedora-rawhide/man3/stpncpy.3 b/upstream/fedora-rawhide/man3/stpncpy.3 index c8e12d90..c4b5db4d 100644 --- a/upstream/fedora-rawhide/man3/stpncpy.3 +++ b/upstream/fedora-rawhide/man3/stpncpy.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH stpncpy 3 2024-02-12 "Linux man-pages 6.06" +.TH stpncpy 3 2024-02-12 "Linux man-pages 6.7" .SH NAME stpncpy, strncpy \- diff --git a/upstream/fedora-rawhide/man3/strcasecmp.3 b/upstream/fedora-rawhide/man3/strcasecmp.3 index 22c21abc..3154740e 100644 --- a/upstream/fedora-rawhide/man3/strcasecmp.3 +++ b/upstream/fedora-rawhide/man3/strcasecmp.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:12:45 1993 by Rik Faith (faith@cs.unc.edu) -.TH strcasecmp 3 2023-10-31 "Linux man-pages 6.06" +.TH strcasecmp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strcasecmp, strncasecmp \- compare two strings ignoring case .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strchr.3 b/upstream/fedora-rawhide/man3/strchr.3 index 2f74a4ea..bff3bd41 100644 --- a/upstream/fedora-rawhide/man3/strchr.3 +++ b/upstream/fedora-rawhide/man3/strchr.3 @@ -11,7 +11,7 @@ .\" 2006-05-19, Justin Pryzby <pryzbyj@justinpryzby.com> .\" Document strchrnul(3). .\" -.TH strchr 3 2023-10-31 "Linux man-pages 6.06" +.TH strchr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strchr, strrchr, strchrnul \- locate character in string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strcmp.3 b/upstream/fedora-rawhide/man3/strcmp.3 index 21f3e1a7..78fdf680 100644 --- a/upstream/fedora-rawhide/man3/strcmp.3 +++ b/upstream/fedora-rawhide/man3/strcmp.3 @@ -11,7 +11,7 @@ .\" Modified Sat Jul 24 18:08:52 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 2001-08-31, aeb .\" -.TH strcmp 3 2023-10-31 "Linux man-pages 6.06" +.TH strcmp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strcmp, strncmp \- compare two strings .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strcoll.3 b/upstream/fedora-rawhide/man3/strcoll.3 index 6ad9486e..71918ea3 100644 --- a/upstream/fedora-rawhide/man3/strcoll.3 +++ b/upstream/fedora-rawhide/man3/strcoll.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sun Jul 25 10:40:44 1993 by Rik Faith (faith@cs.unc.edu) -.TH strcoll 3 2023-10-31 "Linux man-pages 6.06" +.TH strcoll 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strcoll \- compare two strings using the current locale .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strcpy.3 b/upstream/fedora-rawhide/man3/strcpy.3 index 65e1a389..fd0c3351 100644 --- a/upstream/fedora-rawhide/man3/strcpy.3 +++ b/upstream/fedora-rawhide/man3/strcpy.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH strcpy 3 2023-10-31 "Linux man-pages 6.06" +.TH strcpy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME stpcpy, strcpy, strcat \- copy or catenate a string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strdup.3 b/upstream/fedora-rawhide/man3/strdup.3 index 287b3711..75b678ee 100644 --- a/upstream/fedora-rawhide/man3/strdup.3 +++ b/upstream/fedora-rawhide/man3/strdup.3 @@ -9,7 +9,7 @@ .\" 386BSD man pages .\" Modified Sun Jul 25 10:41:34 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Wed Oct 17 01:12:26 2001 by John Levon <moz@compsoc.man.ac.uk> -.TH strdup 3 2023-10-31 "Linux man-pages 6.06" +.TH strdup 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strdup, strndup, strdupa, strndupa \- duplicate a string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strerror.3 b/upstream/fedora-rawhide/man3/strerror.3 index 4251ebb5..89f4e9bc 100644 --- a/upstream/fedora-rawhide/man3/strerror.3 +++ b/upstream/fedora-rawhide/man3/strerror.3 @@ -17,7 +17,7 @@ .\" 2005-12-13, mtk, Substantial rewrite of strerror_r() description .\" Addition of extra material on portability and standards. .\" -.TH strerror 3 2023-10-31 "Linux man-pages 6.06" +.TH strerror 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strerror, strerrorname_np, strerrordesc_np, strerror_r, strerror_l \- return string describing error number diff --git a/upstream/fedora-rawhide/man3/strfmon.3 b/upstream/fedora-rawhide/man3/strfmon.3 index d198e5bc..687da22f 100644 --- a/upstream/fedora-rawhide/man3/strfmon.3 +++ b/upstream/fedora-rawhide/man3/strfmon.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH strfmon 3 2023-10-31 "Linux man-pages 6.06" +.TH strfmon 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strfmon, strfmon_l \- convert monetary value to a string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strfromd.3 b/upstream/fedora-rawhide/man3/strfromd.3 index d65e6182..9243191d 100644 --- a/upstream/fedora-rawhide/man3/strfromd.3 +++ b/upstream/fedora-rawhide/man3/strfromd.3 @@ -10,7 +10,7 @@ .\" ISO/IEC TS 18661-1 technical specification. .\" snprintf and other man.3 pages. .\" -.TH strfromd 3 2023-10-31 "Linux man-pages 6.06" +.TH strfromd 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strfromd, strfromf, strfroml \- convert a floating-point value into a string diff --git a/upstream/fedora-rawhide/man3/strfry.3 b/upstream/fedora-rawhide/man3/strfry.3 index 9faaae15..98712497 100644 --- a/upstream/fedora-rawhide/man3/strfry.3 +++ b/upstream/fedora-rawhide/man3/strfry.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sun Jul 25 10:39:43 1993 by Rik Faith (faith@cs.unc.edu) -.TH strfry 3 2023-10-31 "Linux man-pages 6.06" +.TH strfry 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strfry \- randomize a string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strftime.3 b/upstream/fedora-rawhide/man3/strftime.3 index d7e27806..191c0f41 100644 --- a/upstream/fedora-rawhide/man3/strftime.3 +++ b/upstream/fedora-rawhide/man3/strftime.3 @@ -15,7 +15,7 @@ .\" 2005-11-22 mtk, added glibc Notes covering optional 'flag' and .\" 'width' components of conversion specifications. .\" -.TH strftime 3 2024-01-28 "Linux man-pages 6.06" +.TH strftime 3 2024-01-28 "Linux man-pages 6.7" .SH NAME strftime \- format date and time .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/string.3 b/upstream/fedora-rawhide/man3/string.3 index 4a9c62de..e7fb7776 100644 --- a/upstream/fedora-rawhide/man3/string.3 +++ b/upstream/fedora-rawhide/man3/string.3 @@ -7,7 +7,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sun Jul 25 10:54:31 1993, Rik Faith (faith@cs.unc.edu) -.TH string 3 2023-11-14 "Linux man-pages 6.06" +.TH string 3 2023-11-14 "Linux man-pages 6.7" .SH NAME stpcpy, strcasecmp, strcat, strchr, strcmp, strcoll, strcpy, strcspn, strdup, strfry, strlen, strncat, strncmp, strncpy, strncasecmp, strpbrk, diff --git a/upstream/fedora-rawhide/man3/strlen.3 b/upstream/fedora-rawhide/man3/strlen.3 index 28eee927..9b0ec8e2 100644 --- a/upstream/fedora-rawhide/man3/strlen.3 +++ b/upstream/fedora-rawhide/man3/strlen.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:02:26 1993 by Rik Faith (faith@cs.unc.edu) -.TH strlen 3 2023-10-31 "Linux man-pages 6.06" +.TH strlen 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strlen \- calculate the length of a string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strncat.3 b/upstream/fedora-rawhide/man3/strncat.3 index c388e1fb..74848c9e 100644 --- a/upstream/fedora-rawhide/man3/strncat.3 +++ b/upstream/fedora-rawhide/man3/strncat.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH strncat 3 2023-12-05 "Linux man-pages 6.06" +.TH strncat 3 2023-12-05 "Linux man-pages 6.7" .SH NAME strncat \- diff --git a/upstream/fedora-rawhide/man3/strnlen.3 b/upstream/fedora-rawhide/man3/strnlen.3 index 2a741927..78e5c51f 100644 --- a/upstream/fedora-rawhide/man3/strnlen.3 +++ b/upstream/fedora-rawhide/man3/strnlen.3 @@ -6,7 +6,7 @@ .\" References consulted: .\" GNU glibc-2 source code and manual .\" -.TH strnlen 3 2023-10-31 "Linux man-pages 6.06" +.TH strnlen 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strnlen \- determine the length of a fixed-size string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strpbrk.3 b/upstream/fedora-rawhide/man3/strpbrk.3 index 7f464d07..c8d71a80 100644 --- a/upstream/fedora-rawhide/man3/strpbrk.3 +++ b/upstream/fedora-rawhide/man3/strpbrk.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 18:01:24 1993 by Rik Faith (faith@cs.unc.edu) -.TH strpbrk 3 2023-10-31 "Linux man-pages 6.06" +.TH strpbrk 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strpbrk \- search a string for any of a set of bytes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strptime.3 b/upstream/fedora-rawhide/man3/strptime.3 index 8cff78f0..9ccccfd5 100644 --- a/upstream/fedora-rawhide/man3/strptime.3 +++ b/upstream/fedora-rawhide/man3/strptime.3 @@ -9,7 +9,7 @@ .\" Modified, aeb, 2001-08-31 .\" Modified, wharms 2001-11-12, remark on white space and example .\" -.TH strptime 3 2024-01-28 "Linux man-pages 6.06" +.TH strptime 3 2024-01-28 "Linux man-pages 6.7" .SH NAME strptime \- convert a string representation of time to a time tm structure .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strsep.3 b/upstream/fedora-rawhide/man3/strsep.3 index 285dd03a..aac29b98 100644 --- a/upstream/fedora-rawhide/man3/strsep.3 +++ b/upstream/fedora-rawhide/man3/strsep.3 @@ -11,7 +11,7 @@ .\" Modified Mon Jan 20 12:04:18 1997 by Andries Brouwer (aeb@cwi.nl) .\" Modified Tue Jan 23 20:23:07 2001 by Andries Brouwer (aeb@cwi.nl) .\" -.TH strsep 3 2023-10-31 "Linux man-pages 6.06" +.TH strsep 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strsep \- extract token from string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strsignal.3 b/upstream/fedora-rawhide/man3/strsignal.3 index edd33042..0d359d69 100644 --- a/upstream/fedora-rawhide/man3/strsignal.3 +++ b/upstream/fedora-rawhide/man3/strsignal.3 @@ -9,7 +9,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 17:59:03 1993 by Rik Faith (faith@cs.unc.edu) -.TH strsignal 3 2023-10-31 "Linux man-pages 6.06" +.TH strsignal 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strsignal, sigabbrev_np, sigdescr_np, sys_siglist \- return string describing signal diff --git a/upstream/fedora-rawhide/man3/strspn.3 b/upstream/fedora-rawhide/man3/strspn.3 index c6f9358b..b1398cf3 100644 --- a/upstream/fedora-rawhide/man3/strspn.3 +++ b/upstream/fedora-rawhide/man3/strspn.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 17:57:50 1993 by Rik Faith (faith@cs.unc.edu) -.TH strspn 3 2023-10-31 "Linux man-pages 6.06" +.TH strspn 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strspn, strcspn \- get length of a prefix substring .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strstr.3 b/upstream/fedora-rawhide/man3/strstr.3 index 7b22a94d..ef455cfc 100644 --- a/upstream/fedora-rawhide/man3/strstr.3 +++ b/upstream/fedora-rawhide/man3/strstr.3 @@ -11,7 +11,7 @@ .\" Added history, aeb, 980113. .\" 2005-05-05 mtk: added strcasestr() .\" -.TH strstr 3 2023-10-31 "Linux man-pages 6.06" +.TH strstr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strstr, strcasestr \- locate a substring .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strtod.3 b/upstream/fedora-rawhide/man3/strtod.3 index 652a426d..5c650b12 100644 --- a/upstream/fedora-rawhide/man3/strtod.3 +++ b/upstream/fedora-rawhide/man3/strtod.3 @@ -15,7 +15,7 @@ .\" (michael@cantor.informatik.rwth-aachen.de) .\" Added strof, strtold, aeb, 2001-06-07 .\" -.TH strtod 3 2023-10-31 "Linux man-pages 6.06" +.TH strtod 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strtod, strtof, strtold \- convert ASCII string to floating-point number .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strtoimax.3 b/upstream/fedora-rawhide/man3/strtoimax.3 index e55b3e57..1e736610 100644 --- a/upstream/fedora-rawhide/man3/strtoimax.3 +++ b/upstream/fedora-rawhide/man3/strtoimax.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH strtoimax 3 2023-10-31 "Linux man-pages 6.06" +.TH strtoimax 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strtoimax, strtoumax \- convert string to integer .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strtok.3 b/upstream/fedora-rawhide/man3/strtok.3 index 0c3bcd1b..8454776d 100644 --- a/upstream/fedora-rawhide/man3/strtok.3 +++ b/upstream/fedora-rawhide/man3/strtok.3 @@ -10,7 +10,7 @@ .\" 2005-11-17, mtk: Substantial parts rewritten .\" 2013-05-19, mtk: added much further detail on the operation of strtok() .\" -.TH strtok 3 2023-10-31 "Linux man-pages 6.06" +.TH strtok 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strtok, strtok_r \- extract tokens from strings .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strtol.3 b/upstream/fedora-rawhide/man3/strtol.3 index 23ee7225..b6609b20 100644 --- a/upstream/fedora-rawhide/man3/strtol.3 +++ b/upstream/fedora-rawhide/man3/strtol.3 @@ -10,7 +10,7 @@ .\" 386BSD man pages .\" Modified Sun Jul 25 10:53:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Added correction due to nsd@bbc.com (Nick Duffek) - aeb, 950610 -.TH strtol 3 2023-12-19 "Linux man-pages 6.06" +.TH strtol 3 2023-12-19 "Linux man-pages 6.7" .SH NAME strtol, strtoll, strtoq \- convert a string to a long integer .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strtoul.3 b/upstream/fedora-rawhide/man3/strtoul.3 index 5982f732..99b5a470 100644 --- a/upstream/fedora-rawhide/man3/strtoul.3 +++ b/upstream/fedora-rawhide/man3/strtoul.3 @@ -11,7 +11,7 @@ .\" Fixed typo, aeb, 950823 .\" 2002-02-22, joey, mihtjel: Added strtoull() .\" -.TH strtoul 3 2023-12-19 "Linux man-pages 6.06" +.TH strtoul 3 2023-12-19 "Linux man-pages 6.7" .SH NAME strtoul, strtoull, strtouq \- convert a string to an unsigned long integer .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strverscmp.3 b/upstream/fedora-rawhide/man3/strverscmp.3 index 967da711..ad3ebeb2 100644 --- a/upstream/fedora-rawhide/man3/strverscmp.3 +++ b/upstream/fedora-rawhide/man3/strverscmp.3 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH strverscmp 3 2023-10-31 "Linux man-pages 6.06" +.TH strverscmp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strverscmp \- compare two version strings .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/strxfrm.3 b/upstream/fedora-rawhide/man3/strxfrm.3 index 9fa0b971..a646af05 100644 --- a/upstream/fedora-rawhide/man3/strxfrm.3 +++ b/upstream/fedora-rawhide/man3/strxfrm.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sun Jul 25 10:41:28 1993 by Rik Faith (faith@cs.unc.edu) -.TH strxfrm 3 2023-10-31 "Linux man-pages 6.06" +.TH strxfrm 3 2023-10-31 "Linux man-pages 6.7" .SH NAME strxfrm \- string transformation .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/swab.3 b/upstream/fedora-rawhide/man3/swab.3 index c4ecfa27..73c840fc 100644 --- a/upstream/fedora-rawhide/man3/swab.3 +++ b/upstream/fedora-rawhide/man3/swab.3 @@ -9,7 +9,7 @@ .\" 386BSD man pages .\" Modified Sat Jul 24 17:52:15 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 2001-12-15, aeb -.TH swab 3 2023-10-31 "Linux man-pages 6.06" +.TH swab 3 2023-10-31 "Linux man-pages 6.7" .SH NAME swab \- swap adjacent bytes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sysconf.3 b/upstream/fedora-rawhide/man3/sysconf.3 index e4e57b64..29ce6bde 100644 --- a/upstream/fedora-rawhide/man3/sysconf.3 +++ b/upstream/fedora-rawhide/man3/sysconf.3 @@ -5,7 +5,7 @@ .\" .\" Modified Sat Jul 24 17:51:42 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Tue Aug 17 11:42:20 1999 by Ariel Scolnicov (ariels@compugen.co.il) -.TH sysconf 3 2023-10-31 "Linux man-pages 6.06" +.TH sysconf 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sysconf \- get configuration information at run time .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/syslog.3 b/upstream/fedora-rawhide/man3/syslog.3 index 485777f6..7b3c663e 100644 --- a/upstream/fedora-rawhide/man3/syslog.3 +++ b/upstream/fedora-rawhide/man3/syslog.3 @@ -15,7 +15,7 @@ .\" Modified 13 Dec 2001, Martin Schulze <joey@infodrom.org> .\" Modified 3 Jan 2002, Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH syslog 3 2023-10-31 "Linux man-pages 6.06" +.TH syslog 3 2023-10-31 "Linux man-pages 6.7" .SH NAME closelog, openlog, syslog, vsyslog \- send messages to the system logger .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/system.3 b/upstream/fedora-rawhide/man3/system.3 index 29cfbc55..08ffb074 100644 --- a/upstream/fedora-rawhide/man3/system.3 +++ b/upstream/fedora-rawhide/man3/system.3 @@ -9,7 +9,7 @@ .\" Modified 14 May 2001, 23 Sep 2001 by aeb .\" 2004-12-20, mtk .\" -.TH system 3 2023-10-31 "Linux man-pages 6.06" +.TH system 3 2023-10-31 "Linux man-pages 6.7" .SH NAME system \- execute a shell command .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/sysv_signal.3 b/upstream/fedora-rawhide/man3/sysv_signal.3 index f4351e07..0c0c161f 100644 --- a/upstream/fedora-rawhide/man3/sysv_signal.3 +++ b/upstream/fedora-rawhide/man3/sysv_signal.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sysv_signal 3 2023-10-31 "Linux man-pages 6.06" +.TH sysv_signal 3 2023-10-31 "Linux man-pages 6.7" .SH NAME sysv_signal \- signal handling with System V semantics .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/tailq.3 b/upstream/fedora-rawhide/man3/tailq.3 index 8beecf04..5e24501e 100644 --- a/upstream/fedora-rawhide/man3/tailq.3 +++ b/upstream/fedora-rawhide/man3/tailq.3 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: BSD-3-Clause .\" .\" -.TH TAILQ 3 2023-10-31 "Linux man-pages 6.06" +.TH TAILQ 3 2023-10-31 "Linux man-pages 6.7" .SH NAME TAILQ_CONCAT, TAILQ_EMPTY, diff --git a/upstream/fedora-rawhide/man3/tan.3 b/upstream/fedora-rawhide/man3/tan.3 index bef7feee..169a6ef3 100644 --- a/upstream/fedora-rawhide/man3/tan.3 +++ b/upstream/fedora-rawhide/man3/tan.3 @@ -13,7 +13,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH tan 3 2023-10-31 "Linux man-pages 6.06" +.TH tan 3 2023-10-31 "Linux man-pages 6.7" .SH NAME tan, tanf, tanl \- tangent function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/tanh.3 b/upstream/fedora-rawhide/man3/tanh.3 index 9d9d194c..09d3e039 100644 --- a/upstream/fedora-rawhide/man3/tanh.3 +++ b/upstream/fedora-rawhide/man3/tanh.3 @@ -13,7 +13,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH tanh 3 2023-10-31 "Linux man-pages 6.06" +.TH tanh 3 2023-10-31 "Linux man-pages 6.7" .SH NAME tanh, tanhf, tanhl \- hyperbolic tangent function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/tcgetpgrp.3 b/upstream/fedora-rawhide/man3/tcgetpgrp.3 index 77e8f11b..d80baedf 100644 --- a/upstream/fedora-rawhide/man3/tcgetpgrp.3 +++ b/upstream/fedora-rawhide/man3/tcgetpgrp.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH tcgetpgrp 3 2023-10-31 "Linux man-pages 6.06" +.TH tcgetpgrp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME tcgetpgrp, tcsetpgrp \- get and set terminal foreground process group .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/tcgetsid.3 b/upstream/fedora-rawhide/man3/tcgetsid.3 index 959e75e8..f727dfde 100644 --- a/upstream/fedora-rawhide/man3/tcgetsid.3 +++ b/upstream/fedora-rawhide/man3/tcgetsid.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH tcgetsid 3 2023-10-31 "Linux man-pages 6.06" +.TH tcgetsid 3 2023-10-31 "Linux man-pages 6.7" .SH NAME tcgetsid \- get session ID .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/telldir.3 b/upstream/fedora-rawhide/man3/telldir.3 index a15a7380..dbc5d9c4 100644 --- a/upstream/fedora-rawhide/man3/telldir.3 +++ b/upstream/fedora-rawhide/man3/telldir.3 @@ -8,7 +8,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 17:48:42 1993 by Rik Faith (faith@cs.unc.edu) -.TH telldir 3 2023-10-31 "Linux man-pages 6.06" +.TH telldir 3 2023-10-31 "Linux man-pages 6.7" .SH NAME telldir \- return current location in directory stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/tempnam.3 b/upstream/fedora-rawhide/man3/tempnam.3 index 873b3ae8..e1b7380e 100644 --- a/upstream/fedora-rawhide/man3/tempnam.3 +++ b/upstream/fedora-rawhide/man3/tempnam.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH tempnam 3 2023-10-31 "Linux man-pages 6.06" +.TH tempnam 3 2023-10-31 "Linux man-pages 6.7" .SH NAME tempnam \- create a name for a temporary file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/termios.3 b/upstream/fedora-rawhide/man3/termios.3 index 78523a2e..28a54116 100644 --- a/upstream/fedora-rawhide/man3/termios.3 +++ b/upstream/fedora-rawhide/man3/termios.3 @@ -19,7 +19,7 @@ .\" Enhanced the discussion of "raw" mode for cfmakeraw(). .\" Document CMSPAR. .\" -.TH termios 3 2023-10-31 "Linux man-pages 6.06" +.TH termios 3 2023-10-31 "Linux man-pages 6.7" .SH NAME termios, tcgetattr, tcsetattr, tcsendbreak, tcdrain, tcflush, tcflow, cfmakeraw, cfgetospeed, cfgetispeed, cfsetispeed, cfsetospeed, cfsetspeed \- diff --git a/upstream/fedora-rawhide/man3/textdomain.3 b/upstream/fedora-rawhide/man3/textdomain.3 index aed23921..49d7dfc4 100644 --- a/upstream/fedora-rawhide/man3/textdomain.3 +++ b/upstream/fedora-rawhide/man3/textdomain.3 @@ -10,7 +10,7 @@ .\" GNU gettext source code and manual .\" LI18NUX 2000 Globalization Specification .\" -.TH TEXTDOMAIN 3 "May 2001" "GNU gettext 0.22.2" +.TH TEXTDOMAIN 3 "May 2001" "GNU gettext 0.22.5" .SH NAME textdomain \- set domain for future gettext() calls .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man3/tgamma.3 b/upstream/fedora-rawhide/man3/tgamma.3 index 89bab480..e62069cf 100644 --- a/upstream/fedora-rawhide/man3/tgamma.3 +++ b/upstream/fedora-rawhide/man3/tgamma.3 @@ -9,7 +9,7 @@ .\" Modified 2004-11-15, fixed error noted by Fabian Kreutz .\" <kreutz@dbs.uni-hannover.de> .\" -.TH tgamma 3 2023-10-31 "Linux man-pages 6.06" +.TH tgamma 3 2023-10-31 "Linux man-pages 6.7" .SH NAME tgamma, tgammaf, tgammal \- true gamma function .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/timegm.3 b/upstream/fedora-rawhide/man3/timegm.3 index a521333b..ab21d77e 100644 --- a/upstream/fedora-rawhide/man3/timegm.3 +++ b/upstream/fedora-rawhide/man3/timegm.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH timegm 3 2023-10-31 "Linux man-pages 6.06" +.TH timegm 3 2023-10-31 "Linux man-pages 6.7" .SH NAME timegm, timelocal \- inverses of gmtime and localtime .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/timeradd.3 b/upstream/fedora-rawhide/man3/timeradd.3 index 3f317b52..aba49a33 100644 --- a/upstream/fedora-rawhide/man3/timeradd.3 +++ b/upstream/fedora-rawhide/man3/timeradd.3 @@ -4,7 +4,7 @@ .\" .\" 2007-07-31, mtk, Created .\" -.TH timeradd 3 2023-10-31 "Linux man-pages 6.06" +.TH timeradd 3 2023-10-31 "Linux man-pages 6.7" .SH NAME timeradd, timersub, timercmp, timerclear, timerisset \- timeval operations .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/tmpfile.3 b/upstream/fedora-rawhide/man3/tmpfile.3 index 6dd760ba..d45202b9 100644 --- a/upstream/fedora-rawhide/man3/tmpfile.3 +++ b/upstream/fedora-rawhide/man3/tmpfile.3 @@ -9,7 +9,7 @@ .\" 386BSD man pages .\" Modified Sat Jul 24 17:46:57 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 2001-11-17, aeb -.TH tmpfile 3 2023-10-31 "Linux man-pages 6.06" +.TH tmpfile 3 2023-10-31 "Linux man-pages 6.7" .SH NAME tmpfile \- create a temporary file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/tmpnam.3 b/upstream/fedora-rawhide/man3/tmpnam.3 index 13799eea..157c9a7e 100644 --- a/upstream/fedora-rawhide/man3/tmpnam.3 +++ b/upstream/fedora-rawhide/man3/tmpnam.3 @@ -5,7 +5,7 @@ .\" .\" 2003-11-15, aeb, added tmpnam_r .\" -.TH tmpnam 3 2023-10-31 "Linux man-pages 6.06" +.TH tmpnam 3 2023-10-31 "Linux man-pages 6.7" .SH NAME tmpnam, tmpnam_r \- create a name for a temporary file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/toascii.3 b/upstream/fedora-rawhide/man3/toascii.3 index 245b3ab3..20b91cda 100644 --- a/upstream/fedora-rawhide/man3/toascii.3 +++ b/upstream/fedora-rawhide/man3/toascii.3 @@ -5,7 +5,7 @@ .\" .\" Added BUGS section, aeb, 950919 .\" -.TH toascii 3 2023-10-31 "Linux man-pages 6.06" +.TH toascii 3 2023-10-31 "Linux man-pages 6.7" .SH NAME toascii \- convert character to ASCII .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/toupper.3 b/upstream/fedora-rawhide/man3/toupper.3 index 05cfdc51..84500c22 100644 --- a/upstream/fedora-rawhide/man3/toupper.3 +++ b/upstream/fedora-rawhide/man3/toupper.3 @@ -6,7 +6,7 @@ .\" .\" Modified Sat Jul 24 17:45:39 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 2000-02-13 by Nicolás Lichtmaier <nick@debian.org> -.TH toupper 3 2023-10-31 "Linux man-pages 6.06" +.TH toupper 3 2024-02-25 "Linux man-pages 6.7" .SH NAME toupper, tolower, toupper_l, tolower_l \- convert uppercase or lowercase .SH LIBRARY @@ -166,7 +166,7 @@ yielding a value that is outside the range of The details of what constitutes an uppercase or lowercase letter depend on the locale. For example, the default -.B """C""" +.B \[dq]C\[dq] locale does not know about umlauts, so no conversion is done for them. .P In some non-English locales, there are lowercase letters with no diff --git a/upstream/fedora-rawhide/man3/towctrans.3 b/upstream/fedora-rawhide/man3/towctrans.3 index e122d59c..7e30c872 100644 --- a/upstream/fedora-rawhide/man3/towctrans.3 +++ b/upstream/fedora-rawhide/man3/towctrans.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH towctrans 3 2023-10-31 "Linux man-pages 6.06" +.TH towctrans 3 2023-10-31 "Linux man-pages 6.7" .SH NAME towctrans \- wide-character transliteration .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/towlower.3 b/upstream/fedora-rawhide/man3/towlower.3 index 1e4d1d26..3a5f2037 100644 --- a/upstream/fedora-rawhide/man3/towlower.3 +++ b/upstream/fedora-rawhide/man3/towlower.3 @@ -10,7 +10,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH towlower 3 2023-10-31 "Linux man-pages 6.06" +.TH towlower 3 2023-10-31 "Linux man-pages 6.7" .SH NAME towlower, towlower_l \- convert a wide character to lowercase .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/towupper.3 b/upstream/fedora-rawhide/man3/towupper.3 index d3c77d9b..fe3d609e 100644 --- a/upstream/fedora-rawhide/man3/towupper.3 +++ b/upstream/fedora-rawhide/man3/towupper.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH towupper 3 2023-10-31 "Linux man-pages 6.06" +.TH towupper 3 2023-10-31 "Linux man-pages 6.7" .SH NAME towupper, towupper_l \- convert a wide character to uppercase .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/trunc.3 b/upstream/fedora-rawhide/man3/trunc.3 index e609aa89..1c90c810 100644 --- a/upstream/fedora-rawhide/man3/trunc.3 +++ b/upstream/fedora-rawhide/man3/trunc.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH trunc 3 2023-10-31 "Linux man-pages 6.06" +.TH trunc 3 2023-10-31 "Linux man-pages 6.7" .SH NAME trunc, truncf, truncl \- round to integer, toward zero .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/tsearch.3 b/upstream/fedora-rawhide/man3/tsearch.3 index 933a3bed..1343cbef 100644 --- a/upstream/fedora-rawhide/man3/tsearch.3 +++ b/upstream/fedora-rawhide/man3/tsearch.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH tsearch 3 2023-10-31 "Linux man-pages 6.06" +.TH tsearch 3 2023-10-31 "Linux man-pages 6.7" .SH NAME tsearch, tfind, tdelete, twalk, twalk_r, tdestroy \- manage a binary search tree .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ttyname.3 b/upstream/fedora-rawhide/man3/ttyname.3 index 9007204d..ca12a14e 100644 --- a/upstream/fedora-rawhide/man3/ttyname.3 +++ b/upstream/fedora-rawhide/man3/ttyname.3 @@ -6,7 +6,7 @@ .\" Modified 2001-12-13, Martin Schulze <joey@infodrom.org> .\" Added ttyname_r, aeb, 2002-07-20 .\" -.TH ttyname 3 2023-10-31 "Linux man-pages 6.06" +.TH ttyname 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ttyname, ttyname_r \- return name of a terminal .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ttyslot.3 b/upstream/fedora-rawhide/man3/ttyslot.3 index a36f186f..f4eaa7f5 100644 --- a/upstream/fedora-rawhide/man3/ttyslot.3 +++ b/upstream/fedora-rawhide/man3/ttyslot.3 @@ -6,7 +6,7 @@ .\" This replaces an earlier man page written by Walter Harms .\" <walter.harms@informatik.uni-oldenburg.de>. .\" -.TH ttyslot 3 2023-10-31 "Linux man-pages 6.06" +.TH ttyslot 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ttyslot \- find the slot of the current user's terminal in some file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/tzset.3 b/upstream/fedora-rawhide/man3/tzset.3 index 3ef33fd4..3c976842 100644 --- a/upstream/fedora-rawhide/man3/tzset.3 +++ b/upstream/fedora-rawhide/man3/tzset.3 @@ -11,7 +11,7 @@ .\" Modified 2001-11-13, aeb .\" Modified 2004-12-01 mtk and Martin Schulze <joey@infodrom.org> .\" -.TH tzset 3 2023-10-31 "Linux man-pages 6.06" +.TH tzset 3 2023-10-31 "Linux man-pages 6.7" .SH NAME tzset, tzname, timezone, daylight \- initialize time conversion information .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/ualarm.3 b/upstream/fedora-rawhide/man3/ualarm.3 index 622c7cef..0d4275cf 100644 --- a/upstream/fedora-rawhide/man3/ualarm.3 +++ b/upstream/fedora-rawhide/man3/ualarm.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ualarm 3 2023-10-31 "Linux man-pages 6.06" +.TH ualarm 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ualarm \- schedule signal after given number of microseconds .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/udev_device_get_syspath.3 b/upstream/fedora-rawhide/man3/udev_device_get_syspath.3 index c0abedf4..c77de83e 100644 --- a/upstream/fedora-rawhide/man3/udev_device_get_syspath.3 +++ b/upstream/fedora-rawhide/man3/udev_device_get_syspath.3 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV_DEVICE_GET_SYSPATH" "3" "" "systemd 255" "udev_device_get_syspath" +.TH "UDEV_DEVICE_GET_SYSPATH" "3" "" "systemd 256~rc3" "udev_device_get_syspath" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -114,10 +114,4 @@ or were added in version 221\&. .SH "SEE ALSO" .PP -\fBudev_new\fR(3), -\fBudev_device_new_from_syspath\fR(3), -\fBudev_device_has_tag\fR(3), -\fBudev_enumerate_new\fR(3), -\fBudev_monitor_new_from_netlink\fR(3), -\fBudev_list_entry\fR(3), -\fBsystemd\fR(1) +\fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_device_has_tag\fR(3), \fBudev_enumerate_new\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBudev_list_entry\fR(3), \fBsystemd\fR(1) diff --git a/upstream/fedora-rawhide/man3/udev_device_has_tag.3 b/upstream/fedora-rawhide/man3/udev_device_has_tag.3 index b72f0924..e9d307e4 100644 --- a/upstream/fedora-rawhide/man3/udev_device_has_tag.3 +++ b/upstream/fedora-rawhide/man3/udev_device_has_tag.3 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV_DEVICE_HAS_TAG" "3" "" "systemd 255" "udev_device_has_tag" +.TH "UDEV_DEVICE_HAS_TAG" "3" "" "systemd 256~rc3" "udev_device_has_tag" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -123,11 +123,4 @@ and were added in version 247\&. .SH "SEE ALSO" .PP -\fBudev\fR(7), -\fBudev_new\fR(3), -\fBudev_device_new_from_syspath\fR(3), -\fBudev_device_get_syspath\fR(3), -\fBudev_enumerate_new\fR(3), -\fBudev_monitor_new_from_netlink\fR(3), -\fBudev_list_entry\fR(3), -\fBsystemd\fR(1), +\fBudev\fR(7), \fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_device_get_syspath\fR(3), \fBudev_enumerate_new\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBudev_list_entry\fR(3), \fBsystemd\fR(1) diff --git a/upstream/fedora-rawhide/man3/udev_device_new_from_syspath.3 b/upstream/fedora-rawhide/man3/udev_device_new_from_syspath.3 index 2382b067..4055d631 100644 --- a/upstream/fedora-rawhide/man3/udev_device_new_from_syspath.3 +++ b/upstream/fedora-rawhide/man3/udev_device_new_from_syspath.3 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV_DEVICE_NEW_FROM_SYSPATH" "3" "" "systemd 255" "udev_device_new_from_syspath" +.TH "UDEV_DEVICE_NEW_FROM_SYSPATH" "3" "" "systemd 256~rc3" "udev_device_new_from_syspath" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -161,10 +161,4 @@ always returns were added in version 221\&. .SH "SEE ALSO" .PP -\fBudev_new\fR(3), -\fBudev_device_get_syspath\fR(3), -\fBudev_device_has_tag\fR(3), -\fBudev_enumerate_new\fR(3), -\fBudev_monitor_new_from_netlink\fR(3), -\fBudev_list_entry\fR(3), -\fBsystemd\fR(1), +\fBudev_new\fR(3), \fBudev_device_get_syspath\fR(3), \fBudev_device_has_tag\fR(3), \fBudev_enumerate_new\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBudev_list_entry\fR(3), \fBsystemd\fR(1) diff --git a/upstream/fedora-rawhide/man3/udev_enumerate_add_match_subsystem.3 b/upstream/fedora-rawhide/man3/udev_enumerate_add_match_subsystem.3 index ea991502..f003ead8 100644 --- a/upstream/fedora-rawhide/man3/udev_enumerate_add_match_subsystem.3 +++ b/upstream/fedora-rawhide/man3/udev_enumerate_add_match_subsystem.3 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV_ENUMERATE_ADD_MATCH_SUBSYSTEM" "3" "" "systemd 255" "udev_enumerate_add_match_subsystem" +.TH "UDEV_ENUMERATE_ADD_MATCH_SUBSYSTEM" "3" "" "systemd 256~rc3" "udev_enumerate_add_match_subsystem" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -75,10 +75,4 @@ return an integer greater than, or equal to, were added in version 221\&. .SH "SEE ALSO" .PP -\fBudev_new\fR(3), -\fBudev_device_new_from_syspath\fR(3), -\fBudev_enumerate_new\fR(3), -\fBudev_enumerate_scan_devices\fR(3), -\fBudev_monitor_new_from_netlink\fR(3), -\fBudev_list_entry\fR(3), -\fBsystemd\fR(1), +\fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_enumerate_new\fR(3), \fBudev_enumerate_scan_devices\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBudev_list_entry\fR(3), \fBsystemd\fR(1) diff --git a/upstream/fedora-rawhide/man3/udev_enumerate_new.3 b/upstream/fedora-rawhide/man3/udev_enumerate_new.3 index 6bb67eff..2be19d06 100644 --- a/upstream/fedora-rawhide/man3/udev_enumerate_new.3 +++ b/upstream/fedora-rawhide/man3/udev_enumerate_new.3 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV_ENUMERATE_NEW" "3" "" "systemd 255" "udev_enumerate_new" +.TH "UDEV_ENUMERATE_NEW" "3" "" "systemd 256~rc3" "udev_enumerate_new" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -54,10 +54,4 @@ always returns were added in version 221\&. .SH "SEE ALSO" .PP -\fBudev_new\fR(3), -\fBudev_device_new_from_syspath\fR(3), -\fBudev_enumerate_add_match_subsystem\fR(3), -\fBudev_enumerate_scan_devices\fR(3), -\fBudev_monitor_new_from_netlink\fR(3), -\fBudev_list_entry\fR(3), -\fBsystemd\fR(1), +\fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_enumerate_add_match_subsystem\fR(3), \fBudev_enumerate_scan_devices\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBudev_list_entry\fR(3), \fBsystemd\fR(1) diff --git a/upstream/fedora-rawhide/man3/udev_enumerate_scan_devices.3 b/upstream/fedora-rawhide/man3/udev_enumerate_scan_devices.3 index f92a0c60..fdcef85e 100644 --- a/upstream/fedora-rawhide/man3/udev_enumerate_scan_devices.3 +++ b/upstream/fedora-rawhide/man3/udev_enumerate_scan_devices.3 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV_ENUMERATE_SCAN_DEVICES" "3" "" "systemd 255" "udev_enumerate_scan_devices" +.TH "UDEV_ENUMERATE_SCAN_DEVICES" "3" "" "systemd 256~rc3" "udev_enumerate_scan_devices" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -66,10 +66,4 @@ always returns a pointer to the udev context that this enumerated object is asso were added in version 221\&. .SH "SEE ALSO" .PP -\fBudev_new\fR(3), -\fBudev_device_new_from_syspath\fR(3), -\fBudev_enumerate_new\fR(3), -\fBudev_enumerate_add_match_subsystem\fR(3), -\fBudev_monitor_new_from_netlink\fR(3), -\fBudev_list_entry\fR(3), -\fBsystemd\fR(1), +\fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_enumerate_new\fR(3), \fBudev_enumerate_add_match_subsystem\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBudev_list_entry\fR(3), \fBsystemd\fR(1) diff --git a/upstream/fedora-rawhide/man3/udev_list_entry.3 b/upstream/fedora-rawhide/man3/udev_list_entry.3 index 8b3d7250..ef52b9a1 100644 --- a/upstream/fedora-rawhide/man3/udev_list_entry.3 +++ b/upstream/fedora-rawhide/man3/udev_list_entry.3 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV_LIST_ENTRY" "3" "" "systemd 255" "udev_list_entry" +.TH "UDEV_LIST_ENTRY" "3" "" "systemd 256~rc3" "udev_list_entry" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -62,8 +62,4 @@ is returned\&. were added in version 221\&. .SH "SEE ALSO" .PP -\fBudev_new\fR(3), -\fBudev_device_new_from_syspath\fR(3), -\fBudev_enumerate_new\fR(3), -\fBudev_monitor_new_from_netlink\fR(3), -\fBsystemd\fR(1), +\fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_enumerate_new\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBsystemd\fR(1) diff --git a/upstream/fedora-rawhide/man3/udev_monitor_filter_update.3 b/upstream/fedora-rawhide/man3/udev_monitor_filter_update.3 index 3f1006b2..1bdefb73 100644 --- a/upstream/fedora-rawhide/man3/udev_monitor_filter_update.3 +++ b/upstream/fedora-rawhide/man3/udev_monitor_filter_update.3 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV_MONITOR_FILTER_UPDATE" "3" "" "systemd 255" "udev_monitor_filter_update" +.TH "UDEV_MONITOR_FILTER_UPDATE" "3" "" "systemd 256~rc3" "udev_monitor_filter_update" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -55,10 +55,4 @@ return an integer greater than, or equal to, were added in version 221\&. .SH "SEE ALSO" .PP -\fBudev_new\fR(3), -\fBudev_device_new_from_syspath\fR(3), -\fBudev_enumerate_new\fR(3), -\fBudev_monitor_new_from_netlink\fR(3), -\fBudev_monitor_receive_device\fR(3), -\fBudev_list_entry\fR(3), -\fBsystemd\fR(1), +\fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_enumerate_new\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBudev_monitor_receive_device\fR(3), \fBudev_list_entry\fR(3), \fBsystemd\fR(1) diff --git a/upstream/fedora-rawhide/man3/udev_monitor_new_from_netlink.3 b/upstream/fedora-rawhide/man3/udev_monitor_new_from_netlink.3 index f68e2517..417ce8bc 100644 --- a/upstream/fedora-rawhide/man3/udev_monitor_new_from_netlink.3 +++ b/upstream/fedora-rawhide/man3/udev_monitor_new_from_netlink.3 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV_MONITOR_NEW_FROM_NETLINK" "3" "" "systemd 255" "udev_monitor_new_from_netlink" +.TH "UDEV_MONITOR_NEW_FROM_NETLINK" "3" "" "systemd 256~rc3" "udev_monitor_new_from_netlink" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -54,10 +54,4 @@ always returns were added in version 221\&. .SH "SEE ALSO" .PP -\fBudev_new\fR(3), -\fBudev_device_new_from_syspath\fR(3), -\fBudev_enumerate_new\fR(3), -\fBudev_monitor_filter_update\fR(3), -\fBudev_monitor_receive_device\fR(3), -\fBudev_list_entry\fR(3), -\fBsystemd\fR(1), +\fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_enumerate_new\fR(3), \fBudev_monitor_filter_update\fR(3), \fBudev_monitor_receive_device\fR(3), \fBudev_list_entry\fR(3), \fBsystemd\fR(1) diff --git a/upstream/fedora-rawhide/man3/udev_monitor_receive_device.3 b/upstream/fedora-rawhide/man3/udev_monitor_receive_device.3 index 01d3f1b3..7283eed6 100644 --- a/upstream/fedora-rawhide/man3/udev_monitor_receive_device.3 +++ b/upstream/fedora-rawhide/man3/udev_monitor_receive_device.3 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV_MONITOR_RECEIVE_DEVICE" "3" "" "systemd 255" "udev_monitor_receive_device" +.TH "UDEV_MONITOR_RECEIVE_DEVICE" "3" "" "systemd 256~rc3" "udev_monitor_receive_device" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -69,10 +69,4 @@ always returns a pointer to the udev context that this monitor is associated wit were added in version 221\&. .SH "SEE ALSO" .PP -\fBudev_new\fR(3), -\fBudev_device_new_from_syspath\fR(3), -\fBudev_enumerate_new\fR(3), -\fBudev_monitor_new_from_netlink\fR(3), -\fBudev_monitor_filter_update\fR(3), -\fBudev_list_entry\fR(3), -\fBsystemd\fR(1), +\fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_enumerate_new\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBudev_monitor_filter_update\fR(3), \fBudev_list_entry\fR(3), \fBsystemd\fR(1) diff --git a/upstream/fedora-rawhide/man3/udev_new.3 b/upstream/fedora-rawhide/man3/udev_new.3 index 1e67a77d..9445bf7e 100644 --- a/upstream/fedora-rawhide/man3/udev_new.3 +++ b/upstream/fedora-rawhide/man3/udev_new.3 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV_NEW" "3" "" "systemd 255" "udev_new" +.TH "UDEV_NEW" "3" "" "systemd 256~rc3" "udev_new" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man3/ulimit.3 b/upstream/fedora-rawhide/man3/ulimit.3 index ff8c64fa..f0034824 100644 --- a/upstream/fedora-rawhide/man3/ulimit.3 +++ b/upstream/fedora-rawhide/man3/ulimit.3 @@ -5,7 +5,7 @@ .\" .\" Moved to man3, aeb, 980612 .\" -.TH ulimit 3 2023-10-31 "Linux man-pages 6.06" +.TH ulimit 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ulimit \- get and set user limits .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/undocumented.3 b/upstream/fedora-rawhide/man3/undocumented.3 index 6fab6b27..b67b9f02 100644 --- a/upstream/fedora-rawhide/man3/undocumented.3 +++ b/upstream/fedora-rawhide/man3/undocumented.3 @@ -7,7 +7,7 @@ .\" 2004-10-31, aeb, changed maintainer address, updated list .\" 2015-04-20, william@tuffbizz.com, updated list .\" -.TH undocumented 3 2022-10-30 "Linux man-pages 6.06" +.TH undocumented 3 2022-10-30 "Linux man-pages 6.7" .SH NAME undocumented \- undocumented library functions .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man3/ungetwc.3 b/upstream/fedora-rawhide/man3/ungetwc.3 index 4aaff0a2..2b163221 100644 --- a/upstream/fedora-rawhide/man3/ungetwc.3 +++ b/upstream/fedora-rawhide/man3/ungetwc.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH ungetwc 3 2023-10-31 "Linux man-pages 6.06" +.TH ungetwc 3 2023-10-31 "Linux man-pages 6.7" .SH NAME ungetwc \- push back a wide character onto a FILE stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/unlocked_stdio.3 b/upstream/fedora-rawhide/man3/unlocked_stdio.3 index 7cc6f023..627bfbcc 100644 --- a/upstream/fedora-rawhide/man3/unlocked_stdio.3 +++ b/upstream/fedora-rawhide/man3/unlocked_stdio.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH unlocked_stdio 3 2023-10-31 "Linux man-pages 6.06" +.TH unlocked_stdio 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getc_unlocked, getchar_unlocked, putc_unlocked, putchar_unlocked \- nonlocking stdio functions diff --git a/upstream/fedora-rawhide/man3/unlockpt.3 b/upstream/fedora-rawhide/man3/unlockpt.3 index 9d173ace..87608705 100644 --- a/upstream/fedora-rawhide/man3/unlockpt.3 +++ b/upstream/fedora-rawhide/man3/unlockpt.3 @@ -3,7 +3,7 @@ .\" This page is in the public domain. - aeb .\" %%%LICENSE_END .\" -.TH unlockpt 3 2023-10-31 "Linux man-pages 6.06" +.TH unlockpt 3 2023-10-31 "Linux man-pages 6.7" .SH NAME unlockpt \- unlock a pseudoterminal master/slave pair .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/updwtmp.3 b/upstream/fedora-rawhide/man3/updwtmp.3 index a2dc7da2..65483934 100644 --- a/upstream/fedora-rawhide/man3/updwtmp.3 +++ b/upstream/fedora-rawhide/man3/updwtmp.3 @@ -8,7 +8,7 @@ .\" Added -lutil remark, 030718 .\" 2008-07-02, mtk, document updwtmpx() .\" -.TH updwtmp 3 2023-10-31 "Linux man-pages 6.06" +.TH updwtmp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME updwtmp, logwtmp \- append an entry to the wtmp file .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/uselocale.3 b/upstream/fedora-rawhide/man3/uselocale.3 index c0d632d3..6e976493 100644 --- a/upstream/fedora-rawhide/man3/uselocale.3 +++ b/upstream/fedora-rawhide/man3/uselocale.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH uselocale 3 2023-10-31 "Linux man-pages 6.06" +.TH uselocale 3 2023-10-31 "Linux man-pages 6.7" .SH NAME uselocale \- set/get the locale for the calling thread .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/usleep.3 b/upstream/fedora-rawhide/man3/usleep.3 index 34c09a03..cb3ee05f 100644 --- a/upstream/fedora-rawhide/man3/usleep.3 +++ b/upstream/fedora-rawhide/man3/usleep.3 @@ -11,7 +11,7 @@ .\" Modified 2001-04-01 by aeb .\" Modified 2003-07-23 by aeb .\" -.TH usleep 3 2023-10-31 "Linux man-pages 6.06" +.TH usleep 3 2023-10-31 "Linux man-pages 6.7" .SH NAME usleep \- suspend execution for microsecond intervals .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcpcpy.3 b/upstream/fedora-rawhide/man3/wcpcpy.3 index ed3c86c9..ea83da89 100644 --- a/upstream/fedora-rawhide/man3/wcpcpy.3 +++ b/upstream/fedora-rawhide/man3/wcpcpy.3 @@ -8,7 +8,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH wcpcpy 3 2023-10-31 "Linux man-pages 6.06" +.TH wcpcpy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcpcpy \- copy a wide-character string, returning a pointer to its end .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcpncpy.3 b/upstream/fedora-rawhide/man3/wcpncpy.3 index b1530beb..dcb39119 100644 --- a/upstream/fedora-rawhide/man3/wcpncpy.3 +++ b/upstream/fedora-rawhide/man3/wcpncpy.3 @@ -8,7 +8,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH wcpncpy 3 2023-10-31 "Linux man-pages 6.06" +.TH wcpncpy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcpncpy \- copy a fixed-size string of wide characters, returning a pointer to its end diff --git a/upstream/fedora-rawhide/man3/wcrtomb.3 b/upstream/fedora-rawhide/man3/wcrtomb.3 index af44f7ed..9957bd03 100644 --- a/upstream/fedora-rawhide/man3/wcrtomb.3 +++ b/upstream/fedora-rawhide/man3/wcrtomb.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcrtomb 3 2023-10-31 "Linux man-pages 6.06" +.TH wcrtomb 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcrtomb \- convert a wide character to a multibyte sequence .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcscasecmp.3 b/upstream/fedora-rawhide/man3/wcscasecmp.3 index 672eaca9..121fa454 100644 --- a/upstream/fedora-rawhide/man3/wcscasecmp.3 +++ b/upstream/fedora-rawhide/man3/wcscasecmp.3 @@ -8,7 +8,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH wcscasecmp 3 2023-10-31 "Linux man-pages 6.06" +.TH wcscasecmp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcscasecmp \- compare two wide-character strings, ignoring case .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcscat.3 b/upstream/fedora-rawhide/man3/wcscat.3 index c77e5e7c..36c8fc9b 100644 --- a/upstream/fedora-rawhide/man3/wcscat.3 +++ b/upstream/fedora-rawhide/man3/wcscat.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcscat 3 2023-10-31 "Linux man-pages 6.06" +.TH wcscat 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcscat \- concatenate two wide-character strings .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcschr.3 b/upstream/fedora-rawhide/man3/wcschr.3 index 1838cb1f..e8f017e0 100644 --- a/upstream/fedora-rawhide/man3/wcschr.3 +++ b/upstream/fedora-rawhide/man3/wcschr.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcschr 3 2023-10-31 "Linux man-pages 6.06" +.TH wcschr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcschr \- search a wide character in a wide-character string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcscmp.3 b/upstream/fedora-rawhide/man3/wcscmp.3 index 82df840c..04d1eb5c 100644 --- a/upstream/fedora-rawhide/man3/wcscmp.3 +++ b/upstream/fedora-rawhide/man3/wcscmp.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcscmp 3 2023-10-31 "Linux man-pages 6.06" +.TH wcscmp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcscmp \- compare two wide-character strings .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcscpy.3 b/upstream/fedora-rawhide/man3/wcscpy.3 index 0c90e9be..cdb33a08 100644 --- a/upstream/fedora-rawhide/man3/wcscpy.3 +++ b/upstream/fedora-rawhide/man3/wcscpy.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcscpy 3 2023-10-31 "Linux man-pages 6.06" +.TH wcscpy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcscpy \- copy a wide-character string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcscspn.3 b/upstream/fedora-rawhide/man3/wcscspn.3 index 84b0dc81..d427a4c1 100644 --- a/upstream/fedora-rawhide/man3/wcscspn.3 +++ b/upstream/fedora-rawhide/man3/wcscspn.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcscspn 3 2023-10-31 "Linux man-pages 6.06" +.TH wcscspn 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcscspn \- search a wide-character string for any of a set of wide characters .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcsdup.3 b/upstream/fedora-rawhide/man3/wcsdup.3 index da85a6de..58dc92cb 100644 --- a/upstream/fedora-rawhide/man3/wcsdup.3 +++ b/upstream/fedora-rawhide/man3/wcsdup.3 @@ -8,7 +8,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH wcsdup 3 2023-10-31 "Linux man-pages 6.06" +.TH wcsdup 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcsdup \- duplicate a wide-character string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcslen.3 b/upstream/fedora-rawhide/man3/wcslen.3 index 4481bcf8..223c274d 100644 --- a/upstream/fedora-rawhide/man3/wcslen.3 +++ b/upstream/fedora-rawhide/man3/wcslen.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcslen 3 2023-10-31 "Linux man-pages 6.06" +.TH wcslen 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcslen \- determine the length of a wide-character string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcsncasecmp.3 b/upstream/fedora-rawhide/man3/wcsncasecmp.3 index 4107beb1..b4d0ea63 100644 --- a/upstream/fedora-rawhide/man3/wcsncasecmp.3 +++ b/upstream/fedora-rawhide/man3/wcsncasecmp.3 @@ -8,7 +8,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH wcsncasecmp 3 2023-10-31 "Linux man-pages 6.06" +.TH wcsncasecmp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcsncasecmp \- compare two fixed-size wide-character strings, ignoring case .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcsncat.3 b/upstream/fedora-rawhide/man3/wcsncat.3 index e2e18414..131b8b68 100644 --- a/upstream/fedora-rawhide/man3/wcsncat.3 +++ b/upstream/fedora-rawhide/man3/wcsncat.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcsncat 3 2023-10-31 "Linux man-pages 6.06" +.TH wcsncat 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcsncat \- concatenate two wide-character strings .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcsncmp.3 b/upstream/fedora-rawhide/man3/wcsncmp.3 index f6f87600..bbf490d6 100644 --- a/upstream/fedora-rawhide/man3/wcsncmp.3 +++ b/upstream/fedora-rawhide/man3/wcsncmp.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcsncmp 3 2023-10-31 "Linux man-pages 6.06" +.TH wcsncmp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcsncmp \- compare two fixed-size wide-character strings .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcsncpy.3 b/upstream/fedora-rawhide/man3/wcsncpy.3 index 247e9aaf..82bdbef8 100644 --- a/upstream/fedora-rawhide/man3/wcsncpy.3 +++ b/upstream/fedora-rawhide/man3/wcsncpy.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcsncpy 3 2023-10-31 "Linux man-pages 6.06" +.TH wcsncpy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcsncpy \- copy a fixed-size string of wide characters .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcsnlen.3 b/upstream/fedora-rawhide/man3/wcsnlen.3 index 3398b601..3f846e41 100644 --- a/upstream/fedora-rawhide/man3/wcsnlen.3 +++ b/upstream/fedora-rawhide/man3/wcsnlen.3 @@ -8,7 +8,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH wcsnlen 3 2023-10-31 "Linux man-pages 6.06" +.TH wcsnlen 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcsnlen \- determine the length of a fixed-size wide-character string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcsnrtombs.3 b/upstream/fedora-rawhide/man3/wcsnrtombs.3 index 44241532..787d56f1 100644 --- a/upstream/fedora-rawhide/man3/wcsnrtombs.3 +++ b/upstream/fedora-rawhide/man3/wcsnrtombs.3 @@ -8,7 +8,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH wcsnrtombs 3 2023-10-31 "Linux man-pages 6.06" +.TH wcsnrtombs 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcsnrtombs \- convert a wide-character string to a multibyte string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcspbrk.3 b/upstream/fedora-rawhide/man3/wcspbrk.3 index 2cd60cc5..ec76fd6e 100644 --- a/upstream/fedora-rawhide/man3/wcspbrk.3 +++ b/upstream/fedora-rawhide/man3/wcspbrk.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcspbrk 3 2023-10-31 "Linux man-pages 6.06" +.TH wcspbrk 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcspbrk \- search a wide-character string for any of a set of wide characters .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcsrchr.3 b/upstream/fedora-rawhide/man3/wcsrchr.3 index 8345be8f..59b24766 100644 --- a/upstream/fedora-rawhide/man3/wcsrchr.3 +++ b/upstream/fedora-rawhide/man3/wcsrchr.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcsrchr 3 2023-10-31 "Linux man-pages 6.06" +.TH wcsrchr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcsrchr \- search a wide character in a wide-character string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcsrtombs.3 b/upstream/fedora-rawhide/man3/wcsrtombs.3 index fdcecdc7..49a581f0 100644 --- a/upstream/fedora-rawhide/man3/wcsrtombs.3 +++ b/upstream/fedora-rawhide/man3/wcsrtombs.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcsrtombs 3 2023-10-31 "Linux man-pages 6.06" +.TH wcsrtombs 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcsrtombs \- convert a wide-character string to a multibyte string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcsspn.3 b/upstream/fedora-rawhide/man3/wcsspn.3 index 6c5279f2..b7b571a6 100644 --- a/upstream/fedora-rawhide/man3/wcsspn.3 +++ b/upstream/fedora-rawhide/man3/wcsspn.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcsspn 3 2023-10-31 "Linux man-pages 6.06" +.TH wcsspn 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcsspn \- get length of a prefix wide-character substring .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcsstr.3 b/upstream/fedora-rawhide/man3/wcsstr.3 index b4aee784..ae3746a2 100644 --- a/upstream/fedora-rawhide/man3/wcsstr.3 +++ b/upstream/fedora-rawhide/man3/wcsstr.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcsstr 3 2023-10-31 "Linux man-pages 6.06" +.TH wcsstr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcsstr \- locate a substring in a wide-character string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcstoimax.3 b/upstream/fedora-rawhide/man3/wcstoimax.3 index 32e52e92..82dea8e8 100644 --- a/upstream/fedora-rawhide/man3/wcstoimax.3 +++ b/upstream/fedora-rawhide/man3/wcstoimax.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH wcstoimax 3 2023-10-31 "Linux man-pages 6.06" +.TH wcstoimax 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcstoimax, wcstoumax \- convert wide-character string to integer .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcstok.3 b/upstream/fedora-rawhide/man3/wcstok.3 index 1f7a98be..26f18dba 100644 --- a/upstream/fedora-rawhide/man3/wcstok.3 +++ b/upstream/fedora-rawhide/man3/wcstok.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcstok 3 2023-10-31 "Linux man-pages 6.06" +.TH wcstok 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcstok \- split wide-character string into tokens .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcstombs.3 b/upstream/fedora-rawhide/man3/wcstombs.3 index 7f0fe451..85a6ae21 100644 --- a/upstream/fedora-rawhide/man3/wcstombs.3 +++ b/upstream/fedora-rawhide/man3/wcstombs.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wcstombs 3 2023-10-31 "Linux man-pages 6.06" +.TH wcstombs 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcstombs \- convert a wide-character string to a multibyte string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcswidth.3 b/upstream/fedora-rawhide/man3/wcswidth.3 index 6d3e40a4..2f5c1489 100644 --- a/upstream/fedora-rawhide/man3/wcswidth.3 +++ b/upstream/fedora-rawhide/man3/wcswidth.3 @@ -8,7 +8,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH wcswidth 3 2023-10-31 "Linux man-pages 6.06" +.TH wcswidth 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcswidth \- determine columns needed for a fixed-size wide-character string .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wctob.3 b/upstream/fedora-rawhide/man3/wctob.3 index 09341731..ff38a40a 100644 --- a/upstream/fedora-rawhide/man3/wctob.3 +++ b/upstream/fedora-rawhide/man3/wctob.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wctob 3 2023-10-31 "Linux man-pages 6.06" +.TH wctob 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wctob \- try to represent a wide character as a single byte .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wctomb.3 b/upstream/fedora-rawhide/man3/wctomb.3 index 6b3a9e96..9606dc89 100644 --- a/upstream/fedora-rawhide/man3/wctomb.3 +++ b/upstream/fedora-rawhide/man3/wctomb.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wctomb 3 2023-10-31 "Linux man-pages 6.06" +.TH wctomb 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wctomb \- convert a wide character to a multibyte sequence .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wctrans.3 b/upstream/fedora-rawhide/man3/wctrans.3 index 29ccf308..f7832eec 100644 --- a/upstream/fedora-rawhide/man3/wctrans.3 +++ b/upstream/fedora-rawhide/man3/wctrans.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wctrans 3 2023-10-31 "Linux man-pages 6.06" +.TH wctrans 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wctrans \- wide-character translation mapping .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wctype.3 b/upstream/fedora-rawhide/man3/wctype.3 index 4a1bcab4..48257b73 100644 --- a/upstream/fedora-rawhide/man3/wctype.3 +++ b/upstream/fedora-rawhide/man3/wctype.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wctype 3 2023-10-31 "Linux man-pages 6.06" +.TH wctype 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wctype \- wide-character classification .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wcwidth.3 b/upstream/fedora-rawhide/man3/wcwidth.3 index 9397d141..6942179f 100644 --- a/upstream/fedora-rawhide/man3/wcwidth.3 +++ b/upstream/fedora-rawhide/man3/wcwidth.3 @@ -8,7 +8,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH wcwidth 3 2023-10-31 "Linux man-pages 6.06" +.TH wcwidth 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wcwidth \- determine columns needed for a wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wmemchr.3 b/upstream/fedora-rawhide/man3/wmemchr.3 index 9770d896..059e2c03 100644 --- a/upstream/fedora-rawhide/man3/wmemchr.3 +++ b/upstream/fedora-rawhide/man3/wmemchr.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wmemchr 3 2023-10-31 "Linux man-pages 6.06" +.TH wmemchr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wmemchr \- search a wide character in a wide-character array .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wmemcmp.3 b/upstream/fedora-rawhide/man3/wmemcmp.3 index 6687199a..c3d9ebdc 100644 --- a/upstream/fedora-rawhide/man3/wmemcmp.3 +++ b/upstream/fedora-rawhide/man3/wmemcmp.3 @@ -8,7 +8,7 @@ .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" -.TH wmemcmp 3 2023-10-31 "Linux man-pages 6.06" +.TH wmemcmp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wmemcmp \- compare two arrays of wide-characters .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wmemcpy.3 b/upstream/fedora-rawhide/man3/wmemcpy.3 index 59043b86..781502e5 100644 --- a/upstream/fedora-rawhide/man3/wmemcpy.3 +++ b/upstream/fedora-rawhide/man3/wmemcpy.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wmemcpy 3 2023-10-31 "Linux man-pages 6.06" +.TH wmemcpy 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wmemcpy \- copy an array of wide-characters .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wmemmove.3 b/upstream/fedora-rawhide/man3/wmemmove.3 index bee481bf..2d011435 100644 --- a/upstream/fedora-rawhide/man3/wmemmove.3 +++ b/upstream/fedora-rawhide/man3/wmemmove.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wmemmove 3 2023-10-31 "Linux man-pages 6.06" +.TH wmemmove 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wmemmove \- copy an array of wide-characters .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wmemset.3 b/upstream/fedora-rawhide/man3/wmemset.3 index dd844337..3331d428 100644 --- a/upstream/fedora-rawhide/man3/wmemset.3 +++ b/upstream/fedora-rawhide/man3/wmemset.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wmemset 3 2023-10-31 "Linux man-pages 6.06" +.TH wmemset 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wmemset \- fill an array of wide-characters with a constant wide character .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wordexp.3 b/upstream/fedora-rawhide/man3/wordexp.3 index ef666a17..b0787075 100644 --- a/upstream/fedora-rawhide/man3/wordexp.3 +++ b/upstream/fedora-rawhide/man3/wordexp.3 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH wordexp 3 2023-10-31 "Linux man-pages 6.06" +.TH wordexp 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wordexp, wordfree \- perform word expansion like a posix-shell .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/wprintf.3 b/upstream/fedora-rawhide/man3/wprintf.3 index 757b74e5..4140496d 100644 --- a/upstream/fedora-rawhide/man3/wprintf.3 +++ b/upstream/fedora-rawhide/man3/wprintf.3 @@ -9,7 +9,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH wprintf 3 2023-10-31 "Linux man-pages 6.06" +.TH wprintf 3 2023-10-31 "Linux man-pages 6.7" .SH NAME wprintf, fwprintf, swprintf, vwprintf, vfwprintf, vswprintf \- formatted wide-character output conversion diff --git a/upstream/fedora-rawhide/man3/xcrypt.3 b/upstream/fedora-rawhide/man3/xcrypt.3 index cd139b5c..320523f6 100644 --- a/upstream/fedora-rawhide/man3/xcrypt.3 +++ b/upstream/fedora-rawhide/man3/xcrypt.3 @@ -9,7 +9,7 @@ .\" 3. xencrypt() a hexstring .\" to bad to be true :( .\" -.TH XCRYPT 3 2023-10-31 "Linux man-pages 6.06" +.TH XCRYPT 3 2023-10-31 "Linux man-pages 6.7" .SH NAME xencrypt, xdecrypt, passwd2des \- RFS password encryption .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/xdr.3 b/upstream/fedora-rawhide/man3/xdr.3 index ae82885c..b0673488 100644 --- a/upstream/fedora-rawhide/man3/xdr.3 +++ b/upstream/fedora-rawhide/man3/xdr.3 @@ -9,7 +9,7 @@ .\" .\" 2007-12-30, mtk, Convert function prototypes to modern C syntax .\" -.TH xdr 3 2023-10-31 "Linux man-pages 6.06" +.TH xdr 3 2023-10-31 "Linux man-pages 6.7" .SH NAME xdr \- library routines for external data representation .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3/y0.3 b/upstream/fedora-rawhide/man3/y0.3 index 7058b7b2..e8cfc91e 100644 --- a/upstream/fedora-rawhide/man3/y0.3 +++ b/upstream/fedora-rawhide/man3/y0.3 @@ -14,7 +14,7 @@ .\" Modified 2004-11-12 as per suggestion by Fabian Kreutz/AEB .\" 2008-07-24, mtk, created this page, based on material from j0.3. .\" -.TH y0 3 2023-10-31 "Linux man-pages 6.06" +.TH y0 3 2023-10-31 "Linux man-pages 6.7" .SH NAME y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl \- Bessel functions of the second kind diff --git a/upstream/fedora-rawhide/man3const/EOF.3const b/upstream/fedora-rawhide/man3const/EOF.3const index 165f5e00..5b961a42 100644 --- a/upstream/fedora-rawhide/man3const/EOF.3const +++ b/upstream/fedora-rawhide/man3const/EOF.3const @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH EOF 3const 2023-10-31 "Linux man-pages 6.06" +.TH EOF 3const 2023-10-31 "Linux man-pages 6.7" .SH NAME EOF \- end of file or error indicator .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3const/EXIT_SUCCESS.3const b/upstream/fedora-rawhide/man3const/EXIT_SUCCESS.3const index 0a3939d1..515305fa 100644 --- a/upstream/fedora-rawhide/man3const/EXIT_SUCCESS.3const +++ b/upstream/fedora-rawhide/man3const/EXIT_SUCCESS.3const @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH EXIT_SUCCESS 3const 2023-10-31 "Linux man-pages 6.06" +.TH EXIT_SUCCESS 3const 2023-10-31 "Linux man-pages 6.7" .SH NAME EXIT_SUCCESS, EXIT_FAILURE \- termination status constants .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3const/NULL.3const b/upstream/fedora-rawhide/man3const/NULL.3const index 00f296fa..c88bbe0a 100644 --- a/upstream/fedora-rawhide/man3const/NULL.3const +++ b/upstream/fedora-rawhide/man3const/NULL.3const @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH NULL 3const 2023-10-31 "Linux man-pages 6.06" +.TH NULL 3const 2023-10-31 "Linux man-pages 6.7" .SH NAME NULL \- null pointer constant .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3head/printf.h.3head b/upstream/fedora-rawhide/man3head/printf.h.3head index 3fec2e67..8f1b9a0a 100644 --- a/upstream/fedora-rawhide/man3head/printf.h.3head +++ b/upstream/fedora-rawhide/man3head/printf.h.3head @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH printf.h 3head 2024-01-28 "Linux man-pages 6.06" +.TH printf.h 3head 2024-03-14 "Linux man-pages 6.7" .SH NAME printf.h, \%register_printf_specifier, @@ -231,7 +231,7 @@ and is now deprecated. That function can't handle user-defined types. .P .BR \%register_printf_specifier () -superseeds +supersedes .BR \%register_printf_function (3). .SH EXAMPLES The following example program registers the 'b' and 'B' specifiers diff --git a/upstream/fedora-rawhide/man3head/sysexits.h.3head b/upstream/fedora-rawhide/man3head/sysexits.h.3head index 38765c0e..f3732349 100644 --- a/upstream/fedora-rawhide/man3head/sysexits.h.3head +++ b/upstream/fedora-rawhide/man3head/sysexits.h.3head @@ -8,7 +8,7 @@ .\" .\" Rewritten for the Linux man-pages by Alejandro Colomar .\" -.TH sysexits.h 3head 2023-10-31 "Linux man-pages 6.06" +.TH sysexits.h 3head 2023-10-31 "Linux man-pages 6.7" .SH NAME sysexits.h \- exit codes for programs .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/FILE.3type b/upstream/fedora-rawhide/man3type/FILE.3type index d4099d90..3e8ea246 100644 --- a/upstream/fedora-rawhide/man3type/FILE.3type +++ b/upstream/fedora-rawhide/man3type/FILE.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH FILE 3type 2023-10-31 "Linux man-pages 6.06" +.TH FILE 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME FILE \- input/output stream .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/aiocb.3type b/upstream/fedora-rawhide/man3type/aiocb.3type index 775340df..5daec06d 100644 --- a/upstream/fedora-rawhide/man3type/aiocb.3type +++ b/upstream/fedora-rawhide/man3type/aiocb.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH aiocb 3type 2023-10-31 "Linux man-pages 6.06" +.TH aiocb 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME aiocb \- asynchronous I/O control block .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/blkcnt_t.3type b/upstream/fedora-rawhide/man3type/blkcnt_t.3type index 91a8e367..d5b2e44b 100644 --- a/upstream/fedora-rawhide/man3type/blkcnt_t.3type +++ b/upstream/fedora-rawhide/man3type/blkcnt_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH blkcnt_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH blkcnt_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME blkcnt_t \- file block counts .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/blksize_t.3type b/upstream/fedora-rawhide/man3type/blksize_t.3type index 275a41d4..00f341c9 100644 --- a/upstream/fedora-rawhide/man3type/blksize_t.3type +++ b/upstream/fedora-rawhide/man3type/blksize_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH blksize_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH blksize_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME blksize_t \- file block sizes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/cc_t.3type b/upstream/fedora-rawhide/man3type/cc_t.3type index 605edc35..c7b4021f 100644 --- a/upstream/fedora-rawhide/man3type/cc_t.3type +++ b/upstream/fedora-rawhide/man3type/cc_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH cc_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH cc_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME cc_t, speed_t, tcflag_t \- terminal special characters, baud rates, modes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/clock_t.3type b/upstream/fedora-rawhide/man3type/clock_t.3type index e0cab7fa..aa061b06 100644 --- a/upstream/fedora-rawhide/man3type/clock_t.3type +++ b/upstream/fedora-rawhide/man3type/clock_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH clock_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH clock_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME clock_t \- system time .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/clockid_t.3type b/upstream/fedora-rawhide/man3type/clockid_t.3type index 978d0474..a28c065f 100644 --- a/upstream/fedora-rawhide/man3type/clockid_t.3type +++ b/upstream/fedora-rawhide/man3type/clockid_t.3type @@ -1,4 +1,4 @@ -.TH clockid_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH clockid_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME clockid_t \- clock ID for the clock and timer functions .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/dev_t.3type b/upstream/fedora-rawhide/man3type/dev_t.3type index 54240ede..d30803b0 100644 --- a/upstream/fedora-rawhide/man3type/dev_t.3type +++ b/upstream/fedora-rawhide/man3type/dev_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH dev_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH dev_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME dev_t \- device ID .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/div_t.3type b/upstream/fedora-rawhide/man3type/div_t.3type index e276e10b..977d5af3 100644 --- a/upstream/fedora-rawhide/man3type/div_t.3type +++ b/upstream/fedora-rawhide/man3type/div_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH div_t 3type 2024-01-16 "Linux man-pages 6.06" +.TH div_t 3type 2024-01-16 "Linux man-pages 6.7" .SH NAME div_t, ldiv_t, lldiv_t, imaxdiv_t \- quotient and remainder of an integer division diff --git a/upstream/fedora-rawhide/man3type/double_t.3type b/upstream/fedora-rawhide/man3type/double_t.3type index aa323c01..06c7699c 100644 --- a/upstream/fedora-rawhide/man3type/double_t.3type +++ b/upstream/fedora-rawhide/man3type/double_t.3type @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH double_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH double_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME float_t, double_t \- most efficient floating types .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/epoll_event.3type b/upstream/fedora-rawhide/man3type/epoll_event.3type index 9710d0bc..1ba679de 100644 --- a/upstream/fedora-rawhide/man3type/epoll_event.3type +++ b/upstream/fedora-rawhide/man3type/epoll_event.3type @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH epoll_event 3type 2023-10-31 "Linux man-pages 6.06" +.TH epoll_event 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME epoll_event, epoll_data, epoll_data_t \- epoll event diff --git a/upstream/fedora-rawhide/man3type/fenv_t.3type b/upstream/fedora-rawhide/man3type/fenv_t.3type index a28247a1..bc430b00 100644 --- a/upstream/fedora-rawhide/man3type/fenv_t.3type +++ b/upstream/fedora-rawhide/man3type/fenv_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH fenv_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH fenv_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME fenv_t, fexcept_t \- floating-point environment .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/id_t.3type b/upstream/fedora-rawhide/man3type/id_t.3type index cb29361d..23c130c2 100644 --- a/upstream/fedora-rawhide/man3type/id_t.3type +++ b/upstream/fedora-rawhide/man3type/id_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH id_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH id_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME pid_t, uid_t, gid_t, id_t \- process/user/group identifier .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/intN_t.3type b/upstream/fedora-rawhide/man3type/intN_t.3type index 7f74803e..dc420420 100644 --- a/upstream/fedora-rawhide/man3type/intN_t.3type +++ b/upstream/fedora-rawhide/man3type/intN_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH intN_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH intN_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME intN_t, int8_t, int16_t, int32_t, int64_t, uintN_t, uint8_t, uint16_t, uint32_t, uint64_t diff --git a/upstream/fedora-rawhide/man3type/intmax_t.3type b/upstream/fedora-rawhide/man3type/intmax_t.3type index ebe0a0a8..846c5cc5 100644 --- a/upstream/fedora-rawhide/man3type/intmax_t.3type +++ b/upstream/fedora-rawhide/man3type/intmax_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH intmax_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH intmax_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME intmax_t, uintmax_t \- greatest-width basic integer types .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/intptr_t.3type b/upstream/fedora-rawhide/man3type/intptr_t.3type index ceb38df3..4ee32915 100644 --- a/upstream/fedora-rawhide/man3type/intptr_t.3type +++ b/upstream/fedora-rawhide/man3type/intptr_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH intptr_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH intptr_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME intptr_t, uintptr_t \- integer types wide enough to hold pointers .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/iovec.3type b/upstream/fedora-rawhide/man3type/iovec.3type index 8d84eeea..4d5c9ec6 100644 --- a/upstream/fedora-rawhide/man3type/iovec.3type +++ b/upstream/fedora-rawhide/man3type/iovec.3type @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH iovec 3type 2023-10-31 "Linux man-pages 6.06" +.TH iovec 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME iovec \- Vector I/O data structure .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/itimerspec.3type b/upstream/fedora-rawhide/man3type/itimerspec.3type index d0b45b70..1650e0aa 100644 --- a/upstream/fedora-rawhide/man3type/itimerspec.3type +++ b/upstream/fedora-rawhide/man3type/itimerspec.3type @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH itimerspec 3type 2023-10-31 "Linux man-pages 6.06" +.TH itimerspec 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME itimerspec \- interval for a timer with nanosecond precision .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/lconv.3type b/upstream/fedora-rawhide/man3type/lconv.3type index b2bc1927..5fe2e74c 100644 --- a/upstream/fedora-rawhide/man3type/lconv.3type +++ b/upstream/fedora-rawhide/man3type/lconv.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH lconv 3type 2023-10-31 "Linux man-pages 6.06" +.TH lconv 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME lconv \- numeric formatting information .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/mode_t.3type b/upstream/fedora-rawhide/man3type/mode_t.3type index c05f44e8..36f4bb85 100644 --- a/upstream/fedora-rawhide/man3type/mode_t.3type +++ b/upstream/fedora-rawhide/man3type/mode_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH mode_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH mode_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME mode_t \- file attributes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/off_t.3type b/upstream/fedora-rawhide/man3type/off_t.3type index 11253f21..95193d21 100644 --- a/upstream/fedora-rawhide/man3type/off_t.3type +++ b/upstream/fedora-rawhide/man3type/off_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH off_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH off_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME off_t, off64_t, loff_t \- file sizes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/ptrdiff_t.3type b/upstream/fedora-rawhide/man3type/ptrdiff_t.3type index ad7cc8d6..7e1ce76f 100644 --- a/upstream/fedora-rawhide/man3type/ptrdiff_t.3type +++ b/upstream/fedora-rawhide/man3type/ptrdiff_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH ptrdiff_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH ptrdiff_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME ptrdiff_t \- count of elements or array index .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/sigevent.3type b/upstream/fedora-rawhide/man3type/sigevent.3type index 20be5303..4f1cb71b 100644 --- a/upstream/fedora-rawhide/man3type/sigevent.3type +++ b/upstream/fedora-rawhide/man3type/sigevent.3type @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sigevent 3type 2023-10-31 "Linux man-pages 6.06" +.TH sigevent 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME sigevent, sigval \- structure for notification from asynchronous routines .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man3type/size_t.3type b/upstream/fedora-rawhide/man3type/size_t.3type index efc9447f..c9ac9c21 100644 --- a/upstream/fedora-rawhide/man3type/size_t.3type +++ b/upstream/fedora-rawhide/man3type/size_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH size_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH size_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME size_t, ssize_t \- count of bytes .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/sockaddr.3type b/upstream/fedora-rawhide/man3type/sockaddr.3type index fca06320..2ca69c8a 100644 --- a/upstream/fedora-rawhide/man3type/sockaddr.3type +++ b/upstream/fedora-rawhide/man3type/sockaddr.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH sockaddr 3type 2023-10-31 "Linux man-pages 6.06" +.TH sockaddr 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME sockaddr, sockaddr_storage, sockaddr_in, sockaddr_in6, sockaddr_un, socklen_t, in_addr, in6_addr, in_addr_t, in_port_t, diff --git a/upstream/fedora-rawhide/man3type/stat.3type b/upstream/fedora-rawhide/man3type/stat.3type index 5f31178b..71b850e8 100644 --- a/upstream/fedora-rawhide/man3type/stat.3type +++ b/upstream/fedora-rawhide/man3type/stat.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH stat 3type 2023-10-31 "Linux man-pages 6.06" +.TH stat 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME stat \- file status .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/time_t.3type b/upstream/fedora-rawhide/man3type/time_t.3type index 5ddf10d1..d528ad3a 100644 --- a/upstream/fedora-rawhide/man3type/time_t.3type +++ b/upstream/fedora-rawhide/man3type/time_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH time_t 3type 2023-11-11 "Linux man-pages 6.06" +.TH time_t 3type 2023-11-11 "Linux man-pages 6.7" .SH NAME time_t, suseconds_t, useconds_t \- integer time .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/timer_t.3type b/upstream/fedora-rawhide/man3type/timer_t.3type index dd892777..a14dc1ee 100644 --- a/upstream/fedora-rawhide/man3type/timer_t.3type +++ b/upstream/fedora-rawhide/man3type/timer_t.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH timer_t 3type 2023-10-31 "Linux man-pages 6.06" +.TH timer_t 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME timer_t \- timer ID .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/timespec.3type b/upstream/fedora-rawhide/man3type/timespec.3type index 614f6a83..8e18d2e0 100644 --- a/upstream/fedora-rawhide/man3type/timespec.3type +++ b/upstream/fedora-rawhide/man3type/timespec.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH timespec 3type 2023-10-31 "Linux man-pages 6.06" +.TH timespec 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME timespec \- time in seconds and nanoseconds .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/timeval.3type b/upstream/fedora-rawhide/man3type/timeval.3type index 9f6de386..97240299 100644 --- a/upstream/fedora-rawhide/man3type/timeval.3type +++ b/upstream/fedora-rawhide/man3type/timeval.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH timeval 3type 2023-10-31 "Linux man-pages 6.06" +.TH timeval 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME timeval \- time in seconds and microseconds .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/tm.3type b/upstream/fedora-rawhide/man3type/tm.3type index e572919c..721a5aa5 100644 --- a/upstream/fedora-rawhide/man3type/tm.3type +++ b/upstream/fedora-rawhide/man3type/tm.3type @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH tm 3type 2023-10-31 "Linux man-pages 6.06" +.TH tm 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME tm \- broken-down time .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/va_list.3type b/upstream/fedora-rawhide/man3type/va_list.3type index 0d0e91ae..d520594a 100644 --- a/upstream/fedora-rawhide/man3type/va_list.3type +++ b/upstream/fedora-rawhide/man3type/va_list.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH va_list 3type 2023-10-31 "Linux man-pages 6.06" +.TH va_list 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME va_list \- variable argument list .SH LIBRARY diff --git a/upstream/fedora-rawhide/man3type/void.3type b/upstream/fedora-rawhide/man3type/void.3type index 176dddde..4174f5f6 100644 --- a/upstream/fedora-rawhide/man3type/void.3type +++ b/upstream/fedora-rawhide/man3type/void.3type @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH void 3type 2023-10-31 "Linux man-pages 6.06" +.TH void 3type 2023-10-31 "Linux man-pages 6.7" .SH NAME void \- abstract type .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/cciss.4 b/upstream/fedora-rawhide/man4/cciss.4 index 1def6c4a..6b6a6d1d 100644 --- a/upstream/fedora-rawhide/man4/cciss.4 +++ b/upstream/fedora-rawhide/man4/cciss.4 @@ -6,7 +6,7 @@ .\" .\" shorthand for double quote that works everywhere. .ds q \N'34' -.TH cciss 4 2023-10-31 "Linux man-pages 6.06" +.TH cciss 4 2023-10-31 "Linux man-pages 6.7" .SH NAME cciss \- HP Smart Array block driver .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/console_codes.4 b/upstream/fedora-rawhide/man4/console_codes.4 index 2854b314..afc8c709 100644 --- a/upstream/fedora-rawhide/man4/console_codes.4 +++ b/upstream/fedora-rawhide/man4/console_codes.4 @@ -15,7 +15,7 @@ .\" .\" 2006-05-27, Several corrections - Thomas E. Dickey .\" -.TH console_codes 4 2024-01-28 "Linux man-pages 6.06" +.TH console_codes 4 2024-01-28 "Linux man-pages 6.7" .SH NAME console_codes \- Linux console escape and control sequences .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/cpuid.4 b/upstream/fedora-rawhide/man4/cpuid.4 index 04b033f9..e58e29ee 100644 --- a/upstream/fedora-rawhide/man4/cpuid.4 +++ b/upstream/fedora-rawhide/man4/cpuid.4 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH cpuid 4 2024-01-05 "Linux man-pages 6.06" +.TH cpuid 4 2024-01-05 "Linux man-pages 6.7" .SH NAME cpuid \- x86 CPUID access device .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/dsp56k.4 b/upstream/fedora-rawhide/man4/dsp56k.4 index f0c898a8..36a856d6 100644 --- a/upstream/fedora-rawhide/man4/dsp56k.4 +++ b/upstream/fedora-rawhide/man4/dsp56k.4 @@ -4,7 +4,7 @@ .\" .\" Modified, Thu Jan 27 19:16:19 CET 2000, lars@nocrew.org .\" -.TH dsp56k 4 2023-10-31 "Linux man-pages 6.06" +.TH dsp56k 4 2023-10-31 "Linux man-pages 6.7" .SH NAME dsp56k \- DSP56001 interface device .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/fd.4 b/upstream/fedora-rawhide/man4/fd.4 index d5fb85d5..e1aaacb4 100644 --- a/upstream/fedora-rawhide/man4/fd.4 +++ b/upstream/fedora-rawhide/man4/fd.4 @@ -6,7 +6,7 @@ .\" .\" Modified, Sun Feb 26 15:00:02 1995, faith@cs.unc.edu .\" -.TH fd 4 2023-10-31 "Linux man-pages 6.06" +.TH fd 4 2023-10-31 "Linux man-pages 6.7" .SH NAME fd \- floppy disk device .SH CONFIGURATION diff --git a/upstream/fedora-rawhide/man4/full.4 b/upstream/fedora-rawhide/man4/full.4 index b4696e50..9d5289bc 100644 --- a/upstream/fedora-rawhide/man4/full.4 +++ b/upstream/fedora-rawhide/man4/full.4 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" correction, aeb, 970825 -.TH full 4 2023-10-31 "Linux man-pages 6.06" +.TH full 4 2023-10-31 "Linux man-pages 6.7" .SH NAME full \- always full device .SH CONFIGURATION diff --git a/upstream/fedora-rawhide/man4/fuse.4 b/upstream/fedora-rawhide/man4/fuse.4 index 205bbfdc..fbdd918f 100644 --- a/upstream/fedora-rawhide/man4/fuse.4 +++ b/upstream/fedora-rawhide/man4/fuse.4 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH fuse 4 2023-10-31 "Linux man-pages 6.06" +.TH fuse 4 2023-10-31 "Linux man-pages 6.7" .SH NAME fuse \- Filesystem in Userspace (FUSE) device .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/hd.4 b/upstream/fedora-rawhide/man4/hd.4 index 55bce842..995468f5 100644 --- a/upstream/fedora-rawhide/man4/hd.4 +++ b/upstream/fedora-rawhide/man4/hd.4 @@ -7,7 +7,7 @@ .\" Modified Mon Oct 21 21:38:51 1996 by Eric S. Raymond <esr@thyrsus.com> .\" (and some more by aeb) .\" -.TH hd 4 2023-10-31 "Linux man-pages 6.06" +.TH hd 4 2023-10-31 "Linux man-pages 6.7" .SH NAME hd \- MFM/IDE hard disk devices .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/hpsa.4 b/upstream/fedora-rawhide/man4/hpsa.4 index 89c91253..2145bf19 100644 --- a/upstream/fedora-rawhide/man4/hpsa.4 +++ b/upstream/fedora-rawhide/man4/hpsa.4 @@ -5,7 +5,7 @@ .\" .\" shorthand for double quote that works everywhere. .ds q \N'34' -.TH hpsa 4 2023-10-31 "Linux man-pages 6.06" +.TH hpsa 4 2023-10-31 "Linux man-pages 6.7" .SH NAME hpsa \- HP Smart Array SCSI driver .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/initrd.4 b/upstream/fedora-rawhide/man4/initrd.4 index 8a00efb1..1490f8ef 100644 --- a/upstream/fedora-rawhide/man4/initrd.4 +++ b/upstream/fedora-rawhide/man4/initrd.4 @@ -12,7 +12,7 @@ .\" phone: (302)654-5478 .\" .\" $Id: initrd.4,v 0.9 1997/11/07 05:05:32 kallal Exp kallal $ -.TH initrd 4 2023-10-31 "Linux man-pages 6.06" +.TH initrd 4 2023-10-31 "Linux man-pages 6.7" .SH NAME initrd \- boot loader initialized RAM disk .SH CONFIGURATION diff --git a/upstream/fedora-rawhide/man4/intro.4 b/upstream/fedora-rawhide/man4/intro.4 index 223e2597..bcfcee4f 100644 --- a/upstream/fedora-rawhide/man4/intro.4 +++ b/upstream/fedora-rawhide/man4/intro.4 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sat Jul 24 16:57:14 1993 by Rik Faith (faith@cs.unc.edu) -.TH intro 4 2023-02-05 "Linux man-pages 6.06" +.TH intro 4 2023-02-05 "Linux man-pages 6.7" .SH NAME intro \- introduction to special files .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/lirc.4 b/upstream/fedora-rawhide/man4/lirc.4 index 0f543b2b..227172fb 100644 --- a/upstream/fedora-rawhide/man4/lirc.4 +++ b/upstream/fedora-rawhide/man4/lirc.4 @@ -2,7 +2,7 @@ .\" Copyright (c) 2018, Sean Young <sean@mess.org> .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH lirc 4 2023-10-31 "Linux man-pages 6.06" +.TH lirc 4 2023-10-31 "Linux man-pages 6.7" .SH NAME lirc \- lirc devices .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/loop.4 b/upstream/fedora-rawhide/man4/loop.4 index 63bb8722..273456cf 100644 --- a/upstream/fedora-rawhide/man4/loop.4 +++ b/upstream/fedora-rawhide/man4/loop.4 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH loop 4 2023-10-31 "Linux man-pages 6.06" +.TH loop 4 2023-10-31 "Linux man-pages 6.7" .SH NAME loop, loop-control \- loop devices .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/lp.4 b/upstream/fedora-rawhide/man4/lp.4 index 17aa2ec8..aa4376bb 100644 --- a/upstream/fedora-rawhide/man4/lp.4 +++ b/upstream/fedora-rawhide/man4/lp.4 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified, Sun Feb 26 15:02:58 1995, faith@cs.unc.edu -.TH lp 4 2023-02-05 "Linux man-pages 6.06" +.TH lp 4 2023-02-05 "Linux man-pages 6.7" .SH NAME lp \- line printer devices .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/mem.4 b/upstream/fedora-rawhide/man4/mem.4 index 0afd3bae..cfaa99c5 100644 --- a/upstream/fedora-rawhide/man4/mem.4 +++ b/upstream/fedora-rawhide/man4/mem.4 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sat Jul 24 16:59:10 1993 by Rik Faith (faith@cs.unc.edu) -.TH mem 4 2023-10-31 "Linux man-pages 6.06" +.TH mem 4 2023-10-31 "Linux man-pages 6.7" .SH NAME mem, kmem, port \- system memory, kernel memory and system ports .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/mouse.4 b/upstream/fedora-rawhide/man4/mouse.4 index 55fbbdfc..21ff1a22 100644 --- a/upstream/fedora-rawhide/man4/mouse.4 +++ b/upstream/fedora-rawhide/man4/mouse.4 @@ -3,7 +3,7 @@ .\" Updates Nov 1998, Andries Brouwer .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH mouse 4 2023-10-31 "Linux man-pages 6.06" +.TH mouse 4 2023-10-31 "Linux man-pages 6.7" .SH NAME mouse \- serial mouse interface .SH CONFIGURATION diff --git a/upstream/fedora-rawhide/man4/msr.4 b/upstream/fedora-rawhide/man4/msr.4 index 5cb083c9..6a6438c1 100644 --- a/upstream/fedora-rawhide/man4/msr.4 +++ b/upstream/fedora-rawhide/man4/msr.4 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH msr 4 2023-10-31 "Linux man-pages 6.06" +.TH msr 4 2023-10-31 "Linux man-pages 6.7" .SH NAME msr \- x86 CPU MSR access device .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/null.4 b/upstream/fedora-rawhide/man4/null.4 index 79710bff..0d59e4f2 100644 --- a/upstream/fedora-rawhide/man4/null.4 +++ b/upstream/fedora-rawhide/man4/null.4 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sat Jul 24 17:00:12 1993 by Rik Faith (faith@cs.unc.edu) -.TH null 4 2023-10-31 "Linux man-pages 6.06" +.TH null 4 2023-10-31 "Linux man-pages 6.7" .SH NAME null, zero \- data sink .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/pts.4 b/upstream/fedora-rawhide/man4/pts.4 index abfb8c80..db778d3e 100644 --- a/upstream/fedora-rawhide/man4/pts.4 +++ b/upstream/fedora-rawhide/man4/pts.4 @@ -5,7 +5,7 @@ .\" Redistribute and revise at will. .\" %%%LICENSE_END .\" -.TH pts 4 2023-10-31 "Linux man-pages 6.06" +.TH pts 4 2023-10-31 "Linux man-pages 6.7" .SH NAME ptmx, pts \- pseudoterminal master and slave .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/ram.4 b/upstream/fedora-rawhide/man4/ram.4 index db4538a9..6c4e0370 100644 --- a/upstream/fedora-rawhide/man4/ram.4 +++ b/upstream/fedora-rawhide/man4/ram.4 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sat Jul 24 17:01:11 1993 by Rik Faith (faith@cs.unc.edu) -.TH ram 4 2023-10-31 "Linux man-pages 6.06" +.TH ram 4 2023-10-31 "Linux man-pages 6.7" .SH NAME ram \- ram disk device .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/random.4 b/upstream/fedora-rawhide/man4/random.4 index 89bbec46..7a1d15d6 100644 --- a/upstream/fedora-rawhide/man4/random.4 +++ b/upstream/fedora-rawhide/man4/random.4 @@ -9,7 +9,7 @@ .\" 2008-06-20, George Spelvin <linux@horizon.com>, .\" Matt Mackall <mpm@selenic.com> .\" -.TH random 4 2023-10-31 "Linux man-pages 6.06" +.TH random 4 2023-10-31 "Linux man-pages 6.7" .SH NAME random, urandom \- kernel random number source devices .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/rtc.4 b/upstream/fedora-rawhide/man4/rtc.4 index 3cea6d6a..5a04a7b4 100644 --- a/upstream/fedora-rawhide/man4/rtc.4 +++ b/upstream/fedora-rawhide/man4/rtc.4 @@ -8,7 +8,7 @@ .\" 2006-02-08 Various additions by mtk .\" 2006-11-26 cleanup, cover the generic rtc framework; David Brownell .\" -.TH rtc 4 2023-10-31 "Linux man-pages 6.06" +.TH rtc 4 2023-10-31 "Linux man-pages 6.7" .SH NAME rtc \- real-time clock .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/sd.4 b/upstream/fedora-rawhide/man4/sd.4 index d943f68b..a2bf8146 100644 --- a/upstream/fedora-rawhide/man4/sd.4 +++ b/upstream/fedora-rawhide/man4/sd.4 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sd 4 2023-10-31 "Linux man-pages 6.06" +.TH sd 4 2023-10-31 "Linux man-pages 6.7" .SH NAME sd \- driver for SCSI disk drives .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/sk98lin.4 b/upstream/fedora-rawhide/man4/sk98lin.4 index cd0fe0a7..808a769f 100644 --- a/upstream/fedora-rawhide/man4/sk98lin.4 +++ b/upstream/fedora-rawhide/man4/sk98lin.4 @@ -6,7 +6,7 @@ .\" .\" This manpage can be viewed using `groff -Tascii -man sk98lin.4 | less` .\" -.TH sk98lin 4 2023-10-31 "Linux man-pages 6.06" +.TH sk98lin 4 2023-10-31 "Linux man-pages 6.7" .SH NAME sk98lin \- Marvell/SysKonnect Gigabit Ethernet driver v6.21 .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/smartpqi.4 b/upstream/fedora-rawhide/man4/smartpqi.4 index eb649217..5e9f25cc 100644 --- a/upstream/fedora-rawhide/man4/smartpqi.4 +++ b/upstream/fedora-rawhide/man4/smartpqi.4 @@ -5,7 +5,7 @@ .\" Written by Kevin Barnett <kevin.barnett@microchip.com> .\" .\" SPDX-License-Identifier: GPL-2.0-only -.TH smartpqi 4 2023-10-31 "Linux man-pages 6.06" +.TH smartpqi 4 2023-10-31 "Linux man-pages 6.7" .SH NAME smartpqi \- Microchip Smart Storage SCSI driver .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/st.4 b/upstream/fedora-rawhide/man4/st.4 index b11e3d90..7366a227 100644 --- a/upstream/fedora-rawhide/man4/st.4 +++ b/upstream/fedora-rawhide/man4/st.4 @@ -2,7 +2,7 @@ .\" Copyright 1999-2005 Kai Mäkisara (Kai.Makisara@kolumbus.fi) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH st 4 2023-10-31 "Linux man-pages 6.06" +.TH st 4 2023-10-31 "Linux man-pages 6.7" .SH NAME st \- SCSI tape device .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man4/tty.4 b/upstream/fedora-rawhide/man4/tty.4 index b41f3e1b..72bfcdf7 100644 --- a/upstream/fedora-rawhide/man4/tty.4 +++ b/upstream/fedora-rawhide/man4/tty.4 @@ -6,7 +6,7 @@ .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2003-04-07 by Michael Kerrisk .\" -.TH tty 4 2023-10-31 "Linux man-pages 6.06" +.TH tty 4 2023-10-31 "Linux man-pages 6.7" .SH NAME tty \- controlling terminal .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/ttyS.4 b/upstream/fedora-rawhide/man4/ttyS.4 index abe695e8..66fb1199 100644 --- a/upstream/fedora-rawhide/man4/ttyS.4 +++ b/upstream/fedora-rawhide/man4/ttyS.4 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sat Jul 24 17:03:24 1993 by Rik Faith (faith@cs.unc.edu) -.TH ttyS 4 2023-10-31 "Linux man-pages 6.06" +.TH ttyS 4 2023-10-31 "Linux man-pages 6.7" .SH NAME ttyS \- serial terminal lines .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/vcs.4 b/upstream/fedora-rawhide/man4/vcs.4 index 2a0e145c..bf5dba22 100644 --- a/upstream/fedora-rawhide/man4/vcs.4 +++ b/upstream/fedora-rawhide/man4/vcs.4 @@ -7,7 +7,7 @@ .\" 2007-12-17, Samuel Thibault <samuel.thibault@ens-lyon.org>: .\" document the VT_GETHIFONTMASK ioctl .\" " -.TH vcs 4 2023-10-31 "Linux man-pages 6.06" +.TH vcs 4 2023-10-31 "Linux man-pages 6.7" .SH NAME vcs, vcsa \- virtual console memory .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/veth.4 b/upstream/fedora-rawhide/man4/veth.4 index 35358f59..d6c9a195 100644 --- a/upstream/fedora-rawhide/man4/veth.4 +++ b/upstream/fedora-rawhide/man4/veth.4 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" -.TH veth 4 2023-10-31 "Linux man-pages 6.06" +.TH veth 4 2023-10-31 "Linux man-pages 6.7" .SH NAME veth \- Virtual Ethernet Device .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man4/wavelan.4 b/upstream/fedora-rawhide/man4/wavelan.4 index 92bebe45..3e2f3b41 100644 --- a/upstream/fedora-rawhide/man4/wavelan.4 +++ b/upstream/fedora-rawhide/man4/wavelan.4 @@ -8,7 +8,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH wavelan 4 2023-10-31 "Linux man-pages 6.06" +.TH wavelan 4 2023-10-31 "Linux man-pages 6.7" .SH NAME wavelan \- AT&T GIS WaveLAN ISA device driver .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man5/BUILDINFO.5 b/upstream/fedora-rawhide/man5/BUILDINFO.5 index 13f1ccde..c7f0a361 100644 --- a/upstream/fedora-rawhide/man5/BUILDINFO.5 +++ b/upstream/fedora-rawhide/man5/BUILDINFO.5 @@ -2,12 +2,12 @@ .\" Title: buildinfo .\" 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 "BUILDINFO" "5" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "BUILDINFO" "5" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -34,7 +34,7 @@ BUILDINFO \- Makepkg package build information file This manual page describes the format of a BUILDINFO file found in the root of a package created by makepkg\&. The file contains a description of the package\(cqs build environment\&. The information is formatted in key\-value pairs separated by a \fI=\fR, one value per line\&. Arrays are represented multiple keys with the same value\&. .SH "DESCRIPTION" .sp -This is a description of the contents of version \fI1\fR of the BUILDINFO file format\&. +This is a description of the contents of version \fI2\fR of the BUILDINFO file format\&. .PP \fBformat\fR .RS 4 @@ -86,6 +86,19 @@ The directory where the package was built\&. The directory from which makepkg was executed\&. .RE .PP +\fBbuildtool\fR +.RS 4 +The name of the tool ecosystem used to set up the build environment\&. Used for defining a spec for reproducible builds, e\&.g\&. the source of the +\fBmakepkg.conf\fR(5) +used\&. +.RE +.PP +\fBbuildtoolver\fR +.RS 4 +The full version of the +\fIbuildtool\fR, for example: "$pkgver\-$pkgrel\-$pkgarch"\&. +.RE +.PP \fBbuildenv (array)\fR .RS 4 The build environment specified in makepkg\&.conf\&. @@ -142,17 +155,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 @@ -235,4 +237,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/man5/PKGBUILD.5 b/upstream/fedora-rawhide/man5/PKGBUILD.5 index c320a1e5..a81c3aa9 100644 --- a/upstream/fedora-rawhide/man5/PKGBUILD.5 +++ b/upstream/fedora-rawhide/man5/PKGBUILD.5 @@ -2,12 +2,12 @@ .\" Title: pkgbuild .\" 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 "PKGBUILD" "5" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "PKGBUILD" "5" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -28,7 +28,7 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -PKGBUILD \- Arch Linux package build description file +PKGBUILD \- Package build description file .SH "SYNOPSIS" .sp PKGBUILD @@ -104,15 +104,7 @@ This field contains a URL that is associated with the software being packaged\&. .PP \fBlicense (array)\fR .RS 4 -This field specifies the license(s) that apply to the package\&. Commonly used licenses can be found in -\fI/usr/share/licenses/common\fR\&. If you see the package\(cqs license there, simply reference it in the license field (e\&.g\&., -license=(\*(AqGPL\*(Aq))\&. If the package provides a license not available in -\fI/usr/share/licenses/common\fR, then you should include it in the package itself and set -license=(\*(Aqcustom\*(Aq) -or -license=(\*(Aqcustom:LicenseName\*(Aq)\&. The license should be placed in -\fI$pkgdir/usr/share/licenses/$pkgname/\fR -when building the package\&. If multiple licenses are applicable, list all of them: +This field specifies the license(s) that apply to the package\&. If multiple licenses are applicable, list all of them: license=(\*(AqGPL\*(Aq \*(AqFDL\*(Aq)\&. .RE .PP @@ -223,8 +215,6 @@ is one of five comparisons: < (less than)\&. .sp -If the dependency name appears to be a library (ends with \&.so), makepkg will try to find a binary that depends on the library in the built package and append the version needed by the binary\&. Appending the version yourself disables automatic detection\&. -.sp Additional architecture\-specific depends can be added by appending an underscore and the architecture name e\&.g\&., \fIdepends_x86_64=()\fR\&. .RE @@ -292,8 +282,6 @@ and < operators are invalid as only specific versions of a package may be provided\&. .sp -If the provision name appears to be a library (ends with \&.so), makepkg will try to find the library in the built package and append the correct version\&. Appending the version yourself disables automatic detection\&. -.sp Additional architecture\-specific provides can be added by appending an underscore and the architecture name e\&.g\&., \fIprovides_x86_64=()\fR\&. .RE @@ -421,7 +409,16 @@ If you create any variables of your own in any of these functions, it is recomme .RS 4 The package() -function is used to install files into the directory that will become the root directory of the built package and is run after all the optional functions listed below\&. The packaging stage is run using fakeroot to ensure correct file permissions in the resulting package\&. All other functions will be run as the user calling makepkg\&. +function is used to install files into the directory that will become the root directory of the built package and is run after all the optional functions listed below\&. The packaging stage is run using fakeroot to ensure correct file permissions in the resulting package\&. All other functions will be run as the user calling makepkg\&. This function is run inside +$srcdir\&. +.RE +.PP +\fBverify() Function\fR +.RS 4 +An optional +verify() +function can be specified to implement arbitrary source authentication\&. The function should return a non\-zero exit code when verification fails\&. This function is run before sources are extracted\&. This function is run inside +$startdir\&. .RE .PP \fBprepare() Function\fR @@ -432,7 +429,8 @@ function can be specified in which operations to prepare the sources for buildin build() function\&. The prepare() -function is skipped when source extraction is skipped\&. +function is skipped when source extraction is skipped\&. This function is run inside +$srcdir\&. .RE .PP \fBbuild() Function\fR @@ -441,7 +439,8 @@ The optional build() function is used to compile and/or adjust the source files in preparation to be installed by the package() -function\&. +function\&. This function is run inside +$srcdir\&. .RE .PP \fBcheck() Function\fR @@ -454,7 +453,8 @@ and package() functions\&. Be sure any exotic commands used are covered by the checkdepends -array\&. +array\&. This function is run inside +$srcdir\&. .RE .sp All of the above variables such as $pkgname and $pkgver are available for use in the packaging functions\&. In addition, makepkg defines the following variables: @@ -462,9 +462,6 @@ All of the above variables such as $pkgname and $pkgver are available for use in \fBsrcdir\fR .RS 4 This contains the directory where makepkg extracts, or copies, all source files\&. -.sp -All of the packaging functions defined above are run starting inside -$srcdir .RE .PP \fBpkgdir\fR @@ -563,6 +560,8 @@ source=(\*(Aqdirectory::url#fragment?query\*(Aq) .sp Currently makepkg supports the Bazaar, Git, Subversion, Fossil and Mercurial version control systems\&. For other version control systems, manual cloning of upstream repositories must be done in the prepare() function\&. .sp +Some VCS Sources like Git support pinning the checkout by a checksum of its content using deterministic export functionality like \(lqgit archive\(rq\&. +.sp The source URL is divided into four components: .PP \fBdirectory\fR @@ -620,7 +619,7 @@ source=(url?signed#fragment)\&. Currently only supported by Git\&. .RE .SH "EXAMPLE" .sp -The following is an example PKGBUILD for the \fIpatch\fR package\&. For more examples, look through the build files of your distribution\(cqs packages\&. For those using Arch Linux, consult the Arch Build System (ABS) tree\&. +The following is an example PKGBUILD for the \fIpatch\fR package\&. For more examples, look through the build files of your distribution\(cqs packages\&. .sp .if n \{\ .RS 4 @@ -640,8 +639,8 @@ depends=(\*(Aqglibc\*(Aq) makedepends=(\*(Aqed\*(Aq) optdepends=(\*(Aqed: for "patch \-e" functionality\*(Aq) source=("ftp://ftp\&.gnu\&.org/gnu/$pkgname/$pkgname\-$pkgver\&.tar\&.xz"{,\&.sig}) -md5sums=(\*(Aqe9ae5393426d3ad783a300a338c09b72\*(Aq - \*(AqSKIP\*(Aq) +sha256sums=(\*(Aq9124ba46db0abd873d0995c2ca880e81252676bb6c03e0a37dfc5f608a9b0ceb\*(Aq + \*(AqSKIP\*(Aq) build() { cd "$srcdir/$pkgname\-$pkgver" @@ -699,17 +698,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 @@ -792,4 +780,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/man5/acct.5 b/upstream/fedora-rawhide/man5/acct.5 index 18d458e6..a140bc43 100644 --- a/upstream/fedora-rawhide/man5/acct.5 +++ b/upstream/fedora-rawhide/man5/acct.5 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH acct 5 2023-10-31 "Linux man-pages 6.06" +.TH acct 5 2023-10-31 "Linux man-pages 6.7" .SH NAME acct \- process accounting file .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man5/alpm-hooks.5 b/upstream/fedora-rawhide/man5/alpm-hooks.5 index f82c1e8a..15f4cafe 100644 --- a/upstream/fedora-rawhide/man5/alpm-hooks.5 +++ b/upstream/fedora-rawhide/man5/alpm-hooks.5 @@ -2,12 +2,12 @@ .\" Title: alpm-hooks .\" 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 "ALPM\-HOOKS" "5" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "ALPM\-HOOKS" "5" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -176,17 +176,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 @@ -269,4 +258,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/man5/binfmt.d.5 b/upstream/fedora-rawhide/man5/binfmt.d.5 index f03a5a39..b52230ef 100644 --- a/upstream/fedora-rawhide/man5/binfmt.d.5 +++ b/upstream/fedora-rawhide/man5/binfmt.d.5 @@ -1,5 +1,5 @@ '\" t -.TH "BINFMT\&.D" "5" "" "systemd 255" "binfmt.d" +.TH "BINFMT\&.D" "5" "" "systemd 256~rc3" "binfmt.d" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,11 +23,15 @@ binfmt.d \- Configure additional binary formats for executables at boot .SH "SYNOPSIS" .PP +.RS 4 /etc/binfmt\&.d/*\&.conf -.PP +.RE +.RS 4 /run/binfmt\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/binfmt\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP At boot, @@ -70,7 +74,12 @@ Packages should install their configuration files in /usr/local/lib/ (local installs)\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. It is recommended to prefix all filenames with a two\-digit number and a dash, to simplify the ordering of the files\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. It is recommended to prefix all filenames with a two\-digit number and a dash, to simplify the ordering of the files\&. It is recommended to use the range 10\-40 for configuration files in +/usr/ +and the range 60\-90 for configuration files in +/etc/ +and +/run/, to make sure that local and transient configuration files will always take priority over configuration files shipped by the OS vendor\&. .PP If the administrator wants to disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -92,10 +101,7 @@ in the configuration directory in .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-binfmt.service\fR(8), -\fBsystemd-delta\fR(1), -\fBwine\fR(8) +\fBsystemd\fR(1), \fBsystemd-binfmt.service\fR(8), \fBsystemd-delta\fR(1), \fBwine\fR(8) .SH "NOTES" .IP " 1." 4 Kernel Support for miscellaneous Binary Formats (binfmt_misc) diff --git a/upstream/fedora-rawhide/man5/btrfs.5 b/upstream/fedora-rawhide/man5/btrfs.5 index 208aa24b..68c29796 100644 --- a/upstream/fedora-rawhide/man5/btrfs.5 +++ b/upstream/fedora-rawhide/man5/btrfs.5 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS" "5" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS" "5" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs \- topics about the BTRFS filesystem (mount options, supported file attributes and other) .SH DESCRIPTION @@ -70,7 +70,7 @@ storage model, hardware considerations .SS BTRFS SPECIFIC MOUNT OPTIONS .sp This section describes mount options specific to BTRFS. For the generic mount -options please refer to \fBmount(8)\fP manual page. The options are sorted alphabetically +options please refer to \fI\%mount(8)\fP manual page. The options are sorted alphabetically (discarding the \fIno\fP prefix). .sp \fBNOTE:\fP @@ -95,7 +95,7 @@ have been applied. (default: on) .sp Enable/disable support for POSIX Access Control Lists (ACLs). See the -\fBacl(5)\fP manual page for more information about ACLs. +\fI\%acl(5)\fP manual page for more information about ACLs. .sp The support for ACL is build\-time configurable (BTRFS_FS_POSIX_ACL) and mount fails if \fIacl\fP is requested but the feature is not compiled in. @@ -228,7 +228,7 @@ If compression is enabled, \fInodatacow\fP and \fInodatasum\fP are disabled. .sp Enable data copy\-on\-write for newly created files. \fINodatacow\fP implies \fInodatasum\fP, and disables \fIcompression\fP\&. All files created -under \fInodatacow\fP are also set the NOCOW file attribute (see \fBchattr(1)\fP). +under \fInodatacow\fP are also set the NOCOW file attribute (see \fI\%chattr(1)\fP). .sp \fBNOTE:\fP .INDENT 7.0 @@ -247,7 +247,7 @@ at the cost of potential partial writes, in case the write is interrupted Enable data checksumming for newly created files. \fIDatasum\fP implies \fIdatacow\fP, i.e. the normal mode of operation. All files created under \fInodatasum\fP inherit the \(dqno checksums\(dq property, however there\(aqs no -corresponding file attribute (see \fBchattr(1)\fP). +corresponding file attribute (see \fI\%chattr(1)\fP). .sp \fBNOTE:\fP .INDENT 7.0 @@ -599,7 +599,7 @@ Historically, any user could create a snapshot even if he was not owner of the source subvolume, the subvolume deletion has been restricted for that reason. The subvolume creation has been restricted but this mount option is still required. This is a usability issue. -Since 4.18, the \fBrmdir(2)\fP syscall can delete an empty subvolume just like an +Since 4.18, the \fI\%rmdir(2)\fP syscall can delete an empty subvolume just like an ordinary directory. Whether this is possible can be detected at runtime, see \fIrmdir_subvol\fP feature in \fIFILESYSTEM FEATURES\fP\&. .UNINDENT @@ -635,7 +635,7 @@ previous use of the \fIinode_cache\fP option can be removed by .UNINDENT .SS NOTES ON GENERIC MOUNT OPTIONS .sp -Some of the general mount options from \fBmount(8)\fP that affect BTRFS and are +Some of the general mount options from \fI\%mount(8)\fP that affect BTRFS and are worth mentioning. .INDENT 0.0 .TP @@ -763,6 +763,11 @@ stored as an extent, saves a few percent of metadata if sparse files are used .sp extended RAID1 mode with copies on 3 or 4 devices respectively .TP +.B raid_stripe_tree +(since: 6.7) +.sp +a separate tree for tracking file extents on RAID profiles +.TP .B RAID56 (since: 3.9) .sp @@ -771,7 +776,7 @@ the filesystem contains or contained a RAID56 profile of block groups .B rmdir_subvol (since: 4.18) .sp -indicate that \fBrmdir(2)\fP syscall can delete an empty subvolume just like an +indicate that \fI\%rmdir(2)\fP syscall can delete an empty subvolume just like an ordinary directory. Note that this feature only depends on the kernel version. .TP .B skinny_metadata @@ -784,6 +789,11 @@ reduced\-size metadata for extent references, saves a few percent of metadata .sp number of the highest supported send stream version .TP +.B simple_quota +(since: 6.7) +.sp +simplified quota accounting +.TP .B supported_checksums (since: 5.5) .sp @@ -813,8 +823,8 @@ sequentially, see section \fI\%ZONED MODE\fP .SH SWAPFILE SUPPORT .sp A swapfile, when active, is a file\-backed swap area. It is supported since kernel 5.0. -Use \fBswapon(8)\fP to activate it, until then (respectively again after deactivating it -with \fBswapoff(8)\fP) it\(aqs just a normal file (with NODATACOW set), for which the special +Use \fI\%swapon(8)\fP to activate it, until then (respectively again after deactivating it +with \fI\%swapoff(8)\fP) it\(aqs just a normal file (with NODATACOW set), for which the special restrictions for active swapfiles don\(aqt apply. .sp There are some limitations of the implementation in BTRFS and Linux swap @@ -1447,9 +1457,9 @@ pattern detection, byte frequency, Shannon entropy. .SH COMPATIBILITY .sp Compression is done using the COW mechanism so it\(aqs incompatible with -\fInodatacow\fP\&. Direct IO works on compressed files but will fall back to buffered -writes and leads to recompression. Currently \fInodatasum\fP and compression don\(aqt -work together. +\fInodatacow\fP\&. Direct IO read works on compressed files but will fall back to +buffered writes and leads to no compression even if force compression is set. +Currently \fInodatasum\fP and compression don\(aqt work together. .sp The compression algorithms have been added over time so the version compatibility should be also considered, together with other tools that may @@ -1886,7 +1896,7 @@ depends on the \fInodesize\fP value, for 4KiB it\(aqs 3949 bytes, for larger nod it\(aqs 4095 due to the system limit PATH_MAX .sp The symlink target may not be a valid path, i.e. the path name components -can exceed the limits (NAME_MAX), there\(aqs no content validation at \fBsymlink(3)\fP +can exceed the limits (NAME_MAX), there\(aqs no content validation at \fI\%symlink(3)\fP creation. .TP .B maximum number of inodes @@ -1944,7 +1954,7 @@ old and new interfaces, with confusing names. The following list should clarify that: .INDENT 0.0 .IP \(bu 2 -\fIattributes\fP: \fBchattr(1)\fP or \fBlsattr(1)\fP utilities (the ioctls are +\fIattributes\fP: \fI\%chattr(1)\fP or \fI\%lsattr(1)\fP utilities (the ioctls are FS_IOC_GETFLAGS and FS_IOC_SETFLAGS), due to the ioctl names the attributes are also called flags .IP \(bu 2 @@ -1952,7 +1962,7 @@ are also called flags bits similar to the attributes but extensible and new bits will be added in the future (the ioctls are FS_IOC_FSGETXATTR and FS_IOC_FSSETXATTR but they are not related to extended attributes that are also called xattrs), there\(aqs -no standard tool to change the bits, there\(aqs support in \fBxfs_io(8)\fP as +no standard tool to change the bits, there\(aqs support in \fI\%xfs_io(8)\fP as command \fBxfs_io \-c chattr\fP .UNINDENT .SS Attributes @@ -1986,11 +1996,11 @@ empty files. .UNINDENT .TP .B d -\fIno dump\fP, makes sense with 3rd party tools like \fBdump(8)\fP, on BTRFS the +\fIno dump\fP, makes sense with 3rd party tools like \fI\%dump(8)\fP, on BTRFS the attribute can be set/unset but no other special handling is done .TP .B D -\fIsynchronous directory updates\fP, for more details search \fBopen(2)\fP for \fIO_SYNC\fP +\fIsynchronous directory updates\fP, for more details search \fI\%open(2)\fP for \fIO_SYNC\fP and \fIO_DSYNC\fP .TP .B i @@ -1999,23 +2009,23 @@ long as this attribute is set (obviously the exception is unsetting the attribut .TP .B m \fIno compression\fP, permanently turn off compression on the given file. Any -compression mount options will not affect this file. (\fBchattr\fP support added in +compression mount options will not affect this file. (\fI\%chattr(1)\fP support added in 1.46.2) .sp When set on a directory, all newly created files will inherit this attribute. This attribute cannot be set with \fIc\fP at the same time. .TP .B S -\fIsynchronous updates\fP, for more details search \fBopen(2)\fP for \fIO_SYNC\fP and +\fIsynchronous updates\fP, for more details search \fI\%open(2)\fP for \fIO_SYNC\fP and \fIO_DSYNC\fP .UNINDENT .sp No other attributes are supported. For the complete list please refer to the -\fBchattr(1)\fP manual page. +\fI\%chattr(1)\fP manual page. .SS XFLAGS .sp There\(aqs an overlap of letters assigned to the bits with the attributes, this list -refers to what \fBxfs_io(8)\fP provides: +refers to what \fI\%xfs_io(8)\fP provides: .INDENT 0.0 .TP .B i @@ -2757,10 +2767,23 @@ have been demonstrated (\fIrowhammer\fP) achieving specific bits to be flipped. While these were targeted, this shows that a series of reads or writes can affect unrelated parts of memory. .sp +Block group profiles with redundancy (like RAID1) will not protect against +memory errors as the blocks are first stored in memory before they are written +to the devices from the same source. +.sp +A filesystem mounted read\-only will not affect the underlying block device in +almost 100% (with highly unlikely exceptions). The exception is a tree\-log that +needs to be replayed during mount (and before the read\-only mount takes place), +working memory is needed for that and that can be affected by bit flips. +There\(aqs a theoretical case where bit flip changes the filesystem status from +read\-only to read\-write. +.sp Further reading: .INDENT 0.0 .IP \(bu 2 \fI\%https://en.wikipedia.org/wiki/Row_hammer\fP +.IP \(bu 2 +memory overclocking, XMP, potential risks .UNINDENT .sp What to do: @@ -2772,6 +2795,10 @@ is under heavy load that the default memtest cannot trigger memory errors may appear as filesystem going read\-only due to \(dqpre write\(dq check, that verify meta data before they get written but fail some basic consistency checks +.IP \(bu 2 +newly built systems should be tested before being put to production use, +ideally start a IO/CPU load that will be run on such system later; namely +systems that will utilize overclocking or special performance features .UNINDENT .SS Direct memory access (DMA) .sp @@ -2827,7 +2854,7 @@ to avoid unnecessary resets and performs optimizations to maximize the storage media lifetime. The known techniques are deduplication (blocks with same fingerprint/hash are mapped to same physical block), compression or internal remapping and garbage collection of used memory cells. Due to the additional -processing there are measures to verity the data e.g. by ECC codes. +processing there are measures to verify the data e.g. by ECC codes. .sp The observations of failing SSDs show that the whole electronic fails at once or affects a lot of data (e.g. stored on one chip). Recovering such data @@ -2960,13 +2987,13 @@ and replacing the card could be required as well. filesystem when it tells you.\fP .SH SEE ALSO .sp -\fBacl(5)\fP, +\fI\%acl(5)\fP, \fI\%btrfs(8)\fP, -\fBchattr(1)\fP, -\fBfstrim(8)\fP, -\fBioctl(2)\fP, +\fI\%chattr(1)\fP, +\fI\%fstrim(8)\fP, +\fI\%ioctl(2)\fP, \fI\%mkfs.btrfs(8)\fP, -\fBmount(8)\fP, -\fBswapon(8)\fP +\fI\%mount(8)\fP, +\fI\%swapon(8)\fP .\" Generated by docutils manpage writer. . diff --git a/upstream/fedora-rawhide/man5/capsule@.service.5 b/upstream/fedora-rawhide/man5/capsule@.service.5 new file mode 100644 index 00000000..b18401aa --- /dev/null +++ b/upstream/fedora-rawhide/man5/capsule@.service.5 @@ -0,0 +1,180 @@ +'\" t +.TH "CAPSULE@\&.SERVICE" "5" "" "systemd 256~rc3" "capsule@.service" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +capsule@.service \- System unit for the capsule service manager +.SH "SYNOPSIS" +.PP +capsule@\fINAME\fR\&.service +.SH "DESCRIPTION" +.PP +Service managers for capsules run in +capsule@\fINAME\fR\&.service +system units, with the capsule name as the instance identifier\&. Capsules are way to run additional instances of the service manager, under dynamic user IDs, i\&.e\&. UIDs that are allocated when the capsule service manager is started, and released when it is stopped\&. +.PP +In many ways +capsule@\&.service +is similar to the per\-user +user@\&.service +service manager, but there are a few important distinctions: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +The capsule service manager utilizes +\fIDynamicUser=\fR +(see +\fBsystemd.exec\fR(5)) to allocate a new UID dynamically on invocation\&. The user name is automatically generated from the capsule name, by prefixng +"p_"\&. The UID is released when the service is terminated\&. The user service manager on the other hand operates under a statically allocated user ID that must be pre\-existing, before the user service manager is invoked\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +User service managers register themselves with +\fBpam\fR(8), capsule service managers do not\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +User service managers typically read their configuration from a +\fI$HOME\fR +directory below +/home/, capsule service managers from a +\fI$HOME\fR +directory below +/var/lib/capsules/\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +User service managers are collectively contained in the +user\&.slice +unit, capsule service managers in +capsule\&.slice\&. Also see +\fBsystemd.special\fR(7)\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +User service managers start the user unit +default\&.target +initially\&. Capsule service managers invoke the user unit +capsule@\&.target +instead\&. +.RE +.PP +The capsule service manager and the capsule\*(Aqs bus broker can be reached via the +\fB\-\-capsule=\fR +switch to +\fBsystemctl\fR(1), +\fBsystemd-run\fR(1) +and +\fBbusctl\fR(1)\&. +.PP +New capsules can be started via a simple +\fBsystemctl start capsule@\fR\fB\fINAME\fR\fR\fB\&.service\fR +command, and stopped via +\fBsystemctl stop capsule@\fR\fB\fINAME\fR\fR\fB\&.service\fR\&. Starting a capsule will implicitly create a home directory +/var/lib/capsules/\fINAME\fR/, if missing\&. A runtime directory is created as +/run/capsules/\fINAME\fR/\&. To remove these resources use +\fBsystemctl clean capsule@\fR\fB\fINAME\fR\fR\fB\&.service\fR, for example with the +\fB\-\-what=all\fR +switch\&. +.PP +The +capsule@\&.service +unit invokes a +\fBsystemd \-\-user\fR +service manager process\&. This means unit files are looked for according to the sames rules as for regular user service managers, for example in +/var/lib/capsules/\fINAME\fR/\&.config/systemd/user/\&. +.PP +Capsule names may be chosen freely by the user, however, they must be suitable as UNIX filenames (i\&.e\&. 255 characters max, and contain no +"/"), and when prefixed with +"p\-" +be suitable as a user name matching strict POSIX rules, see +\m[blue]\fBUser/Group Name Syntax\fR\m[]\&\s-2\u[1]\d\s+2 +for details\&. +.SH "EXAMPLES" +.PP +\fBExample\ \&1.\ \&Create a new capsule, invoke two programs in it (one interactively), terminate it, and clean everything up\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +# systemctl start capsule@tatze\&.service +# systemd\-run \-\-capsule=tatze \-\-unit=sleeptest\&.service sleep 999 +# systemctl \-\-capsule=tatze status sleeptest\&.service +# systemd\-run \-t \-\-capsule=tatze bash +# systemctl \-\-capsule=tatze stop sleeptest\&.service +# systemctl stop capsule@tatze\&.service +# systemctl clean \-\-all capsule@tatze\&.service +.fi +.if n \{\ +.RE +.\} +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), +\fBuser@.service\fR(5), +\fBsystemd.service\fR(5), +\fBsystemd.slice\fR(5), +\fBsystemd.exec\fR(5), +\fBsystemd.special\fR(7), +\fBsystemctl\fR(1), +\fBsystemd-run\fR(1), +\fBbusctl\fR(1), +\fBpam\fR(8) +.SH "NOTES" +.IP " 1." 4 +User/Group Name Syntax +.RS 4 +\%https://systemd.io/USER_NAMES +.RE diff --git a/upstream/fedora-rawhide/man5/charmap.5 b/upstream/fedora-rawhide/man5/charmap.5 index 1b66a63f..7dda95c4 100644 --- a/upstream/fedora-rawhide/man5/charmap.5 +++ b/upstream/fedora-rawhide/man5/charmap.5 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH charmap 5 2023-10-31 "Linux man-pages 6.06" +.TH charmap 5 2023-10-31 "Linux man-pages 6.7" .SH NAME charmap \- character set description file .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/core.5 b/upstream/fedora-rawhide/man5/core.5 index 73408b44..ea250e20 100644 --- a/upstream/fedora-rawhide/man5/core.5 +++ b/upstream/fedora-rawhide/man5/core.5 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH core 5 2023-10-31 "Linux man-pages 6.06" +.TH core 5 2023-10-31 "Linux man-pages 6.7" .SH NAME core \- core dump file .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/coredump.conf.5 b/upstream/fedora-rawhide/man5/coredump.conf.5 index 10f56339..ba037f56 100644 --- a/upstream/fedora-rawhide/man5/coredump.conf.5 +++ b/upstream/fedora-rawhide/man5/coredump.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "COREDUMP\&.CONF" "5" "" "systemd 255" "coredump.conf" +.TH "COREDUMP\&.CONF" "5" "" "systemd 256~rc3" "coredump.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,13 +23,24 @@ coredump.conf, coredump.conf.d \- Core dump storage configuration files .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/coredump\&.conf -.PP +.RE +.RS 4 +/run/systemd/coredump\&.conf +.RE +.RS 4 +/usr/lib/systemd/coredump\&.conf +.RE +.RS 4 /etc/systemd/coredump\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /run/systemd/coredump\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/systemd/coredump\&.conf\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP These files configure the behavior of @@ -45,16 +56,16 @@ and pages for the details\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -64,7 +75,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -152,6 +168,4 @@ The defaults for all values are listed as comments in the template file that is installed by default\&. .SH "SEE ALSO" .PP -\fBsystemd-journald.service\fR(8), -\fBcoredumpctl\fR(1), -\fBsystemd-tmpfiles\fR(8) +\fBsystemd-journald.service\fR(8), \fBcoredumpctl\fR(1), \fBsystemd-tmpfiles\fR(8) diff --git a/upstream/fedora-rawhide/man5/crypttab.5 b/upstream/fedora-rawhide/man5/crypttab.5 index 1a621795..5ae5aaf9 100644 --- a/upstream/fedora-rawhide/man5/crypttab.5 +++ b/upstream/fedora-rawhide/man5/crypttab.5 @@ -1,5 +1,5 @@ '\" t -.TH "CRYPTTAB" "5" "" "systemd 255" "crypttab" +.TH "CRYPTTAB" "5" "" "systemd 256~rc3" "crypttab" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -170,8 +170,8 @@ file system socket in place of a key file in the third field\&. For details see .sp -1 .IP " 4." 4.2 .\} -The key may be acquired via a PKCS#11 compatible hardware security token or smartcard\&. In this case an encrypted key is stored on disk/removable media, acquired via -\fBAF_UNIX\fR, or stored in the LUKS2 JSON token metadata header\&. The encrypted key is then decrypted by the PKCS#11 token with an RSA key stored on it, and then used to unlock the encrypted volume\&. Use the +The key may be acquired via a PKCS#11 compatible hardware security token or smartcard\&. In this case a saved key used in unlock process is stored on disk/removable media, acquired via +\fBAF_UNIX\fR, or stored in the LUKS2 JSON token metadata header\&. For RSA, the saved key is an encrypted volume key\&. The encrypted volume key is then decrypted by the PKCS#11 token with an RSA private key stored on it, and used to unlock the encrypted volume\&. For elliptic\-curve (EC) cryptography, the saved key is the public key generated in enrollment process\&. The public key is then used to derive a shared secret with a private key stored in the PKCS#11 token\&. The derived shared secret is then used to unlock the volume\&. Use the \fBpkcs11\-uri=\fR option described below to use this mechanism\&. .RE @@ -206,7 +206,7 @@ option described below to use this mechanism\&. .PP For the latter five mechanisms the source for the key material used for unlocking the volume is primarily configured in the third field of each /etc/crypttab -line, but may also configured in +line, but may also be configured in /etc/cryptsetup\-keys\&.d/ and /run/cryptsetup\-keys\&.d/ @@ -305,6 +305,32 @@ for key files on external devices\&. Added in version 243\&. .RE .PP +\fBlink\-volume\-key=\fR +.RS 4 +Specifies the kernel keyring and key description (see +\fBkeyrings\fR(7)) where LUKS2 volume key gets linked during device activation\&. The kernel keyring description and key description must be separated by +"::"\&. +.sp +The kernel keyring part can be a string description or a predefined kernel keyring prefixed with +"@" +(e\&.g\&.: to use +"@s" +session or +"@u" +user keyring directly)\&. The type prefix text in the kernel keyring description is not required\&. The specified kernel keyring must already exist at the time of device activation\&. +.sp +The key part is a string description optionally prefixed by a +"%key_type:"\&. If no type is specified, the +"user" +type key is linked by default\&. See +\fBkeyctl\fR(1) +for more information on key descriptions (KEY IDENTIFIERS section)\&. +.sp +Note that the linked volume key is not cleaned up automatically when the device is detached\&. +.sp +Added in version 256\&. +.RE +.PP \fBluks\fR .RS 4 Force LUKS mode\&. When this mode is used, the following options are ignored since they are provided by the LUKS header on the device: @@ -360,7 +386,9 @@ Added in version 186\&. This device will not be a hard dependency of cryptsetup\&.target\&. It\*(Aqll still be pulled in and started, but the system will not wait for the device to show up and be unlocked, and boot will not fail if this is unsuccessful\&. Note that other units that depend on the unlocked device may still fail\&. In particular, if the device is used for a mount point, the mount point itself also needs to have the \fBnofail\fR -option, or the boot will fail if the device is not unlocked successfully\&. +option, or the boot will fail if the device is not unlocked successfully\&. If a keyfile and/or a +\fBheader\fR +are specified, the dependencies on their respective directories will also not be fatal, so that umounting said directories will not cause the generated cryptset unit to be deactivated\&. .sp Added in version 186\&. .RE @@ -467,11 +495,23 @@ Added in version 240\&. The encrypted block device will be used as a swap device, and will be formatted accordingly after setting up the encrypted block device, with \fBmkswap\fR(8)\&. This option implies \fBplain\fR\&. +.if n \{\ .sp -WARNING: Using the +.\} +.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 +Using the \fBswap\fR option will destroy the contents of the named partition during every boot, so make sure the underlying block device is specified correctly\&. -.sp +.sp .5v +.RE Added in version 186\&. .RE .PP @@ -569,11 +609,23 @@ or "btrfs"\&. If no argument is specified defaults to "ext4"\&. This option implies \fBplain\fR\&. +.if n \{\ .sp -WARNING: Using the +.\} +.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 +Using the \fBtmp\fR option will destroy the contents of the named partition during every boot, so make sure the underlying block device is specified correctly\&. -.sp +.sp .5v +.RE Added in version 186\&. .RE .PP @@ -616,17 +668,17 @@ Takes either the special value "auto" or an \m[blue]\fBRFC7512 PKCS#11 URI\fR\m[]\&\s-2\u[2]\d\s+2 -pointing to a private RSA key which is used to decrypt the encrypted key specified in the third column of the line\&. This is useful for unlocking encrypted volumes through PKCS#11 compatible security tokens or smartcards\&. See below for an example how to set up this mechanism for unlocking a LUKS2 volume with a YubiKey security token\&. +pointing to a private key which is used to decrypt the encrypted key specified in the third column of the line\&. This is useful for unlocking encrypted volumes through PKCS#11 compatible security tokens or smartcards\&. See below for an example how to set up this mechanism for unlocking a LUKS2 volume with a YubiKey security token\&. .sp If specified as "auto" the volume must be of type LUKS2 and must carry PKCS#11 security token metadata in its LUKS2 JSON token section\&. In this mode the URI and the encrypted key are automatically read from the LUKS2 JSON token header\&. Use \fBsystemd-cryptenroll\fR(1) -as simple tool for enrolling PKCS#11 security tokens or smartcards in a way compatible with +as a simple tool for enrolling PKCS#11 security tokens or smartcards in a way compatible with "auto"\&. In this mode the third column of the line should remain empty (that is, specified as "\-")\&. .sp -The specified URI can refer directly to a private RSA key stored on a token or alternatively just to a slot or token, in which case a search for a suitable private RSA key will be performed\&. In this case if multiple suitable objects are found the token is refused\&. The encrypted key configured in the third column of the line is passed as is (i\&.e\&. in binary form, unprocessed) to RSA decryption\&. The resulting decrypted key is then Base64 encoded before it is used to unlock the LUKS volume\&. +The specified URI can refer directly to a private key stored on a token or alternatively just to a slot or token, in which case a search for a suitable private key will be performed\&. In this case if multiple suitable objects are found the token is refused\&. The keyfile configured in the third column of the line is used as is (i\&.e\&. in binary form, unprocessed)\&. The resulting decrypted key (for RSA) or derived shared secret (for ECC) is then Base64 encoded before it is used to unlock the LUKS volume\&. .sp Use \fBsystemd\-cryptenroll \-\-pkcs11\-token\-uri=list\fR @@ -852,7 +904,7 @@ stream socket in the file system, the key is acquired by connecting to the socke \fBAF_UNIX\fR socket name in the abstract namespace, see \fBunix\fR(7) -for details\&. The source socket name is chosen according the following format: +for details\&. The source socket name is chosen according to the following format: .sp .if n \{\ .RS 4 @@ -910,7 +962,7 @@ external /dev/sda3 keyfile:LABEL=keydev keyfile\-timeout=10s,cipher=xcha .PP \fBExample\ \&2.\ \&Yubikey\-based PKCS#11 Volume Unlocking Example\fR .PP -The PKCS#11 logic allows hooking up any compatible security token that is capable of storing RSA decryption keys for unlocking an encrypted volume\&. Here\*(Aqs an example how to set up a Yubikey security token for this purpose on a LUKS2 volume, using +The PKCS#11 logic allows hooking up any compatible security token that is capable of storing RSA or EC cryptographic keys for unlocking an encrypted volume\&. Here\*(Aqs an example how to set up a Yubikey security token for this purpose on a LUKS2 volume, using \fBykmap\fR(1) from the yubikey\-manager project to initialize the token and \fBsystemd-cryptenroll\fR(1) @@ -1088,14 +1140,7 @@ sudo update\-initramfs \-u .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-cryptsetup@.service\fR(8), -\fBsystemd-cryptsetup-generator\fR(8), -\fBsystemd-cryptenroll\fR(1), -\fBfstab\fR(5), -\fBcryptsetup\fR(8), -\fBmkswap\fR(8), -\fBmke2fs\fR(8) +\fBsystemd\fR(1), \fBsystemd-cryptsetup@.service\fR(8), \fBsystemd-cryptsetup-generator\fR(8), \fBsystemd-cryptenroll\fR(1), \fBfstab\fR(5), \fBcryptsetup\fR(8), \fBmkswap\fR(8), \fBmke2fs\fR(8) .SH "NOTES" .IP " 1." 4 Veracrypt Personal Iterations Multiplier diff --git a/upstream/fedora-rawhide/man5/dir_colors.5 b/upstream/fedora-rawhide/man5/dir_colors.5 index a492f644..7c49f314 100644 --- a/upstream/fedora-rawhide/man5/dir_colors.5 +++ b/upstream/fedora-rawhide/man5/dir_colors.5 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH dir_colors 5 2024-01-28 "Linux man-pages 6.06" +.TH dir_colors 5 2024-01-28 "Linux man-pages 6.7" .SH NAME dir_colors \- configuration file for dircolors(1) .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/dnssec-trust-anchors.d.5 b/upstream/fedora-rawhide/man5/dnssec-trust-anchors.d.5 index 4671d2f5..4f4eadf8 100644 --- a/upstream/fedora-rawhide/man5/dnssec-trust-anchors.d.5 +++ b/upstream/fedora-rawhide/man5/dnssec-trust-anchors.d.5 @@ -1,5 +1,5 @@ '\" t -.TH "DNSSEC\-TRUST\-ANCHORS\&.D" "5" "" "systemd 255" "dnssec-trust-anchors.d" +.TH "DNSSEC\-TRUST\-ANCHORS\&.D" "5" "" "systemd 256~rc3" "dnssec-trust-anchors.d" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,17 +23,24 @@ dnssec-trust-anchors.d, systemd.positive, systemd.negative \- DNSSEC trust anchor configuration files .SH "SYNOPSIS" .PP +.RS 4 /etc/dnssec\-trust\-anchors\&.d/*\&.positive -.PP +.RE +.RS 4 /run/dnssec\-trust\-anchors\&.d/*\&.positive -.PP +.RE +.RS 4 /usr/lib/dnssec\-trust\-anchors\&.d/*\&.positive -.PP +.RE +.RS 4 /etc/dnssec\-trust\-anchors\&.d/*\&.negative -.PP +.RE +.RS 4 /run/dnssec\-trust\-anchors\&.d/*\&.negative -.PP +.RE +.RS 4 /usr/lib/dnssec\-trust\-anchors\&.d/*\&.negative +.RE .SH "DESCRIPTION" .PP The DNSSEC trust anchor configuration files define positive and negative trust anchors @@ -185,10 +192,7 @@ setting in files\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-resolved.service\fR(8), -\fBresolved.conf\fR(5), -\fBsystemd.network\fR(5) +\fBsystemd\fR(1), \fBsystemd-resolved.service\fR(8), \fBresolved.conf\fR(5), \fBsystemd.network\fR(5) .SH "NOTES" .IP " 1." 4 RFC 4035, Section 4.4 diff --git a/upstream/fedora-rawhide/man5/elf.5 b/upstream/fedora-rawhide/man5/elf.5 index 730d58cd..84c7f27c 100644 --- a/upstream/fedora-rawhide/man5/elf.5 +++ b/upstream/fedora-rawhide/man5/elf.5 @@ -32,7 +32,7 @@ .\" 2007-10-11, Mike Frysinger <vapier@gentoo.org>, various fixes .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH ELF 5 2023-10-31 "Linux man-pages 6.06" +.TH ELF 5 2024-02-25 "Linux man-pages 6.7" .SH NAME elf \- format of Executable and Linking Format (ELF) files .SH SYNOPSIS @@ -785,7 +785,7 @@ A readable segment. A text segment commonly has the flags .B PF_X and -.B PF_R . +.BR PF_R . A data segment commonly has .B PF_W and diff --git a/upstream/fedora-rawhide/man5/environment.d.5 b/upstream/fedora-rawhide/man5/environment.d.5 index 063bfb25..c54bd5c6 100644 --- a/upstream/fedora-rawhide/man5/environment.d.5 +++ b/upstream/fedora-rawhide/man5/environment.d.5 @@ -1,5 +1,5 @@ '\" t -.TH "ENVIRONMENT\&.D" "5" "" "systemd 255" "environment.d" +.TH "ENVIRONMENT\&.D" "5" "" "systemd 256~rc3" "environment.d" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,15 +23,21 @@ environment.d \- Definition of user service environment .SH "SYNOPSIS" .PP +.RS 4 ~/\&.config/environment\&.d/*\&.conf -.PP +.RE +.RS 4 /etc/environment\&.d/*\&.conf -.PP +.RE +.RS 4 /run/environment\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/environment\&.d/*\&.conf -.PP +.RE +.RS 4 /etc/environment +.RE .SH "DESCRIPTION" .PP Configuration files in the @@ -71,7 +77,12 @@ Packages should install their configuration files in /usr/local/lib/ (local installs)\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. It is recommended to prefix all filenames with a two\-digit number and a dash, to simplify the ordering of the files\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. It is recommended to prefix all filenames with a two\-digit number and a dash, to simplify the ordering of the files\&. It is recommended to use the range 10\-40 for configuration files in +/usr/ +and the range 60\-90 for configuration files in +/etc/ +and +/run/, to make sure that local and transient configuration files will always take priority over configuration files shipped by the OS vendor\&. .PP If the administrator wants to disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -146,6 +157,4 @@ service builds an environment that is a combination of variables forwarded from or the underlying D\-Bus call\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-environment-d-generator\fR(8), -\fBsystemd.environment-generator\fR(7) +\fBsystemd\fR(1), \fBsystemd-environment-d-generator\fR(8), \fBsystemd.environment-generator\fR(7) diff --git a/upstream/fedora-rawhide/man5/erofs.5 b/upstream/fedora-rawhide/man5/erofs.5 index 12de0ec7..f0756c71 100644 --- a/upstream/fedora-rawhide/man5/erofs.5 +++ b/upstream/fedora-rawhide/man5/erofs.5 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH erofs 5 2023-10-31 "Linux man-pages 6.06" +.TH erofs 5 2023-10-31 "Linux man-pages 6.7" .SH NAME erofs \- the Enhanced Read-Only File System .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/exports.5 b/upstream/fedora-rawhide/man5/exports.5 index 58537a22..c14769e5 100644 --- a/upstream/fedora-rawhide/man5/exports.5 +++ b/upstream/fedora-rawhide/man5/exports.5 @@ -445,6 +445,9 @@ the given list an alternative location for the filesystem. filesystem is not required; so, for example, .IR "mount --bind" " /path /path" is sufficient.) + +This option affects only NFSv4 clients. Other clients will ignore +all "refer=" parts. .TP .IR replicas= path@host[+host][:path@host[+host]] If the client asks for alternative locations for the export point, it diff --git a/upstream/fedora-rawhide/man5/filesystems.5 b/upstream/fedora-rawhide/man5/filesystems.5 index 5196cec5..14b4906d 100644 --- a/upstream/fedora-rawhide/man5/filesystems.5 +++ b/upstream/fedora-rawhide/man5/filesystems.5 @@ -4,7 +4,7 @@ .\" .\" 2007-12-14 mtk Added Reiserfs, XFS, JFS. .\" -.TH filesystems 5 2024-01-28 "Linux man-pages 6.06" +.TH filesystems 5 2024-01-28 "Linux man-pages 6.7" .nh .SH NAME filesystems \- Linux filesystem types: ext, ext2, ext3, ext4, hpfs, iso9660, diff --git a/upstream/fedora-rawhide/man5/ftpusers.5 b/upstream/fedora-rawhide/man5/ftpusers.5 index 9595622e..21b27061 100644 --- a/upstream/fedora-rawhide/man5/ftpusers.5 +++ b/upstream/fedora-rawhide/man5/ftpusers.5 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ftpusers 5 2023-10-31 "Linux man-pages 6.06" +.TH ftpusers 5 2023-10-31 "Linux man-pages 6.7" .SH NAME ftpusers \- list of users that may not log in via the FTP daemon .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/gai.conf.5 b/upstream/fedora-rawhide/man5/gai.conf.5 index 7fed47e4..0b2c2e3b 100644 --- a/upstream/fedora-rawhide/man5/gai.conf.5 +++ b/upstream/fedora-rawhide/man5/gai.conf.5 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-only .\" -.TH gai.conf 5 2023-10-31 "Linux man-pages 6.06" +.TH gai.conf 5 2023-10-31 "Linux man-pages 6.7" .SH NAME gai.conf \- getaddrinfo(3) configuration file .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/group.5 b/upstream/fedora-rawhide/man5/group.5 index 41212819..233f3072 100644 --- a/upstream/fedora-rawhide/man5/group.5 +++ b/upstream/fedora-rawhide/man5/group.5 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sat Jul 24 17:06:03 1993 by Rik Faith (faith@cs.unc.edu) -.TH group 5 2023-10-31 "Linux man-pages 6.06" +.TH group 5 2023-10-31 "Linux man-pages 6.7" .SH NAME group \- user group file .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/homed.conf.5 b/upstream/fedora-rawhide/man5/homed.conf.5 index af99d452..caf235e2 100644 --- a/upstream/fedora-rawhide/man5/homed.conf.5 +++ b/upstream/fedora-rawhide/man5/homed.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "HOMED\&.CONF" "5" "" "systemd 255" "homed.conf" +.TH "HOMED\&.CONF" "5" "" "systemd 256~rc3" "homed.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,29 +23,40 @@ homed.conf, homed.conf.d \- Home area/user account manager configuration files .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/homed\&.conf -.PP +.RE +.RS 4 +/run/systemd/homed\&.conf +.RE +.RS 4 +/usr/lib/systemd/homed\&.conf +.RE +.RS 4 /etc/systemd/homed\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /run/systemd/homed\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/systemd/homed\&.conf\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP These configuration files control default parameters for home areas/user accounts created and managed by \fBsystemd-homed.service\fR(8)\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -55,7 +66,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -106,5 +122,4 @@ Added in version 246\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-homed.service\fR(8) +\fBsystemd\fR(1), \fBsystemd-homed.service\fR(8) diff --git a/upstream/fedora-rawhide/man5/host.conf.5 b/upstream/fedora-rawhide/man5/host.conf.5 index 867c206f..73f29693 100644 --- a/upstream/fedora-rawhide/man5/host.conf.5 +++ b/upstream/fedora-rawhide/man5/host.conf.5 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" 2003-08-23 Martin Schulze <joey@infodrom.org> Updated according to glibc 2.3.2 -.TH host.conf 5 2023-10-31 "Linux man-pages 6.06" +.TH host.conf 5 2023-10-31 "Linux man-pages 6.7" .SH NAME host.conf \- resolver configuration file .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/hostname.5 b/upstream/fedora-rawhide/man5/hostname.5 index ff5139a9..7226f5c4 100644 --- a/upstream/fedora-rawhide/man5/hostname.5 +++ b/upstream/fedora-rawhide/man5/hostname.5 @@ -1,5 +1,5 @@ '\" t -.TH "HOSTNAME" "5" "" "systemd 255" "hostname" +.TH "HOSTNAME" "5" "" "systemd 256~rc3" "hostname" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -113,15 +113,7 @@ The simple configuration file format of originates from Debian GNU/Linux\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsethostname\fR(2), -\fBhostname\fR(1), -\fBhostname\fR(7), -\fBmachine-id\fR(5), -\fBmachine-info\fR(5), -\fBhostnamectl\fR(1), -\fBsystemd-hostnamed.service\fR(8), -\fBsystemd-firstboot\fR(1) +\fBsystemd\fR(1), \fBsethostname\fR(2), \fBhostname\fR(1), \fBhostname\fR(7), \fBmachine-id\fR(5), \fBmachine-info\fR(5), \fBhostnamectl\fR(1), \fBsystemd-hostnamed.service\fR(8), \fBsystemd-firstboot\fR(1) .SH "NOTES" .IP " 1." 4 NetworkManager diff --git a/upstream/fedora-rawhide/man5/hosts.5 b/upstream/fedora-rawhide/man5/hosts.5 index e111ccb8..b01c3467 100644 --- a/upstream/fedora-rawhide/man5/hosts.5 +++ b/upstream/fedora-rawhide/man5/hosts.5 @@ -5,7 +5,7 @@ .\" Minor polishing, aeb .\" Modified, 2002-06-16, Mike Coleman .\" -.TH hosts 5 2023-10-31 "Linux man-pages 6.06" +.TH hosts 5 2023-10-31 "Linux man-pages 6.7" .SH NAME hosts \- static table lookup for hostnames .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man5/hosts.equiv.5 b/upstream/fedora-rawhide/man5/hosts.equiv.5 index 53d79104..b8ff0f68 100644 --- a/upstream/fedora-rawhide/man5/hosts.equiv.5 +++ b/upstream/fedora-rawhide/man5/hosts.equiv.5 @@ -1,7 +1,7 @@ .\" Copyright (c) 1995 Peter Tobias <tobias@et-inf.fho-emden.de> .\" .\" SPDX-License-Identifier: GPL-1.0-or-later -.TH hosts.equiv 5 2023-10-31 "Linux man-pages 6.06" +.TH hosts.equiv 5 2023-10-31 "Linux man-pages 6.7" .SH NAME hosts.equiv \- list of hosts and users that are granted "trusted" .B r diff --git a/upstream/fedora-rawhide/man5/icewm-env.5 b/upstream/fedora-rawhide/man5/icewm-env.5 index 783678dc..dfaf4002 100644 --- a/upstream/fedora-rawhide/man5/icewm-env.5 +++ b/upstream/fedora-rawhide/man5/icewm-env.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-ENV 5" -.TH ICEWM-ENV 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-ENV 5 2024-05-20 "icewm\ 3.5.0" "Standards, Environments and Macros" .\" 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/man5/icewm-focus_mode.5 b/upstream/fedora-rawhide/man5/icewm-focus_mode.5 index e4e9d6d2..1a0e3859 100644 --- a/upstream/fedora-rawhide/man5/icewm-focus_mode.5 +++ b/upstream/fedora-rawhide/man5/icewm-focus_mode.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-FOCUS_MODE 5" -.TH ICEWM-FOCUS_MODE 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-FOCUS_MODE 5 2024-05-20 "icewm\ 3.5.0" "Standards, Environments and Macros" .\" 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/man5/icewm-keys.5 b/upstream/fedora-rawhide/man5/icewm-keys.5 index 2e942c95..f50dbfb3 100644 --- a/upstream/fedora-rawhide/man5/icewm-keys.5 +++ b/upstream/fedora-rawhide/man5/icewm-keys.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-KEYS 5" -.TH ICEWM-KEYS 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-KEYS 5 2024-05-20 "icewm\ 3.5.0" "Standards, Environments and Macros" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -102,7 +102,10 @@ following four ways, which are identical: \& key "Ctrl++" xterm .Ve .PP -To bind the mouse use \f(CW\*(C`Pointer_Button1\*(C'\fR for button 1, and so on. +To bind the mouse, use \f(CW\*(C`Pointer_Button1\*(C'\fR for button 1, and so on. +This only works when the mouse is over the root window. +See below for examples. +.PP The command \f(CW\*(C`icesh keys\*(C'\fR instructs icewm to reload this file. .SS FORMAT .IX Subsection "FORMAT" diff --git a/upstream/fedora-rawhide/man5/icewm-menu.5 b/upstream/fedora-rawhide/man5/icewm-menu.5 index e316d331..5fc8b5d9 100644 --- a/upstream/fedora-rawhide/man5/icewm-menu.5 +++ b/upstream/fedora-rawhide/man5/icewm-menu.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-MENU 5" -.TH ICEWM-MENU 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-MENU 5 2024-05-20 "icewm\ 3.5.0" "Standards, Environments and Macros" .\" 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/man5/icewm-preferences.5 b/upstream/fedora-rawhide/man5/icewm-preferences.5 index 37190201..d1dac365 100644 --- a/upstream/fedora-rawhide/man5/icewm-preferences.5 +++ b/upstream/fedora-rawhide/man5/icewm-preferences.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-PREFERENCES 5" -.TH ICEWM-PREFERENCES 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-PREFERENCES 5 2024-05-20 "icewm\ 3.5.0" "Standards, Environments and Macros" .\" 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/man5/icewm-prefoverride.5 b/upstream/fedora-rawhide/man5/icewm-prefoverride.5 index 52b7e8bd..fed32f60 100644 --- a/upstream/fedora-rawhide/man5/icewm-prefoverride.5 +++ b/upstream/fedora-rawhide/man5/icewm-prefoverride.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-PREFOVERRIDE 5" -.TH ICEWM-PREFOVERRIDE 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-PREFOVERRIDE 5 2024-05-20 "icewm\ 3.5.0" "Standards, Environments and Macros" .\" 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/man5/icewm-programs.5 b/upstream/fedora-rawhide/man5/icewm-programs.5 index cf55983b..f993a328 100644 --- a/upstream/fedora-rawhide/man5/icewm-programs.5 +++ b/upstream/fedora-rawhide/man5/icewm-programs.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-PROGRAMS 5" -.TH ICEWM-PROGRAMS 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-PROGRAMS 5 2024-05-20 "icewm\ 3.5.0" "Standards, Environments and Macros" .\" 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/man5/icewm-shutdown.5 b/upstream/fedora-rawhide/man5/icewm-shutdown.5 index 56cd4fa8..d870f304 100644 --- a/upstream/fedora-rawhide/man5/icewm-shutdown.5 +++ b/upstream/fedora-rawhide/man5/icewm-shutdown.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-SHUTDOWN 5" -.TH ICEWM-SHUTDOWN 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-SHUTDOWN 5 2024-05-20 "icewm\ 3.5.0" "Standards, Environments and Macros" .\" 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/man5/icewm-startup.5 b/upstream/fedora-rawhide/man5/icewm-startup.5 index 6962672c..87b70744 100644 --- a/upstream/fedora-rawhide/man5/icewm-startup.5 +++ b/upstream/fedora-rawhide/man5/icewm-startup.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-STARTUP 5" -.TH ICEWM-STARTUP 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-STARTUP 5 2024-05-20 "icewm\ 3.5.0" "Standards, Environments and Macros" .\" 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/man5/icewm-theme.5 b/upstream/fedora-rawhide/man5/icewm-theme.5 index e09988c5..962d9706 100644 --- a/upstream/fedora-rawhide/man5/icewm-theme.5 +++ b/upstream/fedora-rawhide/man5/icewm-theme.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-THEME 5" -.TH ICEWM-THEME 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-THEME 5 2024-05-20 "icewm\ 3.5.0" "Standards, Environments and Macros" .\" 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/man5/icewm-toolbar.5 b/upstream/fedora-rawhide/man5/icewm-toolbar.5 index f2af59ab..7777a060 100644 --- a/upstream/fedora-rawhide/man5/icewm-toolbar.5 +++ b/upstream/fedora-rawhide/man5/icewm-toolbar.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-TOOLBAR 5" -.TH ICEWM-TOOLBAR 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-TOOLBAR 5 2024-05-20 "icewm\ 3.5.0" "Standards, Environments and Macros" .\" 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/man5/icewm-winoptions.5 b/upstream/fedora-rawhide/man5/icewm-winoptions.5 index b305b885..ec9f3077 100644 --- a/upstream/fedora-rawhide/man5/icewm-winoptions.5 +++ b/upstream/fedora-rawhide/man5/icewm-winoptions.5 @@ -55,7 +55,7 @@ .\" ======================================================================== .\" .IX Title "ICEWM-WINOPTIONS 5" -.TH ICEWM-WINOPTIONS 5 2024-01-24 "icewm\ 3.4.5" "Standards, Environments and Macros" +.TH ICEWM-WINOPTIONS 5 2024-05-20 "icewm\ 3.5.0" "Standards, Environments and Macros" .\" 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/man5/integritytab.5 b/upstream/fedora-rawhide/man5/integritytab.5 index 1272444a..d29162af 100644 --- a/upstream/fedora-rawhide/man5/integritytab.5 +++ b/upstream/fedora-rawhide/man5/integritytab.5 @@ -1,5 +1,5 @@ '\" t -.TH "INTEGRITYTAB" "5" "" "systemd 255" "integritytab" +.TH "INTEGRITYTAB" "5" "" "systemd 256~rc3" "integritytab" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -81,7 +81,7 @@ Added in version 250\&. .PP \fBmode=(journal|bitmap|direct)\fR .RS 4 -Enable journaled, bitmapped or direct (passthrough) mode\&. Journaled mode is the default when this option is not specified\&. It provides safety against crashes, but can be slow because all data has to be written twice\&. Bitmap mode is more efficient since it requires only a single write, but it is less reliable because if data corruption happens when the machine crashes, it may not be detected\&. Direct mode disables the journal and the bitmap\&. Corresponds to the "direct writes" mode documented in +Enable journaled, bitmapped or direct (passthrough) mode\&. Journaled mode is the default when this option is not specified\&. It provides safety against crashes, but can be slow because all data has to be written twice\&. Bitmap mode is more efficient since it requires only a single write, but it is less reliable because if data corruption happens when the machine crashes, it might not be detected\&. Direct mode disables the journal and the bitmap\&. Corresponds to the "direct writes" mode documented in \m[blue]\fBthe dm\-integrity documentation\fR\m[]\&\s-2\u[1]\d\s+2\&. Note that without a journal, if there is a crash, it is possible that the integrity tags and data will not match\&. If used, the journal\-* options below will have no effect if passed\&. .sp Added in version 254\&. @@ -177,10 +177,7 @@ home PARTUUID=4973d0b8\-1b15\-c449\-96ec\-94bab7f6a7b8 /etc/hmac\&.key .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-integritysetup@.service\fR(8), -\fBsystemd-integritysetup-generator\fR(8), -\fBintegritysetup\fR(8), +\fBsystemd\fR(1), \fBsystemd-integritysetup@.service\fR(8), \fBsystemd-integritysetup-generator\fR(8), \fBintegritysetup\fR(8) .SH "NOTES" .IP " 1." 4 the dm-integrity documentation diff --git a/upstream/fedora-rawhide/man5/intro.5 b/upstream/fedora-rawhide/man5/intro.5 index ada73a01..10e885b4 100644 --- a/upstream/fedora-rawhide/man5/intro.5 +++ b/upstream/fedora-rawhide/man5/intro.5 @@ -5,7 +5,7 @@ .\" .\" Modified Sat Jul 24 17:06:52 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Sun Jan 14 00:34:09 1996 by Andries Brouwer (aeb@cwi.nl) -.TH intro 5 2023-10-31 "Linux man-pages 6.06" +.TH intro 5 2023-10-31 "Linux man-pages 6.7" .SH NAME intro \- introduction to file formats and filesystems .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/iocost.conf.5 b/upstream/fedora-rawhide/man5/iocost.conf.5 index 112f047f..94dafcef 100644 --- a/upstream/fedora-rawhide/man5/iocost.conf.5 +++ b/upstream/fedora-rawhide/man5/iocost.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "IOCOST\&.CONF" "5" "" "systemd 255" "iocost.conf" +.TH "IOCOST\&.CONF" "5" "" "systemd 256~rc3" "iocost.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -38,16 +38,16 @@ The qos and model values are calculated based on benchmarks collected on the project and turned into a set of solutions that go from most to least isolated\&. Isolation allows the system to remain responsive in face of high I/O load\&. Which solutions are available for a device can be queried from the udev metadata attached to it\&. By default the naive solution is used, which provides the most bandwidth\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -57,7 +57,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -80,9 +85,7 @@ Added in version 254\&. .RE .SH "SEE ALSO" .PP -\fBudevadm\fR(8), -\m[blue]\fBThe iocost\-benchmarks github project\fR\m[]\&\s-2\u[1]\d\s+2, -\m[blue]\fBThe resctl\-bench documentation details how the values are obtained\fR\m[]\&\s-2\u[2]\d\s+2 +\fBudevadm\fR(8), \m[blue]\fBThe iocost\-benchmarks github project\fR\m[]\&\s-2\u[1]\d\s+2, \m[blue]\fBThe resctl\-bench documentation details how the values are obtained\fR\m[]\&\s-2\u[2]\d\s+2 .SH "NOTES" .IP " 1." 4 iocost-benchmark diff --git a/upstream/fedora-rawhide/man5/issue.5 b/upstream/fedora-rawhide/man5/issue.5 index e1d6352c..c5e2501c 100644 --- a/upstream/fedora-rawhide/man5/issue.5 +++ b/upstream/fedora-rawhide/man5/issue.5 @@ -5,7 +5,7 @@ .\" .\" Modified Sun Jul 25 11:06:22 1993 by Rik Faith <faith@cs.unc.edu> .\" Modified Mon Oct 21 17:47:19 EDT 1996 by Eric S. Raymond <esr@thyrsus.com> -.TH issue 5 2022-10-30 "Linux man-pages 6.06" +.TH issue 5 2022-10-30 "Linux man-pages 6.7" .SH NAME issue \- prelogin message and identification file .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/journal-remote.conf.5 b/upstream/fedora-rawhide/man5/journal-remote.conf.5 index a2619006..4bfe1487 100644 --- a/upstream/fedora-rawhide/man5/journal-remote.conf.5 +++ b/upstream/fedora-rawhide/man5/journal-remote.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "JOURNAL\-REMOTE\&.CONF" "5" "" "systemd 255" "journal-remote.conf" +.TH "JOURNAL\-REMOTE\&.CONF" "5" "" "systemd 256~rc3" "journal-remote.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,13 +23,24 @@ journal-remote.conf, journal-remote.conf.d \- Configuration files for the service accepting remote journal uploads .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/journal\-remote\&.conf -.PP +.RE +.RS 4 +/run/systemd/journal\-remote\&.conf +.RE +.RS 4 +/usr/lib/systemd/journal\-remote\&.conf +.RE +.RS 4 /etc/systemd/journal\-remote\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /run/systemd/journal\-remote\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/systemd/journal\-remote\&.conf\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP These files configure various parameters of @@ -38,16 +49,16 @@ These files configure various parameters of for a general description of the syntax\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -57,7 +68,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -134,7 +150,4 @@ Added in version 253\&. .RE .SH "SEE ALSO" .PP -\fBjournald.conf\fR(5), -\fBsystemd\fR(1), -\fBsystemd-journal-remote.service\fR(8), -\fBsystemd-journald.service\fR(8) +\fBjournald.conf\fR(5), \fBsystemd\fR(1), \fBsystemd-journal-remote.service\fR(8), \fBsystemd-journald.service\fR(8) diff --git a/upstream/fedora-rawhide/man5/journal-upload.conf.5 b/upstream/fedora-rawhide/man5/journal-upload.conf.5 index 73889f48..c2e0c90f 100644 --- a/upstream/fedora-rawhide/man5/journal-upload.conf.5 +++ b/upstream/fedora-rawhide/man5/journal-upload.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "JOURNAL\-UPLOAD\&.CONF" "5" "" "systemd 255" "journal-upload.conf" +.TH "JOURNAL\-UPLOAD\&.CONF" "5" "" "systemd 256~rc3" "journal-upload.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -25,6 +25,10 @@ journal-upload.conf, journal-upload.conf.d \- Configuration files for the journa .PP /etc/systemd/journal\-upload\&.conf .PP +/run/systemd/journal\-upload\&.conf +.PP +/usr/lib/systemd/journal\-upload\&.conf +.PP /etc/systemd/journal\-upload\&.conf\&.d/*\&.conf .PP /run/systemd/journal\-upload\&.conf\&.d/*\&.conf @@ -38,16 +42,16 @@ These files configure various parameters of for a general description of the syntax\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -57,7 +61,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -110,6 +119,4 @@ Added in version 249\&. .RE .SH "SEE ALSO" .PP -\fBsystemd-journal-upload.service\fR(8), -\fBsystemd\fR(1), -\fBsystemd-journald.service\fR(8) +\fBsystemd-journal-upload.service\fR(8), \fBsystemd\fR(1), \fBsystemd-journald.service\fR(8) diff --git a/upstream/fedora-rawhide/man5/journald.conf.5 b/upstream/fedora-rawhide/man5/journald.conf.5 index 911b6cdf..212b7e97 100644 --- a/upstream/fedora-rawhide/man5/journald.conf.5 +++ b/upstream/fedora-rawhide/man5/journald.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "JOURNALD\&.CONF" "5" "" "systemd 255" "journald.conf" +.TH "JOURNALD\&.CONF" "5" "" "systemd 256~rc3" "journald.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,21 +23,36 @@ journald.conf, journald.conf.d, journald@.conf \- Journal service configuration files .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/journald\&.conf -.PP +.RE +.RS 4 +/run/systemd/journald\&.conf +.RE +.RS 4 +/usr/lib/systemd/journald\&.conf +.RE +.RS 4 /etc/systemd/journald\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /run/systemd/journald\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/systemd/journald\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /etc/systemd/journald@\fINAMESPACE\fR\&.conf -.PP +.RE +.RS 4 /etc/systemd/journald@\fINAMESPACE\fR\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /run/systemd/journald@\fINAMESPACE\fR\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/systemd/journald@\fINAMESPACE\fR\&.conf\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP These files configure various parameters of the systemd journal service, @@ -56,16 +71,16 @@ and associated drop\-ins with the namespace identifier filled in\&. This allows for details about journal namespaces\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -75,7 +90,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -151,6 +171,10 @@ Note that per\-user journal files are not supported unless persistent storage is \fBjournalctl \-\-user\fR unavailable\&. .sp +The storage to use can also be specified via the +"journal\&.storage" +credential\&. Values configured via configuration files take priority over values configured via the credential\&. +.sp Added in version 186\&. .RE .PP @@ -364,9 +388,11 @@ The timeout before synchronizing journal files to disk\&. After syncing, journal Added in version 199\&. .RE .PP -\fIForwardToSyslog=\fR, \fIForwardToKMsg=\fR, \fIForwardToConsole=\fR, \fIForwardToWall=\fR +\fIForwardToSyslog=\fR, \fIForwardToKMsg=\fR, \fIForwardToConsole=\fR, \fIForwardToWall=\fR, \fIForwardToSocket=\fR .RS 4 -Control whether log messages received by the journal daemon shall be forwarded to a traditional syslog daemon, to the kernel log buffer (kmsg), to the system console, or sent as wall messages to all logged\-in users\&. These options take boolean arguments\&. If forwarding to syslog is enabled but nothing reads messages from the socket, forwarding to syslog has no effect\&. By default, only forwarding to wall is enabled\&. These settings may be overridden at boot time with the kernel command line options +Control whether log messages received by the journal daemon shall be forwarded to a traditional syslog daemon, to the kernel log buffer (kmsg), to the system console, sent as wall messages to all logged\-in users or sent over a socket\&. These options take boolean arguments except for +"ForwardToSocket=" +which takes an address instead\&. If forwarding to syslog is enabled but nothing reads messages from the socket, forwarding to syslog has no effect\&. By default, only forwarding to wall is enabled\&. These settings may be overridden at boot time with the kernel command line options "systemd\&.journald\&.forward_to_syslog", "systemd\&.journald\&.forward_to_kmsg", "systemd\&.journald\&.forward_to_console", and @@ -374,6 +400,11 @@ Control whether log messages received by the journal daemon shall be forwarded t "=" and the following argument, true is assumed\&. Otherwise, the argument is parsed as a boolean\&. .sp +The socket forwarding address can be specified with the credential +"journal\&.forward_to_socket"\&. The following socket types are supported: +.sp +\fBAF_INET\fR (e\&.g\&. "192\&.168\&.0\&.11:4444"), \fBAF_INET6\fR (e\&.g\&. "[2001:db8::ff00:42:8329]:4444"), \fBAF_UNIX\fR (e\&.g\&. "/run/host/journal/socket"), \fBAF_VSOCK\fR (e\&.g\&. "vsock:2:1234") +.sp When forwarding to the console, the TTY to log to can be changed with \fITTYPath=\fR, described below\&. .sp @@ -383,15 +414,30 @@ to the kernel command line\&. \fBsystemd\fR will automatically disable kernel\*(Aqs rate\-limiting applied to userspace processes (equivalent to setting "printk\&.devkmsg=on")\&. -.PP +.sp +When forwarding over a socket the +\m[blue]\fBJournal Export Format\fR\m[]\&\s-2\u[3]\d\s+2 +is used when sending over the wire\&. Notably this includes the metadata field +\fI__REALTIME_TIMESTAMP\fR +so that +\fBsystemd\-journal\-remote\fR +(see +\fBsystemd-journal-remote.service\fR(8)) can be used to receive the forwarded journal entries\&. +.sp Note: Forwarding is performed synchronously within journald, and may significantly affect its performance\&. This is particularly relevant when using ForwardToConsole=yes in cloud environments, where the console is often a slow, virtual serial port\&. Since journald is implemented as a conventional single\-process daemon, forwarding to a completely hung console will block journald\&. This can have a cascading effect resulting in any services synchronously logging to the blocked journal also becoming blocked\&. Unless actively debugging/developing something, it\*(Aqs generally preferable to setup a \fBjournalctl \-\-follow\fR style service redirected to the console, instead of ForwardToConsole=yes, for production use\&. +.PP +Note: Using +\fIForwardToSocket=\fR +over IPv4/IPv6 links can be very slow due to the synchronous nature of the sockets\&. Take care to ensure your link is a low\-latency local link if possible\&. Typically IP networking is not available everywhere journald runs, e\&.g\&. in the initrd during boot\&. Consider using +\fBAF_VSOCK\fR/\fBAF_UNIX\fR +sockets for this if possible\&. .RE .PP -\fIMaxLevelStore=\fR, \fIMaxLevelSyslog=\fR, \fIMaxLevelKMsg=\fR, \fIMaxLevelConsole=\fR, \fIMaxLevelWall=\fR +\fIMaxLevelStore=\fR, \fIMaxLevelSyslog=\fR, \fIMaxLevelKMsg=\fR, \fIMaxLevelConsole=\fR, \fIMaxLevelWall=\fR, \fIMaxLevelSocket=\fR .RS 4 -Controls the maximum log level of messages that are stored in the journal, forwarded to syslog, kmsg, the console or wall (if that is enabled, see above)\&. As argument, takes one of +Controls the maximum log level of messages that are stored in the journal, forwarded to syslog, kmsg, the console, the wall, or a socket (if that is enabled, see above)\&. As argument, takes one of "emerg", "alert", "crit", @@ -402,9 +448,10 @@ Controls the maximum log level of messages that are stored in the journal, forwa "debug", or integer values in the range of 0\(en7 (corresponding to the same levels)\&. Messages equal or below the log level specified are stored/forwarded, messages above are dropped\&. Defaults to "debug" for -\fIMaxLevelStore=\fR +\fIMaxLevelStore=\fR, +\fIMaxLevelSyslog=\fR and -\fIMaxLevelSyslog=\fR, to ensure that the all messages are stored in the journal and forwarded to syslog\&. Defaults to +\fIMaxLevelSocket=\fR, to ensure that the all messages are stored in the journal, forwarded to syslog and the socket if one exists\&. Defaults to "notice" for \fIMaxLevelKMsg=\fR, @@ -418,7 +465,8 @@ for "systemd\&.journald\&.max_level_syslog=", "systemd\&.journald\&.max_level_kmsg=", "systemd\&.journald\&.max_level_console=", -"systemd\&.journald\&.max_level_wall="\&. +"systemd\&.journald\&.max_level_wall=", +"systemd\&.journald\&.max_level_socket="\&. .sp Added in version 185\&. .RE @@ -491,11 +539,7 @@ option, and not the option, is relevant for them\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-journald.service\fR(8), -\fBjournalctl\fR(1), -\fBsystemd.journal-fields\fR(7), -\fBsystemd-system.conf\fR(5) +\fBsystemd\fR(1), \fBsystemd-journald.service\fR(8), \fBjournalctl\fR(1), \fBsystemd.journal-fields\fR(7), \fBsystemd-system.conf\fR(5) .SH "NOTES" .IP " 1." 4 Seekable Sequential Key Generators @@ -507,3 +551,8 @@ Users, Groups, UIDs and GIDs on systemd systems .RS 4 \%https://systemd.io/UIDS-GIDS .RE +.IP " 3." 4 +Journal Export Format +.RS 4 +\%https://systemd.io/JOURNAL_EXPORT_FORMATS/#journal-export-format +.RE diff --git a/upstream/fedora-rawhide/man5/lmhosts.5 b/upstream/fedora-rawhide/man5/lmhosts.5 index ccd4d9c3..497964dc 100644 --- a/upstream/fedora-rawhide/man5/lmhosts.5 +++ b/upstream/fedora-rawhide/man5/lmhosts.5 @@ -2,12 +2,12 @@ .\" Title: lmhosts .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/26/2024 +.\" Date: 05/08/2024 .\" Manual: File Formats and Conventions -.\" Source: Samba 4.20.0rc3 +.\" Source: Samba 4.20.1 .\" Language: English .\" -.TH "LMHOSTS" "5" "02/26/2024" "Samba 4\&.20\&.0rc3" "File Formats and Conventions" +.TH "LMHOSTS" "5" "05/08/2024" "Samba 4\&.20\&.1" "File Formats and Conventions" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -112,7 +112,7 @@ or /usr/local/samba/lib\&. .SH "VERSION" .PP -This man page is part of version 4\&.20\&.0rc3 of the Samba suite\&. +This man page is part of version 4\&.20\&.1 of the Samba suite\&. .SH "SEE ALSO" .PP \fBsmbclient\fR(1), diff --git a/upstream/fedora-rawhide/man5/locale.5 b/upstream/fedora-rawhide/man5/locale.5 index 4c6f9a64..3dade710 100644 --- a/upstream/fedora-rawhide/man5/locale.5 +++ b/upstream/fedora-rawhide/man5/locale.5 @@ -7,7 +7,7 @@ .\" 2008-06-17 Petr Baudis <pasky@suse.cz> .\" LC_TIME: Describe first_weekday and first_workday .\" -.TH locale 5 2024-01-28 "Linux man-pages 6.06" +.TH locale 5 2024-01-28 "Linux man-pages 6.7" .SH NAME locale \- describes a locale definition file .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/locale.conf.5 b/upstream/fedora-rawhide/man5/locale.conf.5 index 531a8d8f..c3c2148c 100644 --- a/upstream/fedora-rawhide/man5/locale.conf.5 +++ b/upstream/fedora-rawhide/man5/locale.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "LOCALE\&.CONF" "5" "" "systemd 255" "locale.conf" +.TH "LOCALE\&.CONF" "5" "" "systemd 256~rc3" "locale.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -108,8 +108,4 @@ LC_MESSAGES=en_US\&.UTF\-8 .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBlocale\fR(7), -\fBlocalectl\fR(1), -\fBsystemd-localed.service\fR(8), -\fBsystemd-firstboot\fR(1) +\fBsystemd\fR(1), \fBlocale\fR(7), \fBlocalectl\fR(1), \fBsystemd-localed.service\fR(8), \fBsystemd-firstboot\fR(1) diff --git a/upstream/fedora-rawhide/man5/localtime.5 b/upstream/fedora-rawhide/man5/localtime.5 index 091dfcc0..9b8a0ed3 100644 --- a/upstream/fedora-rawhide/man5/localtime.5 +++ b/upstream/fedora-rawhide/man5/localtime.5 @@ -1,5 +1,5 @@ '\" t -.TH "LOCALTIME" "5" "" "systemd 255" "localtime" +.TH "LOCALTIME" "5" "" "systemd 256~rc3" "localtime" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -59,9 +59,4 @@ to change the settings of this file from the command line during runtime\&. Use to initialize the time zone on mounted (but not booted) system images\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBtzset\fR(3), -\fBlocaltime\fR(3), -\fBtimedatectl\fR(1), -\fBsystemd-timedated.service\fR(8), -\fBsystemd-firstboot\fR(1) +\fBsystemd\fR(1), \fBtzset\fR(3), \fBlocaltime\fR(3), \fBtimedatectl\fR(1), \fBsystemd-timedated.service\fR(8), \fBsystemd-firstboot\fR(1) diff --git a/upstream/fedora-rawhide/man5/logind.conf.5 b/upstream/fedora-rawhide/man5/logind.conf.5 index 5089cb9c..0572aa17 100644 --- a/upstream/fedora-rawhide/man5/logind.conf.5 +++ b/upstream/fedora-rawhide/man5/logind.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "LOGIND\&.CONF" "5" "" "systemd 255" "logind.conf" +.TH "LOGIND\&.CONF" "5" "" "systemd 256~rc3" "logind.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,13 +23,24 @@ logind.conf, logind.conf.d \- Login manager configuration files .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/logind\&.conf -.PP +.RE +.RS 4 +/run/systemd/logind\&.conf +.RE +.RS 4 +/usr/lib/systemd/logind\&.conf +.RE +.RS 4 /etc/systemd/logind\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /run/systemd/logind\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/systemd/logind\&.conf\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP These files configure various parameters of the systemd login manager, @@ -38,16 +49,16 @@ These files configure various parameters of the systemd login manager, for a general description of the syntax\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -57,7 +68,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -158,7 +174,8 @@ Configures the action to take when the system is idle\&. Takes one of "suspend", "hibernate", "hybrid\-sleep", -"suspend\-then\-hibernate", and +"suspend\-then\-hibernate", +"sleep", and "lock"\&. Defaults to "ignore"\&. .sp @@ -196,6 +213,28 @@ the per\-user service for a user is never terminated again after first login, an Added in version 240\&. .RE .PP +\fISleepOperation=\fR +.RS 4 +Takes a list of sleep operations\&. Possible values are +"suspend", +"hibernate", +"hybrid\-sleep", and +"suspend\-then\-hibernate"\&. Controls the candidate sleep operations for the +"sleep" +action\&. When +"sleep" +action is performed, the specified sleep operations are checked in a fixed order ("suspend\-then\-hibernate" +→ +"hybrid\-sleep" +→ +"suspend" +→ +"hibernate"), and the first one supported by the machine is used to put the system into sleep\&. Defaults to +"suspend\-then\-hibernate suspend hibernate"\&. +.sp +Added in version 256\&. +.RE +.PP \fIHandlePowerKey=\fR, \fIHandlePowerKeyLongPress=\fR, \fIHandleRebootKey=\fR, \fIHandleRebootKeyLongPress=\fR, \fIHandleSuspendKey=\fR, \fIHandleSuspendKeyLongPress=\fR, \fIHandleHibernateKey=\fR, \fIHandleHibernateKeyLongPress=\fR, \fIHandleLidSwitch=\fR, \fIHandleLidSwitchExternalPower=\fR, \fIHandleLidSwitchDocked=\fR .RS 4 Controls how logind shall handle the system power, reboot and sleep keys and the lid switch to trigger actions such as system power\-off, reboot or suspend\&. Can be one of @@ -208,6 +247,7 @@ Controls how logind shall handle the system power, reboot and sleep keys and the "hibernate", "hybrid\-sleep", "suspend\-then\-hibernate", +"sleep", "lock", and "factory\-reset"\&. If "ignore", @@ -354,7 +394,11 @@ Added in version 212\&. .RS 4 Specifies a timeout in seconds, or a time span value after which systemd\-logind -checks the idle state of all sessions\&. Every session that is idle for longer then the timeout will be stopped\&. Defaults to +checks the idle state of all sessions\&. Every session that is idle for longer than the timeout will be stopped\&. Note that this option doesn\*(Aqt apply to +"greeter" +or +"lock\-screen" +sessions\&. Defaults to "infinity" (systemd\-logind is not checking the idle state of sessions)\&. For details about the syntax of time spans, see @@ -364,7 +408,4 @@ Added in version 252\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-logind.service\fR(8), -\fBloginctl\fR(1), -\fBsystemd-system.conf\fR(5) +\fBsystemd\fR(1), \fBsystemd-logind.service\fR(8), \fBloginctl\fR(1), \fBsystemd-system.conf\fR(5) diff --git a/upstream/fedora-rawhide/man5/machine-id.5 b/upstream/fedora-rawhide/man5/machine-id.5 index a85e524b..10d5cd55 100644 --- a/upstream/fedora-rawhide/man5/machine-id.5 +++ b/upstream/fedora-rawhide/man5/machine-id.5 @@ -1,5 +1,5 @@ '\" t -.TH "MACHINE\-ID" "5" "" "systemd 255" "machine-id" +.TH "MACHINE\-ID" "5" "" "systemd 256~rc3" "machine-id" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -89,7 +89,8 @@ will attempt to use the D\-Bus machine ID from product_uuid or the devicetree vm,uuid -(on KVM systems), and finally a randomly generated UUID\&. +(on KVM systems), the Xen hypervisor +uuid, and finally a randomly generated UUID\&. .PP After the machine ID is established, \fBsystemd\fR(1) @@ -231,15 +232,7 @@ file introduced by D\-Bus\&. In fact, this latter file might be a symlink to /etc/machine\-id\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-machine-id-setup\fR(1), -\fBgethostid\fR(3), -\fBhostname\fR(5), -\fBmachine-info\fR(5), -\fBos-release\fR(5), -\fBsd-id128\fR(3), -\fBsd_id128_get_machine\fR(3), -\fBsystemd-firstboot\fR(1) +\fBsystemd\fR(1), \fBsystemd-machine-id-setup\fR(1), \fBgethostid\fR(3), \fBhostname\fR(5), \fBmachine-info\fR(5), \fBos-release\fR(5), \fBsd-id128\fR(3), \fBsd_id128_get_machine\fR(3), \fBsystemd-firstboot\fR(1) .SH "NOTES" .IP " 1." 4 Safely Building Images diff --git a/upstream/fedora-rawhide/man5/machine-info.5 b/upstream/fedora-rawhide/man5/machine-info.5 index f77dc12b..105e38cc 100644 --- a/upstream/fedora-rawhide/man5/machine-info.5 +++ b/upstream/fedora-rawhide/man5/machine-info.5 @@ -1,5 +1,5 @@ '\" t -.TH "MACHINE\-INFO" "5" "" "systemd 255" "machine-info" +.TH "MACHINE\-INFO" "5" "" "systemd 256~rc3" "machine-info" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -143,12 +143,7 @@ DEPLOYMENT=production .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBos-release\fR(5), -\fBhostname\fR(5), -\fBmachine-id\fR(5), -\fBhostnamectl\fR(1), -\fBsystemd-hostnamed.service\fR(8) +\fBsystemd\fR(1), \fBos-release\fR(5), \fBhostname\fR(5), \fBmachine-id\fR(5), \fBhostnamectl\fR(1), \fBsystemd-hostnamed.service\fR(8) .SH "NOTES" .IP " 1." 4 XDG Icon Naming Specification diff --git a/upstream/fedora-rawhide/man5/makepkg.conf.5 b/upstream/fedora-rawhide/man5/makepkg.conf.5 index 7c5fe2de..aad557bb 100644 --- a/upstream/fedora-rawhide/man5/makepkg.conf.5 +++ b/upstream/fedora-rawhide/man5/makepkg.conf.5 @@ -2,12 +2,12 @@ .\" Title: makepkg.conf .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "MAKEPKG\&.CONF" "5" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "MAKEPKG\&.CONF" "5" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -107,13 +107,6 @@ in place of Flags used for the C++ compiler; see CFLAGS for more info\&. .RE .PP -\fBRUSTFLAGS=\fR"rustflags" -.RS 4 -Flags used for the Rust compiler, similar in spirit to CFLAGS\&. Read -\fBrustc\fR(1) -for more details on the available flags\&. -.RE -.PP \fBLDFLAGS=\fR"ldflags" .RS 4 Flags used for the linker\&. Several options may be specified with common usage resembling \(lq\-Wl,\-\-hash\-style=gnu\(rq\&. Read ld(1) for more details on available linker flags\&. @@ -147,15 +140,6 @@ for use in debugging\&. Usually this would include: \(lq\-g\(rq\&. Read gcc(1) f Debug flags used for the C++ compiler; see DEBUG_CFLAGS for more info\&. .RE .PP -\fBDEBUG_RUSTFLAGS=\fR"debug_rustflags" -.RS 4 -Additional compiler flags appended to -RUSTFLAGS -for use in debugging\&. Usually this would include: \(lq\-C debuginfo=2\(rq\&. Read -\fBrustc\fR(1) -for more details on the available flags\&. -.RE -.PP \fBBUILDENV=(\fR!distcc !color !ccache check !sign\fB)\fR .RS 4 This array contains options that affect the build environment; the defaults are shown here\&. All options should always be left in the array; to enable or disable an option, simply remove or add an \(lq!\(rq at the front of the option\&. If an option is specified multiple times, the final value takes precedence\&. Each option works as follows: @@ -216,7 +200,7 @@ Specify a key to use for GPG signing instead of the default key in the keyring\& option\&. .RE .PP -\fBOPTIONS=(\fR!strip docs libtool staticlibs emptydirs !zipman !purge !debug\fB)\fR +\fBOPTIONS=(\fR!strip docs libtool staticlibs emptydirs \&...\fB)\fR .RS 4 This array contains options that affect default packaging\&. They are equivalent to options that can be placed in the PKGBUILD; the defaults are shown here\&. All options should always be left in the array; to enable or disable an option, simply remove or add an \(lq!\(rq at the front of the option\&. If an option is specified multiple times, the final value takes precedence\&. Each option works as follows: .PP @@ -276,6 +260,11 @@ Add the user\-specified debug flags as specified in DEBUG_CFLAGS and DEBUG_CXXFL .RS 4 Enable building packages using link time optimization\&. Adds the flags specified in LTOFLAGS to CFLAGS, CXXFLAGS and LDFLAGS (or \(lq\-flto\(rq if LTOFLAGS is empty)\&. .RE +.PP +\fBautodeps\fR +.RS 4 +Enable the automatic addition of libraries to the depends and provides arrays\&. Search library directories are controlled by the LIB_DIRS variable defined below\&. +.RE .RE .PP \fBINTEGRITY_CHECK=(\fRcheck1 \&...\fB)\fR @@ -334,6 +323,17 @@ array, this variable will instruct makepkg where to look to remove docs\&. If yo Do not add the leading slash to the directory name\&. .RE .PP +\fBLIB_DIRS=(\fRlib:usr/lib \&...\fB)\fR +.RS 4 +If +autodeps +is specified in the +OPTIONS +array, this variable will instruct makepkg where to look to find libraries to add to the +provides +array\&. The format is "prefix:path", where provides will be added for libraries found in "path" with the specified prefix added\&. +.RE +.PP \fBPURGE_TARGETS=(\fRusr/{,share}/info/dir \&.podlist *\&.pod\&...\fB)\fR .RS 4 If @@ -388,6 +388,10 @@ Sets the command and options used when compressing compiled or source packages i \fBPKGEXT=\fR"\&.pkg\&.tar\&.gz", \fBSRCEXT=\fR"\&.src\&.tar\&.gz" .RS 4 Sets the compression used when making compiled or source packages\&. Valid suffixes are +\&.pkg +or +\&.src +(for PKGEXT and SRCEXT resepectively) followed by one of \&.tar\&.gz, \&.tar\&.bz2, \&.tar\&.xz, @@ -452,17 +456,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 @@ -545,4 +538,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/man5/mlocate.db.5 b/upstream/fedora-rawhide/man5/mlocate.db.5 deleted file mode 100644 index 60814d6b..00000000 --- a/upstream/fedora-rawhide/man5/mlocate.db.5 +++ /dev/null @@ -1,131 +0,0 @@ -.\" A man page for mlocate.db. -*- nroff -*- -.\" -.\" Copyright (C) 2005, 2007 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 mlocate.db 5 "Jan 2007" mlocate - -.SH NAME -mlocate.db \- a mlocate database - -.SH DESCRIPTION -A mlocate database starts with a file header: -8 bytes for a magic number (\fB"\\0mlocate"\fR like a C literal), -4 bytes for the -.I configuration block -size in big endian, -1 byte for file format version (\fB0\fR), -1 byte for the \*(lqrequire visibility\*(rq flag (\fB0\fR or \fB1\fR), -2 bytes padding, -and a \f(SMNUL\fR-terminated path name of the root of the database. - -The header is followed by a \fIconfiguration block\fR, -included to ensure databases are not reused -if some configuration changes -could affect their contents. -The size of the configuration block in bytes is stored in the file header. -The configuration block is a sequence of \fIvariable assignments\fR, -ordered by variable name. -Each -.I variable assignment -consists of a \f(SMNUL\fR-terminated variable name -and an ordered list of \f(SMNUL\fR-terminated values. -The value list is terminated by one more -.SM NUL -character. -The ordering used is defined by the -.B strcmp () -function. - -Currently defined variables are: -.TP -\fBprune_bind_mounts\fR -A single entry, the value of \fbPRUNE_BIND_MOUNTS\fR; one of the strings -.B 0 -or \fB1\fR. - -.TP -\fBprunefs\fR -The value of \fBPRUNEFS\fR, each entry is converted to uppercase. - -.TP -\fBprunepaths\fR -The value of \fBPRUNEPATHS\fR. - -.P -The rest of the file until -.SM EOF -describes directories and their contents. -Each directory starts with a header: -8 bytes for -.I directory time -(seconds) in big endian, -4 bytes for -.I directory time -(nanoseconds) in big endian (0 if unknown, less than 1,000,000,000), -4 bytes padding, -and a \f(SMNUL\fR-terminated path name of the the directory. -Directory contents, a sequence of -.I file entries -sorted by name, follow. - -.I Directory time -is the maximum of -.B st_ctime -and -.B st_mtime -of the directory. -.BR updatedb (8) -uses the original data if the -.I directory time -in the database and in the file system match exactly. -.I Directory time -equal to 0 always causes rescanning of the directory: -this is necessary to handle directories -which were being updated while building the database. - -Each -.I file entry -starts with a single byte, marking its type: -.TP -\fB0\fR -A non-directory file. -Followed by a \f(SMNUL\fR-terminated file (not path) name. - -.TP -\fB1\fR -A subdirectory. -Followed by a \f(SMNUL\fR-terminated file (not path) name. - -.TP -\fB2\fR -Marks the end of the current directory. - -.P -.BR locate(1) -only reports file entries, -directory names are not reported -because they are reported as an entry in their parent directory. -The only exception is the root directory of the database, -which is stored in the file header. - -.SH AUTHOR -Miloslav Trmac <mitr@redhat.com> - -.SH SEE ALSO -.BR locate (1), -.BR updatedb.conf (5), -.BR updatedb (8) diff --git a/upstream/fedora-rawhide/man5/modules-load.d.5 b/upstream/fedora-rawhide/man5/modules-load.d.5 index 1570e788..1b0af433 100644 --- a/upstream/fedora-rawhide/man5/modules-load.d.5 +++ b/upstream/fedora-rawhide/man5/modules-load.d.5 @@ -1,5 +1,5 @@ '\" t -.TH "MODULES\-LOAD\&.D" "5" "" "systemd 255" "modules-load.d" +.TH "MODULES\-LOAD\&.D" "5" "" "systemd 256~rc3" "modules-load.d" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,11 +23,15 @@ modules-load.d \- Configure kernel modules to load at boot .SH "SYNOPSIS" .PP +.RS 4 /etc/modules\-load\&.d/*\&.conf -.PP +.RE +.RS 4 /run/modules\-load\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/modules\-load\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP \fBsystemd-modules-load.service\fR(8) @@ -62,7 +66,12 @@ Packages should install their configuration files in /usr/local/lib/ (local installs)\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. It is recommended to prefix all filenames with a two\-digit number and a dash, to simplify the ordering of the files\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. It is recommended to prefix all filenames with a two\-digit number and a dash, to simplify the ordering of the files\&. It is recommended to use the range 10\-40 for configuration files in +/usr/ +and the range 60\-90 for configuration files in +/etc/ +and +/run/, to make sure that local and transient configuration files will always take priority over configuration files shipped by the OS vendor\&. .PP If the administrator wants to disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -84,7 +93,4 @@ virtio\-net .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-modules-load.service\fR(8), -\fBsystemd-delta\fR(1), -\fBmodprobe\fR(8) +\fBsystemd\fR(1), \fBsystemd-modules-load.service\fR(8), \fBsystemd-delta\fR(1), \fBmodprobe\fR(8) diff --git a/upstream/fedora-rawhide/man5/motd.5 b/upstream/fedora-rawhide/man5/motd.5 index e530f542..26dc74e9 100644 --- a/upstream/fedora-rawhide/man5/motd.5 +++ b/upstream/fedora-rawhide/man5/motd.5 @@ -5,7 +5,7 @@ .\" .\" Modified Sat Jul 24 17:08:16 1993 by Rik Faith <faith@cs.unc.edu> .\" Modified Mon Oct 21 17:47:19 EDT 1996 by Eric S. Raymond <esr@thyrsus.com> -.TH motd 5 2023-10-31 "Linux man-pages 6.06" +.TH motd 5 2023-10-31 "Linux man-pages 6.7" .SH NAME motd \- message of the day .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/nanorc.5 b/upstream/fedora-rawhide/man5/nanorc.5 index 4416b7dd..672f6e16 100644 --- a/upstream/fedora-rawhide/man5/nanorc.5 +++ b/upstream/fedora-rawhide/man5/nanorc.5 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2003-2011, 2013-2023 Free Software Foundation, Inc. +.\" Copyright (C) 2003-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,14 +16,14 @@ .\" Documentation License along with this program. If not, see .\" <https://www.gnu.org/licenses/>. .\" -.TH NANORC 5 "version 7.2" "January 2023" +.TH NANORC 5 "version 8.0" "May 2024" .SH NAME nanorc \- GNU nano's configuration file .SH DESCRIPTION The \fInanorc\fP files contain the default settings for \fBnano\fP, -a small and friendly editor. During startup, if \fB\-\-rcfile\fR +a small and friendly text editor. During startup, if \fB\-\-rcfile\fR is not given, \fBnano\fR will read two files: first the system-wide settings, from \fI/etc/nanorc\fP (the exact path might be different on your system), and then the user-specific settings, either @@ -32,6 +32,24 @@ or from \fI~/.config/nano/nanorc\fR, whichever is encountered first. If \fB\-\-rcfile\fR is given, \fBnano\fR will read just the specified settings file. +.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 OPTIONS The configuration file accepts a series of \fBset\fP and \fBunset\fP commands, which can be used to configure nano on startup without using @@ -80,10 +98,12 @@ with \fBset backup\fR or \fB\-\-backup\fR or \fB\-B\fR. The uniquely numbered files are stored in the specified \fIdirectory\fR. .TP .B set boldtext -Use bold instead of reverse video for the title bar, status bar, key combos, -function tags, line numbers, and selected text. This can be overridden by -setting the options \fBtitlecolor\fP, \fBstatuscolor\fP, \fBkeycolor\fP, -\fBfunctioncolor\fP, \fBnumbercolor\fP, and \fBselectedcolor\fP. +Use bold instead of reverse video for the title bar, status bar, +prompt bar, mini bar, key combos, function tags, line numbers, +and selected text. This can be overridden by setting the options +\fBtitlecolor\fP, \fBstatuscolor\fP, +\fBpromptcolor\fP, \fBminicolor\fP, \fBkeycolor\fP, \fBfunctioncolor\fP, +\fBnumbercolor\fP, and/or \fBselectedcolor\fP. .TP .B set bookstyle When justifying, treat any line that starts with whitespace as the @@ -171,7 +191,7 @@ The default value is "\fB(<[{)>]}\fP". .B set 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), @@ -186,7 +206,7 @@ The line plus column numbers and the character code are displayed only when The state flags are displayed only when \fBset stateflags\fR is used. .TP .B set minicolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR -Use this color combination for the minibar. +Use this color combination for the mini bar. (When this option is not specified, the colors of the title bar are used.) See \fBset titlecolor\fR for more details. .TP @@ -239,7 +259,7 @@ See \fBset titlecolor\fR for more details. .BI "set punct """ characters """ Set the characters treated as closing punctuation when justifying paragraphs. This may not include blank characters. Only the -specfified closing punctuation, optionally followed by closing brackets +specified closing punctuation, optionally followed by closing brackets (see \fBbrackets\fP), can end sentences. The default value is "\fB!.?\fP". .TP .B set quickblank @@ -278,8 +298,6 @@ Save a changed buffer automatically on exit (\fB^X\fR); don't prompt. .TP .B set scrollercolor \fIfgcolor\fB,\fIbgcolor\fR Use this color combination for the indicator alias "scrollbar". -(On terminal emulators that link to a libvte older than version 0.55, -using a background color here does not work correctly.) See \fBset titlecolor\fR for more details. .TP .B set selectedcolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR @@ -335,6 +353,7 @@ greater than 0. The default value is \fB8\fR. .B set 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 .B set titlecolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR Use this color combination for the title bar. @@ -345,6 +364,8 @@ Each of these eight names may be prefixed with the word \fBlight\fR to get a brighter version of that color. The word \fBgrey\fR or \fBgray\fR may be used as a synonym for \fBlightblack\fR. +On a Linux console, \fBlight\fR does not have +any effect for a background color. On terminal emulators that can do at least 256 colors, other valid (but unprefixable) color names are: .BR pink ", " purple ", " mauve ", " lagoon ", " mint ", " @@ -398,12 +419,6 @@ 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. -.SH NOTES -Option \fBset suspendable\fR has been removed. -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.) - .SH SYNTAX HIGHLIGHTING Coloring the different syntactic elements of a file is done via regular expressions (see the \fBcolor\fR command below). @@ -444,9 +459,10 @@ will be added to this syntax, until a new \fBsyntax\fR command is encountered. .sp When \fBnano\fR is run, this syntax will be automatically -activated if the current filename matches the extended regular -expression \fIfileregex\fR. Or the syntax can be explicitly -activated by using the \fB\-Y\fR or \fB\-\-syntax\fR +activated (for the relevant buffer) if the absolute filename +matches the extended regular expression \fIfileregex\fR. +Or the syntax can be explicitly activated (for all buffers) +by using the \fB\-Y\fR or \fB\-\-syntax\fR command-line option followed by the \fIname\fR. .sp The syntax \fBdefault\fP is special: it takes no \fIfileregex\fR, @@ -499,6 +515,8 @@ Each of these eight names may be prefixed with the word \fBlight\fR to get a brighter version of that color. The word \fBgrey\fR or \fBgray\fR may be used as a synonym for \fBlightblack\fR. +On a Linux console, \fBlight\fR does not have +any effect for a background color. On terminal emulators that can do at least 256 colors, other valid (but unprefixable) color names are: .BR pink ", " purple ", " mauve ", " lagoon ", " mint ", " @@ -570,7 +588,7 @@ menus where the key exists when \fBall\fP is used). .sp Note that \fBbind \fIkey\fR \fB"{\fIfunction\fB}"\fR \fImenu\fR is equivalent to \fBbind \fIkey\fR \fIfunction\fR \fImenu\fR, except that for the latter form -\fBnano\fR will check the availabilty of the \fIfunction\fR in the given \fImenu\fR +\fBnano\fR will check the availability of the \fIfunction\fR in the given \fImenu\fR at startup time (and report an error if it does not exist there), whereas for the first form \fBnano\fR will check at execution time that the \fIfunction\fR exists but not whether it makes any sense in the current menu. The user has to take care @@ -791,6 +809,12 @@ Moves the cursor to the beginning of the current or preceding block of text. .B nextblock Moves the cursor to the beginning of the next block of text. .TP +.B toprow +Moves the cursor to the first row in the viewport. +.TP +.B bottomrow +Moves the cursor to the last row in the viewport. +.TP .B pageup Goes up one screenful. .TP @@ -886,7 +910,7 @@ Toggles between searching for something and replacing something. Toggles between searching for text and targeting a line number. .TP .B flipexecute -Toggles between inserting a file and executing a command. +Switches from inserting a file to executing a command. .TP .B flippipe When executing a command, toggles whether the current buffer (or marked @@ -1038,6 +1062,20 @@ For \fBbind\fR it means all menus where the specified \fIfunction\fR exists; for \fBunbind\fR it means all menus where the specified \fIkey\fR exists. .RE +.SH EXAMPLES +To make \fBCtrl+Z\fR suspend nano: +.sp +.RS +.B bind ^Z suspend main +.RE +.sp +To make \fBShift+Alt+C\fR copy the marked region to the system's clipboard: +.sp +.RS +.B bind Sh-M-C """{execute}| xsel -ib {enter}{undo}""" main +.RE +.sp + .SH FILES .TP .I /etc/nanorc diff --git a/upstream/fedora-rawhide/man5/networkd.conf.5 b/upstream/fedora-rawhide/man5/networkd.conf.5 index caead9da..9064e702 100644 --- a/upstream/fedora-rawhide/man5/networkd.conf.5 +++ b/upstream/fedora-rawhide/man5/networkd.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "NETWORKD\&.CONF" "5" "" "systemd 255" "networkd.conf" +.TH "NETWORKD\&.CONF" "5" "" "systemd 256~rc3" "networkd.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,26 +23,39 @@ networkd.conf, networkd.conf.d \- Global Network configuration files .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/networkd\&.conf -.PP +.RE +.RS 4 +/run/systemd/networkd\&.conf +.RE +.RS 4 +/usr/lib/systemd/networkd\&.conf +.RE +.RS 4 /etc/systemd/networkd\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 +/run/systemd/networkd\&.conf\&.d/*\&.conf +.RE +.RS 4 /usr/lib/systemd/networkd\&.conf\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP -These configuration files control global network parameters\&. Currently the DHCP Unique Identifier (DUID)\&. +These configuration files control global network parameters\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -52,7 +65,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -111,6 +129,16 @@ is true or Added in version 246\&. .RE .PP +\fIManageForeignNextHops=\fR +.RS 4 +A boolean\&. When true, +\fBsystemd\-networkd\fR +will remove nexthops that are not configured in \&.network files (except for routes with protocol +"kernel")\&. When false, it will not remove any foreign nexthops, keeping them even if they are not configured in a \&.network file\&. Defaults to yes\&. +.sp +Added in version 256\&. +.RE +.PP \fIRouteTable=\fR .RS 4 Defines the route table name\&. Takes a whitespace\-separated list of the pairs of route table name and number\&. The route table name and number in each pair are separated with a colon, i\&.e\&., @@ -122,6 +150,31 @@ Defines the route table name\&. Takes a whitespace\-separated list of the pairs Added in version 248\&. .RE .PP +\fIIPv4Forwarding=\fR +.RS 4 +Configures IPv4 packet forwarding for the system\&. Takes a boolean value\&. This controls the +net\&.ipv4\&.conf\&.default\&.forwarding +and +net\&.ipv4\&.conf\&.all\&.forwardingsysctl options\&. See +\m[blue]\fBIP Sysctl\fR\m[]\&\s-2\u[1]\d\s+2 +for more details about the sysctl options\&. Defaults to unset and the sysctl options will not be changed\&. +.sp +Added in version 256\&. +.RE +.PP +\fIIPv6Forwarding=\fR +.RS 4 +Configures IPv6 packet forwarding for the system\&. Takes a boolean value\&. This controls the +net\&.ipv6\&.conf\&.default\&.forwarding +and +net\&.ipv6\&.conf\&.all\&.forwarding +sysctl options\&. See +\m[blue]\fBIP Sysctl\fR\m[]\&\s-2\u[1]\d\s+2 +for more details about the sysctl options\&. Defaults to unset and the sysctl options will not be changed\&. +.sp +Added in version 256\&. +.RE +.PP \fIIPv6PrivacyExtensions=\fR .RS 4 Specifies the default value for per\-network @@ -134,6 +187,30 @@ and .sp Added in version 254\&. .RE +.PP +\fIUseDomains=\fR +.RS 4 +Specifies the network\- and protocol\-independent default value for the same settings in [IPv6AcceptRA], [DHCPv4], and [DHCPv6] sections below\&. Takes a boolean, or the special value +\fBroute\fR\&. See the same setting in +\fBsystemd.network\fR(5)\&. Defaults to +"no"\&. +.sp +Added in version 256\&. +.RE +.SH "[IPV6ACCEPTRA] SECTION OPTIONS" +.PP +This section configures the default setting of the Neighbor Discovery\&. The following options are available in the [IPv6AcceptRA] section: +.PP +\fIUseDomains=\fR +.RS 4 +Specifies the network\-independent default value for the same setting in the [IPv6AcceptRA] section in +\fBsystemd.network\fR(5)\&. Takes a boolean, or the special value +\fBroute\fR\&. When unspecified, the value specified in the [Network] section in +\fBnetworkd.conf\fR(5), which defaults to +"no", will be used\&. +.sp +Added in version 256\&. +.RE .SH "[DHCPV4] SECTION OPTIONS" .PP This section configures the DHCP Unique Identifier (DUID) value used by DHCP protocol\&. DHCPv4 client protocol sends IAID and DUID to the DHCP server when acquiring a dynamic IPv4 address if @@ -145,7 +222,7 @@ The following options are understood: \fIDUIDType=\fR .RS 4 Specifies how the DUID should be generated\&. See -\m[blue]\fBRFC 3315\fR\m[]\&\s-2\u[1]\d\s+2 +\m[blue]\fBRFC 3315\fR\m[]\&\s-2\u[2]\d\s+2 for a description of all the options\&. .sp This takes an integer in the range 0\&...65535, or one of the following string values: @@ -209,8 +286,8 @@ The DUID value specified here overrides the DUID that \fBsystemd-networkd.service\fR(8) generates from the machine ID\&. To configure DUID per\-network, see \fBsystemd.network\fR(5)\&. The configured DHCP DUID should conform to the specification in -\m[blue]\fBRFC 3315\fR\m[]\&\s-2\u[2]\d\s+2, -\m[blue]\fBRFC 6355\fR\m[]\&\s-2\u[3]\d\s+2\&. To configure IAID, see +\m[blue]\fBRFC 3315\fR\m[]\&\s-2\u[3]\d\s+2, +\m[blue]\fBRFC 6355\fR\m[]\&\s-2\u[4]\d\s+2\&. To configure IAID, see \fBsystemd.network\fR(5)\&. .PP \fBExample\ \&1.\ \&A DUIDType=vendor with a custom value\fR @@ -231,6 +308,13 @@ This specifies a 14 byte DUID, with the type DUID\-EN ("00:02"), enterprise numb Added in version 230\&. .RE +.PP +\fIUseDomains=\fR +.RS 4 +Same as the one in the [IPv6AcceptRA] section, but applied for DHCPv4 protocol\&. +.sp +Added in version 256\&. +.RE .SH "[DHCPV6] SECTION OPTIONS" .PP This section configures the DHCP Unique Identifier (DUID) value used by DHCPv6 protocol\&. DHCPv6 client protocol sends the DHCP Unique Identifier and the interface Identity Association Identifier (IAID) to a DHCPv6 server when acquiring a dynamic IPv6 address\&. IAID and DUID allows a DHCPv6 server to uniquely identify the machine and the interface requesting a DHCP IP address\&. To configure IAID, see @@ -244,25 +328,43 @@ As in the [DHCPv4] section\&. .sp Added in version 249\&. .RE +.PP +\fIUseDomains=\fR +.RS 4 +As in the [DHCPv4] section\&. +.sp +Added in version 256\&. +.RE +.SH "[DHCPSERVER] SECTION OPTIONS" +.PP +This section configures the default setting of the DHCP server\&. The following options are available in the [DHCPServer] section: +.PP +\fIUseDomains=\fR +.RS 4 +Same as the one in the [IPv6AcceptRA] section, but applied for DHCPv4 protocol\&. +.sp +Added in version 256\&. +.RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.network\fR(5), -\fBsystemd-networkd.service\fR(8), -\fBmachine-id\fR(5), -\fBsd_id128_get_machine_app_specific\fR(3) +\fBsystemd\fR(1), \fBsystemd.network\fR(5), \fBsystemd-networkd.service\fR(8), \fBmachine-id\fR(5), \fBsd_id128_get_machine_app_specific\fR(3) .SH "NOTES" .IP " 1." 4 +IP Sysctl +.RS 4 +\%https://docs.kernel.org/networking/ip-sysctl.html +.RE +.IP " 2." 4 RFC 3315 .RS 4 \%https://tools.ietf.org/html/rfc3315#section-9 .RE -.IP " 2." 4 +.IP " 3." 4 RFC 3315 .RS 4 \%http://tools.ietf.org/html/rfc3315#section-9 .RE -.IP " 3." 4 +.IP " 4." 4 RFC 6355 .RS 4 \%http://tools.ietf.org/html/rfc6355 diff --git a/upstream/fedora-rawhide/man5/networks.5 b/upstream/fedora-rawhide/man5/networks.5 index f30ceef9..168c2c58 100644 --- a/upstream/fedora-rawhide/man5/networks.5 +++ b/upstream/fedora-rawhide/man5/networks.5 @@ -4,7 +4,7 @@ .\" .\" 2008-09-04, mtk, taken from Debian downstream, with a few light edits .\" -.TH networks 5 2023-10-31 "Linux man-pages 6.06" +.TH networks 5 2024-02-25 "Linux man-pages 6.7" .SH NAME networks \- network name information .SH DESCRIPTION @@ -15,7 +15,7 @@ names for these networks. Each line represents a network and has the following structure: .P .RS -.I name number aliases ... +.I name number aliases .\|.\|. .RE .P where the fields are delimited by spaces or tabs. diff --git a/upstream/fedora-rawhide/man5/nfs.5 b/upstream/fedora-rawhide/man5/nfs.5 index 7103d28e..233a7177 100644 --- a/upstream/fedora-rawhide/man5/nfs.5 +++ b/upstream/fedora-rawhide/man5/nfs.5 @@ -186,6 +186,10 @@ infrequently used request types are retried after 1.1 seconds. After each retransmission, the NFS client doubles the timeout for that request, up to a maximum timeout length of 60 seconds. +.IP +Any timeo value greater than default value will be set to the default value. +For TCP and RDMA, default value is 600 (60 seconds). +For UDP, default value is 60 (6 seconds). .TP 1.5i .BI retrans= n The number of times the NFS client retries a request before diff --git a/upstream/fedora-rawhide/man5/nologin.5 b/upstream/fedora-rawhide/man5/nologin.5 index e5875188..b5242a4c 100644 --- a/upstream/fedora-rawhide/man5/nologin.5 +++ b/upstream/fedora-rawhide/man5/nologin.5 @@ -5,7 +5,7 @@ .\" .\" Modified Sun Jul 25 11:06:34 1993 by Rik Faith (faith@cs.unc.edu) .\" Corrected Mon Oct 21 17:47:19 EDT 1996 by Eric S. Raymond (esr@thyrsus.com) -.TH nologin 5 2022-10-30 "Linux man-pages 6.06" +.TH nologin 5 2022-10-30 "Linux man-pages 6.7" .SH NAME nologin \- prevent unprivileged users from logging into the system .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/nscd.conf.5 b/upstream/fedora-rawhide/man5/nscd.conf.5 index 6f9695cd..c2a1d61e 100644 --- a/upstream/fedora-rawhide/man5/nscd.conf.5 +++ b/upstream/fedora-rawhide/man5/nscd.conf.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH nscd.conf 5 2023-10-31 "Linux man-pages 6.06" +.TH nscd.conf 5 2023-10-31 "Linux man-pages 6.7" .SH NAME nscd.conf \- name service cache daemon configuration file .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/nss.5 b/upstream/fedora-rawhide/man5/nss.5 index cf301fc3..00b9f0c7 100644 --- a/upstream/fedora-rawhide/man5/nss.5 +++ b/upstream/fedora-rawhide/man5/nss.5 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-only .\" -.TH nss 5 2023-10-31 "Linux man-pages 6.06" +.TH nss 5 2023-10-31 "Linux man-pages 6.7" .SH NAME nss \- Name Service Switch configuration file .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/nsswitch.conf.5 b/upstream/fedora-rawhide/man5/nsswitch.conf.5 index 2d2bd64c..34dd7d7a 100644 --- a/upstream/fedora-rawhide/man5/nsswitch.conf.5 +++ b/upstream/fedora-rawhide/man5/nsswitch.conf.5 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH nsswitch.conf 5 2023-10-31 "Linux man-pages 6.06" +.TH nsswitch.conf 5 2023-10-31 "Linux man-pages 6.7" .SH NAME nsswitch.conf \- Name Service Switch configuration file .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/oomd.conf.5 b/upstream/fedora-rawhide/man5/oomd.conf.5 index b6b0b1a8..706775a8 100644 --- a/upstream/fedora-rawhide/man5/oomd.conf.5 +++ b/upstream/fedora-rawhide/man5/oomd.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "OOMD\&.CONF" "5" "" "systemd 255" "oomd.conf" +.TH "OOMD\&.CONF" "5" "" "systemd 256~rc3" "oomd.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,11 +23,24 @@ oomd.conf, oomd.conf.d \- Global \fBsystemd\-oomd\fR configuration files .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/oomd\&.conf -.PP +.RE +.RS 4 +/run/systemd/oomd\&.conf +.RE +.RS 4 +/usr/lib/systemd/oomd\&.conf +.RE +.RS 4 /etc/systemd/oomd\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 +/run/systemd/oomd\&.conf\&.d/*\&.conf +.RE +.RS 4 /usr/lib/systemd/oomd\&.conf\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP These files configure the various parameters of the @@ -38,16 +51,16 @@ userspace out\-of\-memory (OOM) killer, for a general description of the syntax\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -57,7 +70,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -108,7 +126,4 @@ Added in version 248\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.resource-control\fR(5), -\fBsystemd-oomd.service\fR(8), -\fBoomctl\fR(1) +\fBsystemd\fR(1), \fBsystemd.resource-control\fR(5), \fBsystemd-oomd.service\fR(8), \fBoomctl\fR(1) diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.LogControl1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.LogControl1.5 index 70733a8e..30ea304e 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.LogControl1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.LogControl1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.LOGCONTROL1" "5" "" "systemd 255" "org.freedesktop.LogControl1" +.TH "ORG\&.FREEDESKTOP\&.LOGCONTROL1" "5" "" "systemd 256~rc3" "org.freedesktop.LogControl1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -181,13 +181,10 @@ for details about #define _cleanup_(f) __attribute__((cleanup(f))) -#define check(log_level, x) ({ \e - int _r = (x); \e - errno = _r < 0 ? \-_r : 0; \e - sd_journal_print((log_level), #x ": %m"); \e - if (_r < 0) \e - return EXIT_FAILURE; \e - }) +static int log_error(int log_level, int error, const char *str) { + sd_journal_print(log_level, "%s failed: %s", str, strerror(\-error)); + return error; +} typedef enum LogTarget { LOG_TARGET_JOURNAL, @@ -265,7 +262,8 @@ static int property_set( return r; if (strcmp(property, "LogLevel") == 0) { - for (int i = 0; i < LOG_DEBUG + 1; i++) + int i; + for (i = 0; i < LOG_DEBUG + 1; i++) if (strcmp(value, log_level_table[i]) == 0) { o\->log_level = i; setlogmask(LOG_UPTO(i)); @@ -279,7 +277,8 @@ static int property_set( } if (strcmp(property, "LogTarget") == 0) { - for (LogTarget i = 0; i < _LOG_TARGET_MAX; i++) + LogTarget i; + for (i = 0; i < _LOG_TARGET_MAX; i++) if (strcmp(value, log_target_table[i]) == 0) { o\->log_target = i; return 0; @@ -331,6 +330,7 @@ int main(int argc, char **argv) { \&.log_target = LOG_TARGET_JOURNAL, \&.syslog_identifier = "example", }; + int r; /* https://man7\&.org/linux/man\-pages/man3/setlogmask\&.3\&.html * Programs using syslog() instead of sd_journal can use this API to cut logs @@ -341,37 +341,49 @@ int main(int argc, char **argv) { /* Acquire a connection to the bus, letting the library work out the details\&. * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_default\&.html */ - check(o\&.log_level, sd_bus_default(&bus)); + r = sd_bus_default(&bus); + if (r < 0) + return log_error(o\&.log_level, r, "sd_bus_default()"); /* Publish an interface on the bus, specifying our well\-known object access * path and public interface name\&. * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_add_object\&.html * https://dbus\&.freedesktop\&.org/doc/dbus\-tutorial\&.html */ - check(o\&.log_level, sd_bus_add_object_vtable(bus, NULL, - "/org/freedesktop/LogControl1", - "org\&.freedesktop\&.LogControl1", - vtable, - &o)); + r = sd_bus_add_object_vtable(bus, NULL, + "/org/freedesktop/LogControl1", + "org\&.freedesktop\&.LogControl1", + vtable, + &o); + if (r < 0) + return log_error(o\&.log_level, r, "sd_bus_add_object_vtable()"); /* By default the service is assigned an ephemeral name\&. Also add a fixed * one, so that clients know whom to call\&. * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_request_name\&.html */ - check(o\&.log_level, sd_bus_request_name(bus, "org\&.freedesktop\&.Example", 0)); + r = sd_bus_request_name(bus, "org\&.freedesktop\&.Example", 0); + if (r < 0) + return log_error(o\&.log_level, r, "sd_bus_request_name()"); for (;;) { /* https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_wait\&.html */ - check(o\&.log_level, sd_bus_wait(bus, UINT64_MAX)); + r = sd_bus_wait(bus, UINT64_MAX); + if (r < 0) + return log_error(o\&.log_level, r, "sd_bus_wait()"); /* https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_process\&.html */ - check(o\&.log_level, sd_bus_process(bus, NULL)); + r = sd_bus_process(bus, NULL); + if (r < 0) + return log_error(o\&.log_level, r, "sd_bus_process()"); } /* https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_release_name\&.html */ - check(o\&.log_level, sd_bus_release_name(bus, "org\&.freedesktop\&.Example")); + r = sd_bus_release_name(bus, "org\&.freedesktop\&.Example"); + if (r < 0) + return log_error(o\&.log_level, r, "sd_bus_release_name()"); return 0; } @@ -384,8 +396,4 @@ This creates a simple server on the bus\&. It implements the LogControl1 interfa \fBsd_journal_print\fR(3)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBjournalctl\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.service\fR(5), -\fBsyslog\fR(3) +\fBsystemd\fR(1), \fBjournalctl\fR(1), \fBsystemctl\fR(1), \fBsystemd.service\fR(5), \fBsyslog\fR(3) diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.home1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.home1.5 index b91e1d7e..fc16afb4 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.home1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.home1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.HOME1" "5" "" "systemd 255" "org.freedesktop.home1" +.TH "ORG\&.FREEDESKTOP\&.HOME1" "5" "" "systemd 256~rc3" "org.freedesktop.home1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -61,14 +61,18 @@ node /org/freedesktop/home1 { out b incomplete, out o bus_path); ListHomes(out a(susussso) home_areas); - @org\&.freedesktop\&.systemd1\&.Privileged("true") ActivateHome(in s user_name, in s secret); + ActivateHomeIfReferenced(in s user_name, + in s secret); @org\&.freedesktop\&.systemd1\&.Privileged("true") DeactivateHome(in s user_name); RegisterHome(in s user_record); UnregisterHome(in s user_name); CreateHome(in s user_record); + CreateHomeEx(in s user_record, + in a{sh} blobs, + in t flags); RealizeHome(in s user_name, in s secret); RemoveHome(in s user_name); @@ -78,6 +82,9 @@ node /org/freedesktop/home1 { AuthenticateHome(in s user_name, in s secret); UpdateHome(in s user_record); + UpdateHomeEx(in s user_record, + in a{sh} blobs, + in t flags); ResizeHome(in s user_name, in t size, in s secret); @@ -98,6 +105,10 @@ node /org/freedesktop/home1 { in b please_suspend, out h send_fd); @org\&.freedesktop\&.systemd1\&.Privileged("true") + RefHomeUnrestricted(in s user_name, + in b please_suspend, + out h send_fd); + @org\&.freedesktop\&.systemd1\&.Privileged("true") ReleaseHome(in s user_name); @org\&.freedesktop\&.systemd1\&.Privileged("true") LockAllHomes(); @@ -144,6 +155,10 @@ node /org/freedesktop/home1 { + + + + .SS "Methods" .PP \fBGetHomeByName()\fR @@ -151,7 +166,7 @@ returns basic user information (a minimal subset of the full user record), provi \fBgetpwnam\fR(3) returns: the numeric UID and GID, the real name, home directory and shell\&. In addition it returns a state identifier describing the state the user\*(Aqs home directory is in, as well as a bus path referring to the bus object encapsulating the user record and home directory\&. This object implements the org\&.freedesktop\&.home1\&.Home -interface documented below\&. +interface documented below\&. This method, and most others in this interface that take user names, will try to use the caller\*(Aqs home area if the specified user name is an empty string\&. .PP \fBGetHomeByUID()\fR is similar to @@ -190,6 +205,11 @@ method on the org\&.freedesktop\&.home1\&.Home interface documented below, but may be called on the manager object and takes a user name as additional argument, instead\&. .PP +\fBActivateHomeIfReferenced()\fR +is identical to +\fBActivateHome()\fR\&. However, the call only succeeds if the home directory is currently referenced\&. Useful in conjunction with +\fBRefHomeUnrestricted()\fR, which allows creating a reference to a home directory even if the home directory is not active\&. +.PP \fBDeactivateHome()\fR deactivates (i\&.e\&. unmounts) the home directory of the specified user\&. It is equivalent to the \fBDeactivate()\fR @@ -222,6 +242,21 @@ registers and creates a new home directory\&. This takes a fully specified JSON "secret" section)\&. This registers the user record locally and creates a home directory matching it, depending on the settings specified in the record in combination with local configuration\&. .PP +\fBCreateHomeEx()\fR +is like +\fBCreateHome()\fR, but it allows the home directory to be created with a pre\-populated blob directory (see +\m[blue]\fBUser Record Blob Directories\fR\m[]\&\s-2\u[2]\d\s+2 +for more info)\&. This can be done via the dictionary passed as the +\fIblobs\fR +argument to this method: the values are open file descriptors to regular files, and the keys are the filenames that should contain their respective file\*(Aqs data in the blob directory\&. Note that for security reasons, the file descriptors passed into this method must have enough privileges to read their target file and thus cannot be +"O_PATH"; this is done to ensure the caller is actually permitted to read the file they are asking to publish in the blob directories\&. If the user record passed as the first argument contains a +"blobManifest" +field it will be enforced; otherwise, a +"blobManifest" +field will be generated and inserted into the record\&. The +\fIflags\fR +argument may be used for future expansion, but for now pass 0\&. +.PP \fBRealizeHome()\fR creates a home directory whose user record is already registered locally\&. This takes a user name plus a user record consisting only of the "secret" @@ -268,7 +303,7 @@ org\&.freedesktop\&.home1\&.Home interface\&. .PP \fBUpdateHome()\fR -updates a locally registered user record\&. Takes a fully specified JSON user record as argument (including the +updates a locally registered user record\&. Takes a fully specified JSON user record as argument (possibly including the "secret" section)\&. A user with a matching name and realm must be registered locally already, and the last change timestamp of the newly supplied record must be newer than the previously existing user record\&. Note this operation updates the user record only, it does not propagate passwords/authentication tokens from the user record to the storage back\-end, or resizes the storage back\-end\&. Typically a home directory is first updated, and then the password of the underlying storage updated using \fBChangePasswordHome()\fR @@ -279,10 +314,40 @@ on the org\&.freedesktop\&.home1\&.Home interface\&. .PP +\fBUpdateHomeEx()\fR +is like +\fBUpdateHome()\fR, but it allows for changes to the blob directory (see +\m[blue]\fBUser Record Blob Directories\fR\m[]\&\s-2\u[2]\d\s+2 +for more info)\&. The +\fIblobs\fR +argument works in the same way as +\fBCreateHomeEx()\fR, so check there for details\&. The new blob directory contents passed into this method will completely replace the user\*(Aqs existing blob directory\&. The +\fIflags\fR +argument can be used to further customize the behavior of this method via flags defined as follows: +.sp +.if n \{\ +.RS 4 +.\} +.nf +#define SD_HOMED_UPDATE_OFFLINE (UINT64_C(1) << 0) + +.fi +.if n \{\ +.RE +.\} +.PP +When +\fBSD_HOMED_UPDATE_OFFLINE\fR +(0x01) is set, no attempt is made to update the copies of the user record and blob directory that are embedded into the home directory\&. Changes will be stored, however, and may be propagated into the home directory the next time it is reconciled (most likely when the user next logs in)\&. Note that any changes made with this flag set may be lost if the home area has a newer record, which can happen if the home area is updated on another machine after this method call\&. This method is equivalent to +\fBUpdateEx()\fR +on the +org\&.freedesktop\&.home1\&.Home +interface\&. +.PP \fBResizeHome()\fR -resizes the storage associated with a user record\&. Takes a user name, a disk size in bytes and a user record consisting only of the +resizes the storage associated with a user record\&. Takes a user name, a disk size in bytes, and optionally a user record consisting only of the "secret" -section as argument\&. If the size is specified as +section as arguments\&. If the size is specified as \fBUINT64_MAX\fR the storage is resized to the size already specified in the user record\&. Typically, if the user record is updated using \fBUpdateHome()\fR @@ -306,7 +371,7 @@ org\&.freedesktop\&.home1\&.Home interface\&. .PP \fBLockHome()\fR -temporarily suspends access to a home directory, flushing out any cryptographic keys from memory\&. This is only supported on some back\-ends, and usually done during system suspend, in order to effectively secure home directories while the system is sleeping\&. Takes a user name as single argument\&. If an application attempts to access a home directory while it is locked it will typically freeze until the home directory is unlocked again\&. This method is equivalent to +temporarily suspends access to a home directory, flushing out any cryptographic keys from memory\&. This is only supported on some back\-ends, and is usually done during system suspend, in order to effectively secure home directories while the system is sleeping\&. Takes a user name as single argument\&. If an application attempts to access a home directory while it is locked it will typically freeze until the home directory is unlocked again\&. This method is equivalent to \fBLock()\fR on the org\&.freedesktop\&.home1\&.Home @@ -342,6 +407,12 @@ on the org\&.freedesktop\&.home1\&.Home interface\&. .PP +\fBRefHomeUnrestricted()\fR +is identical to +\fBRefHome()\fR +but succeeds even if the home area is not active currently\&. This is useful on conjunction with +\fBActivateHomeIfReferenced()\fR\&. +.PP \fBReleaseHome()\fR releases a home directory again, if all file descriptors referencing it are already closed, that where acquired through \fBAcquireHome()\fR @@ -375,8 +446,8 @@ field set are listed here, with the seat name they are associated with\&. A disp node /org/freedesktop/home1/home { interface org\&.freedesktop\&.home1\&.Home { methods: - @org\&.freedesktop\&.systemd1\&.Privileged("true") Activate(in s secret); + ActivateIfReferenced(in s secret); @org\&.freedesktop\&.systemd1\&.Privileged("true") Deactivate(); Unregister(); @@ -386,6 +457,9 @@ node /org/freedesktop/home1/home { Fixate(in s secret); Authenticate(in s secret); Update(in s user_record); + UpdateEx(in s user_record, + in a{sh} blobs, + in t flags); Resize(in t size, in s secret); ChangePassword(in s new_secret, @@ -402,6 +476,9 @@ node /org/freedesktop/home1/home { Ref(in b please_suspend, out h send_fd); @org\&.freedesktop\&.systemd1\&.Privileged("true") + RefUnrestricted(in b please_suspend, + out h send_fd); + @org\&.freedesktop\&.systemd1\&.Privileged("true") Release(); properties: @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") @@ -446,9 +523,13 @@ node /org/freedesktop/home1/home { + + + .SS "Methods" .PP \fBActivate()\fR, +\fBActivateIfReferenced()\fR, \fBDeactivate()\fR, \fBUnregister()\fR, \fBRealize()\fR, @@ -456,16 +537,17 @@ node /org/freedesktop/home1/home { \fBFixate()\fR, \fBAuthenticate()\fR, \fBUpdate()\fR, +\fBUpdateEx()\fR, \fBResize()\fR, \fBChangePassword()\fR, \fBLock()\fR, \fBUnlock()\fR, \fBAcquire()\fR, \fBRef()\fR, -\fBRelease()\fR -operate like their matching counterparts on the +\fBRefUnrestricted()\fR, +\fBRelease()\fR, operate like their matching counterparts on the org\&.freedesktop\&.home1\&.Manager -interface (see above)\&. The main difference is that they are methods of the home directory objects, and hence carry no additional user name parameter\&. Which of the two flavors of methods to call depends on the handles to the user known on the client side: if only the user name is known, it\*(Aqs preferable to use the methods on the manager object since they operate with user names only\&. If however the home object path was already acquired some way it is preferable to operate on the +interface (see above)\&. The main difference is that they are methods of the home directory objects, and hence carry no additional user name parameter\&. Which of the two flavors of methods to call depends on the handles to the user known on the client side: if only the user name is known, it\*(Aqs preferable to use the methods on the manager object since they operate with user names only\&. Clients can also easily operate on their own home area by using the methods on the manager object with an empty string as the user name\&. If the client has the home\*(Aqs object path already acquired in some way, however, it is preferable to operate on the org\&.freedesktop\&.home1\&.Home objects instead\&. .SS "Properties" @@ -489,12 +571,24 @@ contains the full JSON user record string of the user account\&. .SH "VERSIONING" .PP These D\-Bus interfaces follow -\m[blue]\fBthe usual interface versioning guidelines\fR\m[]\&\s-2\u[2]\d\s+2\&. +\m[blue]\fBthe usual interface versioning guidelines\fR\m[]\&\s-2\u[3]\d\s+2\&. +.SH "HISTORY" +.SS "The Manager Object" +.PP +\fBActivateHomeIfReferenced()\fR, +\fBRefHomeUnrestricted()\fR, +\fBCreateHomeEx()\fR, and +\fBUpdateHomeEx()\fR +were added in version 256\&. +.SS "Home Objects" +.PP +\fBActivateIfReferenced()\fR, +\fBRefUnrestricted()\fR, and +\fBUpdateEx()\fR +were added in version 256\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-homed.service\fR(8), -\fBhomectl\fR(1) +\fBsystemd\fR(1), \fBsystemd-homed.service\fR(8), \fBhomectl\fR(1) .SH "NOTES" .IP " 1." 4 JSON User Records @@ -502,6 +596,11 @@ JSON User Records \%https://systemd.io/USER_RECORD .RE .IP " 2." 4 +User Record Blob Directories +.RS 4 +\%https://systemd.io/USER_RECORD_BLOB_DIRS +.RE +.IP " 3." 4 the usual interface versioning guidelines .RS 4 \%https://0pointer.de/blog/projects/versioning-dbus.html diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.hostname1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.hostname1.5 index b0d8da1f..fb7782bc 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.hostname1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.hostname1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.HOSTNAME1" "5" "" "systemd 255" "org.freedesktop.hostname1" +.TH "ORG\&.FREEDESKTOP\&.HOSTNAME1" "5" "" "systemd 256~rc3" "org.freedesktop.hostname1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -93,6 +93,8 @@ node /org/freedesktop/hostname1 { readonly ay MachineID = [\&.\&.\&.]; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly ay BootID = [\&.\&.\&.]; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") + readonly u VSockCID = \&.\&.\&.; }; interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. }; @@ -138,6 +140,7 @@ node /org/freedesktop/hostname1 { + .PP Whenever the hostname or other metadata is changed via the daemon, \fBPropertyChanged\fR @@ -260,6 +263,42 @@ and \fIHOME_URL=\fR fields from \fBos-release\fR(5)\&. The purpose of those properties is to allow remote clients to access this information over D\-Bus\&. Local clients can access the information directly\&. +.PP +\fIMachineID\fR +expose the 128bit machine ID, see +\fBmachine-id\fR(5) +for details\&. +.PP +\fIBootID\fR +expose the 128bit boot ID, as per +/proc/sys/kernel/random/boot_id\&. +.PP +\fIVSockCID\fR +exposes the system\*(Aqs local +\fBAF_VSOCK\fR +CID (Context Identifier, i\&.e\&. address) for the system, if one is available in the virtual machine environment\&. Set to +\fBUINT32_MAX\fR +otherwise\&. See +\fBvsock\fR(7) +for details\&. +.PP +\fIOperatingSystemSupportEnd\fR +exposes when the OS\*(Aq vendor support ends, if this information is known\&. It\*(Aqs an unsigned 64bit value, in \(mcs since the UNIX epoch, UTC\&. If this information is not known carries the value 2^64\-1, i\&.e\&. +\fBUINT64_MAX\fR\&. +.PP +\fIHardwareVendor\fR +and +\fIHardwareModel\fR +expose information about the vendor of the hardware of the system\&. If no such information can be determined these properties are set to empty strings\&. +.PP +\fIFirmwareVersion\fR +and +\fIFirmwareVendor\fR +expose information about the system\*(Aqs firmware, i\&.e\&. a version string and a vendor name\&. If no such information can be determined these properties are set to empty strings\&. +.PP +\fIFirmwareDate\fR +exposes the firmware build date, if that information is known\&. It\*(Aqs an unsigned 64bit value, in \(mcs since the UNIX epoch, UTC\&. If not known +\fBUNIT64_MAX\fR\&. .SS "Methods" .PP \fBSetHostname()\fR @@ -307,6 +346,9 @@ for the semantics of those settings\&. returns the "product UUID" as exposed by the kernel based on DMI information in /sys/class/dmi/id/product_uuid\&. Reading the file directly requires root privileges, and this method allows access to unprivileged clients through the polkit framework\&. .PP +\fBGetHardwareSerial()\fR +returns the "hardware serial" as exposed by the kernel based on DMI information\&. Reading the file directly requires root privileges, and this method allows access to unprivileged clients through the polkit framework\&. +.PP \fBDescribe()\fR returns a JSON representation of all properties in one\&. .SS "Security" @@ -597,8 +639,10 @@ were added in version 251\&. \fIFirmwareDate\fR were added in version 253\&. .PP -\fIMachineID\fR, and +\fIMachineID\fR, \fIBootID\fR +and +\fIVSockCID\fR were added in version 256\&. .SH "NOTES" .IP " 1." 4 diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.import1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.import1.5 index cbea124e..19745bde 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.import1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.import1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.IMPORT1" "5" "" "systemd 255" "org.freedesktop.import1" +.TH "ORG\&.FREEDESKTOP\&.IMPORT1" "5" "" "systemd 256~rc3" "org.freedesktop.import1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -24,11 +24,11 @@ org.freedesktop.import1 \- The D\-Bus interface of systemd\-importd .SH "INTRODUCTION" .PP \fBsystemd-importd.service\fR(8) -is a system service which may be used to import, export and download additional system images\&. These images can be used by tools such as +is a system service which may be used to import, export and download disk images\&. These images can be used by tools such as \fBsystemd-nspawn\fR(1) to run local containers\&. The service is used as the backend for -\fBmachinectl pull\-raw\fR, -\fBmachinectl pull\-tar\fR +\fBimportctl pull\-raw\fR, +\fBimportctl pull\-tar\fR and related commands\&. This page describes the D\-Bus interface\&. .PP Note that @@ -55,42 +55,94 @@ node /org/freedesktop/import1 { in b read_only, out u transfer_id, out o transfer_path); + ImportTarEx(in h fd, + in s local_name, + in s class, + in t flags, + out u transfer_id, + out o transfer_path); ImportRaw(in h fd, in s local_name, in b force, in b read_only, out u transfer_id, out o transfer_path); + ImportRawEx(in h fd, + in s local_name, + in s class, + in t flags, + out u transfer_id, + out o transfer_path); ImportFileSystem(in h fd, in s local_name, in b force, in b read_only, out u transfer_id, out o transfer_path); + ImportFileSystemEx(in h fd, + in s local_name, + in s class, + in t flags, + out u transfer_id, + out o transfer_path); ExportTar(in s local_name, in h fd, in s format, out u transfer_id, out o transfer_path); + ExportTarEx(in s local_name, + in s class, + in h fd, + in s format, + in t flags, + out u transfer_id, + out o transfer_path); ExportRaw(in s local_name, in h fd, in s format, out u transfer_id, out o transfer_path); + ExportRawEx(in s local_name, + in s class, + in h fd, + in s format, + in t flags, + out u transfer_id, + out o transfer_path); PullTar(in s url, in s local_name, in s verify_mode, in b force, out u transfer_id, out o transfer_path); + PullTarEx(in s url, + in s local_name, + in s class, + in s verify_mode, + in t flags, + out u transfer_id, + out o transfer_path); PullRaw(in s url, in s local_name, in s verify_mode, in b force, out u transfer_id, out o transfer_path); + PullRawEx(in s url, + in s local_name, + in s class, + in s verify_mode, + in t flags, + out u transfer_id, + out o transfer_path); ListTransfers(out a(usssdo) transfers); + ListTransfersEx(in s class, + in t flags, + out a(ussssdo) transfers); CancelTransfer(in u transfer_id); + ListImages(in s class, + in t flags, + out a(ssssbtttttt) images); signals: TransferNew(u transfer_id, o transfer_path); @@ -119,68 +171,86 @@ node /org/freedesktop/import1 { + + + + + + + + + .SS "Methods" .PP -\fBImportTar()\fR +\fBImportTar()\fR/\fBImportTarEx()\fR and -\fBImportRaw()\fR -import a system image and place it into -/var/lib/machines/\&. The first argument should be a file descriptor (opened for reading) referring to the tar or raw file to import\&. It should reference a file on disk, a pipe or a socket\&. When -\fBImportTar()\fR +\fBImportRaw()\fR/\fBImportRawEx()\fR +import a disk image and place it into the image directory\&. The first argument should be a file descriptor (opened for reading) referring to the tar or raw file to import\&. It should reference a file on disk, a pipe or a socket\&. When +\fBImportTar()\fR/\fBImportTarEx()\fR is used the file descriptor should refer to a tar file, optionally compressed with \fBgzip\fR(1), \fBbzip2\fR(1), or \fBxz\fR(1)\&. \fBsystemd\-importd\fR will detect the used compression scheme (if any) automatically\&. When -\fBImportRaw()\fR +\fBImportRaw()\fR/\fBImportRawEx()\fR is used the file descriptor should refer to a raw or qcow2 disk image containing an MBR or GPT disk label, also optionally compressed with gzip, bzip2 or xz\&. In either case, if the file is specified as a file descriptor on disk, progress information is generated for the import operation (as in that case we know the total size on disk)\&. If a socket or pipe is specified, progress information is not available\&. The file descriptor argument is followed by a local name for the image\&. This should be a name suitable as a hostname and will be used to name the imported image below /var/lib/machines/\&. A tar import is placed as a directory tree or a \fBbtrfs\fR(8) -subvolume below -/var/lib/machines/ -under the specified name with no suffix appended\&. A raw import is placed as a file in -/var/lib/machines/ -with the +subvolume below the image directory under the specified name with no suffix appended\&. A raw import is placed as a file in the image directory with the \&.raw -suffix appended\&. If the +suffix appended\&. In case of +\fBImportTar()\fR/\fBImportRaw()\fR, if the \fBforce\fR -argument is true, any pre\-existing image with the same name is removed before starting the operation\&. Otherwise, the operation fails if an image with the same name already exists\&. Finally, the +argument is true, any pre\-existing image with the same name is removed before starting the operation\&. Otherwise, the operation fails if an image with the same name already exists\&. The \fBread_only\fR -argument controls whether to create a writable or read\-only image\&. Both methods return immediately after starting the import, with the import transfer ongoing\&. They return a pair of transfer identifier and object path, which may be used to retrieve progress information about the transfer or to cancel it\&. The transfer identifier is a simple numeric identifier, the object path references an +argument controls whether to create a writable or read\-only image\&. In case of +\fBImportTarEx()\fR/\fBImportRawEx()\fR +these boolean flags are provided via a 64bit flags parameter instead, with bit 0 mapping to the +\fBforce\fR +parameter, and bit 1 mapping to +\fBread_only\fR\&. The +\fBclass\fR +parameter specifies the image class, and takes one of +"machine", +"portable", +"sysext", +"confext"\&. All four methods return immediately after starting the import, with the import transfer ongoing\&. They return a pair of transfer identifier and object path, which may be used to retrieve progress information about the transfer or to cancel it\&. The transfer identifier is a simple numeric identifier, the object path references an org\&.freedesktop\&.import1\&.Transfer object, see below\&. Listen for a -\fBTransferRemoved\fR +\fBTransferRemoved()\fR signal for the transfer ID in order to detect when a transfer is complete\&. The returned transfer object is useful to determine the current progress or log output of the ongoing import operation\&. .PP -\fBExportTar()\fR +\fBExportTar()\fR/\fBExportTarEx()\fR and -\fBExportRaw()\fR +\fBExportRaw()\fR/\fBExportRaw()\fR implement the reverse operation, and may be used to export a system image in order to place it in a tar or raw image\&. They take the machine name to export as their first parameter, followed by a file descriptor (opened for writing) where the tar or raw file will be written\&. It may either reference a file on disk or a pipe/socket\&. The third argument specifies in which compression format to write the image\&. It takes one of "uncompressed", "xz", "bzip2" or "gzip", depending on which compression scheme is required\&. The image written to the specified file descriptor will be a tar file in case of -\fBExportTar()\fR +\fBExportTar()\fR/\fBExportTarEx()\fR or a raw disk image in case of -\fBExportRaw()\fR\&. Note that currently raw disk images may not be exported as tar files, and vice versa\&. This restriction might be lifted eventually\&. The method returns a transfer identifier and object path for cancelling or tracking the export operation, similarly to -\fBImportTar()\fR +\fBExportRaw()\fR/\fBExportRawEx()\fR\&. Note that currently raw disk images may not be exported as tar files, and vice versa\&. This restriction might be lifted eventually\&. The method returns a transfer identifier and object path for cancelling or tracking the export operation, similarly to +\fBImportTar()\fR/\fBImportTarEx()\fR or -\fBImportRaw()\fR +\fBImportRaw()\fR/\fBImportRawEx()\fR as described above\&. +\fBExportTarEx()\fR/\fBExportRawEx()\fR +expect the image class as additional parameter, as well as a 64bit flags parameter that currently must be specified as zero\&. .PP -\fBPullTar()\fR +\fBPullTar()\fR/\fBPullTarEx()\fR and -\fBPullRaw()\fR +\fBPullRaw()\fR/\fBPullRawEx()\fR may be used to download, verify and import a system image from a URL\&. They take a URL argument which should point to a tar or raw file on the "http://" or "https://" protocols, possibly compressed with xz, bzip2 or gzip\&. The second argument is a local name for the image\&. It should be suitable as a hostname, similarly to the matching argument of the -\fBImportTar()\fR +\fBImportTar()\fR/\fBImportTarEx()\fR and -\fBImportRaw()\fR +\fBImportRaw()\fR/\fBImportRawEx()\fR methods above\&. The third argument indicates the verification mode for the image\&. It may be one of "no", "checksum", @@ -196,30 +266,55 @@ does the same but also tries to authenticate the SHA256SUM file via \fBgpg\fR(8) -first\&. The last argument indicates whether to replace a possibly pre\-existing image with the same local name (if +first\&. In case of +\fBPullTar()\fR/\fBPullRaw()\fR +the last argument indicates whether to replace a possibly pre\-existing image with the same local name (if "true"), or whether to fail (if -"false")\&. Like the import and export calls above, these calls return a pair of transfer identifier and object path for the ongoing download\&. +"false")\&. In case of +\fBPullTarEx()\fR/\fBPullRawEx()\fR +the last argument is a 64bit flags parameter, where bit 0 controls the +"force" +flag, bit 1 is a +"read_only" +flag that controls whether the created image shall be marked read\-only, and bit 2 is a +"keep_download" +flag that indicates whether a pristine, read\-only copy of the downloaded image shell be kept, in addition for the local copy of the image\&. The +\fB\&..._Ex()\fR +variants also expect an image class string (as above)\&. Like the import and export calls above, these calls return a pair of transfer identifier and object path for the ongoing download\&. +.PP +\fBImportFileSystem()\fR/\fBImportFileSystemEx()\fR +are similar to +\fBImportTar()\fR/\fBImportTarEx()\fR +but import a directory tree\&. The first argument must refer to a directory file descriptor for the source hierarchy to import\&. .PP -\fBListTransfers()\fR -returns a list of ongoing import, export or download operations as created with the six calls described above\&. It returns an array of structures which consist of the numeric transfer identifier, a string indicating the operation (one of +\fBListTransfers()\fR/\fBListTransfersEx()\fR +return a list of ongoing import, export or download operations as created with the six calls described above\&. They return an array of structures which consist of the numeric transfer identifier, a string indicating the operation (one of "import\-tar", "import\-raw", "export\-tar", "export\-raw", "pull\-tar" or -"pull\-raw"), a string describing the remote file (in case of download operations this is the source URL, in case of import/export operations this is a short string describing the file descriptor passed in), a string with the local machine image name, a progress value between 0\&.0 (for 0%) and 1\&.0 (for 100%), as well as the transfer object path\&. +"pull\-raw"), a string describing the remote file (in case of download operations this is the source URL, in case of import/export operations this is a short string describing the file descriptor passed in), a string with the local machine image name, the image class (only in case of +\fBListTransfersEx()\fR; one of +"machine", +"portable", +"sysext", +"confext"), a progress value between 0\&.0 (for 0%) and 1\&.0 (for 100%), as well as the transfer object path\&. .PP \fBCancelTransfer()\fR may be used to cancel an ongoing import, export or download operation\&. Simply specify the transfer identifier to cancel the ongoing operation\&. +.PP +\fBListImages()\fR +returns a list of currently installed images\&. It takes a image class string and a flags parameter\&. The image class is either the empty string or specifies one of the four image classes, by which it will then filter\&. The flags parameter must be zero at this time\&. It returns an array of items, each describing one image\&. The item fields are in order: the image class, the local image name, the image type, the image path, the read\-only flag, the creation and modification times (in microseconds since the UNIX epoch), as well as the current disk usage in bytes (both overall, and exclusive), as well as any size limit in bytes set on the image (both overall and exclusive)\&. .SS "Signals" .PP The -\fBTransferNew\fR +\fBTransferNew()\fR signal is generated each time a new transfer is started with the import, export or download calls described above\&. It carries the transfer ID and object path that have just been created\&. .PP The -\fBTransferRemoved\fR +\fBTransferRemoved()\fR signal is sent each time a transfer finishes, is canceled or fails\&. It also carries the transfer ID and object path, followed by a string indicating the result of the operation, which is one of "done" (on success), @@ -239,6 +334,7 @@ node /org/freedesktop/import1/transfer/_1 { signals: LogMessage(u priority, s line); + ProgressUpdate(d progress); properties: @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly u Id = \&.\&.\&.; @@ -271,6 +367,7 @@ node /org/freedesktop/import1/transfer/_1 { + .SS "Methods" .PP The @@ -304,6 +401,15 @@ property exposes the selected verification setting and is only defined for downl The \fIProgress\fR property exposes the current progress of the transfer as a value between 0\&.0 and 1\&.0\&. To show a progress bar on screen we recommend to query this value in regular intervals, for example every 500\ \&ms or so\&. +.SS "Signals" +.PP +The +\fBLogMessage()\fR +signal is emitted for log messages generated by a transfer\&. It carries a pair of syslog log level integer and log string\&. +.PP +The +\fBProgressUpdate()\fR +signal is emitted in regular intervals when new download progress information is available for a transfer\&. It carries a double precision floating pointer number between 0\&.0 and 1\&.0 indicating the transfer progress\&. .SH "EXAMPLES" .PP \fBExample\ \&1.\ \&Introspect org\&.freedesktop\&.import1\&.Manager on the bus\fR @@ -339,6 +445,23 @@ $ gdbus introspect \-\-system \e .PP These D\-Bus interfaces follow \m[blue]\fBthe usual interface versioning guidelines\fR\m[]\&\s-2\u[1]\d\s+2\&. +.SH "HISTORY" +.SS "The Manager Object" +.PP +\fBImportTarEx()\fR, +\fBImportRawEx()\fR, +\fBImportFileSystemEx()\fR, +\fBExportTarEx()\fR, +\fBExportRawEx()\fR, +\fBPullTarEx()\fR, +\fBPullRawEx()\fR, +\fBListTransfersEx()\fR, +\fBListImages()\fR +were added in version 256\&. +.SS "Transfer Objects" +.PP +\fBProgressUpdate()\fR +was added in version 256\&. .SH "NOTES" .IP " 1." 4 the usual interface versioning guidelines diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.locale1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.locale1.5 index 4644366b..790618ee 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.locale1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.locale1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.LOCALE1" "5" "" "systemd 255" "org.freedesktop.locale1" +.TH "ORG\&.FREEDESKTOP\&.LOCALE1" "5" "" "systemd 256~rc3" "org.freedesktop.locale1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.login1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.login1.5 index 135cb69b..fc4cda5b 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.login1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.login1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.LOGIN1" "5" "" "systemd 255" "org.freedesktop.login1" +.TH "ORG\&.FREEDESKTOP\&.LOGIN1" "5" "" "systemd 256~rc3" "org.freedesktop.login1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -50,6 +50,7 @@ node /org/freedesktop/login1 { GetSeat(in s seat_id, out o object_path); ListSessions(out a(susso) sessions); + ListSessionsEx(out a(sussussbto) sessions); ListUsers(out a(uso) users); ListSeats(out a(so) seats); ListInhibitors(out a(ssssuu) inhibitors); @@ -100,7 +101,6 @@ node /org/freedesktop/login1 { out s seat_id, out u vtnr, out b existing); - @org\&.freedesktop\&.systemd1\&.Privileged("true") ReleaseSession(in s session_id); ActivateSession(in s session_id); ActivateSessionOnSeat(in s session_id, @@ -138,6 +138,7 @@ node /org/freedesktop/login1 { HybridSleepWithFlags(in t flags); SuspendThenHibernate(in b interactive); SuspendThenHibernateWithFlags(in t flags); + Sleep(in t flags); CanPowerOff(out s result); CanReboot(out s result); CanHalt(out s result); @@ -145,6 +146,7 @@ node /org/freedesktop/login1 { CanHibernate(out s result); CanHybridSleep(out s result); CanSuspendThenHibernate(out s result); + CanSleep(out s result); ScheduleShutdown(in s type, in t usec); CancelScheduledShutdown(out b cancelled); @@ -215,6 +217,8 @@ node /org/freedesktop/login1 { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly t UserStopDelayUSec = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") + readonly as SleepOperation = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.]; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly s HandlePowerKey = \*(Aq\&.\&.\&.\*(Aq; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly s HandlePowerKeyLongPress = \*(Aq\&.\&.\&.\*(Aq; @@ -394,6 +398,10 @@ node /org/freedesktop/login1 { + + + + .SS "Methods" .PP \fBGetSession()\fR @@ -408,7 +416,30 @@ and get the session/user object the specified PID belongs to if there is any\&. .PP \fBListSessions()\fR -returns an array of all current sessions\&. The structures in the array consist of the following fields: session id, user id, user name, seat id, session object path\&. If a session does not have a seat attached, the seat id field will be an empty string\&. +returns an array of all current sessions\&. The structures in the array consist of the following fields: +\fIsession id\fR, +\fIuser id\fR, +\fIuser name\fR, +\fIseat id\fR, and +\fIsession object path\fR\&. If a session does not have a seat attached, the seat id field will be an empty string\&. +.PP +\fBListSessionsEx()\fR +returns an array of all current sessions with more metadata than +\fBListSessions()\fR\&. The structures in the array consist of the following fields: +\fIsession id\fR, +\fIuser id\fR, +\fIuser name\fR, +\fIseat id\fR, +\fIleader pid\fR, +\fIsession class\fR, +\fItty name\fR, +\fIidle hint\fR, +\fIidle hint monotonic timestamp\fR, and +\fIsession object path\fR\&. +\fItty\fR +and +\fIseat id\fR +fields could be empty, if the session has no associated tty or session has no seat attached, respectively\&. .PP \fBListUsers()\fR returns an array of all currently logged in users\&. The structures in the array consist of the following fields: user id, user name, user object path\&. @@ -501,16 +532,21 @@ results in the system entering a hybrid\-sleep mode, i\&.e\&. the system is both \fBSuspendThenHibernate()\fR results in the system being suspended, then later woken using an RTC timer and hibernated\&. The only argument is the polkit interactivity boolean \fIinteractive\fR -(see below)\&. The main purpose of these calls is that they enforce polkit policy and hence allow powering off/rebooting/suspending/hibernating even by unprivileged users\&. They also enforce inhibition locks for non\-privileged users\&. UIs should expose these calls as the primary mechanism to poweroff/reboot/suspend/hibernate the machine\&. Methods +(see below)\&. The main purpose of these calls is that they enforce polkit policy and hence allow powering off/rebooting/suspending/hibernating even by unprivileged users\&. They also enforce inhibition locks for non\-privileged users\&. +\fBSleep()\fR +automatically selects the most suitable sleep operation supported by the machine\&. The candidate sleep operations to check for support can be configured through +\fISleepOperation=\fR +setting in +\fBlogind.conf\fR(5)\&. UIs should expose these calls as the primary mechanism to poweroff/reboot/suspend/hibernate the machine\&. Methods \fBPowerOffWithFlags()\fR, \fBRebootWithFlags()\fR, \fBHaltWithFlags()\fR, \fBSuspendWithFlags()\fR, \fBHibernateWithFlags()\fR, -\fBHybridSleepWithFlags()\fR -and -\fBSuspendThenHibernateWithFlags()\fR -add +\fBHybridSleepWithFlags()\fR, +\fBSuspendThenHibernateWithFlags()\fR, and +\fBSleep()\fR +take \fIflags\fR to allow for extendability, defined as follows: .sp @@ -572,6 +608,7 @@ for the corresponding command line interface\&. \fBCanHibernate()\fR, \fBCanHybridSleep()\fR, \fBCanSuspendThenHibernate()\fR, +\fBCanSleep()\fR, \fBCanRebootParameter()\fR, \fBCanRebootToFirmwareSetup()\fR, \fBCanRebootToBootLoaderMenu()\fR, and @@ -653,18 +690,18 @@ Whenever the inhibition state or idle hint changes, signals are sent out to which clients can subscribe\&. .PP The -\fBSessionNew\fR, -\fBSessionRemoved\fR, -\fBUserNew\fR, -\fBUserRemoved\fR, -\fBSeatNew\fR, and -\fBSeatRemoved\fR +\fBSessionNew()\fR, +\fBSessionRemoved()\fR, +\fBUserNew()\fR, +\fBUserRemoved()\fR, +\fBSeatNew()\fR, and +\fBSeatRemoved()\fR signals are sent each time a session is created or removed, a user logs in or out, or a seat is added or removed\&. They each contain the ID of the object plus the object path\&. .PP The -\fBPrepareForShutdown\fR, -\fBPrepareForShutdownWithMetadata\fR, and -\fBPrepareForSleep\fR +\fBPrepareForShutdown()\fR, +\fBPrepareForShutdownWithMetadata()\fR, and +\fBPrepareForSleep()\fR signals are sent right before (with the argument "true") or after (with the argument "false") the system goes down for reboot/poweroff and suspend/hibernate, respectively\&. This may be used by applications to save data on disk, release memory, or do other jobs that should be done shortly before shutdown/sleep, in conjunction with delay inhibitor locks\&. After completion of this work they should release their inhibition locks in order to not delay the operation any further\&. For more information see @@ -679,7 +716,7 @@ string which defines the type of shutdown\&. The type can be one of "kexec" or "soft\-reboot"\&. This signal is sent first, followed by -\fBPrepareForShutdown\fR +\fBPrepareForShutdown()\fR (for backward compatibility)\&. .SS "Properties" .PP @@ -746,9 +783,9 @@ The and \fIPreparingForSleep\fR boolean properties are true during the interval between the two -\fBPrepareForShutdown\fR +\fBPrepareForShutdown()\fR and -\fBPrepareForSleep\fR +\fBPrepareForSleep()\fR signals respectively\&. Note that these properties do not send out \fBPropertyChanged\fR signals\&. @@ -768,9 +805,9 @@ method described above\&. \fIRebootToBootLoaderMenu\fR, and \fIRebootToBootLoaderEntry\fR are true when the resprective post\-reboot operation was selected with -\fBSetRebootToFirmwareSetup\fR, -\fBSetRebootToBootLoaderMenu\fR, or -\fBSetRebootToBootLoaderEntry\fR\&. +\fBSetRebootToFirmwareSetup()\fR, +\fBSetRebootToBootLoaderMenu()\fR, or +\fBSetRebootToBootLoaderEntry()\fR\&. .PP The \fIWallMessage\fR @@ -826,23 +863,25 @@ and \fBSuspendThenHibernate()\fR use the same privileges as \fBHibernate()\fR\&. +\fBSleep()\fR +uses the inhibits of the auto\-selected sleep operation\&. \fBSetRebootParameter()\fR requires org\&.freedesktop\&.login1\&.set\-reboot\-parameter\&. .PP -\fBSetRebootToFirmwareSetup\fR +\fBSetRebootToFirmwareSetup()\fR requires org\&.freedesktop\&.login1\&.set\-reboot\-to\-firmware\-setup\&. -\fBSetRebootToBootLoaderMenu\fR +\fBSetRebootToBootLoaderMenu()\fR requires org\&.freedesktop\&.login1\&.set\-reboot\-to\-boot\-loader\-menu\&. -\fBSetRebootToBootLoaderEntry\fR +\fBSetRebootToBootLoaderEntry()\fR requires org\&.freedesktop\&.login1\&.set\-reboot\-to\-boot\-loader\-entry\&. .PP -\fBScheduleShutdown\fR +\fBScheduleShutdown()\fR and -\fBCancelScheduledShutdown\fR +\fBCancelScheduledShutdown()\fR require the same privileges (listed above) as the immediate poweroff/reboot/halt operations\&. .PP \fBInhibit()\fR @@ -1125,6 +1164,7 @@ node /org/freedesktop/login1/session/1 { TakeControl(in b force); ReleaseControl(); SetType(in s type); + SetClass(in s class); SetDisplay(in s display); SetTTY(in h tty_fd); TakeDevice(in u major, @@ -1181,7 +1221,6 @@ node /org/freedesktop/login1/session/1 { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly u Audit = \&.\&.\&.; readonly s Type = \*(Aq\&.\&.\&.\*(Aq; - @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly s Class = \*(Aq\&.\&.\&.\*(Aq; readonly b Active = \&.\&.\&.; readonly s State = \*(Aq\&.\&.\&.\*(Aq; @@ -1245,6 +1284,7 @@ node /org/freedesktop/login1/session/1 { + .SS "Methods" .PP \fBTerminate()\fR, @@ -1279,6 +1319,14 @@ or closing the D\-Bus connection\&. This should help prevent a session from ente \fItype\fR is the new session type\&. .PP +\fBSetClass()\fR +allows the caller to change the class of the session dynamically\&. It may only be called by session\*(Aqs owening user\&. Currently, this call may be exclusively used to change the class from +"user\-incomplete" +to +"user"\&. The call is synchronous, and will return only once the user\*(Aqs service manager has successfully been started, if necessary\&. The only argument +\fItype\fR +is the new session type\&. +.PP \fBSetDisplay()\fR allows the display name of the graphical session to be changed\&. This is useful if the display server is started as part of the session\&. It can only be called by session\*(Aqs current controller\&. If \fBTakeControl()\fR @@ -1339,23 +1387,23 @@ parameter specifies the brightness\&. The range is defined by individual drivers .SS "Signals" .PP The active session controller exclusively gets -\fBPauseDevice\fR +\fBPauseDevice()\fR and -\fBResumeDevice\fR +\fBResumeDevice()\fR events for any device it requested via \fBTakeDevice()\fR\&. They notify the controller whenever a device is paused or resumed\&. A device is never resumed if its session is inactive\&. Also note that -\fBPauseDevice\fR +\fBPauseDevice()\fR signals are sent before the \fBPropertyChanged\fR signal for the \fBActive\fR state\&. The inverse is true for -\fBResumeDevice\fR\&. A device may remain paused for unknown reasons even though the +\fBResumeDevice()\fR\&. A device may remain paused for unknown reasons even though the Session is active\&. .PP A -\fBPauseDevice\fR +\fBPauseDevice()\fR signal carries the major and minor numbers and a string describing the type as arguments\&. \fBforce\fR means the device was already paused by @@ -1368,7 +1416,7 @@ grants you a limited amount of time to pause the device\&. You must respond to t \fBPauseDeviceComplete()\fR\&. This synchronous pausing mechanism is used for backwards\-compatibility to VTs and systemd\-logind is free to not make use of it\&. It is also free to send a forced -\fBPauseDevice\fR +\fBPauseDevice()\fR if you don\*(Aqt respond in a timely manner (or for any other reason)\&. \fBgone\fR means the device was unplugged from the system and you will no longer get any notifications about it\&. There is no need to call @@ -1376,7 +1424,7 @@ means the device was unplugged from the system and you will no longer get any no \fBTakeDevice()\fR again if a new device is assigned the major+minor combination\&. .PP -\fBResumeDevice\fR +\fBResumeDevice()\fR is sent whenever a session is active and a device is resumed\&. It carries the major/minor numbers as arguments and provides a new open file descriptor\&. You should switch to the new descriptor and close the old one\&. They are not guaranteed to have the same underlying open file descriptor in the kernel (except for a limited set of device types)\&. .PP Whenever @@ -1385,7 +1433,7 @@ or the idle state changes, \fBPropertyChanged\fR signals are sent out to which clients can subscribe\&. .PP -\fBLock\fR/\fBUnlock\fR +\fBLock()\fR/\fBUnlock()\fR is sent when the session is asked to be screen\-locked/unlocked\&. A session manager of the session should listen to this signal and act accordingly\&. This signal is sent out as a result of the \fBLock()\fR and @@ -1615,10 +1663,16 @@ were added in version 251\&. \fIStopIdleSessionUSec\fR was added in version 252\&. .PP -\fBPrepareForShutdownWithMetadata\fR +\fBPrepareForShutdownWithMetadata()\fR and \fBCreateSessionWithPIDFD()\fR were added in version 255\&. +.PP +\fBSleep()\fR, +\fBCanSleep()\fR, +\fISleepOperation\fR, and +\fBListSessionsEx()\fR +were added in version 256\&. .SS "Session Objects" .PP \fBSetDisplay()\fR @@ -1626,6 +1680,9 @@ was added in version 252\&. .PP \fBSetTTY()\fR was added in version 254\&. +.PP +\fBSetClass()\fR +was added in version 256\&. .SH "NOTES" .IP " 1." 4 polkit diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.machine1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.machine1.5 index a63a4960..3b35991c 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.machine1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.machine1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.MACHINE1" "5" "" "systemd 255" "org.freedesktop.machine1" +.TH "ORG\&.FREEDESKTOP\&.MACHINE1" "5" "" "systemd 256~rc3" "org.freedesktop.machine1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -87,6 +87,9 @@ node /org/freedesktop/machine1 { in i signal); GetMachineAddresses(in s name, out a(iay) addresses); + GetMachineSSHInfo(in s name, + out s ssh_address, + out s ssh_private_key_path); GetMachineOSRelease(in s name, out a{ss} fields); @org\&.freedesktop\&.systemd1\&.Privileged("true") @@ -228,6 +231,7 @@ node /org/freedesktop/machine1 { + .SS "Methods" .PP \fBGetMachine()\fR @@ -300,6 +304,9 @@ retrieves the IP addresses of a container\&. This method returns an array of pai or \fBAF_INET6\fR) and a byte array containing the addresses\&. This is only supported for containers that make use of network namespacing\&. .PP +\fBGetMachineSSHInfo()\fR +retrieves the SSH information of a machine\&. This method returns two strings, the SSH address which can be used to tell SSH where to connect, and the path to the SSH private key required for the connection to succeed\&. +.PP \fBGetMachineOSRelease()\fR retrieves the OS release information of a container\&. This method returns an array of key value pairs read from the \fBos-release\fR(5) @@ -324,7 +331,7 @@ copies files or directories from a container into the host\&. It takes a contain does the opposite and copies files from a source directory on the host into a destination directory in the container\&. \fBCopyFromMachineWithFlags()\fR and -\fBCopyToMachineWithFlags\fR +\fBCopyToMachineWithFlags()\fR do the same but take an additional flags argument\&. .PP \fBRemoveImage()\fR @@ -352,9 +359,9 @@ sets a per\-image quota limit\&. may be used to map UIDs/GIDs from the host user namespace to a container user namespace or vice versa\&. .SS "Signals" .PP -\fBMachineNew\fR +\fBMachineNew()\fR and -\fBMachineRemoved\fR +\fBMachineRemoved()\fR are sent whenever a new machine is registered or removed\&. These signals carry the machine name and the object path to the corresponding org\&.freedesktop\&.machine1\&.Machine interface (see below)\&. @@ -381,6 +388,8 @@ node /org/freedesktop/machine1/machine/rawhide { Kill(in s who, in i signal); GetAddresses(out a(iay) addresses); + GetSSHInfo(out s ssh_address, + out s ssh_private_key_path); GetOSRelease(out a{ss} fields); GetUIDShift(out u shift); OpenPTY(out h pty, @@ -429,6 +438,12 @@ node /org/freedesktop/machine1/machine/rawhide { readonly s RootDirectory = \*(Aq\&.\&.\&.\*(Aq; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly ai NetworkInterfaces = [\&.\&.\&.]; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") + readonly u VSockCID = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") + readonly s SSHAddress = \*(Aq\&.\&.\&.\*(Aq; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") + readonly s SSHPrivateKeyPath = \*(Aq\&.\&.\&.\*(Aq; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly s State = \*(Aq\&.\&.\&.\*(Aq; }; @@ -467,6 +482,10 @@ node /org/freedesktop/machine1/machine/rawhide { + + + + .SS "Methods" .PP \fBTerminate()\fR @@ -478,11 +497,13 @@ and \fBKillMachine()\fR on the Manager interface, respectively\&. .PP -\fBGetAddresses()\fR +\fBGetAddresses()\fR, +\fBGetSSHInfo()\fR and \fBGetOSRelease()\fR -get the IP address and OS release information from the machine\&. These methods take the same arguments as -\fBGetMachineAddresses()\fR +get the IP address, SSH connection and OS release information from the machine\&. These methods take the same arguments as +\fBGetMachineAddresses()\fR, +\fBGetMachineSSHInfo()\fR and \fBGetMachineOSRelease()\fR of the Manager interface, respectively\&. @@ -521,6 +542,19 @@ contains an array of network interface indices that point towards the container, \fBCreateMachineWithNetwork()\fR above\&. .PP +\fIVSockCID\fR +is the VSOCK CID of the VM if it is known, or +\fBVMADDR_CID_ANY\fR +otherwise\&. +.PP +\fISSHAddress\fR +is the address of the VM in a format +\fBssh\fR +can understand if it is known or the empty string\&. +.PP +\fISSHPrivateKeyPath\fR +is the path to the SSH private key of the VM if it is known or the empty string\&. +.PP \fIState\fR is the state of the machine and is one of "opening", @@ -568,12 +602,22 @@ These D\-Bus interfaces follow and \fBCopyToMachineWithFlags()\fR were added in version 252\&. +.PP +\fBGetMachineSSHInfo()\fR +was added in version 256\&. .SS "Machine Objects" .PP \fBCopyFromWithFlags()\fR and \fBCopyToWithFlags()\fR were added in version 252\&. +.PP +\fBGetSSHInfo()\fR, +\fIVSockCID\fR, +\fISSHAddress\fR +and +\fISSHPrivateKeyPath\fR +were added in version 256\&. .SH "NOTES" .IP " 1." 4 New Control Group Interfaces diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.network1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.network1.5 index 46092e21..4c227ef8 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.network1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.network1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.NETWORK1" "5" "" "systemd 255" "org.freedesktop.network1" +.TH "ORG\&.FREEDESKTOP\&.NETWORK1" "5" "" "systemd 256~rc3" "org.freedesktop.network1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -81,6 +81,8 @@ node /org/freedesktop/network1 { readonly s OnlineState = \*(Aq\&.\&.\&.\*(Aq; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly t NamespaceId = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly u NamespaceNSID = \&.\&.\&.; }; interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. }; @@ -121,8 +123,16 @@ node /org/freedesktop/network1 { + .PP Provides information about the manager\&. +.SS "Properties" +.PP +\fINamespaceId\fR +contains the inode number of the network namespace that the network service runs in\&. A client may compare this with the inode number of its own network namespace to verify whether the service manages the same network namespace\&. +.PP +\fINamespaceNSID\fR +contains the "nsid" identifier the kernel maintains for the network namespace, if there\*(Aqs one assigned\&. .SH "LINK OBJECT" .sp .if n \{\ @@ -368,6 +378,10 @@ was added in version 255\&. .PP \fIState\fR was added in version 255\&. +.SS "Manager Object" +.PP +\fINamespaceNSID\fR +was added in version 256\&. .SH "NOTES" .IP " 1." 4 the usual interface versioning guidelines diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.oom1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.oom1.5 index 85840abb..a1131c84 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.oom1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.oom1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.OOM1" "5" "" "systemd 255" "org.freedesktop.oom1" +.TH "ORG\&.FREEDESKTOP\&.OOM1" "5" "" "systemd 256~rc3" "org.freedesktop.oom1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -55,7 +55,7 @@ node /org/freedesktop/oom1 { .SS "Methods" .PP -\fBKilled\fR +\fBKilled()\fR signal is sent when any cgroup is killed by oomd\&. .PP Note that more reasons will be added in the future, and the table below will be expanded accordingly\&. @@ -95,7 +95,7 @@ These D\-Bus interfaces follow .SH "HISTORY" .SS "The Manager Object" .PP -\fBKilled\fR +\fBKilled()\fR was added in version 252\&. .SH "NOTES" .IP " 1." 4 diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.portable1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.portable1.5 index 5fa495f0..12d7a7cb 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.portable1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.portable1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.PORTABLE1" "5" "" "systemd 255" "org.freedesktop.portable1" +.TH "ORG\&.FREEDESKTOP\&.PORTABLE1" "5" "" "systemd 256~rc3" "org.freedesktop.portable1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -265,7 +265,7 @@ property for a list of available profiles), a boolean indicating whether to atta .sp -1 .IP \(bu 2.3 .\} -(null) +(empty) .RE .sp .RS 4 @@ -290,7 +290,24 @@ copy symlink .RE .sp -This method returns the list of changes applied to the system (for example, which unit was added and is now available as a system service)\&. Each change is represented as a triplet of strings: the type of change applied, the path on which it was applied, and the source (if any)\&. The type of change applied will be one of the following possible values: +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +mixed +.RE +.sp +If an empty string is passed the security profile drop\-ins and images will be symlinked while unit files will be copied, +\fIcopy\fR +will copy, +\fIsymlink\fR +will prefer linking if possible (e\&.g\&.: a unit has to be copied out of an image), and +\fImixed\fR +will prefer linking the resources owned by the OS (e\&.g\&.: the portable profile located within the host\*(Aqs /usr/ tree) but will copy the resources owned by the portable image (e\&.g\&.: the unit files and the images)\&. This method returns the list of changes applied to the system (for example, which unit was added and is now available as a system service)\&. Each change is represented as a triplet of strings: the type of change applied, the path on which it was applied, and the source (if any)\&. The type of change applied will be one of the following possible values: .sp .RS 4 .ie n \{\ @@ -336,7 +353,19 @@ write mkdir .RE .sp -Note that an image cannot be attached if a unit that it contains is already present on the system\&. +Note that an image cannot be attached if a unit that it contains is already present on the system\&. Note that this method returns only after all the listed operations are completed, and due to the I/O involved it might take some time\&. +.PP +In place of the image path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. +.PP +In place of the directory path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. .PP \fBAttachImageWithExtensions()\fR attaches a portable image to the system\&. This method is a superset of @@ -364,15 +393,13 @@ detaches a portable image from the system\&. This method takes an image path or unlink .RE .sp -Note that an image cannot be detached if a unit that it contains is running\&. +Note that an image cannot be detached if a unit that it contains is running\&. Note that this method returns only after all the listed operations are completed, and due to the I/O involved it might take some time\&. .PP \fBDetachImageWithExtensions()\fR detaches a portable image from the system\&. This method is a superset of \fBDetachImage()\fR with the addition of a list of extensions as input parameter, which were overlaid on top of the main image via -\fBAttachImageWithExtensions()\fR\&. The -\fIflag\fR -parameter is currently unused and reserved for future purposes\&. +\fBAttachImageWithExtensions()\fR\&. .PP \fBReattachImage()\fR combines the effects of the @@ -395,9 +422,7 @@ with the addition of a list of extensions as input parameter, which will be over entry on \fBsystemd.exec\fR(5) and -\fBsystemd-sysext\fR(8)\&. The -\fIflag\fR -parameter is currently unused and reserved for future purposes +\fBsystemd-sysext\fR(8)\&. .PP \fBRemoveImage()\fR removes the image with the specified name\&. @@ -418,11 +443,11 @@ and \fBReattachImageWithExtensions()\fR methods take in options as flags instead of booleans to allow for extendability\&. \fISD_SYSTEMD_PORTABLE_FORCE_ATTACH\fR -will cause safety checks that ensure the units are not running while the new image is attached or detached to be skipped\&. +will bypass the safety checks that ensure the units are not running while the image is attached or detached\&. \fISD_SYSTEMD_PORTABLE_FORCE_EXTENSION\fR -will cause the check that the +will bypass the check that ensures the extension\-release\&.\fINAME\fR -file in the extension image matches the image name to be skipped\&. They are defined as follows: +file in the extension image matches the image name\&. They are defined as follows: .sp .if n \{\ .RS 4 diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.resolve1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.resolve1.5 index 4f3b397f..69b4a36e 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.resolve1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.resolve1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.RESOLVE1" "5" "" "systemd 255" "org.freedesktop.resolve1" +.TH "ORG\&.FREEDESKTOP\&.RESOLVE1" "5" "" "systemd 256~rc3" "org.freedesktop.resolve1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -94,7 +94,7 @@ node /org/freedesktop/resolve1 { SetLinkDNSSECNegativeTrustAnchors(in i ifindex, in as names); RevertLink(in i ifindex); - RegisterService(in s name, + RegisterService(in s id, in s name_template, in s type, in q service_port, @@ -420,6 +420,32 @@ set) so that all settings take effect during the full time the network interface The \fBRevertLink()\fR method may be used to revert all per\-link settings described above to the defaults\&. +.PP +The +\fBFlushCaches()\fR +flushes all resource record caches maintained by the resolver, and ensures that any subsequent lookups re\-request their responses from their sources\&. +.PP +The +\fBResetServerFeatures()\fR +flushes any feature information learned about remote DNS servers\&. This ensures that subsequent lookups will be initially attempted at the highest DNS protocol feature level again, possibly requiring a (potentially slow) downgrade cycle to recognize the supported feature level again\&. +.PP +The +\fBRegisterService()\fR +method may be used to register a DNS\-SD service on the host\&. This functionality is closely related to the functionality provided by +\fBsystemd.dnssd\fR(5) +files\&. It takes a server identifier string as first parameter (this is just a local identifier, and should be chosen so that it neither collides with the basename of +*\&.dnssd +files nor with names chosen by other IPC clients)\&. It also takes a name template string for the DNS\-SD service name visible on the network\&. This string is subject to specifier expansation, as documented for the +\fIName=\fR +setting in +*\&.dnssd +files\&. It also takes a service type string containing the DNS\-SD service type, as well as an IP port, a priority/weight pair for the DNS\-SD SRV record\&. Finally, it takes an array of TXT record data\&. It returns an object path which may be used as handle to the registered service\&. +.PP +The +\fBUnregisterService()\fR +method undoes the effect of +\fBRegisterService()\fR +and deletes a DNS\-SD service previously created via IPC again\&. .sp .it 1 an-trap .nr an-no-space-flag 1 @@ -436,35 +462,36 @@ The four methods above accept and return a 64\-bit flags value\&. In most cases .\} .nf /* Input+Output: Protocol/scope */ -#define SD_RESOLVED_DNS (UINT64_C(1) << 0) -#define SD_RESOLVED_LLMNR_IPV4 (UINT64_C(1) << 1) -#define SD_RESOLVED_LLMNR_IPV6 (UINT64_C(1) << 2) -#define SD_RESOLVED_MDNS_IPV4 (UINT64_C(1) << 3) -#define SD_RESOLVED_MDNS_IPV6 (UINT64_C(1) << 4) +#define SD_RESOLVED_DNS (UINT64_C(1) << 0) +#define SD_RESOLVED_LLMNR_IPV4 (UINT64_C(1) << 1) +#define SD_RESOLVED_LLMNR_IPV6 (UINT64_C(1) << 2) +#define SD_RESOLVED_MDNS_IPV4 (UINT64_C(1) << 3) +#define SD_RESOLVED_MDNS_IPV6 (UINT64_C(1) << 4) /* Input: Restrictions */ -#define SD_RESOLVED_NO_CNAME (UINT64_C(1) << 5) -#define SD_RESOLVED_NO_TXT (UINT64_C(1) << 6) -#define SD_RESOLVED_NO_ADDRESS (UINT64_C(1) << 7) -#define SD_RESOLVED_NO_SEARCH (UINT64_C(1) << 8) -#define SD_RESOLVED_NO_VALIDATE (UINT64_C(1) << 10) -#define SD_RESOLVED_NO_SYNTHESIZE (UINT64_C(1) << 11) -#define SD_RESOLVED_NO_CACHE (UINT64_C(1) << 12) -#define SD_RESOLVED_NO_ZONE (UINT64_C(1) << 13) -#define SD_RESOLVED_NO_TRUST_ANCHOR (UINT64_C(1) << 14) -#define SD_RESOLVED_NO_NETWORK (UINT64_C(1) << 15) -#define SD_RESOLVED_NO_STALE (UINT64_C(1) << 24) +#define SD_RESOLVED_NO_CNAME (UINT64_C(1) << 5) +#define SD_RESOLVED_NO_TXT (UINT64_C(1) << 6) +#define SD_RESOLVED_NO_ADDRESS (UINT64_C(1) << 7) +#define SD_RESOLVED_NO_SEARCH (UINT64_C(1) << 8) +#define SD_RESOLVED_NO_VALIDATE (UINT64_C(1) << 10) +#define SD_RESOLVED_NO_SYNTHESIZE (UINT64_C(1) << 11) +#define SD_RESOLVED_NO_CACHE (UINT64_C(1) << 12) +#define SD_RESOLVED_NO_ZONE (UINT64_C(1) << 13) +#define SD_RESOLVED_NO_TRUST_ANCHOR (UINT64_C(1) << 14) +#define SD_RESOLVED_NO_NETWORK (UINT64_C(1) << 15) +#define SD_RESOLVED_NO_STALE (UINT64_C(1) << 24) +#define SD_RESOLVED_RELAX_SINGLE_LABEL (UINT64_C(1) << 25) /* Output: Security */ -#define SD_RESOLVED_AUTHENTICATED (UINT64_C(1) << 9) -#define SD_RESOLVED_CONFIDENTIAL (UINT64_C(1) << 18) +#define SD_RESOLVED_AUTHENTICATED (UINT64_C(1) << 9) +#define SD_RESOLVED_CONFIDENTIAL (UINT64_C(1) << 18) /* Output: Origin */ -#define SD_RESOLVED_SYNTHETIC (UINT64_C(1) << 19) -#define SD_RESOLVED_FROM_CACHE (UINT64_C(1) << 20) -#define SD_RESOLVED_FROM_ZONE (UINT64_C(1) << 21) -#define SD_RESOLVED_FROM_TRUST_ANCHOR (UINT64_C(1) << 22) -#define SD_RESOLVED_FROM_NETWORK (UINT64_C(1) << 23) +#define SD_RESOLVED_SYNTHETIC (UINT64_C(1) << 19) +#define SD_RESOLVED_FROM_CACHE (UINT64_C(1) << 20) +#define SD_RESOLVED_FROM_ZONE (UINT64_C(1) << 21) +#define SD_RESOLVED_FROM_TRUST_ANCHOR (UINT64_C(1) << 22) +#define SD_RESOLVED_FROM_NETWORK (UINT64_C(1) << 23) .fi .if n \{\ .RE @@ -646,6 +673,10 @@ property reports whether the stub listener on port 53 is enabled\&. Possible val (only the UDP listener is enabled), and "tcp" (only the TCP listener is enabled)\&. +.PP +The +\fIDNSSECNegativeTrustAnchors\fR +property contains a list of recognized DNSSEC negative trust anchors and contains a list of domains\&. .SH "LINK OBJECT" .sp .if n \{\ diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.systemd1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.systemd1.5 index 7f3378a8..ddfee8e9 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.systemd1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.systemd1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.SYSTEMD1" "5" "" "systemd 255" "org.freedesktop.systemd1" +.TH "ORG\&.FREEDESKTOP\&.SYSTEMD1" "5" "" "systemd 256~rc3" "org.freedesktop.systemd1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -274,6 +274,11 @@ node /org/freedesktop/systemd1 { GetDynamicUsers(out a(us) users); DumpUnitFileDescriptorStore(in s name, out a(suuutuusu) entries); + StartAuxiliaryScope(in s name, + in ah pidfds, + in t flags, + in a(sv) properties, + out o job); signals: UnitNew(s id, o unit); @@ -332,6 +337,10 @@ node /org/freedesktop/systemd1 { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly t FinishTimestampMonotonic = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") + readonly t ShutdownStartTimestamp = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") + readonly t ShutdownStartTimestampMonotonic = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly t SecurityStartTimestamp = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly t SecurityStartTimestampMonotonic = \&.\&.\&.; @@ -548,6 +557,8 @@ node /org/freedesktop/systemd1 { readonly i DefaultOOMScoreAdjust = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly s CtrlAltDelBurstAction = \*(Aq\&.\&.\&.\*(Aq; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") + readonly u SoftRebootsCount = \&.\&.\&.; }; interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. }; @@ -776,6 +787,10 @@ node /org/freedesktop/systemd1 { + + + + .SS "Methods" .PP Note that many of the methods exist twice: once on the @@ -807,7 +822,13 @@ enqueues a start job and possibly depending jobs\&. It takes the unit to activat "fail", the method will start the unit and its dependencies, but will fail if this would change an already queued job\&. If "isolate", the method will start the unit in question and terminate all units that aren\*(Aqt dependencies of it\&. If "ignore\-dependencies", it will start a unit but ignore all its dependencies\&. If -"ignore\-requirements", it will start a unit but only ignore the requirement dependencies\&. It is not recommended to make use of the latter two options\&. On completion, this method returns the newly created job object\&. +"ignore\-requirements", it will start a unit but only ignore the requirement dependencies\&. It is not recommended to make use of the latter two options\&. On reply, if successful, this method returns the newly created job object which has been enqueued for asynchronous activation\&. Callers that want to track the outcome of the actual start operation need to monitor the result of this job\&. This can be achieved in a race\-free manner by first subscribing to the +\fBJobRemoved()\fR +signal, then calling +\fBStartUnit()\fR +and using the returned job object to filter out unrelated +\fBJobRemoved()\fR +signals, until the desired one is received, which will then carry the result of the start operation\&. .PP \fBStartUnitReplace()\fR is similar to @@ -1287,6 +1308,21 @@ returns an array with information about the file descriptors currently in the fi \fBDumpFileDescriptorStore()\fR on the org\&.freedesktop\&.systemd1\&.Service\&. For further details, see below\&. +.PP +\fBStartAuxiliaryScope()\fR +creates a new scope unit from a service where calling process resides\&. Set of processes that will be migrated to newly created scope is passed in as an array of pidfds\&. This is useful for creating auxiliary scopes that should contain worker processes and their lifecycle shouldn\*(Aqt be bound to a lifecycle of the service, e\&.g\&. they should continue running after the restart of the service\&. Note that the main PID of the service can not be migrated to an auxiliary scope\&. Also, +\fIflags\fR +argument must be 0 and is reserved for future extensions\&. +.PP +\fBCleanUnit()\fR +deletes the configuration, state, logs, cache and runtime data directories and clear out the file descriptors store for the unit, as specified in the mask parameters\&. The possible values are +"configuration", +"state", +"logs", +"cache", +"runtime", +"fdstore", and +"all"\&. .SS "Signals" .PP Note that most signals are sent out only after @@ -1371,16 +1407,29 @@ are not symlinks to their counterparts under Added in version 252\&. .RE .PP -"cgroups\-missing" +"unmerged\-bin" .RS 4 -Support for cgroups is unavailable\&. +/usr/sbin +is not a symlink to +/usr/bin/\&. +.sp +Added in version 256\&. +.RE +.PP +"var\-run\-bad" +.RS 4 +/run/ +does not exist or +/var/run +is not a symlink to +/run/\&. .sp Added in version 252\&. .RE .PP "cgroupsv1" .RS 4 -The system is using the old cgroup hierarchy\&. +The system is using the deprecated cgroup v1 hierarchy\&. .sp Added in version 252\&. .RE @@ -1409,17 +1458,6 @@ The system is running a kernel version that is older than the minimum supported Added in version 252\&. .RE .PP -"var\-run\-bad" -.RS 4 -/run/ -does not exist or -/var/run -is not a symlink to -/run/\&. -.sp -Added in version 252\&. -.RE -.PP "overflowuid\-not\-65534", "overflowgid\-not\-65534" .RS 4 The kernel overflow UID or GID have a value other than 65534\&. @@ -1444,13 +1482,16 @@ Added in version 252\&. \fIInitRDTimestampMonotonic\fR, \fIUserspaceTimestamp\fR, \fIUserspaceTimestampMonotonic\fR, -\fIFinishTimestamp\fR, and -\fIFinishTimestampMonotonic\fR +\fIFinishTimestamp\fR, +\fIFinishTimestampMonotonic\fR, +\fIShutdownStartTimestamp\fR +and +\fIShutdownStartTimestampMonotonic\fR encode \fBCLOCK_REALTIME\fR and \fBCLOCK_MONOTONIC\fR -microsecond timestamps taken when the firmware first began execution, when the boot loader first began execution, when the kernel first began execution, when the initrd first began execution, when the main systemd instance began execution and finally, when all queued startup jobs finished execution\&. These values are useful for determining boot\-time performance\&. Note that as monotonic time begins with the kernel startup, the +microsecond timestamps taken when the firmware first began execution, when the boot loader first began execution, when the kernel first began execution, when the initrd first began execution, when the main systemd instance began execution, when all queued startup jobs finished execution and finally, when a shutdown operation first began execution\&. These values are useful for determining boot\-time performance\&. Note that as monotonic time begins with the kernel startup, the \fIKernelTimestampMonotonic\fR timestamp will always be 0 and \fIFirmwareTimestampMonotonic\fR @@ -1497,6 +1538,10 @@ encodes the environment block passed to all executed services\&. It may be alter \fIUnitPath\fR encodes the currently active unit file search path\&. It is an array of file system paths encoded as strings\&. .PP +\fISoftRebootsCount\fR +encodes how many soft\-reboots were successfully completed since the last full boot\&. Starts at +"0"\&. +.PP \fIVirtualization\fR contains a short ID string describing the virtualization technology the system runs in\&. On bare\-metal hardware this is the empty string\&. Otherwise, it contains an identifier such as "kvm", @@ -1579,8 +1624,8 @@ org\&.freedesktop\&.systemd1\&.manage\-units\&. Operations which modify unit fil \fBDisableUnitFilesWithFlags()\fR, \fBReenableUnitFiles()\fR, \fBLinkUnitFiles()\fR, -\fBPresetUnitFiles\fR, -\fBMaskUnitFiles\fR, and similar) require +\fBPresetUnitFiles()\fR, +\fBMaskUnitFiles()\fR, and similar) require org\&.freedesktop\&.systemd1\&.manage\-unit\-files\&. Operations which modify the exported environment (\fBSetEnvironment()\fR, \fBUnsetEnvironment()\fR, \fBUnsetAndSetEnvironment()\fR) require @@ -1702,6 +1747,8 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly as RequiresMountsFor = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.]; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") + readonly as WantsMountsFor = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.]; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly as Documentation = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.]; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly s Description = \*(Aq\&.\&.\&.\*(Aq; @@ -1940,6 +1987,7 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice { + .SS "Methods" .PP \fBStart()\fR, @@ -2316,6 +2364,8 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice { readonly t ExecMainStartTimestampMonotonic = \&.\&.\&.; readonly t ExecMainExitTimestamp = \&.\&.\&.; readonly t ExecMainExitTimestampMonotonic = \&.\&.\&.; + readonly t ExecMainHandoffTimestamp = \&.\&.\&.; + readonly t ExecMainHandoffTimestampMonotonic = \&.\&.\&.; readonly u ExecMainPID = \&.\&.\&.; readonly i ExecMainCode = \&.\&.\&.; readonly i ExecMainStatus = \&.\&.\&.; @@ -2366,6 +2416,10 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t MemoryAvailable = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveMemoryMax = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveMemoryHigh = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t CPUUsageNSec = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly ay EffectiveCPUs = [\&.\&.\&.]; @@ -2374,6 +2428,8 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t TasksCurrent = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveTasksMax = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t IPIngressBytes = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t IPIngressPackets = \&.\&.\&.; @@ -2478,6 +2534,8 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t StartupMemoryZSwapMax = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly b MemoryZSwapWriteback = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t MemoryLimit = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly s DevicePolicy = \*(Aq\&.\&.\&.\*(Aq; @@ -3236,6 +3294,12 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice { + + + + + + .SS "Methods" .PP \fBBindMount()\fR @@ -3303,13 +3367,28 @@ also correspond to the configured settings of the unit files, but instead of bei \fIExecMainStartTimestampMonotonic\fR, \fIExecMainExitTimestamp\fR, \fIExecMainExitTimestampMonotonic\fR, +\fIExecMainHandoffTimestamp\fR, +\fIExecMainHandoffTimestampMonotonic\fR, \fIExecMainPID\fR, \fIExecMainCode\fR, \fIExecMainStatus\fR -contain information about the main process of the service as far as it is known\&. This is often the same runtime information that is stored in -\fIExecStart\fR\&. However, it deviates for +contain information about the main process of the service as far as it is known\&. The +\fIExecMainStartTimestamp\fR +timestamps record when the main process of the service is created\&. +\fIExecMainExitTimestamp\fR +timestamps record when the main process exit has been detected by the service manager\&. +\fIExecMainHandoffTimestamp\fR +timestamps records when the service binary is about to be executed by +\fBsystemd\-executor\fR +(this timestamp is recorded regardless if the immediately following +\fBexecve()\fR +system call succeeds or fails)\&. This is often the same runtime information that is also maintained for +\fIExecStart=\fR\&. However, it deviates for services with \fIType=forking\fR -services where the main process of the service is not forked off systemd directly\&. These fields either contain information of the last run of the process or of the current running process\&. +as well as services that use +\fIMAINPID=\fR +\fBsd_notify()\fR +messages as the main process of the service is not forked off by the service manager directly in that case\&. These fields either contain information of the last run of the process or of the current running process\&. .PP \fIMainPID\fR and @@ -3457,6 +3536,8 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2esocket { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly b PassCredentials = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") + readonly b PassFileDescriptorsToExec = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly b PassSecurity = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly b PassPacketInfo = \&.\&.\&.; @@ -3537,6 +3618,10 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2esocket { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t MemoryAvailable = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveMemoryMax = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveMemoryHigh = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t CPUUsageNSec = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly ay EffectiveCPUs = [\&.\&.\&.]; @@ -3545,6 +3630,8 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2esocket { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t TasksCurrent = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveTasksMax = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t IPIngressBytes = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t IPIngressPackets = \&.\&.\&.; @@ -3649,6 +3736,8 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2esocket { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t StartupMemoryZSwapMax = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly b MemoryZSwapWriteback = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t MemoryLimit = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly s DevicePolicy = \*(Aq\&.\&.\&.\*(Aq; @@ -4399,6 +4488,11 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2esocket { + + + + + .PP \fIPollLimitIntervalUSec\fR/\fIPollLimitBurst\fR properties configure the polling limit for the socket unit\&. Expects a time in \(mcs, resp\&. an unsigned integer\&. If either is set to zero the limiting feature is turned off\&. @@ -4568,6 +4662,10 @@ node /org/freedesktop/systemd1/unit/home_2emount { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t MemoryAvailable = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveMemoryMax = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveMemoryHigh = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t CPUUsageNSec = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly ay EffectiveCPUs = [\&.\&.\&.]; @@ -4576,6 +4674,8 @@ node /org/freedesktop/systemd1/unit/home_2emount { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t TasksCurrent = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveTasksMax = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t IPIngressBytes = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t IPIngressPackets = \&.\&.\&.; @@ -4680,6 +4780,8 @@ node /org/freedesktop/systemd1/unit/home_2emount { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t StartupMemoryZSwapMax = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly b MemoryZSwapWriteback = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t MemoryLimit = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly s DevicePolicy = \*(Aq\&.\&.\&.\*(Aq; @@ -5386,6 +5488,10 @@ node /org/freedesktop/systemd1/unit/home_2emount { + + + + .SS "Properties" .PP Most of the properties map directly to the corresponding settings in mount unit files\&. As mount units invoke the @@ -5626,6 +5732,10 @@ node /org/freedesktop/systemd1/unit/dev_2dsda3_2eswap { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t MemoryAvailable = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveMemoryMax = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveMemoryHigh = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t CPUUsageNSec = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly ay EffectiveCPUs = [\&.\&.\&.]; @@ -5634,6 +5744,8 @@ node /org/freedesktop/systemd1/unit/dev_2dsda3_2eswap { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t TasksCurrent = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveTasksMax = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t IPIngressBytes = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t IPIngressPackets = \&.\&.\&.; @@ -5738,6 +5850,8 @@ node /org/freedesktop/systemd1/unit/dev_2dsda3_2eswap { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t StartupMemoryZSwapMax = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly b MemoryZSwapWriteback = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t MemoryLimit = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly s DevicePolicy = \*(Aq\&.\&.\&.\*(Aq; @@ -6437,6 +6551,10 @@ node /org/freedesktop/systemd1/unit/dev_2dsda3_2eswap { + + + + .SS "Properties" .PP Most of the properties map directly to the corresponding settings in swap unit files\&. As mount units invoke the @@ -6563,6 +6681,10 @@ node /org/freedesktop/systemd1/unit/system_2eslice { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t MemoryAvailable = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveMemoryMax = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveMemoryHigh = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t CPUUsageNSec = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly ay EffectiveCPUs = [\&.\&.\&.]; @@ -6571,6 +6693,8 @@ node /org/freedesktop/systemd1/unit/system_2eslice { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t TasksCurrent = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveTasksMax = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t IPIngressBytes = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t IPIngressPackets = \&.\&.\&.; @@ -6675,6 +6799,8 @@ node /org/freedesktop/systemd1/unit/system_2eslice { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t StartupMemoryZSwapMax = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly b MemoryZSwapWriteback = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t MemoryLimit = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly s DevicePolicy = \*(Aq\&.\&.\&.\*(Aq; @@ -6824,6 +6950,10 @@ node /org/freedesktop/systemd1/unit/system_2eslice { + + + + .SS "Properties" .PP Most properties correspond directly with the matching settings in slice unit files\&. @@ -6878,6 +7008,10 @@ node /org/freedesktop/systemd1/unit/session_2d1_2escope { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t MemoryAvailable = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveMemoryMax = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveMemoryHigh = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t CPUUsageNSec = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly ay EffectiveCPUs = [\&.\&.\&.]; @@ -6886,6 +7020,8 @@ node /org/freedesktop/systemd1/unit/session_2d1_2escope { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t TasksCurrent = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly t EffectiveTasksMax = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t IPIngressBytes = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t IPIngressPackets = \&.\&.\&.; @@ -6990,6 +7126,8 @@ node /org/freedesktop/systemd1/unit/session_2d1_2escope { @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t StartupMemoryZSwapMax = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") + readonly b MemoryZSwapWriteback = \&.\&.\&.; + @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly t MemoryLimit = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly s DevicePolicy = \*(Aq\&.\&.\&.\*(Aq; @@ -7168,13 +7306,17 @@ node /org/freedesktop/systemd1/unit/session_2d1_2escope { + + + + .SS "Methods" .PP \fBAbandon()\fR may be used to place a scope unit in the "abandoned" state\&. This may be used to inform the system manager that the manager that created the scope lost interest in the scope (for example, because it is terminating), without wanting to shut down the scope entirely\&. .SS "Signals" .PP -\fBRequestStop\fR +\fBRequestStop()\fR is sent to the peer that is configured in the \fIController\fR property when systemd is requested to terminate the scope unit\&. A program registering a scope can use this to cleanly shut down the processes it added to the scope instead of letting systemd do it with the usual @@ -7186,7 +7328,7 @@ All properties correspond directly with the matching properties of service units .PP \fIController\fR contains the bus name (unique or well\-known) that is notified when the scope unit is to be shut down via a -\fBRequestStop\fR +\fBRequestStop()\fR signal (see below)\&. This is set when the scope is created\&. If not set, the scope\*(Aqs processes will terminated with \fBSIGTERM\fR directly\&. @@ -7348,6 +7490,13 @@ were added in version 253\&. \fBSoftReboot()\fR, and \fBDumpUnitFileDescriptorStore()\fR were added in version 254\&. +.PP +\fBStartAuxiliaryScope()\fR, +\fIShutdownStartTimestamp\fR, +\fIShutdownStartTimestampMonotonic\fR +and +\fISoftRebootsCount\fR +were added in version 256\&. .SS "Unit Objects" .PP \fIUpholds\fR @@ -7365,6 +7514,9 @@ was added in version 254\&. .PP \fISurviveFinalKillSignal\fR was added in version 255\&. +.PP +\fIWantsMountsFor\fR +was added in version 256\&. .SS "Service Unit Objects" .PP \fIControlGroupId\fR @@ -7409,6 +7561,14 @@ were added in version 254\&. \fIMemorySwapPeak\fR, and \fIMemoryZSwapCurrent\fR were added in version 255\&. +.PP +\fIEffectiveMemoryHigh\fR, +\fIEffectiveMemoryMax\fR, +\fIEffectiveTasksMax\fR, +\fIMemoryZSwapWriteback\fR, +\fIExecMainHandoffTimestampMonotonic\fR, and +\fIExecMainHandoffTimestamp\fR +were added in version 256\&. .SS "Socket Unit Objects" .PP \fIControlGroupId\fR @@ -7448,6 +7608,13 @@ were added in version 254\&. \fIMemorySwapPeak\fR, and \fIMemoryZSwapCurrent\fR were added in version 255\&. +.PP +\fIEffectiveMemoryHigh\fR, +\fIEffectiveMemoryMax\fR, +\fIEffectiveTasksMax\fR, +\fIMemoryZSwapWriteback\fR, and +\fIPassFileDescriptorsToExec\fR +were added in version 256\&. .SS "Mount Unit Objects" .PP \fIControlGroupId\fR @@ -7485,6 +7652,12 @@ were added in version 254\&. \fIMemorySwapPeak\fR, and \fIMemoryZSwapCurrent\fR were added in version 255\&. +.PP +\fIEffectiveMemoryHigh\fR, +\fIEffectiveMemoryMax\fR, +\fIEffectiveTasksMax\fR, and +\fIMemoryZSwapWriteback\fR +were added in version 256\&. .SS "Swap Unit Objects" .PP \fIControlGroupId\fR @@ -7522,6 +7695,12 @@ were added in version 254\&. \fIMemorySwapPeak\fR, and \fIMemoryZSwapCurrent\fR were added in version 255\&. +.PP +\fIEffectiveMemoryHigh\fR, +\fIEffectiveMemoryMax\fR, +\fIEffectiveTasksMax\fR, and +\fIMemoryZSwapWriteback\fR +were added in version 256\&. .SS "Slice Unit Objects" .PP \fIControlGroupId\fR @@ -7548,6 +7727,12 @@ were added in version 254\&. \fIMemorySwapPeak\fR, and \fIMemoryZSwapCurrent\fR were added in version 255\&. +.PP +\fIEffectiveMemoryHigh\fR, +\fIEffectiveMemoryMax\fR, +\fIEffectiveTasksMax\fR, and +\fIMemoryZSwapWriteback\fR +were added in version 256\&. .SS "Scope Unit Objects" .PP \fIControlGroupId\fR @@ -7576,6 +7761,12 @@ were added in version 254\&. \fIMemorySwapPeak\fR, and \fIMemoryZSwapCurrent\fR were added in version 255\&. +.PP +\fIEffectiveMemoryHigh\fR, +\fIEffectiveMemoryMax\fR, +\fIEffectiveTasksMax\fR, and +\fIMemoryZSwapWriteback\fR +were added in version 256\&. .SS "Job Objects" .PP \fIActivationDetails\fR diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.timedate1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.timedate1.5 index 63adbcd7..cca2dc94 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.timedate1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.timedate1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.TIMEDATE1" "5" "" "systemd 255" "org.freedesktop.timedate1" +.TH "ORG\&.FREEDESKTOP\&.TIMEDATE1" "5" "" "systemd 256~rc3" "org.freedesktop.timedate1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man5/os-release.5 b/upstream/fedora-rawhide/man5/os-release.5 index 795363d3..fc3297c4 100644 --- a/upstream/fedora-rawhide/man5/os-release.5 +++ b/upstream/fedora-rawhide/man5/os-release.5 @@ -1,5 +1,5 @@ '\" t -.TH "OS\-RELEASE" "5" "" "systemd 255" "os-release" +.TH "OS\-RELEASE" "5" "" "systemd 256~rc3" "os-release" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,13 +23,18 @@ os-release, initrd-release, extension-release \- Operating system identification .SH "SYNOPSIS" .PP +.RS 4 /etc/os\-release -.PP +.RE +.RS 4 /usr/lib/os\-release -.PP +.RE +.RS 4 /etc/initrd\-release -.PP +.RE +.RS 4 /usr/lib/extension\-release\&.d/extension\-release\&.\fIIMAGE\fR +.RE .SH "DESCRIPTION" .PP The @@ -53,7 +58,7 @@ is the recommended place to store OS release information as part of vendor trees /etc/os\-release should be a relative symlink to /usr/lib/os\-release, to provide compatibility with applications only looking at -/etc/\&. A relative symlink instead of an absolute symlink is necessary to avoid breaking the link in a chroot or initrd environment such as dracut\&. +/etc/\&. A relative symlink instead of an absolute symlink is necessary to avoid breaking the link in a chroot or initrd environment\&. .PP os\-release contains data that is defined by the operating system vendor and should generally not be changed by the administrator\&. @@ -674,11 +679,7 @@ if \*(Aqdebian\*(Aq in [os_release\&.get(\*(AqID\*(Aq, \*(Aqlinux\*(Aq), Note that the above version that uses the built\-in implementation is preferred in most cases, and the open\-coded version here is provided for reference\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBlsb_release\fR(1), -\fBhostname\fR(5), -\fBmachine-id\fR(5), -\fBmachine-info\fR(5) +\fBsystemd\fR(1), \fBlsb_release\fR(1), \fBhostname\fR(5), \fBmachine-id\fR(5), \fBmachine-info\fR(5) .SH "NOTES" .IP " 1." 4 Announcement of /etc/os-release diff --git a/upstream/fedora-rawhide/man5/pacman.conf.5 b/upstream/fedora-rawhide/man5/pacman.conf.5 index 9e994376..0471f092 100644 --- a/upstream/fedora-rawhide/man5/pacman.conf.5 +++ b/upstream/fedora-rawhide/man5/pacman.conf.5 @@ -2,12 +2,12 @@ .\" Title: pacman.conf .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "PACMAN\&.CONF" "5" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "PACMAN\&.CONF" "5" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -165,7 +165,7 @@ will use the system architecture, provided via \(lquname \-m\(rq\&. If unset, no can always be installed, as they are meant to be architecture independent\&. .RE .PP -\fBXferCommand =\fR /path/to/command %u +\fBXferCommand =\fR /path/to/command %u [%o] .RS 4 If set, an external program will be used to download all remote files\&. All instances of %u @@ -291,6 +291,11 @@ Include another config file\&. This file can include repositories or general con rules\&. .RE .PP +\fBCacheServer =\fR url +.RS 4 +A full URL to a location where the packages, and signatures (if available) for this repository can be found\&. Cache servers will be tried before any non\-cache servers, will not be removed from the server pool for 404 download errors, and will not be used for database files\&. +.RE +.PP \fBServer =\fR url .RS 4 A full URL to a location where the database, packages, and signatures (if available) for this repository can be found\&. @@ -499,17 +504,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 @@ -592,4 +586,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/man5/passwd.5 b/upstream/fedora-rawhide/man5/passwd.5 index e4bcb8e0..15703831 100644 --- a/upstream/fedora-rawhide/man5/passwd.5 +++ b/upstream/fedora-rawhide/man5/passwd.5 @@ -8,7 +8,7 @@ .\" Modified Sun Jun 18 01:53:57 1995 by Andries Brouwer (aeb@cwi.nl) .\" Modified Mon Jan 5 20:24:40 MET 1998 by Michael Haardt .\" (michael@cantor.informatik.rwth-aachen.de) -.TH passwd 5 2023-10-31 "Linux man-pages 6.06" +.TH passwd 5 2023-10-31 "Linux man-pages 6.7" .SH NAME passwd \- password file .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc.5 b/upstream/fedora-rawhide/man5/proc.5 index 788cb97e..ce072ee9 100644 --- a/upstream/fedora-rawhide/man5/proc.5 +++ b/upstream/fedora-rawhide/man5/proc.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc 5 2023-10-31 "Linux man-pages 6.06" +.TH proc 5 2023-10-31 "Linux man-pages 6.7" .SH NAME proc \- process information, system information, and sysctl pseudo-filesystem .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_apm.5 b/upstream/fedora-rawhide/man5/proc_apm.5 index 03462ace..2987d2bd 100644 --- a/upstream/fedora-rawhide/man5/proc_apm.5 +++ b/upstream/fedora-rawhide/man5/proc_apm.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_apm 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_apm 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/apm \- advanced power management .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_buddyinfo.5 b/upstream/fedora-rawhide/man5/proc_buddyinfo.5 index 7b3db6c6..b98185c5 100644 --- a/upstream/fedora-rawhide/man5/proc_buddyinfo.5 +++ b/upstream/fedora-rawhide/man5/proc_buddyinfo.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_buddyinfo 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_buddyinfo 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/buddyinfo \- memory fragmentation .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_bus.5 b/upstream/fedora-rawhide/man5/proc_bus.5 index aeb8ec62..505b8ea4 100644 --- a/upstream/fedora-rawhide/man5/proc_bus.5 +++ b/upstream/fedora-rawhide/man5/proc_bus.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_bus 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_bus 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/bus/ \- installed buses .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_cgroups.5 b/upstream/fedora-rawhide/man5/proc_cgroups.5 index 61a675e0..b858a64c 100644 --- a/upstream/fedora-rawhide/man5/proc_cgroups.5 +++ b/upstream/fedora-rawhide/man5/proc_cgroups.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_cgroups 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_cgroups 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/cgroups \- control groups .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_cmdline.5 b/upstream/fedora-rawhide/man5/proc_cmdline.5 index f030d61b..55873f95 100644 --- a/upstream/fedora-rawhide/man5/proc_cmdline.5 +++ b/upstream/fedora-rawhide/man5/proc_cmdline.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_cmdline 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_cmdline 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/cmdline \- kernel boot arguments .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_config.gz.5 b/upstream/fedora-rawhide/man5/proc_config.gz.5 index eedafc80..1d894bd4 100644 --- a/upstream/fedora-rawhide/man5/proc_config.gz.5 +++ b/upstream/fedora-rawhide/man5/proc_config.gz.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_config.gz 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_config.gz 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/config.gz \- kernel build configuration .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_cpuinfo.5 b/upstream/fedora-rawhide/man5/proc_cpuinfo.5 index 648f5057..7d620ce8 100644 --- a/upstream/fedora-rawhide/man5/proc_cpuinfo.5 +++ b/upstream/fedora-rawhide/man5/proc_cpuinfo.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_cpuinfo 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_cpuinfo 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/cpuinfo \- CPU and system architecture information .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_crypto.5 b/upstream/fedora-rawhide/man5/proc_crypto.5 index a3e0096d..eeee62ef 100644 --- a/upstream/fedora-rawhide/man5/proc_crypto.5 +++ b/upstream/fedora-rawhide/man5/proc_crypto.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_crypto 5 2023-11-24 "Linux man-pages 6.06" +.TH proc_crypto 5 2023-11-24 "Linux man-pages 6.7" .SH NAME /proc/crypto \- ciphers provided by kernel crypto API .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_devices.5 b/upstream/fedora-rawhide/man5/proc_devices.5 index b17fb81a..27280ca3 100644 --- a/upstream/fedora-rawhide/man5/proc_devices.5 +++ b/upstream/fedora-rawhide/man5/proc_devices.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_devices 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_devices 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/devices \- major numbers and device groups .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_diskstats.5 b/upstream/fedora-rawhide/man5/proc_diskstats.5 index 59c028f9..76f83470 100644 --- a/upstream/fedora-rawhide/man5/proc_diskstats.5 +++ b/upstream/fedora-rawhide/man5/proc_diskstats.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_diskstats 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_diskstats 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/diskstats \- disk I/O statistics .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_dma.5 b/upstream/fedora-rawhide/man5/proc_dma.5 index ddc4dd94..6882949b 100644 --- a/upstream/fedora-rawhide/man5/proc_dma.5 +++ b/upstream/fedora-rawhide/man5/proc_dma.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_dma 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_dma 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/dma \- ISA DMA channels .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_driver.5 b/upstream/fedora-rawhide/man5/proc_driver.5 index ec17a4c4..ec86255c 100644 --- a/upstream/fedora-rawhide/man5/proc_driver.5 +++ b/upstream/fedora-rawhide/man5/proc_driver.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_driver 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_driver 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/driver/ \- empty dir .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_execdomains.5 b/upstream/fedora-rawhide/man5/proc_execdomains.5 index f77465b3..945cbf3f 100644 --- a/upstream/fedora-rawhide/man5/proc_execdomains.5 +++ b/upstream/fedora-rawhide/man5/proc_execdomains.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_execdomains 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_execdomains 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/execdomains \- ABI personalities (obsolete) .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_fb.5 b/upstream/fedora-rawhide/man5/proc_fb.5 index 96336075..31ea1cee 100644 --- a/upstream/fedora-rawhide/man5/proc_fb.5 +++ b/upstream/fedora-rawhide/man5/proc_fb.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_fb 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_fb 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/fb \- frame buffer .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_filesystems.5 b/upstream/fedora-rawhide/man5/proc_filesystems.5 index c7f002a6..2ed6b54f 100644 --- a/upstream/fedora-rawhide/man5/proc_filesystems.5 +++ b/upstream/fedora-rawhide/man5/proc_filesystems.5 @@ -8,7 +8,7 @@ .\" to see what information could be imported from that file .\" into this file. .\" -.TH proc_filesystems 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_filesystems 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/filesystems \- supported filesystems .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_fs.5 b/upstream/fedora-rawhide/man5/proc_fs.5 index 57bcbfc9..31fe94c8 100644 --- a/upstream/fedora-rawhide/man5/proc_fs.5 +++ b/upstream/fedora-rawhide/man5/proc_fs.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_fs 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_fs 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/fs/ \- mounted filesystems .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_ide.5 b/upstream/fedora-rawhide/man5/proc_ide.5 index 41521a63..7e28acc3 100644 --- a/upstream/fedora-rawhide/man5/proc_ide.5 +++ b/upstream/fedora-rawhide/man5/proc_ide.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_ide 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_ide 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/ide/ \- IDE channels and attached devices .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_interrupts.5 b/upstream/fedora-rawhide/man5/proc_interrupts.5 index c9874bca..897399a5 100644 --- a/upstream/fedora-rawhide/man5/proc_interrupts.5 +++ b/upstream/fedora-rawhide/man5/proc_interrupts.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_interrupts 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_interrupts 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/interrupts \- number of interrupts .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_iomem.5 b/upstream/fedora-rawhide/man5/proc_iomem.5 index e9c17dfd..55414501 100644 --- a/upstream/fedora-rawhide/man5/proc_iomem.5 +++ b/upstream/fedora-rawhide/man5/proc_iomem.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_iomem 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_iomem 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/iomem \- I/O memory map .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_ioports.5 b/upstream/fedora-rawhide/man5/proc_ioports.5 index 968cf555..e07c2786 100644 --- a/upstream/fedora-rawhide/man5/proc_ioports.5 +++ b/upstream/fedora-rawhide/man5/proc_ioports.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_ioports 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_ioports 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/ioports \- I/O port regions .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_kallsyms.5 b/upstream/fedora-rawhide/man5/proc_kallsyms.5 index 91b53638..a4f30a45 100644 --- a/upstream/fedora-rawhide/man5/proc_kallsyms.5 +++ b/upstream/fedora-rawhide/man5/proc_kallsyms.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_kallsyms 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_kallsyms 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/kallsyms \- kernel exported symbols .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_kcore.5 b/upstream/fedora-rawhide/man5/proc_kcore.5 index 269b73c5..9a98a950 100644 --- a/upstream/fedora-rawhide/man5/proc_kcore.5 +++ b/upstream/fedora-rawhide/man5/proc_kcore.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_kcore 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_kcore 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/kcore \- physical memory .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_keys.5 b/upstream/fedora-rawhide/man5/proc_keys.5 index 9c4f2d5b..5cdcbee0 100644 --- a/upstream/fedora-rawhide/man5/proc_keys.5 +++ b/upstream/fedora-rawhide/man5/proc_keys.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_keys 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_keys 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/keys, /proc/key\-users \- in-kernel key management .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_kmsg.5 b/upstream/fedora-rawhide/man5/proc_kmsg.5 index a64e0361..1486552d 100644 --- a/upstream/fedora-rawhide/man5/proc_kmsg.5 +++ b/upstream/fedora-rawhide/man5/proc_kmsg.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_kmsg 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_kmsg 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/kmsg \- kernel messages .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_kpagecgroup.5 b/upstream/fedora-rawhide/man5/proc_kpagecgroup.5 index ee0877e6..41f32372 100644 --- a/upstream/fedora-rawhide/man5/proc_kpagecgroup.5 +++ b/upstream/fedora-rawhide/man5/proc_kpagecgroup.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_kpagecgroup 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_kpagecgroup 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/kpagecgroup \- memory cgroups .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_kpagecount.5 b/upstream/fedora-rawhide/man5/proc_kpagecount.5 index 8bb8230a..16cf080d 100644 --- a/upstream/fedora-rawhide/man5/proc_kpagecount.5 +++ b/upstream/fedora-rawhide/man5/proc_kpagecount.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_kpagecount 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_kpagecount 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/kpagecount \- count of mappings of physical pages .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_kpageflags.5 b/upstream/fedora-rawhide/man5/proc_kpageflags.5 index e0f9b751..5c23d024 100644 --- a/upstream/fedora-rawhide/man5/proc_kpageflags.5 +++ b/upstream/fedora-rawhide/man5/proc_kpageflags.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_kpageflags 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_kpageflags 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/kpageflags \- physical pages frame masks .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_loadavg.5 b/upstream/fedora-rawhide/man5/proc_loadavg.5 index 3403a2b1..fba66031 100644 --- a/upstream/fedora-rawhide/man5/proc_loadavg.5 +++ b/upstream/fedora-rawhide/man5/proc_loadavg.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_loadavg 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_loadavg 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/loadavg \- load average .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_locks.5 b/upstream/fedora-rawhide/man5/proc_locks.5 index 5269cce1..c33ec82a 100644 --- a/upstream/fedora-rawhide/man5/proc_locks.5 +++ b/upstream/fedora-rawhide/man5/proc_locks.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_locks 5 2023-11-19 "Linux man-pages 6.06" +.TH proc_locks 5 2023-11-19 "Linux man-pages 6.7" .SH NAME /proc/locks \- current file locks and leases .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_malloc.5 b/upstream/fedora-rawhide/man5/proc_malloc.5 index 9ed444e2..d6197dce 100644 --- a/upstream/fedora-rawhide/man5/proc_malloc.5 +++ b/upstream/fedora-rawhide/man5/proc_malloc.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_malloc 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_malloc 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/malloc \- debug malloc (obsolete) .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_meminfo.5 b/upstream/fedora-rawhide/man5/proc_meminfo.5 index d2454114..7a2e70eb 100644 --- a/upstream/fedora-rawhide/man5/proc_meminfo.5 +++ b/upstream/fedora-rawhide/man5/proc_meminfo.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_meminfo 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_meminfo 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/meminfo \- memory usage .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_modules.5 b/upstream/fedora-rawhide/man5/proc_modules.5 index 56ad8f9e..d040fde5 100644 --- a/upstream/fedora-rawhide/man5/proc_modules.5 +++ b/upstream/fedora-rawhide/man5/proc_modules.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_modules 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_modules 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/modules \- loaded modules .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_mtrr.5 b/upstream/fedora-rawhide/man5/proc_mtrr.5 index 6860d112..d2d1991b 100644 --- a/upstream/fedora-rawhide/man5/proc_mtrr.5 +++ b/upstream/fedora-rawhide/man5/proc_mtrr.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_mtrr 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_mtrr 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/mtrr \- memory type range registers .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_partitions.5 b/upstream/fedora-rawhide/man5/proc_partitions.5 index ef5874d8..ff58779a 100644 --- a/upstream/fedora-rawhide/man5/proc_partitions.5 +++ b/upstream/fedora-rawhide/man5/proc_partitions.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_partitions 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_partitions 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/partitions \- major and minor numbers of partitions .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pci.5 b/upstream/fedora-rawhide/man5/proc_pci.5 index 0fa2cc88..6977571f 100644 --- a/upstream/fedora-rawhide/man5/proc_pci.5 +++ b/upstream/fedora-rawhide/man5/proc_pci.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pci 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pci 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pci \- PCI devices .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid.5 b/upstream/fedora-rawhide/man5/proc_pid.5 index 172b7805..0d8cdafa 100644 --- a/upstream/fedora-rawhide/man5/proc_pid.5 +++ b/upstream/fedora-rawhide/man5/proc_pid.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/, /proc/self/ \- process information .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_attr.5 b/upstream/fedora-rawhide/man5/proc_pid_attr.5 index 2f8fa2a8..33993a88 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_attr.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_attr.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_attr 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_attr 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/attr/ \- security-related attributes .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_autogroup.5 b/upstream/fedora-rawhide/man5/proc_pid_autogroup.5 index 7765d533..cbf8e4d5 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_autogroup.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_autogroup.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_autogroup 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_autogroup 5 2023-08-15 "Linux man-pages 6.7" .SH NAME proc_pid_autogroup \- group tasks for the scheduler .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_auxv.5 b/upstream/fedora-rawhide/man5/proc_pid_auxv.5 index ce36368a..524414de 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_auxv.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_auxv.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_auxv 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_auxv 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/auxv \- exec(3) information .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_cgroup.5 b/upstream/fedora-rawhide/man5/proc_pid_cgroup.5 index 2605b502..c78fde4f 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_cgroup.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_cgroup.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_cgroup 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_cgroup 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/cgroup \- control group .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_clear_refs.5 b/upstream/fedora-rawhide/man5/proc_pid_clear_refs.5 index d98144aa..134a3b94 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_clear_refs.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_clear_refs.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_clear_refs 5 2023-09-07 "Linux man-pages 6.06" +.TH proc_pid_clear_refs 5 2023-09-07 "Linux man-pages 6.7" .SH NAME /proc/pid/clear_refs \- reset the PG_Referenced and ACCESSED/YOUNG bits .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_cmdline.5 b/upstream/fedora-rawhide/man5/proc_pid_cmdline.5 index 25c43b5e..d9e5967e 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_cmdline.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_cmdline.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_cmdline 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_cmdline 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/cmdline \- command line .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_comm.5 b/upstream/fedora-rawhide/man5/proc_pid_comm.5 index 18566e95..492d4809 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_comm.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_comm.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_comm 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_comm 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/comm \- command name .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_coredump_filter.5 b/upstream/fedora-rawhide/man5/proc_pid_coredump_filter.5 index 638020bc..82f48ed6 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_coredump_filter.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_coredump_filter.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_coredump_filter 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_coredump_filter 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/coredump_filter \- core dump filter .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_cpuset.5 b/upstream/fedora-rawhide/man5/proc_pid_cpuset.5 index 26314704..2bdf32d9 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_cpuset.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_cpuset.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_cpuset 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_cpuset 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/cpuset \- CPU affinity sets .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_cwd.5 b/upstream/fedora-rawhide/man5/proc_pid_cwd.5 index 5ed1b137..df99f113 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_cwd.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_cwd.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_cwd 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_cwd 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/cwd \- symbolic link to current working directory .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_environ.5 b/upstream/fedora-rawhide/man5/proc_pid_environ.5 index 075a2674..104cbe08 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_environ.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_environ.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_environ 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_environ 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/environ \- initial environment .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_exe.5 b/upstream/fedora-rawhide/man5/proc_pid_exe.5 index ca9b7f09..21d2fbc1 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_exe.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_exe.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_exe 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_exe 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/exe \- symbolic link to program pathname .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_fd.5 b/upstream/fedora-rawhide/man5/proc_pid_fd.5 index bb86075d..0489169c 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_fd.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_fd.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_fd 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_fd 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/fd/ \- file descriptors .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_fdinfo.5 b/upstream/fedora-rawhide/man5/proc_pid_fdinfo.5 index 3703012b..1eeb895e 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_fdinfo.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_fdinfo.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_fdinfo 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_fdinfo 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/fdinfo/ \- information about file descriptors .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_io.5 b/upstream/fedora-rawhide/man5/proc_pid_io.5 index f989e493..4ad79f51 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_io.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_io.5 @@ -4,14 +4,16 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_io 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_io 5 2024-03-18 "Linux man-pages 6.7" .SH NAME /proc/pid/io \- I/O statistics .SH DESCRIPTION .TP .IR /proc/ pid /io " (since Linux 2.6.20)" .\" commit 7c3ab7381e79dfc7db14a67c6f4f3285664e1ec2 -This file contains I/O statistics for the process, for example: +This file contains I/O statistics +for the process and its waited-for children, +for example: .IP .in +4n .EX @@ -30,69 +32,69 @@ The fields are as follows: .RS .TP .IR rchar ": characters read" -The number of bytes which this task has caused to be read from storage. -This is simply the sum of bytes which this process passed to +The number of bytes +returned by successful .BR read (2) and similar system calls. -It includes things such as terminal I/O and -is unaffected by whether or not actual -physical disk I/O was required (the read might have been satisfied from -pagecache). .TP .IR wchar ": characters written" -The number of bytes which this task has caused, or shall cause to be written -to disk. -Similar caveats apply here as with -.IR rchar . +The number of bytes +returned by successful +.BR write (2) +and similar system calls. .TP .IR syscr ": read syscalls" -Attempt to count the number of read I/O operations\[em]that is, -system calls such as +The number of "file read" system calls\[em]those from the .BR read (2) +family, +.BR sendfile (2), +.BR copy_file_range (2), and -.BR pread (2). +.BR ioctl (2) +.BR BTRFS_IOC_ENCODED_READ [ _32 ] +(including when invoked by the kernel as part of other syscalls). .TP .IR syscw ": write syscalls" -Attempt to count the number of write I/O operations\[em]that is, -system calls such as +The number of "file write" system calls\[em]those from the .BR write (2) +family, +.BR sendfile (2), +.BR copy_file_range (2), and -.BR pwrite (2). +.BR ioctl (2) +.BR BTRFS_IOC_ENCODED_WRITE [ _32 ] +(including when invoked by the kernel as part of other syscalls). .TP .IR read_bytes ": bytes read" -Attempt to count the number of bytes which this process really did cause to -be fetched from the storage layer. +The number of bytes really fetched from the storage layer. This is accurate for block-backed filesystems. .TP .IR write_bytes ": bytes written" -Attempt to count the number of bytes which this process caused to be sent to -the storage layer. +The number of bytes really sent to the storage layer. .TP .IR cancelled_write_bytes : -The big inaccuracy here is truncate. -If a process writes 1 MB to a file and then deletes the file, -it will in fact perform no writeout. -But it will have been accounted as having caused 1 MB of write. -In other words: this field represents the number of bytes which this process -caused to not happen, by truncating pagecache. -A task can cause "negative" I/O too. -If this task truncates some dirty pagecache, -some I/O which another task has been accounted for -(in its -.IR write_bytes ) -will not be happening. +The above statistics fail to account for truncation: +if a process writes 1 MB to a regular file and then removes it, +said 1 MB will not be written, but +.I will +have nevertheless been accounted as a 1 MB write. +This field represents the number of bytes "saved" from I/O writeback. +This can yield to having done negative I/O +if caches dirtied by another process are truncated. +.I cancelled_write_bytes +applies to I/O already accounted-for in +.IR write_bytes . .RE .IP -.IR Note : -In the current implementation, things are a bit racy on 32-bit systems: -if process A reads process B's -.IR /proc/ pid /io -while process B is updating one of these 64-bit counters, -process A could see an intermediate result. -.IP -Permission to access this file is governed by a ptrace access mode -.B PTRACE_MODE_READ_FSCREDS -check; see -.BR ptrace (2). +Permission to access this file is governed by +.BR ptrace (2) +access mode +.BR PTRACE_MODE_READ_FSCREDS . +.SH CAVEATS +These counters are not atomic: +on systems where 64-bit integer operations may tear, +a counter could be updated simultaneously with a read, +yielding an incorrect intermediate value. .SH SEE ALSO +.BR getrusage (2), .BR proc (5) diff --git a/upstream/fedora-rawhide/man5/proc_pid_limits.5 b/upstream/fedora-rawhide/man5/proc_pid_limits.5 index 70ad07d0..a8ab93c2 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_limits.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_limits.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_oid_limits 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_oid_limits 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/limits \- resource limits .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_map_files.5 b/upstream/fedora-rawhide/man5/proc_pid_map_files.5 index e1ba8024..5b50c450 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_map_files.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_map_files.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_map_files 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_map_files 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/map_files/ \- memory-mapped files .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_maps.5 b/upstream/fedora-rawhide/man5/proc_pid_maps.5 index 22c220f3..25fbbde4 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_maps.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_maps.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_maps 5 2023-09-07 "Linux man-pages 6.06" +.TH proc_pid_maps 5 2023-09-07 "Linux man-pages 6.7" .SH NAME /proc/pid/maps \- mapped memory regions .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_mem.5 b/upstream/fedora-rawhide/man5/proc_pid_mem.5 index 8cea82e2..b54206d4 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_mem.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_mem.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_mem 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_mem 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/mem \- memory .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_mountinfo.5 b/upstream/fedora-rawhide/man5/proc_pid_mountinfo.5 index 2ff0da3d..257c1db8 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_mountinfo.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_mountinfo.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_mountinfo 5 2023-11-24 "Linux man-pages 6.06" +.TH proc_pid_mountinfo 5 2023-11-24 "Linux man-pages 6.7" .SH NAME /proc/pid/mountinfo \- mount information .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_mounts.5 b/upstream/fedora-rawhide/man5/proc_pid_mounts.5 index 3084ce13..bcb32f2e 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_mounts.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_mounts.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_mounts 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_mounts 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/mounts \- mounted filesystems .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_mountstats.5 b/upstream/fedora-rawhide/man5/proc_pid_mountstats.5 index 024d69a8..1205b14c 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_mountstats.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_mountstats.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_mountstats 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_mountstats 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/mountstats \- mount statistics .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_net.5 b/upstream/fedora-rawhide/man5/proc_pid_net.5 index 21ae4a6f..590e87d5 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_net.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_net.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_net 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_net 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/net/, /proc/net/ \- network layer information .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_ns.5 b/upstream/fedora-rawhide/man5/proc_pid_ns.5 index 37517e35..bf83ab5e 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_ns.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_ns.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_ns 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_ns 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/ns/ \- namespaces .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_numa_maps.5 b/upstream/fedora-rawhide/man5/proc_pid_numa_maps.5 index cad08414..4b29fab8 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_numa_maps.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_numa_maps.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_numa_maps 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_numa_maps 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/numa_maps \- NUMA memory policy and allocation .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_oom_score.5 b/upstream/fedora-rawhide/man5/proc_pid_oom_score.5 index 96975fc6..ddaeddf9 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_oom_score.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_oom_score.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_oom_score 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_oom_score 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/oom_score \- OOM-killer score .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_oom_score_adj.5 b/upstream/fedora-rawhide/man5/proc_pid_oom_score_adj.5 index 8eb725e9..a068e33c 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_oom_score_adj.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_oom_score_adj.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_oom_score_adj 5 2023-11-24 "Linux man-pages 6.06" +.TH proc_pid_oom_score_adj 5 2023-11-24 "Linux man-pages 6.7" .SH NAME /proc/pid/oom_score_adj \- OOM-killer score adjustment .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_pagemap.5 b/upstream/fedora-rawhide/man5/proc_pid_pagemap.5 index 85d4ea86..436e2c51 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_pagemap.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_pagemap.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_pagemap 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_pagemap 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/pagemap \- mapping of virtual pages .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_personality.5 b/upstream/fedora-rawhide/man5/proc_pid_personality.5 index 2bef64f9..4dccf0ce 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_personality.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_personality.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_personality 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_personality 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/personality \- execution domain .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_projid_map.5 b/upstream/fedora-rawhide/man5/proc_pid_projid_map.5 index 33090b5b..cf88aa47 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_projid_map.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_projid_map.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_projid_map 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_projid_map 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/projid_map \- project ID mappings .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_root.5 b/upstream/fedora-rawhide/man5/proc_pid_root.5 index b6b31752..5263329c 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_root.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_root.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_root 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_root 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/root/ \- symbolic link to root directory .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_seccomp.5 b/upstream/fedora-rawhide/man5/proc_pid_seccomp.5 index 031dc5ca..22c582c3 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_seccomp.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_seccomp.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_seccomp 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_seccomp 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/seccomp \- secure computing mode .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_setgroups.5 b/upstream/fedora-rawhide/man5/proc_pid_setgroups.5 index 10dda201..d90ad191 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_setgroups.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_setgroups.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_setgroups 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_setgroups 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/setgroups \- allow or deny setting groups .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_smaps.5 b/upstream/fedora-rawhide/man5/proc_pid_smaps.5 index f0e0b8ae..21d7d5c8 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_smaps.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_smaps.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_smaps 5 2023-09-07 "Linux man-pages 6.06" +.TH proc_pid_smaps 5 2023-09-07 "Linux man-pages 6.7" .SH NAME /proc/pid/smaps \- XXX: What does 's' in "smaps" stand for? .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_stack.5 b/upstream/fedora-rawhide/man5/proc_pid_stack.5 index b2e88261..bb1d3c29 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_stack.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_stack.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_stack 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_stack 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/stack \- kernel stack .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_stat.5 b/upstream/fedora-rawhide/man5/proc_pid_stat.5 index 85f42135..b08e441f 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_stat.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_stat.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_stat 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_stat 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/stat \- status information .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_statm.5 b/upstream/fedora-rawhide/man5/proc_pid_statm.5 index 6b02d572..5e3ca2e6 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_statm.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_statm.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_statm 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_statm 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/statm \- memory usage information .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_status.5 b/upstream/fedora-rawhide/man5/proc_pid_status.5 index eddd21b9..fdef4777 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_status.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_status.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_status 5 2023-10-23 "Linux man-pages 6.06" +.TH proc_pid_status 5 2023-10-23 "Linux man-pages 6.7" .SH NAME /proc/pid/status \- memory usage and status information .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_syscall.5 b/upstream/fedora-rawhide/man5/proc_pid_syscall.5 index c5b6188c..c569293a 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_syscall.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_syscall.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_syscall 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_syscall 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/syscall \- currently executed system call .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_task.5 b/upstream/fedora-rawhide/man5/proc_pid_task.5 index 4b04c84f..70af355a 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_task.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_task.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_task 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_task 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/task/, /proc/tid/, /proc/thread\-self/ \- thread information .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_timers.5 b/upstream/fedora-rawhide/man5/proc_pid_timers.5 index ebee7769..981ba799 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_timers.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_timers.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_timers 5 2023-09-07 "Linux man-pages 6.06" +.TH proc_pid_timers 5 2023-09-07 "Linux man-pages 6.7" .SH NAME /proc/pid/timers \- POSIX timers .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_timerslack_ns.5 b/upstream/fedora-rawhide/man5/proc_pid_timerslack_ns.5 index 60a51f57..94be8eb9 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_timerslack_ns.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_timerslack_ns.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_timerslack_ns 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_timerslack_ns 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/timerslack_ns \- timer slack in nanoseconds .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_uid_map.5 b/upstream/fedora-rawhide/man5/proc_pid_uid_map.5 index 14cfdf3e..68fd4ffc 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_uid_map.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_uid_map.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_uid_map 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_uid_map 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/gid_map, /proc/pid/uid_map \- user and group ID mappings .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_pid_wchan.5 b/upstream/fedora-rawhide/man5/proc_pid_wchan.5 index c9e018a6..e7ab9d40 100644 --- a/upstream/fedora-rawhide/man5/proc_pid_wchan.5 +++ b/upstream/fedora-rawhide/man5/proc_pid_wchan.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_pid_wchan 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_pid_wchan 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/pid/wchan \- wait channel .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_profile.5 b/upstream/fedora-rawhide/man5/proc_profile.5 index 0a97484a..bd206b41 100644 --- a/upstream/fedora-rawhide/man5/proc_profile.5 +++ b/upstream/fedora-rawhide/man5/proc_profile.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_profile 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_profile 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/profile \- kernel profiling .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_scsi.5 b/upstream/fedora-rawhide/man5/proc_scsi.5 index 753d0ff0..12f92aa8 100644 --- a/upstream/fedora-rawhide/man5/proc_scsi.5 +++ b/upstream/fedora-rawhide/man5/proc_scsi.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_scsi 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_scsi 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/scsi/ \- SCSI .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_slabinfo.5 b/upstream/fedora-rawhide/man5/proc_slabinfo.5 index d551a431..18949318 100644 --- a/upstream/fedora-rawhide/man5/proc_slabinfo.5 +++ b/upstream/fedora-rawhide/man5/proc_slabinfo.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_slabinfo 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_slabinfo 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/slabinfo \- kernel caches .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_stat.5 b/upstream/fedora-rawhide/man5/proc_stat.5 index 52a14b4f..c7350f0f 100644 --- a/upstream/fedora-rawhide/man5/proc_stat.5 +++ b/upstream/fedora-rawhide/man5/proc_stat.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_stat 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_stat 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/stat \- kernel system statistics .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_swaps.5 b/upstream/fedora-rawhide/man5/proc_swaps.5 index cb411aac..e9569548 100644 --- a/upstream/fedora-rawhide/man5/proc_swaps.5 +++ b/upstream/fedora-rawhide/man5/proc_swaps.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_swaps 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_swaps 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/swaps \- swap areas .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sys.5 b/upstream/fedora-rawhide/man5/proc_sys.5 index 130ec5bf..f467b30e 100644 --- a/upstream/fedora-rawhide/man5/proc_sys.5 +++ b/upstream/fedora-rawhide/man5/proc_sys.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sys 5 2023-09-30 "Linux man-pages 6.06" +.TH proc_sys 5 2023-09-30 "Linux man-pages 6.7" .SH NAME /proc/sys/ \- system information, and sysctl pseudo-filesystem .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sys_abi.5 b/upstream/fedora-rawhide/man5/proc_sys_abi.5 index 161413bf..a9bfd472 100644 --- a/upstream/fedora-rawhide/man5/proc_sys_abi.5 +++ b/upstream/fedora-rawhide/man5/proc_sys_abi.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sys_abi 5 2023-09-30 "Linux man-pages 6.06" +.TH proc_sys_abi 5 2023-09-30 "Linux man-pages 6.7" .SH NAME /proc/sys/abi/ \- application binary information .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sys_debug.5 b/upstream/fedora-rawhide/man5/proc_sys_debug.5 index cf2f458d..798da050 100644 --- a/upstream/fedora-rawhide/man5/proc_sys_debug.5 +++ b/upstream/fedora-rawhide/man5/proc_sys_debug.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sys_debug 5 2023-09-30 "Linux man-pages 6.06" +.TH proc_sys_debug 5 2023-09-30 "Linux man-pages 6.7" .SH NAME /proc/sys/debug/ \- debug .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sys_dev.5 b/upstream/fedora-rawhide/man5/proc_sys_dev.5 index 0f6c11f5..28ca8311 100644 --- a/upstream/fedora-rawhide/man5/proc_sys_dev.5 +++ b/upstream/fedora-rawhide/man5/proc_sys_dev.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sys_dev 5 2023-09-30 "Linux man-pages 6.06" +.TH proc_sys_dev 5 2023-09-30 "Linux man-pages 6.7" .SH NAME /proc/sys/dev/ \- device-specific information .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sys_fs.5 b/upstream/fedora-rawhide/man5/proc_sys_fs.5 index 9196d399..d6f5a4bb 100644 --- a/upstream/fedora-rawhide/man5/proc_sys_fs.5 +++ b/upstream/fedora-rawhide/man5/proc_sys_fs.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sys_fs 5 2023-09-30 "Linux man-pages 6.06" +.TH proc_sys_fs 5 2023-09-30 "Linux man-pages 6.7" .SH NAME /proc/sys/fs/ \- kernel variables related to filesystems .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sys_kernel.5 b/upstream/fedora-rawhide/man5/proc_sys_kernel.5 index 8563a761..334d3be2 100644 --- a/upstream/fedora-rawhide/man5/proc_sys_kernel.5 +++ b/upstream/fedora-rawhide/man5/proc_sys_kernel.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sys_kernel 5 2023-09-30 "Linux man-pages 6.06" +.TH proc_sys_kernel 5 2023-09-30 "Linux man-pages 6.7" .SH NAME /proc/sys/kernel/ \- control a range of kernel parameters .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sys_net.5 b/upstream/fedora-rawhide/man5/proc_sys_net.5 index ba5b8956..02214cc3 100644 --- a/upstream/fedora-rawhide/man5/proc_sys_net.5 +++ b/upstream/fedora-rawhide/man5/proc_sys_net.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sys_net 5 2023-09-30 "Linux man-pages 6.06" +.TH proc_sys_net 5 2023-09-30 "Linux man-pages 6.7" .SH NAME /proc/sys/net/ \- networking .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sys_proc.5 b/upstream/fedora-rawhide/man5/proc_sys_proc.5 index 758ace67..ad9b2329 100644 --- a/upstream/fedora-rawhide/man5/proc_sys_proc.5 +++ b/upstream/fedora-rawhide/man5/proc_sys_proc.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sys_proc 5 2023-09-30 "Linux man-pages 6.06" +.TH proc_sys_proc 5 2023-09-30 "Linux man-pages 6.7" .SH NAME /proc/sys/proc/ \- ??? .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sys_sunrpc.5 b/upstream/fedora-rawhide/man5/proc_sys_sunrpc.5 index b6b207be..06e90d7e 100644 --- a/upstream/fedora-rawhide/man5/proc_sys_sunrpc.5 +++ b/upstream/fedora-rawhide/man5/proc_sys_sunrpc.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sys_sunrpc 5 2023-09-30 "Linux man-pages 6.06" +.TH proc_sys_sunrpc 5 2023-09-30 "Linux man-pages 6.7" .SH NAME /proc/sys/sunrpc/ \- Sun remote procedure call for NFS .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sys_user.5 b/upstream/fedora-rawhide/man5/proc_sys_user.5 index 3fe4e6ea..34d9f882 100644 --- a/upstream/fedora-rawhide/man5/proc_sys_user.5 +++ b/upstream/fedora-rawhide/man5/proc_sys_user.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sys_user 5 2023-11-24 "Linux man-pages 6.06" +.TH proc_sys_user 5 2023-11-24 "Linux man-pages 6.7" .SH NAME /proc/sys/user/ \- limits on the number of namespaces of various types .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sys_vm.5 b/upstream/fedora-rawhide/man5/proc_sys_vm.5 index 4f978478..cbd5cf14 100644 --- a/upstream/fedora-rawhide/man5/proc_sys_vm.5 +++ b/upstream/fedora-rawhide/man5/proc_sys_vm.5 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sys_vm 5 2023-09-30 "Linux man-pages 6.06" +.TH proc_sys_vm 5 2023-09-30 "Linux man-pages 6.7" .SH NAME /proc/sys/vm/ \- virtual memory subsystem .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sysrq-trigger.5 b/upstream/fedora-rawhide/man5/proc_sysrq-trigger.5 index 89c488c5..bca3173f 100644 --- a/upstream/fedora-rawhide/man5/proc_sysrq-trigger.5 +++ b/upstream/fedora-rawhide/man5/proc_sysrq-trigger.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sysrq-trigger 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_sysrq-trigger 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/sysrq\-trigger \- SysRq function .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_sysvipc.5 b/upstream/fedora-rawhide/man5/proc_sysvipc.5 index 5fdf75f8..9ca6701a 100644 --- a/upstream/fedora-rawhide/man5/proc_sysvipc.5 +++ b/upstream/fedora-rawhide/man5/proc_sysvipc.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_sysvipc 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_sysvipc 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/sysvipc/ \- System V IPC .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_tid_children.5 b/upstream/fedora-rawhide/man5/proc_tid_children.5 index 67f984b9..6cb28331 100644 --- a/upstream/fedora-rawhide/man5/proc_tid_children.5 +++ b/upstream/fedora-rawhide/man5/proc_tid_children.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_tid_children 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_tid_children 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/tid/children \- child tasks .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_timer_list.5 b/upstream/fedora-rawhide/man5/proc_timer_list.5 index 51b9575b..e16fc5fd 100644 --- a/upstream/fedora-rawhide/man5/proc_timer_list.5 +++ b/upstream/fedora-rawhide/man5/proc_timer_list.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_timer_list 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_timer_list 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/timer_list \- pending timers .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_timer_stats.5 b/upstream/fedora-rawhide/man5/proc_timer_stats.5 index caf83856..3503f112 100644 --- a/upstream/fedora-rawhide/man5/proc_timer_stats.5 +++ b/upstream/fedora-rawhide/man5/proc_timer_stats.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_timer_stats 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_timer_stats 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/timer_stats \- timer statistics .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_tty.5 b/upstream/fedora-rawhide/man5/proc_tty.5 index e554541f..3b744718 100644 --- a/upstream/fedora-rawhide/man5/proc_tty.5 +++ b/upstream/fedora-rawhide/man5/proc_tty.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_tty 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_tty 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/tty/ \- tty .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_uptime.5 b/upstream/fedora-rawhide/man5/proc_uptime.5 index 7268029d..0fad2539 100644 --- a/upstream/fedora-rawhide/man5/proc_uptime.5 +++ b/upstream/fedora-rawhide/man5/proc_uptime.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_uptime 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_uptime 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/uptime \- system uptime .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_version.5 b/upstream/fedora-rawhide/man5/proc_version.5 index 5a4a703c..0f612d88 100644 --- a/upstream/fedora-rawhide/man5/proc_version.5 +++ b/upstream/fedora-rawhide/man5/proc_version.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_version 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_version 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/version \- kernel version .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_vmstat.5 b/upstream/fedora-rawhide/man5/proc_vmstat.5 index fe7dccdc..453ef1c7 100644 --- a/upstream/fedora-rawhide/man5/proc_vmstat.5 +++ b/upstream/fedora-rawhide/man5/proc_vmstat.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_vmstat 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_vmstat 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/vmstat \- virtual memory statistics .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/proc_zoneinfo.5 b/upstream/fedora-rawhide/man5/proc_zoneinfo.5 index ad3341d9..33e07a68 100644 --- a/upstream/fedora-rawhide/man5/proc_zoneinfo.5 +++ b/upstream/fedora-rawhide/man5/proc_zoneinfo.5 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-3.0-or-later .\" -.TH proc_zoneinfo 5 2023-08-15 "Linux man-pages 6.06" +.TH proc_zoneinfo 5 2023-08-15 "Linux man-pages 6.7" .SH NAME /proc/zoneinfo \- memory zones .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/protocols.5 b/upstream/fedora-rawhide/man5/protocols.5 index c30d0527..954f06d5 100644 --- a/upstream/fedora-rawhide/man5/protocols.5 +++ b/upstream/fedora-rawhide/man5/protocols.5 @@ -7,7 +7,7 @@ .\" 2002-09-22 Seth W. Klein <sk@sethwklein.net> .\" * protocol numbers are now assigned by the IANA .\" -.TH protocols 5 2023-10-31 "Linux man-pages 6.06" +.TH protocols 5 2024-02-25 "Linux man-pages 6.7" .SH NAME protocols \- protocols definition file .SH DESCRIPTION @@ -28,7 +28,7 @@ Protocol numbers and names are specified by the IANA Each line is of the following format: .P .RS -.I protocol number aliases ... +.I protocol number aliases .\|.\|. .RE .P where the fields are delimited by spaces or tabs. diff --git a/upstream/fedora-rawhide/man5/pstore.conf.5 b/upstream/fedora-rawhide/man5/pstore.conf.5 index 247722c9..25858a09 100644 --- a/upstream/fedora-rawhide/man5/pstore.conf.5 +++ b/upstream/fedora-rawhide/man5/pstore.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "PSTORE\&.CONF" "5" "" "systemd 255" "pstore.conf" +.TH "PSTORE\&.CONF" "5" "" "systemd 256~rc3" "pstore.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,8 +23,24 @@ pstore.conf, pstore.conf.d \- PStore configuration file .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/pstore\&.conf -/etc/systemd/pstore\&.conf\&.d/* +.RE +.RS 4 +/run/systemd/pstore\&.conf +.RE +.RS 4 +/usr/lib/systemd/pstore\&.conf +.RE +.RS 4 +/etc/systemd/pstore\&.conf\&.d/*\&.conf +.RE +.RS 4 +/run/systemd/pstore\&.conf\&.d/*\&.conf +.RE +.RS 4 +/usr/lib/systemd/pstore\&.conf\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP This file configures the behavior of @@ -32,16 +48,16 @@ This file configures the behavior of \m[blue]\fBpstore\fR\m[]\&\s-2\u[1]\d\s+2\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -51,7 +67,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null diff --git a/upstream/fedora-rawhide/man5/repart.d.5 b/upstream/fedora-rawhide/man5/repart.d.5 index 17e247f9..c2f5ff87 100644 --- a/upstream/fedora-rawhide/man5/repart.d.5 +++ b/upstream/fedora-rawhide/man5/repart.d.5 @@ -1,5 +1,5 @@ '\" t -.TH "REPART\&.D" "5" "" "systemd 255" "repart.d" +.TH "REPART\&.D" "5" "" "systemd 256~rc3" "repart.d" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,12 +23,15 @@ repart.d \- Partition Definition Files for Automatic Boot\-Time Repartitioning .SH "SYNOPSIS" .PP -.nf +.RS 4 /etc/repart\&.d/*\&.conf +.RE +.RS 4 /run/repart\&.d/*\&.conf +.RE +.RS 4 /usr/lib/repart\&.d/*\&.conf - -.fi +.RE .SH "DESCRIPTION" .PP repart\&.d/*\&.conf @@ -366,7 +369,7 @@ too\&. The logic is capable of automatically tracking down the backing partition "CopyBlocks=auto" is useful for implementing "self\-replicating" systems, i\&.e\&. systems that are their own installer\&. .sp -The file specified here must have a size that is a multiple of the basic block size 512 and not be empty\&. If this option is used, the size allocation algorithm is slightly altered: the partition is created as least as big as required to fit the data in, i\&.e\&. the data size is an additional minimum size value taken into consideration for the allocation algorithm, similar to and in addition to the +The file specified here must have a size that is a multiple of the basic block size 512 and not be empty\&. If this option is used, the size allocation algorithm is slightly altered: the partition is created at least as big as required to fit the data in, i\&.e\&. the data size is an additional minimum size value taken into consideration for the allocation algorithm, similar to and in addition to the \fISizeMin=\fR value configured above\&. .sp @@ -390,7 +393,7 @@ Takes a file system name, such as "erofs", "squashfs" or the special value -"swap"\&. If specified and the partition is newly created it is formatted with the specified file system (or as swap device)\&. The file system UUID and label are automatically derived from the partition UUID and label\&. If this option is used, the size allocation algorithm is slightly altered: the partition is created as least as big as required for the minimal file system of the specified type (or 4KiB if the minimal size is not known)\&. +"swap"\&. If specified and the partition is newly created it is formatted with the specified file system (or as swap device)\&. The file system UUID and label are automatically derived from the partition UUID and label\&. If this option is used, the size allocation algorithm is slightly altered: the partition is created at least as big as required for the minimal file system of the specified type (or 4KiB if the minimal size is not known)\&. .sp This option has no effect if the partition already exists\&. .sp @@ -539,6 +542,21 @@ Note that due to limitations of Added in version 255\&. .RE .PP +\fIDefaultSubvolume=\fR +.RS 4 +Takes an absolute path specifying the default subvolume within the new filesystem\&. Note that this setting does not create the subvolume itself, that can be configured with +\fISubvolumes=\fR\&. +.sp +Note that this option only takes effect if the target filesystem supports subvolumes, such as +"btrfs"\&. +.sp +Note that due to limitations of +"mkfs\&.btrfs", this option is only supported when running with +\fB\-\-offline=no\fR\&. +.sp +Added in version 256\&. +.RE +.PP \fIEncrypt=\fR .RS 4 Takes one of @@ -744,6 +762,41 @@ will have to populate the filesystem twice to guess the minimal required size, s .sp Added in version 253\&. .RE +.PP +\fIMountPoint=\fR +.RS 4 +Specifies where and how the partition should be mounted\&. Takes at least one and at most two fields separated with a colon (":")\&. The first field specifies where the partition should be mounted\&. The second field specifies extra mount options to append to the default mount options\&. These fields correspond to the second and fourth column of the +\fBfstab\fR(5) +format\&. This setting may be specified multiple times to mount the partition multiple times\&. This can be used to add mounts for different btrfs subvolumes located on the same btrfs partition\&. +.sp +Note that this setting is only taken into account when +\fB\-\-generate\-fstab=\fR +is specified on the +\fBsystemd\-repart\fR +command line\&. +.sp +Added in version 256\&. +.RE +.PP +\fIEncryptedVolume=\fR +.RS 4 +Specify how the encrypted partition should be set up\&. Takes at least one and at most three fields separated with a colon (":")\&. The first field specifies the encrypted volume name under +/dev/mapper/\&. If not specified, +"luks\-UUID" +will be used where +"UUID" +is the LUKS UUID\&. The second field specifies the keyfile to use following the same format as specified in crypttab\&. The third field specifies a comma\-delimited list of crypttab options\&. These fields correspond to the first, third and fourth column of the +\fBcrypttab\fR(5) +format\&. +.sp +Note that this setting is only taken into account when +\fB\-\-generate\-crypttab=\fR +is specified on the +\fBsystemd\-repart\fR +command line\&. +.sp +Added in version 256\&. +.RE .SH "SPECIFIERS" .PP Specifiers may be used in the @@ -947,6 +1000,16 @@ The partition number assigned to the partition T} .TE .sp 1 +.SH "ENVIRONMENT" +.PP +Extra filesystem formatting options can be provided using filesystem\-specific environment variables: +\fI$SYSTEMD_REPART_MKFS_OPTIONS_BTRFS\fR, +\fI$SYSTEMD_REPART_MKFS_OPTIONS_XFS\fR, +\fI$SYSTEMD_REPART_MKFS_OPTIONS_VFAT\fR, +\fI$SYSTEMD_REPART_MKFS_OPTIONS_EROFS\fR, and +\fI$SYSTEMD_REPART_MKFS_OPTIONS_SQUASHFS\fR\&. Each variable accepts valid +\fBmkfs\&.\fR\fB\fIfilesystem\fR\fR +command\-line arguments\&. The content of those variables is passed as\-is to the command, without any verification\&. .SH "EXAMPLES" .PP \fBExample\ \&1.\ \&Grow the root partition to the full disk size at first boot\fR @@ -1101,10 +1164,7 @@ VerityMatchKey=root .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-repart\fR(8), -\fBsfdisk\fR(8), -\fBsystemd-cryptenroll\fR(1) +\fBsystemd\fR(1), \fBsystemd-repart\fR(8), \fBsfdisk\fR(8), \fBsystemd-cryptenroll\fR(1) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man5/repertoiremap.5 b/upstream/fedora-rawhide/man5/repertoiremap.5 index dd7781cb..0a1f19e9 100644 --- a/upstream/fedora-rawhide/man5/repertoiremap.5 +++ b/upstream/fedora-rawhide/man5/repertoiremap.5 @@ -1,6 +1,6 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH repertoiremap 5 2023-10-31 "Linux man-pages 6.06" +.TH repertoiremap 5 2023-10-31 "Linux man-pages 6.7" .SH NAME repertoiremap \- map symbolic character names to Unicode code points .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/resolv.conf.5 b/upstream/fedora-rawhide/man5/resolv.conf.5 index 149f06dc..12103991 100644 --- a/upstream/fedora-rawhide/man5/resolv.conf.5 +++ b/upstream/fedora-rawhide/man5/resolv.conf.5 @@ -20,7 +20,7 @@ .\" .\" Added ndots remark by Bernhard R. Link - debian bug #182886 .\" -.TH resolv.conf 5 2023-10-31 "Linux man-pages 6.06" +.TH resolv.conf 5 2023-10-31 "Linux man-pages 6.7" .UC 4 .SH NAME resolv.conf \- resolver configuration file diff --git a/upstream/fedora-rawhide/man5/resolved.conf.5 b/upstream/fedora-rawhide/man5/resolved.conf.5 index cd0d5721..4979ca77 100644 --- a/upstream/fedora-rawhide/man5/resolved.conf.5 +++ b/upstream/fedora-rawhide/man5/resolved.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "RESOLVED\&.CONF" "5" "" "systemd 255" "resolved.conf" +.TH "RESOLVED\&.CONF" "5" "" "systemd 256~rc3" "resolved.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,28 +23,39 @@ resolved.conf, resolved.conf.d \- Network Name Resolution configuration files .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/resolved\&.conf -.PP +.RE +.RS 4 +/run/systemd/resolved\&.conf +.RE +.RS 4 +/usr/lib/systemd/resolved\&.conf +.RE +.RS 4 /etc/systemd/resolved\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /run/systemd/resolved\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/systemd/resolved\&.conf\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP These configuration files control local DNS and LLMNR name resolution\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -54,7 +65,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -173,9 +189,7 @@ If set to true, all DNS lookups are DNSSEC\-validated locally (excluding LLMNR a If set to "allow\-downgrade", DNSSEC validation is attempted, but if the server does not support DNSSEC properly, DNSSEC mode is automatically disabled\&. Note that this mode makes DNSSEC validation vulnerable to "downgrade" attacks, where an attacker might be able to trigger a downgrade to non\-DNSSEC mode by synthesizing a DNS response that suggests DNSSEC was not supported\&. .sp -If set to false, DNS lookups are not DNSSEC validated\&. In this mode, or when set to -"allow\-downgrade" -and the downgrade has happened, the resolver becomes security\-unaware and all forwarded queries have DNSSEC OK (DO) bit unset\&. +If set to false, DNS lookups are not DNSSEC validated\&. .sp Note that DNSSEC validation requires retrieval of additional DNS data, and thus results in a small DNS lookup time penalty\&. .sp @@ -366,11 +380,7 @@ Added in version 254\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-resolved.service\fR(8), -\fBsystemd-networkd.service\fR(8), -\fBdnssec-trust-anchors.d\fR(5), -\fBresolv.conf\fR(5) +\fBsystemd\fR(1), \fBsystemd-resolved.service\fR(8), \fBsystemd-networkd.service\fR(8), \fBdnssec-trust-anchors.d\fR(5), \fBresolv.conf\fR(5) .SH "NOTES" .IP " 1." 4 RFC 4795 diff --git a/upstream/fedora-rawhide/man5/rpc.5 b/upstream/fedora-rawhide/man5/rpc.5 index 15277eff..bc67a347 100644 --- a/upstream/fedora-rawhide/man5/rpc.5 +++ b/upstream/fedora-rawhide/man5/rpc.5 @@ -5,7 +5,7 @@ .\" %%%LICENSE_END .\" .\" @(#)rpc.5 2.2 88/08/03 4.0 RPCSRC; from 1.4 87/11/27 SMI; -.TH rpc 5 2023-10-31 "Linux man-pages 6.06" +.TH rpc 5 2023-10-31 "Linux man-pages 6.7" .SH NAME rpc \- RPC program number data base .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man5/rsyncd.conf.5 b/upstream/fedora-rawhide/man5/rsyncd.conf.5 index 249edd46..ce91b49a 100644 --- a/upstream/fedora-rawhide/man5/rsyncd.conf.5 +++ b/upstream/fedora-rawhide/man5/rsyncd.conf.5 @@ -1,4 +1,4 @@ -.TH "rsyncd.conf" "5" "20 Oct 2022" "rsyncd.conf from rsync 3.2.7" "User Commands" +.TH "rsyncd.conf" "5" "6 Apr 2024" "rsyncd.conf from rsync 3.3.0" "User Commands" .\" prefix=/usr .P .SH "NAME" @@ -10,7 +10,9 @@ rsyncd.conf \- configuration file for rsync in daemon mode rsyncd.conf .P The online version of this manpage (that includes cross-linking of topics) -is available at https://download.samba.org/pub/rsync/rsyncd.conf.5. +is available at +.UR https://download.samba.org/pub/rsync/rsyncd.conf.5 +.UE . .P .SH "DESCRIPTION" .P @@ -85,25 +87,7 @@ reread the \fBrsyncd.conf\fP file. The file is re-read on each client connection .SH "GLOBAL PARAMETERS" .P The first parameters in the file (before a [module] header) are the global -parameters. Rsync also allows for the use of a "[global]" module name to -indicate the start of one or more global-parameter sections (the name must be -lower case). -.P -You may also include any module parameters in the global part of the config -file in which case the supplied value will override the default for that -parameter. -.P -You may use references to environment variables in the values of parameters. -String parameters will have %VAR% references expanded as late as possible (when -the string is first used in the program), allowing for the use of variables -that rsync sets at connection time, such as RSYNC_USER_NAME. Non-string -parameters (such as true/false settings) are expanded when read from the config -file. If a variable does not exist in the environment, or if a sequence of -characters is not a valid reference (such as an un-paired percent sign), the -raw characters are passed through unchanged. This helps with backward -compatibility and safety (e.g. expanding a non-existent %VAR% to an empty -string in a path could result in a very unsafe path). The safest way to insert -a literal % into a value is to use %%. +parameters: .P .IP "\fBmotd\ file\fP" This parameter allows you to specify a "message of the day" (MOTD) to display @@ -136,6 +120,22 @@ can also be specified via the \fB\-\-sockopts\fP command-line option. You can override the default backlog value when the daemon listens for connections. It defaults to 5. .P +You may also include any MODULE PARAMETERS in the global part of the +config file, in which case the supplied value will override the default for +that parameter. +.P +You may use references to environment variables in the values of parameters. +String parameters will have %VAR% references expanded as late as possible (when +the string is first used in the program), allowing for the use of variables +that rsync sets at connection time, such as RSYNC_USER_NAME. Non-string +parameters (such as true/false settings) are expanded when read from the config +file. If a variable does not exist in the environment, or if a sequence of +characters is not a valid reference (such as an un-paired percent sign), the +raw characters are passed through unchanged. This helps with backward +compatibility and safety (e.g. expanding a non-existent %VAR% to an empty +string in a path could result in a very unsafe path). The safest way to insert +a literal % into a value is to use %%. +.P .SH "MODULE PARAMETERS" .P After the global parameters you should define a number of modules, each module @@ -144,11 +144,17 @@ a module name in square brackets [module] followed by the parameters for that module. The module name cannot contain a slash or a closing square bracket. If the name contains whitespace, each internal sequence of whitespace will be changed into a single space, while leading or trailing whitespace will be -discarded. Also, the name cannot be "global" as that exact name indicates that -global parameters follow (see above). +discarded. +.P +There is also a special module name of "[global]" that does not define a module +but instead switches back to the global settings context where default +parameters can be specified. Because each defined module gets its full set of +parameters as a combination of the default values that are set at that position +in the config file plus its own parameter list, the use of a "[global]" section +can help to maintain shared config values for multiple modules. .P -As with GLOBAL PARAMETERS, you may use references to environment variables in -the values of parameters. See the GLOBAL PARAMETERS section for more details. +As with GLOBAL PARAMETERS, you may use references to environment variables +in the values of parameters. See that section for details. .P .IP "\fBcomment\fP" This parameter specifies a description string that is displayed next to the @@ -1021,7 +1027,7 @@ before it begins. Any output from the \fBpre-xfer\ exec\fP command on stdout \fInot\fP displayed if the script returns success. The other programs cannot send any text to the user. All output except for the \fBpre-xfer\ exec\fP stdout goes to the corresponding daemon's stdout/stderr, which is typically -discarded. See the \fB\-\-no-detatch\fP option for a way to see the daemon's +discarded. See the \fB\-\-no-detach\fP option for a way to see the daemon's output, which can assist with debugging. .IP Note that the \fBearly\ exec\fP command runs before any part of the transfer @@ -1284,19 +1290,25 @@ susan:herpass .SH "BUGS" .P Please report bugs! The rsync bug tracking system is online at -https://rsync.samba.org/. +.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 -An rsync web site is available at https://rsync.samba.org/ and its github -project is https://github.com/WayneD/rsync. +An rsync web site is available at +.UR https://rsync.samba.org/ +.UE +and its github +project is +.UR https://github.com/WayneD/rsync +.UE . .P .SH "THANKS" .P @@ -1310,4 +1322,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/man5/securetty.5 b/upstream/fedora-rawhide/man5/securetty.5 index 279a81d6..d1ffbaa8 100644 --- a/upstream/fedora-rawhide/man5/securetty.5 +++ b/upstream/fedora-rawhide/man5/securetty.5 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sun Jul 25 11:06:27 1993 by Rik Faith (faith@cs.unc.edu) -.TH securetty 5 2023-10-31 "Linux man-pages 6.06" +.TH securetty 5 2023-10-31 "Linux man-pages 6.7" .SH NAME securetty \- list of terminals on which root is allowed to login .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/services.5 b/upstream/fedora-rawhide/man5/services.5 index 2442c6dc..eb83b3ef 100644 --- a/upstream/fedora-rawhide/man5/services.5 +++ b/upstream/fedora-rawhide/man5/services.5 @@ -11,7 +11,7 @@ .\" Thu Jan 11 12:14:41 1996 Austin Donnelly <and1000@cam.ac.uk> .\" * Merged two services(5) manpages .\" -.TH services 5 2023-10-31 "Linux man-pages 6.06" +.TH services 5 2023-10-31 "Linux man-pages 6.7" .SH NAME services \- Internet network services list .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/shells.5 b/upstream/fedora-rawhide/man5/shells.5 index 7a6c6297..aaeaed70 100644 --- a/upstream/fedora-rawhide/man5/shells.5 +++ b/upstream/fedora-rawhide/man5/shells.5 @@ -6,7 +6,7 @@ .\" Modified Sat Jul 24 17:11:07 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified Sun Nov 21 10:49:38 1993 by Michael Haardt .\" Modified Sun Feb 26 15:09:15 1995 by Rik Faith (faith@cs.unc.edu) -.TH shells 5 2023-10-31 "Linux man-pages 6.06" +.TH shells 5 2023-10-31 "Linux man-pages 6.7" .SH NAME shells \- pathnames of valid login shells .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/slabinfo.5 b/upstream/fedora-rawhide/man5/slabinfo.5 index 51e02a48..73f7f9ed 100644 --- a/upstream/fedora-rawhide/man5/slabinfo.5 +++ b/upstream/fedora-rawhide/man5/slabinfo.5 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH slabinfo 5 2023-10-31 "Linux man-pages 6.06" +.TH slabinfo 5 2023-10-31 "Linux man-pages 6.7" .SH NAME slabinfo \- kernel slab allocator statistics .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man5/smb.conf.5 b/upstream/fedora-rawhide/man5/smb.conf.5 index 6de830fd..3b5626d6 100644 --- a/upstream/fedora-rawhide/man5/smb.conf.5 +++ b/upstream/fedora-rawhide/man5/smb.conf.5 @@ -2,12 +2,12 @@ .\" Title: smb.conf .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/26/2024 +.\" Date: 05/08/2024 .\" Manual: File Formats and Conventions -.\" Source: Samba 4.20.0rc3 +.\" Source: Samba 4.20.1 .\" Language: English .\" -.TH "SMB\&.CONF" "5" "02/26/2024" "Samba 4\&.20\&.0rc3" "File Formats and Conventions" +.TH "SMB\&.CONF" "5" "05/08/2024" "Samba 4\&.20\&.1" "File Formats and Conventions" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -3860,7 +3860,7 @@ dns update command (G) This option sets the command that is called when there are DNS updates\&. It should update the local machines DNS names using TSIG\-GSS\&. .sp Default: -\fI\fIdns update command\fR\fR\fI = \fR\fI/builddir/build/BUILD/samba\-4\&.20\&.0rc3/source4/scripting/bin/samba_dnsupdate\fR\fI \fR +\fI\fIdns update command\fR\fR\fI = \fR\fI/builddir/build/BUILD/samba\-4\&.20\&.1/source4/scripting/bin/samba_dnsupdate\fR\fI \fR .sp Example: \fI\fIdns update command\fR\fR\fI = \fR\fI/usr/local/sbin/dnsupdate\fR\fI \fR @@ -4886,7 +4886,7 @@ gpo update command (G) This option sets the command that is called to apply GPO policies\&. The samba\-gpupdate script applies System Access and Kerberos Policies to the KDC\&. System Access policies set minPwdAge, maxPwdAge, minPwdLength, and pwdProperties in the samdb\&. Kerberos Policies set kdc:service ticket lifetime, kdc:user ticket lifetime, and kdc:renewal lifetime in smb\&.conf\&. .sp Default: -\fI\fIgpo update command\fR\fR\fI = \fR\fI/builddir/build/BUILD/samba\-4\&.20\&.0rc3/source4/scripting/bin/samba\-gpupdate\fR\fI \fR +\fI\fIgpo update command\fR\fR\fI = \fR\fI/builddir/build/BUILD/samba\-4\&.20\&.1/source4/scripting/bin/samba\-gpupdate\fR\fI \fR .sp Example: \fI\fIgpo update command\fR\fR\fI = \fR\fI/usr/local/sbin/gpoupdate\fR\fI \fR @@ -11017,7 +11017,7 @@ samba_kcc was installed in a non\-default location\&. .sp Default: -\fI\fIsamba kcc command\fR\fR\fI = \fR\fI/builddir/build/BUILD/samba\-4\&.20\&.0rc3/source4/scripting/bin/samba_kcc\fR\fI \fR +\fI\fIsamba kcc command\fR\fR\fI = \fR\fI/builddir/build/BUILD/samba\-4\&.20\&.1/source4/scripting/bin/samba_kcc\fR\fI \fR .sp Example: \fI\fIsamba kcc command\fR\fR\fI = \fR\fI/usr/local/bin/kcc\fR\fI \fR @@ -13021,7 +13021,7 @@ This option sets the command that for updating servicePrincipalName names from spn_update_list\&. .sp Default: -\fI\fIspn update command\fR\fR\fI = \fR\fI/builddir/build/BUILD/samba\-4\&.20\&.0rc3/source4/scripting/bin/samba_spnupdate\fR\fI \fR +\fI\fIspn update command\fR\fR\fI = \fR\fI/builddir/build/BUILD/samba\-4\&.20\&.1/source4/scripting/bin/samba_spnupdate\fR\fI \fR .sp Example: \fI\fIspn update command\fR\fR\fI = \fR\fI/usr/local/sbin/spnupdate\fR\fI \fR @@ -14912,7 +14912,7 @@ and special sections make life for an administrator easy, but the various combinations of default attributes can be tricky\&. Take extreme care when designing these sections\&. In particular, ensure that the permissions on spool directories are correct\&. .SH "VERSION" .PP -This man page is part of version 4\&.20\&.0rc3 of the Samba suite\&. +This man page is part of version 4\&.20\&.1 of the Samba suite\&. .SH "SEE ALSO" .PP \fBsamba\fR(7), diff --git a/upstream/fedora-rawhide/man5/smbpasswd.5 b/upstream/fedora-rawhide/man5/smbpasswd.5 index d18b9a61..b26cb58b 100644 --- a/upstream/fedora-rawhide/man5/smbpasswd.5 +++ b/upstream/fedora-rawhide/man5/smbpasswd.5 @@ -2,12 +2,12 @@ .\" Title: smbpasswd .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/26/2024 +.\" Date: 05/08/2024 .\" Manual: File Formats and Conventions -.\" Source: Samba 4.20.0rc3 +.\" Source: Samba 4.20.1 .\" Language: English .\" -.TH "SMBPASSWD" "5" "02/26/2024" "Samba 4\&.20\&.0rc3" "File Formats and Conventions" +.TH "SMBPASSWD" "5" "05/08/2024" "Samba 4\&.20\&.1" "File Formats and Conventions" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -165,7 +165,7 @@ This field consists of the time the account was last modified\&. It consists of All other colon separated fields are ignored at this time\&. .SH "VERSION" .PP -This man page is part of version 4\&.20\&.0rc3 of the Samba suite\&. +This man page is part of version 4\&.20\&.1 of the Samba suite\&. .SH "SEE ALSO" .PP \fBsmbpasswd\fR(8), diff --git a/upstream/fedora-rawhide/man5/sysctl.d.5 b/upstream/fedora-rawhide/man5/sysctl.d.5 index 9b232b02..43455ab4 100644 --- a/upstream/fedora-rawhide/man5/sysctl.d.5 +++ b/upstream/fedora-rawhide/man5/sysctl.d.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSCTL\&.D" "5" "" "systemd 255" "sysctl.d" +.TH "SYSCTL\&.D" "5" "" "systemd 256~rc3" "sysctl.d" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,11 +23,15 @@ sysctl.d \- Configure kernel parameters at boot .SH "SYNOPSIS" .PP +.RS 4 /etc/sysctl\&.d/*\&.conf -.PP +.RE +.RS 4 /run/sysctl\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/sysctl\&.d/*\&.conf +.RE .sp .nf key\&.name\&.under\&.proc\&.sys = some value @@ -122,7 +126,12 @@ Packages should install their configuration files in /usr/local/lib/ (local installs)\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. It is recommended to prefix all filenames with a two\-digit number and a dash, to simplify the ordering of the files\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. It is recommended to prefix all filenames with a two\-digit number and a dash, to simplify the ordering of the files\&. It is recommended to use the range 10\-40 for configuration files in +/usr/ +and the range 60\-90 for configuration files in +/etc/ +and +/run/, to make sure that local and transient configuration files will always take priority over configuration files shipped by the OS vendor\&. .PP If the administrator wants to disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -237,9 +246,4 @@ will get this value (this also covers any interfaces detected while we\*(Aqre ru net\&.ipv4\&.conf\&.all\&.rp_filter, which we don\*(Aqt want to set at all, so it is explicitly excluded\&. And "hub0" is excluded from the glob because it has an explicit setting\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-sysctl.service\fR(8), -\fBsystemd-delta\fR(1), -\fBsysctl\fR(8), -\fBsysctl.conf\fR(5), -\fBmodprobe\fR(8) +\fBsystemd\fR(1), \fBsystemd-sysctl.service\fR(8), \fBsystemd-delta\fR(1), \fBsysctl\fR(8), \fBsysctl.conf\fR(5), \fBmodprobe\fR(8) diff --git a/upstream/fedora-rawhide/man5/sysfs.5 b/upstream/fedora-rawhide/man5/sysfs.5 index 7c18e4be..5a5237cc 100644 --- a/upstream/fedora-rawhide/man5/sysfs.5 +++ b/upstream/fedora-rawhide/man5/sysfs.5 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sysfs 5 2023-10-31 "Linux man-pages 6.06" +.TH sysfs 5 2023-10-31 "Linux man-pages 6.7" .SH NAME sysfs \- a filesystem for exporting kernel objects .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/systemd-sleep.conf.5 b/upstream/fedora-rawhide/man5/systemd-sleep.conf.5 index 20d3e071..0c81de64 100644 --- a/upstream/fedora-rawhide/man5/systemd-sleep.conf.5 +++ b/upstream/fedora-rawhide/man5/systemd-sleep.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SLEEP\&.CONF" "5" "" "systemd 255" "systemd-sleep.conf" +.TH "SYSTEMD\-SLEEP\&.CONF" "5" "" "systemd 256~rc3" "systemd-sleep.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,13 +23,24 @@ systemd-sleep.conf, sleep.conf.d \- Suspend and hibernation configuration file .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/sleep\&.conf -.PP +.RE +.RS 4 +/run/systemd/sleep\&.conf +.RE +.RS 4 +/usr/lib/systemd/sleep\&.conf +.RE +.RS 4 /etc/systemd/sleep\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /run/systemd/sleep\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/systemd/sleep\&.conf\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP \fBsystemd\fR @@ -89,16 +100,16 @@ attempts to suspend or hibernate the machine\&. See for a general description of the syntax\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -108,7 +119,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -142,6 +158,25 @@ can be used to override and enable those specific modes\&. Added in version 240\&. .RE .PP +\fISuspendState=\fR +.RS 4 +The string to be written to +/sys/power/state +by +\fBsystemd-suspend.service\fR(8)\&. More than one value can be specified by separating multiple values with whitespace\&. They will be tried in turn, until one is written without error\&. If none of the writes succeed, the operation will be aborted\&. +.sp +The allowed set of values is determined by the kernel and is shown in the file itself (use +\fBcat /sys/power/state\fR +to display)\&. See +\m[blue]\fBBasic sysfs Interfaces for System Suspend and Hibernation\fR\m[]\&\s-2\u[1]\d\s+2 +for more details\&. +.sp +\fBsystemd-suspend-then-hibernate.service\fR(8) +uses this value when suspending\&. +.sp +Added in version 203\&. +.RE +.PP \fIHibernateMode=\fR .RS 4 The string to be written to @@ -163,23 +198,25 @@ when hibernating\&. Added in version 203\&. .RE .PP -\fISuspendState=\fR +\fIMemorySleepMode=\fR .RS 4 The string to be written to -/sys/power/state -by -\fBsystemd-suspend.service\fR(8)\&. More than one value can be specified by separating multiple values with whitespace\&. They will be tried in turn, until one is written without error\&. If none of the writes succeed, the operation will be aborted\&. +/sys/power/mem_sleep +when +\fBSuspendState=mem\fR +or +\fBhybrid\-sleep\fR +is used\&. More than one value can be specified by separating multiple values with whitespace\&. They will be tried in turn, until one is written without error\&. If none of the writes succeed, the operation will be aborted\&. Defaults to empty, i\&.e\&. the kernel default or kernel command line option +\fImem_sleep_default=\fR +is respected\&. .sp The allowed set of values is determined by the kernel and is shown in the file itself (use -\fBcat /sys/power/state\fR -to display)\&. See +\fBcat /sys/power/mem_sleep\fR +to display)\&. See the kernel documentation page \m[blue]\fBBasic sysfs Interfaces for System Suspend and Hibernation\fR\m[]\&\s-2\u[1]\d\s+2 for more details\&. .sp -\fBsystemd-suspend-then-hibernate.service\fR(8) -uses this value when suspending\&. -.sp -Added in version 203\&. +Added in version 256\&. .RE .PP \fIHibernateDelaySec=\fR @@ -221,16 +258,10 @@ SuspendState=freeze .\} .SH "SEE ALSO" .PP -\fBsystemd-sleep\fR(8), -\fBsystemd-suspend.service\fR(8), -\fBsystemd-hibernate.service\fR(8), -\fBsystemd-hybrid-sleep.service\fR(8), -\fBsystemd-suspend-then-hibernate.service\fR(8), -\fBsystemd\fR(1), -\fBsystemd.directives\fR(7) +\fBsystemd-sleep\fR(8), \fBsystemd-suspend.service\fR(8), \fBsystemd-hibernate.service\fR(8), \fBsystemd-hybrid-sleep.service\fR(8), \fBsystemd-suspend-then-hibernate.service\fR(8), \fBsystemd\fR(1), \fBsystemd.directives\fR(7) .SH "NOTES" .IP " 1." 4 Basic sysfs Interfaces for System Suspend and Hibernation .RS 4 -\%https://www.kernel.org/doc/html/latest/admin-guide/pm/sleep-states.html#basic-sysfs-interfaces-for-system-suspend-and-hibernation +\%https://docs.kernel.org/admin-guide/pm/sleep-states.html#basic-sysfs-interfaces-for-system-suspend-and-hibernation .RE diff --git a/upstream/fedora-rawhide/man5/systemd-system.conf.5 b/upstream/fedora-rawhide/man5/systemd-system.conf.5 index 6d2267c2..072da5ee 100644 --- a/upstream/fedora-rawhide/man5/systemd-system.conf.5 +++ b/upstream/fedora-rawhide/man5/systemd-system.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSTEM\&.CONF" "5" "" "systemd 255" "systemd-system.conf" +.TH "SYSTEMD\-SYSTEM\&.CONF" "5" "" "systemd 256~rc3" "systemd-system.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -24,12 +24,16 @@ systemd-system.conf, system.conf.d, systemd-user.conf, user.conf.d \- System and .SH "SYNOPSIS" .PP /etc/systemd/system\&.conf, +/run/systemd/system\&.conf, +/usr/lib/systemd/system\&.conf, /etc/systemd/system\&.conf\&.d/*\&.conf, /run/systemd/system\&.conf\&.d/*\&.conf, /usr/lib/systemd/system\&.conf\&.d/*\&.conf .PP ~/\&.config/systemd/user\&.conf, /etc/systemd/user\&.conf, +/run/systemd/user\&.conf, +/usr/lib/systemd/user\&.conf, /etc/systemd/user\&.conf\&.d/*\&.conf, /run/systemd/user\&.conf\&.d/*\&.conf, /usr/lib/systemd/user\&.conf\&.d/*\&.conf @@ -43,8 +47,10 @@ and the files in system\&.conf\&.d directories; when run as a user instance, it interprets the configuration file user\&.conf -(either in the home directory of the user, or if not found, under -/etc/systemd/) and the files in +(in order of priority, in the home directory of the user and under +/etc/systemd/, +/run/systemd/, and +/usr/lib/systemd/) and the files in user\&.conf\&.d directories\&. These configuration files contain a few settings controlling basic manager operations\&. .PP @@ -53,16 +59,16 @@ See for a general description of the syntax\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -72,7 +78,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -82,7 +93,7 @@ in the configuration directory in .PP All options are configured in the [Manager] section: .PP -\fILogColor=\fR, \fILogLevel=\fR, \fILogLocation=\fR, \fILogTarget=\fR, \fILogTime=\fR, \fIDumpCore=yes\fR, \fICrashChangeVT=no\fR, \fICrashShell=no\fR, \fICrashReboot=no\fR, \fIShowStatus=yes\fR, \fIDefaultStandardOutput=journal\fR, \fIDefaultStandardError=inherit\fR +\fILogColor=\fR, \fILogLevel=\fR, \fILogLocation=\fR, \fILogTarget=\fR, \fILogTime=\fR, \fIDumpCore=yes\fR, \fICrashChangeVT=no\fR, \fICrashShell=no\fR, \fICrashAction=freeze\fR, \fIShowStatus=yes\fR, \fIDefaultStandardOutput=journal\fR, \fIDefaultStandardError=inherit\fR .RS 4 Configures various parameters of basic manager operation\&. These options may be overridden by the respective process and kernel command line arguments\&. See \fBsystemd\fR(1) @@ -263,6 +274,24 @@ Takes a boolean argument\&. If true, ensures that PID 1 and all its children can Added in version 239\&. .RE .PP +\fIProtectSystem=\fR +.RS 4 +Takes a boolean argument or the string +"auto"\&. If set to true this will remount +/usr/ +read\-only\&. If set to +"auto" +(the default) and running in an initrd equivalent to true, otherwise false\&. This implements a restricted subset of the per\-unit setting of the same name, see +\fBsystemd.exec\fR(5) +for details: currently, the +"full" +or +"struct" +values are not supported\&. +.sp +Added in version 256\&. +.RE +.PP \fISystemCallArchitectures=\fR .RS 4 Takes a space\-separated list of architecture identifiers\&. Selects from which architectures system calls may be invoked on this system\&. This may be used as an effective way to disable invocation of non\-native binaries system\-wide, for example to prohibit execution of 32\-bit x86 binaries on 64\-bit x86\-64 systems\&. This option operates system\-wide, and acts similar to the @@ -588,11 +617,11 @@ Added in version 252\&. .PP \fIReloadLimitIntervalSec=\fR, \fIReloadLimitBurst=\fR .RS 4 -Rate limiting for daemon\-reload requests\&. Default to unset, and any number of daemon\-reload operations can be requested at any time\&. +Rate limiting for daemon\-reload and (since v256) daemon\-reexec requests\&. The setting applies to both operations, but the rate limits are tracked separately\&. Defaults to unset, and any number of operations can be requested at any time\&. \fIReloadLimitIntervalSec=\fR takes a value in seconds to configure the rate limit window, and \fIReloadLimitBurst=\fR -takes a positive integer to configure the maximum allowed number of reloads within the configured time window\&. +takes a positive integer to configure the maximum allowed number of operations within the configured time window\&. .sp Added in version 253\&. .RE @@ -818,12 +847,7 @@ Added in version 252\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.directives\fR(7), -\fBsystemd.exec\fR(5), -\fBsystemd.service\fR(5), -\fBenviron\fR(7), -\fBcapabilities\fR(7) +\fBsystemd\fR(1), \fBsystemd.directives\fR(7), \fBsystemd.exec\fR(5), \fBsystemd.service\fR(5), \fBenviron\fR(7), \fBcapabilities\fR(7) .SH "NOTES" .IP " 1." 4 No New Privileges Flag diff --git a/upstream/fedora-rawhide/man5/systemd.automount.5 b/upstream/fedora-rawhide/man5/systemd.automount.5 index b61efb9a..1ba25d77 100644 --- a/upstream/fedora-rawhide/man5/systemd.automount.5 +++ b/upstream/fedora-rawhide/man5/systemd.automount.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.AUTOMOUNT" "5" "" "systemd 255" "systemd.automount" +.TH "SYSTEMD\&.AUTOMOUNT" "5" "" "systemd 256~rc3" "systemd.automount" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -183,10 +183,4 @@ Check for more settings\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemd.mount\fR(5), -\fBmount\fR(8), -\fBautomount\fR(8), -\fBsystemd.directives\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.mount\fR(5), \fBmount\fR(8), \fBautomount\fR(8), \fBsystemd.directives\fR(7) diff --git a/upstream/fedora-rawhide/man5/systemd.device.5 b/upstream/fedora-rawhide/man5/systemd.device.5 index 6d6744c4..7c240275 100644 --- a/upstream/fedora-rawhide/man5/systemd.device.5 +++ b/upstream/fedora-rawhide/man5/systemd.device.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.DEVICE" "5" "" "systemd 255" "systemd.device" +.TH "SYSTEMD\&.DEVICE" "5" "" "systemd 256~rc3" "systemd.device" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -131,8 +131,4 @@ Device unit files may include [Unit] and [Install] sections, which are described \fBsystemd.unit\fR(5)\&. No options specific to this file type are supported\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.unit\fR(5), -\fBudev\fR(7), -\fBsystemd.directives\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.unit\fR(5), \fBudev\fR(7), \fBsystemd.directives\fR(7) diff --git a/upstream/fedora-rawhide/man5/systemd.dnssd.5 b/upstream/fedora-rawhide/man5/systemd.dnssd.5 index 708d02ca..1b719a77 100644 --- a/upstream/fedora-rawhide/man5/systemd.dnssd.5 +++ b/upstream/fedora-rawhide/man5/systemd.dnssd.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.DNSSD" "5" "" "systemd 255" "systemd.dnssd" +.TH "SYSTEMD\&.DNSSD" "5" "" "systemd 256~rc3" "systemd.dnssd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -207,6 +207,15 @@ A type of the network service as defined in the section 4\&.1\&.2 of Added in version 236\&. .RE .PP +\fISubType=\fR +.RS 4 +A subtype of the network service as defined in the section 7\&.1 of +\m[blue]\fBRFC 6763\fR\m[]\&\s-2\u[1]\d\s+2, e\&.g\&. +"_printer"\&. +.sp +Added in version 256\&. +.RE +.PP \fIPort=\fR .RS 4 An IP port number of the network service\&. @@ -325,9 +334,7 @@ $ avahi\-browse \-a \-r .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-resolved.service\fR(8), -\fBresolvectl\fR(1) +\fBsystemd\fR(1), \fBsystemd-resolved.service\fR(8), \fBresolvectl\fR(1) .SH "NOTES" .IP " 1." 4 RFC 6763 diff --git a/upstream/fedora-rawhide/man5/systemd.exec.5 b/upstream/fedora-rawhide/man5/systemd.exec.5 index 3e30d6d5..c08fb7a7 100644 --- a/upstream/fedora-rawhide/man5/systemd.exec.5 +++ b/upstream/fedora-rawhide/man5/systemd.exec.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.EXEC" "5" "" "systemd 255" "systemd.exec" +.TH "SYSTEMD\&.EXEC" "5" "" "systemd 256~rc3" "systemd.exec" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -171,10 +171,10 @@ is relative to the root of the system running the service manager\&. Note that s \fIRootDirectory=\fR .RS 4 Takes a directory path relative to the host\*(Aqs root directory (i\&.e\&. the root of the system running the service manager)\&. Sets the root directory for executed processes, with the +\fBpivot_root\fR(2) +or \fBchroot\fR(2) -system call\&. If this is used, it must be ensured that the process binary and all its auxiliary files are available in the -\fBchroot()\fR -jail\&. Note that setting this parameter might result in additional dependencies to be added to the unit (see above)\&. +system call\&. If this is used, it must be ensured that the process binary and all its auxiliary files are available in the new root\&. Note that setting this parameter might result in additional dependencies to be added to the unit (see above)\&. .sp The \fIMountAPIVFS=\fR @@ -211,6 +211,12 @@ BindReadOnlyPaths=/dev/log /run/systemd/journal/socket /run/systemd/journal/stdo .RE .\} +In place of the directory path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. +.sp This option is only available for system services, or for services running in per\-user instances of the service manager in which case \fIPrivateUsers=\fR is implicitly enabled (requires unprivileged user namespaces support to be enabled in the kernel via the @@ -268,6 +274,12 @@ file will be made available for the service (read\-only) as /run/host/os\-release\&. It will be updated automatically on soft reboot (see: \fBsystemd-soft-reboot.service\fR(8)), in case the service is configured to survive it\&. .sp +In place of the image path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. +.sp This option is only available for system services and is not supported for services running in per\-user instances of the service manager\&. .sp Added in version 233\&. @@ -549,6 +561,10 @@ creates regular writable bind mounts (unless the source file system mount is alr \fIBindReadOnlyPaths=\fR creates read\-only bind mounts\&. These settings may be used more than once, each usage appends to the unit\*(Aqs list of bind mounts\&. If the empty string is assigned to either of these two options the entire list of bind mounts defined prior to this is reset\&. Note that in this case both read\-only and regular bind mounts are reset, regardless which of the two settings is used\&. .sp +Using this option implies that a mount namespace is allocated for the unit, i\&.e\&. it implies the effect of +\fIPrivateMounts=\fR +(see below)\&. +.sp This option is particularly useful when \fIRootDirectory=\fR/\fIRootImage=\fR is used\&. In this case the source path refers to a path on the host file system, while the destination path refers to a path below the root directory of the unit\&. @@ -696,6 +712,12 @@ or below, as it may change the setting of \fIDevicePolicy=\fR\&. .sp +In place of the image path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. +.sp This option is only available for system services and is not supported for services running in per\-user instances of the service manager\&. .sp Added in version 248\&. @@ -733,6 +755,12 @@ or the host\&. See: .sp Note that usage from user units requires overlayfs support in unprivileged user namespaces, which was first introduced in kernel v5\&.11\&. .sp +In place of the directory path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. +.sp This option is only available for system services, or for services running in per\-user instances of the service manager in which case \fIPrivateUsers=\fR is implicitly enabled (requires unprivileged user namespaces support to be enabled in the kernel via the @@ -837,17 +865,22 @@ Sets the supplementary Unix groups the processes are executed as\&. This takes a .PP \fISetLoginEnvironment=\fR .RS 4 -Takes a boolean parameter that controls whether to set +Takes a boolean parameter that controls whether to set the \fI$HOME\fR, \fI$LOGNAME\fR, and \fI$SHELL\fR -environment variables\&. If unset, this is controlled by whether -\fIUser=\fR -is set\&. If true, they will always be set for system services, i\&.e\&. even when the default user +environment variables\&. If not set, this defaults to true if +\fIUser=\fR, +\fIDynamicUser=\fR +or +\fIPAMName=\fR +are set, false otherwise\&. If set to true, the variables will always be set for system services, i\&.e\&. even when the default user "root" -is used\&. If false, the mentioned variables are not set by systemd, no matter whether -\fIUser=\fR -is used or not\&. This option normally has no effect on user services, since these variables are typically inherited from user manager\*(Aqs own environment anyway\&. +is used\&. If set to false, the mentioned variables are not set by the service manager, no matter whether +\fIUser=\fR, +\fIDynamicUser=\fR, or +\fIPAMName=\fR +are used or not\&. This option normally has no effect on services of the per\-user service manager, since in that case these variables are typically inherited from user manager\*(Aqs own environment anyway\&. .sp Added in version 255\&. .RE @@ -1410,11 +1443,11 @@ Added in version 209\&. .PP \fIIgnoreSIGPIPE=\fR .RS 4 -Takes a boolean argument\&. If true, causes +Takes a boolean argument\&. If true, \fBSIGPIPE\fR -to be ignored in the executed process\&. Defaults to true because +is ignored in the executed process\&. Defaults to true since \fBSIGPIPE\fR -generally is useful only in shell pipelines\&. +is generally only useful in shell pipelines\&. .RE .SH "SCHEDULING" .PP @@ -1532,6 +1565,12 @@ Also note that some sandboxing functionality is generally not available in user \fIProtectSystem=\fR) are not available, as the underlying kernel functionality is only accessible to privileged processes\&. However, most namespacing settings, that will not work on their own in user services, will work when used in conjunction with \fIPrivateUsers=\fR\fBtrue\fR\&. .PP +Note that the various options that turn directories read\-only (such as +\fIProtectSystem=\fR, +\fIReadOnlyPaths=\fR, \&...) do not affect the ability for programs to connect to and communicate with +\fBAF_UNIX\fR +sockets in these directories\&. These options cannot be used to lock down access to IPC services hence\&. +.PP \fIProtectSystem=\fR .RS 4 Takes a boolean argument or the special values @@ -1556,7 +1595,10 @@ and \fIProtectKernelTunables=\fR, \fIProtectControlGroups=\fR)\&. This setting ensures that any modification of the vendor\-supplied operating system (and optionally its configuration, and local mounts) is prohibited for the service\&. It is recommended to enable this setting for all long\-running services, unless they are involved with system updates or need to modify the operating system in other ways\&. If this option is used, \fIReadWritePaths=\fR -may be used to exclude specific directories from being made read\-only\&. This setting is implied if +may be used to exclude specific directories from being made read\-only\&. Similar, +\fIStateDirectory=\fR, +\fILogsDirectory=\fR, \&... and related directory settings (see below) also exclude the specific directories from the effect of +\fIProtectSystem=\fR\&. This setting is implied if \fIDynamicUser=\fR is set\&. This setting cannot ensure protection in all cases\&. In general it has the same limitations as \fIReadOnlyPaths=\fR, see below\&. Defaults to off\&. @@ -2790,14 +2832,15 @@ and directories\&. .sp Other file system namespace unit settings \(em -\fIPrivateMounts=\fR, \fIPrivateTmp=\fR, \fIPrivateDevices=\fR, \fIProtectSystem=\fR, \fIProtectHome=\fR, \fIReadOnlyPaths=\fR, \fIInaccessiblePaths=\fR, -\fIReadWritePaths=\fR, \&... \(em also enable file system namespacing in a fashion equivalent to this option\&. Hence it is primarily useful to explicitly request this behaviour if none of the other settings are used\&. +\fIReadWritePaths=\fR, +\fIBindPaths=\fR, +\fIBindReadOnlyPaths=\fR, \&... \(em also enable file system namespacing in a fashion equivalent to this option\&. Hence it is primarily useful to explicitly request this behaviour if none of the other settings are used\&. .sp This option is only available for system services, or for services running in per\-user instances of the service manager in which case \fIPrivateUsers=\fR @@ -3481,7 +3524,7 @@ The option may be used to connect a specific file system object to standard output\&. The semantics are similar to the same option of \fIStandardInput=\fR, see above\&. If \fIpath\fR -refers to a regular file on the filesystem, it is opened (created if it doesn\*(Aqt exist yet) for writing at the beginning of the file, but without truncating it\&. If standard input and output are directed to the same file path, it is opened only once \(em for reading as well as writing \(em and duplicated\&. This is particularly useful when the specified path refers to an +refers to a regular file on the filesystem, it is opened (created if it doesn\*(Aqt exist yet using privileges of the user executing the systemd process) for writing at the beginning of the file, but without truncating it\&. If standard input and output are directed to the same file path, it is opened only once \(em for reading as well as writing \(em and duplicated\&. This is particularly useful when the specified path refers to an \fBAF_UNIX\fR socket in the file system, as in that case only a single stream connection is created for both input and output\&. .sp @@ -3543,7 +3586,7 @@ on systemd\-journald\&.socket (also see the "Implicit Dependencies" section above)\&. Also note that in this case stdout (or stderr, see below) will be an \fBAF_UNIX\fR -stream socket, and not a pipe or FIFO that can be re\-opened\&. This means when executing shell scripts the construct +stream socket, and not a pipe or FIFO that can be reopened\&. This means when executing shell scripts the construct \fBecho "hello" > /dev/stderr\fR for writing text to stderr will not work\&. To mitigate this use the construct \fBecho "hello" >&2\fR @@ -3678,6 +3721,8 @@ separated by whitespace\&. See for details on the journal field concept\&. Even though the underlying journal implementation permits binary field values, this setting accepts only valid UTF\-8 values\&. To include space characters in a journal field value, enclose the assignment in double quotes (")\&. The usual specifiers are expanded in all assignments (see below)\&. Note that this setting is not only useful for attaching additional metadata to log records of a unit, but given that all fields and values are indexed may also be used to implement cross\-unit log record matching\&. Assign an empty string to reset the list\&. .sp +Note that this functionality is currently only available in system services, not in per\-user services\&. +.sp Added in version 236\&. .RE .PP @@ -3727,7 +3772,7 @@ would add a pattern matching "~foobar" to the allow list\&. .sp -Log messages are tested against denied patterns (if any), then against allowed patterns (if any)\&. If a log message matches any of the denied patterns, it will be discarded, whatever the allowed patterns\&. Then, remaining log messages are tested against allowed patterns\&. Messages matching against none of the allowed pattern are discarded\&. If no allowed patterns are defined, then all messages are processed directly after going through denied filters\&. +Log messages are tested against denied patterns (if any), then against allowed patterns (if any)\&. If a log message matches any of the denied patterns, it is discarded immediately without considering allowed patterns\&. Remaining log messages are tested against allowed patterns\&. Messages matching against none of the allowed pattern are discarded\&. If no allowed patterns are defined, then all messages are processed directly after going through denied filters\&. .sp Filtering is based on the unit for which \fILogFilterPatterns=\fR @@ -3735,6 +3780,8 @@ is defined, meaning log messages coming from \fBsystemd\fR(1) about the unit are not taken into account\&. Filtered log messages won\*(Aqt be forwarded to traditional syslog daemons, the kernel log buffer (kmsg), the systemd console, or sent as wall messages to all logged\-in users\&. .sp +Note that this functionality is currently only available in system services, not in per\-user services\&. +.sp Added in version 253\&. .RE .PP @@ -3934,6 +3981,8 @@ are searched as well\&. .sp If the file system path is omitted it is chosen identical to the credential name, i\&.e\&. this is a terse way to declare credentials to inherit from the service manager into a service\&. This option may be used multiple times, each time defining an additional credential to pass to the unit\&. .sp +Note that if the path is not specified or a valid credential identifier is given, i\&.e\&. in the above two cases, a missing credential is not considered fatal\&. +.sp If an absolute path referring to a directory is specified, every file in that directory (recursively) will be loaded as a separate credential\&. The ID for each credential will be the provided ID suffixed with "_$FILENAME" (e\&.g\&., @@ -3973,6 +4022,11 @@ for the details about or \fIDeviceAllow=\fR\&. .sp +Note that encrypted credentials targeted for services of the per\-user service manager must be encrypted with +\fBsystemd\-creds encrypt \-\-user\fR, and those for the system service manager without the +\fB\-\-user\fR +switch\&. Encrypted credentials are always targeted to a specific user or the system as a whole, and it is ensured that per\-user service managers cannot decrypt secrets intended for the system or for other users\&. +.sp The credential files/IPC sockets must be accessible to the service manager, but don\*(Aqt have to be directly accessible to the unit\*(Aqs processes: the credential data is read and copied into separate, read\-only copies for the unit that are accessible to appropriately privileged processes\&. This is particularly useful in combination with \fIDynamicUser=\fR as this way privileged data can be made available to processes running under a dynamic UID (i\&.e\&. not a previously known one) without having to open up access to all users\&. @@ -5547,23 +5601,7 @@ MONITOR_UNIT=mysuccess\&.service .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd-analyze\fR(1), -\fBjournalctl\fR(1), -\fBsystemd-system.conf\fR(5), -\fBsystemd.unit\fR(5), -\fBsystemd.service\fR(5), -\fBsystemd.socket\fR(5), -\fBsystemd.swap\fR(5), -\fBsystemd.mount\fR(5), -\fBsystemd.kill\fR(5), -\fBsystemd.resource-control\fR(5), -\fBsystemd.time\fR(7), -\fBsystemd.directives\fR(7), -\fBtmpfiles.d\fR(5), -\fBexec\fR(3), -\fBfork\fR(2) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-analyze\fR(1), \fBjournalctl\fR(1), \fBsystemd-system.conf\fR(5), \fBsystemd.unit\fR(5), \fBsystemd.service\fR(5), \fBsystemd.socket\fR(5), \fBsystemd.swap\fR(5), \fBsystemd.mount\fR(5), \fBsystemd.kill\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.time\fR(7), \fBsystemd.directives\fR(7), \fBtmpfiles.d\fR(5), \fBexec\fR(3), \fBfork\fR(2) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man5/systemd.kill.5 b/upstream/fedora-rawhide/man5/systemd.kill.5 index f8379e5f..57b5de8c 100644 --- a/upstream/fedora-rawhide/man5/systemd.kill.5 +++ b/upstream/fedora-rawhide/man5/systemd.kill.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.KILL" "5" "" "systemd 255" "systemd.kill" +.TH "SYSTEMD\&.KILL" "5" "" "systemd 256~rc3" "systemd.kill" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -211,15 +211,4 @@ Added in version 240\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBjournalctl\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemd.service\fR(5), -\fBsystemd.socket\fR(5), -\fBsystemd.swap\fR(5), -\fBsystemd.mount\fR(5), -\fBsystemd.exec\fR(5), -\fBsystemd.directives\fR(7), -\fBkill\fR(2), -\fBsignal\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBjournalctl\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.service\fR(5), \fBsystemd.socket\fR(5), \fBsystemd.swap\fR(5), \fBsystemd.mount\fR(5), \fBsystemd.exec\fR(5), \fBsystemd.directives\fR(7), \fBkill\fR(2), \fBsignal\fR(7) diff --git a/upstream/fedora-rawhide/man5/systemd.link.5 b/upstream/fedora-rawhide/man5/systemd.link.5 index 359f1911..63d7e08e 100644 --- a/upstream/fedora-rawhide/man5/systemd.link.5 +++ b/upstream/fedora-rawhide/man5/systemd.link.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.LINK" "5" "" "systemd 255" "systemd.link" +.TH "SYSTEMD\&.LINK" "5" "" "systemd 256~rc3" "systemd.link" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -345,6 +345,97 @@ A description of the device\&. Added in version 211\&. .RE .PP +\fIProperty=\fR +.RS 4 +Set specified udev properties\&. This takes space separated list of key\-value pairs concatenated with equal sign ("=")\&. Example: +.sp +.if n \{\ +.RS 4 +.\} +.nf +Property=HOGE=foo BAR=baz +.fi +.if n \{\ +.RE +.\} +.sp +This option supports simple specifier expansion, see the Specifiers section below\&. This option can be specified multiple times\&. If an empty string is assigned, then the all previous assignments are cleared\&. +.sp +This setting is useful to configure the +"ID_NET_MANAGED_BY=" +property which declares which network management service shall manage the interface, which is respected by systemd\-networkd and others\&. Use +.sp +.if n \{\ +.RS 4 +.\} +.nf +Property=ID_NET_MANAGED_BY=io\&.systemd\&.Network +.fi +.if n \{\ +.RE +.\} +.sp +to declare explicitly that +\fBsystemd\-networkd\fR +shall manage the interface, or set the property to something else to declare explicitly it shall not do so\&. See +\fBsystemd.network\fR(5) +for details how this property is used to match interface names\&. +.sp +Added in version 256\&. +.RE +.PP +\fIImportProperty=\fR +.RS 4 +Import specified udev properties from the saved database\&. This takes space separated list of property names\&. Example: +.sp +.if n \{\ +.RS 4 +.\} +.nf +ImportProperty=HOGE BAR +.fi +.if n \{\ +.RE +.\} +.sp +This option supports simple specifier expansion, see the Specifiers section below\&. This option can be specified multiple times\&. If an empty string is assigned, then the all previous assignments are cleared\&. +.sp +If the same property is also set in +\fIProperty=\fR +in the above, then the imported property value will be overridden by the value specified in +\fIProperty=\fR\&. +.sp +Added in version 256\&. +.RE +.PP +\fIUnsetProperty=\fR +.RS 4 +Unset specified udev properties\&. This takes space separated list of property names\&. Example: +.sp +.if n \{\ +.RS 4 +.\} +.nf +ImportProperty=HOGE BAR +.fi +.if n \{\ +.RE +.\} +.sp +This option supports simple specifier expansion, see the Specifiers section below\&. This option can be specified multiple times\&. If an empty string is assigned, then the all previous assignments are cleared\&. +.sp +This setting is applied after +\fIImportProperty=\fR +and +\fIProperty=\fR +are applied\&. Hence, if the same property is specified in +\fIImportProperty=\fR +or +\fIProperty=\fR, then the imported or specified property value will be ignored, and the property will be unset\&. +.sp +Added in version 256\&. +.RE +.PP \fIAlias=\fR .RS 4 The @@ -493,7 +584,7 @@ and "%"\&. While "\&." is an allowed character, it\*(Aqs recommended to avoid it when naming interfaces as various tools (such as -\fBresolvconf\fR(1)) use it as separator character\&. Also, fully numeric interface names are not allowed (in order to avoid ambiguity with interface specification by numeric indexes), as are the special strings +\fBresolvconf\fR(1)) use it as separator character\&. Also, fully numeric interface names are not allowed (in order to avoid ambiguity with interface specification by numeric indexes), nor are the special strings "\&.", "\&.\&.", "all" @@ -1584,6 +1675,17 @@ Takes a boolean\&. If set to true, Large Receive Offload (LRO) is enabled\&. Whe Added in version 232\&. .RE .PP +\fIReceivePacketSteeringCPUMask=\fR +.RS 4 +Configures Receive Packet Steering (RPS) list of CPUs to which RPS may forward traffic\&. Takes a list of CPU indices or ranges separated by either whitespace or commas\&. Alternatively, takes the special value +"all" +in which will include all available CPUs in the mask\&. CPU ranges are specified by the lower and upper CPU indices separated by a dash (e\&.g\&. +"2\-6")\&. This option may be specified more than once, in which case the specified CPU affinity masks are merged\&. If an empty string is assigned, the mask is reset, all assignments prior to this will have no effect\&. Defaults to unset and RPS CPU list is unchanged\&. To disable RPS when it was previously enabled, use the special value +"disable"\&. +.sp +Added in version 256\&. +.RE +.PP \fIReceiveVLANCTAGHardwareAcceleration=\fR .RS 4 Takes a boolean\&. If set to true, receive VLAN CTAG hardware acceleration is enabled\&. When unset, the kernel\*(Aqs default will be used\&. @@ -1828,6 +1930,148 @@ Specifies the MAC address for the virtual function\&. .sp Added in version 251\&. .RE +.SH "SPECIFIERS" +.PP +Some settings resolve specifiers which may be used to write generic unit files referring to runtime or unit parameters that are replaced when the unit files are loaded\&. Specifiers must be known and resolvable for the setting to be valid\&. The following specifiers are understood: +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.B Table\ \&2.\ \&Specifiers available in unit files +.TS +allbox tab(:); +lB lB lB. +T{ +Specifier +T}:T{ +Meaning +T}:T{ +Details +T} +.T& +l l l +l l l +l l l +l l l +l l l +l l l +l l l +l l l +l l l +l l l +l l l +l l l +l l l +l l l +l l l. +T{ +"%a" +T}:T{ +Architecture +T}:T{ +A short string identifying the architecture of the local system\&. A string such as \fBx86\fR, \fBx86\-64\fR or \fBarm64\fR\&. See the architectures defined for \fIConditionArchitecture=\fR in \fBsystemd.unit\fR(5) for a full list\&. +T} +T{ +"%A" +T}:T{ +Operating system image version +T}:T{ +The operating system image version identifier of the running system, as read from the \fIIMAGE_VERSION=\fR field of /etc/os\-release\&. If not set, resolves to an empty string\&. See \fBos-release\fR(5) for more information\&. +T} +T{ +"%b" +T}:T{ +Boot ID +T}:T{ +The boot ID of the running system, formatted as string\&. See \fBrandom\fR(4) for more information\&. +T} +T{ +"%B" +T}:T{ +Operating system build ID +T}:T{ +The operating system build identifier of the running system, as read from the \fIBUILD_ID=\fR field of /etc/os\-release\&. If not set, resolves to an empty string\&. See \fBos-release\fR(5) for more information\&. +T} +T{ +"%H" +T}:T{ +Host name +T}:T{ +The hostname of the running system\&. +T} +T{ +"%l" +T}:T{ +Short host name +T}:T{ +The hostname of the running system, truncated at the first dot to remove any domain component\&. +T} +T{ +"%m" +T}:T{ +Machine ID +T}:T{ +The machine ID of the running system, formatted as string\&. See \fBmachine-id\fR(5) for more information\&. +T} +T{ +"%M" +T}:T{ +Operating system image identifier +T}:T{ +The operating system image identifier of the running system, as read from the \fIIMAGE_ID=\fR field of /etc/os\-release\&. If not set, resolves to an empty string\&. See \fBos-release\fR(5) for more information\&. +T} +T{ +"%o" +T}:T{ +Operating system ID +T}:T{ +The operating system identifier of the running system, as read from the \fIID=\fR field of /etc/os\-release\&. See \fBos-release\fR(5) for more information\&. +T} +T{ +"%q" +T}:T{ +Pretty host name +T}:T{ +The pretty hostname of the running system, as read from the \fIPRETTY_HOSTNAME=\fR field of /etc/machine\-info\&. If not set, resolves to the short hostname\&. See \fBmachine-info\fR(5) for more information\&. +T} +T{ +"%T" +T}:T{ +Directory for temporary files +T}:T{ +This is either /tmp or the path "$TMPDIR", "$TEMP" or "$TMP" are set to\&. (Note that the directory may be specified without a trailing slash\&.) +T} +T{ +"%v" +T}:T{ +Kernel release +T}:T{ +Identical to \fBuname \-r\fR output\&. +T} +T{ +"%V" +T}:T{ +Directory for larger and persistent temporary files +T}:T{ +This is either /var/tmp or the path "$TMPDIR", "$TEMP" or "$TMP" are set to\&. (Note that the directory may be specified without a trailing slash\&.) +T} +T{ +"%w" +T}:T{ +Operating system version ID +T}:T{ +The operating system version identifier of the running system, as read from the \fIVERSION_ID=\fR field of /etc/os\-release\&. If not set, resolves to an empty string\&. See \fBos-release\fR(5) for more information\&. +T} +T{ +"%W" +T}:T{ +Operating system variant ID +T}:T{ +The operating system variant identifier of the running system, as read from the \fIVARIANT_ID=\fR field of /etc/os\-release\&. If not set, resolves to an empty string\&. See \fBos-release\fR(5) for more information\&. +T} +.TE +.sp 1 .SH "EXAMPLES" .PP \fBExample\ \&1.\ \&/usr/lib/systemd/network/99\-default\&.link\fR @@ -2032,11 +2276,7 @@ MACAddress=cb:a9:87:65:43:21 .\} .SH "SEE ALSO" .PP -\fBsystemd-udevd.service\fR(8), -\fBudevadm\fR(8), -\fBsystemd.netdev\fR(5), -\fBsystemd.network\fR(5), -\fBsystemd-network-generator.service\fR(8) +\fBsystemd-udevd.service\fR(8), \fBudevadm\fR(8), \fBsystemd.netdev\fR(5), \fBsystemd.network\fR(5), \fBsystemd-network-generator.service\fR(8) .SH "NOTES" .IP " 1." 4 System and Service Credentials diff --git a/upstream/fedora-rawhide/man5/systemd.mount.5 b/upstream/fedora-rawhide/man5/systemd.mount.5 index 62d7fb91..894df873 100644 --- a/upstream/fedora-rawhide/man5/systemd.mount.5 +++ b/upstream/fedora-rawhide/man5/systemd.mount.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.MOUNT" "5" "" "systemd 255" "systemd.mount" +.TH "SYSTEMD\&.MOUNT" "5" "" "systemd 256~rc3" "systemd.mount" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -104,10 +104,12 @@ If a mount unit is beneath another mount unit in the file system hierarchy, both .IP \(bu 2.3 .\} Block device backed file systems automatically gain -\fIBindsTo=\fR -and +\fIRequires=\fR, +\fIStopPropagatedFrom=\fR, and \fIAfter=\fR -type dependencies on the device unit encapsulating the block device (see below)\&. +type dependencies on the device unit encapsulating the block device (see +\fIx\-systemd\&.device\-bound=\fR +for details)\&. .RE .sp .RS 4 @@ -180,9 +182,18 @@ local\-fs\-pre\&.target, and a \fIBefore=\fR dependency on local\-fs\&.target -unless -\fBnofail\fR -mount option is set\&. +unless one or more mount options among +\fBnofail\fR, +\fBx\-systemd\&.wanted\-by=\fR, and +\fBx\-systemd\&.required\-by=\fR +is set\&. See below for detailed information\&. +.sp +Additionally, an +\fIAfter=\fR +dependency on +swap\&.target +is added when the file system type is +"tmpfs"\&. .RE .sp .RS 4 @@ -197,17 +208,19 @@ Network mount units automatically acquire \fIAfter=\fR dependencies on remote\-fs\-pre\&.target, -network\&.target +network\&.target, plus +\fIAfter=\fR and -network\-online\&.target, and gain a +\fIWants=\fR +dependencies on +network\-online\&.target, and a \fIBefore=\fR dependency on -remote\-fs\&.target -unless -\fBnofail\fR -mount option is set\&. Towards the latter a -\fIWants=\fR -unit is added as well\&. +remote\-fs\&.target, unless one or more mount options among +\fBnofail\fR, +\fBx\-systemd\&.wanted\-by=\fR, and +\fBx\-systemd\&.required\-by=\fR +is set\&. .RE .PP Mount units referring to local and network file systems are distinguished by their file system type specification\&. In some cases this is not sufficient (for example network block device based mounts, such as iSCSI), in which case @@ -312,8 +325,13 @@ In the created mount unit, configures a \fIWantedBy=\fR or \fIRequiredBy=\fR -dependency on another unit\&. This option may be specified more than once\&. If this is specified, the normal automatic dependencies on the created mount unit, e\&.g\&., -local\-fs\&.target, are not automatically created\&. See +dependency on another unit\&. This option may be specified more than once\&. If this is specified, the default dependencies (see above) other than +umount\&.target +on the created mount unit, e\&.g\&. +local\-fs\&.target, are not automatically created\&. Hence it is likely that some ordering dependencies need to be set up manually through +\fBx\-systemd\&.before=\fR +and +\fBx\-systemd\&.after=\fR\&. See \fIWantedBy=\fR and \fIRequiredBy=\fR @@ -324,12 +342,16 @@ for details\&. Added in version 245\&. .RE .PP -\fBx\-systemd\&.requires\-mounts\-for=\fR +\fBx\-systemd\&.wants\-mounts\-for=\fR, \fBx\-systemd\&.requires\-mounts\-for=\fR .RS 4 Configures a \fIRequiresMountsFor=\fR +or +\fIWantsMountsFor=\fR dependency between the created mount unit and other mount units\&. The argument must be an absolute path\&. This option may be specified more than once\&. See \fIRequiresMountsFor=\fR +or +\fIWantsMountsFor=\fR in \fBsystemd.unit\fR(5) for details\&. @@ -550,13 +572,14 @@ Mount unit files may include [Unit] and [Install] sections, which are described \fBsystemd.unit\fR(5)\&. .PP Mount unit files must include a [Mount] section, which carries information about the file system mount points it supervises\&. A number of options that may be used in this section are shared with other unit types\&. These options are documented in -\fBsystemd.exec\fR(5) +\fBsystemd.exec\fR(5), +\fBsystemd.kill\fR(5) and -\fBsystemd.kill\fR(5)\&. The options specific to the [Mount] section of mount units are the following: +\fBsystemd.resource-control\fR(5)\&. The options specific to the [Mount] section of mount units are the following: .PP \fIWhat=\fR .RS 4 -Takes an absolute path of a device node, file or other resource to mount\&. See +Takes an absolute path or a fstab\-style identifier of a device node, file or other resource to mount\&. See \fBmount\fR(8) for details\&. If this refers to a device node, a dependency on the respective device unit is automatically created\&. (See \fBsystemd.device\fR(5) @@ -574,6 +597,13 @@ Takes an absolute path of a file or directory for the mount point; in particular Takes a string for the file system type\&. See \fBmount\fR(8) for details\&. This setting is optional\&. +.sp +If the type is +"overlay", and +"upperdir=" +or +"workdir=" +are specified as options and they don\*(Aqt exist, they will be created\&. .RE .PP \fIOptions=\fR @@ -649,20 +679,7 @@ Check for more settings\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd-system.conf\fR(5), -\fBsystemd.unit\fR(5), -\fBsystemd.exec\fR(5), -\fBsystemd.kill\fR(5), -\fBsystemd.resource-control\fR(5), -\fBsystemd.service\fR(5), -\fBsystemd.device\fR(5), -\fBproc\fR(5), -\fBmount\fR(8), -\fBsystemd-fstab-generator\fR(8), -\fBsystemd.directives\fR(7), -\fBsystemd-mount\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-system.conf\fR(5), \fBsystemd.unit\fR(5), \fBsystemd.exec\fR(5), \fBsystemd.kill\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.service\fR(5), \fBsystemd.device\fR(5), \fBproc\fR(5), \fBmount\fR(8), \fBsystemd-fstab-generator\fR(8), \fBsystemd.directives\fR(7), \fBsystemd-mount\fR(1) .SH "NOTES" .IP " 1." 4 API File Systems diff --git a/upstream/fedora-rawhide/man5/systemd.netdev.5 b/upstream/fedora-rawhide/man5/systemd.netdev.5 index 4cbedb2f..6343ec31 100644 --- a/upstream/fedora-rawhide/man5/systemd.netdev.5 +++ b/upstream/fedora-rawhide/man5/systemd.netdev.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.NETDEV" "5" "" "systemd 255" "systemd.network" +.TH "SYSTEMD\&.NETDEV" "5" "" "systemd 256~rc3" "systemd.network" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -670,6 +670,16 @@ Specifies the length of the receive queue for broadcast/multicast packets\&. An .sp Added in version 248\&. .RE +.PP +\fIBroadcastQueueThreshold=\fR +.RS 4 +Controls the threshold for broadcast queueing of the macvlan device\&. Takes the special value +"no", or an integer in the range 0\&...2147483647\&. When +"no" +is specified, the broadcast queueing is disabled altogether\&. When an integer is specified, a multicast address will be queued as broadcast if the number of devices using it is greater than the given value\&. Defaults to unset, and the kernel default will be used\&. +.sp +Added in version 256\&. +.RE .SH "[MACVTAP] SECTION OPTIONS" .PP The [MACVTAP] section applies for netdevs of kind @@ -1734,9 +1744,19 @@ The [WireGuard] section accepts the following keys: The Base64 encoded private key for the interface\&. It can be generated using the \fBwg genkey\fR command (see -\fBwg\fR(8))\&. This option or -\fIPrivateKeyFile=\fR -is mandatory to use WireGuard\&. Note that because this information is secret, you may want to set the permissions of the \&.netdev file to be owned by +\fBwg\fR(8))\&. Specially, if the specified key is prefixed with +"@", it is interpreted as the name of the credential from which the actual key shall be read\&. +\fBsystemd\-networkd\&.service\fR +automatically imports credentials matching +"network\&.wireguard\&.*"\&. For more details on credentials, refer to +\fBsystemd.exec\fR(5)\&. A private key is mandatory to use WireGuard\&. If not set, the credential +"network\&.wireguard\&.private\&.\fInetdev\fR" +is used if exists\&. I\&.e\&. for +50\-foobar\&.netdev, +"network\&.wireguard\&.private\&.50\-foobar" +is tried\&. +.sp +Note that because this information is secret, it\*(Aqs strongly recommended to use an (encrypted) credential\&. Alternatively, you may want to set the permissions of the \&.netdev file to be owned by "root:systemd\-network" with a "0640" @@ -1813,7 +1833,13 @@ The [WireGuardPeer] section accepts the following keys: Sets a Base64 encoded public key calculated by \fBwg pubkey\fR (see -\fBwg\fR(8)) from a private key, and usually transmitted out of band to the author of the configuration file\&. This option is mandatory for this section\&. +\fBwg\fR(8)) from a private key, and usually transmitted out of band to the author of the configuration file\&. This option honors the +"@" +prefix in the same way as the +\fBPrivateKey=\fR +setting of the +\fB[WireGuard]\fR +section\&. This option is mandatory for this section\&. .sp Added in version 237\&. .RE @@ -1822,7 +1848,15 @@ Added in version 237\&. .RS 4 Optional preshared key for the interface\&. It can be generated by the \fBwg genpsk\fR -command\&. This option adds an additional layer of symmetric\-key cryptography to be mixed into the already existing public\-key cryptography, for post\-quantum resistance\&. Note that because this information is secret, you may want to set the permissions of the \&.netdev file to be owned by +command\&. This option adds an additional layer of symmetric\-key cryptography to be mixed into the already existing public\-key cryptography, for post\-quantum resistance\&. This option honors the +"@" +prefix in the same way as the +\fBPrivateKey=\fR +setting of the +\fB[WireGuard]\fR +section\&. +.sp +Note that because this information is secret, it\*(Aqs strongly recommended to use an (encrypted) credential\&. Alternatively, you may want to set the permissions of the \&.netdev file to be owned by "root:systemd\-network" with a "0640" @@ -1872,6 +1906,14 @@ for IPv4 and "[1111:2222::3333]:51820" for IPv6 address\&. This endpoint will be updated automatically once to the most recent source IP address and port of correctly authenticated packets from the peer at configuration time\&. .sp +This option honors the +"@" +prefix in the same way as the +\fBPrivateKey=\fR +setting of the +\fB[WireGuard]\fR +section\&. +.sp Added in version 237\&. .RE .PP @@ -1952,6 +1994,14 @@ Specifies the frequency that Media Independent Interface link monitoring will oc Added in version 216\&. .RE .PP +\fIPeerNotifyDelaySec=\fR +.RS 4 +Specifies the number of seconds the delay between each peer notification (gratuitous ARP and unsolicited IPv6 Neighbor Advertisement) when they are issued after a failover event\&. This delay should be a multiple of the MII link monitor interval (miimon)\&. The valid range is 0\&.\&.\&.300s\&. The default value is 0, which means to match the value of the +\fIMIIMonitorSec=\fR\&. +.sp +Added in version 256\&. +.RE +.PP \fIUpDelaySec=\fR .RS 4 Specifies the delay before a link is enabled after a link up status has been detected\&. This value is rounded down to a multiple of @@ -2111,6 +2161,13 @@ Specifies the minimum number of links that must be active before asserting carri Added in version 220\&. .RE .PP +\fIARPMissedMax=\fR +.RS 4 +Specify the maximum number of arp interval monitor cycle for missed ARP replies\&. If this number is exceeded, link is reported as down\&. Defaults to unset\&. +.sp +Added in version 256\&. +.RE +.PP For more detail information see \m[blue]\fBLinux Ethernet Bonding Driver HOWTO\fR\m[]\&\s-2\u[1]\d\s+2 .SH "[XFRM] SECTION OPTIONS" @@ -2648,11 +2705,7 @@ Independent=yes .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-networkd\fR(8), -\fBsystemd.link\fR(5), -\fBsystemd.network\fR(5), -\fBsystemd-network-generator.service\fR(8) +\fBsystemd\fR(1), \fBsystemd-networkd\fR(8), \fBsystemd.link\fR(5), \fBsystemd.network\fR(5), \fBsystemd-network-generator.service\fR(8) .SH "NOTES" .IP " 1." 4 Linux Ethernet Bonding Driver HOWTO diff --git a/upstream/fedora-rawhide/man5/systemd.network.5 b/upstream/fedora-rawhide/man5/systemd.network.5 index 49b3eb68..5238454e 100644 --- a/upstream/fedora-rawhide/man5/systemd.network.5 +++ b/upstream/fedora-rawhide/man5/systemd.network.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.NETWORK" "5" "" "systemd 255" "systemd.network" +.TH "SYSTEMD\&.NETWORK" "5" "" "systemd 256~rc3" "systemd.network" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -447,14 +447,16 @@ Added in version 246\&. .PP \fIRequiredForOnline=\fR .RS 4 -Takes a boolean or a minimum operational state and an optional maximum operational state\&. Please see +Takes a boolean, a minimum operational state (e\&.g\&., +"carrier"), or a range of operational state separated with a colon (e\&.g\&., +"degraded:routable")\&. Please see \fBnetworkctl\fR(1) for possible operational states\&. When "yes", the network is deemed required when determining whether the system is online (including when running \fBsystemd\-networkd\-wait\-online\fR)\&. When "no", the network is ignored when determining the online state\&. When a minimum operational state and an optional maximum operational state are set, -"yes" -is implied, and this controls the minimum and maximum operational state required for the network interface to be considered online\&. +\fBsystemd\-networkd\-wait\-online\fR +deems that the interface is online when the operational state is in the specified range\&. .sp Defaults to "yes" @@ -483,6 +485,45 @@ The network will be brought up normally (as configured by if "RequiredForOnline=no"\&. .sp +The boolean value +"yes" +is translated as follows; +.PP +\fBCAN devices\fR +.RS 4 +"carrier", +.sp +Added in version 256\&. +.RE +.PP +\fBMaster devices, e\&.g\&. bond or bridge\fR +.RS 4 +"degraded\-carrier" +with +\fIRequiredFamilyForOnline=any\fR, +.sp +Added in version 256\&. +.RE +.PP +\fBBonding port interfaces\fR +.RS 4 +"enslaved", +.sp +Added in version 256\&. +.RE +.PP +\fBOther interfaces\fR +.RS 4 +"degraded"\&. +.sp +Added in version 236\&. +.RE +.sp +This setting can be overridden by the command line option for +\fBsystemd\-networkd\-wait\-online\fR\&. See +\fBsystemd-networkd-wait-online.service\fR(8) +for more details\&. +.sp Added in version 236\&. .RE .PP @@ -494,11 +535,8 @@ Takes an address family\&. When specified, an IP address in the given family is "ipv6", "both", or "any"\&. Defaults to -"any"\&. Note that this option has no effect if -"RequiredForOnline=no", or if -"RequiredForOnline=" -specifies a minimum operational state below -"degraded"\&. +"no"\&. Note that this option has no effect if +"RequiredForOnline=no"\&. .sp Added in version 249\&. .RE @@ -686,14 +724,23 @@ Takes a boolean\&. If set to "yes", DHCPv4 server will be started\&. Defaults to "no"\&. Further settings for the DHCP server may be set in the [DHCPServer] section described below\&. .sp +Even if this is enabled, the DHCP server will not be started automatically and wait for the persistent storage being ready to load/save leases in the storage, unless +\fIRelayTarget=\fR +or +\fIPersistLeases=no\fR +are specified in the [DHCPServer] section\&. It will be started after +systemd\-networkd\-persistent\-storage\&.service +is started, which calls +\fBnetworkctl persistent\-storage yes\fR\&. See +\fBnetworkctl\fR(1) +for more details\&. +.sp Added in version 215\&. .RE .PP \fILinkLocalAddressing=\fR .RS 4 -Enables link\-local address autoconfiguration\&. Accepts -\fByes\fR, -\fBno\fR, +Enables link\-local address autoconfiguration\&. Accepts a boolean, \fBipv4\fR, and \fBipv6\fR\&. An IPv6 link\-local address is configured when \fByes\fR @@ -963,6 +1010,8 @@ If the specified address is "::" (for IPv6), a new address range of the requested size is automatically allocated from a system\-wide pool of unused ranges\&. Note that the prefix length must be equal or larger than 8 for IPv4, and 64 for IPv6\&. The allocated range is checked against all current network interfaces and all known network configuration files to avoid address range conflicts\&. The default system\-wide pool consists of 192\&.168\&.0\&.0/16, 172\&.16\&.0\&.0/12 and 10\&.0\&.0\&.0/8 for IPv4, and fd00::/8 for IPv6\&. This functionality is useful to manage a large number of dynamically created network interfaces with the same network configuration and automatic address range assignment\&. .sp +If an empty string is specified, then the all previous assignments in both [Network] and [Address] sections are cleared\&. +.sp Added in version 211\&. .RE .PP @@ -992,6 +1041,14 @@ for IPv6\&. If an empty string is assigned, then the all previous assignments ar Added in version 211\&. .RE .PP +\fIUseDomains=\fR +.RS 4 +Specifies the protocol\-independent default value for the same settings in [IPv6AcceptRA], [DHCPv4], and [DHCPv6] sections below\&. Takes a boolean, or the special value +\fBroute\fR\&. See also the same setting in [DHCPv4] below\&. Defaults to unset\&. +.sp +Added in version 256\&. +.RE +.PP \fIDomains=\fR .RS 4 A whitespace\-separated list of domains which should be resolved using the DNS servers on this link\&. Each item in the list should be a domain name, optionally prefixed with a tilde ("~")\&. The domains with the prefix are called "routing\-only domains"\&. The domains without the prefix are called "search domains" and are first used as search suffixes for extending single\-label hostnames (hostnames containing no dots) to become fully qualified domain names (FQDNs)\&. If a single\-label hostname is resolved on this interface, each of the specified search domains are appended to it in turn, converting it into a fully qualified domain name, until one of them may be successfully resolved\&. @@ -1030,25 +1087,42 @@ An NTP server address (either an IP address, or a hostname)\&. This option may b Added in version 216\&. .RE .PP -\fIIPForward=\fR +\fIIPv4Forwarding=\fR .RS 4 -Configures IP packet forwarding for the system\&. If enabled, incoming packets on any network interface will be forwarded to any other interfaces according to the routing table\&. Takes a boolean, or the values -"ipv4" -or -"ipv6", which only enable IP packet forwarding for the specified address family\&. This controls the -net\&.ipv4\&.ip_forward -and -net\&.ipv6\&.conf\&.all\&.forwarding -sysctl options of the network interface (see +Configures IPv4 packet forwarding for the interface\&. Takes a boolean value\&. This controls the +net\&.ipv4\&.conf\&.\fIINTERFACE\fR\&.forwarding +sysctl option of the network interface\&. See \m[blue]\fBIP Sysctl\fR\m[]\&\s-2\u[7]\d\s+2 -for details about sysctl options)\&. Defaults to -"no"\&. +for more details about the sysctl option\&. Defaults to true if +\fIIPMasquerade=\fR +is enabled for IPv4, otherwise the value specified to the same setting in +\fBnetworkd.conf\fR(5) +will be used\&. If none of them are specified, the sysctl option will not be changed\&. .sp -Note: this setting controls a global kernel option, and does so one way only: if a network that has this setting enabled is set up the global setting is turned on\&. However, it is never turned off again, even after all networks with this setting enabled are shut down again\&. +To control the global setting, use the same setting in +\fBnetworkd.conf\fR(5)\&. .sp -To allow IP packet forwarding only between specific network interfaces use a firewall\&. +Added in version 256\&. +.RE +.PP +\fIIPv6Forwarding=\fR +.RS 4 +Configures IPv6 packet forwarding for the interface\&. Takes a boolean value\&. This controls the +net\&.ipv6\&.conf\&.\fIINTERFACE\fR\&.forwarding +sysctl option of the network interface\&. See +\m[blue]\fBIP Sysctl\fR\m[]\&\s-2\u[7]\d\s+2 +for more details about the sysctl option\&. Defaults to true if +\fIIPMasquerade=\fR +is enabled for IPv6 or +\fIIPv6SendRA=\fR +is enabled, otherwise the value specified to the same setting in +\fBnetworkd.conf\fR(5) +will be used\&. If none of them are specified, the sysctl option will not be changed\&. .sp -Added in version 219\&. +To control the global setting, use the same setting in +\fBnetworkd.conf\fR(5)\&. +.sp +Added in version 256\&. .RE .PP \fIIPMasquerade=\fR @@ -1058,19 +1132,13 @@ Configures IP masquerading for the network interface\&. If enabled, packets forw "ipv6", "both", or "no"\&. Defaults to -"no"\&. If enabled, this automatically sets -\fIIPForward=\fR -to one of -"ipv4", -"ipv6" -or -"yes"\&. +"no"\&. .sp Note\&. Any positive boolean values such as "yes" or "true" -are now deprecated\&. Please use one of the values in the above\&. +are now deprecated\&. Please use one of the values above\&. .sp Added in version 219\&. .RE @@ -1092,7 +1160,11 @@ Added in version 222\&. .PP \fIIPv6AcceptRA=\fR .RS 4 -Takes a boolean\&. Controls IPv6 Router Advertisement (RA) reception support for the interface\&. If true, RAs are accepted; if false, RAs are ignored\&. When RAs are accepted, they may trigger the start of the DHCPv6 client if the relevant flags are set in the RA data, or if no routers are found on the link\&. The default is to disable RA reception for bridge devices or when IP forwarding is enabled, and to enable it otherwise\&. Cannot be enabled on devices aggregated in a bond device or when link\-local addressing is disabled\&. +Takes a boolean\&. Controls IPv6 Router Advertisement (RA) reception support for the interface\&. If true, RAs are accepted; if false, RAs are ignored\&. When RAs are accepted, they may trigger the start of the DHCPv6 client if the relevant flags are set in the RA data, or if no routers are found on the link\&. Defaults to false for bridge devices, when IP forwarding is enabled, +\fIIPv6SendRA=\fR +or +\fIKeepMaster=\fR +is enabled\&. Otherwise, enabled by default\&. Cannot be enabled on devices aggregated in a bond device or when link\-local addressing is disabled\&. .sp Further settings for the IPv6 RA support may be configured in the [IPv6AcceptRA] section, see below\&. .sp @@ -1125,6 +1197,13 @@ Configures IPv6 Hop Limit\&. Takes an integer in the range 1\&...255\&. For each Added in version 228\&. .RE .PP +\fIIPv6RetransmissionTimeSec=\fR +.RS 4 +Configures IPv6 Retransmission Time\&. The time between retransmitted Neighbor Solicitation messages\&. Used by address resolution and the Neighbor Unreachability Detection algorithm\&. A value of zero is ignored and the kernel\*(Aqs current value will be used\&. Defaults to unset, and the kernel\*(Aqs current value will be used\&. +.sp +Added in version 256\&. +.RE +.PP \fIIPv4ReversePathFilter=\fR .RS 4 Configure IPv4 Reverse Path Filtering\&. If enabled, when an IPv4 packet is received, the machine will first check whether the @@ -1163,6 +1242,18 @@ Takes a boolean\&. Configures proxy ARP for IPv4\&. Proxy ARP is the technique i Added in version 233\&. .RE .PP +\fIIPv4ProxyARPPrivateVLAN=\fR +.RS 4 +Takes a boolean\&. Configures proxy ARP private VLAN for IPv4, also known as VLAN aggregation, private VLAN, source\-port filtering, port\-isolation, or MAC\-forced forwarding\&. +.sp +This variant of the ARP proxy technique will allow the ARP proxy to reply back to the same interface\&. +.sp +See +\m[blue]\fBRFC 3069\fR\m[]\&\s-2\u[10]\d\s+2\&. When unset, the kernel\*(Aqs default will be used\&. +.sp +Added in version 256\&. +.RE +.PP \fIIPv6ProxyNDP=\fR .RS 4 Takes a boolean\&. Configures proxy NDP for IPv6\&. Proxy NDP (Neighbor Discovery Protocol) is a technique for IPv6 to allow routing of addresses to a different destination when peers expect them to be present on a certain physical link\&. In this case a router answers Neighbour Advertisement messages intended for another machine by offering its own MAC address as destination\&. Unlike proxy ARP for IPv4, it is not enabled globally, but will only send Neighbour Advertisement messages for addresses in the IPv6 neighbor proxy table, which can also be shown by @@ -1445,7 +1536,7 @@ Added in version 246\&. \fIHomeAddress=\fR .RS 4 Takes a boolean\&. Designates this address the "home address" as defined in -\m[blue]\fBRFC 6275\fR\m[]\&\s-2\u[10]\d\s+2\&. Supported only on IPv6\&. Defaults to false\&. +\m[blue]\fBRFC 6275\fR\m[]\&\s-2\u[11]\d\s+2\&. Supported only on IPv6\&. Defaults to false\&. .sp Added in version 232\&. .RE @@ -1458,9 +1549,9 @@ Takes one of "both", or "none"\&. When "ipv4", performs IPv4 Address Conflict Detection\&. See -\m[blue]\fBRFC 5227\fR\m[]\&\s-2\u[11]\d\s+2\&. When +\m[blue]\fBRFC 5227\fR\m[]\&\s-2\u[12]\d\s+2\&. When "ipv6", performs IPv6 Duplicate Address Detection\&. See -\m[blue]\fBRFC 4862\fR\m[]\&\s-2\u[12]\d\s+2\&. Defaults to +\m[blue]\fBRFC 4862\fR\m[]\&\s-2\u[13]\d\s+2\&. Defaults to "ipv4" for IPv4 link\-local addresses, "ipv6" @@ -1474,7 +1565,7 @@ Added in version 232\&. \fIManageTemporaryAddress=\fR .RS 4 Takes a boolean\&. If true the kernel manage temporary addresses created from this one as template on behalf of Privacy Extensions -\m[blue]\fBRFC 3041\fR\m[]\&\s-2\u[13]\d\s+2\&. For this to become active, the use_tempaddr sysctl setting has to be set to a value greater than zero\&. The given address needs to have a prefix length of 64\&. This flag allows using privacy extensions in a manually configured network, just like if stateless auto\-configuration was active\&. Defaults to false\&. +\m[blue]\fBRFC 3041\fR\m[]\&\s-2\u[14]\d\s+2\&. For this to become active, the use_tempaddr sysctl setting has to be set to a value greater than zero\&. The given address needs to have a prefix length of 64\&. This flag allows using privacy extensions in a manually configured network, just like if stateless auto\-configuration was active\&. Defaults to false\&. .sp Added in version 232\&. .RE @@ -1505,22 +1596,34 @@ Added in version 232\&. \fINetLabel=\fR\fIlabel\fR .RS 4 This setting provides a method for integrating static and dynamic network configuration into Linux -\m[blue]\fBNetLabel\fR\m[]\&\s-2\u[14]\d\s+2 +\m[blue]\fBNetLabel\fR\m[]\&\s-2\u[15]\d\s+2 subsystem rules, used by -\m[blue]\fBLinux Security Modules (LSMs)\fR\m[]\&\s-2\u[15]\d\s+2 +\m[blue]\fBLinux Security Modules (LSMs)\fR\m[]\&\s-2\u[16]\d\s+2 for network access control\&. The label, with suitable LSM rules, can be used to control connectivity of (for example) a service with peers in the local network\&. At least with SELinux, only the ingress can be controlled but not egress\&. The benefit of using this setting is that it may be possible to apply interface independent part of NetLabel configuration at very early stage of system boot sequence, at the time when the network interfaces are not available yet, with \fBnetlabelctl\fR(8), and the per\-interface configuration with \fBsystemd\-networkd\fR once the interfaces appear later\&. Currently this feature is only implemented for SELinux\&. .sp The option expects a single NetLabel label\&. The label must conform to lexical restrictions of LSM labels\&. When an interface is configured with IP addresses, the addresses and subnetwork masks will be appended to the -\m[blue]\fBNetLabel Fallback Peer Labeling\fR\m[]\&\s-2\u[16]\d\s+2 +\m[blue]\fBNetLabel Fallback Peer Labeling\fR\m[]\&\s-2\u[17]\d\s+2 rules\&. They will be removed when the interface is deconfigured\&. Failures to manage the labels will be ignored\&. +.if n \{\ .sp -Warning: Once labeling is enabled for network traffic, a lot of LSM access control points in Linux networking stack go from dormant to active\&. Care should be taken to avoid getting into a situation where for example remote connectivity is broken, when the security policy hasn\*(Aqt been updated to consider LSM per\-packet access controls and no rules would allow any network traffic\&. Also note that additional configuration with +.\} +.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 +Once labeling is enabled for network traffic, a lot of LSM access control points in Linux networking stack go from dormant to active\&. Care should be taken to avoid getting into a situation where for example remote connectivity is broken, when the security policy hasn\*(Aqt been updated to consider LSM per\-packet access controls and no rules would allow any network traffic\&. Also note that additional configuration with \fBnetlabelctl\fR(8) is needed\&. -.sp +.sp .5v +.RE Example: .sp .if n \{\ @@ -1577,7 +1680,7 @@ Added in version 252\&. \fINFTSet=\fR\fIsource\fR:\fIfamily\fR:\fItable\fR:\fIset\fR .RS 4 This setting provides a method for integrating network configuration into firewall rules with -\m[blue]\fBNFT\fR\m[]\&\s-2\u[17]\d\s+2 +\m[blue]\fBNFT\fR\m[]\&\s-2\u[18]\d\s+2 sets\&. The benefit of using the setting is that static network configuration (or dynamically obtained network addresses, see similar directives in other sections) can be used in firewall rules with the indirection of NFT set types\&. For example, access could be granted for hosts in the local subnetwork only\&. Firewall rules using IP address of an interface are also instantly updated when the network configuration changes, for example via DHCP\&. .sp This option expects a whitespace separated list of NFT set definitions\&. Each definition consists of a colon\-separated tuple of source type (one of @@ -1698,7 +1801,7 @@ Added in version 243\&. .SH "[IPV6ADDRESSLABEL] SECTION OPTIONS" .PP An [IPv6AddressLabel] section accepts the following keys\&. Specify several [IPv6AddressLabel] sections to configure several address labels\&. IPv6 address labels are used for address selection\&. See -\m[blue]\fBRFC 3484\fR\m[]\&\s-2\u[18]\d\s+2\&. Precedence is managed by userspace, and only the label itself is stored in the kernel\&. +\m[blue]\fBRFC 3484\fR\m[]\&\s-2\u[19]\d\s+2\&. Precedence is managed by userspace, and only the label itself is stored in the kernel\&. .PP \fILabel=\fR .RS 4 @@ -1722,9 +1825,9 @@ An [RoutingPolicyRule] section accepts the following settings\&. Specify several \fITypeOfService=\fR .RS 4 This specifies the Type of Service (ToS) field of packets to match; it takes an unsigned integer in the range 0\&...255\&. The field can be used to specify precedence (the first 3 bits) and ToS (the next 3 bits)\&. The field can be also used to specify Differentiated Services Code Point (DSCP) (the first 6 bits) and Explicit Congestion Notification (ECN) (the last 2 bits)\&. See -\m[blue]\fBType of Service\fR\m[]\&\s-2\u[19]\d\s+2 +\m[blue]\fBType of Service\fR\m[]\&\s-2\u[20]\d\s+2 and -\m[blue]\fBDifferentiated services\fR\m[]\&\s-2\u[20]\d\s+2 +\m[blue]\fBDifferentiated services\fR\m[]\&\s-2\u[21]\d\s+2 for more details\&. .sp Added in version 235\&. @@ -1789,6 +1892,14 @@ Specifies the outgoing device to match\&. The outgoing interface is only availab Added in version 236\&. .RE .PP +\fIL3MasterDevice=\fR +.RS 4 +A boolean\&. Specifies whether the rule is to direct lookups to the tables associated with level 3 master devices (also known as Virtual Routing and Forwarding or VRF devices)\&. For further details see +\m[blue]\fBVirtual Routing and Forwarding (VRF)\fR\m[]\&\s-2\u[22]\d\s+2\&. Defaults to false\&. +.sp +Added in version 256\&. +.RE +.PP \fISourcePort=\fR .RS 4 Specifies the source IP port or IP port range match in forwarding information base (FIB) rules\&. A port range is specified by the lower and upper port separated by a dash\&. Defaults to unset\&. @@ -1890,7 +2001,10 @@ The [NextHop] section is used to manipulate entries in the kernel\*(Aqs "nexthop .PP \fIId=\fR .RS 4 -The id of the next hop\&. Takes an integer in the range 1\&...4294967295\&. If unspecified, then automatically chosen by kernel\&. +The id of the next hop\&. Takes an integer in the range 1\&...4294967295\&. This is mandatory if +\fIManageForeignNextHops=no\fR +is specified in +\fBnetworkd.conf\fR(5)\&. Otherwise, if unspecified, an unused ID will be automatically picked\&. .sp Added in version 244\&. .RE @@ -1993,7 +2107,7 @@ Added in version 216\&. \fIIPv6Preference=\fR .RS 4 Specifies the route preference as defined in -\m[blue]\fBRFC 4191\fR\m[]\&\s-2\u[21]\d\s+2 +\m[blue]\fBRFC 4191\fR\m[]\&\s-2\u[23]\d\s+2 for Router Discovery messages\&. Which can be one of "low" the route has a lowest priority, @@ -2121,7 +2235,9 @@ is "nat", then "local" is used\&. In other cases, defaults to -"main"\&. +"main"\&. Ignored if +\fIL3MasterDevice=\fR +is true\&. .sp Added in version 230\&. .RE @@ -2200,13 +2316,6 @@ Takes a boolean\&. When true enables TCP fastopen without a cookie on a per\-rou Added in version 243\&. .RE .PP -\fITTLPropagate=\fR -.RS 4 -Takes a boolean\&. When true enables TTL propagation at Label Switched Path (LSP) egress\&. When unset, the kernel\*(Aqs default will be used\&. -.sp -Added in version 243\&. -.RE -.PP \fIMTUBytes=\fR .RS 4 The maximum transmission unit in bytes to set for the route\&. The usual suffixes K, M, G, are supported and are understood to the base of 1024\&. @@ -2283,7 +2392,7 @@ Added in version 223\&. \fIMUDURL=\fR .RS 4 When configured, the specified Manufacturer Usage Description (MUD) URL will be sent to the DHCPv4 server\&. Takes a URL of length up to 255 characters\&. A superficial verification that the string is a valid URL will be performed\&. DHCPv4 clients are intended to have at most one MUD URL associated with them\&. See -\m[blue]\fBRFC 8520\fR\m[]\&\s-2\u[22]\d\s+2\&. +\m[blue]\fBRFC 8520\fR\m[]\&\s-2\u[24]\d\s+2\&. .sp MUD is an embedded software standard defined by the IETF that allows IoT device makers to advertise device specifications, including the intended communication patterns for their device when it connects to the network\&. The network can then use this to author a context\-specific access policy, so the device functions only within those parameters\&. .sp @@ -2353,7 +2462,7 @@ Added in version 230\&. \fIRapidCommit=\fR .RS 4 Takes a boolean\&. The DHCPv4 client can obtain configuration parameters from a DHCPv4 server through a rapid two\-message exchange (discover and ack)\&. When the rapid commit option is set by both the DHCPv4 client and the DHCPv4 server, the two\-message exchange is used\&. Otherwise, the four\-message exchange (discover, offer, request, and ack) is used\&. The two\-message exchange provides faster client configuration\&. See -\m[blue]\fBRFC 4039\fR\m[]\&\s-2\u[23]\d\s+2 +\m[blue]\fBRFC 4039\fR\m[]\&\s-2\u[25]\d\s+2 for details\&. Defaults to true when \fIAnonymize=no\fR and neither @@ -2368,7 +2477,7 @@ Added in version 255\&. \fIAnonymize=\fR .RS 4 Takes a boolean\&. When true, the options sent to the DHCP server will follow the -\m[blue]\fBRFC 7844\fR\m[]\&\s-2\u[24]\d\s+2 +\m[blue]\fBRFC 7844\fR\m[]\&\s-2\u[26]\d\s+2 (Anonymity Profiles for DHCP Clients) to minimize disclosure of identifying information\&. Defaults to false\&. .sp This option should only be set to true when @@ -2391,7 +2500,7 @@ When true, are implied and these settings in the \&.network file are silently ignored\&. Also, \fIHostname=\fR, \fIMUDURL=\fR, -\fIRequestAddress\fR, +\fIRequestAddress=\fR, \fIRequestOptions=\fR, \fISendOption=\fR, \fISendVendorOption=\fR, @@ -2419,7 +2528,7 @@ Send an arbitrary raw option in the DHCPv4 request\&. Takes a DHCP option number "uint32", "ipv4address", or "string"\&. Special characters in the data string may be escaped using -\m[blue]\fBC\-style escapes\fR\m[]\&\s-2\u[25]\d\s+2\&. This setting can be specified multiple times\&. If an empty string is specified, then all options specified earlier are cleared\&. Defaults to unset\&. +\m[blue]\fBC\-style escapes\fR\m[]\&\s-2\u[27]\d\s+2\&. This setting can be specified multiple times\&. If an empty string is specified, then all options specified earlier are cleared\&. Defaults to unset\&. .sp Added in version 244\&. .RE @@ -2432,7 +2541,7 @@ Send an arbitrary vendor option in the DHCPv4 request\&. Takes a DHCP option num "uint32", "ipv4address", or "string"\&. Special characters in the data string may be escaped using -\m[blue]\fBC\-style escapes\fR\m[]\&\s-2\u[25]\d\s+2\&. This setting can be specified multiple times\&. If an empty string is specified, then all options specified earlier are cleared\&. Defaults to unset\&. +\m[blue]\fBC\-style escapes\fR\m[]\&\s-2\u[27]\d\s+2\&. This setting can be specified multiple times\&. If an empty string is specified, then all options specified earlier are cleared\&. Defaults to unset\&. .sp Added in version 246\&. .RE @@ -2560,7 +2669,14 @@ setting\&. If set to \fBroute\fR, the domain name received from the DHCP server will be used for routing DNS queries only, but not for searching, similarly to the effect of the \fBDomains=\fR setting when the argument is prefixed with -"~"\&. Defaults to false\&. +"~"\&. +.sp +When unspecified, the value specified in the same setting in the [Network] section will be used\&. When it is unspecified, the value specified in the same setting in the [DHCPv4] section in +\fBnetworkd.conf\fR(5) +will be used\&. When it is unspecified, the value specified in the same setting in the [Network] section in +\fBnetworkd.conf\fR(5) +will be used\&. When none of them are specified, defaults to +"no"\&. .sp It is recommended to enable this option only on trusted networks, as setting this affects resolution of all hostnames, in particular of single\-label names\&. It is generally safer to use the supplied domain only as routing domain, rather than as search domain, in order to not have it affect local resolution of single\-label names\&. .sp @@ -2647,7 +2763,7 @@ will be used\&. Note, when the server provides both the Router and Classless Static Routes option, and \fIUseRoutes=\fR is enabled, the Router option is always ignored regardless of this setting\&. See -\m[blue]\fBRFC 3442\fR\m[]\&\s-2\u[26]\d\s+2\&. +\m[blue]\fBRFC 3442\fR\m[]\&\s-2\u[28]\d\s+2\&. .sp Added in version 246\&. .RE @@ -2665,7 +2781,7 @@ When true, subnets of the received IPv6 prefix are assigned to downstream interf \fIDHCPPrefixDelegation=\fR\&. See also \fIDHCPPrefixDelegation=\fR in the [Network] section, the [DHCPPrefixDelegation] section, and -\m[blue]\fBRFC 5969\fR\m[]\&\s-2\u[27]\d\s+2\&. Defaults to false\&. +\m[blue]\fBRFC 5969\fR\m[]\&\s-2\u[29]\d\s+2\&. Defaults to false\&. .sp Added in version 250\&. .RE @@ -2673,10 +2789,7 @@ Added in version 250\&. \fIIPv6OnlyMode=\fR .RS 4 When true, the DHCPv4 configuration will be delayed by the timespan provided by the DHCP server and skip to configure dynamic IPv4 network connectivity if IPv6 connectivity is provided within the timespan\&. See -\m[blue]\fBRFC 8925\fR\m[]\&\s-2\u[28]\d\s+2\&. Defaults to true when -\fIIPv6AcceptRA=\fR -is enabled or DHCPv6 client is enabled (i\&.e\&., -\fIDHCP=yes\fR), and false otherwise\&. +\m[blue]\fBRFC 8925\fR\m[]\&\s-2\u[30]\d\s+2\&. Defaults to false\&. .sp Added in version 255\&. .RE @@ -2714,6 +2827,13 @@ Set the port from which the DHCP client packets originate\&. Added in version 233\&. .RE .PP +\fIServerPort=\fR +.RS 4 +Set the port on which the DHCP server is listening\&. +.sp +Added in version 256\&. +.RE +.PP \fIDenyList=\fR .RS 4 A whitespace\-separated list of IPv4 addresses\&. Each address can optionally take a prefix length after @@ -2723,7 +2843,7 @@ is configured then \fIDenyList=\fR is ignored\&. .sp -Note that this filters only DHCP offers, so the filtering may not work when +Note that this filters only DHCP offers, so the filtering might not work when \fIRapidCommit=\fR is enabled\&. See also \fIRapidCommit=\fR @@ -2737,7 +2857,7 @@ Added in version 246\&. A whitespace\-separated list of IPv4 addresses\&. Each address can optionally take a prefix length after "/"\&. DHCP offers from servers in the list are accepted\&. .sp -Note that this filters only DHCP offers, so the filtering may not work when +Note that this filters only DHCP offers, so the filtering might not work when \fIRapidCommit=\fR is enabled\&. See also \fIRapidCommit=\fR @@ -2760,7 +2880,7 @@ A boolean\&. When true, performs IPv4 Duplicate Address Detection to the acquired address by the DHCPv4 client\&. If duplicate is detected, the DHCPv4 client rejects the address by sending a \fBDHCPDECLINE\fR packet to the DHCP server, and tries to obtain an IP address again\&. See -\m[blue]\fBRFC 5227\fR\m[]\&\s-2\u[11]\d\s+2\&. Defaults to false\&. +\m[blue]\fBRFC 5227\fR\m[]\&\s-2\u[12]\d\s+2\&. Defaults to false\&. .sp Added in version 245\&. .RE @@ -2820,7 +2940,7 @@ Send an arbitrary vendor option in the DHCPv6 request\&. Takes an enterprise ide "ipv4address", "ipv6address", or "string"\&. Special characters in the data string may be escaped using -\m[blue]\fBC\-style escapes\fR\m[]\&\s-2\u[25]\d\s+2\&. This setting can be specified multiple times\&. If an empty string is specified, then all options specified earlier are cleared\&. Defaults to unset\&. +\m[blue]\fBC\-style escapes\fR\m[]\&\s-2\u[27]\d\s+2\&. This setting can be specified multiple times\&. If an empty string is specified, then all options specified earlier are cleared\&. Defaults to unset\&. .sp Added in version 246\&. .RE @@ -2828,7 +2948,7 @@ Added in version 246\&. \fIUserClass=\fR .RS 4 A DHCPv6 client can use User Class option to identify the type or category of user or applications it represents\&. The information contained in this option is a string that represents the user class of which the client is a member\&. Each class sets an identifying string of information to be used by the DHCP service to classify clients\&. Special characters in the data string may be escaped using -\m[blue]\fBC\-style escapes\fR\m[]\&\s-2\u[25]\d\s+2\&. This setting can be specified multiple times\&. If an empty string is specified, then all options specified earlier are cleared\&. Takes a whitespace\-separated list of strings\&. Note that currently +\m[blue]\fBC\-style escapes\fR\m[]\&\s-2\u[27]\d\s+2\&. This setting can be specified multiple times\&. If an empty string is specified, then all options specified earlier are cleared\&. Takes a whitespace\-separated list of strings\&. Note that currently \fBNUL\fR bytes are not allowed\&. .sp @@ -2854,7 +2974,7 @@ Added in version 244\&. \fIRapidCommit=\fR .RS 4 Takes a boolean\&. The DHCPv6 client can obtain configuration parameters from a DHCPv6 server through a rapid two\-message exchange (solicit and reply)\&. When the rapid commit option is set by both the DHCPv6 client and the DHCPv6 server, the two\-message exchange is used\&. Otherwise, the four\-message exchange (solicit, advertise, request, and reply) is used\&. The two\-message exchange provides faster client configuration\&. See -\m[blue]\fBRFC 3315\fR\m[]\&\s-2\u[29]\d\s+2 +\m[blue]\fBRFC 3315\fR\m[]\&\s-2\u[31]\d\s+2 for details\&. Defaults to true, and the two\-message exchange will be used if the server support it\&. .sp Added in version 252\&. @@ -2897,7 +3017,7 @@ When true (the default), the client will request the DHCPv6 server to delegate p \fIDHCPPrefixDelegation=yes\fR\&. See also the \fIDHCPPrefixDelegation=\fR setting in the [Network] section, settings in the [DHCPPrefixDelegation] section, and -\m[blue]\fBRFC 8415\fR\m[]\&\s-2\u[30]\d\s+2\&. +\m[blue]\fBRFC 8415\fR\m[]\&\s-2\u[32]\d\s+2\&. .sp Added in version 250\&. .RE @@ -2971,7 +3091,7 @@ Added in version 250\&. \fISubnetId=\fR .RS 4 Configure a specific subnet ID on the interface from a (previously) received prefix delegation\&. You can either set "auto" (the default) or a specific subnet ID (as defined in -\m[blue]\fBRFC 4291\fR\m[]\&\s-2\u[31]\d\s+2, section 2\&.5\&.4), in which case the allowed value is hexadecimal, from 0 to 0x7fffffffffffffff inclusive\&. +\m[blue]\fBRFC 4291\fR\m[]\&\s-2\u[33]\d\s+2, section 2\&.5\&.4), in which case the allowed value is hexadecimal, from 0 to 0x7fffffffffffffff inclusive\&. .sp Added in version 246\&. .RE @@ -3053,6 +3173,13 @@ The [IPv6AcceptRA] section configures the IPv6 Router Advertisement (RA) client, \fIIPv6AcceptRA=\fR setting described above: .PP +\fIUseRedirect=\fR +.RS 4 +When true (the default), Redirect message sent by the current first\-hop router will be accepted, and configures routes to redirected nodes will be configured\&. +.sp +Added in version 256\&. +.RE +.PP \fIToken=\fR .RS 4 Specifies an optional address generation mode for the Stateless Address Autoconfiguration (SLAAC)\&. The following values are supported: @@ -3076,7 +3203,7 @@ Added in version 250\&. \fBprefixstable[:\fR\fB\fIADDRESS\fR\fR\fB][,\fR\fB\fIUUID\fR\fR\fB]\fR .RS 4 The algorithm specified in -\m[blue]\fBRFC 7217\fR\m[]\&\s-2\u[32]\d\s+2 +\m[blue]\fBRFC 7217\fR\m[]\&\s-2\u[34]\d\s+2 will be used to generate interface identifiers\&. This mode can optionally take an IPv6 address separated with a colon (":")\&. If an IPv6 address is specified, then an interface identifier is generated only when a prefix received in an RA message matches the supplied address\&. .sp This mode can also optionally take a non\-null UUID in the format which @@ -3203,11 +3330,18 @@ Takes a boolean\&. When true, the hop limit received in the Router Advertisement Added in version 255\&. .RE .PP -\fIUseICMP6RateLimit=\fR +\fIUseReachableTime=\fR .RS 4 -Takes a boolean\&. When true, the ICMP6 rate limit received in the Router Advertisement will be set to ICMP6 rate limit based on the advertisement\&. Defaults to true\&. +Takes a boolean\&. When true, the reachable time received in the Router Advertisement will be set on the interface receiving the advertisement\&. It is used as the base timespan of the validity of a neighbor entry\&. Defaults to true\&. .sp -Added in version 255\&. +Added in version 256\&. +.RE +.PP +\fIUseRetransmissionTime=\fR +.RS 4 +Takes a boolean\&. When true, the retransmission time received in the Router Advertisement will be set on the interface receiving the advertisement\&. It is used as the time between retransmissions of Neighbor Solicitation messages to a neighbor when resolving the address or when probing the reachability of a neighbor\&. Defaults to true\&. +.sp +Added in version 256\&. .RE .PP \fIUseGateway=\fR @@ -3238,7 +3372,7 @@ Added in version 254\&. When true, the IPv6 PREF64 (or NAT64) prefixes received in the Router Advertisement will be recorded and made available to client programs and displayed in the \fBnetworkctl\fR(1) status output per\-link\&. See -\m[blue]\fBRFC 8781\fR\m[]\&\s-2\u[33]\d\s+2\&. Defaults to false\&. +\m[blue]\fBRFC 8781\fR\m[]\&\s-2\u[35]\d\s+2\&. Defaults to false\&. .sp Added in version 255\&. .RE @@ -3421,7 +3555,7 @@ ServerAddress=192\&.168\&.0\&.1/24 .RE .\} .sp -are equivalent to the following\&. +are equivalent to the following: .sp .if n \{\ .RS 4 @@ -3556,7 +3690,7 @@ Added in version 226\&. Takes an IPv4 address of the boot server used by e\&.g\&. PXE boot systems\&. When specified, this address is sent in the \fBsiaddr\fR field of the DHCP message header\&. See -\m[blue]\fBRFC 2131\fR\m[]\&\s-2\u[34]\d\s+2 +\m[blue]\fBRFC 2131\fR\m[]\&\s-2\u[36]\d\s+2 for more details\&. Defaults to unset\&. .sp Added in version 251\&. @@ -3565,7 +3699,7 @@ Added in version 251\&. \fIBootServerName=\fR .RS 4 Takes a name of the boot server used by e\&.g\&. PXE boot systems\&. When specified, this name is sent in the DHCP option 66 ("TFTP server name")\&. See -\m[blue]\fBRFC 2132\fR\m[]\&\s-2\u[35]\d\s+2 +\m[blue]\fBRFC 2132\fR\m[]\&\s-2\u[37]\d\s+2 for more details\&. Defaults to unset\&. .sp Note that typically setting one of @@ -3580,7 +3714,7 @@ Added in version 251\&. \fIBootFilename=\fR .RS 4 Takes a path or URL to a file loaded by e\&.g\&. a PXE boot loader\&. When specified, this path is sent in the DHCP option 67 ("Bootfile name")\&. See -\m[blue]\fBRFC 2132\fR\m[]\&\s-2\u[35]\d\s+2 +\m[blue]\fBRFC 2132\fR\m[]\&\s-2\u[37]\d\s+2 for more details\&. Defaults to unset\&. .sp Added in version 251\&. @@ -3589,7 +3723,7 @@ Added in version 251\&. \fIIPv6OnlyPreferredSec=\fR .RS 4 Takes a timespan\&. Controls the -\m[blue]\fBRFC 8925\fR\m[]\&\s-2\u[28]\d\s+2 +\m[blue]\fBRFC 8925\fR\m[]\&\s-2\u[30]\d\s+2 IPv6\-Only Preferred option\&. Specifies the DHCPv4 option to indicate that a host supports an IPv6\-only mode and is willing to forgo obtaining an IPv4 address if the network provides IPv6 connectivity\&. Defaults to unset, and not send the option\&. The minimum allowed value is 300 seconds\&. .sp Added in version 255\&. @@ -3604,7 +3738,7 @@ Send a raw option with value via DHCPv4 server\&. Takes a DHCP option number, da "ipv4address", "ipv6address", or "string"\&. Special characters in the data string may be escaped using -\m[blue]\fBC\-style escapes\fR\m[]\&\s-2\u[25]\d\s+2\&. This setting can be specified multiple times\&. If an empty string is specified, then all options specified earlier are cleared\&. Defaults to unset\&. +\m[blue]\fBC\-style escapes\fR\m[]\&\s-2\u[27]\d\s+2\&. This setting can be specified multiple times\&. If an empty string is specified, then all options specified earlier are cleared\&. Defaults to unset\&. .sp Added in version 244\&. .RE @@ -3617,7 +3751,7 @@ Send a vendor option with value via DHCPv4 server\&. Takes a DHCP option number, "uint32", "ipv4address", or "string"\&. Special characters in the data string may be escaped using -\m[blue]\fBC\-style escapes\fR\m[]\&\s-2\u[25]\d\s+2\&. This setting can be specified multiple times\&. If an empty string is specified, then all options specified earlier are cleared\&. Defaults to unset\&. +\m[blue]\fBC\-style escapes\fR\m[]\&\s-2\u[27]\d\s+2\&. This setting can be specified multiple times\&. If an empty string is specified, then all options specified earlier are cleared\&. Defaults to unset\&. .sp Added in version 246\&. .RE @@ -3638,7 +3772,7 @@ Added in version 249\&. .RS 4 Takes an IPv4 address, which must be in the format described in \fBinet_pton\fR(3)\&. Turns this DHCP server into a DHCP relay agent\&. See -\m[blue]\fBRFC 1542\fR\m[]\&\s-2\u[36]\d\s+2\&. The address is the address of DHCP server or another relay agent to forward DHCP messages to and from\&. +\m[blue]\fBRFC 1542\fR\m[]\&\s-2\u[38]\d\s+2\&. The address is the address of DHCP server or another relay agent to forward DHCP messages to and from\&. .sp Added in version 249\&. .RE @@ -3670,10 +3804,22 @@ Added in version 249\&. \fIRapidCommit=\fR .RS 4 Takes a boolean\&. When true, the server supports -\m[blue]\fBRFC 4039\fR\m[]\&\s-2\u[37]\d\s+2\&. When a client sends a DHCPDISCOVER message with the Rapid Commit option to the server, then the server will reply with a DHCPACK message to the client, instead of DHCPOFFER\&. Defaults to true\&. +\m[blue]\fBRFC 4039\fR\m[]\&\s-2\u[39]\d\s+2\&. When a client sends a DHCPDISCOVER message with the Rapid Commit option to the server, then the server will reply with a DHCPACK message to the client, instead of DHCPOFFER\&. Defaults to true\&. .sp Added in version 255\&. .RE +.PP +\fIPersistLeases=\fR +.RS 4 +Takes a boolean\&. When true, the DHCP server will load and save leases in the persistent storage\&. When false, the DHCP server will neither load nor save leases in the persistent storage\&. Hence, bound leases will be lost when the interface is reconfigured e\&.g\&. by +\fBnetworkctl reconfigure\fR, or +systemd\-networkd\&.service +is restarted\&. That may cause address conflict on the network\&. So, please take an extra care when disable this setting\&. When unspecified, the value specified in the same setting in +\fBnetworkd.conf\fR(5), which defaults to +"yes", will be used\&. +.sp +Added in version 256\&. +.RE .SH "[DHCPSERVERSTATICLEASE] SECTION OPTIONS" .PP The @@ -3722,9 +3868,16 @@ Takes a timespan\&. Configures the IPv6 router lifetime in seconds\&. The value Added in version 235\&. .RE .PP +\fIReachableTimeSec=\fR +.RS 4 +Configures the time, used in the Neighbor Unreachability Detection algorithm, for which clients can assume a neighbor is reachable after having received a reachability confirmation\&. Takes a time span in the range 0\&...4294967295 ms\&. When 0, clients will handle it as if the value wasn\*(Aqt specified\&. Defaults to 0\&. +.sp +Added in version 256\&. +.RE +.PP \fIRetransmitSec=\fR .RS 4 -Takes a timespan\&. Configures the retransmit time, used by clients to retransmit Neighbor Solicitation messages on address resolution and the Neighbor Unreachability Detection algorithm\&. An integer the default unit of seconds, in the range 0\&...4294967295 msec\&. Defaults to 0\&. +Configures the time, used in the Neighbor Unreachability Detection algorithm, for which clients can use as retransmit time on address resolution and the Neighbor Unreachability Detection algorithm\&. Takes a time span in the range 0\&...4294967295 ms\&. When 0, clients will handle it as if the value wasn\*(Aqt specified\&. Defaults to 0\&. .sp Added in version 255\&. .RE @@ -3744,7 +3897,7 @@ and added as synonyms for "medium" just to make configuration easier\&. See -\m[blue]\fBRFC 4191\fR\m[]\&\s-2\u[21]\d\s+2 +\m[blue]\fBRFC 4191\fR\m[]\&\s-2\u[23]\d\s+2 for details\&. Defaults to "medium"\&. .sp @@ -3824,8 +3977,8 @@ Added in version 235\&. .PP \fIHomeAgent=\fR .RS 4 -Takes a boolean\&. Specifies that IPv6 router advertisements which indicates to hosts that the router acts as a Home Agent and includes a Home Agent Option\&. Defaults to false\&. See -\m[blue]\fBRFC 6275\fR\m[]\&\s-2\u[10]\d\s+2 +Takes a boolean\&. Specifies that IPv6 router advertisements which indicate to hosts that the router acts as a Home Agent and includes a Home Agent option\&. Defaults to false\&. See +\m[blue]\fBRFC 6275\fR\m[]\&\s-2\u[11]\d\s+2 for further details\&. .sp Added in version 255\&. @@ -3833,7 +3986,7 @@ Added in version 255\&. .PP \fIHomeAgentLifetimeSec=\fR .RS 4 -Takes a timespan\&. Specifies the lifetime of the Home Agent\&. An integer the default unit of seconds, in the range 1\&...65535\&. Defaults to the value set to +Takes a timespan\&. Specifies the lifetime of the Home Agent\&. An integer, the default unit is seconds, in the range 1\&...65535\&. Defaults to the value set to \fIRouterLifetimeSec=\fR\&. .sp Added in version 255\&. @@ -3848,7 +4001,7 @@ Added in version 255\&. .SH "[IPV6PREFIX] SECTION OPTIONS" .PP One or more [IPv6Prefix] sections contain the IPv6 prefixes that are announced via Router Advertisements\&. See -\m[blue]\fBRFC 4861\fR\m[]\&\s-2\u[38]\d\s+2 +\m[blue]\fBRFC 4861\fR\m[]\&\s-2\u[40]\d\s+2 for further details\&. .PP \fIAddressAutoconfiguration=\fR, \fIOnLink=\fR @@ -3909,7 +4062,7 @@ Added in version 249\&. .SH "[IPV6ROUTEPREFIX] SECTION OPTIONS" .PP One or more [IPv6RoutePrefix] sections contain the IPv6 prefix routes that are announced via Router Advertisements\&. See -\m[blue]\fBRFC 4191\fR\m[]\&\s-2\u[21]\d\s+2 +\m[blue]\fBRFC 4191\fR\m[]\&\s-2\u[23]\d\s+2 for further details\&. .PP \fIRoute=\fR @@ -3932,7 +4085,7 @@ Added in version 244\&. .SH "[IPV6PREF64PREFIX] SECTION OPTIONS" .PP One or more [IPv6PREF64Prefix] sections contain the IPv6 PREF64 (or NAT64) prefixes that are announced via Router Advertisements\&. See -\m[blue]\fBRFC 8781\fR\m[]\&\s-2\u[33]\d\s+2 +\m[blue]\fBRFC 8781\fR\m[]\&\s-2\u[35]\d\s+2 for further details\&. .PP \fIPrefix=\fR @@ -5507,14 +5660,14 @@ Added in version 246\&. .RE .SH "[BRIDGEVLAN] SECTION OPTIONS" .PP -The [BridgeVLAN] section manages the VLAN ID configuration of a bridge port and accepts the following keys\&. Specify several [BridgeVLAN] sections to configure several VLAN entries\&. The +The [BridgeVLAN] section manages the VLAN ID configurations of a bridge master or port, and accepts the following keys\&. To make the settings in this section take an effect, \fIVLANFiltering=\fR -option has to be enabled, see the [Bridge] section in -\fBsystemd.netdev\fR(5)\&. +option has to be enabled on the bridge master, see the [Bridge] section in +\fBsystemd.netdev\fR(5)\&. If at least one valid settings specified in this section in a \&.network file for an interface, all assigned VLAN IDs on the interface that are not configured in the \&.network file will be removed\&. If VLAN IDs on an interface need to be managed by other tools, then the settings in this section cannot be used in the matching \&.network file\&. .PP \fIVLAN=\fR .RS 4 -The VLAN ID allowed on the port\&. This can be either a single ID or a range M\-N\&. Takes an integer in the range 1\&...4094\&. +The VLAN ID allowed on the port\&. This can be either a single ID or a range M\-N\&. Takes an integer in the range 1\&...4094\&. This setting can be specified multiple times\&. If an empty string is assigned, then the all previous assignments are cleared\&. .sp Added in version 231\&. .RE @@ -5525,20 +5678,19 @@ The VLAN ID specified here will be used to untag frames on egress\&. Configuring \fIEgressUntagged=\fR implicates the use of \fIVLAN=\fR -above and will enable the VLAN ID for ingress as well\&. This can be either a single ID or a range M\-N\&. +above and will enable the VLAN ID for ingress as well\&. This can be either a single ID or a range M\-N\&. This setting can be specified multiple times\&. If an empty string is assigned, then the all previous assignments are cleared\&. .sp Added in version 231\&. .RE .PP \fIPVID=\fR .RS 4 -The Port VLAN ID specified here is assigned to all untagged frames at ingress\&. -\fIPVID=\fR -can be used only once\&. Configuring +The port VLAN ID specified here is assigned to all untagged frames at ingress\&. Takes an VLAN ID or negative boolean value (e\&.g\&. +"no")\&. When false, the currently assigned port VLAN ID will be dropped\&. Configuring \fIPVID=\fR implicates the use of \fIVLAN=\fR -above and will enable the VLAN ID for ingress as well\&. +setting in the above and will enable the VLAN ID for ingress as well\&. Defaults to unset, and will keep the assigned port VLAN ID if exists\&. .sp Added in version 231\&. .RE @@ -6031,12 +6183,7 @@ nic\&. If offloading is not needed, xfrm interfaces can be assigned to the device\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-networkd.service\fR(8), -\fBsystemd.link\fR(5), -\fBsystemd.netdev\fR(5), -\fBsystemd-network-generator.service\fR(8), -\fBsystemd-resolved.service\fR(8) +\fBsystemd\fR(1), \fBsystemd-networkd.service\fR(8), \fBsystemd.link\fR(5), \fBsystemd.netdev\fR(5), \fBsystemd-network-generator.service\fR(8), \fBsystemd-resolved.service\fR(8) .SH "NOTES" .IP " 1." 4 System and Service Credentials @@ -6084,146 +6231,156 @@ RFC 3704 \%https://tools.ietf.org/html/rfc1027 .RE .IP "10." 4 +RFC 3069 +.RS 4 +\%https://tools.ietf.org/html/rfc3069 +.RE +.IP "11." 4 RFC 6275 .RS 4 \%https://tools.ietf.org/html/rfc6275 .RE -.IP "11." 4 +.IP "12." 4 RFC 5227 .RS 4 \%https://tools.ietf.org/html/rfc5227 .RE -.IP "12." 4 +.IP "13." 4 RFC 4862 .RS 4 \%https://tools.ietf.org/html/rfc4862 .RE -.IP "13." 4 +.IP "14." 4 RFC 3041 .RS 4 \%https://tools.ietf.org/html/rfc3041 .RE -.IP "14." 4 +.IP "15." 4 NetLabel .RS 4 \%https://docs.kernel.org/netlabel/index.html .RE -.IP "15." 4 +.IP "16." 4 Linux Security Modules (LSMs) .RS 4 \%https://en.wikipedia.org/wiki/Linux_Security_Modules .RE -.IP "16." 4 +.IP "17." 4 NetLabel Fallback Peer Labeling .RS 4 \%https://github.com/SELinuxProject/selinux-notebook/blob/main/src/network_support.md .RE -.IP "17." 4 +.IP "18." 4 NFT .RS 4 \%https://netfilter.org/projects/nftables/index.html .RE -.IP "18." 4 +.IP "19." 4 RFC 3484 .RS 4 \%https://tools.ietf.org/html/rfc3484 .RE -.IP "19." 4 +.IP "20." 4 Type of Service .RS 4 \%https://en.wikipedia.org/wiki/Type_of_service .RE -.IP "20." 4 +.IP "21." 4 Differentiated services .RS 4 \%https://en.wikipedia.org/wiki/Differentiated_services .RE -.IP "21." 4 +.IP "22." 4 +Virtual Routing and Forwarding (VRF) +.RS 4 +\%https://docs.kernel.org/networking/vrf.html +.RE +.IP "23." 4 RFC 4191 .RS 4 \%https://tools.ietf.org/html/rfc4191 .RE -.IP "22." 4 +.IP "24." 4 RFC 8520 .RS 4 \%https://tools.ietf.org/html/rfc8520 .RE -.IP "23." 4 +.IP "25." 4 RFC 4039 .RS 4 \%https://tools.ietf.org/html/rfc4039 .RE -.IP "24." 4 +.IP "26." 4 RFC 7844 .RS 4 \%https://tools.ietf.org/html/rfc7844 .RE -.IP "25." 4 +.IP "27." 4 C-style escapes .RS 4 \%https://en.wikipedia.org/wiki/Escape_sequences_in_C#Table_of_escape_sequences .RE -.IP "26." 4 +.IP "28." 4 RFC 3442 .RS 4 \%https://datatracker.ietf.org/doc/html/rfc3442 .RE -.IP "27." 4 +.IP "29." 4 RFC 5969 .RS 4 \%https://tools.ietf.org/html/rfc5969 .RE -.IP "28." 4 +.IP "30." 4 RFC 8925 .RS 4 \%https://tools.ietf.org/html/rfc8925 .RE -.IP "29." 4 +.IP "31." 4 RFC 3315 .RS 4 \%https://tools.ietf.org/html/rfc3315#section-17.2.1 .RE -.IP "30." 4 +.IP "32." 4 RFC 8415 .RS 4 \%https://www.rfc-editor.org/rfc/rfc8415.html#section-6.3 .RE -.IP "31." 4 +.IP "33." 4 RFC 4291 .RS 4 \%https://tools.ietf.org/html/rfc4291#section-2.5.4 .RE -.IP "32." 4 +.IP "34." 4 RFC 7217 .RS 4 \%https://tools.ietf.org/html/rfc7217 .RE -.IP "33." 4 +.IP "35." 4 RFC 8781 .RS 4 \%https://tools.ietf.org/html/rfc8781 .RE -.IP "34." 4 +.IP "36." 4 RFC 2131 .RS 4 \%https://www.rfc-editor.org/rfc/rfc2131.html .RE -.IP "35." 4 +.IP "37." 4 RFC 2132 .RS 4 \%https://www.rfc-editor.org/rfc/rfc2132.html .RE -.IP "36." 4 +.IP "38." 4 RFC 1542 .RS 4 \%https://tools.ietf.org/html/rfc1542 .RE -.IP "37." 4 +.IP "39." 4 RFC 4039 .RS 4 \%https://datatracker.ietf.org/doc/html/rfc4039 .RE -.IP "38." 4 +.IP "40." 4 RFC 4861 .RS 4 \%https://tools.ietf.org/html/rfc4861 diff --git a/upstream/fedora-rawhide/man5/systemd.nspawn.5 b/upstream/fedora-rawhide/man5/systemd.nspawn.5 index 0c441ba1..5bb98a83 100644 --- a/upstream/fedora-rawhide/man5/systemd.nspawn.5 +++ b/upstream/fedora-rawhide/man5/systemd.nspawn.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.NSPAWN" "5" "" "systemd 255" "systemd.nspawn" +.TH "SYSTEMD\&.NSPAWN" "5" "" "systemd 256~rc3" "systemd.nspawn" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,11 +23,15 @@ systemd.nspawn \- Container settings .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/nspawn/\fImachine\fR\&.nspawn -.PP +.RE +.RS 4 /run/systemd/nspawn/\fImachine\fR\&.nspawn -.PP +.RE +.RS 4 /var/lib/machines/\fImachine\fR\&.nspawn +.RE .SH "DESCRIPTION" .PP An nspawn container settings file (suffix @@ -587,6 +591,4 @@ Added in version 226\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-nspawn\fR(1), -\fBsystemd.directives\fR(7) +\fBsystemd\fR(1), \fBsystemd-nspawn\fR(1), \fBsystemd.directives\fR(7) diff --git a/upstream/fedora-rawhide/man5/systemd.path.5 b/upstream/fedora-rawhide/man5/systemd.path.5 index 9fbc4d47..11d47179 100644 --- a/upstream/fedora-rawhide/man5/systemd.path.5 +++ b/upstream/fedora-rawhide/man5/systemd.path.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.PATH" "5" "" "systemd 255" "systemd.path" +.TH "SYSTEMD\&.PATH" "5" "" "systemd 256~rc3" "systemd.path" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -203,9 +203,4 @@ in \fBsystemd.exec\fR(5) for more details\&. .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemd.service\fR(5), -\fBinotify\fR(7), -\fBsystemd.directives\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.service\fR(5), \fBinotify\fR(7), \fBsystemd.directives\fR(7) diff --git a/upstream/fedora-rawhide/man5/systemd.pcrlock.5 b/upstream/fedora-rawhide/man5/systemd.pcrlock.5 index cadc0742..a3eecafe 100644 --- a/upstream/fedora-rawhide/man5/systemd.pcrlock.5 +++ b/upstream/fedora-rawhide/man5/systemd.pcrlock.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.PCRLOCK" "5" "" "systemd 255" "systemd.pcrlock" +.TH "SYSTEMD\&.PCRLOCK" "5" "" "systemd 256~rc3" "systemd.pcrlock" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,25 +23,43 @@ systemd.pcrlock, systemd.pcrlock.d \- PCR measurement prediction files .SH "SYNOPSIS" .PP -.nf +.RS 4 /etc/pcrlock\&.d/*\&.pcrlock +.RE +.RS 4 /etc/pcrlock\&.d/*\&.pcrlock\&.d/*\&.pcrlock +.RE +.RS 4 /run/pcrlock\&.d/*\&.pcrlock +.RE +.RS 4 /run/pcrlock\&.d/*\&.pcrlock\&.d/*\&.pcrlock +.RE +.RS 4 /var/lib/pcrlock\&.d/*\&.pcrlock +.RE +.RS 4 /var/lib/pcrlock\&.d/*\&.pcrlock\&.d/*\&.pcrlock +.RE +.RS 4 /usr/local/pcrlock\&.d/*\&.pcrlock +.RE +.RS 4 /usr/local/pcrlock\&.d/*\&.pcrlock\&.d/*\&.pcrlock +.RE +.RS 4 /usr/lib/pcrlock\&.d/*\&.pcrlock +.RE +.RS 4 /usr/lib/pcrlock\&.d/*\&.pcrlock\&.d/*\&.pcrlock -.fi +.RE .SH "DESCRIPTION" .PP *\&.pcrlock files define expected TPM2 PCR measurements of components involved in the boot process\&. \fBsystemd-pcrlock\fR(1) uses such pcrlock files to analyze and predict TPM2 PCR measurements\&. The pcrlock files are JSON arrays that follow a subset of the -\m[blue]\fBTCG Common Event Log Format (CEL\-JSON)\fR\m[]\&\s-2\u[1]\d\s+2 +\m[blue]\fBTCG Canonical Event Log Format (CEL\-JSON)\fR\m[]\&\s-2\u[1]\d\s+2 specification\&. Specifically the "recnum", "content", and @@ -90,7 +108,7 @@ Added in version 255\&. 250\-firmware\-code\-early\&.pcrlock .RS 4 Firmware code measurements, as recorded to PCR 0 and 2, up to the separator measurement (see -400\-secureboot\-separator\&.pcrlock\&. +400\-secureboot\-separator\&.pcrlock below)\&. May be generated via \fBsystemd\-pcrlock lock\-firmware\-code\fR\&. .sp @@ -100,7 +118,7 @@ Added in version 255\&. 250\-firmware\-config\-early\&.pcrlock .RS 4 Firmware configuration measurements, as recorded to PCR 1 and 3, up to the separator measurement (see -400\-secureboot\-separator\&.pcrlock\&. +400\-secureboot\-separator\&.pcrlock below)\&. May be generated via \fBsystemd\-pcrlock lock\-firmware\-config\fR\&. .sp @@ -131,7 +149,7 @@ Added in version 255\&. 550\-firmware\-code\-late\&.pcrlock .RS 4 Firmware code measurements, as recorded to PCR 0 and 2, after the separator measurement (see -400\-secureboot\-separator\&.pcrlock\&. +400\-secureboot\-separator\&.pcrlock above)\&. May be generated via \fBsystemd\-pcrlock lock\-firmware\-code\fR\&. .sp @@ -141,7 +159,7 @@ Added in version 255\&. 550\-firmware\-config\-late\&.pcrlock .RS 4 Firmware configuration measurements, as recorded to PCR 1 and 3, after the separator measurement (see -400\-secureboot\-separator\&.pcrlock\&. +400\-secureboot\-separator\&.pcrlock above)\&. May be generated via \fBsystemd\-pcrlock lock\-firmware\-config\fR\&. .sp @@ -168,7 +186,7 @@ Added in version 255\&. .RS 4 The EFI action generated when \fBExitBootServices()\fR -is generated, i\&.e\&. the UEFI environment is left and the OS takes over\&. Covers the PCR 5 measurement\&. Statically defined\&. +is generated, i\&.e\&. when the UEFI environment is left and the OS takes over\&. Covers the PCR 5 measurement\&. Statically defined\&. .sp Added in version 255\&. .RE @@ -266,11 +284,10 @@ Added in version 255\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-pcrlock\fR(1) +\fBsystemd\fR(1), \fBsystemd-pcrlock\fR(1) .SH "NOTES" .IP " 1." 4 -TCG Common Event Log Format (CEL-JSON) +TCG Canonical Event Log Format (CEL-JSON) .RS 4 \%https://trustedcomputinggroup.org/resource/canonical-event-log-format/ .RE diff --git a/upstream/fedora-rawhide/man5/systemd.preset.5 b/upstream/fedora-rawhide/man5/systemd.preset.5 index 945e0d62..c75ee687 100644 --- a/upstream/fedora-rawhide/man5/systemd.preset.5 +++ b/upstream/fedora-rawhide/man5/systemd.preset.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.PRESET" "5" "" "systemd 255" "systemd.preset" +.TH "SYSTEMD\&.PRESET" "5" "" "systemd 256~rc3" "systemd.preset" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,17 +23,24 @@ systemd.preset \- Service enablement presets .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/system\-preset/*\&.preset -.PP +.RE +.RS 4 /run/systemd/system\-preset/*\&.preset -.PP +.RE +.RS 4 /usr/lib/systemd/system\-preset/*\&.preset -.PP +.RE +.RS 4 /etc/systemd/user\-preset/*\&.preset -.PP +.RE +.RS 4 /run/systemd/user\-preset/*\&.preset -.PP +.RE +.RS 4 /usr/lib/systemd/user\-preset/*\&.preset +.RE .SH "DESCRIPTION" .PP Preset files may be used to encode policy which units shall be enabled by default and which ones shall be disabled\&. They are read by @@ -45,7 +52,7 @@ is identical to or \fBsystemctl disable\fR\&. \fBsystemctl preset\fR -is used by the post install scriptlets of rpm packages (or other OS package formats), to enable/disable specific units by default on package installation, enforcing distribution, spin or administrator preset policy\&. This allows choosing a certain set of units to be enabled/disabled even before installing the actual package\&. For more information, see +is used by the post install scriptlets of rpm packages (or other OS package formats), to enable/disable specific units by default on package installation, enforcing distribution, spin, or administrator preset policy\&. This allows choosing a certain set of units to be enabled/disabled even before installing the actual package\&. For more information, see \fBsystemctl\fR(1)\&. .PP It is not recommended to ship preset files within the respective software packages implementing the units, but rather centralize them in a distribution or spin default policy, which can be amended by administrator policy, see below\&. @@ -55,7 +62,11 @@ If no preset files exist, preset operations will enable all units that are insta When the machine is booted for the first time, \fBsystemd\fR(1) will enable/disable all units according to preset policy, similarly to -\fBsystemctl preset\-all\fR\&. Also see "First Boot Semantics" in +\fBsystemctl preset\-all\fR\&. Also see +\fIConditionFirstBoot=\fR +in +\fBsystemd.unit\fR(5) +and "First Boot Semantics" in \fBmachine-id\fR(5)\&. .SH "PRESET FILE FORMAT" .PP @@ -203,9 +214,7 @@ The preset mechanism allows clean separation of the enablement mechanism (inside \fBsystemctl preset\fR) and enablement policy (centralized in the preset files), and lifts the configuration out of individual packages\&. Preset files may be written for specific distributions, for specific spins or for specific sites, in order to enforce different policies as needed\&. It is recommended to apply the policy encoded in preset files in package installation scriptlets\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd-delta\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-delta\fR(1) .PP \fBdaemon\fR(7) has a discussion of packaging scriptlets\&. diff --git a/upstream/fedora-rawhide/man5/systemd.resource-control.5 b/upstream/fedora-rawhide/man5/systemd.resource-control.5 index 3e1a9ae0..a2829b60 100644 --- a/upstream/fedora-rawhide/man5/systemd.resource-control.5 +++ b/upstream/fedora-rawhide/man5/systemd.resource-control.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.RESOURCE\-CONTROL" "5" "" "systemd 255" "systemd.resource-control" +.TH "SYSTEMD\&.RESOURCE\-CONTROL" "5" "" "systemd 256~rc3" "systemd.resource-control" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -161,6 +161,7 @@ user\-\fInnn\fR\&.slice\&. Drop\-ins with local configuration that affect user 1 /etc/systemd/system/user\-1000\&.slice, /etc/systemd/system/user\-1000\&.slice\&.d/*\&.conf, but also /etc/systemd/system/user\-\&.slice\&.d/*\&.conf\&. This last directory applies to all user slices\&. +.SS "" .PP See the \m[blue]\fBNew Control Group Interfaces\fR\m[]\&\s-2\u[1]\d\s+2 @@ -422,7 +423,10 @@ Takes a memory size in bytes\&. If the value is suffixed with K, M, G or T, the "infinity", no memory throttling is applied\&. This controls the "memory\&.high" control group attribute\&. For details about this control group attribute, see -\m[blue]\fBMemory Interface Files\fR\m[]\&\s-2\u[5]\d\s+2\&. +\m[blue]\fBMemory Interface Files\fR\m[]\&\s-2\u[5]\d\s+2\&. The effective configuration is reported as +\fIEffectiveMemoryHigh=\fR +(see also +\fIEffectiveMemoryMax=\fR)\&. .sp While \fIStartupMemoryHigh=\fR @@ -451,7 +455,9 @@ Takes a memory size in bytes\&. If the value is suffixed with K, M, G or T, the "infinity", no memory limit is applied\&. This controls the "memory\&.max" control group attribute\&. For details about this control group attribute, see -\m[blue]\fBMemory Interface Files\fR\m[]\&\s-2\u[5]\d\s+2\&. +\m[blue]\fBMemory Interface Files\fR\m[]\&\s-2\u[5]\d\s+2\&. The effective configuration is reported as +\fIEffectiveMemoryMax=\fR +(the value is the most stringent limit of the unit and parent slices and it is capped by physical memory)\&. .sp While \fIStartupMemoryMax=\fR @@ -516,6 +522,19 @@ allows prioritizing specific services at boot\-up and shutdown differently than Added in version 253\&. .RE .PP +\fIMemoryZSwapWriteback=\fR +.RS 4 +This setting controls the +\fBmemory\fR +controller in the unified hierarchy\&. +.sp +Takes a boolean argument\&. When true, pages stored in the Zswap cache are permitted to be written to the backing storage, false otherwise\&. Defaults to true\&. This allows disabling writeback of swap pages for IO\-intensive applications, while retaining the ability to store compressed pages in Zswap\&. See the kernel\*(Aqs +\m[blue]\fBZswap\fR\m[]\&\s-2\u[6]\d\s+2 +documentation for more details\&. +.sp +Added in version 256\&. +.RE +.PP \fIAllowedMemoryNodes=\fR, \fIStartupAllowedMemoryNodes=\fR .RS 4 These settings control the @@ -569,7 +588,8 @@ Specify the maximum number of tasks that may be created in the unit\&. This ensu "infinity", no tasks limit is applied\&. This controls the "pids\&.max" control group attribute\&. For details about this control group attribute, the -\m[blue]\fBpids controller\fR\m[]\&\s-2\u[7]\d\s+2\&. +\m[blue]\fBpids controller\fR\m[]\&\s-2\u[7]\d\s+2\&. The effective configuration is reported as +\fIEffectiveTasksMax=\fR\&. .sp The system default for this setting may be controlled with \fIDefaultTasksMax=\fR @@ -702,6 +722,8 @@ The system default for this setting may be controlled with in \fBsystemd-system.conf\fR(5)\&. .sp +Note that this functionality is currently only available for system services, not for per\-user services\&. +.sp Added in version 235\&. .RE .PP @@ -833,9 +855,9 @@ Added in version 235\&. .PP \fISocketBindAllow=\fR\fI\fIbind\-rule\fR\fR, \fISocketBindDeny=\fR\fI\fIbind\-rule\fR\fR .RS 4 -Allow or deny binding a socket address to a socket by matching it with the -\fIbind\-rule\fR -and applying a corresponding action if there is a match\&. +Configures restrictions on the ability of unit processes to invoke +\fBbind\fR(2) +on a socket\&. Both allow and deny rules may defined that restrict which addresses a socket may be bound to\&. .sp \fIbind\-rule\fR describes socket properties such as @@ -964,6 +986,11 @@ and \fBcgroup/bind6\fR cgroup\-bpf hooks\&. .sp +Note that these settings apply to any +\fBbind\fR(2) +system call invocation by the unit processes, regardless in which network namespace they are placed\&. Or in other words: changing the network namespace is not a suitable mechanism for escaping these restrictions on +\fBbind()\fR\&. +.sp Examples: .sp .if n \{\ @@ -1739,20 +1766,7 @@ Added in version 252\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-system.conf\fR(5), -\fBsystemd.unit\fR(5), -\fBsystemd.service\fR(5), -\fBsystemd.slice\fR(5), -\fBsystemd.scope\fR(5), -\fBsystemd.socket\fR(5), -\fBsystemd.mount\fR(5), -\fBsystemd.swap\fR(5), -\fBsystemd.exec\fR(5), -\fBsystemd.directives\fR(7), -\fBsystemd.special\fR(7), -\fBsystemd-oomd.service\fR(8), The documentation for control groups and specific controllers in the Linux kernel: -\m[blue]\fBControl Groups v2\fR\m[]\&\s-2\u[2]\d\s+2\&. +\fBsystemd\fR(1), \fBsystemd-system.conf\fR(5), \fBsystemd.unit\fR(5), \fBsystemd.service\fR(5), \fBsystemd.slice\fR(5), \fBsystemd.scope\fR(5), \fBsystemd.socket\fR(5), \fBsystemd.mount\fR(5), \fBsystemd.swap\fR(5), \fBsystemd.exec\fR(5), \fBsystemd.directives\fR(7), \fBsystemd.special\fR(7), \fBsystemd-oomd.service\fR(8), The documentation for control groups and specific controllers in the Linux kernel: \m[blue]\fBControl Groups v2\fR\m[]\&\s-2\u[2]\d\s+2 .SH "NOTES" .IP " 1." 4 New Control Group Interfaces @@ -1782,12 +1796,12 @@ Memory Interface Files .IP " 6." 4 Zswap .RS 4 -\%https://www.kernel.org/doc/html/latest/admin-guide/mm/zswap.html +\%https://docs.kernel.org/admin-guide/mm/zswap.html .RE .IP " 7." 4 pids controller .RS 4 -\%https://www.kernel.org/doc/html/latest/admin-guide/cgroup-v2.html#pid +\%https://docs.kernel.org/admin-guide/cgroup-v2.html#pid .RE .IP " 8." 4 IO Interface Files diff --git a/upstream/fedora-rawhide/man5/systemd.scope.5 b/upstream/fedora-rawhide/man5/systemd.scope.5 index 64cb28d7..45f17811 100644 --- a/upstream/fedora-rawhide/man5/systemd.scope.5 +++ b/upstream/fedora-rawhide/man5/systemd.scope.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.SCOPE" "5" "" "systemd 255" "systemd.scope" +.TH "SYSTEMD\&.SCOPE" "5" "" "systemd 256~rc3" "systemd.scope" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -121,7 +121,7 @@ This setting also applies to \fBsystemd\-oomd\fR kills a cgroup associated with it\&. .sp -Added in version 243\&. +Added in version 253\&. .RE .PP \fIRuntimeMaxSec=\fR @@ -151,12 +151,7 @@ Check for more settings\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-run\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemd.resource-control\fR(5), -\fBsystemd.service\fR(5), -\fBsystemd.directives\fR(7)\&. +\fBsystemd\fR(1), \fBsystemd-run\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.service\fR(5), \fBsystemd.directives\fR(7)\&. .SH "NOTES" .IP " 1." 4 New Control Group Interfaces diff --git a/upstream/fedora-rawhide/man5/systemd.service.5 b/upstream/fedora-rawhide/man5/systemd.service.5 index 098eba50..a53894ed 100644 --- a/upstream/fedora-rawhide/man5/systemd.service.5 +++ b/upstream/fedora-rawhide/man5/systemd.service.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.SERVICE" "5" "" "systemd 255" "systemd.service" +.TH "SYSTEMD\&.SERVICE" "5" "" "systemd 256~rc3" "systemd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -1079,7 +1079,13 @@ If set to \fBon\-abnormal\fR, the service will be restarted when the process is terminated by a signal (including on core dump, excluding the aforementioned four signals), when an operation times out, or when the watchdog timeout is triggered\&. If set to \fBon\-abort\fR, the service will be restarted only if the service process exits due to an uncaught signal not specified as a clean exit status\&. If set to \fBon\-watchdog\fR, the service will be restarted only if the watchdog timeout for the service expires\&. If set to -\fBalways\fR, the service will be restarted regardless of whether it exited cleanly or not, got terminated abnormally by a signal, or hit a timeout\&. +\fBalways\fR, the service will be restarted regardless of whether it exited cleanly or not, got terminated abnormally by a signal, or hit a timeout\&. Note that +\fIType=oneshot\fR +services will never be restarted on a clean exit status, i\&.e\&. +\fBalways\fR +and +\fBon\-success\fR +are rejected for them\&. .sp .it 1 an-trap .nr an-no-space-flag 1 @@ -1316,21 +1322,9 @@ Added in version 189\&. \fIRestartPreventExitStatus=\fR .RS 4 Takes a list of exit status definitions that, when returned by the main service process, will prevent automatic service restarts, regardless of the restart setting configured with -\fIRestart=\fR\&. Exit status definitions can either be numeric exit codes or termination signal names, and are separated by spaces\&. Defaults to the empty list, so that, by default, no exit status is excluded from the configured restart logic\&. For example: -.sp -.if n \{\ -.RS 4 -.\} -.nf -RestartPreventExitStatus=1 6 SIGABRT -.fi -.if n \{\ -.RE -.\} -.sp -ensures that exit codes 1 and 6 and the termination signal -\fBSIGABRT\fR -will not result in automatic service restarting\&. This option may appear more than once, in which case the list of restart\-preventing statuses is merged\&. If the empty string is assigned to this option, the list is reset and all prior assignments of this option will have no effect\&. +\fIRestart=\fR\&. Exit status definitions can be numeric termination statuses, termination status names, or termination signal names, separated by spaces\&. Defaults to the empty list, so that, by default, no exit status is excluded from the configured restart logic\&. +.PP \fBExample\ \&2.\ \&A service with the \fIRestartPreventExitStatus=\fR setting\fR .sp .if n \{\ .RS 4 .\} .nf RestartPreventExitStatus=TEMPFAIL 250 SIGKILL .fi .if n \{\ .RE .\} .sp Exit status 75 (\fBTEMPFAIL\fR), 250, and the termination signal \fBSIGKILL\fR will not result in automatic service restarting\&. +This option may appear more than once, in which case the list of restart\-preventing statuses is merged\&. If the empty string is assigned to this option, the list is reset and all prior assignments of this option will have no effect\&. .sp Note that this setting has no effect on processes configured via \fIExecStartPre=\fR, @@ -1353,6 +1347,10 @@ Takes a list of exit status definitions that, when returned by the main service \fIRestart=\fR\&. The argument format is similar to \fIRestartPreventExitStatus=\fR\&. .sp +Note that for +\fIType=oneshot\fR +services, a success exit status will prevent them from auto\-restarting, no matter whether the corresponding exit statuses are listed in this option or not\&. +.sp Added in version 215\&. .RE .PP @@ -1731,7 +1729,7 @@ T} T{ ":" T}:T{ -If the executable path is prefixed with ":", environment variable substitution (as described by the "Command Lines" section below) is not applied\&. +If the executable path is prefixed with ":", environment variable substitution (as described below this table) is not applied\&. T} T{ "+" @@ -1929,7 +1927,7 @@ with five arguments: "ls"\&. .SH "EXAMPLES" .PP -\fBExample\ \&2.\ \&Simple service\fR +\fBExample\ \&3.\ \&Simple service\fR .PP The following unit file creates a service that will execute /usr/sbin/foo\-daemon\&. Since no @@ -1973,7 +1971,7 @@ if the service can background itself or \fIType=\fR\fBdbus\fR if the unit acquires a DBus name once initialization is complete\&. See below\&. .PP -\fBExample\ \&3.\ \&Oneshot service\fR +\fBExample\ \&4.\ \&Oneshot service\fR .PP Sometimes, units should just execute an action without keeping active processes, such as a filesystem check or a cleanup action on boot\&. For this, \fIType=\fR\fBoneshot\fR @@ -2013,7 +2011,7 @@ are \fInot\fR allowed\&. .PP -\fBExample\ \&4.\ \&Stoppable oneshot service\fR +\fBExample\ \&5.\ \&Stoppable oneshot service\fR .PP Similarly to the oneshot services, there are sometimes units that need to execute a program to set up something and then execute another to shut it down, but no process remains active while they are considered "started"\&. Network configuration can sometimes fall into this category\&. Another use case is if a oneshot service shall not be executed each time when they are pulled in as a dependency, but only the first time\&. .PP @@ -2049,7 +2047,7 @@ Since the unit is considered to be running after the start action has exited, in \fBsystemctl start\fR on that unit again will cause no action to be taken\&. .PP -\fBExample\ \&5.\ \&Traditional forking services\fR +\fBExample\ \&6.\ \&Traditional forking services\fR .PP Many traditional daemons/services background (i\&.e\&. fork, daemonize) themselves when starting\&. Set \fIType=\fR\fBforking\fR @@ -2092,7 +2090,7 @@ Please see \fBsystemd.kill\fR(5) for details on how you can influence the way systemd terminates the service\&. .PP -\fBExample\ \&6.\ \&DBus services\fR +\fBExample\ \&7.\ \&DBus services\fR .PP For services that acquire a name on the DBus system bus, use \fIType=\fR\fBdbus\fR @@ -2143,7 +2141,7 @@ Please see \fBsystemd.kill\fR(5) for details on how you can influence the way systemd terminates the service\&. .PP -\fBExample\ \&7.\ \&Services that notify systemd about their initialization\fR +\fBExample\ \&8.\ \&Services that notify systemd about their initialization\fR .PP \fIType=\fR\fBsimple\fR services are really easy to write, but have the major disadvantage of systemd not being able to tell when initialization of the given service is complete\&. For this reason, systemd supports a simple notification protocol that allows daemons to make systemd aware that they are done initializing\&. Use @@ -2160,7 +2158,7 @@ for this\&. A typical service file for such a daemon would look like this: Description=Simple notifying service [Service] -Type=notify +Type=notify\-reload ExecStart=/usr/sbin/simple\-notifying\-service [Install] @@ -2176,17 +2174,17 @@ Note that the daemon has to support systemd\*(Aqs notification protocol, else sy Please see \fBsystemd.kill\fR(5) for details on how you can influence the way systemd terminates the service\&. +.PP +To avoid code duplication, it is preferable to use +\fBsd_notify\fR(3) +when possible, especially when other APIs provided by +\fBlibsystemd\fR(3) +are also used, but note that the notification protocol is very simple and guaranteed to be stable as per the +\m[blue]\fBInterface Portability and Stability Promise\fR\m[]\&\s-2\u[4]\d\s+2, so it can be reimplemented by services with no external dependencies\&. For a self\-contained example, see +\fBsd_notify\fR(3)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd-system.conf\fR(5), -\fBsystemd.unit\fR(5), -\fBsystemd.exec\fR(5), -\fBsystemd.resource-control\fR(5), -\fBsystemd.kill\fR(5), -\fBsystemd.directives\fR(7), -\fBsystemd-run\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-system.conf\fR(5), \fBsystemd.unit\fR(5), \fBsystemd.exec\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.kill\fR(5), \fBsystemd.directives\fR(7), \fBsystemd-run\fR(1) .SH "NOTES" .IP " 1." 4 File Descriptor Store @@ -2203,3 +2201,8 @@ Control Group v2 .RS 4 \%https://docs.kernel.org/admin-guide/cgroup-v2.html .RE +.IP " 4." 4 +Interface Portability and Stability Promise +.RS 4 +\%https://systemd.io/PORTABILITY_AND_STABILITY/ +.RE diff --git a/upstream/fedora-rawhide/man5/systemd.slice.5 b/upstream/fedora-rawhide/man5/systemd.slice.5 index e4e179cc..98e7cc0b 100644 --- a/upstream/fedora-rawhide/man5/systemd.slice.5 +++ b/upstream/fedora-rawhide/man5/systemd.slice.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.SLICE" "5" "" "systemd 255" "systemd.slice" +.TH "SYSTEMD\&.SLICE" "5" "" "systemd 256~rc3" "systemd.slice" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -102,16 +102,13 @@ option\&. .SH "OPTIONS" .PP Slice unit files may include [Unit] and [Install] sections, which are described in -\fBsystemd.unit\fR(5)\&. No options specific to this file type are supported\&. +\fBsystemd.unit\fR(5)\&. +.PP +Slice files may include a [Slice] section\&. Options that may be used in this section are shared with other unit types\&. These options are documented in +\fBsystemd.resource-control\fR(5)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemd.resource-control\fR(5), -\fBsystemd.service\fR(5), -\fBsystemd.scope\fR(5), -\fBsystemd.special\fR(7), -\fBsystemd.directives\fR(7) +\fBsystemd\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.service\fR(5), \fBsystemd.scope\fR(5), \fBsystemd.special\fR(7), \fBsystemd.directives\fR(7) .SH "NOTES" .IP " 1." 4 New Control Group Interfaces diff --git a/upstream/fedora-rawhide/man5/systemd.socket.5 b/upstream/fedora-rawhide/man5/systemd.socket.5 index 1cd05d5c..3112c60a 100644 --- a/upstream/fedora-rawhide/man5/systemd.socket.5 +++ b/upstream/fedora-rawhide/man5/systemd.socket.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.SOCKET" "5" "" "systemd 255" "systemd.socket" +.TH "SYSTEMD\&.SOCKET" "5" "" "systemd 256~rc3" "systemd.socket" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -191,9 +191,10 @@ Socket unit files may include [Unit] and [Install] sections, which are described \fBsystemd.unit\fR(5)\&. .PP Socket unit files must include a [Socket] section, which carries information about the socket or FIFO it supervises\&. A number of options that may be used in this section are shared with other unit types\&. These options are documented in -\fBsystemd.exec\fR(5) +\fBsystemd.exec\fR(5), +\fBsystemd.kill\fR(5) and -\fBsystemd.kill\fR(5)\&. The options specific to the [Socket] section of socket units are the following: +\fBsystemd.resource-control\fR(5)\&. The options specific to the [Socket] section of socket units are the following: .PP \fIListenStream=\fR, \fIListenDatagram=\fR, \fIListenSequentialPacket=\fR .RS 4 @@ -243,6 +244,13 @@ address in the family\&. The CID is a unique 32\-bit integer identifier in \fBAF_VSOCK\fR analogous to an IP address\&. Specifying the CID is optional, and may be set to the empty string\&. +"vsock" +may be replaced with +"vsock\-stream", +"vsock\-dgram" +or +"vsock\-seqpacket" +to force usage of the corresponding socket type\&. .sp Note that \fBSOCK_SEQPACKET\fR @@ -453,9 +461,11 @@ or datagram sockets\&. Defaults to 64\&. .PP \fIMaxConnectionsPerSource=\fR .RS 4 -The maximum number of connections for a service per source IP address\&. This is very similar to the +The maximum number of connections for a service per source IP address (in case of IPv4/IPv6), per source CID (in case of +\fBAF_VSOCK\fR), or source UID (in case of +\fBAF_UNIX\fR)\&. This is very similar to the \fIMaxConnections=\fR -directive above\&. Disabled by default\&. +directive above\&. Defaults to 0, i\&.e\&. disabled\&. .sp Added in version 232\&. .RE @@ -727,7 +737,7 @@ Added in version 247\&. .RS 4 Takes a string value\&. Controls the TCP congestion algorithm used by this socket\&. Should be one of "westwood", -"veno", +"reno", "cubic", "lp" or any other available algorithm supported by the IP stack\&. This setting applies only to stream sockets\&. @@ -853,6 +863,21 @@ These setting defaults to 150 (in case of Added in version 255\&. .RE .PP +\fIPassFileDescriptorsToExec=\fR +.RS 4 +Takes a boolean argument\&. Defaults to off\&. If enabled, file descriptors created by the socket unit are passed to +\fIExecStartPost=\fR, +\fIExecStopPre=\fR, and +\fIExecStopPost=\fR +commands from the socket unit\&. The passed file descriptors can be accessed with +\fBsd_listen_fds\fR(3) +as if the commands were invoked from the associated service units\&. Note that +\fIExecStartPre=\fR +command cannot access socket file descriptors\&. +.sp +Added in version 256\&. +.RE +.PP Check \fBsystemd.unit\fR(5), \fBsystemd.exec\fR(5), and @@ -860,23 +885,10 @@ Check for more settings\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd-system.conf\fR(5), -\fBsystemd.unit\fR(5), -\fBsystemd.exec\fR(5), -\fBsystemd.kill\fR(5), -\fBsystemd.resource-control\fR(5), -\fBsystemd.service\fR(5), -\fBsystemd.directives\fR(7), -\fBsd_listen_fds\fR(3), -\fBsd_listen_fds_with_names\fR(3) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-system.conf\fR(5), \fBsystemd.unit\fR(5), \fBsystemd.exec\fR(5), \fBsystemd.kill\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.service\fR(5), \fBsystemd.directives\fR(7), \fBsd_listen_fds\fR(3), \fBsd_listen_fds_with_names\fR(3) .PP For more extensive descriptions see the "systemd for Developers" series: -\m[blue]\fBSocket Activation\fR\m[]\&\s-2\u[4]\d\s+2, -\m[blue]\fBSocket Activation, part II\fR\m[]\&\s-2\u[5]\d\s+2, -\m[blue]\fBConverting inetd Services\fR\m[]\&\s-2\u[6]\d\s+2, -\m[blue]\fBSocket Activated Internet Services and OS Containers\fR\m[]\&\s-2\u[7]\d\s+2\&. +\m[blue]\fBSocket Activation\fR\m[]\&\s-2\u[4]\d\s+2, \m[blue]\fBSocket Activation, part II\fR\m[]\&\s-2\u[5]\d\s+2, \m[blue]\fBConverting inetd Services\fR\m[]\&\s-2\u[6]\d\s+2, \m[blue]\fBSocket Activated Internet Services and OS Containers\fR\m[]\&\s-2\u[7]\d\s+2\&. .SH "NOTES" .IP " 1." 4 USB FunctionFS diff --git a/upstream/fedora-rawhide/man5/systemd.swap.5 b/upstream/fedora-rawhide/man5/systemd.swap.5 index 1cb7edb2..3adcd21b 100644 --- a/upstream/fedora-rawhide/man5/systemd.swap.5 +++ b/upstream/fedora-rawhide/man5/systemd.swap.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.SWAP" "5" "" "systemd 255" "systemd.swap" +.TH "SYSTEMD\&.SWAP" "5" "" "systemd 256~rc3" "systemd.swap" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -176,13 +176,14 @@ Swap unit files may include [Unit] and [Install] sections, which are described i \fBsystemd.unit\fR(5)\&. .PP Swap unit files must include a [Swap] section, which carries information about the swap device it supervises\&. A number of options that may be used in this section are shared with other unit types\&. These options are documented in -\fBsystemd.exec\fR(5) +\fBsystemd.exec\fR(5), +\fBsystemd.kill\fR(5) and -\fBsystemd.kill\fR(5)\&. The options specific to the [Swap] section of swap units are the following: +\fBsystemd.resource-control\fR(5)\&. The options specific to the [Swap] section of swap units are the following: .PP \fIWhat=\fR .RS 4 -Takes an absolute path of a device node or file to use for paging\&. See +Takes an absolute path or a fstab\-style identifier of a device node or file to use for paging\&. See \fBswapon\fR(8) for details\&. If this refers to a device node, a dependency on the respective device unit is automatically created\&. (See \fBsystemd.device\fR(5) @@ -233,15 +234,4 @@ Check for more settings\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd-system.conf\fR(5), -\fBsystemd.unit\fR(5), -\fBsystemd.exec\fR(5), -\fBsystemd.kill\fR(5), -\fBsystemd.resource-control\fR(5), -\fBsystemd.device\fR(5), -\fBsystemd.mount\fR(5), -\fBswapon\fR(8), -\fBsystemd-fstab-generator\fR(8), -\fBsystemd.directives\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-system.conf\fR(5), \fBsystemd.unit\fR(5), \fBsystemd.exec\fR(5), \fBsystemd.kill\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.device\fR(5), \fBsystemd.mount\fR(5), \fBswapon\fR(8), \fBsystemd-fstab-generator\fR(8), \fBsystemd.directives\fR(7) diff --git a/upstream/fedora-rawhide/man5/systemd.target.5 b/upstream/fedora-rawhide/man5/systemd.target.5 index ba0aa547..8d5cb678 100644 --- a/upstream/fedora-rawhide/man5/systemd.target.5 +++ b/upstream/fedora-rawhide/man5/systemd.target.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.TARGET" "5" "" "systemd 255" "systemd.target" +.TH "SYSTEMD\&.TARGET" "5" "" "systemd 256~rc3" "systemd.target" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -170,8 +170,4 @@ without modifying them by using \fBsystemctl add\-wants\fR\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemd.special\fR(7), -\fBsystemd.directives\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.special\fR(7), \fBsystemd.directives\fR(7) diff --git a/upstream/fedora-rawhide/man5/systemd.timer.5 b/upstream/fedora-rawhide/man5/systemd.timer.5 index de75ccde..1f5a8fce 100644 --- a/upstream/fedora-rawhide/man5/systemd.timer.5 +++ b/upstream/fedora-rawhide/man5/systemd.timer.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.TIMER" "5" "" "systemd 255" "systemd.timer" +.TH "SYSTEMD\&.TIMER" "5" "" "systemd 256~rc3" "systemd.timer" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -378,11 +378,4 @@ section in \fBsystemd.exec\fR(5) for more details\&. .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemd.service\fR(5), -\fBsystemd.time\fR(7), -\fBsystemd.directives\fR(7), -\fBsystemd-system.conf\fR(5), -\fBprctl\fR(2) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.service\fR(5), \fBsystemd.time\fR(7), \fBsystemd.directives\fR(7), \fBsystemd-system.conf\fR(5), \fBprctl\fR(2) diff --git a/upstream/fedora-rawhide/man5/systemd.unit.5 b/upstream/fedora-rawhide/man5/systemd.unit.5 index 9c3e27c6..7e3e6fae 100644 --- a/upstream/fedora-rawhide/man5/systemd.unit.5 +++ b/upstream/fedora-rawhide/man5/systemd.unit.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.UNIT" "5" "" "systemd 255" "systemd.unit" +.TH "SYSTEMD\&.UNIT" "5" "" "systemd 256~rc3" "systemd.unit" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,52 +23,92 @@ systemd.unit \- Unit configuration .SH "SYNOPSIS" .PP -\fIservice\fR\&.service, -\fIsocket\fR\&.socket, -\fIdevice\fR\&.device, -\fImount\fR\&.mount, -\fIautomount\fR\&.automount, -\fIswap\fR\&.swap, -\fItarget\fR\&.target, -\fIpath\fR\&.path, -\fItimer\fR\&.timer, -\fIslice\fR\&.slice, -\fIscope\fR\&.scope +\fIservice\fR\&.service, \fIsocket\fR\&.socket, \fIdevice\fR\&.device, \fImount\fR\&.mount, \fIautomount\fR\&.automount, \fIswap\fR\&.swap, \fItarget\fR\&.target, \fIpath\fR\&.path, \fItimer\fR\&.timer, \fIslice\fR\&.slice, \fIscope\fR\&.scope .SS "System Unit Search Path" .PP -.nf +.RS 4 /etc/systemd/system\&.control/* +.RE +.RS 4 /run/systemd/system\&.control/* +.RE +.RS 4 /run/systemd/transient/* +.RE +.RS 4 /run/systemd/generator\&.early/* +.RE +.RS 4 /etc/systemd/system/* +.RE +.RS 4 /etc/systemd/system\&.attached/* +.RE +.RS 4 /run/systemd/system/* +.RE +.RS 4 /run/systemd/system\&.attached/* +.RE +.RS 4 /run/systemd/generator/* +.RE +.RS 4 \&... +.RE +.RS 4 /usr/lib/systemd/system/* +.RE +.RS 4 /run/systemd/generator\&.late/* -.fi +.RE .SS "User Unit Search Path" .PP -.nf +.RS 4 ~/\&.config/systemd/user\&.control/* +.RE +.RS 4 $XDG_RUNTIME_DIR/systemd/user\&.control/* +.RE +.RS 4 $XDG_RUNTIME_DIR/systemd/transient/* +.RE +.RS 4 $XDG_RUNTIME_DIR/systemd/generator\&.early/* +.RE +.RS 4 ~/\&.config/systemd/user/* +.RE +.RS 4 $XDG_CONFIG_DIRS/systemd/user/* +.RE +.RS 4 /etc/systemd/user/* +.RE +.RS 4 $XDG_RUNTIME_DIR/systemd/user/* +.RE +.RS 4 /run/systemd/user/* +.RE +.RS 4 $XDG_RUNTIME_DIR/systemd/generator/* +.RE +.RS 4 $XDG_DATA_HOME/systemd/user/* +.RE +.RS 4 $XDG_DATA_DIRS/systemd/user/* +.RE +.RS 4 \&... +.RE +.RS 4 /usr/lib/systemd/user/* +.RE +.RS 4 $XDG_RUNTIME_DIR/systemd/generator\&.late/* -.fi +.RE .SH "DESCRIPTION" .PP A unit file is a plain text ini\-style file that encodes information about a service, a socket, a device, a mount point, an automount point, a swap file or partition, a start\-up target, a watched file system path, a timer controlled and supervised by @@ -152,7 +192,7 @@ Aliases obey the following restrictions: a unit of a certain type ("\&.service", "alias@inst\&.service") may be a symlink to different template (e\&.g\&. "template@inst\&.service")\&. In that case, just this specific instance is aliased, while other instances of the template (e\&.g\&. "alias@foo\&.service", -"alias@bar\&.service") are not aliased\&. Those rules preserve the requirement that the instance (if any) is always uniquely defined for a given unit and all its aliases\&. The target of alias symlink must point to a valid unit file location, i\&.e\&. the symlink target name must match the symlink source name as described, and the destination path must be in one of the unit search paths, see UNIT FILE LOAD PATH section below for more details\&. Note that the target file may not exist, i\&.e\&. the symlink may be dangling\&. +"alias@bar\&.service") are not aliased\&. Those rules preserve the requirement that the instance (if any) is always uniquely defined for a given unit and all its aliases\&. The target of alias symlink must point to a valid unit file location, i\&.e\&. the symlink target name must match the symlink source name as described, and the destination path must be in one of the unit search paths, see UNIT FILE LOAD PATH section below for more details\&. Note that the target file might not exist, i\&.e\&. the symlink may be dangling\&. .PP Unit files may specify aliases through the \fIAlias=\fR @@ -199,7 +239,7 @@ commands of \&.wants/ or \&.requires/ -must thus point to a valid unit file location, i\&.e\&. the symlink target name must satisfy the described requirements, and the destination path must be in one of the unit search paths, see UNIT FILE LOAD PATH section below for more details\&. Note that the target file may not exist, i\&.e\&. the symlink may be dangling\&. +must thus point to a valid unit file location, i\&.e\&. the symlink target name must satisfy the described requirements, and the destination path must be in one of the unit search paths, see UNIT FILE LOAD PATH section below for more details\&. Note that the target file might not exist, i\&.e\&. the symlink may be dangling\&. .PP Along with a unit file foo\&.service, a "drop\-in" directory @@ -1057,6 +1097,17 @@ local\-fs\&.target, but are still honored for the purposes of this option, i\&.e Added in version 201\&. .RE .PP +\fIWantsMountsFor=\fR +.RS 4 +Same as +\fIRequiresMountsFor=\fR, but adds dependencies of type +\fIWants=\fR +instead of +\fIRequires=\fR\&. +.sp +Added in version 256\&. +.RE +.PP \fIOnSuccessJobMode=\fR, \fIOnFailureJobMode=\fR .RS 4 Takes a value of @@ -1196,11 +1247,8 @@ Configure the action to take when the unit stops and enters a failed state or in and \fBhalt\-immediate\fR\&. In system mode, all options are allowed\&. In user mode, only \fBnone\fR, -\fBexit\fR, -\fBexit\-force\fR, -\fBsoft\-reboot\fR -and -\fBsoft\-reboot\-force\fR +\fBexit\fR, and +\fBexit\-force\fR are allowed\&. Both options default to \fBnone\fR\&. .sp @@ -1290,7 +1338,7 @@ optionally configures an additional action to take when the timeout is hit, see and \fIJobRunningTimeoutSec=\fR above\&. It takes the same values as -\fIStartLimitAction=\fR\&. Defaults to +\fIFailureAction=\fR/\fISuccessAction=\fR\&. Defaults to \fBnone\fR\&. .sp \fIJobTimeoutRebootArgument=\fR @@ -1446,6 +1494,10 @@ Check whether the system is running on a specific architecture\&. Takes one of "arc\-be", or "native"\&. .sp +Use +\fBsystemd-analyze\fR(1) +for the complete list of known architectures\&. +.sp The architecture is determined from the information returned by \fBuname\fR(2) and is thus subject to @@ -1780,7 +1832,7 @@ on the next following boot\&. Units making use of this condition should order th \fBsystemd-update-done.service\fR(8), to make sure they run before the stamp file\*(Aqs modification time gets reset indicating a completed update\&. .sp If the -\fIsystemd\&.condition\-needs\-update=\fR +\fIsystemd\&.condition_needs_update=\fR option is specified on the kernel command line (taking a boolean), it will override the result of this condition check, taking precedence over any file modification time checks\&. If the kernel command line option is used, systemd\-update\-done\&.service will not have immediate effect on any following @@ -1806,12 +1858,19 @@ Added in version 244\&. Takes a boolean argument\&. This condition may be used to conditionalize units on whether the system is booting up for the first time\&. This roughly means that /etc/ was unpopulated when the system started booting (for details, see "First Boot Semantics" in -\fBmachine-id\fR(5))\&. First boot is considered finished (this condition will evaluate as false) after the manager has finished the startup phase\&. +\fBmachine-id\fR(5))\&. First Boot is considered finished (this condition will evaluate as false) after the manager has finished the startup phase\&. .sp This condition may be used to populate /etc/ on the first boot after factory reset, or when a new system instance boots up for the first time\&. .sp +Note that the service manager itself will perform setup steps during First Boot: it will initialize +\fBmachine-id\fR(5) +and preset all units, enabling or disabling them according to the +\fBsystemd.preset\fR(5) +settings\&. Additional setup may be performed via units with +\fIConditionFirstBoot=yes\fR\&. +.sp For robustness, units with \fIConditionFirstBoot=yes\fR should order themselves before @@ -1820,7 +1879,7 @@ and pull in this passive target with \fIWants=\fR\&. This ensures that in a case of an aborted first boot, these units will be re\-run during the next system startup\&. .sp If the -\fIsystemd\&.condition\-first\-boot=\fR +\fIsystemd\&.condition_first_boot=\fR option is specified on the kernel command line (taking a boolean), it will override the result of this condition check, taking precedence over /etc/machine\-id existence checks\&. @@ -2470,6 +2529,7 @@ l l l l l l l l l l l l +l l l l l l. T{ "%a" @@ -2514,6 +2574,13 @@ T}:T{ This is the value of the "$CREDENTIALS_DIRECTORY" environment variable if available\&. See section "Credentials" in \fBsystemd.exec\fR(5) for more information\&. T} T{ +"%D" +T}:T{ +Shared data directory +T}:T{ +This is either /usr/share/ (for the system manager) or the path "$XDG_DATA_HOME" resolves to (for user managers)\&. +T} +T{ "%E" T}:T{ Configuration directory root @@ -2972,26 +3039,7 @@ instance fails it will not trigger an instance named failure\-handler@failure\-handler\&.service\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd-system.conf\fR(5), -\fBsystemd.special\fR(7), -\fBsystemd.service\fR(5), -\fBsystemd.socket\fR(5), -\fBsystemd.device\fR(5), -\fBsystemd.mount\fR(5), -\fBsystemd.automount\fR(5), -\fBsystemd.swap\fR(5), -\fBsystemd.target\fR(5), -\fBsystemd.path\fR(5), -\fBsystemd.timer\fR(5), -\fBsystemd.scope\fR(5), -\fBsystemd.slice\fR(5), -\fBsystemd.time\fR(7), -\fBsystemd-analyze\fR(1), -\fBcapabilities\fR(7), -\fBsystemd.directives\fR(7), -\fBuname\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-system.conf\fR(5), \fBsystemd.special\fR(7), \fBsystemd.service\fR(5), \fBsystemd.socket\fR(5), \fBsystemd.device\fR(5), \fBsystemd.mount\fR(5), \fBsystemd.automount\fR(5), \fBsystemd.swap\fR(5), \fBsystemd.target\fR(5), \fBsystemd.path\fR(5), \fBsystemd.timer\fR(5), \fBsystemd.scope\fR(5), \fBsystemd.slice\fR(5), \fBsystemd.time\fR(7), \fBsystemd-analyze\fR(1), \fBcapabilities\fR(7), \fBsystemd.directives\fR(7), \fBuname\fR(1) .SH "NOTES" .IP " 1." 4 Interface Portability and Stability Promise diff --git a/upstream/fedora-rawhide/man5/sysupdate.d.5 b/upstream/fedora-rawhide/man5/sysupdate.d.5 index 456bdb01..fbf4facb 100644 --- a/upstream/fedora-rawhide/man5/sysupdate.d.5 +++ b/upstream/fedora-rawhide/man5/sysupdate.d.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSUPDATE\&.D" "5" "" "systemd 255" "sysupdate.d" +.TH "SYSUPDATE\&.D" "5" "" "systemd 256~rc3" "sysupdate.d" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,12 +23,15 @@ sysupdate.d \- Transfer Definition Files for Automatic Updates .SH "SYNOPSIS" .PP -.nf +.RS 4 /etc/sysupdate\&.d/*\&.conf +.RE +.RS 4 /run/sysupdate\&.d/*\&.conf +.RE +.RS 4 /usr/lib/sysupdate\&.d/*\&.conf - -.fi +.RE .SH "DESCRIPTION" .PP sysupdate\&.d/*\&.conf @@ -1319,9 +1322,7 @@ and decompresses/unpacks it to is created/updated always pointing to the most recent update\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-sysupdate\fR(8), -\fBsystemd-repart\fR(8) +\fBsystemd\fR(1), \fBsystemd-sysupdate\fR(8), \fBsystemd-repart\fR(8) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man5/sysusers.d.5 b/upstream/fedora-rawhide/man5/sysusers.d.5 index a44d461f..22c19b4b 100644 --- a/upstream/fedora-rawhide/man5/sysusers.d.5 +++ b/upstream/fedora-rawhide/man5/sysusers.d.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSUSERS\&.D" "5" "" "systemd 255" "sysusers.d" +.TH "SYSUSERS\&.D" "5" "" "systemd 256~rc3" "sysusers.d" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,11 +23,15 @@ sysusers.d \- Declarative allocation of system users and groups .SH "SYNOPSIS" .PP +.RS 4 /etc/sysusers\&.d/*\&.conf -.PP +.RE +.RS 4 /run/sysusers\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/sysusers\&.d/*\&.conf +.RE .sp .nf #Type Name ID GECOS Home directory Shell @@ -367,8 +371,7 @@ sysusers\&.d vendor configuration, except to block certain users or groups from being created\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-sysusers\fR(8) +\fBsystemd\fR(1), \fBsystemd-sysusers\fR(8) .SH "NOTES" .IP " 1." 4 User/Group Name Syntax diff --git a/upstream/fedora-rawhide/man5/termcap.5 b/upstream/fedora-rawhide/man5/termcap.5 index a2fc7839..8aefa689 100644 --- a/upstream/fedora-rawhide/man5/termcap.5 +++ b/upstream/fedora-rawhide/man5/termcap.5 @@ -9,7 +9,7 @@ .\" If mistakes in the capabilities are found, please send a bug report to: .\" michael@moria.de .\" Modified Mon Oct 21 17:47:19 EDT 1996 by Eric S. Raymond (esr@thyrsus.com) -.TH termcap 5 2023-10-31 "Linux man-pages 6.06" +.TH termcap 5 2023-10-31 "Linux man-pages 6.7" .SH NAME termcap \- terminal capability database .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/timesyncd.conf.5 b/upstream/fedora-rawhide/man5/timesyncd.conf.5 index 33f0675d..663f10bd 100644 --- a/upstream/fedora-rawhide/man5/timesyncd.conf.5 +++ b/upstream/fedora-rawhide/man5/timesyncd.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "TIMESYNCD\&.CONF" "5" "" "systemd 255" "timesyncd.conf" +.TH "TIMESYNCD\&.CONF" "5" "" "systemd 256~rc3" "timesyncd.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,13 +23,24 @@ timesyncd.conf, timesyncd.conf.d \- Network Time Synchronization configuration files .SH "SYNOPSIS" .PP +.RS 4 /etc/systemd/timesyncd\&.conf -.PP +.RE +.RS 4 +/run/systemd/timesyncd\&.conf +.RE +.RS 4 +/usr/lib/systemd/timesyncd\&.conf +.RE +.RS 4 /etc/systemd/timesyncd\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /run/systemd/timesyncd\&.conf\&.d/*\&.conf -.PP +.RE +.RS 4 /usr/lib/systemd/timesyncd\&.conf\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP These configuration files control NTP network time synchronization\&. See @@ -37,16 +48,16 @@ These configuration files control NTP network time synchronization\&. See for a general description of the syntax\&. .SH "CONFIGURATION DIRECTORIES AND PRECEDENCE" .PP -The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is either in -/usr/lib/systemd/ -or -/etc/systemd/ -and contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in +The default configuration is set during compilation, so configuration is only needed when it is necessary to deviate from those defaults\&. The main configuration file is loaded from one of the listed directories in order of priority, only the first file found is used: +/etc/systemd/, +/run/systemd/, +/usr/local/lib/systemd/, +/usr/lib/systemd/\&. The vendor version of the file contains commented out entries showing the defaults as a guide to the administrator\&. Local overrides can also be created by creating drop\-ins, as described below\&. The main configuration file can also be edited for this purpose (or a copy in /etc/ -if it\*(Aqs shipped in -/usr/) however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. +if it\*(Aqs shipped under +/usr/), however using drop\-ins for local configuration is recommended over modifications to the main configuration file\&. .PP -In addition to the "main" configuration file, drop\-in configuration snippets are read from +In addition to the main configuration file, drop\-in configuration snippets are read from /usr/lib/systemd/*\&.conf\&.d/, /usr/local/lib/systemd/*\&.conf\&.d/, and /etc/systemd/*\&.conf\&.d/\&. Those drop\-ins have higher precedence and override the main configuration file\&. Files in the @@ -56,7 +67,12 @@ configuration subdirectories are sorted by their filename in lexicographic order When packages need to customize the configuration, they can install drop\-ins under /usr/\&. Files in /etc/ -are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defined a concept of drop\-in priority to allow distributions to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. +are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. Drop\-ins have to be used to override package drop\-ins, since the main configuration file has lower precedence\&. It is recommended to prefix all filenames in those subdirectories with a two\-digit number and a dash, to simplify the ordering of the files\&. This also defines a concept of drop\-in priorities to allow OS vendors to ship drop\-ins within a specific range lower than the range used by users\&. This should lower the risk of package drop\-ins overriding accidentally drop\-ins defined by users\&. It is recommended to use the range 10\-40 for drop\-ins in +/usr/ +and the range 60\-90 for drop\-ins in +/etc/ +and +/run/, to make sure that local and transient drop\-ins take priority over drop\-ins shipped by the OS vendor\&. .PP To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to /dev/null @@ -135,6 +151,4 @@ Added in version 250\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-timesyncd.service\fR(8), -\fBsystemd-networkd.service\fR(8) +\fBsystemd\fR(1), \fBsystemd-timesyncd.service\fR(8), \fBsystemd-networkd.service\fR(8) diff --git a/upstream/fedora-rawhide/man5/tmpfiles.d.5 b/upstream/fedora-rawhide/man5/tmpfiles.d.5 index 9c32f27f..f84439b7 100644 --- a/upstream/fedora-rawhide/man5/tmpfiles.d.5 +++ b/upstream/fedora-rawhide/man5/tmpfiles.d.5 @@ -1,5 +1,5 @@ '\" t -.TH "TMPFILES\&.D" "5" "" "systemd 255" "tmpfiles.d" +.TH "TMPFILES\&.D" "5" "" "systemd 256~rc3" "tmpfiles.d" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,25 +20,34 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -tmpfiles.d \- Configuration for creation, deletion and cleaning of volatile and temporary files +tmpfiles.d \- Configuration for creation, deletion, and cleaning of files and directories .SH "SYNOPSIS" .PP -.nf +.RS 4 /etc/tmpfiles\&.d/*\&.conf +.RE +.RS 4 /run/tmpfiles\&.d/*\&.conf +.RE +.RS 4 /usr/lib/tmpfiles\&.d/*\&.conf - -.fi +.RE .PP -.nf +.RS 4 ~/\&.config/user\-tmpfiles\&.d/*\&.conf +.RE +.RS 4 $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf +.RE +.RS 4 ~/\&.local/share/user\-tmpfiles\&.d/*\&.conf +.RE +.RS 4 \&... +.RE +.RS 4 /usr/share/user\-tmpfiles\&.d/*\&.conf - -.fi - +.RE .sp .nf #Type Path Mode User Group Age Argument @@ -326,21 +335,13 @@ Added in version 214\&. .PP \fIx\fR .RS 4 -Ignore a path during cleaning\&. Use this type to exclude paths from clean\-up as controlled with the Age parameter\&. Note that lines of this type do not influence the effect of -\fIr\fR -or -\fIR\fR -lines\&. Lines of this type accept shell\-style globs in place of normal path names\&. +Ignore a path during cleaning\&. Use this type to exclude paths from clean\-up as controlled with the Age parameter\&. Lines of this type accept shell\-style globs in place of normal path names\&. .RE .PP \fIX\fR .RS 4 Ignore a path during cleaning\&. Use this type to exclude paths from clean\-up as controlled with the Age parameter\&. Unlike -\fIx\fR, this parameter will not exclude the content if path is a directory, but only directory itself\&. Note that lines of this type do not influence the effect of -\fIr\fR -or -\fIR\fR -lines\&. Lines of this type accept shell\-style globs in place of normal path names\&. +\fIx\fR, this parameter will not exclude the content if path is a directory, but only directory itself\&. Lines of this type accept shell\-style globs in place of normal path names\&. .sp Added in version 198\&. .RE @@ -513,7 +514,7 @@ and are combined Base64 decoding is applied to the credential contents\&. .PP Note that for all line types that result in creation of any kind of file node (i\&.e\&. -\fIf\fR/\fIF\fR, +\fIf\fR, \fId\fR/\fID\fR/\fIv\fR/\fIq\fR/\fIQ\fR, \fIp\fR, \fIL\fR, @@ -661,8 +662,8 @@ and \fIb\fR, determines the major/minor of the device node, with major and minor formatted as integers, separated by ":", e\&.g\&. "1:3"\&. For -\fIf\fR, -\fIF\fR, and +\fIf\fR +and \fIw\fR, the argument may be used to specify a short string that is written to the file, suffixed by a newline\&. For \fIC\fR, specifies the source file or directory\&. For \fIt\fR @@ -1000,7 +1001,7 @@ will be removed on boot\&. The directory will not be created\&. .RS 4 .\} .nf -\-smbios type=11,value=io\&.systemd\&.credential\&.binary:tmpfiles\&.extra=$(echo "f~ /root/\&.ssh/authorized_keys 700 root root \- $(ssh\-add \-L | base64 \-w 0)" | base64 \-w 0) +\-smbios type=11,value=io\&.systemd\&.credential\&.binary:tmpfiles\&.extra=$(echo \-e "d /root/\&.ssh 0750 root root \-\enf~ /root/\&.ssh/authorized_keys 0600 root root \- $(ssh\-add \-L | base64 \-w 0)" | base64 \-w 0) .fi .if n \{\ .RE @@ -1021,18 +1022,7 @@ will warn if is used\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-tmpfiles\fR(8), -\fBsystemd-delta\fR(1), -\fBsystemd.exec\fR(5), -\fBattr\fR(5), -\fBgetfattr\fR(1), -\fBsetfattr\fR(1), -\fBsetfacl\fR(1), -\fBgetfacl\fR(1), -\fBchattr\fR(1), -\fBbtrfs-subvolume\fR(8), -\fBbtrfs-qgroup\fR(8) +\fBsystemd\fR(1), \fBsystemd-tmpfiles\fR(8), \fBsystemd-delta\fR(1), \fBsystemd.exec\fR(5), \fBattr\fR(5), \fBgetfattr\fR(1), \fBsetfattr\fR(1), \fBsetfacl\fR(1), \fBgetfacl\fR(1), \fBchattr\fR(1), \fBbtrfs-subvolume\fR(8), \fBbtrfs-qgroup\fR(8) .SH "NOTES" .IP " 1." 4 Base64 decoded diff --git a/upstream/fedora-rawhide/man5/tmpfs.5 b/upstream/fedora-rawhide/man5/tmpfs.5 index b7c5f407..55fc8265 100644 --- a/upstream/fedora-rawhide/man5/tmpfs.5 +++ b/upstream/fedora-rawhide/man5/tmpfs.5 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH tmpfs 5 2023-10-31 "Linux man-pages 6.06" +.TH tmpfs 5 2023-10-31 "Linux man-pages 6.7" .SH NAME tmpfs \- a virtual memory filesystem .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/ttytype.5 b/upstream/fedora-rawhide/man5/ttytype.5 index 3e9a5a3d..ebe0866a 100644 --- a/upstream/fedora-rawhide/man5/ttytype.5 +++ b/upstream/fedora-rawhide/man5/ttytype.5 @@ -7,7 +7,7 @@ .\" Modified Thu Oct 19 21:25:21 MET 1995 by Martin Schulze <joey@infodrom.north.de> .\" Modified Mon Oct 21 17:47:19 EDT 1996 by Eric S. Raymond .\" <esr@thyrsus.com>xk -.TH ttytype 5 2023-10-31 "Linux man-pages 6.06" +.TH ttytype 5 2023-10-31 "Linux man-pages 6.7" .SH NAME ttytype \- terminal device to default terminal type mapping .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man5/tzfile.5 b/upstream/fedora-rawhide/man5/tzfile.5 index 45afecc1..4aa3f6c2 100644 --- a/upstream/fedora-rawhide/man5/tzfile.5 +++ b/upstream/fedora-rawhide/man5/tzfile.5 @@ -26,23 +26,24 @@ a signed binary integer is represented using two's complement, and a boolean is represented by a one-byte binary integer that is either 0 (false) or 1 (true). The format begins with a 44-byte header containing the following fields: -.IP * 2 +.RS 2 +.IP \(bu 3 The magic four-byte ASCII sequence .q "TZif" identifies the file as a timezone information file. -.IP * +.IP \(bu A byte identifying the version of the file's format (as of 2021, either an ASCII NUL, .q "2", .q "3", or .q "4" ). -.IP * +.IP \(bu Fifteen bytes containing zeros reserved for future use. -.IP * +.IP \(bu Six four-byte integer values, in the following order: .RS -.TP +.TP 2 .B tzh_ttisutcnt The number of UT/local indicators stored in the file. (UT is Universal Time.) @@ -65,17 +66,19 @@ in the file (must not be zero). The number of bytes of time zone abbreviation strings stored in the file. .RE -.P +.RE +.PP The above header is followed by the following fields, whose lengths depend on the contents of the header: -.IP * 2 +.RS 2 +.IP \(bu 3 .B tzh_timecnt four-byte signed integer values sorted in ascending order. These values are written in network byte order. Each is used as a transition time (as returned by .BR time (2)) at which the rules for computing local time change. -.IP * +.IP \(bu .B tzh_timecnt one-byte unsigned integer values; each one but the last tells which of the different types of local time types @@ -83,22 +86,22 @@ described in the file is associated with the time period starting with the same-indexed transition time and continuing up to but not including the next transition time. (The last time type is present only for consistency checking with the -POSIX-style TZ string described below.) +POSIX.1-2017-style TZ string described below.) These values serve as indices into the next field. -.IP * +.IP \(bu .B tzh_typecnt .B ttinfo entries, each defined as follows: -.in +.5i +.in +2 .sp .nf -.ta .5i +\w'unsigned char\0\0'u +.ta \w'\0\0\0\0'u +\w'unsigned char\0'u struct ttinfo { int32_t tt_utoff; unsigned char tt_isdst; unsigned char tt_desigidx; }; -.in -.5i +.in .fi .sp Each structure is written as a four-byte signed integer value for @@ -132,7 +135,7 @@ Also, in realistic applications is in the range [\-89999, 93599] (i.e., more than \-25 hours and less than 26 hours); this allows easy support by implementations that already support the POSIX-required range [\-24:59:59, 25:59:59]. -.IP * +.IP \(bu .B tzh_charcnt bytes that represent time zone designations, which are null-terminated byte strings, each indexed by the @@ -140,7 +143,7 @@ which are null-terminated byte strings, each indexed by the values mentioned above. The byte strings can overlap if one is a suffix of the other. The encoding of these strings is not specified. -.IP * +.IP \(bu .B tzh_leapcnt pairs of four-byte values, written in network byte order; the first value of each pair gives the nonnegative time @@ -167,22 +170,24 @@ otherwise, for timestamps before the first occurrence time, the leap-second correction is zero if the first pair's correction is 1 or \-1, and is unspecified otherwise (which can happen only in files truncated at the start). -.IP * +.IP \(bu .B tzh_ttisstdcnt standard/wall indicators, each stored as a one-byte boolean; they tell whether the transition times associated with local time types were specified as standard time or local (wall clock) time. -.IP * +.IP \(bu .B tzh_ttisutcnt UT/local indicators, each stored as a one-byte boolean; they tell whether the transition times associated with local time types were specified as UT or local time. If a UT/local indicator is set, the corresponding standard/wall indicator must also be set. -.P +.RE +.PP The standard/wall and UT/local indicators were designed for transforming a TZif file's transition times into transitions appropriate -for another time zone specified via a POSIX-style TZ string that lacks rules. +for another time zone specified via +a POSIX.1-2017-style TZ string that lacks rules. For example, when TZ="EET\*-2EEST" and there is no TZif file "EET\*-2EEST", the idea was to adapt the transition times from a TZif file with the well-known name "posixrules" that is present only for this purpose and @@ -194,7 +199,7 @@ so users desiring (say) Greek time should instead specify TZ="Europe/Athens" for better historical coverage, falling back on TZ="EET\*-2EEST,M3.5.0/3,M10.5.0/4" if POSIX conformance is required and older timestamps need not be handled accurately. -.P +.PP The .BR localtime (3) function @@ -211,13 +216,14 @@ the above header and data are followed by a second header and data, identical in format except that eight bytes are used for each transition time or leap second time. (Leap second counts remain four bytes.) -After the second header and data comes a newline-enclosed, -POSIX-TZ-environment-variable-style string for use in handling instants +After the second header and data comes a newline-enclosed string +in the style of the contents of a POSIX.1-2017 TZ environment variable, +for use in handling instants after the last transition time stored in the file or for all instants if the file has no transitions. -The POSIX-style TZ string is empty (i.e., nothing between the newlines) -if there is no POSIX-style representation for such instants. -If nonempty, the POSIX-style TZ string must agree with the local time +The TZ string is empty (i.e., nothing between the newlines) +if there is no POSIX.1-2017-style representation for such instants. +If nonempty, the TZ string must agree with the local time type after the last transition time if present in the eight-byte data; for example, given the string .q "WET0WEST,M3.5.0/1,M10.5.0" @@ -229,8 +235,8 @@ Also, if there is at least one transition, time type 0 is associated with the time period from the indefinite past up to but not including the earliest transition time. .SS Version 3 format -For version-3-format timezone files, the POSIX-TZ-style string may -use two minor extensions to the POSIX TZ format, as described in +For version-3-format timezone files, the TZ string may +use two minor extensions to the POSIX.1-2017 TZ format, as described in .BR newtzset (3). First, the hours part of its transition times may be signed and range from \-167 through 167 instead of the POSIX-required unsigned values @@ -250,14 +256,14 @@ releases will likely add leap second entries after the expiration, and the added leap seconds will change how post-expiration timestamps are treated. .SS Interoperability considerations Future changes to the format may append more data. -.P +.PP Version 1 files are considered a legacy format and should not be generated, as they do not support transition times after the year 2038. Readers that understand only Version 1 must ignore any data that extends beyond the calculated end of the version 1 data block. -.P +.PP Other than version 1, writers should generate the lowest version number needed by a file's data. For example, a writer should generate a version 4 file @@ -266,7 +272,7 @@ Likewise, a writer not generating a version 4 file should generate a version 3 file only if TZ string extensions are necessary to accurately model transition times. -.P +.PP The sequence of time changes defined by the version 1 header and data block should be a contiguous sub-sequence of the time changes defined by the version 2+ header and data @@ -278,12 +284,12 @@ supporting obsolescent readers use a .B tzh_timecnt of zero in the version 1 data block to save space. -.P +.PP When a TZif file contains a leap second table expiration time, TZif readers should either refuse to process post-expiration timestamps, or process them as if the expiration time did not exist (possibly with an error indication). -.P +.PP Time zone designations should consist of at least three (3) and no more than six (6) ASCII characters from the set of alphanumerics, @@ -292,15 +298,15 @@ and .q "+". This is for compatibility with POSIX requirements for time zone abbreviations. -.P +.PP When reading a version 2 or higher file, readers should ignore the version 1 header and data block except for the purpose of skipping over them. -.P +.PP Readers should calculate the total lengths of the headers and data blocks and check that they all fit within the actual file size, as part of a validity check for the file. -.P +.PP When a positive leap second occurs, readers should append an extra second to the local minute containing the second just before the leap second. If this occurs when the UTC offset is not a multiple of 60 @@ -312,16 +318,18 @@ This section documents common problems in reading or writing TZif files. Most of these are problems in generating TZif files for use by older readers. The goals of this section are: -.IP * 2 +.RS 2 +.IP \(bu 3 to help TZif writers output files that avoid common pitfalls in older or buggy TZif readers, -.IP * +.IP \(bu to help TZif readers avoid common pitfalls when reading files generated by future TZif writers, and -.IP * +.IP \(bu to help any future specification authors see what sort of problems arise when the TZif format is changed. -.P +.RE +.PP When new versions of the TZif format have been defined, a design goal has been that a reader can successfully use a TZif file even if the file is of a later TZif version than what the @@ -333,23 +341,24 @@ new-version data useful even for older-version readers. This section attempts to document these compatibility issues and workarounds, as well as to document other common bugs in readers. -.P +.PP Interoperability problems with TZif include the following: -.IP * 2 +.RS 2 +.IP \(bu 3 Some readers examine only version 1 data. As a partial workaround, a writer can output as much version 1 data as possible. However, a reader should ignore version 1 data, and should use version 2+ data even if the reader's native timestamps have only 32 bits. -.IP * +.IP \(bu Some readers designed for version 2 might mishandle timestamps after a version 3 or higher file's last transition, because -they cannot parse extensions to POSIX in the TZ-like string. +they cannot parse extensions to POSIX.1-2017 in the TZ-like string. As a partial workaround, a writer can output more transitions than necessary, so that only far-future timestamps are mishandled by version 2 readers. -.IP * +.IP \(bu Some readers designed for version 2 do not support permanent daylight saving time with transitions after 24:00 \(en e.g., a TZ string @@ -367,22 +376,22 @@ for the next time zone east \(en e.g., .q "AST4" for permanent Atlantic Standard Time (\-04). -.IP * +.IP \(bu Some readers designed for version 2 or 3, and that require strict conformance to RFC 8536, reject version 4 files whose leap second tables are truncated at the start or that end in expiration times. -.IP * +.IP \(bu Some readers ignore the footer, and instead predict future timestamps from the time type of the last transition. As a partial workaround, a writer can output more transitions than necessary. -.IP * +.IP \(bu Some readers do not use time type 0 for timestamps before the first transition, in that they infer a time type using a heuristic that does not always select time type 0. As a partial workaround, a writer can output a dummy (no-op) first transition at an early time. -.IP * +.IP \(bu Some readers mishandle timestamps before the first transition that has a timestamp not less than \-2**31. Readers that support only 32-bit timestamps are likely to be @@ -391,12 +400,12 @@ more prone to this problem, for example, when they process bits. As a partial workaround, a writer can output a dummy transition at timestamp \-2**31. -.IP * +.IP \(bu Some readers mishandle a transition if its timestamp has the minimum possible signed 64-bit value. Timestamps less than \-2**59 are not recommended. -.IP * -Some readers mishandle POSIX-style TZ strings that +.IP \(bu +Some readers mishandle TZ strings that contain .q "<" or @@ -407,11 +416,11 @@ or .q ">" for time zone abbreviations containing only alphabetic characters. -.IP * +.IP \(bu Many readers mishandle time zone abbreviations that contain non-ASCII characters. These characters are not recommended. -.IP * +.IP \(bu Some readers may mishandle time zone abbreviations that contain fewer than 3 or more than 6 characters, or that contain ASCII characters other than alphanumerics, @@ -419,23 +428,23 @@ contain ASCII characters other than alphanumerics, and .q "+". These abbreviations are not recommended. -.IP * +.IP \(bu Some readers mishandle TZif files that specify daylight-saving time UT offsets that are less than the UT offsets for the corresponding standard time. These readers do not support locations like Ireland, which -uses the equivalent of the POSIX TZ string +uses the equivalent of the TZ string .q "IST\*-1GMT0,M10.5.0,M3.5.0/1", observing standard time (IST, +01) in summer and daylight saving time (GMT, +00) in winter. As a partial workaround, a writer can output data for the -equivalent of the POSIX TZ string +equivalent of the TZ string .q "GMT0IST,M3.5.0/1,M10.5.0", thus swapping standard and daylight saving time. Although this workaround misidentifies which part of the year uses daylight saving time, it records UT offsets and time zone abbreviations correctly. -.IP * +.IP \(bu Some readers generate ambiguous timestamps for positive leap seconds that occur when the UTC offset is not a multiple of 60 seconds. For example, in a timezone with UTC offset +01:23:45 and with @@ -446,38 +455,41 @@ instead of mapping the latter to 01:23:46, and they will map 78796815 to This has not yet been a practical problem, since no civil authority has observed such UTC offsets since leap seconds were introduced in 1972. -.P +.RE +.PP Some interoperability problems are reader bugs that are listed here mostly as warnings to developers of readers. -.IP * 2 +.RS 2 +.IP \(bu 3 Some readers do not support negative timestamps. Developers of distributed applications should keep this in mind if they need to deal with pre-1970 data. -.IP * +.IP \(bu Some readers mishandle timestamps before the first transition that has a nonnegative timestamp. Readers that do not support negative timestamps are likely to be more prone to this problem. -.IP * +.IP \(bu Some readers mishandle time zone abbreviations like .q "\*-08" that contain .q "+", .q "\*-", or digits. -.IP * +.IP \(bu Some readers mishandle UT offsets that are out of the traditional range of \-12 through +12 hours, and so do not support locations like Kiritimati that are outside this range. -.IP * +.IP \(bu Some readers mishandle UT offsets in the range [\-3599, \-1] seconds from UT, because they integer-divide the offset by 3600 to get 0 and then display the hour part as .q "+00". -.IP * +.IP \(bu Some readers mishandle UT offsets that are not a multiple of one hour, or of 15 minutes, or of 1 minute. +.RE .SH SEE ALSO .BR time (2), .BR localtime (3), @@ -485,7 +497,7 @@ of one hour, or of 15 minutes, or of 1 minute. .BR tzselect (8), .BR zdump (8), .BR zic (8). -.P +.PP Olson A, Eggert P, Murchison K. The Time Zone Information Format (TZif). 2019 Feb. .UR https://\:datatracker.ietf.org/\:doc/\:html/\:rfc8536 diff --git a/upstream/fedora-rawhide/man5/udev.conf.5 b/upstream/fedora-rawhide/man5/udev.conf.5 index db1e9cec..635aa734 100644 --- a/upstream/fedora-rawhide/man5/udev.conf.5 +++ b/upstream/fedora-rawhide/man5/udev.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV\&.CONF" "5" "" "systemd 255" "udev.conf" +.TH "UDEV\&.CONF" "5" "" "systemd 256~rc3" "udev.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,15 +20,35 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -udev.conf \- Configuration for device event managing daemon +udev.conf, udev.conf.d \- Configuration for device event managing daemon .SH "SYNOPSIS" .PP +.RS 4 /etc/udev/udev\&.conf +.RE +.RS 4 +/run/udev/udev\&.conf +.RE +.RS 4 +/usr/lib/udev/udev\&.conf +.RE +.RS 4 +/etc/udev/udev\&.conf\&.d/*\&.conf +.RE +.RS 4 +/run/udev/udev\&.conf\&.d/*\&.conf +.RE +.RS 4 +/usr/lib/udev/udev\&.conf\&.d/*\&.conf +.RE .SH "DESCRIPTION" .PP -\fBsystemd-udevd\fR(8) -expects its main configuration file at -/etc/udev/udev\&.conf\&. It consists of a set of variables allowing the user to override default udev values\&. All empty lines or lines beginning with \*(Aq#\*(Aq are ignored\&. The following variables can be set: +These files contain configuration options for +\fBsystemd-udevd\fR(8)\&. The syntax of these files is very simple: a list of assignments, one per line\&. All empty lines or lines beginning with +"#" +are ignored\&. +.PP +The following options can be set: .PP \fIudev_log=\fR .RS 4 @@ -37,7 +57,22 @@ The log level\&. Valid values are the numerical syslog priorities or their textu \fBinfo\fR and \fBdebug\fR\&. +.if n \{\ .sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBNote\fR +.ps -1 +.br +This option is also honored by +\fBudevadm\fR(8)\&. +.sp .5v +.RE Added in version 216\&. .RE .PP @@ -107,6 +142,4 @@ can be configured by command line options and the kernel command line (see \fBsystemd-udevd\fR(8))\&. .SH "SEE ALSO" .PP -\fBsystemd-udevd\fR(8), -\fBudev\fR(7), -\fBudevadm\fR(8) +\fBsystemd-udevd\fR(8), \fBudev\fR(7), \fBudevadm\fR(8) diff --git a/upstream/fedora-rawhide/man5/updatedb.conf.5 b/upstream/fedora-rawhide/man5/updatedb.conf.5 deleted file mode 100644 index 89181379..00000000 --- a/upstream/fedora-rawhide/man5/updatedb.conf.5 +++ /dev/null @@ -1,138 +0,0 @@ -.\" A man page for updatedb.conf. -*- nroff -*- -.\" -.\" Copyright (C) 2005, 2007, 2008 Red Hat, Inc. All rights reserved. -.\" -.\" This copyrighted material is made available to anyone wishing to use, -.\" modify, copy, or redistribute it subject to the terms and conditions of the -.\" GNU General Public License v.2. -.\" -.\" This program is distributed in the hope that it will be useful, but WITHOUT -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for -.\" more details. -.\" -.\" You should have received a copy of the GNU General Public License along -.\" with this program; if not, write to the Free Software Foundation, Inc., -.\" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. -.\" -.\" Author: Miloslav Trmac <mitr@redhat.com> -.TH updatedb.conf 5 "Jun 2008" mlocate - -.SH NAME -/etc/updatedb.conf \- a configuration file for updatedb(8) - -.SH DESCRIPTION -.B /etc/updatedb.conf -is a text file. -Blank lines are ignored. -A -.B # -character outside of a quoted string starts a comment -extending until end of line. - -Other lines must be of the following form: -.RS -.I VARIABLE -.B = -\fB"\fIVALUE\fB"\fR -.RE - -White space between tokens is ignored. -.I VARIABLE -is an alphanumeric string which does not start with a digit. -.I VALUE -can contain any character except for \fB\(dq\fR. -No escape mechanism is supported within -.I VALUE -and there is no way to write -.I VALUE -spanning more than one line. - -Unknown -.I VARIABLE -values are considered an error. -The defined variables are: - -.TP -\fBPRUNEFS\fR -A whitespace-separated list of file system types (as used in \fB/etc/mtab\fR) -which should not be scanned by -.BR updatedb (8). -The file system type matching is case-insensitive. By default, no file system -types are skipped. - -When scanning a file system is skipped, -all file systems mounted in the subtree are skipped too, -even if their type does not match any entry in \fBPRUNEFS\fR. - -.TP -\fBPRUNENAMES\fR -A whitespace-separated list of directory names (without paths) which should not -be scanned by -.BR updatedb (8). -By default, no directory names are skipped. - -Note that only directories can be specified, and no pattern mechanism (e.g. -globbing) is used. - -.TP -\fBPRUNEPATHS\fR -A whitespace-separated list of path names of directories which should not be -scanned by -.BR updatedb (8). -Each path name must be exactly in the form -in which the directory would be reported by -.BR locate (1). - -By default, no paths are skipped. - -.TP -\fBPRUNE_BIND_MOUNTS\FR -One of the strings \fB0\fR, \fBno\fR, \fB1\fR or \fByes\fR. -If -.B PRUNE_BIND_MOUNTS -is \fB1\fR or \fByes\fR, -bind mounts are not scanned by -.BR updatedb (8). -All file systems mounted in the subtree of a bind mount are skipped as well, -even if they are not bind mounts. -As an exception, bind mounts of a directory on itself are not skipped. - -By default, bind mounts are not skipped. - -.SH NOTES -When a directory is matched by \fBPRUNEFS\fR, \fBPRUNENAMES\fR or -\fBPRUNEPATHS\fR, -.BR updatedb (8) -does not scan the contents of the directory. -The path of the directory itself is, however, entered in the created database. -For example, if -.I /tmp -is in \fBPRUNEPATHS\fR, -.BR locate (1) -will not show any files stored in \fI/tmp\fR, -but it can show the -.I /tmp -directory. -This behavior differs from traditional -.B locate -implementations. - -In some -.BR updatedb (8) -implementations \fBPRUNEPATHS\fR can be used to exclude non-directory files. -This is not the case in this implementation. - -.B /etc/updatedb.conf -is a shell script in some implementations, -which allows much more flexibility in defining the variables. -Equivalent functionality can be achieved by using the command-line options -to -.BR updatedb (8). - -.SH AUTHOR -Miloslav Trmac <mitr@redhat.com> - -.SH SEE ALSO -.BR locate (1), -.BR updatedb (8) diff --git a/upstream/fedora-rawhide/man5/user@.service.5 b/upstream/fedora-rawhide/man5/user@.service.5 index 0f068135..e6e5d656 100644 --- a/upstream/fedora-rawhide/man5/user@.service.5 +++ b/upstream/fedora-rawhide/man5/user@.service.5 @@ -1,5 +1,5 @@ '\" t -.TH "USER@\&.SERVICE" "5" "" "systemd 255" "user@.service" +.TH "USER@\&.SERVICE" "5" "" "systemd 256~rc3" "user@.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -188,10 +188,4 @@ user\-\fIUID\fR\&.slice units by default don\*(Aqt have a unit file\&. The resource limits are set through a drop\-in, which can be easily replaced or extended following standard drop\-in mechanisms discussed in the first section\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.service\fR(5), -\fBsystemd.slice\fR(5), -\fBsystemd.resource-control\fR(5), -\fBsystemd.exec\fR(5), -\fBsystemd.special\fR(7), -\fBpam\fR(8) +\fBsystemd\fR(1), \fBsystemd.service\fR(5), \fBsystemd.slice\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.exec\fR(5), \fBsystemd.special\fR(7), \fBcapsule@.service\fR(5), \fBpam\fR(8) diff --git a/upstream/fedora-rawhide/man5/utmp.5 b/upstream/fedora-rawhide/man5/utmp.5 index 99d3fed5..48f300e4 100644 --- a/upstream/fedora-rawhide/man5/utmp.5 +++ b/upstream/fedora-rawhide/man5/utmp.5 @@ -8,7 +8,7 @@ .\" Modified 1996-07-20 by Michael Haardt .\" Modified 1997-07-02 by Nicolás Lichtmaier <nick@debian.org> .\" Modified 2004-10-31 by aeb, following Gwenole Beauchesne -.TH utmp 5 2023-10-31 "Linux man-pages 6.06" +.TH utmp 5 2023-10-31 "Linux man-pages 6.7" .SH NAME utmp, wtmp \- login records .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man5/vconsole.conf.5 b/upstream/fedora-rawhide/man5/vconsole.conf.5 index ef220e50..04d58ef0 100644 --- a/upstream/fedora-rawhide/man5/vconsole.conf.5 +++ b/upstream/fedora-rawhide/man5/vconsole.conf.5 @@ -1,5 +1,5 @@ '\" t -.TH "VCONSOLE\&.CONF" "5" "" "systemd 255" "vconsole.conf" +.TH "VCONSOLE\&.CONF" "5" "" "systemd 256~rc3" "vconsole.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -119,9 +119,4 @@ FONT=eurlatgr .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-vconsole-setup.service\fR(8), -\fBloadkeys\fR(1), -\fBsetfont\fR(8), -\fBlocale.conf\fR(5), -\fBsystemd-localed.service\fR(8) +\fBsystemd\fR(1), \fBsystemd-vconsole-setup.service\fR(8), \fBloadkeys\fR(1), \fBsetfont\fR(8), \fBlocale.conf\fR(5), \fBsystemd-localed.service\fR(8) diff --git a/upstream/fedora-rawhide/man5/veritytab.5 b/upstream/fedora-rawhide/man5/veritytab.5 index d68a8af4..c8b0b5d3 100644 --- a/upstream/fedora-rawhide/man5/veritytab.5 +++ b/upstream/fedora-rawhide/man5/veritytab.5 @@ -1,5 +1,5 @@ '\" t -.TH "VERITYTAB" "5" "" "systemd 255" "veritytab" +.TH "VERITYTAB" "5" "" "systemd 256~rc3" "veritytab" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -40,7 +40,7 @@ Each line is in the form .RS 4 .\} .nf -\fIvolume\-name\fR \fIdata\-device\fR \fIhash\-device\fR \fIroothash\fR \fIoptions\fR +\fIvolume\-name\fR \fIdata\-device\fR \fIhash\-device\fR \fIroothash\fR [\fIoptions\fR] .fi .if n \{\ .RE @@ -52,15 +52,17 @@ The first field contains the name of the resulting verity volume; its block devi /dev/mapper/\&. .PP The second field contains a path to the underlying block data device, or a specification of a block device via -"UUID=" -followed by the UUID\&. +\fIUUID=\fR +followed by the +\fIUUID\fR\&. .PP The third field contains a path to the underlying block hash device, or a specification of a block device via -"UUID=" -followed by the UUID\&. +\fIUUID=\fR +followed by the +\fIUUID\fR\&. .PP The fourth field is the -"roothash" +\fIroothash\fR in hexadecimal\&. .PP The fifth field, if present, is a comma\-delimited list of options\&. The following options are recognized: @@ -74,7 +76,11 @@ Added in version 254\&. .PP \fBformat=\fR\fB\fINUMBER\fR\fR .RS 4 -Specifies the hash version type\&. Format type 0 is original Chrome OS version\&. Format type 1 is modern version\&. +Specifies the hash version type\&. Format type +"0" +is original Chrome OS version\&. Format type +"1" +is modern version\&. .sp Added in version 254\&. .RE @@ -111,26 +117,38 @@ Added in version 254\&. \fBsalt=\fR\fB\fIHEX\fR\fR .RS 4 Salt used for format or verification\&. Format is a hexadecimal string; 256 bytes long maximum; -"\-"is the special value for empty\&. +"\-" +is the special value for empty\&. .sp Added in version 254\&. .RE .PP \fBuuid=\fR\fB\fIUUID\fR\fR .RS 4 -Use the provided UUID for format command instead of generating new one\&. The UUID must be provided in standard UUID format, e\&.g\&. 12345678\-1234\-1234\-1234\-123456789abc\&. +Use the provided +\fIUUID\fR +instead of generating new one\&. The +\fIUUID\fR +must be provided in standard +UUID +format, e\&.g\&. +"12345678\-1234\-1234\-1234\-123456789abc"\&. .sp Added in version 254\&. .RE .PP \fBignore\-corruption\fR, \fBrestart\-on\-corruption\fR, \fBpanic\-on\-corruption\fR .RS 4 -Defines what to do if a data verity problem is detected (data corruption)\&. Without these options kernel fails the IO operation with I/O error\&. With -"\-\-ignore\-corruption" +Defines what to do if a data verity problem is detected (data corruption)\&. Without these options kernel fails the +IO +operation with +I/O +error\&. With +\fB\-\-ignore\-corruption\fR option the corruption is only logged\&. With -"\-\-restart\-on\-corruption" +\fB\-\-restart\-on\-corruption\fR or -"\-\-panic\-on\-corruption" +\fB\-\-panic\-on\-corruption\fR the kernel is restarted (panicked) immediately\&. (You have to provide way how to avoid restart loops\&.) .sp Added in version 248\&. @@ -138,15 +156,43 @@ Added in version 248\&. .PP \fBignore\-zero\-blocks\fR .RS 4 -Instruct kernel to not verify blocks that are expected to contain zeroes and always directly return zeroes instead\&. WARNING: Use this option only in very specific cases\&. This option is available since Linux kernel version 4\&.5\&. +Instruct kernel to not verify blocks that are expected to contain zeroes and always directly return zeroes instead\&. +.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 +Use this option only in very specific cases\&. This option is available since Linux kernel version 4\&.5\&. +.sp .5v +.RE Added in version 248\&. .RE .PP \fBcheck\-at\-most\-once\fR .RS 4 -Instruct kernel to verify blocks only the first time they are read from the data device, rather than every time\&. WARNING: It provides a reduced level of security because only offline tampering of the data device\*(Aqs content will be detected, not online tampering\&. This option is available since Linux kernel version 4\&.17\&. +Instruct kernel to verify blocks only the first time they are read from the data device, rather than every time\&. +.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 +It provides a reduced level of security because only offline tampering of the data device\*(Aqs content will be detected, not online tampering\&. This option is available since Linux kernel version 4\&.17\&. +.sp .5v +.RE Added in version 248\&. .RE .PP @@ -160,14 +206,16 @@ Added in version 254\&. .PP \fBfec\-device=\fR\fB\fIPATH\fR\fR .RS 4 -Use forward error correction (FEC) to recover from corruption if hash verification fails\&. Use encoding data from the specified device\&. The fec device argument can be block device or file image\&. For format, if fec device path doesn\*(Aqt exist, it will be created as file\&. Note: block sizes for data and hash devices must match\&. Also, if the verity data_device is encrypted the fec_device should be too\&. +Use forward error correction (FEC) to recover from corruption if hash verification fails\&. Use encoding data from the specified device\&. The fec device argument can be block device or file image\&. If fec device path doesn\*(Aqt exist, it will be created as file\&. Note: block sizes for data and hash devices must match\&. Also, if the verity data_device is encrypted the fec_device should be too\&. .sp Added in version 254\&. .RE .PP \fBfec\-offset=\fR\fB\fIBYTES\fR\fR .RS 4 -This is the offset, in bytes, from the start of the FEC device to the beginning of the encoding data\&. (Aligned on 512 bytes\&.) +This is the offset, in bytes, from the start of the +FEC +device to the beginning of the encoding data\&. (Aligned on 512 bytes\&.) .sp Added in version 254\&. .RE @@ -268,8 +316,4 @@ data /etc/data /etc/hash a5ee4b42f70ae1f46a08a7c92c2e0a20672ad2f514792730f5d49d7 .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-veritysetup@.service\fR(8), -\fBsystemd-veritysetup-generator\fR(8), -\fBfstab\fR(5), -\fBveritysetup\fR(8), +\fBsystemd\fR(1), \fBsystemd-veritysetup@.service\fR(8), \fBsystemd-veritysetup-generator\fR(8), \fBfstab\fR(5), \fBveritysetup\fR(8) diff --git a/upstream/fedora-rawhide/man6/intro.6 b/upstream/fedora-rawhide/man6/intro.6 index b737c052..9a2fefbd 100644 --- a/upstream/fedora-rawhide/man6/intro.6 +++ b/upstream/fedora-rawhide/man6/intro.6 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sat Jul 24 17:19:57 1993 by Rik Faith (faith@cs.unc.edu) -.TH intro 6 2022-10-30 "Linux man-pages 6.06" +.TH intro 6 2022-10-30 "Linux man-pages 6.7" .SH NAME intro \- introduction to games .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/address_families.7 b/upstream/fedora-rawhide/man7/address_families.7 index 473cec6b..14464be9 100644 --- a/upstream/fedora-rawhide/man7/address_families.7 +++ b/upstream/fedora-rawhide/man7/address_families.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH address_families 7 2024-01-28 "Linux man-pages 6.06" +.TH address_families 7 2024-01-28 "Linux man-pages 6.7" .SH NAME address_families \- socket address families (domains) .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/aio.7 b/upstream/fedora-rawhide/man7/aio.7 index 5f8d4b44..d3718311 100644 --- a/upstream/fedora-rawhide/man7/aio.7 +++ b/upstream/fedora-rawhide/man7/aio.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH AIO 7 2023-10-31 "Linux man-pages 6.06" +.TH AIO 7 2023-10-31 "Linux man-pages 6.7" .SH NAME aio \- POSIX asynchronous I/O overview .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/armscii-8.7 b/upstream/fedora-rawhide/man7/armscii-8.7 index 631ac3b4..633c8d66 100644 --- a/upstream/fedora-rawhide/man7/armscii-8.7 +++ b/upstream/fedora-rawhide/man7/armscii-8.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ARMSCII-8 7 2022-12-15 "Linux man-pages 6.06" +.TH ARMSCII-8 7 2022-12-15 "Linux man-pages 6.7" .SH NAME armscii-8 \- Armenian character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/arp.7 b/upstream/fedora-rawhide/man7/arp.7 index 715c0125..9de545cc 100644 --- a/upstream/fedora-rawhide/man7/arp.7 +++ b/upstream/fedora-rawhide/man7/arp.7 @@ -6,7 +6,7 @@ .\" Modified June 1999 Andi Kleen .\" $Id: arp.7,v 1.10 2000/04/27 19:31:38 ak Exp $ .\" -.TH arp 7 2023-10-31 "Linux man-pages 6.06" +.TH arp 7 2023-10-31 "Linux man-pages 6.7" .SH NAME arp \- Linux ARP kernel module. .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/ascii.7 b/upstream/fedora-rawhide/man7/ascii.7 index 7fb1a6eb..19193e15 100644 --- a/upstream/fedora-rawhide/man7/ascii.7 +++ b/upstream/fedora-rawhide/man7/ascii.7 @@ -13,7 +13,7 @@ .\" Modified 1999-08-08 by Michael Haardt (michael@moria.de) .\" Modified 2004-04-01 by aeb .\" -.TH ascii 7 2024-01-28 "Linux man-pages 6.06" +.TH ascii 7 2024-01-28 "Linux man-pages 6.7" .SH NAME ascii \- ASCII character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/attributes.7 b/upstream/fedora-rawhide/man7/attributes.7 index 771075f2..838f0394 100644 --- a/upstream/fedora-rawhide/man7/attributes.7 +++ b/upstream/fedora-rawhide/man7/attributes.7 @@ -2,7 +2,7 @@ .\" Written by Alexandre Oliva <aoliva@redhat.com> .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH attributes 7 2023-11-01 "Linux man-pages 6.06" +.TH attributes 7 2023-11-01 "Linux man-pages 6.7" .SH NAME attributes \- POSIX safety concepts .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/bootparam.7 b/upstream/fedora-rawhide/man7/bootparam.7 index 2ad56888..f9d3c106 100644 --- a/upstream/fedora-rawhide/man7/bootparam.7 +++ b/upstream/fedora-rawhide/man7/bootparam.7 @@ -6,7 +6,7 @@ .\" (dated v1.0.1, 15/08/95). .\" Major update, aeb, 970114. .\" -.TH bootparam 7 2023-10-31 "Linux man-pages 6.06" +.TH bootparam 7 2023-10-31 "Linux man-pages 6.7" .SH NAME bootparam \- introduction to boot time parameters of the Linux kernel .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/bootup.7 b/upstream/fedora-rawhide/man7/bootup.7 index 3c82f20d..643f7fc1 100644 --- a/upstream/fedora-rawhide/man7/bootup.7 +++ b/upstream/fedora-rawhide/man7/bootup.7 @@ -1,5 +1,5 @@ '\" t -.TH "BOOTUP" "7" "" "systemd 255" "bootup" +.TH "BOOTUP" "7" "" "systemd 256~rc3" "bootup" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -28,8 +28,7 @@ A number of different components are involved in the boot of a Linux system\&. I or \m[blue]\fBGRUB\fR\m[]\&\s-2\u[1]\d\s+2) stored on a persistent storage device\&. This boot loader will then invoke an OS kernel from disk (or the network)\&. On systems using EFI or other types of firmware, this firmware may also load the kernel directly\&. .PP -The kernel (optionally) mounts an in\-memory file system, often generated by -\fBdracut\fR(8), which looks for the root file system\&. Nowadays this is implemented as an "initramfs" \(em a compressed CPIO archive that the kernel extracts into a tmpfs\&. In the past normal file systems using an in\-memory block device (ramdisk) were used, and the name "initrd" is still used to describe both concepts\&. It\*(Aqs the boot loader or the firmware that loads both the kernel and initrd/initramfs images into memory, but the kernel which interprets it as a file system\&. +The kernel (optionally) mounts an in\-memory file system, which looks for the root file system\&. Nowadays this is implemented as an "initramfs" \(em a compressed CPIO archive that the kernel extracts into a tmpfs\&. In the past normal file systems using an in\-memory block device (ramdisk) were used, and the name "initrd" is still used to describe both concepts\&. It\*(Aqs the boot loader or the firmware that loads both the kernel and initrd/initramfs images into memory, but the kernel which interprets it as a file system\&. \fBsystemd\fR(1) may be used to manage services in the initrd, similarly to the real system\&. .PP @@ -301,21 +300,23 @@ System shutdown with systemd also consists of various target units with some min v final\&.target | - ___________________________/ \e_________________ - / | | \e - | | | | - v | | | -systemd\-reboot\&.service | | | - | v | | - | systemd\-poweroff\&.service | | - v | v | - \fIreboot\&.target\fR | systemd\-halt\&.service | - v | v - \fIpoweroff\&.target\fR | systemd\-kexec\&.service - v | - \fIhalt\&.target\fR | - v - \fIkexec\&.target\fR + ___________________________/ \e_________________________________ + / | | | \e + | | | | | + v | | | | +systemd\-reboot\&.service | | | | + | v | | | + | systemd\-poweroff\&.service | | | + v | v | | + \fIreboot\&.target\fR | systemd\-halt\&.service | | + v | v | + \fIpoweroff\&.target\fR | systemd\-kexec\&.service | + v | | + \fIhalt\&.target\fR | systemd\-soft\-reboot\&.service + v | + \fIkexec\&.target\fR | + v + \fIsoft\-reboot\&.target\fR .fi .if n \{\ .RE @@ -335,12 +336,7 @@ systemd\-shutdown binary), which will unmount any remaining file systems, kill any remaining processes and release any other remaining resources, in a simple and robust fashion, without taking any service or unit concept into account anymore\&. At that point, regular applications and resources are generally terminated and released already, the second phase hence operates only as safety net for everything that couldn\*(Aqt be stopped or released for some reason during the primary, unit\-based shutdown phase described above\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBboot\fR(7), -\fBsystemd.special\fR(7), -\fBsystemd.target\fR(5), -\fBsystemd-halt.service\fR(8), -\fBdracut\fR(8) +\fBsystemd\fR(1), \fBboot\fR(7), \fBsystemd.special\fR(7), \fBsystemd.target\fR(5), \fBsystemd-halt.service\fR(8), \fBsystemd-soft-reboot.service\fR(8) .SH "NOTES" .IP " 1." 4 GRUB diff --git a/upstream/fedora-rawhide/man7/bpf-helpers.7 b/upstream/fedora-rawhide/man7/bpf-helpers.7 index 26ddf836..b4236f17 100644 --- a/upstream/fedora-rawhide/man7/bpf-helpers.7 +++ b/upstream/fedora-rawhide/man7/bpf-helpers.7 @@ -27,18 +27,18 @@ 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 "BPF-HELPERS" 7 "2023-04-11" "Linux v6.2" +.TH "BPF-HELPERS" 7 "2023-11-10" "Linux v6.8" .SH NAME BPF-HELPERS \- list of eBPF helper functions .\" Copyright (C) All BPF authors and contributors from 2014 to present. . .\" See git log include/uapi/linux/bpf.h in kernel tree for details. . -.\" +.\" . -.\" SPDX-License-Identifier: Linux-man-pages-copyleft +.\" SPDX-License-Identifier: Linux-man-pages-copyleft . -.\" +.\" . .\" Please do not edit this file. It was generated from the documentation . @@ -156,27 +156,25 @@ Current \fIktime\fP\&. .B Description This helper is a \(dqprintk()\-like\(dq facility for debugging. It prints a message defined by format \fIfmt\fP (of size \fIfmt_size\fP) -to file \fI/sys/kernel/debug/tracing/trace\fP from DebugFS, if +to file \fI/sys/kernel/tracing/trace\fP from TraceFS, if available. It can take up to three additional \fBu64\fP arguments (as an eBPF helpers, the total number of arguments is limited to five). .sp Each time the helper is called, it appends a line to the trace. -Lines are discarded while \fI/sys/kernel/debug/tracing/trace\fP is -open, use \fI/sys/kernel/debug/tracing/trace_pipe\fP to avoid this. +Lines are discarded while \fI/sys/kernel/tracing/trace\fP is +open, use \fI/sys/kernel/tracing/trace_pipe\fP to avoid this. The format of the trace is customizable, and the exact output one will get depends on the options set in -\fI/sys/kernel/debug/tracing/trace_options\fP (see also the +\fI/sys/kernel/tracing/trace_options\fP (see also the \fIREADME\fP file under the same directory). However, it usually defaults to something like: .INDENT 7.0 .INDENT 3.5 .sp -.nf -.ft C -telnet\-470 [001] .N.. 419421.045894: 0x00000001: <fmt> -.ft P -.fi +.EX +telnet\-470 [001] .N.. 419421.045894: 0x00000001: <formatted msg> +.EE .UNINDENT .UNINDENT .sp @@ -204,7 +202,8 @@ are set. \fB0x00000001\fP is a fake value used by BPF for the instruction pointer register. .IP \(bu 2 -\fB<fmt>\fP is the message formatted with \fIfmt\fP\&. +\fB<formatted msg>\fP is the message formatted with +\fIfmt\fP\&. .UNINDENT .UNINDENT .UNINDENT @@ -404,7 +403,9 @@ performed again, if the helper is used in combination with direct packet access. .TP .B Return -0 on success, or a negative error in case of failure. +0 on success, or a negative error in case of failure. Positive +error indicates a potential drop or congestion in the target +device. The particular positive error codes are not defined. .UNINDENT .TP .B \fBu64 bpf_get_current_pid_tgid(void)\fP @@ -541,8 +542,7 @@ remote ends with IPv4 address other than 10.0.0.1: .INDENT 7.0 .INDENT 3.5 .sp -.nf -.ft C +.EX int ret; struct bpf_tunnel_key key = {}; @@ -554,8 +554,7 @@ if (key.remote_ipv4 != 0x0a000001) return TC_ACT_SHOT; // drop packet return TC_ACT_OK; // accept packet -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -600,20 +599,22 @@ sequence number should be added to tunnel header before sending the packet. This flag was added for GRE encapsulation, but might be used with other protocols as well in the future. +.TP +.B \fBBPF_F_NO_TUNNEL_KEY\fP +Add a flag to tunnel metadata indicating that no tunnel +key should be set in the resulting tunnel header. .UNINDENT .sp Here is a typical usage on the transmit path: .INDENT 7.0 .INDENT 3.5 .sp -.nf -.ft C +.EX struct bpf_tunnel_key key; populate key ... bpf_skb_set_tunnel_key(skb, &key, sizeof(key), 0); bpf_clone_redirect(skb, vxlan_dev_ifindex, 0); -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -827,11 +828,9 @@ user stacks (such as stacks for Java programs). To do so, use: .INDENT 7.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # sysctl kernel.perf_event_max_stack=<new value> -.ft P -.fi +.EE .UNINDENT .UNINDENT .TP @@ -1334,8 +1333,8 @@ The option value of length \fIoptlen\fP is pointed by \fIoptval\fP\&. .IP \(bu 2 \fBstruct bpf_sock_ops\fP for \fBBPF_PROG_TYPE_SOCK_OPS\fP\&. .IP \(bu 2 -\fBstruct bpf_sock_addr\fP for \fBBPF_CGROUP_INET4_CONNECT\fP -and \fBBPF_CGROUP_INET6_CONNECT\fP\&. +\fBstruct bpf_sock_addr\fP for \fBBPF_CGROUP_INET4_CONNECT\fP, +\fBBPF_CGROUP_INET6_CONNECT\fP and \fBBPF_CGROUP_UNIX_CONNECT\fP\&. .UNINDENT .sp This helper actually implements a subset of \fBsetsockopt()\fP\&. @@ -1417,6 +1416,11 @@ type; \fIlen\fP is the length of the inner MAC header. \fBBPF_F_ADJ_ROOM_ENCAP_L2_ETH\fP: Use with BPF_F_ADJ_ROOM_ENCAP_L2 flag to further specify the L2 type as Ethernet. +.IP \(bu 2 +\fBBPF_F_ADJ_ROOM_DECAP_L3_IPV4\fP, +\fBBPF_F_ADJ_ROOM_DECAP_L3_IPV6\fP: +Indicate the new IP header version after decapsulating the outer +IP header. Used when the inner and outer IP versions are different. .UNINDENT .sp A call to this helper is susceptible to change the underlying @@ -1572,11 +1576,9 @@ as follows. .INDENT 7.0 .INDENT 3.5 .sp -.nf -.ft C +.EX normalized_counter = counter * t_enabled / t_running -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -1596,7 +1598,7 @@ value and do the calculation inside the eBPF program. .INDENT 7.0 .TP .B Description -For en eBPF program attached to a perf event, retrieve the +For an eBPF program attached to a perf event, retrieve the value of the event counter associated to \fIctx\fP and store it in the structure pointed by \fIbuf\fP and of size \fIbuf_size\fP\&. Enabled and running times are also stored in the structure (see @@ -1623,8 +1625,8 @@ The retrieved value is stored in the structure pointed by .IP \(bu 2 \fBstruct bpf_sock_ops\fP for \fBBPF_PROG_TYPE_SOCK_OPS\fP\&. .IP \(bu 2 -\fBstruct bpf_sock_addr\fP for \fBBPF_CGROUP_INET4_CONNECT\fP -and \fBBPF_CGROUP_INET6_CONNECT\fP\&. +\fBstruct bpf_sock_addr\fP for \fBBPF_CGROUP_INET4_CONNECT\fP, +\fBBPF_CGROUP_INET6_CONNECT\fP and \fBBPF_CGROUP_UNIX_CONNECT\fP\&. .UNINDENT .sp This helper actually implements a subset of \fBgetsockopt()\fP\&. @@ -1945,11 +1947,9 @@ user stacks (such as stacks for Java programs). To do so, use: .INDENT 7.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # sysctl kernel.perf_event_max_stack=<new value> -.ft P -.fi +.EE .UNINDENT .UNINDENT .TP @@ -2010,9 +2010,26 @@ following values: Do a direct table lookup vs full lookup using FIB rules. .TP +.B \fBBPF_FIB_LOOKUP_TBID\fP +Used with BPF_FIB_LOOKUP_DIRECT. +Use the routing table ID present in \fIparams\fP\->tbid +for the fib lookup. +.TP .B \fBBPF_FIB_LOOKUP_OUTPUT\fP Perform lookup from an egress perspective (default is ingress). +.TP +.B \fBBPF_FIB_LOOKUP_SKIP_NEIGH\fP +Skip the neighbour table lookup. \fIparams\fP\->dmac +and \fIparams\fP\->smac will not be set as output. A common +use case is to call \fBbpf_redirect_neigh\fP() after +doing \fBbpf_fib_lookup\fP(). +.TP +.B \fBBPF_FIB_LOOKUP_SRC\fP +Derive and set source IP addr in \fIparams\fP\->ipv{4,6}_src +for the nexthop. If the src addr cannot be derived, +\fBBPF_FIB_LKUP_RET_NO_SRC_ADDR\fP is returned. In this +case, \fIparams\fP\->dmac and \fIparams\fP\->smac are not set either. .UNINDENT .sp \fIctx\fP is either \fBstruct xdp_md\fP for XDP programs or @@ -3029,24 +3046,20 @@ get its length at runtime. See the following snippet: .INDENT 7.0 .INDENT 3.5 .sp -.nf -.ft C +.EX SEC(\(dqkprobe/sys_open\(dq) void bpf_sys_open(struct pt_regs *ctx) { char buf[PATHLEN]; // PATHLEN is defined to 256 - int res; - - res = bpf_probe_read_user_str(buf, sizeof(buf), - ctx\->di); + int res = bpf_probe_read_user_str(buf, sizeof(buf), + ctx\->di); // Consume buf, for example push it to // userspace via bpf_perf_event_output(); we // can use res (the string length) as event // size, after checking its boundaries. } -.ft P -.fi +.EE .UNINDENT .UNINDENT .sp @@ -3253,9 +3266,6 @@ The \fIflags\fP argument must be zero. .sp \fB\-EOPNOTSUPP\fP if the operation is not supported, for example a call from outside of TC ingress. -.sp -\fB\-ESOCKTNOSUPPORT\fP if the socket type is not supported -(reuseport). .UNINDENT .TP .B \fBlong bpf_sk_assign(struct bpf_sk_lookup *\fP\fIctx\fP\fB, struct bpf_sock *\fP\fIsk\fP\fB, u64\fP \fIflags\fP\fB)\fP @@ -3605,6 +3615,8 @@ Dynamically cast a \fIsk\fP pointer to a \fIudp6_sock\fP pointer. .TP .B Description Return a user or a kernel stack in bpf program provided buffer. +Note: the user stack will only be populated if the \fItask\fP is +the current task; all other tasks will return \-EOPNOTSUPP. To achieve this, the helper needs \fItask\fP, which is a valid pointer to \fBstruct task_struct\fP\&. To store the stacktrace, the bpf program provides \fIbuf\fP with a nonnegative \fIsize\fP\&. @@ -3617,6 +3629,7 @@ the following flags: .TP .B \fBBPF_F_USER_STACK\fP Collect a user space stack instead of a kernel stack. +The \fItask\fP must be the current task. .TP .B \fBBPF_F_USER_BUILD_ID\fP Collect buildid+offset instead of ips for user stack, @@ -3632,11 +3645,9 @@ user stacks (such as stacks for Java programs). To do so, use: .INDENT 7.0 .INDENT 3.5 .sp -.nf -.ft C +.EX # sysctl kernel.perf_event_max_stack=<new value> -.ft P -.fi +.EE .UNINDENT .UNINDENT .TP @@ -4334,6 +4345,17 @@ The map can contain timers that invoke callback_fn\-s from different programs. The same callback_fn can serve different timers from different maps if key/value layout matches across maps. Every bpf_timer_set_callback() can have different callback_fn. +.sp +\fIflags\fP can be one of: +.INDENT 7.0 +.TP +.B \fBBPF_F_TIMER_ABS\fP +Start the timer in absolute expire value instead of the +default relative one. +.TP +.B \fBBPF_F_TIMER_CPU_PIN\fP +Timer will be pinned to the CPU of the caller. +.UNINDENT .TP .B Return 0 on success. @@ -4360,10 +4382,14 @@ own timer which would have led to a deadlock otherwise. .TP .B Description Get address of the traced function (for tracing and kprobe programs). +.sp +When called for kprobe program attached as uprobe it returns +probe address for both entry and return uprobe. .TP .B Return -Address of the traced function. +Address of the traced function for kprobe. 0 for kprobes placed within the function (not at the entry). +Address of the probe for uprobe and return uprobe. .UNINDENT .TP .B \fBu64 bpf_get_attach_cookie(void *\fP\fIctx\fP\fB)\fP @@ -4817,12 +4843,28 @@ of \fIsrc\fP\(aqs data, \-EINVAL if \fIsrc\fP is an invalid dynptr or if .B Description Write \fIlen\fP bytes from \fIsrc\fP into \fIdst\fP, starting from \fIoffset\fP into \fIdst\fP\&. -\fIflags\fP is currently unused. +.sp +\fIflags\fP must be 0 except for skb\-type dynptrs. +.INDENT 7.0 +.TP +.B For skb\-type dynptrs: +.INDENT 7.0 +.IP \(bu 2 +All data slices of the dynptr are automatically +invalidated after \fBbpf_dynptr_write\fP(). This is +because writing may pull the skb and change the +underlying packet buffer. +.IP \(bu 2 +For \fIflags\fP, please see the flags accepted by +\fBbpf_skb_store_bytes\fP(). +.UNINDENT +.UNINDENT .TP .B Return 0 on success, \-E2BIG if \fIoffset\fP + \fIlen\fP exceeds the length of \fIdst\fP\(aqs data, \-EINVAL if \fIdst\fP is an invalid dynptr or if \fIdst\fP -is a read\-only dynptr or if \fIflags\fP is not 0. +is a read\-only dynptr or if \fIflags\fP is not correct. For skb\-type dynptrs, +other errors correspond to errors returned by \fBbpf_skb_store_bytes\fP(). .UNINDENT .TP .B \fBvoid *bpf_dynptr_data(const struct bpf_dynptr *\fP\fIptr\fP\fB, u32\fP \fIoffset\fP\fB, u32\fP \fIlen\fP\fB)\fP @@ -4833,6 +4875,9 @@ Get a pointer to the underlying dynptr data. .sp \fIlen\fP must be a statically known value. The returned data slice is invalidated whenever the dynptr is invalidated. +.sp +skb and xdp type dynptrs may not use bpf_dynptr_data. They should +instead use bpf_dynptr_slice and bpf_dynptr_slice_rdwr. .TP .B Return Pointer to the underlying dynptr data, NULL if the dynptr is @@ -5049,7 +5094,7 @@ eBPF programs can have an associated license, passed along with the bytecode instructions to the kernel when the programs are loaded. The format for that string is identical to the one in use for kernel modules (Dual licenses, such as \(dqDual BSD/GPL\(dq, may be used). Some helper functions are only accessible to -programs that are compatible with the GNU Privacy License (GPL). +programs that are compatible with the GNU General Public License (GNU GPL). .sp In order to use such helpers, the eBPF program must be loaded with the correct license string passed (via \fBattr\fP) to the \fBbpf\fP() system call, and this @@ -5058,11 +5103,9 @@ similar to the following: .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX char ____license[] __attribute__((section(\(dqlicense\(dq), used)) = \(dqGPL\(dq; -.ft P -.fi +.EE .UNINDENT .UNINDENT .SH IMPLEMENTATION diff --git a/upstream/fedora-rawhide/man7/capabilities.7 b/upstream/fedora-rawhide/man7/capabilities.7 index 5fda075d..ad087f9a 100644 --- a/upstream/fedora-rawhide/man7/capabilities.7 +++ b/upstream/fedora-rawhide/man7/capabilities.7 @@ -25,7 +25,7 @@ .\" other capabilities where the permitted or inheritable bit is set. .\" 2011-09-07, mtk/Serge hallyn: Add CAP_SYSLOG .\" -.TH Capabilities 7 2023-10-31 "Linux man-pages 6.06" +.TH Capabilities 7 2024-02-25 "Linux man-pages 6.7" .SH NAME capabilities \- overview of Linux capabilities .SH DESCRIPTION @@ -1683,7 +1683,7 @@ prctl(PR_SET_SECUREBITS, .in .\" .\" -.SS Per-user-namespace """set-user-ID-root""" programs +.SS Per-user-namespace \[dq]set-user-ID-root\[dq] programs A set-user-ID program whose UID matches the UID that created a user namespace will confer capabilities in the process's permitted and effective sets diff --git a/upstream/fedora-rawhide/man7/cgroup_namespaces.7 b/upstream/fedora-rawhide/man7/cgroup_namespaces.7 index c3a27d8f..f5c73abd 100644 --- a/upstream/fedora-rawhide/man7/cgroup_namespaces.7 +++ b/upstream/fedora-rawhide/man7/cgroup_namespaces.7 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH cgroup_namespaces 7 2023-10-31 "Linux man-pages 6.06" +.TH cgroup_namespaces 7 2023-10-31 "Linux man-pages 6.7" .SH NAME cgroup_namespaces \- overview of Linux cgroup namespaces .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/cgroups.7 b/upstream/fedora-rawhide/man7/cgroups.7 index 5d400dcf..e2c3ec29 100644 --- a/upstream/fedora-rawhide/man7/cgroups.7 +++ b/upstream/fedora-rawhide/man7/cgroups.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH cgroups 7 2023-10-31 "Linux man-pages 6.06" +.TH cgroups 7 2024-03-05 "Linux man-pages 6.7" .SH NAME cgroups \- Linux control groups .SH DESCRIPTION @@ -805,7 +805,7 @@ then the corresponding controller-interface files (e.g., are automatically created in the children of that cgroup and can be used to exert resource control in the child cgroups. .\" -.SS Cgroups v2 """no internal processes""" rule +.SS Cgroups v2 \[dq]no internal processes\[dq] rule Cgroups v2 enforces a so-called "no internal processes" rule. Roughly speaking, this rule means that, with the exception of the root cgroup, processes may reside @@ -974,10 +974,10 @@ fails with the error .BR EAGAIN ). .IP Writing the string -.I """max""" +.I \[dq]max\[dq] to this file means that no limit is imposed. The default value in this file is -.I """max""" . +.IR \[dq]max\[dq] . .TP .IR cgroup.max.descendants " (since Linux 4.14)" .\" commit 1a926e0bbab83bae8207d05a533173425e0496d1 @@ -989,10 +989,10 @@ fails with the error .BR EAGAIN ). .IP Writing the string -.I """max""" +.I \[dq]max\[dq] to this file means that no limit is imposed. The default value in this file is -.IR """max""" . +.IR \[dq]max\[dq] . .\" .SH CGROUPS DELEGATION: DELEGATING A HIERARCHY TO A LESS PRIVILEGED USER In the context of cgroups, @@ -1327,7 +1327,7 @@ The only thing that can be done with this cgroup (other than deleting it) is to convert it to a .I threaded cgroup by writing the string -.I """threaded""" +.I \[dq]threaded\[dq] to the .I cgroup.type file. @@ -1369,7 +1369,7 @@ There are two pathways that lead to the creation of a threaded subtree. The first pathway proceeds as follows: .IP (1) 5 We write the string -.I """threaded""" +.I \[dq]threaded\[dq] to the .I cgroup.type file of a cgroup @@ -1406,7 +1406,7 @@ will also have the type .RE .IP (2) We write the string -.I """threaded""" +.I \[dq]threaded\[dq] to each of the .I domain invalid cgroups under @@ -1418,7 +1418,7 @@ now have the type .I threaded and the threaded subtree is now fully usable. The requirement to write -.I """threaded""" +.I \[dq]threaded\[dq] to each of these cgroups is somewhat cumbersome, but allows for possible future extensions to the thread-mode model. .P @@ -1441,7 +1441,7 @@ becomes .IR "domain threaded" . .IP \[bu] All of the descendant cgroups of -.I x +.I z that were not already of type .I threaded are converted to type @@ -1449,11 +1449,11 @@ are converted to type .RE .IP (2) As before, we make the threaded subtree usable by writing the string -.I """threaded""" +.I \[dq]threaded\[dq] to each of the .I domain invalid cgroups under -.IR y , +.IR z , in order to convert them to the type .IR threaded . .P @@ -1553,7 +1553,7 @@ A number of rules apply when writing to the file: .IP \[bu] 3 Only the string -.I """threaded""" +.I \[dq]threaded\[dq] may be written. In other words, the only explicit transition that is possible is to convert a .I domain @@ -1561,7 +1561,7 @@ cgroup to type .IR threaded . .IP \[bu] The effect of writing -.I """threaded""" +.I \[dq]threaded\[dq] depends on the current value in .IR cgroup.type , as follows: @@ -1607,20 +1607,20 @@ No domain controllers may be enabled in file. .P If any of the above constraints is violated, then an attempt to write -.I """threaded""" +.I \[dq]threaded\[dq] to a .I cgroup.type file fails with the error .BR ENOTSUP . .\" -.SS The """domain threaded""" cgroup type +.SS The \[dq]domain threaded\[dq] cgroup type According to the pathways described above, the type of a cgroup can change to .I domain threaded in either of the following cases: .IP \[bu] 3 The string -.I """threaded""" +.I \[dq]threaded\[dq] is written to a child cgroup. .IP \[bu] A threaded controller is enabled inside the cgroup and @@ -1666,7 +1666,7 @@ and .I threaded cgroups. If the string -.I """threaded""" +.I \[dq]threaded\[dq] is written to the .I cgroup.type file of one of the children of the root cgroup, then @@ -1690,7 +1690,7 @@ allow a threaded cgroup that employs the controller to be placed as high as possible in the hierarchy, so as to minimize the (small) cost of traversing the cgroup hierarchy. .\" -.SS The cgroups v2 """cpu""" controller and realtime threads +.SS The cgroups v2 \[dq]cpu\[dq] controller and realtime threads As at Linux 4.19, the cgroups v2 .I cpu controller does not support control of realtime threads @@ -1708,7 +1708,7 @@ if all realtime threads are in the root cgroup. (If there are realtime threads in nonroot cgroups, then a .BR write (2) of the string -.I """+cpu""" +.I \[dq]+cpu\[dq] to the .I cgroup.subtree_control file fails with the error diff --git a/upstream/fedora-rawhide/man7/charsets.7 b/upstream/fedora-rawhide/man7/charsets.7 index 7d76d066..eb9f8f8a 100644 --- a/upstream/fedora-rawhide/man7/charsets.7 +++ b/upstream/fedora-rawhide/man7/charsets.7 @@ -8,7 +8,7 @@ .\" .\" Changes also by David Starner <dstarner98@aasaa.ofe.org>. .\" -.TH charsets 7 2024-01-28 "Linux man-pages 6.06" +.TH charsets 7 2024-01-28 "Linux man-pages 6.7" .SH NAME charsets \- character set standards and internationalization .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/complex.7 b/upstream/fedora-rawhide/man7/complex.7 index 05d570ae..a61551e9 100644 --- a/upstream/fedora-rawhide/man7/complex.7 +++ b/upstream/fedora-rawhide/man7/complex.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH complex 7 2023-10-31 "Linux man-pages 6.06" +.TH complex 7 2023-10-31 "Linux man-pages 6.7" .SH NAME complex \- basics of complex mathematics .SH LIBRARY diff --git a/upstream/fedora-rawhide/man7/cp1251.7 b/upstream/fedora-rawhide/man7/cp1251.7 index e8ddf1b1..6668ad71 100644 --- a/upstream/fedora-rawhide/man7/cp1251.7 +++ b/upstream/fedora-rawhide/man7/cp1251.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH cp1251 7 2024-01-28 "Linux man-pages 6.06" +.TH cp1251 7 2024-01-28 "Linux man-pages 6.7" .SH NAME cp1251 \- CP\ 1251 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/cp1252.7 b/upstream/fedora-rawhide/man7/cp1252.7 index 3d75c78f..66304344 100644 --- a/upstream/fedora-rawhide/man7/cp1252.7 +++ b/upstream/fedora-rawhide/man7/cp1252.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH cp1252 7 2024-01-28 "Linux man-pages 6.06" +.TH cp1252 7 2024-01-28 "Linux man-pages 6.7" .SH NAME cp1252 \- CP\ 1252 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/cpuset.7 b/upstream/fedora-rawhide/man7/cpuset.7 index 58b2ad9e..2db2bfcf 100644 --- a/upstream/fedora-rawhide/man7/cpuset.7 +++ b/upstream/fedora-rawhide/man7/cpuset.7 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-only .\" -.TH cpuset 7 2023-10-31 "Linux man-pages 6.06" +.TH cpuset 7 2023-10-31 "Linux man-pages 6.7" .SH NAME cpuset \- confine processes to processor and memory node subsets .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/credentials.7 b/upstream/fedora-rawhide/man7/credentials.7 index 14f86b39..ddade68b 100644 --- a/upstream/fedora-rawhide/man7/credentials.7 +++ b/upstream/fedora-rawhide/man7/credentials.7 @@ -4,7 +4,7 @@ .\" .\" 2007-06-13 Creation .\" -.TH credentials 7 2023-11-19 "Linux man-pages 6.06" +.TH credentials 7 2023-11-19 "Linux man-pages 6.7" .SH NAME credentials \- process identifiers .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/crypto-policies.7 b/upstream/fedora-rawhide/man7/crypto-policies.7 index 03cea500..ac66eb40 100644 --- a/upstream/fedora-rawhide/man7/crypto-policies.7 +++ b/upstream/fedora-rawhide/man7/crypto-policies.7 @@ -2,12 +2,12 @@ .\" Title: crypto-policies .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/01/2024 +.\" Date: 05/21/2024 .\" Manual: \ \& .\" Source: crypto-policies .\" Language: English .\" -.TH "CRYPTO\-POLICIES" "7" "02/01/2024" "crypto\-policies" "\ \&" +.TH "CRYPTO\-POLICIES" "7" "05/21/2024" "crypto\-policies" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man7/daemon.7 b/upstream/fedora-rawhide/man7/daemon.7 index 6fcf79b7..459ca89c 100644 --- a/upstream/fedora-rawhide/man7/daemon.7 +++ b/upstream/fedora-rawhide/man7/daemon.7 @@ -1,5 +1,5 @@ '\" t -.TH "DAEMON" "7" "" "systemd 255" "daemon" +.TH "DAEMON" "7" "" "systemd 256~rc3" "daemon" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -116,7 +116,7 @@ to detach from any terminal and create an independent session\&. .\} In the child, call \fBfork()\fR -again, to ensure that the daemon can never re\-acquire a terminal again\&. (This relevant if the program \(em and all its dependencies \(em does not carefully specify `O_NOCTTY` on each and every single `open()` call that might potentially open a TTY device node\&.) +again, to ensure that the daemon can never re\-acquire a terminal again\&. (This is relevant if the program \(em and all its dependencies \(em does not carefully specify `O_NOCTTY` on each and every single `open()` call that might potentially open a TTY device node\&.) .RE .sp .RS 4 @@ -375,7 +375,7 @@ If your daemon provides services to other local processes or remote clients via If the service opens sockets or other files on it own, and those file descriptors shall survive a restart, the daemon should store them in the service manager via \fBsd_notify\fR(3) with -\fIFDSTORE=1\fR\&.\&. +\fIFDSTORE=1\fR\&. .RE .sp .RS 4 @@ -831,13 +831,7 @@ It is recommended to follow the general guidelines for placing package files, as \fBfile-hierarchy\fR(7)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsd-daemon\fR(3), -\fBsd_listen_fds\fR(3), -\fBsd_notify\fR(3), -\fBdaemon\fR(3), -\fBsystemd.service\fR(5), -\fBfile-hierarchy\fR(7) +\fBsystemd\fR(1), \fBsd-daemon\fR(3), \fBsd_listen_fds\fR(3), \fBsd_notify\fR(3), \fBdaemon\fR(3), \fBsystemd.service\fR(5), \fBfile-hierarchy\fR(7) .SH "NOTES" .IP " 1." 4 LSB recommendations for SysV init scripts diff --git a/upstream/fedora-rawhide/man7/ddp.7 b/upstream/fedora-rawhide/man7/ddp.7 index 3ab2c84b..2117aaeb 100644 --- a/upstream/fedora-rawhide/man7/ddp.7 +++ b/upstream/fedora-rawhide/man7/ddp.7 @@ -4,7 +4,7 @@ .\" .\" $Id: ddp.7,v 1.3 1999/05/13 11:33:22 freitag Exp $ .\" -.TH ddp 7 2023-10-31 "Linux man-pages 6.06" +.TH ddp 7 2023-10-31 "Linux man-pages 6.7" .SH NAME ddp \- Linux AppleTalk protocol implementation .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/environ.7 b/upstream/fedora-rawhide/man7/environ.7 index 2418506b..cb7a839f 100644 --- a/upstream/fedora-rawhide/man7/environ.7 +++ b/upstream/fedora-rawhide/man7/environ.7 @@ -12,7 +12,7 @@ .\" Modified Wed Jan 24 06:37:24 2001 by Eric S. Raymond (esr@thyrsus.com) .\" Modified Thu Dec 13 23:53:27 2001 by Martin Schulze <joey@infodrom.org> .\" -.TH environ 7 2023-10-31 "Linux man-pages 6.06" +.TH environ 7 2023-10-31 "Linux man-pages 6.7" .SH NAME environ \- user environment .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/epoll.7 b/upstream/fedora-rawhide/man7/epoll.7 index 888479db..a93bc0bd 100644 --- a/upstream/fedora-rawhide/man7/epoll.7 +++ b/upstream/fedora-rawhide/man7/epoll.7 @@ -4,7 +4,7 @@ .\" .\" Davide Libenzi <davidel@xmailserver.org> .\" -.TH epoll 7 2023-10-31 "Linux man-pages 6.06" +.TH epoll 7 2023-10-31 "Linux man-pages 6.7" .SH NAME epoll \- I/O event notification facility .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/fanotify.7 b/upstream/fedora-rawhide/man7/fanotify.7 index f1b3f2c8..b0b5121b 100644 --- a/upstream/fedora-rawhide/man7/fanotify.7 +++ b/upstream/fedora-rawhide/man7/fanotify.7 @@ -2,7 +2,7 @@ .\" and Copyright (C) 2014, Michael Kerrisk <mtk.manpages@gmail.com> .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH fanotify 7 2023-10-31 "Linux man-pages 6.06" +.TH fanotify 7 2023-10-31 "Linux man-pages 6.7" .SH NAME fanotify \- monitoring filesystem events .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/feature_test_macros.7 b/upstream/fedora-rawhide/man7/feature_test_macros.7 index d27270e4..ee414dd9 100644 --- a/upstream/fedora-rawhide/man7/feature_test_macros.7 +++ b/upstream/fedora-rawhide/man7/feature_test_macros.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH feature_test_macros 7 2023-10-31 "Linux man-pages 6.06" +.TH feature_test_macros 7 2023-10-31 "Linux man-pages 6.7" .SH NAME feature_test_macros \- feature test macros .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/fifo.7 b/upstream/fedora-rawhide/man7/fifo.7 index 9adac77b..6241a43d 100644 --- a/upstream/fedora-rawhide/man7/fifo.7 +++ b/upstream/fedora-rawhide/man7/fifo.7 @@ -4,7 +4,7 @@ .\" .\" 990620 - page created - aeb@cwi.nl .\" -.TH fifo 7 2023-10-31 "Linux man-pages 6.06" +.TH fifo 7 2023-10-31 "Linux man-pages 6.7" .SH NAME fifo \- first-in first-out special file, named pipe .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/file-hierarchy.7 b/upstream/fedora-rawhide/man7/file-hierarchy.7 index 42d4d706..949d4bfe 100644 --- a/upstream/fedora-rawhide/man7/file-hierarchy.7 +++ b/upstream/fedora-rawhide/man7/file-hierarchy.7 @@ -1,5 +1,5 @@ '\" t -.TH "FILE\-HIERARCHY" "7" "" "systemd 255" "file-hierarchy" +.TH "FILE\-HIERARCHY" "7" "" "systemd 256~rc3" "file-hierarchy" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -763,14 +763,7 @@ T} .sp 1 .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBhier\fR(7), -\fBsystemd-path\fR(1), -\fBsystemd-gpt-auto-generator\fR(8), -\fBsysctl.d\fR(5), -\fBtmpfiles.d\fR(5), -\fBpkg-config\fR(1), -\fBsystemd.unit\fR(5) +\fBsystemd\fR(1), \fBhier\fR(7), \fBsystemd-path\fR(1), \fBsystemd-gpt-auto-generator\fR(8), \fBsysctl.d\fR(5), \fBtmpfiles.d\fR(5), \fBpkg-config\fR(1), \fBsystemd.unit\fR(5) .SH "NOTES" .IP " 1." 4 File System Hierarchy diff --git a/upstream/fedora-rawhide/man7/futex.7 b/upstream/fedora-rawhide/man7/futex.7 index ca92df1b..52af91f2 100644 --- a/upstream/fedora-rawhide/man7/futex.7 +++ b/upstream/fedora-rawhide/man7/futex.7 @@ -6,7 +6,7 @@ .\" .\" SPDX-License-Identifier: MIT .\" -.TH futex 7 2023-10-31 "Linux man-pages 6.06" +.TH futex 7 2023-10-31 "Linux man-pages 6.7" .SH NAME futex \- fast user-space locking .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/glob.7 b/upstream/fedora-rawhide/man7/glob.7 index 15af6eaa..0130c802 100644 --- a/upstream/fedora-rawhide/man7/glob.7 +++ b/upstream/fedora-rawhide/man7/glob.7 @@ -4,7 +4,7 @@ .\" .\" 2003-08-24 fix for / by John Kristoff + joey .\" -.TH glob 7 2023-10-31 "Linux man-pages 6.06" +.TH glob 7 2023-10-31 "Linux man-pages 6.7" .SH NAME glob \- globbing pathnames .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/hier.7 b/upstream/fedora-rawhide/man7/hier.7 index 36aa3164..497e0f5f 100644 --- a/upstream/fedora-rawhide/man7/hier.7 +++ b/upstream/fedora-rawhide/man7/hier.7 @@ -8,7 +8,7 @@ .\" Modified Mon Feb 6 16:41:00 1999 by Nicolás Lichtmaier <nick@debian.org> .\" Modified Tue Feb 8 16:46:45 2000 by Chris Pepper <pepper@tgg.com> .\" Modified Fri Sep 7 20:32:45 2001 by Tammy Fox <tfox@redhat.com> -.TH hier 7 2023-10-31 "Linux man-pages 6.06" +.TH hier 7 2023-10-31 "Linux man-pages 6.7" .SH NAME hier \- description of the filesystem hierarchy .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/hostname.7 b/upstream/fedora-rawhide/man7/hostname.7 index 569cd618..58d00d1a 100644 --- a/upstream/fedora-rawhide/man7/hostname.7 +++ b/upstream/fedora-rawhide/man7/hostname.7 @@ -8,7 +8,7 @@ .\" .\" 2008-06-11, mtk, Taken from FreeBSD 6.2 and modified for Linux. .\" -.TH hostname 7 2023-11-11 "Linux man-pages 6.06" +.TH hostname 7 2023-11-11 "Linux man-pages 6.7" .SH NAME hostname \- hostname resolution description .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/hwdb.7 b/upstream/fedora-rawhide/man7/hwdb.7 index cf1e66f5..2b8665ee 100644 --- a/upstream/fedora-rawhide/man7/hwdb.7 +++ b/upstream/fedora-rawhide/man7/hwdb.7 @@ -1,5 +1,5 @@ '\" t -.TH "HWDB" "7" "" "systemd 255" "hwdb" +.TH "HWDB" "7" "" "systemd 256~rc3" "hwdb" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man7/icmp.7 b/upstream/fedora-rawhide/man7/icmp.7 index 013fda13..3969fe23 100644 --- a/upstream/fedora-rawhide/man7/icmp.7 +++ b/upstream/fedora-rawhide/man7/icmp.7 @@ -5,7 +5,7 @@ .\" .\" $Id: icmp.7,v 1.6 2000/08/14 08:03:45 ak Exp $ .\" -.TH icmp 7 2023-10-31 "Linux man-pages 6.06" +.TH icmp 7 2023-10-31 "Linux man-pages 6.7" .SH NAME icmp \- Linux IPv4 ICMP kernel module. .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/inode.7 b/upstream/fedora-rawhide/man7/inode.7 index 0867f6d3..7054fe8b 100644 --- a/upstream/fedora-rawhide/man7/inode.7 +++ b/upstream/fedora-rawhide/man7/inode.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH inode 7 2023-10-31 "Linux man-pages 6.06" +.TH inode 7 2023-10-31 "Linux man-pages 6.7" .SH NAME inode \- file inode information .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/inotify.7 b/upstream/fedora-rawhide/man7/inotify.7 index e56867ab..51faaaa7 100644 --- a/upstream/fedora-rawhide/man7/inotify.7 +++ b/upstream/fedora-rawhide/man7/inotify.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH inotify 7 2023-10-31 "Linux man-pages 6.06" +.TH inotify 7 2023-10-31 "Linux man-pages 6.7" .SH NAME inotify \- monitoring filesystem events .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/intro.7 b/upstream/fedora-rawhide/man7/intro.7 index 5b2444f0..98c8ed95 100644 --- a/upstream/fedora-rawhide/man7/intro.7 +++ b/upstream/fedora-rawhide/man7/intro.7 @@ -6,7 +6,7 @@ .\" .\" Modified by Thomas Koenig (ig25@rz.uni-karlsruhe.de) 24 Apr 1993 .\" Modified Sat Jul 24 17:28:08 1993 by Rik Faith (faith@cs.unc.edu) -.TH intro 7 2022-10-30 "Linux man-pages 6.06" +.TH intro 7 2022-10-30 "Linux man-pages 6.7" .SH NAME intro \- introduction to overview and miscellany section .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/ip.7 b/upstream/fedora-rawhide/man7/ip.7 index 6edb8e69..34e2ff85 100644 --- a/upstream/fedora-rawhide/man7/ip.7 +++ b/upstream/fedora-rawhide/man7/ip.7 @@ -35,7 +35,7 @@ .\" commit 76e21053b5bf33a07c76f99d27a74238310e3c71 .\" Author: Erich E. Hoover <ehoover@mines.edu> .\" -.TH ip 7 2023-10-31 "Linux man-pages 6.06" +.TH ip 7 2024-03-17 "Linux man-pages 6.7" .SH NAME ip \- Linux IPv4 protocol implementation .SH SYNOPSIS @@ -828,6 +828,10 @@ is not zero, the primary local address of the interface specified by the index overwrites .I ipi_spec_dst for the routing table lookup. +.IP +Not supported for +.B SOCK_STREAM +sockets. .TP .BR IP_RECVERR " (since Linux 2.2)" .\" Precisely: since Linux 2.1.15 @@ -989,6 +993,9 @@ in which the kernel returns the original destination address of the datagram being received. The ancillary message contains a .IR "struct sockaddr_in" . +Not supported for +.B SOCK_STREAM +sockets. .TP .BR IP_RECVTOS " (since Linux 2.2)" .\" Precisely: since Linux 2.1.68 @@ -998,6 +1005,9 @@ ancillary message is passed with incoming packets. It contains a byte which specifies the Type of Service/Precedence field of the packet header. Expects a boolean integer flag. +Not supported for +.B SOCK_STREAM +sockets. .TP .BR IP_RECVTTL " (since Linux 2.2)" .\" Precisely: since Linux 2.1.68 @@ -1015,6 +1025,9 @@ Identical to .BR IP_RECVOPTS , but returns raw unprocessed options with timestamp and route record options not filled in for this hop. +Not supported for +.B SOCK_STREAM +sockets. .TP .BR IP_ROUTER_ALERT " (since Linux 2.2)" .\" Precisely: since Linux 2.1.68 diff --git a/upstream/fedora-rawhide/man7/ipc_namespaces.7 b/upstream/fedora-rawhide/man7/ipc_namespaces.7 index 7a3eb177..fe17ae1c 100644 --- a/upstream/fedora-rawhide/man7/ipc_namespaces.7 +++ b/upstream/fedora-rawhide/man7/ipc_namespaces.7 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH ipc_namespaces 7 2023-10-31 "Linux man-pages 6.06" +.TH ipc_namespaces 7 2023-10-31 "Linux man-pages 6.7" .SH NAME ipc_namespaces \- overview of Linux IPC namespaces .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/ipv6.7 b/upstream/fedora-rawhide/man7/ipv6.7 index ed776a3d..18acdc90 100644 --- a/upstream/fedora-rawhide/man7/ipv6.7 +++ b/upstream/fedora-rawhide/man7/ipv6.7 @@ -78,7 +78,7 @@ .\" commit c4062dfc425e94290ac427a98d6b4721dd2bc91f .\" Author: Erich E. Hoover <ehoover@mines.edu> .\" -.TH ipv6 7 2023-10-31 "Linux man-pages 6.06" +.TH ipv6 7 2023-10-31 "Linux man-pages 6.7" .SH NAME ipv6 \- Linux IPv6 protocol implementation .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/iso_8859-1.7 b/upstream/fedora-rawhide/man7/iso_8859-1.7 index 67883990..18e1bdce 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-1.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-1.7 @@ -5,7 +5,7 @@ .\" .\" Slightly rearranged, aeb, 950713 .\" Updated, dpo, 990531 -.TH ISO_8859-1 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-1 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-1 \- ISO/IEC\~8859-1 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-10.7 b/upstream/fedora-rawhide/man7/iso_8859-10.7 index 1e856fe4..79ee5f36 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-10.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-10.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ISO_8859-10 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-10 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-10 \- ISO/IEC\~8859-10 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-11.7 b/upstream/fedora-rawhide/man7/iso_8859-11.7 index 61915437..f7dc9b4f 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-11.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-11.7 @@ -5,7 +5,7 @@ .\" .\"Thanomsub Noppaburana <donga.nb@gmail.com> made valuable suggestions. .\" -.TH ISO_8859-11 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-11 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-11 \- ISO/IEC\~8859-11 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-13.7 b/upstream/fedora-rawhide/man7/iso_8859-13.7 index f0c33173..62561bf6 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-13.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-13.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ISO_8859-13 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-13 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-13 \- ISO/IEC\~8859-13 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-14.7 b/upstream/fedora-rawhide/man7/iso_8859-14.7 index 23c3e999..6c1f6eea 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-14.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-14.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ISO_8859-14 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-14 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-14 \- ISO/IEC\~8859-14 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-15.7 b/upstream/fedora-rawhide/man7/iso_8859-15.7 index d9773e96..fb6d6812 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-15.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-15.7 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ISO_8859-15 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-15 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-15 \- ISO/IEC\~8859-15 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-16.7 b/upstream/fedora-rawhide/man7/iso_8859-16.7 index bf42deea..9e3fdd39 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-16.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-16.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ISO_8859-16 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-16 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-16 \- ISO/IEC\~8859-16 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-2.7 b/upstream/fedora-rawhide/man7/iso_8859-2.7 index d2b642c3..225fbaa7 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-2.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-2.7 @@ -6,7 +6,7 @@ .\" .\" Slightly rearranged, aeb, 950713 .\" Updated, dpo, 990531 -.TH ISO_8859-2 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-2 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-2 \- ISO/IEC\~8859-2 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-3.7 b/upstream/fedora-rawhide/man7/iso_8859-3.7 index 5d4a3982..29c9e59c 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-3.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-3.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ISO_8859-3 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-3 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-3 \- ISO/IEC\~8859-3 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-4.7 b/upstream/fedora-rawhide/man7/iso_8859-4.7 index b1042dce..d772f62b 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-4.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-4.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ISO_8859-4 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-4 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-4 \- ISO/IEC\~8859-4 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-5.7 b/upstream/fedora-rawhide/man7/iso_8859-5.7 index 0828f8f1..6100a1d9 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-5.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-5.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ISO_8859-5 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-5 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-5 \- ISO/IEC\~8859-5 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-6.7 b/upstream/fedora-rawhide/man7/iso_8859-6.7 index 432f6865..f1b4b5c5 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-6.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-6.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ISO_8859-6 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-6 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-6 \- diff --git a/upstream/fedora-rawhide/man7/iso_8859-7.7 b/upstream/fedora-rawhide/man7/iso_8859-7.7 index ecbae472..242359c1 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-7.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-7.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ISO_8859-7 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-7 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-7 \- ISO/IEC\~8859-7 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-8.7 b/upstream/fedora-rawhide/man7/iso_8859-8.7 index 29aba89b..9fcc066c 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-8.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-8.7 @@ -5,7 +5,7 @@ .\" .\" Eli Zaretskii <eliz@gnu.org> made valuable suggestions .\" -.TH ISO_8859-8 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-8 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-8 \- ISO/IEC\~8859-8 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/iso_8859-9.7 b/upstream/fedora-rawhide/man7/iso_8859-9.7 index e4a41e51..4e630d78 100644 --- a/upstream/fedora-rawhide/man7/iso_8859-9.7 +++ b/upstream/fedora-rawhide/man7/iso_8859-9.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH ISO_8859-9 7 2024-01-28 "Linux man-pages 6.06" +.TH ISO_8859-9 7 2024-01-28 "Linux man-pages 6.7" .SH NAME iso_8859-9 \- ISO/IEC\~8859-9 character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/kernel-command-line.7 b/upstream/fedora-rawhide/man7/kernel-command-line.7 index e36aac8f..769870af 100644 --- a/upstream/fedora-rawhide/man7/kernel-command-line.7 +++ b/upstream/fedora-rawhide/man7/kernel-command-line.7 @@ -1,5 +1,5 @@ '\" t -.TH "KERNEL\-COMMAND\-LINE" "7" "" "systemd 255" "kernel-command-line" +.TH "KERNEL\-COMMAND\-LINE" "7" "" "systemd 256~rc3" "kernel-command-line" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -36,11 +36,10 @@ For command line parameters understood by the kernel, please see and \fBbootparam\fR(7)\&. .PP -For command line parameters understood by the initrd, see -\fBdracut.cmdline\fR(7), or the documentation of the specific initrd implementation of your installation\&. +For command line parameters understood by the initrd, see the documentation of the specific initrd implementation of your installation\&. .SH "CORE OS COMMAND LINE ARGUMENTS" .PP -\fIsystemd\&.unit=\fR, \fIrd\&.systemd\&.unit=\fR, \fIsystemd\&.dump_core\fR, \fIsystemd\&.crash_chvt\fR, \fIsystemd\&.crash_shell\fR, \fIsystemd\&.crash_reboot\fR, \fIsystemd\&.confirm_spawn\fR, \fIsystemd\&.service_watchdogs\fR, \fIsystemd\&.show_status\fR, \fIsystemd\&.status_unit_format=\fR, \fIsystemd\&.log_target=\fR, \fIsystemd\&.log_level=\fR, \fIsystemd\&.log_location=\fR, \fIsystemd\&.log_color\fR, \fIsystemd\&.log_ratelimit_kmsg\fR, \fIsystemd\&.default_standard_output=\fR, \fIsystemd\&.default_standard_error=\fR, \fIsystemd\&.setenv=\fR, \fIsystemd\&.machine_id=\fR, \fIsystemd\&.set_credential=\fR, \fIsystemd\&.set_credential_binary=\fR, \fIsystemd\&.import_credentials=\fR, \fIsystemd\&.reload_limit_interval_sec=\fR, \fIsystemd\&.reload_limit_burst=\fR +\fIsystemd\&.unit=\fR, \fIrd\&.systemd\&.unit=\fR, \fIsystemd\&.dump_core\fR, \fIsystemd\&.crash_chvt\fR, \fIsystemd\&.crash_shell\fR, \fIsystemd\&.crash_action=\fR, \fIsystemd\&.confirm_spawn\fR, \fIsystemd\&.service_watchdogs\fR, \fIsystemd\&.show_status\fR, \fIsystemd\&.status_unit_format=\fR, \fIsystemd\&.log_target=\fR, \fIsystemd\&.log_level=\fR, \fIsystemd\&.log_location=\fR, \fIsystemd\&.log_color\fR, \fIsystemd\&.log_ratelimit_kmsg\fR, \fIsystemd\&.default_standard_output=\fR, \fIsystemd\&.default_standard_error=\fR, \fIsystemd\&.setenv=\fR, \fIsystemd\&.machine_id=\fR, \fIsystemd\&.set_credential=\fR, \fIsystemd\&.set_credential_binary=\fR, \fIsystemd\&.import_credentials=\fR, \fIsystemd\&.reload_limit_interval_sec=\fR, \fIsystemd\&.reload_limit_burst=\fR .RS 4 Parameters understood by the system and service manager to control system behavior\&. For details, see \fBsystemd\fR(1)\&. @@ -48,7 +47,7 @@ Parameters understood by the system and service manager to control system behavi Added in version 186\&. .RE .PP -\fIsystemd\&.mask=\fR, \fIsystemd\&.wants=\fR, \fIsystemd\&.debug_shell\fR +\fIsystemd\&.mask=\fR, \fIsystemd\&.wants=\fR, \fIsystemd\&.debug_shell\fR, \fIsystemd\&.default_debug_tty=\fR .RS 4 Additional parameters understood by \fBsystemd-debug-generator\fR(8), to mask or start specific units at boot, or invoke a debug shell on tty9\&. @@ -83,6 +82,15 @@ and Added in version 209\&. .RE .PP +\fIsystemd\&.ssh_auto=\fR, \fIsystemd\&.ssh_listen=\fR +.RS 4 +These parameters are interpreted by +\fBsystemd-ssh-generator\fR(8) +and may be used to control SSH sockets the system shall be reachable on\&. +.sp +Added in version 256\&. +.RE +.PP \fIsystemd\&.volatile=\fR .RS 4 This parameter controls whether the system shall boot up in volatile mode\&. Takes a boolean argument, or the special value @@ -176,7 +184,7 @@ Parameters understood by the virtual console setup logic\&. For details, see Added in version 186\&. .RE .PP -\fIudev\&.log_level=\fR, \fIrd\&.udev\&.log_level=\fR, \fIudev\&.children_max=\fR, \fIrd\&.udev\&.children_max=\fR, \fIudev\&.exec_delay=\fR, \fIrd\&.udev\&.exec_delay=\fR, \fIudev\&.event_timeout=\fR, \fIrd\&.udev\&.event_timeout=\fR, \fIudev\&.timeout_signal=\fR, \fIrd\&.udev\&.timeout_signal=\fR, \fIudev\&.blockdev_read_only\fR, \fIrd\&.udev\&.blockdev_read_only\fR, \fInet\&.ifnames=\fR, \fInet\&.naming\-scheme=\fR +\fIudev\&.log_level=\fR, \fIrd\&.udev\&.log_level=\fR, \fIudev\&.children_max=\fR, \fIrd\&.udev\&.children_max=\fR, \fIudev\&.exec_delay=\fR, \fIrd\&.udev\&.exec_delay=\fR, \fIudev\&.event_timeout=\fR, \fIrd\&.udev\&.event_timeout=\fR, \fIudev\&.timeout_signal=\fR, \fIrd\&.udev\&.timeout_signal=\fR, \fIudev\&.blockdev_read_only\fR, \fIrd\&.udev\&.blockdev_read_only\fR, \fInet\&.ifnames=\fR, \fInet\&.naming_scheme=\fR .RS 4 Parameters understood by the device event managing daemon\&. For details, see \fBsystemd-udevd.service\fR(8)\&. @@ -370,19 +378,29 @@ Added in version 253\&. .PP \fIresume=\fR, \fIresumeflags=\fR .RS 4 -Enables resume from hibernation using the specified device and mount options\&. All -\fBfstab\fR(5)\-like paths are supported\&. For details, see +Enable resume from hibernation using the specified device and timeout options\&. All +\fBfstab\fR(5)\-style device identifiers are supported\&. For details, see \fBsystemd-hibernate-resume-generator\fR(8)\&. .sp Added in version 217\&. .RE .PP +\fIresume_offset=\fR +.RS 4 +Configure the page offset of the swap space from the resume device\&. For details, see +\fBsystemd-hibernate-resume-generator\fR(8)\&. +.sp +Added in version 254\&. +.RE +.PP \fIsystemd\&.firstboot=\fR .RS 4 Takes a boolean argument, defaults to on\&. If off, \fBsystemd-firstboot.service\fR(8) +and +\fBsystemd-homed-firstboot.service\fR(1) will not query the user for basic system settings, even if the system boots up for the first time and the relevant settings are not initialized yet\&. Not to be confused with -\fIsystemd\&.condition\-first\-boot=\fR +\fIsystemd\&.condition_first_boot=\fR (see below), which overrides the result of the \fIConditionFirstBoot=\fR unit file condition, and thus controls more than just @@ -392,7 +410,7 @@ behaviour\&. Added in version 233\&. .RE .PP -\fIsystemd\&.condition\-needs\-update=\fR +\fIsystemd\&.condition_needs_update=\fR .RS 4 Takes a boolean argument\&. If specified, overrides the result of \fIConditionNeedsUpdate=\fR @@ -403,7 +421,7 @@ for details\&. Added in version 246\&. .RE .PP -\fIsystemd\&.condition\-first\-boot=\fR +\fIsystemd\&.condition_first_boot=\fR .RS 4 Takes a boolean argument\&. If specified, overrides the result of \fIConditionFirstBoot=\fR @@ -418,14 +436,14 @@ system service but has no effect on the condition check (see above)\&. Added in version 246\&. .RE .PP -\fIsystemd\&.clock\-usec=\fR +\fIsystemd\&.clock_usec=\fR .RS 4 Takes a decimal, numeric timestamp in μs since January 1st 1970, 00:00am, to set the system clock to\&. The system time is set to the specified timestamp early during boot\&. It is not propagated to the hardware clock (RTC)\&. .sp Added in version 246\&. .RE .PP -\fIsystemd\&.random\-seed=\fR +\fIsystemd\&.random_seed=\fR .RS 4 Takes a base64 encoded random seed value to credit with full entropy to the kernel\*(Aqs random pool during early service manager initialization\&. This option is useful in testing environments where delays due to random pool initialization in entropy starved virtual machines shall be avoided\&. .sp @@ -449,6 +467,15 @@ Again: do not use this option outside of testing environments, it\*(Aqs a securi Added in version 246\&. .RE .PP +\fIsystemd\&.allow_userspace_verity=\fR +.RS 4 +Takes a boolean argument\&. Controls whether disk images that are Verity protected may be authenticated in userspace signature checks via +/etc/verity\&.d/ +(and related directories) public key drop\-ins, or whether in\-kernel signature checking only\&. Defaults to on\&. +.sp +Added in version 256\&. +.RE +.PP \fIsystemd\&.hostname=\fR .RS 4 Accepts a hostname to set during early boot\&. If specified takes precedence over what is set in @@ -479,6 +506,31 @@ prefix (e\&.g\&. .sp Added in version 254\&. .RE +.PP +\fIsystemd\&.battery_check=\fR +.RS 4 +Accepts a boolean argument\&. If false the boot\-time battery charge check implemented by +\fBsystemd-battery-check.service\fR(8) +is disabled\&. +.sp +Added in version 254\&. +.RE +.PP +\fIifname=\fR, \fInet\&.ifname_policy=\fR +.RS 4 +Controls interface naming policies, implemented by +\fBsystemd-network-generator.service\fR(8)\&. +.sp +Added in version 245\&. +.RE +.PP +\fIsystemd\&.tpm2_wait=\fR +.RS 4 +Controls whether to wait for a TPM2 device at boot, implemented by +\fBsystemd-tpm2-generator\fR(8)\&. +.sp +Added in version 256\&. +.RE .SH "HISTORY" .PP systemd 252 @@ -493,31 +545,7 @@ Added in version 252\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-system.conf\fR(5), -\fBbootparam\fR(7), -\fBsystemd.system-credentials\fR(7) -\fBsmbios-type-11\fR(7), -\fBdracut.cmdline\fR(7), -\fBsystemd-debug-generator\fR(8), -\fBsystemd-fsck@.service\fR(8), -\fBsystemd-quotacheck.service\fR(8), -\fBsystemd-journald.service\fR(8), -\fBsystemd-vconsole-setup.service\fR(8), -\fBsystemd-udevd.service\fR(8), -\fBplymouth\fR(8), -\fBsystemd-cryptsetup-generator\fR(8), -\fBsystemd-veritysetup-generator\fR(8), -\fBsystemd-fstab-generator\fR(8), -\fBsystemd-getty-generator\fR(8), -\fBsystemd-gpt-auto-generator\fR(8), -\fBsystemd-volatile-root.service\fR(8), -\fBsystemd-modules-load.service\fR(8), -\fBsystemd-backlight@.service\fR(8), -\fBsystemd-rfkill.service\fR(8), -\fBsystemd-hibernate-resume-generator\fR(8), -\fBsystemd-firstboot.service\fR(8), -\fBbootctl\fR(1) +\fBsystemd\fR(1), \fBsystemd-system.conf\fR(5), \fBbootparam\fR(7), \fBsystemd.system-credentials\fR(7), \fBsmbios-type-11\fR(7), \fBsystemd-debug-generator\fR(8), \fBsystemd-fsck@.service\fR(8), \fBsystemd-quotacheck.service\fR(8), \fBsystemd-journald.service\fR(8), \fBsystemd-vconsole-setup.service\fR(8), \fBsystemd-udevd.service\fR(8), \fBplymouth\fR(8), \fBsystemd-cryptsetup-generator\fR(8), \fBsystemd-veritysetup-generator\fR(8), \fBsystemd-fstab-generator\fR(8), \fBsystemd-getty-generator\fR(8), \fBsystemd-gpt-auto-generator\fR(8), \fBsystemd-volatile-root.service\fR(8), \fBsystemd-modules-load.service\fR(8), \fBsystemd-backlight@.service\fR(8), \fBsystemd-rfkill.service\fR(8), \fBsystemd-hibernate-resume-generator\fR(8), \fBsystemd-firstboot.service\fR(8), \fBbootctl\fR(1) .SH "NOTES" .IP " 1." 4 kernel-parameters.html diff --git a/upstream/fedora-rawhide/man7/kernel_lockdown.7 b/upstream/fedora-rawhide/man7/kernel_lockdown.7 index ce2d9379..cb8aa7c3 100644 --- a/upstream/fedora-rawhide/man7/kernel_lockdown.7 +++ b/upstream/fedora-rawhide/man7/kernel_lockdown.7 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH kernel_lockdown 7 2023-10-31 "Linux man-pages 6.06" +.TH kernel_lockdown 7 2023-10-31 "Linux man-pages 6.7" .SH NAME kernel_lockdown \- kernel image access prevention feature .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/keyrings.7 b/upstream/fedora-rawhide/man7/keyrings.7 index 2df33993..879d1aaa 100644 --- a/upstream/fedora-rawhide/man7/keyrings.7 +++ b/upstream/fedora-rawhide/man7/keyrings.7 @@ -4,7 +4,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH keyrings 7 2023-10-31 "Linux man-pages 6.06" +.TH keyrings 7 2024-02-25 "Linux man-pages 6.7" .SH NAME keyrings \- in-kernel key management and retention facility .SH DESCRIPTION @@ -98,7 +98,7 @@ the key is scheduled for garbage collection. .SS Key types The kernel provides several basic types of key: .TP -.I """keyring""" +.I \[dq]keyring\[dq] .\" Note that keyrings use different fields in struct key in order to store .\" their data - index_key instead of type/description and name_link/keys .\" instead of payload. @@ -111,7 +111,7 @@ being garbage collected because nothing refers to them. Keyrings with descriptions (names) that begin with a period (\[aq].\[aq]) are reserved to the implementation. .TP -.I """user""" +.I \[dq]user\[dq] This is a general-purpose key type. The key is kept entirely within kernel memory. The payload may be read and updated by user-space applications. @@ -123,12 +123,12 @@ The description may be any valid string, though it is preferred that it start with a colon-delimited prefix representing the service to which the key is of interest (for instance -.IR """afs:mykey""" ). +.IR \[dq]afs:mykey\[dq] ). .TP -.IR """logon""" " (since Linux 3.3)" +.IR \[dq]logon\[dq] " (since Linux 3.3)" .\" commit 9f6ed2ca257fa8650b876377833e6f14e272848b This key type is essentially the same as -.IR """user""" , +.IR \[dq]user\[dq] , but it does not provide reading (i.e., the .BR keyctl (2) .B KEYCTL_READ @@ -138,19 +138,19 @@ This is suitable for storing username-password pairs that should not be readable from user space. .IP The description of a -.I """logon""" +.I \[dq]logon\[dq] key .I must start with a non-empty colon-delimited prefix whose purpose is to identify the service to which the key belongs. (Note that this differs from keys of the -.I """user""" +.I \[dq]user\[dq] type, where the inclusion of a prefix is recommended but is not enforced.) .TP -.IR """big_key""" " (since Linux 3.13)" +.IR \[dq]big_key\[dq] " (since Linux 3.13)" .\" commit ab3c3587f8cda9083209a61dbe3a4407d3cada10 This key type is similar to the -.I """user""" +.I \[dq]user\[dq] key type, but it may hold a payload of up to 1\ MiB in size. This key type is useful for purposes such as holding Kerberos ticket caches. .IP @@ -685,16 +685,16 @@ field provides some further information about the key. The information that appears here depends on the key type, as follows: .RS .TP -.IR """user""" " and " """logon""" +.IR \[dq]user\[dq] " and " \[dq]logon\[dq] The size in bytes of the key payload (expressed in decimal). .TP -.I """keyring""" +.I \[dq]keyring\[dq] The number of keys linked to the keyring, or the string .I empty if there are no keys linked to the keyring. .TP -.I """big_key""" +.I \[dq]big_key\[dq] The payload size in bytes, followed either by the string .IR [file] , if the key payload exceeds the threshold that means that the @@ -707,7 +707,7 @@ indicating that the key is small enough to reside in kernel memory. .RE .IP For the -.I """.request_key_auth""" +.I \[dq].request_key_auth\[dq] key type (authorization key; see .BR request_key (2)), diff --git a/upstream/fedora-rawhide/man7/koi8-r.7 b/upstream/fedora-rawhide/man7/koi8-r.7 index f0a8c4b8..5239cb5d 100644 --- a/upstream/fedora-rawhide/man7/koi8-r.7 +++ b/upstream/fedora-rawhide/man7/koi8-r.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH KOI8-R 7 2022-12-15 "Linux man-pages 6.06" +.TH KOI8-R 7 2022-12-15 "Linux man-pages 6.7" .SH NAME koi8-r \- Russian character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/koi8-u.7 b/upstream/fedora-rawhide/man7/koi8-u.7 index c3cf67ea..00dec198 100644 --- a/upstream/fedora-rawhide/man7/koi8-u.7 +++ b/upstream/fedora-rawhide/man7/koi8-u.7 @@ -5,7 +5,7 @@ .\" .\" 2009-01-15, mtk, Some edits .\" -.TH KOI8-U 7 2022-12-15 "Linux man-pages 6.06" +.TH KOI8-U 7 2022-12-15 "Linux man-pages 6.7" .SH NAME koi8-u \- Ukrainian character set encoded in octal, decimal, and hexadecimal diff --git a/upstream/fedora-rawhide/man7/landlock.7 b/upstream/fedora-rawhide/man7/landlock.7 index c96de124..3df7d7b2 100644 --- a/upstream/fedora-rawhide/man7/landlock.7 +++ b/upstream/fedora-rawhide/man7/landlock.7 @@ -5,7 +5,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH Landlock 7 2023-10-31 "Linux man-pages 6.06" +.TH Landlock 7 2023-10-31 "Linux man-pages 6.7" .SH NAME Landlock \- unprivileged access-control .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/libc.7 b/upstream/fedora-rawhide/man7/libc.7 index f8b18dfe..5e906d16 100644 --- a/upstream/fedora-rawhide/man7/libc.7 +++ b/upstream/fedora-rawhide/man7/libc.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH libc 7 2023-10-31 "Linux man-pages 6.06" +.TH libc 7 2023-10-31 "Linux man-pages 6.7" .SH NAME libc \- overview of standard C libraries on Linux .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/locale.7 b/upstream/fedora-rawhide/man7/locale.7 index 5e9e164f..862a1d59 100644 --- a/upstream/fedora-rawhide/man7/locale.7 +++ b/upstream/fedora-rawhide/man7/locale.7 @@ -8,7 +8,7 @@ .\" <jochen.hein@delphi.central.de> .\" Modified Thu Apr 25 00:43:19 2002 by Bruno Haible <bruno@clisp.org> .\" -.TH locale 7 2023-10-31 "Linux man-pages 6.06" +.TH locale 7 2024-02-25 "Linux man-pages 6.7" .SH NAME locale \- description of multilanguage support .SH SYNOPSIS @@ -131,7 +131,7 @@ functions also obey the environment variable .B LANGUAGE (containing a colon-separated list of locales) if the category is set to a valid locale other than -.BR """C""" . +.BR \[dq]C\[dq] . This category also affects the behavior of .BR catopen (3). .TP diff --git a/upstream/fedora-rawhide/man7/mailaddr.7 b/upstream/fedora-rawhide/man7/mailaddr.7 index 4784728b..f2da7da2 100644 --- a/upstream/fedora-rawhide/man7/mailaddr.7 +++ b/upstream/fedora-rawhide/man7/mailaddr.7 @@ -24,7 +24,7 @@ .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. .\" %%%LICENSE_END .\" -.TH mailaddr 7 2023-10-31 "Linux man-pages 6.06" +.TH mailaddr 7 2023-10-31 "Linux man-pages 6.7" .UC 5 .SH NAME mailaddr \- mail addressing description diff --git a/upstream/fedora-rawhide/man7/man-pages.7 b/upstream/fedora-rawhide/man7/man-pages.7 index bd72e7ca..c7eeb0aa 100644 --- a/upstream/fedora-rawhide/man7/man-pages.7 +++ b/upstream/fedora-rawhide/man7/man-pages.7 @@ -8,7 +8,7 @@ .\" 2007-05-30 created by mtk, using text from old man.7 plus .\" rewrites and additional text. .\" -.TH man-pages 7 2023-10-31 "Linux man-pages 6.06" +.TH man-pages 7 2023-10-31 "Linux man-pages 6.7" .SH NAME man-pages \- conventions for writing Linux man pages .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/math_error.7 b/upstream/fedora-rawhide/man7/math_error.7 index aed1a7dc..6fdff9a6 100644 --- a/upstream/fedora-rawhide/man7/math_error.7 +++ b/upstream/fedora-rawhide/man7/math_error.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH math_error 7 2023-10-31 "Linux man-pages 6.06" +.TH math_error 7 2023-10-31 "Linux man-pages 6.7" .SH NAME math_error \- detecting errors from mathematical functions .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/mount_namespaces.7 b/upstream/fedora-rawhide/man7/mount_namespaces.7 index b9176052..475b44db 100644 --- a/upstream/fedora-rawhide/man7/mount_namespaces.7 +++ b/upstream/fedora-rawhide/man7/mount_namespaces.7 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH mount_namespaces 7 2023-10-31 "Linux man-pages 6.06" +.TH mount_namespaces 7 2023-10-31 "Linux man-pages 6.7" .SH NAME mount_namespaces \- overview of Linux mount namespaces .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/mq_overview.7 b/upstream/fedora-rawhide/man7/mq_overview.7 index 7fd1f391..223f2381 100644 --- a/upstream/fedora-rawhide/man7/mq_overview.7 +++ b/upstream/fedora-rawhide/man7/mq_overview.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH mq_overview 7 2023-10-31 "Linux man-pages 6.06" +.TH mq_overview 7 2023-10-31 "Linux man-pages 6.7" .SH NAME mq_overview \- overview of POSIX message queues .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/namespaces.7 b/upstream/fedora-rawhide/man7/namespaces.7 index ea2da41a..5fdca2e3 100644 --- a/upstream/fedora-rawhide/man7/namespaces.7 +++ b/upstream/fedora-rawhide/man7/namespaces.7 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH namespaces 7 2023-10-31 "Linux man-pages 6.06" +.TH namespaces 7 2023-10-31 "Linux man-pages 6.7" .SH NAME namespaces \- overview of Linux namespaces .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/netdevice.7 b/upstream/fedora-rawhide/man7/netdevice.7 index 29426763..9f9f0022 100644 --- a/upstream/fedora-rawhide/man7/netdevice.7 +++ b/upstream/fedora-rawhide/man7/netdevice.7 @@ -10,7 +10,7 @@ .\" Modified, 2011-11-02, <bidulock@openss7.org>, added many basic .\" but missing ioctls, such as SIOCGIFADDR. .\" -.TH netdevice 7 2023-10-31 "Linux man-pages 6.06" +.TH netdevice 7 2023-10-31 "Linux man-pages 6.7" .SH NAME netdevice \- low-level access to Linux network devices .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/netlink.7 b/upstream/fedora-rawhide/man7/netlink.7 index 5227c455..e0e14f4f 100644 --- a/upstream/fedora-rawhide/man7/netlink.7 +++ b/upstream/fedora-rawhide/man7/netlink.7 @@ -6,7 +6,7 @@ .\" Based on the original comments from Alexey Kuznetsov .\" Modified 2005-12-27 by Hasso Tepper <hasso@estpak.ee> .\" $Id: netlink.7,v 1.8 2000/06/22 13:23:00 ak Exp $ -.TH netlink 7 2023-10-31 "Linux man-pages 6.06" +.TH netlink 7 2023-10-31 "Linux man-pages 6.7" .SH NAME netlink \- communication between kernel and user space (AF_NETLINK) .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/network_namespaces.7 b/upstream/fedora-rawhide/man7/network_namespaces.7 index d20585c8..06d323f4 100644 --- a/upstream/fedora-rawhide/man7/network_namespaces.7 +++ b/upstream/fedora-rawhide/man7/network_namespaces.7 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH network_namespaces 7 2023-10-31 "Linux man-pages 6.06" +.TH network_namespaces 7 2023-10-31 "Linux man-pages 6.7" .SH NAME network_namespaces \- overview of Linux network namespaces .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/nptl.7 b/upstream/fedora-rawhide/man7/nptl.7 index e62a698e..421ad5f8 100644 --- a/upstream/fedora-rawhide/man7/nptl.7 +++ b/upstream/fedora-rawhide/man7/nptl.7 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH nptl 7 2023-10-31 "Linux man-pages 6.06" +.TH nptl 7 2023-10-31 "Linux man-pages 6.7" .SH NAME nptl \- Native POSIX Threads Library .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/numa.7 b/upstream/fedora-rawhide/man7/numa.7 index 9823de16..03654691 100644 --- a/upstream/fedora-rawhide/man7/numa.7 +++ b/upstream/fedora-rawhide/man7/numa.7 @@ -6,7 +6,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH numa 7 2023-10-31 "Linux man-pages 6.06" +.TH numa 7 2023-10-31 "Linux man-pages 6.7" .SH NAME numa \- overview of Non-Uniform Memory Architecture .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/operator.7 b/upstream/fedora-rawhide/man7/operator.7 index 4627fd7d..047041e8 100644 --- a/upstream/fedora-rawhide/man7/operator.7 +++ b/upstream/fedora-rawhide/man7/operator.7 @@ -14,7 +14,7 @@ .\" .\" 2007-12-08, mtk, Converted from mdoc to man macros .\" -.TH operator 7 2023-10-31 "Linux man-pages 6.06" +.TH operator 7 2023-10-31 "Linux man-pages 6.7" .SH NAME operator \- C operator precedence and order of evaluation .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/packet.7 b/upstream/fedora-rawhide/man7/packet.7 index 40f0d471..5d9d0cfe 100644 --- a/upstream/fedora-rawhide/man7/packet.7 +++ b/upstream/fedora-rawhide/man7/packet.7 @@ -4,7 +4,7 @@ .\" .\" $Id: packet.7,v 1.13 2000/08/14 08:03:45 ak Exp $ .\" -.TH packet 7 2023-10-31 "Linux man-pages 6.06" +.TH packet 7 2023-10-31 "Linux man-pages 6.7" .SH NAME packet \- packet interface on device level .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/path_resolution.7 b/upstream/fedora-rawhide/man7/path_resolution.7 index ab0389df..ac814ed0 100644 --- a/upstream/fedora-rawhide/man7/path_resolution.7 +++ b/upstream/fedora-rawhide/man7/path_resolution.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH path_resolution 7 2023-10-31 "Linux man-pages 6.06" +.TH path_resolution 7 2024-02-18 "Linux man-pages 6.7" .SH NAME path_resolution \- how a pathname is resolved to a file .SH DESCRIPTION @@ -132,7 +132,7 @@ we are just creating it. The details on the treatment of the final entry are described in the manual pages of the specific system calls. -.SS . and .. +.SS "\&. and .." By convention, every directory has the entries "." and "..", which refer to the directory itself and to its parent directory, respectively. diff --git a/upstream/fedora-rawhide/man7/persistent-keyring.7 b/upstream/fedora-rawhide/man7/persistent-keyring.7 index 47f96ecf..0db49408 100644 --- a/upstream/fedora-rawhide/man7/persistent-keyring.7 +++ b/upstream/fedora-rawhide/man7/persistent-keyring.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH persistent-keyring 7 2023-10-31 "Linux man-pages 6.06" +.TH persistent-keyring 7 2023-10-31 "Linux man-pages 6.7" .SH NAME persistent-keyring \- per-user persistent keyring .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/pid_namespaces.7 b/upstream/fedora-rawhide/man7/pid_namespaces.7 index 601f39fc..90d062b9 100644 --- a/upstream/fedora-rawhide/man7/pid_namespaces.7 +++ b/upstream/fedora-rawhide/man7/pid_namespaces.7 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH pid_namespaces 7 2023-10-31 "Linux man-pages 6.06" +.TH pid_namespaces 7 2023-10-31 "Linux man-pages 6.7" .SH NAME pid_namespaces \- overview of Linux PID namespaces .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/pipe.7 b/upstream/fedora-rawhide/man7/pipe.7 index 0fd53f9b..bebb856f 100644 --- a/upstream/fedora-rawhide/man7/pipe.7 +++ b/upstream/fedora-rawhide/man7/pipe.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pipe 7 2023-10-31 "Linux man-pages 6.06" +.TH pipe 7 2023-10-31 "Linux man-pages 6.7" .SH NAME pipe \- overview of pipes and FIFOs .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/pkeys.7 b/upstream/fedora-rawhide/man7/pkeys.7 index 65bc78e9..660805cd 100644 --- a/upstream/fedora-rawhide/man7/pkeys.7 +++ b/upstream/fedora-rawhide/man7/pkeys.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pkeys 7 2023-10-31 "Linux man-pages 6.06" +.TH pkeys 7 2023-10-31 "Linux man-pages 6.7" .SH NAME pkeys \- overview of Memory Protection Keys .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/posixoptions.7 b/upstream/fedora-rawhide/man7/posixoptions.7 index fa8a5074..2b3e3bc5 100644 --- a/upstream/fedora-rawhide/man7/posixoptions.7 +++ b/upstream/fedora-rawhide/man7/posixoptions.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH posixoptions 7 2023-11-01 "Linux man-pages 6.06" +.TH posixoptions 7 2023-11-01 "Linux man-pages 6.7" .SH NAME posixoptions \- optional parts of the POSIX standard .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/process-keyring.7 b/upstream/fedora-rawhide/man7/process-keyring.7 index 6c53b64c..23a7722c 100644 --- a/upstream/fedora-rawhide/man7/process-keyring.7 +++ b/upstream/fedora-rawhide/man7/process-keyring.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH process-keyring 7 2023-10-31 "Linux man-pages 6.06" +.TH process-keyring 7 2023-10-31 "Linux man-pages 6.7" .SH NAME process-keyring \- per-process shared keyring .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/pthreads.7 b/upstream/fedora-rawhide/man7/pthreads.7 index 821ad65b..6d4a5e3c 100644 --- a/upstream/fedora-rawhide/man7/pthreads.7 +++ b/upstream/fedora-rawhide/man7/pthreads.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pthreads 7 2023-10-31 "Linux man-pages 6.06" +.TH pthreads 7 2023-10-31 "Linux man-pages 6.7" .SH NAME pthreads \- POSIX threads .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/pty.7 b/upstream/fedora-rawhide/man7/pty.7 index 9f31c8d2..45cdb5f5 100644 --- a/upstream/fedora-rawhide/man7/pty.7 +++ b/upstream/fedora-rawhide/man7/pty.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH pty 7 2023-11-19 "Linux man-pages 6.06" +.TH pty 7 2023-11-19 "Linux man-pages 6.7" .SH NAME pty \- pseudoterminal interfaces .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/queue.7 b/upstream/fedora-rawhide/man7/queue.7 index 823385f2..469974f1 100644 --- a/upstream/fedora-rawhide/man7/queue.7 +++ b/upstream/fedora-rawhide/man7/queue.7 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: BSD-3-Clause .\" .\" -.TH queue 7 2023-10-31 "Linux man-pages 6.06" +.TH queue 7 2023-10-31 "Linux man-pages 6.7" .SH NAME queue \- implementations of linked lists and queues .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/random.7 b/upstream/fedora-rawhide/man7/random.7 index 02660a23..5ba6d334 100644 --- a/upstream/fedora-rawhide/man7/random.7 +++ b/upstream/fedora-rawhide/man7/random.7 @@ -9,7 +9,7 @@ .\" The following web page is quite informative: .\" http://www.2uo.de/myths-about-urandom/ .\" -.TH random 7 2023-10-31 "Linux man-pages 6.06" +.TH random 7 2023-10-31 "Linux man-pages 6.7" .SH NAME random \- overview of interfaces for obtaining randomness .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/raw.7 b/upstream/fedora-rawhide/man7/raw.7 index dedb91fe..65cdbe08 100644 --- a/upstream/fedora-rawhide/man7/raw.7 +++ b/upstream/fedora-rawhide/man7/raw.7 @@ -5,7 +5,7 @@ .\" .\" $Id: raw.7,v 1.6 1999/06/05 10:32:08 freitag Exp $ .\" -.TH raw 7 2023-10-31 "Linux man-pages 6.06" +.TH raw 7 2023-10-31 "Linux man-pages 6.7" .SH NAME raw \- Linux IPv4 raw sockets .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/regex.7 b/upstream/fedora-rawhide/man7/regex.7 index e25c83c4..ad635739 100644 --- a/upstream/fedora-rawhide/man7/regex.7 +++ b/upstream/fedora-rawhide/man7/regex.7 @@ -35,7 +35,7 @@ .\" .ie t .ds dg \(dg .el .ds dg (!) -.TH regex 7 2023-11-01 "Linux man-pages 6.06" +.TH regex 7 2023-11-01 "Linux man-pages 6.7" .SH NAME regex \- POSIX.2 regular expressions .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/rtld-audit.7 b/upstream/fedora-rawhide/man7/rtld-audit.7 index 8fbb69f8..67678b49 100644 --- a/upstream/fedora-rawhide/man7/rtld-audit.7 +++ b/upstream/fedora-rawhide/man7/rtld-audit.7 @@ -5,7 +5,7 @@ .\" .\" 2009-01-12, mtk, Created .\" -.TH RTLD-AUDIT 7 2023-10-31 "Linux man-pages 6.06" +.TH RTLD-AUDIT 7 2023-10-31 "Linux man-pages 6.7" .SH NAME rtld\-audit \- auditing API for the dynamic linker .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/rtnetlink.7 b/upstream/fedora-rawhide/man7/rtnetlink.7 index a8dfb9ff..1ab355fc 100644 --- a/upstream/fedora-rawhide/man7/rtnetlink.7 +++ b/upstream/fedora-rawhide/man7/rtnetlink.7 @@ -7,7 +7,7 @@ .\" help from Matthew Wilcox. .\" $Id: rtnetlink.7,v 1.8 2000/01/22 01:55:04 freitag Exp $ .\" -.TH rtnetlink 7 2023-10-31 "Linux man-pages 6.06" +.TH rtnetlink 7 2023-10-31 "Linux man-pages 6.7" .SH NAME rtnetlink \- Linux routing socket .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/samba.7 b/upstream/fedora-rawhide/man7/samba.7 index 362c5ba9..f48d0cb2 100644 --- a/upstream/fedora-rawhide/man7/samba.7 +++ b/upstream/fedora-rawhide/man7/samba.7 @@ -2,12 +2,12 @@ .\" Title: samba .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/26/2024 +.\" Date: 05/08/2024 .\" Manual: Miscellanea -.\" Source: Samba 4.20.0rc3 +.\" Source: Samba 4.20.1 .\" Language: English .\" -.TH "SAMBA" "7" "02/26/2024" "Samba 4\&.20\&.0rc3" "Miscellanea" +.TH "SAMBA" "7" "05/08/2024" "Samba 4\&.20\&.1" "Miscellanea" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -231,7 +231,7 @@ https://lists\&.samba\&.org you can find a lot of information in the archives and you can subscribe to the samba list and ask for help or discuss things\&. .SH "VERSION" .PP -This man page is part of version 4\&.20\&.0rc3 of the Samba suite\&. +This man page is part of version 4\&.20\&.1 of the Samba suite\&. .SH "CONTRIBUTIONS" .PP If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at diff --git a/upstream/fedora-rawhide/man7/sched.7 b/upstream/fedora-rawhide/man7/sched.7 index 901fd40e..7e1212ff 100644 --- a/upstream/fedora-rawhide/man7/sched.7 +++ b/upstream/fedora-rawhide/man7/sched.7 @@ -10,7 +10,7 @@ .\" .\" Worth looking at: http://rt.wiki.kernel.org/index.php .\" -.TH sched 7 2023-10-31 "Linux man-pages 6.06" +.TH sched 7 2024-02-18 "Linux man-pages 6.7" .SH NAME sched \- overview of CPU scheduling .SH DESCRIPTION @@ -158,7 +158,7 @@ changes the priority of the running or runnable thread identified by .I pid the effect on the thread's position in the list depends on -the direction of the change to threads priority: +the direction of the change to the thread's priority: .RS .IP (a) 5 If the thread's priority is raised, diff --git a/upstream/fedora-rawhide/man7/sem_overview.7 b/upstream/fedora-rawhide/man7/sem_overview.7 index 8578f7db..67f2e41a 100644 --- a/upstream/fedora-rawhide/man7/sem_overview.7 +++ b/upstream/fedora-rawhide/man7/sem_overview.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sem_overview 7 2023-10-31 "Linux man-pages 6.06" +.TH sem_overview 7 2023-10-31 "Linux man-pages 6.7" .SH NAME sem_overview \- overview of POSIX semaphores .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/session-keyring.7 b/upstream/fedora-rawhide/man7/session-keyring.7 index c49c4ce7..d67de259 100644 --- a/upstream/fedora-rawhide/man7/session-keyring.7 +++ b/upstream/fedora-rawhide/man7/session-keyring.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH session-keyring 7 2023-10-31 "Linux man-pages 6.06" +.TH session-keyring 7 2023-10-31 "Linux man-pages 6.7" .SH NAME session-keyring \- session shared process keyring .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/shm_overview.7 b/upstream/fedora-rawhide/man7/shm_overview.7 index 5d68097b..a049e4cc 100644 --- a/upstream/fedora-rawhide/man7/shm_overview.7 +++ b/upstream/fedora-rawhide/man7/shm_overview.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH shm_overview 7 2023-10-31 "Linux man-pages 6.06" +.TH shm_overview 7 2023-10-31 "Linux man-pages 6.7" .SH NAME shm_overview \- overview of POSIX shared memory .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/signal-safety.7 b/upstream/fedora-rawhide/man7/signal-safety.7 index f86309a3..d307dda4 100644 --- a/upstream/fedora-rawhide/man7/signal-safety.7 +++ b/upstream/fedora-rawhide/man7/signal-safety.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH signal-safety 7 2023-10-31 "Linux man-pages 6.06" +.TH signal-safety 7 2023-10-31 "Linux man-pages 6.7" .SH NAME signal-safety \- async-signal-safe functions .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/signal.7 b/upstream/fedora-rawhide/man7/signal.7 index d54c3878..39281e5a 100644 --- a/upstream/fedora-rawhide/man7/signal.7 +++ b/upstream/fedora-rawhide/man7/signal.7 @@ -23,7 +23,7 @@ .\" Added section on stop/cont signals interrupting syscalls. .\" 2008-10-05, mtk: various additions .\" -.TH signal 7 2023-10-31 "Linux man-pages 6.06" +.TH signal 7 2023-10-31 "Linux man-pages 6.7" .SH NAME signal \- overview of signals .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/smbios-type-11.7 b/upstream/fedora-rawhide/man7/smbios-type-11.7 index b9c52637..5893c76a 100644 --- a/upstream/fedora-rawhide/man7/smbios-type-11.7 +++ b/upstream/fedora-rawhide/man7/smbios-type-11.7 @@ -1,5 +1,5 @@ '\" t -.TH "SMBIOS\-TYPE\-11" "7" "" "systemd 255" "smbios-type-11" +.TH "SMBIOS\-TYPE\-11" "7" "" "systemd 256~rc3" "smbios-type-11" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -55,11 +55,18 @@ This allows configuration of additional kernel command line options, and is read .sp Added in version 254\&. .RE +.PP +\fIio\&.systemd\&.boot\&.kernel\-cmdline\-extra=\fR\fICMDLINE\fR +.RS 4 +This allows configuration of additional kernel command line options for Boot Loader Specification Type 1 entries, and is read by +\fBsystemd\-boot\fR\&. For details see +\fBsystemd-boot\fR(1)\&. +.sp +Added in version 256\&. +.RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBkernel-command-line\fR(7), -\fBsystemd.system-credentials\fR(7) +\fBsystemd\fR(1), \fBkernel-command-line\fR(7), \fBsystemd.system-credentials\fR(7) .SH "NOTES" .IP " 1." 4 System Management BIOS diff --git a/upstream/fedora-rawhide/man7/sock_diag.7 b/upstream/fedora-rawhide/man7/sock_diag.7 index ad0d1a92..3da3b4a5 100644 --- a/upstream/fedora-rawhide/man7/sock_diag.7 +++ b/upstream/fedora-rawhide/man7/sock_diag.7 @@ -2,7 +2,7 @@ .\" Copyright (c) 2016 Dmitry V. Levin <ldv@altlinux.org> .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH sock_diag 7 2023-10-31 "Linux man-pages 6.06" +.TH sock_diag 7 2023-10-31 "Linux man-pages 6.7" .SH NAME sock_diag \- obtaining information about sockets .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/socket.7 b/upstream/fedora-rawhide/man7/socket.7 index 88ee3f39..619139e4 100644 --- a/upstream/fedora-rawhide/man7/socket.7 +++ b/upstream/fedora-rawhide/man7/socket.7 @@ -47,7 +47,7 @@ .\" commit ea02f9411d9faa3553ed09ce0ec9f00ceae9885e .\" Author: Michal Sekletar <msekleta@redhat.com> .\" -.TH socket 7 2024-01-16 "Linux man-pages 6.06" +.TH socket 7 2024-01-16 "Linux man-pages 6.7" .SH NAME socket \- Linux socket interface .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/spufs.7 b/upstream/fedora-rawhide/man7/spufs.7 index 71919f94..3e8c2ed8 100644 --- a/upstream/fedora-rawhide/man7/spufs.7 +++ b/upstream/fedora-rawhide/man7/spufs.7 @@ -10,7 +10,7 @@ .\" 2007-07-10, quite a lot of polishing by mtk .\" 2007-09-28, updates for newer kernels by Jeremy Kerr <jk@ozlabs.org> .\" -.TH spufs 7 2023-10-31 "Linux man-pages 6.06" +.TH spufs 7 2023-10-31 "Linux man-pages 6.7" .SH NAME spufs \- SPU filesystem .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/standards.7 b/upstream/fedora-rawhide/man7/standards.7 index 913d4b9c..a058b92d 100644 --- a/upstream/fedora-rawhide/man7/standards.7 +++ b/upstream/fedora-rawhide/man7/standards.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH standards 7 2023-10-31 "Linux man-pages 6.06" +.TH standards 7 2023-10-31 "Linux man-pages 6.7" .SH NAME standards \- C and UNIX Standards .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/string_copying.7 b/upstream/fedora-rawhide/man7/string_copying.7 index b79739f1..43bc00da 100644 --- a/upstream/fedora-rawhide/man7/string_copying.7 +++ b/upstream/fedora-rawhide/man7/string_copying.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: BSD-3-Clause .\" -.TH string_copying 7 2023-12-17 "Linux man-pages 6.06" +.TH string_copying 7 2023-12-17 "Linux man-pages 6.7" .\" ----- NAME :: -----------------------------------------------------/ .SH NAME stpcpy, diff --git a/upstream/fedora-rawhide/man7/suffixes.7 b/upstream/fedora-rawhide/man7/suffixes.7 index 2fb86053..3352a9cc 100644 --- a/upstream/fedora-rawhide/man7/suffixes.7 +++ b/upstream/fedora-rawhide/man7/suffixes.7 @@ -14,7 +14,7 @@ .\" Modified Thu Nov 16 23:28:25 2000 by David A. Wheeler .\" <dwheeler@dwheeler.com> .\" -.TH SUFFIXES 7 2023-10-31 "Linux man-pages 6.06" +.TH SUFFIXES 7 2023-10-31 "Linux man-pages 6.7" .SH NAME suffixes \- list of file suffixes .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/symlink.7 b/upstream/fedora-rawhide/man7/symlink.7 index c913dfa2..737bb1f2 100644 --- a/upstream/fedora-rawhide/man7/symlink.7 +++ b/upstream/fedora-rawhide/man7/symlink.7 @@ -10,7 +10,7 @@ .\" 2008-06-11, mtk, Taken from FreeBSD 6.2 and heavily edited for .\" specific Linux details, improved readability, and man-pages style. .\" -.TH symlink 7 2023-10-31 "Linux man-pages 6.06" +.TH symlink 7 2023-10-31 "Linux man-pages 6.7" .SH NAME symlink \- symbolic link handling .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/system_data_types.7 b/upstream/fedora-rawhide/man7/system_data_types.7 index da0e10e9..f79b65dc 100644 --- a/upstream/fedora-rawhide/man7/system_data_types.7 +++ b/upstream/fedora-rawhide/man7/system_data_types.7 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH system_data_types 7 2023-10-31 "Linux man-pages 6.06" +.TH system_data_types 7 2023-10-31 "Linux man-pages 6.7" .SH NAME system_data_types \- overview of system data types .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/systemd-stub.7 b/upstream/fedora-rawhide/man7/systemd-stub.7 index 0a1f9b0b..be784019 100644 --- a/upstream/fedora-rawhide/man7/systemd-stub.7 +++ b/upstream/fedora-rawhide/man7/systemd-stub.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-STUB" "7" "" "systemd 255" "systemd-stub" +.TH "SYSTEMD\-STUB" "7" "" "systemd 256~rc3" "systemd-stub" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,21 +23,36 @@ systemd-stub, sd-stub, linuxx64.efi.stub, linuxia32.efi.stub, linuxaa64.efi.stub \- A simple UEFI kernel boot stub .SH "SYNOPSIS" .PP +.RS 4 /usr/lib/systemd/boot/efi/linuxx64\&.efi\&.stub -.PP +.RE +.RS 4 /usr/lib/systemd/boot/efi/linuxia32\&.efi\&.stub -.PP +.RE +.RS 4 /usr/lib/systemd/boot/efi/linuxaa64\&.efi\&.stub -.PP +.RE +.RS 4 \fIESP\fR/\&.\&.\&./\fIfoo\fR\&.efi\&.extra\&.d/*\&.addon\&.efi -.PP +.RE +.RS 4 \fIESP\fR/\&.\&.\&./\fIfoo\fR\&.efi\&.extra\&.d/*\&.cred -.PP +.RE +.RS 4 \fIESP\fR/\&.\&.\&./\fIfoo\fR\&.efi\&.extra\&.d/*\&.raw -.PP +.RE +.RS 4 +\fIESP\fR/\&.\&.\&./\fIfoo\fR\&.efi\&.extra\&.d/*\&.sysext\&.raw +.RE +.RS 4 +\fIESP\fR/\&.\&.\&./\fIfoo\fR\&.efi\&.extra\&.d/*\&.confext\&.raw +.RE +.RS 4 \fIESP\fR/loader/addons/*\&.addon\&.efi -.PP +.RE +.RS 4 \fIESP\fR/loader/credentials/*\&.cred +.RE .SH "DESCRIPTION" .PP \fBsystemd\-stub\fR @@ -112,6 +127,19 @@ section with the initrd\&. .IP \(bu 2.3 .\} A +"\&.ucode" +section with an initrd containing microcode, to be handed to the kernel before any other initrd\&. This initrd must not be compressed\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +A "\&.splash" section with an image (in the Windows \&.BMP @@ -186,7 +214,7 @@ section with a set of cryptographic signatures for the expected TPM2 PCR values .\} A "\&.pcrpkey" -section with a public key in the PEM format matching the signature data in the the +section with a public key in the PEM format matching the signature data in the "\&.pcrsig" section\&. .RE @@ -277,7 +305,7 @@ archive is measured into TPM PCR 12 (if a TPM is present)\&. .IP \(bu 2.3 .\} Similarly, files -\fIfoo\fR\&.efi\&.extra\&.d/*\&.raw +\fIfoo\fR\&.efi\&.extra\&.d/*\&.sysext\&.raw are packed up in a \fBcpio\fR archive and placed in the @@ -298,12 +326,33 @@ archive containing these system extension images is measured into TPM PCR 13 (if .IP \(bu 2.3 .\} Similarly, files +\fIfoo\fR\&.efi\&.extra\&.d/*\&.confext\&.raw +are packed up in a +\fBcpio\fR +archive and placed in the +/\&.extra/confext/ +directory in the initrd file hierarchy\&. This is supposed to be used to pass additional configuration extension images to the initrd\&. See +\fBsystemd-confext\fR(8) +for details on configuration extension images\&. The generated +\fBcpio\fR +archive containing these system extension images is measured into TPM PCR 12 (if a TPM is present)\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Similarly, files \fIfoo\fR\&.efi\&.extra\&.d/*\&.addon\&.efi are loaded and verified as PE binaries, and a "\&.cmdline" section is parsed from them\&. Addons are supposed to be used to pass additional kernel command line parameters or Devicetree blobs, regardless of the kernel image being booted, for example to allow platform vendors to ship platform\-specific configuration\&. .sp -In case Secure Boot is enabled, these files will be validated using keys in UEFI DB, Shim\*(Aqs DB or Shim\*(Aqs MOK, and will be rejected otherwise\&. Additionally, if the both the addon and the UKI contain a a +In case Secure Boot is enabled, these files will be validated using keys in UEFI DB, Shim\*(Aqs DB or Shim\*(Aqs MOK, and will be rejected otherwise\&. Additionally, if both the addon and the UKI contain a "\&.uname" section, the addon will be rejected if they do not match exactly\&. It is recommended to always add a "\&.sbat" @@ -363,7 +412,7 @@ Note that when a unified kernel using \fBsystemd\-stub\fR is invoked the firmware will measure it as a whole to TPM PCR 4, covering all embedded resources, such as the stub code itself, the core kernel, the embedded initrd and kernel command line (see above for a full list)\&. .PP -Also note that the Linux kernel will measure all initrds it receives into TPM PCR 9\&. This means every type of initrd will be measured two or three times: the initrd embedded in the kernel image will be measured to PCR 4, PCR 9 and PCR 11; the initrd synthesized from credentials will be measured to both PCR 9 and PCR 12; the initrd synthesized from system extensions will be measured to both PCR 4 and PCR 9\&. Let\*(Aqs summarize the OS resources and the PCRs they are measured to: +Also note that the Linux kernel will measure all initrds it receives into TPM PCR 9\&. This means every type of initrd will be measured two or three times: the initrds embedded in the kernel image will be measured to PCR 4, PCR 9 and PCR 11; the initrd synthesized from credentials (and the one synthesized from configuration extensions) will be measured to both PCR 9 and PCR 12; the initrd synthesized from system extensions will be measured to both PCR 4 and PCR 9\&. Let\*(Aqs summarize the OS resources and the PCRs they are measured to: .sp .it 1 an-trap .nr an-no-space-flag 1 @@ -389,6 +438,8 @@ l l l l l l l l +l l +l l l l. T{ \fBsystemd\-stub\fR code (the entry point of the unified PE binary) @@ -411,6 +462,11 @@ T}:T{ 4 + 9 + 11 T} T{ +Microcode initrd (embedded in unified PE binary) +T}:T{ +4 + 9 + 11 +T} +T{ Default kernel command line (embedded in unified PE binary) T}:T{ 4 + 11 @@ -445,6 +501,11 @@ System Extensions (synthesized initrd from companion files) T}:T{ 9 + 13 T} +T{ +Configuration Extensions (synthesized initrd from companion files) +T}:T{ +9 + 12 +T} .TE .sp 1 .SH "EFI VARIABLES" @@ -507,12 +568,20 @@ Added in version 252\&. .PP \fIStubPcrInitRDSysExts\fR .RS 4 -The PCR register index the systemd extensions for the initrd, which are picked up from the file system the kernel image is located on\&. Formatted as decimal ASCII string (e\&.g\&. +The PCR register index the system extensions for the initrd, which are picked up from the file system the kernel image is located on\&. Formatted as decimal ASCII string (e\&.g\&. "13")\&. This variable is set if a measurement was successfully completed, and remains unset otherwise\&. .sp Added in version 252\&. .RE .PP +\fIStubPcrInitRDConfExts\fR +.RS 4 +The PCR register index the configuration extensions for the initrd, which are picked up from the file system the kernel image is located on\&. Formatted as decimal ASCII string (e\&.g\&. +"12")\&. This variable is set if a measurement was successfully completed, and remains unset otherwise\&. +.sp +Added in version 255\&. +.RE +.PP Note that some of the variables above may also be set by the boot loader\&. The stub will only set them if they aren\*(Aqt set already\&. Some of these variables are defined by the \m[blue]\fBBoot Loader Interface\fR\m[]\&\s-2\u[4]\d\s+2\&. .SH "INITRD RESOURCES" @@ -549,16 +618,26 @@ directory in the initrd execution environment\&. Added in version 252\&. .RE .PP -/\&.extra/sysext/*\&.raw +/\&.extra/sysext/*\&.sysext\&.raw .RS 4 System extension image files (suffix -"\&.raw") that are placed next to the unified kernel image (as described above) are copied into the +"\&.sysext\&.raw") that are placed next to the unified kernel image (as described above) are copied into the /\&.extra/sysext/ directory in the initrd execution environment\&. .sp Added in version 252\&. .RE .PP +/\&.extra/confext/*\&.confext\&.raw +.RS 4 +Configuration extension image files (suffix +"\&.confext\&.raw") that are placed next to the unified kernel image (as described above) are copied into the +/\&.extra/confext/ +directory in the initrd execution environment\&. +.sp +Added in version 255\&. +.RE +.PP /\&.extra/tpm2\-pcr\-signature\&.json .RS 4 The TPM2 PCR signature JSON object included in the @@ -590,7 +669,9 @@ line\&. By default, this is done for the TPM2 PCR signature and public key files .PP \fBsystemd\-stub\fR can be configured using SMBIOS Type 11 strings\&. Applicable strings consist of a name, followed by -"=", followed by the value\&. +"=", followed by the value\&. Unless +\fBsystemd\-stub\fR +detects it is running inside a confidential computing environment, \fBsystemd\-stub\fR will search the table for a string with a specific name, and if found, use its value\&. The following strings are read: .PP @@ -606,15 +687,7 @@ In order to assemble a bootable Unified Kernel Image from various components as \fBukify\fR(1)\&. .SH "SEE ALSO" .PP -\fBsystemd-boot\fR(7), -\fBsystemd.exec\fR(5), -\fBsystemd-creds\fR(1), -\fBsystemd-sysext\fR(8), -\m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[5]\d\s+2, -\m[blue]\fBBoot Loader Interface\fR\m[]\&\s-2\u[4]\d\s+2, -\fBukify\fR(1), -\fBsystemd-measure\fR(1), -\m[blue]\fBTPM2 PCR Measurements Made by systemd\fR\m[]\&\s-2\u[6]\d\s+2 +\fBsystemd-boot\fR(7), \fBsystemd.exec\fR(5), \fBsystemd-creds\fR(1), \fBsystemd-sysext\fR(8), \m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[5]\d\s+2, \m[blue]\fBBoot Loader Interface\fR\m[]\&\s-2\u[4]\d\s+2, \fBukify\fR(1), \fBsystemd-measure\fR(1), \m[blue]\fBTPM2 PCR Measurements Made by systemd\fR\m[]\&\s-2\u[6]\d\s+2 .SH "NOTES" .IP " 1." 4 SBAT diff --git a/upstream/fedora-rawhide/man7/systemd.directives.7 b/upstream/fedora-rawhide/man7/systemd.directives.7 index c6b2d21c..28466c19 100644 --- a/upstream/fedora-rawhide/man7/systemd.directives.7 +++ b/upstream/fedora-rawhide/man7/systemd.directives.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.DIRECTIVES" "7" "" "systemd 255" "systemd.directives" +.TH "SYSTEMD\&.DIRECTIVES" "7" "" "systemd 256~rc3" "systemd.directives" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -1201,6 +1201,11 @@ Directives for configuring units, used in unit files\&. \fBsystemd.resource-control\fR(5) .RE .PP +\fIMemoryZSwapWriteback=\fR +.RS 4 +\fBsystemd.resource-control\fR(5) +.RE +.PP \fIMessageQueueMaxMessages=\fR .RS 4 \fBsystemd.socket\fR(5) @@ -1388,6 +1393,11 @@ Directives for configuring units, used in unit files\&. \fBsystemd.exec\fR(5) .RE .PP +\fIPassFileDescriptorsToExec=\fR +.RS 4 +\fBsystemd.socket\fR(5) +.RE +.PP \fIPassPacketInfo=\fR .RS 4 \fBsystemd.socket\fR(5) @@ -2263,6 +2273,11 @@ Directives for configuring units, used in unit files\&. \fBsystemd.unit\fR(5) .RE .PP +\fIWantsMountsFor=\fR +.RS 4 +\fBsystemd.unit\fR(5) +.RE +.PP \fIWatchdogSec=\fR .RS 4 \fBsystemd.service\fR(5) @@ -2393,6 +2408,7 @@ Kernel boot options for configuring the behaviour of the systemd process\&. .PP \fIifname=\fR .RS 4 +\fBkernel-command-line\fR(7), \fBsystemd-network-generator.service\fR(8) .RE .PP @@ -2557,8 +2573,9 @@ Kernel boot options for configuring the behaviour of the systemd process\&. \fBsystemd-resolved.service\fR(8) .RE .PP -\fInet\&.ifname\-policy=\fR +\fInet\&.ifname_policy=\fR .RS 4 +\fBkernel-command-line\fR(7), \fBsystemd-network-generator.service\fR(8), \fBsystemd-udevd.service\fR(8) .RE @@ -2569,7 +2586,7 @@ Kernel boot options for configuring the behaviour of the systemd process\&. \fBsystemd-udevd.service\fR(8) .RE .PP -\fInet\&.naming\-scheme=\fR +\fInet\&.naming_scheme=\fR .RS 4 \fBkernel-command-line\fR(7), \fBsystemd-udevd.service\fR(8) @@ -2765,6 +2782,7 @@ Kernel boot options for configuring the behaviour of the systemd process\&. .PP \fIresume_offset=\fR .RS 4 +\fBkernel-command-line\fR(7), \fBsystemd-hibernate-resume-generator\fR(8) .RE .PP @@ -2826,22 +2844,28 @@ Kernel boot options for configuring the behaviour of the systemd process\&. \fBsystemd\fR(1) .RE .PP -\fIsystemd\&.battery\-check=\fR +\fIsystemd\&.allow_userspace_verity=\fR .RS 4 +\fBkernel-command-line\fR(7) +.RE +.PP +\fIsystemd\&.battery_check=\fR +.RS 4 +\fBkernel-command-line\fR(7), \fBsystemd-battery-check.service\fR(8) .RE .PP -\fIsystemd\&.clock\-usec=\fR +\fIsystemd\&.clock_usec=\fR .RS 4 \fBkernel-command-line\fR(7) .RE .PP -\fIsystemd\&.condition\-first\-boot=\fR +\fIsystemd\&.condition_first_boot=\fR .RS 4 \fBkernel-command-line\fR(7) .RE .PP -\fIsystemd\&.condition\-needs\-update=\fR +\fIsystemd\&.condition_needs_update=\fR .RS 4 \fBkernel-command-line\fR(7) .RE @@ -2857,13 +2881,13 @@ Kernel boot options for configuring the behaviour of the systemd process\&. \fBkernel-command-line\fR(7) .RE .PP -\fIsystemd\&.crash_chvt\fR +\fIsystemd\&.crash_action=\fR .RS 4 \fBkernel-command-line\fR(7), \fBsystemd\fR(1) .RE .PP -\fIsystemd\&.crash_reboot\fR +\fIsystemd\&.crash_chvt\fR .RS 4 \fBkernel-command-line\fR(7), \fBsystemd\fR(1) @@ -2880,6 +2904,11 @@ Kernel boot options for configuring the behaviour of the systemd process\&. \fBkernel-command-line\fR(7) .RE .PP +\fIsystemd\&.default_debug_tty=\fR +.RS 4 +\fBkernel-command-line\fR(7) +.RE +.PP \fIsystemd\&.default_device_timeout_sec=\fR .RS 4 \fBkernel-command-line\fR(7) @@ -2915,6 +2944,7 @@ Kernel boot options for configuring the behaviour of the systemd process\&. .PP \fIsystemd\&.firstboot=\fR .RS 4 +\fBhomectl\fR(1), \fBkernel-command-line\fR(7), \fBsystemd-firstboot\fR(1) .RE @@ -2976,6 +3006,36 @@ Kernel boot options for configuring the behaviour of the systemd process\&. \fBsystemd-journald.service\fR(8) .RE .PP +\fIsystemd\&.journald\&.max_level_console=\fR +.RS 4 +\fBsystemd-journald.service\fR(8) +.RE +.PP +\fIsystemd\&.journald\&.max_level_kmsg=\fR +.RS 4 +\fBsystemd-journald.service\fR(8) +.RE +.PP +\fIsystemd\&.journald\&.max_level_socket=\fR +.RS 4 +\fBsystemd-journald.service\fR(8) +.RE +.PP +\fIsystemd\&.journald\&.max_level_store=\fR +.RS 4 +\fBsystemd-journald.service\fR(8) +.RE +.PP +\fIsystemd\&.journald\&.max_level_syslog=\fR +.RS 4 +\fBsystemd-journald.service\fR(8) +.RE +.PP +\fIsystemd\&.journald\&.max_level_wall=\fR +.RS 4 +\fBsystemd-journald.service\fR(8) +.RE +.PP \fIsystemd\&.log_color\fR .RS 4 \fBkernel-command-line\fR(7), @@ -3036,7 +3096,7 @@ Kernel boot options for configuring the behaviour of the systemd process\&. \fBsystemd-fstab-generator\fR(8) .RE .PP -\fIsystemd\&.random\-seed=\fR +\fIsystemd\&.random_seed=\fR .RS 4 \fBkernel-command-line\fR(7) .RE @@ -3107,6 +3167,18 @@ Kernel boot options for configuring the behaviour of the systemd process\&. \fBsystemd\fR(1) .RE .PP +\fIsystemd\&.ssh_auto=\fR +.RS 4 +\fBkernel-command-line\fR(7), +\fBsystemd-ssh-generator\fR(8) +.RE +.PP +\fIsystemd\&.ssh_listen=\fR +.RS 4 +\fBkernel-command-line\fR(7), +\fBsystemd-ssh-generator\fR(8) +.RE +.PP \fIsystemd\&.status_unit_format=\fR .RS 4 \fBkernel-command-line\fR(7), @@ -3124,6 +3196,11 @@ Kernel boot options for configuring the behaviour of the systemd process\&. \fBsystemd-gpt-auto-generator\fR(8) .RE .PP +\fIsystemd\&.tpm2_wait=\fR +.RS 4 +\fBkernel-command-line\fR(7) +.RE +.PP \fIsystemd\&.tty\&.columns\&.\fR\fI\fItty\fR\fR\fI=\fR .RS 4 \fBkernel-command-line\fR(7) @@ -3308,6 +3385,11 @@ Kernel boot options for configuring the behaviour of the systemd process\&. .PP Data passed from VMM to system via SMBIOS Type 11\&. .PP +\fIio\&.systemd\&.boot\&.kernel\-cmdline\-extra=\fR +.RS 4 +\fBsmbios-type-11\fR(7) +.RE +.PP \fIio\&.systemd\&.credential\&.binary:\fR .RS 4 \fBsmbios-type-11\fR(7) @@ -3537,6 +3619,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_COLORS\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -3611,6 +3694,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_LESS\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -3630,6 +3714,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_LESSCHARSET\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -3649,6 +3734,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_LOG_COLOR\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -3669,6 +3755,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_LOG_LEVEL\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -3689,6 +3776,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_LOG_LOCATION\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -3709,6 +3797,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_LOG_RATELIMIT_KMSG\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -3726,6 +3815,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_LOG_TARGET\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -3746,6 +3836,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_LOG_TID\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -3763,6 +3854,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_LOG_TIME\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -3813,6 +3905,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_PAGER\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -3832,6 +3925,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_PAGERSECURE\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -3866,6 +3960,7 @@ Environment variables understood by the systemd manager and other programs and e \fI$SYSTEMD_URLIFY\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -4203,6 +4298,66 @@ Environment variables understood by the systemd manager and other programs and e .PP System credentials understood by the system and service manager and various other components: .PP +\fIcryptenroll\&.fido2\-pin\fR +.RS 4 +\fBsystemd-cryptenroll\fR(1) +.RE +.PP +\fIcryptenroll\&.new\-passphrase\fR +.RS 4 +\fBsystemd-cryptenroll\fR(1) +.RE +.PP +\fIcryptenroll\&.new\-tpm2\-pin\fR +.RS 4 +\fBsystemd-cryptenroll\fR(1) +.RE +.PP +\fIcryptenroll\&.passphrase\fR +.RS 4 +\fBsystemd-cryptenroll\fR(1) +.RE +.PP +\fIcryptenroll\&.pkcs11\-pin\fR +.RS 4 +\fBsystemd-cryptenroll\fR(1) +.RE +.PP +\fIcryptenroll\&.tpm2\-pin\fR +.RS 4 +\fBsystemd-cryptenroll\fR(1) +.RE +.PP +\fIcryptsetup\&.fido2\-pin\fR +.RS 4 +\fBsystemd-cryptsetup\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP +\fIcryptsetup\&.luks2\-pin\fR +.RS 4 +\fBsystemd-cryptsetup\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP +\fIcryptsetup\&.passphrase\fR +.RS 4 +\fBsystemd-cryptsetup\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP +\fIcryptsetup\&.pkcs11\-pin\fR +.RS 4 +\fBsystemd-cryptsetup\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP +\fIcryptsetup\&.tpm2\-pin\fR +.RS 4 +\fBsystemd-cryptsetup\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP \fIfirstboot\&.keymap\fR .RS 4 \fBsystemd-firstboot\fR(1), @@ -4245,6 +4400,24 @@ System credentials understood by the system and service manager and various othe \fBsystemd.system-credentials\fR(7) .RE .PP +\fIhome\&.create\&.*\fR +.RS 4 +\fBhomectl\fR(1), +\fBsystemd.system-credentials\fR(7) +.RE +.PP +\fIjournal\&.forward_to_socket\fR +.RS 4 +\fBsystemd-journald.service\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP +\fIjournal\&.storage\fR +.RS 4 +\fBsystemd-journald.service\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP \fIlogin\&.issue\fR .RS 4 \fBsystemd.system-credentials\fR(7) @@ -4255,6 +4428,12 @@ System credentials understood by the system and service manager and various othe \fBsystemd.system-credentials\fR(7) .RE .PP +\fInetwork\&.conf\&.*\fR +.RS 4 +\fBsystemd-network-generator.service\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP \fInetwork\&.dns\fR .RS 4 \fBsystemd-resolved.service\fR(8), @@ -4266,12 +4445,35 @@ System credentials understood by the system and service manager and various othe \fBsystemd.system-credentials\fR(7) .RE .PP +\fInetwork\&.link\&.*\fR +.RS 4 +\fBsystemd-network-generator.service\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP +\fInetwork\&.netdev\&.*\fR +.RS 4 +\fBsystemd-network-generator.service\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP +\fInetwork\&.network\&.*\fR +.RS 4 +\fBsystemd-network-generator.service\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP \fInetwork\&.search_domains\fR .RS 4 \fBsystemd-resolved.service\fR(8), \fBsystemd.system-credentials\fR(7) .RE .PP +\fInetwork\&.wireguard\&.*\fR +.RS 4 +\fBsystemd.system-credentials\fR(7) +.RE +.PP \fIpasswd\&.hashed\-password\&.\fR\fI\fIuser\fR\fR .RS 4 \fBsystemd-sysusers\fR(8) @@ -4310,18 +4512,41 @@ System credentials understood by the system and service manager and various othe \fBsystemd.system-credentials\fR(7) .RE .PP +\fIssh\&.listen\fR +.RS 4 +\fBsystemd-ssh-generator\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP \fIsysctl\&.extra\fR .RS 4 \fBsystemd-sysctl.service\fR(8), \fBsystemd.system-credentials\fR(7) .RE .PP +\fIsystem\&.hostname\fR +.RS 4 +\fBsystemd.system-credentials\fR(7) +.RE +.PP \fIsystem\&.machine_id\fR .RS 4 \fBsystemd\fR(1), \fBsystemd.system-credentials\fR(7) .RE .PP +\fIsystemd\&.extra\-unit\&.*\fR +.RS 4 +\fBsystemd-debug-generator\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP +\fIsystemd\&.unit\-dropin\&.*\fR +.RS 4 +\fBsystemd-debug-generator\fR(8), +\fBsystemd.system-credentials\fR(7) +.RE +.PP \fIsysusers\&.extra\fR .RS 4 \fBsystemd-sysusers\fR(8), @@ -4334,6 +4559,16 @@ System credentials understood by the system and service manager and various othe \fBsystemd.system-credentials\fR(7) .RE .PP +\fIudev\&.conf\&.*\fR +.RS 4 +\fBsystemd.system-credentials\fR(7) +.RE +.PP +\fIudev\&.rules\&.*\fR +.RS 4 +\fBsystemd.system-credentials\fR(7) +.RE +.PP \fIvconsole\&.font\fR .RS 4 \fBsystemd-vconsole-setup.service\fR(8), @@ -4479,6 +4714,11 @@ and other programs\&. \fBsystemd-stub\fR(7) .RE .PP +\fIStubPcrInitRDConfExts\fR +.RS 4 +\fBsystemd-stub\fR(7) +.RE +.PP \fIStubPcrInitRDSysExts\fR .RS 4 \fBsystemd-stub\fR(7) @@ -4924,6 +5164,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.netdev\fR(5) .RE .PP +\fIARPMissedMax=\fR +.RS 4 +\fBsystemd.netdev\fR(5) +.RE +.PP \fIARPValidate=\fR .RS 4 \fBsystemd.netdev\fR(5) @@ -5181,6 +5426,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.netdev\fR(5) .RE .PP +\fIBroadcastQueueThreshold=\fR +.RS 4 +\fBsystemd.netdev\fR(5) +.RE +.PP \fIBuckets=\fR .RS 4 \fBsystemd.network\fR(5) @@ -5899,11 +6149,6 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.netdev\fR(5) .RE .PP -\fIIPForward=\fR -.RS 4 -\fBsystemd.network\fR(5) -.RE -.PP \fIIPMasquerade=\fR .RS 4 \fBsystemd.network\fR(5) @@ -5939,6 +6184,12 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.network\fR(5) .RE .PP +\fIIPv4Forwarding=\fR +.RS 4 +\fBnetworkd.conf\fR(5), +\fBsystemd.network\fR(5) +.RE +.PP \fIIPv4LLRoute=\fR .RS 4 \fBsystemd.network\fR(5) @@ -5954,6 +6205,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.network\fR(5) .RE .PP +\fIIPv4ProxyARPPrivateVLAN=\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP \fIIPv4ReversePathFilter=\fR .RS 4 \fBsystemd.network\fR(5) @@ -5979,6 +6235,12 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.netdev\fR(5) .RE .PP +\fIIPv6Forwarding=\fR +.RS 4 +\fBnetworkd.conf\fR(5), +\fBsystemd.network\fR(5) +.RE +.PP \fIIPv6HopLimit=\fR .RS 4 \fBsystemd.network\fR(5) @@ -6030,6 +6292,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.netdev\fR(5) .RE .PP +\fIIPv6RetransmissionTimeSec=\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP \fIIPv6SendRA=\fR .RS 4 \fBsystemd.network\fR(5) @@ -6067,6 +6334,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.network\fR(5) .RE .PP +\fIImportProperty=\fR +.RS 4 +\fBsystemd.link\fR(5) +.RE +.PP \fIIncomingInterface=\fR .RS 4 \fBsystemd.network\fR(5) @@ -6183,6 +6455,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.netdev\fR(5) .RE .PP +\fIL3MasterDevice=\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP \fIL3MissNotification=\fR .RS 4 \fBsystemd.netdev\fR(5) @@ -6366,6 +6643,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.netdev\fR(5) .RE .PP +\fIManageForeignNextHops=\fR +.RS 4 +\fBnetworkd.conf\fR(5) +.RE +.PP \fIManageForeignRoutes=\fR .RS 4 \fBnetworkd.conf\fR(5) @@ -6654,6 +6936,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.network\fR(5) .RE .PP +\fIPeerNotifyDelaySec=\fR +.RS 4 +\fBsystemd.netdev\fR(5) +.RE +.PP \fIPeerPort=\fR .RS 4 \fBsystemd.netdev\fR(5) @@ -6675,6 +6962,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.network\fR(5) .RE .PP +\fIPersistLeases=\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP \fIPersistentKeepalive=\fR .RS 4 \fBsystemd.netdev\fR(5) @@ -6898,6 +7190,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.network\fR(5) .RE .PP +\fIReachableTimeSec=\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP \fIReadEtcHosts=\fR .RS 4 \fBresolved.conf\fR(5) @@ -6908,6 +7205,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.link\fR(5) .RE .PP +\fIReceivePacketSteeringCPUMask=\fR +.RS 4 +\fBsystemd.link\fR(5) +.RE +.PP \fIReceiveQueues=\fR .RS 4 \fBsystemd.link\fR(5) @@ -7231,6 +7533,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.network\fR(5) .RE .PP +\fIServerPort=\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP \fISessionId=\fR .RS 4 \fBsystemd.netdev\fR(5) @@ -7281,6 +7588,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.network\fR(5) .RE .PP +\fISubType=\fR +.RS 4 +\fBsystemd.dnssd\fR(5) +.RE +.PP \fISubnetId=\fR .RS 4 \fBsystemd.network\fR(5) @@ -7336,11 +7648,6 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.netdev\fR(5) .RE .PP -\fITTLPropagate=\fR -.RS 4 -\fBsystemd.network\fR(5) -.RE -.PP \fITable=\fR .RS 4 \fBsystemd.netdev\fR(5), @@ -7541,6 +7848,11 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.network\fR(5) .RE .PP +\fIUnsetProperty=\fR +.RS 4 +\fBsystemd.link\fR(5) +.RE +.PP \fIUpDelaySec=\fR .RS 4 \fBsystemd.netdev\fR(5) @@ -7598,6 +7910,7 @@ Directives for configuring network links through the net\-setup\-link udev built .PP \fIUseDomains=\fR .RS 4 +\fBnetworkd.conf\fR(5), \fBsystemd.network\fR(5) .RE .PP @@ -7621,11 +7934,6 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.network\fR(5) .RE .PP -\fIUseICMP6RateLimit=\fR -.RS 4 -\fBsystemd.network\fR(5) -.RE -.PP \fIUseMTU=\fR .RS 4 \fBsystemd.network\fR(5) @@ -7651,6 +7959,21 @@ Directives for configuring network links through the net\-setup\-link udev built \fBsystemd.network\fR(5) .RE .PP +\fIUseReachableTime=\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP +\fIUseRedirect=\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP +\fIUseRetransmissionTime=\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP \fIUseRoutePrefix=\fR .RS 4 \fBsystemd.network\fR(5) @@ -8056,6 +8379,11 @@ Fields in the journal events with a well known meaning\&. \fBsystemd.journal-fields\fR(7) .RE .PP +\fIOBJECT_SYSTEMD_INVOCATION_ID=\fR +.RS 4 +\fBsystemd.journal-fields\fR(7) +.RE +.PP \fIOBJECT_SYSTEMD_OWNER_UID=\fR .RS 4 \fBsystemd.journal-fields\fR(7) @@ -8528,6 +8856,11 @@ Options which influence mounted filesystems and encrypted volumes\&. \fBcrypttab\fR(5) .RE .PP +\fBlink\-volume\-key=\fR +.RS 4 +\fBcrypttab\fR(5) +.RE +.PP \fBluks\fR .RS 4 \fBcrypttab\fR(5) @@ -8832,6 +9165,11 @@ Options which influence mounted filesystems and encrypted volumes\&. .RS 4 \fBsystemd.mount\fR(5) .RE +.PP +\fBx\-systemd\&.wants\-mounts\-for=\fR +.RS 4 +\fBsystemd.mount\fR(5) +.RE .SH "SYSTEMD.NSPAWN(5) DIRECTIVES" .PP Directives for configuring systemd\-nspawn containers\&. @@ -9180,12 +9518,12 @@ Directives for configuring the behaviour of the systemd process and other tools \fBjournald.conf\fR(5) .RE .PP -\fICrashChangeVT=\fR +\fICrashAction=\fR .RS 4 \fBsystemd-system.conf\fR(5) .RE .PP -\fICrashReboot=\fR +\fICrashChangeVT=\fR .RS 4 \fBsystemd-system.conf\fR(5) .RE @@ -9420,6 +9758,11 @@ Directives for configuring the behaviour of the systemd process and other tools \fBjournald.conf\fR(5) .RE .PP +\fIForwardToSocket=\fR +.RS 4 +\fBjournald.conf\fR(5) +.RE +.PP \fIForwardToSyslog=\fR .RS 4 \fBjournald.conf\fR(5) @@ -9621,6 +9964,11 @@ Directives for configuring the behaviour of the systemd process and other tools \fBjournald.conf\fR(5) .RE .PP +\fIMaxLevelSocket=\fR +.RS 4 +\fBjournald.conf\fR(5) +.RE +.PP \fIMaxLevelStore=\fR .RS 4 \fBjournald.conf\fR(5) @@ -9647,6 +9995,11 @@ Directives for configuring the behaviour of the systemd process and other tools \fBjournal-remote.conf\fR(5) .RE .PP +\fIMemorySleepMode=\fR +.RS 4 +\fBsystemd-sleep.conf\fR(5) +.RE +.PP \fINAutoVTs=\fR .RS 4 \fBlogind.conf\fR(5) @@ -9682,6 +10035,11 @@ Directives for configuring the behaviour of the systemd process and other tools \fBcoredump.conf\fR(5) .RE .PP +\fIProtectSystem=\fR +.RS 4 +\fBsystemd-system.conf\fR(5) +.RE +.PP \fIRateLimitBurst=\fR .RS 4 \fBjournald.conf\fR(5) @@ -9800,6 +10158,11 @@ Directives for configuring the behaviour of the systemd process and other tools \fBsystemd-system.conf\fR(5) .RE .PP +\fISleepOperation=\fR +.RS 4 +\fBlogind.conf\fR(5) +.RE +.PP \fISplitMode=\fR .RS 4 \fBjournal-remote.conf\fR(5), @@ -10022,6 +10385,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBbusctl\fR(1) .RE .PP +\fB\-\-allow\-null\fR +.RS 4 +\fBsystemd-creds\fR(1) +.RE +.PP \fB\-\-ambient\-capability\fR .RS 4 \fBsystemd-nspawn\fR(1) @@ -10107,6 +10475,19 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-mount\fR(1) .RE .PP +\fB\-\-avatar\fR +.RS 4 +\fBhomectl\fR(1) +.RE +.PP +\fB\-\-background\fR +.RS 4 +\fBrun0\fR(1), +\fBsystemd-nspawn\fR(1), +\fBsystemd-run\fR(1), +\fBsystemd-vmspawn\fR(1) +.RE +.PP \fB\-\-backing\fR .RS 4 \fBudevadm\fR(8) @@ -10123,6 +10504,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-analyze\fR(1) .RE .PP +\fB\-\-basename\fR +.RS 4 +\fBsystemd-vpick\fR(1) +.RE +.PP \fB\-\-batch\fR .RS 4 \fBsystemd-cgtop\fR(1) @@ -10135,7 +10521,8 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-bind\fR .RS 4 -\fBsystemd-nspawn\fR(1) +\fBsystemd-nspawn\fR(1), +\fBsystemd-vmspawn\fR(1) .RE .PP \fB\-\-bind\-device\fR @@ -10145,7 +10532,8 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-bind\-ro\fR .RS 4 -\fBsystemd-nspawn\fR(1) +\fBsystemd-nspawn\fR(1), +\fBsystemd-vmspawn\fR(1) .RE .PP \fB\-\-bind\-user\fR @@ -10153,6 +10541,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-nspawn\fR(1) .RE .PP +\fB\-\-blob\fR +.RS 4 +\fBhomectl\fR(1) +.RE +.PP \fB\-\-boot\fR\fB[=[\fIID\fR][\fI\(+-offset\fR]|\fBall\fR]\fR .RS 4 \fBjournalctl\fR(1), @@ -10211,6 +10604,13 @@ Command\-line options accepted by programs in the systemd suite\&. \fBhomectl\fR(1) .RE .PP +\fB\-\-capsule\fR +.RS 4 +\fBbusctl\fR(1), +\fBsystemctl\fR(1), +\fBsystemd-run\fR(1) +.RE +.PP \fB\-\-case\-sensitive\fR\fB[=BOOLEAN]\fR .RS 4 \fBjournalctl\fR(1) @@ -10243,6 +10643,7 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-certificate\fR .RS 4 +\fBsystemd-measure\fR(1), \fBsystemd-repart\fR(8) .RE .PP @@ -10258,6 +10659,7 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-chdir\fR .RS 4 +\fBrun0\fR(1), \fBsystemd-nspawn\fR(1) .RE .PP @@ -10299,11 +10701,13 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-class\fR .RS 4 +\fBimportctl\fR(1), \fBresolvectl\fR(1) .RE .PP \fB\-\-clean\fR .RS 4 +\fBportablectl\fR(1), \fBsystemd-tmpfiles\fR(8) .RE .PP @@ -10326,7 +10730,8 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-\-collect\fR .RS 4 \fBsystemd-mount\fR(1), -\fBsystemd-run\fR(1) +\fBsystemd-run\fR(1), +\fBvarlinkctl\fR(1) .RE .PP \fB\-\-commit\fR @@ -10367,7 +10772,8 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-\-console\fR .RS 4 \fBsystemd-nspawn\fR(1), -\fBsystemd-tty-ask-password-agent\fR(1) +\fBsystemd-tty-ask-password-agent\fR(1), +\fBsystemd-vmspawn\fR(1) .RE .PP \fB\-\-container\fR @@ -10442,7 +10848,12 @@ Command\-line options accepted by programs in the systemd suite\&. \fBhomectl\fR(1) .RE .PP -\fB\-\-crash\-reboot\fR +\fB\-\-cpus\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP +\fB\-\-crash\-action\fR .RS 4 \fBsystemd\fR(1) .RE @@ -10552,6 +10963,7 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-description\fR .RS 4 +\fBrun0\fR(1), \fBsystemd-mount\fR(1), \fBsystemd-run\fR(1) .RE @@ -10592,7 +11004,8 @@ Command\-line options accepted by programs in the systemd suite\&. \fBjournalctl\fR(1), \fBsystemd-journal-gatewayd.service\fR(8), \fBsystemd-journal-upload.service\fR(8), -\fBsystemd-nspawn\fR(1) +\fBsystemd-nspawn\fR(1), +\fBsystemd-vmspawn\fR(1) .RE .PP \fB\-\-disable\-updates\fR @@ -10606,6 +11019,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-repart\fR(8) .RE .PP +\fB\-\-discard\-disk\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP \fB\-\-discover\fR .RS 4 \fBsystemd-dissect\fR(1), @@ -10650,6 +11068,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-oomd.service\fR(8), \fBsystemd-repart\fR(8), \fBsystemd-sysusers\fR(8), +\fBsystemd-tmpfiles\fR(8), \fBudevadm\fR(8) .RE .PP @@ -10721,7 +11140,8 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-\-entry\-token\fR .RS 4 \fBbootctl\fR(1), -\fBkernel-install\fR(8) +\fBkernel-install\fR(8), +\fBsystemd-pcrlock\fR(8) .RE .PP \fB\-\-ephemeral\fR @@ -10740,6 +11160,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-udevd.service\fR(8) .RE .PP +\fB\-\-exclude\-identifier\fR +.RS 4 +\fBjournalctl\fR(1) +.RE +.PP \fB\-\-exclude\-partitions\fR .RS 4 \fBsystemd-repart\fR(8) @@ -10810,6 +11235,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBportablectl\fR(1) .RE .PP +\fB\-\-extra\-drive\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP \fB\-\-facility\fR .RS 4 \fBjournalctl\fR(1) @@ -10895,6 +11325,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-pcrphase.service\fR(8) .RE .PP +\fB\-\-firmware\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP \fB\-\-firmware\-setup\fR .RS 4 \fBsystemctl\fR(1) @@ -10913,6 +11348,7 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-force\fR .RS 4 +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBmachinectl\fR(1), \fBportablectl\fR(1), @@ -10925,7 +11361,12 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-format\fR .RS 4 -\fBmachinectl\fR(1) +\fBimportctl\fR(1) +.RE +.PP +\fB\-\-forward\-journal\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) .RE .PP \fB\-\-from\-pattern\fR @@ -10961,6 +11402,16 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-analyze\fR(1) .RE .PP +\fB\-\-generate\-crypttab\fR +.RS 4 +\fBsystemd-repart\fR(8) +.RE +.PP +\fB\-\-generate\-fstab\fR +.RS 4 +\fBsystemd-repart\fR(8) +.RE +.PP \fB\-\-generators\fR .RS 4 \fBsystemd-analyze\fR(1) @@ -10999,6 +11450,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBjournalctl\fR(1) .RE .PP +\fB\-\-group\fR +.RS 4 +\fBrun0\fR(1) +.RE +.PP \fB\-\-growfs\fR .RS 4 \fBsystemd-dissect\fR(1) @@ -11022,6 +11478,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBcoredumpctl\fR(1), \fBhomectl\fR(1), \fBhostnamectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBkernel-install\fR(8), \fBlocalectl\fR(1), @@ -11032,6 +11489,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBportablectl\fR(1), \fBpoweroff\fR(8), \fBresolvectl\fR(1), +\fBrun0\fR(1), \fBrunlevel\fR(8), \fBshutdown\fR(8), \fBsystemctl\fR(1), @@ -11065,6 +11523,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-networkd-wait-online.service\fR(8), \fBsystemd-notify\fR(1), \fBsystemd-nspawn\fR(1), +\fBsystemd-oomd.service\fR(8), \fBsystemd-path\fR(1), \fBsystemd-pcrlock\fR(8), \fBsystemd-pcrphase.service\fR(8), @@ -11083,6 +11542,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-tty-ask-password-agent\fR(1), \fBsystemd-udevd.service\fR(8), \fBsystemd-vmspawn\fR(1), +\fBsystemd-vpick\fR(1), \fBtelinit\fR(8), \fBtimedatectl\fR(1), \fBudevadm\fR(8), @@ -11101,6 +11561,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBbusctl\fR(1), \fBhomectl\fR(1), \fBhostnamectl\fR(1), +\fBimportctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), \fBmachinectl\fR(1), @@ -11149,6 +11610,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-networkd-wait-online.service\fR(8) .RE .PP +\fB\-\-ignore\-failure\fR +.RS 4 +\fBsystemd-run\fR(1) +.RE +.PP \fB\-\-image\fR .RS 4 \fBbootctl\fR(1), @@ -11228,6 +11694,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-\-initrd\fR .RS 4 \fBsystemd-measure\fR(1), +\fBsystemd-vmspawn\fR(1), \fBukify\fR(1) .RE .PP @@ -11295,12 +11762,15 @@ Command\-line options accepted by programs in the systemd suite\&. \fBcoredumpctl\fR(1), \fBhomectl\fR(1), \fBhostnamectl\fR(1), +\fBimportctl\fR(1), \fBkernel-install\fR(8), +\fBloginctl\fR(1), \fBnetworkctl\fR(1), \fBresolvectl\fR(1), \fBsystemd-analyze\fR(1), \fBsystemd-creds\fR(1), \fBsystemd-dissect\fR(1), +\fBsystemd-id128\fR(1), \fBsystemd-measure\fR(1), \fBsystemd-pcrlock\fR(8), \fBsystemd-repart\fR(8), @@ -11312,6 +11782,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBvarlinkctl\fR(1) .RE .PP +\fB\-\-keep\-download\fR +.RS 4 +\fBimportctl\fR(1) +.RE +.PP \fB\-\-keep\-unit\fR .RS 4 \fBsystemd-nspawn\fR(1) @@ -11371,6 +11846,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemctl\fR(1) .RE .PP +\fB\-\-kvm\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP \fB\-\-language\fR .RS 4 \fBhomectl\fR(1) @@ -11404,6 +11884,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-\-linux\fR .RS 4 \fBsystemd-measure\fR(1), +\fBsystemd-vmspawn\fR(1), \fBukify\fR(1) .RE .PP @@ -11458,6 +11939,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-vmspawn\fR(1) .RE .PP +\fB\-\-load\-credentials\fR +.RS 4 +\fBudevadm\fR(8) +.RE +.PP \fB\-\-locale\fR .RS 4 \fBsystemd-firstboot\fR(1) @@ -11505,6 +11991,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd\fR(1) .RE .PP +\fB\-\-login\-background\fR +.RS 4 +\fBhomectl\fR(1) +.RE +.PP \fB\-\-loop\-ref\fR .RS 4 \fBsystemd-dissect\fR(1) @@ -11585,11 +12076,13 @@ Command\-line options accepted by programs in the systemd suite\&. \fBbusctl\fR(1), \fBhomectl\fR(1), \fBhostnamectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), \fBmachinectl\fR(1), \fBportablectl\fR(1), +\fBrun0\fR(1), \fBsystemctl\fR(1), \fBsystemd-analyze\fR(1), \fBsystemd-cgls\fR(1), @@ -11609,6 +12102,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-pcrphase.service\fR(8) .RE .PP +\fB\-\-make\-archive\fR +.RS 4 +\fBsystemd-dissect\fR(1) +.RE +.PP \fB\-\-make\-ddi\fR .RS 4 \fBsystemd-repart\fR(8) @@ -11677,6 +12175,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemctl\fR(1) .RE .PP +\fB\-\-microcode\fR +.RS 4 +\fBukify\fR(1) +.RE +.PP \fB\-\-mkdir\fR .RS 4 \fBmachinectl\fR(1), @@ -11724,6 +12227,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBuserdbctl\fR(1) .RE .PP +\fB\-\-mutable\fR +.RS 4 +\fBsystemd-sysext\fR(8) +.RE +.PP \fB\-\-name\fR .RS 4 \fBsystemd-creds\fR(1), @@ -11738,6 +12246,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-\-namespace\fR .RS 4 \fBjournalctl\fR(1), +\fBsystemd-cat\fR(1), \fBsystemd-journal-upload.service\fR(8) .RE .PP @@ -11771,6 +12280,16 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-nspawn\fR(1) .RE .PP +\fB\-\-network\-tap\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP +\fB\-\-network\-user\-mode\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP \fB\-\-network\-veth\fR .RS 4 \fBsystemd-nspawn\fR(1) @@ -11794,6 +12313,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-\-nice\fR .RS 4 \fBhomectl\fR(1), +\fBrun0\fR(1), \fBsystemd-run\fR(1) .RE .PP @@ -11801,10 +12321,12 @@ Command\-line options accepted by programs in the systemd suite\&. .RS 4 \fBhomectl\fR(1), \fBhostnamectl\fR(1), +\fBimportctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), \fBmachinectl\fR(1), \fBportablectl\fR(1), +\fBrun0\fR(1), \fBsystemctl\fR(1), \fBsystemd-mount\fR(1), \fBsystemd-run\fR(1), @@ -11840,6 +12362,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBbusctl\fR(1), \fBcoredumpctl\fR(1), \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBkernel-install\fR(8), \fBloginctl\fR(1), \fBmachinectl\fR(1), @@ -11848,6 +12371,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-analyze\fR(1), \fBsystemd-creds\fR(1), \fBsystemd-dissect\fR(1), +\fBsystemd-id128\fR(1), \fBsystemd-inhibit\fR(1), \fBsystemd-mount\fR(1), \fBsystemd-repart\fR(8), @@ -11877,6 +12401,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBbusctl\fR(1), \fBcoredumpctl\fR(1), \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBkernel-install\fR(8), \fBlocalectl\fR(1), @@ -11893,6 +12418,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-creds\fR(1), \fBsystemd-delta\fR(1), \fBsystemd-dissect\fR(1), +\fBsystemd-id128\fR(1), \fBsystemd-inhibit\fR(1), \fBsystemd-measure\fR(1), \fBsystemd-mount\fR(1), @@ -12029,6 +12555,7 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-offline\fR .RS 4 +\fBhomectl\fR(1), \fBsystemd-analyze\fR(1), \fBsystemd-repart\fR(8) .RE @@ -12151,6 +12678,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBudevadm\fR(8) .RE .PP +\fB\-\-pass\-ssh\-key\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP \fB\-\-password\fR .RS 4 \fBsystemd-cryptenroll\fR(1) @@ -12319,6 +12851,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-\-print\fR .RS 4 \fBsystemd-machine-id-setup\fR(1), +\fBsystemd-vpick\fR(1), \fBudevadm\fR(8) .RE .PP @@ -12354,6 +12887,12 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-repart\fR(8) .RE .PP +\fB\-\-private\-key\-source\fR +.RS 4 +\fBsystemd-measure\fR(1), +\fBsystemd-repart\fR(8) +.RE +.PP \fB\-\-private\-network\fR .RS 4 \fBsystemd-nspawn\fR(1) @@ -12362,7 +12901,8 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-\-private\-users\fR .RS 4 \fBsystemd-detect-virt\fR(1), -\fBsystemd-nspawn\fR(1) +\fBsystemd-nspawn\fR(1), +\fBsystemd-vmspawn\fR(1) .RE .PP \fB\-\-private\-users\-ownership\fR @@ -12415,6 +12955,7 @@ Command\-line options accepted by programs in the systemd suite\&. .RS 4 \fBloginctl\fR(1), \fBmachinectl\fR(1), +\fBrun0\fR(1), \fBsystemctl\fR(1), \fBsystemd-mount\fR(1), \fBsystemd-nspawn\fR(1), @@ -12443,29 +12984,9 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-measure\fR(1) .RE .PP -\fB\-\-qemu\-gui\fR -.RS 4 -\fBsystemd-vmspawn\fR(1) -.RE -.PP -\fB\-\-qemu\-kvm\fR +\fB\-\-purge\fR .RS 4 -\fBsystemd-vmspawn\fR(1) -.RE -.PP -\fB\-\-qemu\-mem\fR -.RS 4 -\fBsystemd-vmspawn\fR(1) -.RE -.PP -\fB\-\-qemu\-smp\fR -.RS 4 -\fBsystemd-vmspawn\fR(1) -.RE -.PP -\fB\-\-qemu\-vsock\fR -.RS 4 -\fBsystemd-vmspawn\fR(1) +\fBsystemd-tmpfiles\fR(8) .RE .PP \fB\-\-query\fR @@ -12479,6 +13000,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBbootctl\fR(1), \fBbusctl\fR(1), \fBcoredumpctl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBmachinectl\fR(1), \fBportablectl\fR(1), @@ -12490,9 +13012,15 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-networkd-wait-online.service\fR(8), \fBsystemd-nspawn\fR(1), \fBsystemd-run\fR(1), +\fBsystemd-vmspawn\fR(1), \fBudevadm\fR(8) .RE .PP +\fB\-\-ram\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP \fB\-\-rate\-limit\-burst\fR .RS 4 \fBhomectl\fR(1) @@ -12516,6 +13044,7 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-read\-only\fR .RS 4 +\fBimportctl\fR(1), \fBmachinectl\fR(1), \fBsystemctl\fR(1), \fBsystemd-dissect\fR(1), @@ -12578,7 +13107,13 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-register\fR .RS 4 -\fBsystemd-nspawn\fR(1) +\fBsystemd-nspawn\fR(1), +\fBsystemd-vmspawn\fR(1) +.RE +.PP +\fB\-\-relax\-single\-label\fR +.RS 4 +\fBresolvectl\fR(1) .RE .PP \fB\-\-relinquish\-var\fR @@ -12632,6 +13167,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-nspawn\fR(1) .RE .PP +\fB\-\-resolve\fR +.RS 4 +\fBsystemd-vpick\fR(1) +.RE +.PP \fB\-\-resolve\-names\fR .RS 4 \fBsystemd-udevd.service\fR(8), @@ -12712,8 +13252,14 @@ Command\-line options accepted by programs in the systemd suite\&. \fBjournalctl\fR(1) .RE .PP +\fB\-\-runner\fR +.RS 4 +\fBmachinectl\fR(1) +.RE +.PP \fB\-\-runtime\fR .RS 4 +\fBnetworkctl\fR(1), \fBportablectl\fR(1), \fBsystemctl\fR(1) .RE @@ -12844,6 +13390,16 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd\fR(1) .RE .PP +\fB\-\-session\-launcher\fR +.RS 4 +\fBhomectl\fR(1) +.RE +.PP +\fB\-\-session\-type\fR +.RS 4 +\fBhomectl\fR(1) +.RE +.PP \fB\-\-set\-credential\fR .RS 4 \fBsystemd-nspawn\fR(1), @@ -12854,6 +13410,7 @@ Command\-line options accepted by programs in the systemd suite\&. .RS 4 \fBhomectl\fR(1), \fBmachinectl\fR(1), +\fBrun0\fR(1), \fBsystemd-nspawn\fR(1), \fBsystemd-run\fR(1), \fBsystemd-socket-activate\fR(1) @@ -12956,12 +13513,14 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-slice\fR .RS 4 +\fBrun0\fR(1), \fBsystemd-nspawn\fR(1), \fBsystemd-run\fR(1) .RE .PP \fB\-\-slice\-inherit\fR .RS 4 +\fBrun0\fR(1), \fBsystemd-run\fR(1) .RE .PP @@ -12996,6 +13555,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBhomectl\fR(1) .RE .PP +\fB\-\-ssh\-key\-type\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP \fB\-\-stale\-data\fR .RS 4 \fBresolvectl\fR(1) @@ -13031,6 +13595,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-cat\fR(1) .RE .PP +\fB\-\-stdin\fR +.RS 4 +\fBsystemctl\fR(1) +.RE +.PP \fB\-\-stop\-delay\fR .RS 4 \fBhomectl\fR(1) @@ -13070,7 +13639,8 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-\-suffix\fR .RS 4 \fBsystemd-escape\fR(1), -\fBsystemd-path\fR(1) +\fBsystemd-path\fR(1), +\fBsystemd-vpick\fR(1) .RE .PP \fB\-\-summary\fR @@ -13212,6 +13782,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBukify\fR(1) .RE .PP +\fB\-\-tpm\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP \fB\-\-tpm2\-device\fR .RS 4 \fBsystemd-creds\fR(1), @@ -13303,15 +13878,26 @@ Command\-line options accepted by programs in the systemd suite\&. \fBresolvectl\fR(1) .RE .PP +\fB\-\-tty\fR +.RS 4 +\fBsystemd-bsod.service\fR(8) +.RE +.PP \fB\-\-type\fR .RS 4 \fBresolvectl\fR(1), \fBsystemctl\fR(1), \fBsystemd-delta\fR(1), \fBsystemd-mount\fR(1), +\fBsystemd-vpick\fR(1), \fBudevadm\fR(8) .RE .PP +\fB\-\-ucode\fR +.RS 4 +\fBsystemd-measure\fR(1) +.RE +.PP \fB\-\-udev\fR .RS 4 \fBudevadm\fR(8) @@ -13321,6 +13907,7 @@ Command\-line options accepted by programs in the systemd suite\&. .RS 4 \fBhomectl\fR(1), \fBmachinectl\fR(1), +\fBsystemd-creds\fR(1), \fBsystemd-notify\fR(1), \fBsystemd-run\fR(1) .RE @@ -13355,6 +13942,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-\-unit\fR .RS 4 \fBjournalctl\fR(1), +\fBrun0\fR(1), \fBsystemd\fR(1), \fBsystemd-analyze\fR(1), \fBsystemd-cgls\fR(1), @@ -13371,6 +13959,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-cryptenroll\fR(1) .RE .PP +\fB\-\-unlock\-tpm2\-device\fR +.RS 4 +\fBsystemd-cryptenroll\fR(1) +.RE +.PP \fB\-\-unregister\fR .RS 4 \fBsystemd-binfmt.service\fR(8) @@ -13397,9 +13990,11 @@ Command\-line options accepted by programs in the systemd suite\&. .RS 4 \fBbusctl\fR(1), \fBjournalctl\fR(1), +\fBrun0\fR(1), \fBsystemctl\fR(1), \fBsystemd\fR(1), \fBsystemd-analyze\fR(1), +\fBsystemd-creds\fR(1), \fBsystemd-journal-gatewayd.service\fR(8), \fBsystemd-journal-upload.service\fR(8), \fBsystemd-mount\fR(1), @@ -13429,6 +14024,7 @@ Command\-line options accepted by programs in the systemd suite\&. .RS 4 \fBsystemd-id128\fR(1), \fBsystemd-nspawn\fR(1), +\fBsystemd-vmspawn\fR(1), \fBudevadm\fR(8) .RE .PP @@ -13473,8 +14069,8 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-\-verify\fR .RS 4 +\fBimportctl\fR(1), \fBjournalctl\fR(1), -\fBmachinectl\fR(1), \fBsystemd-sysupdate\fR(8) .RE .PP @@ -13496,6 +14092,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBcoredumpctl\fR(1), \fBhomectl\fR(1), \fBhostnamectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBkernel-install\fR(8), \fBlocalectl\fR(1), @@ -13505,6 +14102,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBoomctl\fR(1), \fBportablectl\fR(1), \fBresolvectl\fR(1), +\fBrun0\fR(1), \fBsystemctl\fR(1), \fBsystemd\fR(1), \fBsystemd-ac-power\fR(1), @@ -13534,6 +14132,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-networkd-wait-online.service\fR(8), \fBsystemd-notify\fR(1), \fBsystemd-nspawn\fR(1), +\fBsystemd-oomd.service\fR(8), \fBsystemd-path\fR(1), \fBsystemd-pcrlock\fR(8), \fBsystemd-pcrphase.service\fR(8), @@ -13552,6 +14151,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-tty-ask-password-agent\fR(1), \fBsystemd-udevd.service\fR(8), \fBsystemd-vmspawn\fR(1), +\fBsystemd-vpick\fR(1), \fBtimedatectl\fR(1), \fBudevadm\fR(8), \fBukify\fR(1), @@ -13569,6 +14169,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-nspawn\fR(1) .RE .PP +\fB\-\-vsock\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP \fB\-\-vsock\-cid\fR .RS 4 \fBsystemd-vmspawn\fR(1) @@ -13713,12 +14318,22 @@ Command\-line options accepted by programs in the systemd suite\&. .RS 4 \fBcoredumpctl\fR(1), \fBsystemd-mount\fR(1), +\fBsystemd-vpick\fR(1), \fBudevadm\fR(8) .RE .PP +\fB\-B\fR +.RS 4 +\fBsystemd-vpick\fR(1) +.RE +.PP \fB\-C\fR .RS 4 +\fBbusctl\fR(1), +\fBimportctl\fR(1), +\fBsystemctl\fR(1), \fBsystemd-repart\fR(8), +\fBsystemd-run\fR(1), \fBsystemd-sysupdate\fR(8) .RE .PP @@ -13726,10 +14341,12 @@ Command\-line options accepted by programs in the systemd suite\&. .RS 4 \fBcoredumpctl\fR(1), \fBjournalctl\fR(1), +\fBrun0\fR(1), \fBsystemd-journal-gatewayd.service\fR(8), \fBsystemd-journal-upload.service\fR(8), \fBsystemd-nspawn\fR(1), -\fBsystemd-udevd.service\fR(8) +\fBsystemd-udevd.service\fR(8), +\fBsystemd-vmspawn\fR(1) .RE .PP \fB\-E\fR @@ -13766,6 +14383,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBbusctl\fR(1), \fBhomectl\fR(1), \fBhostnamectl\fR(1), +\fBimportctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), \fBmachinectl\fR(1), @@ -13794,11 +14412,13 @@ Command\-line options accepted by programs in the systemd suite\&. \fBbusctl\fR(1), \fBhomectl\fR(1), \fBhostnamectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), \fBmachinectl\fR(1), \fBportablectl\fR(1), +\fBrun0\fR(1), \fBsystemctl\fR(1), \fBsystemd-analyze\fR(1), \fBsystemd-cgls\fR(1), @@ -13814,6 +14434,7 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-N\fR .RS 4 +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBsystemd-udevd.service\fR(8), \fBudevadm\fR(8), @@ -13823,6 +14444,8 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-P\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), +\fBmachinectl\fR(1), \fBshutdown\fR(8), \fBsystemctl\fR(1), \fBsystemd-cgtop\fR(1), @@ -13830,6 +14453,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-nspawn\fR(1), \fBsystemd-repart\fR(8), \fBsystemd-run\fR(1), +\fBtimedatectl\fR(1), \fBudevadm\fR(8) .RE .PP @@ -13843,15 +14467,18 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-S\fR .RS 4 \fBcoredumpctl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBsystemd-nspawn\fR(1), \fBsystemd-repart\fR(8), \fBsystemd-run\fR(1), +\fBsystemd-vpick\fR(1), \fBudevadm\fR(8) .RE .PP \fB\-T\fR .RS 4 +\fBjournalctl\fR(1), \fBsystemctl\fR(1), \fBsystemd-creds\fR(1), \fBsystemd-mount\fR(1) @@ -13867,7 +14494,9 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-V\fR .RS 4 -\fBresolvectl\fR(1) +\fBmachinectl\fR(1), +\fBresolvectl\fR(1), +\fBsystemd-vpick\fR(1) .RE .PP \fB\-Z\fR @@ -13894,6 +14523,7 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-b\fR .RS 4 +\fBhomectl\fR(1), \fBjournalctl\fR(1), \fBsystemd-cgtop\fR(1), \fBsystemd-nspawn\fR(1), @@ -13915,7 +14545,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBudevadm\fR(8) .RE .PP -\fB\-d\fR +\fB\-d\fR\fB\fIPATH\fR\fR .RS 4 \fBhomectl\fR(1), \fBpoweroff\fR(8), @@ -13946,6 +14576,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fB\-g\fR .RS 4 \fBjournalctl\fR(1), +\fBrun0\fR(1), \fBudevadm\fR(8) .RE .PP @@ -13956,6 +14587,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBcoredumpctl\fR(1), \fBhomectl\fR(1), \fBhostnamectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBkernel-install\fR(8), \fBlocalectl\fR(1), @@ -13965,6 +14597,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBoomctl\fR(1), \fBportablectl\fR(1), \fBresolvectl\fR(1), +\fBrun0\fR(1), \fBshutdown\fR(8), \fBsystemctl\fR(1), \fBsystemd\fR(1), @@ -13997,6 +14630,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-networkd-wait-online.service\fR(8), \fBsystemd-notify\fR(1), \fBsystemd-nspawn\fR(1), +\fBsystemd-oomd.service\fR(8), \fBsystemd-path\fR(1), \fBsystemd-pcrlock\fR(8), \fBsystemd-pcrphase.service\fR(8), @@ -14015,6 +14649,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-tty-ask-password-agent\fR(1), \fBsystemd-udevd.service\fR(8), \fBsystemd-vmspawn\fR(1), +\fBsystemd-vpick\fR(1), \fBtimedatectl\fR(1), \fBudevadm\fR(8), \fBukify\fR(1), @@ -14024,6 +14659,7 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-i\fR .RS 4 +\fBjournalctl\fR(1), \fBresolvectl\fR(1), \fBsystemctl\fR(1), \fBsystemd-cgtop\fR(1), @@ -14036,7 +14672,11 @@ Command\-line options accepted by programs in the systemd suite\&. .RS 4 \fBbusctl\fR(1), \fBhomectl\fR(1), +\fBhostnamectl\fR(1), +\fBimportctl\fR(1), +\fBloginctl\fR(1), \fBresolvectl\fR(1), +\fBsystemd-id128\fR(1), \fBsystemd-nspawn\fR(1), \fBvarlinkctl\fR(1) .RE @@ -14068,6 +14708,7 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fB\-m\fR .RS 4 +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBresolvectl\fR(1), \fBsystemd-cgtop\fR(1), @@ -14091,6 +14732,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-ask-password\fR(1), \fBsystemd-cgtop\fR(1), \fBsystemd-nspawn\fR(1), +\fBsystemd-vmspawn\fR(1), \fBudevadm\fR(8) .RE .PP @@ -14125,6 +14767,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-nspawn\fR(1), \fBsystemd-run\fR(1), \fBsystemd-stdio-bridge\fR(1), +\fBsystemd-vpick\fR(1), \fBtimedatectl\fR(1), \fBudevadm\fR(8) .RE @@ -14134,6 +14777,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBbootctl\fR(1), \fBbusctl\fR(1), \fBcoredumpctl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBmachinectl\fR(1), \fBportablectl\fR(1), @@ -14145,6 +14789,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-networkd-wait-online.service\fR(8), \fBsystemd-nspawn\fR(1), \fBsystemd-run\fR(1), +\fBsystemd-vmspawn\fR(1), \fBudevadm\fR(8) .RE .PP @@ -14187,6 +14832,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd-mount\fR(1), \fBsystemd-run\fR(1), \fBsystemd-udevd.service\fR(8), +\fBsystemd-vpick\fR(1), \fBudevadm\fR(8) .RE .PP @@ -14194,6 +14840,7 @@ Command\-line options accepted by programs in the systemd suite\&. .RS 4 \fBjournalctl\fR(1), \fBresolvectl\fR(1), +\fBrun0\fR(1), \fBsystemd-cgls\fR(1), \fBsystemd-dissect\fR(1), \fBsystemd-escape\fR(1), @@ -14236,6 +14883,16 @@ Command\-line options accepted by programs in the systemd suite\&. \fBudevadm\fR(8) .RE .PP +\fBBonding\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP +\fBCAN\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP \fBIPv4\fR .RS 4 \fBsystemd.link\fR(5), @@ -14251,6 +14908,7 @@ Command\-line options accepted by programs in the systemd suite\&. \fBK\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -14267,9 +14925,20 @@ Command\-line options accepted by programs in the systemd suite\&. \fBuserdbctl\fR(1) .RE .PP +\fBMaster\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP +\fBOther\fR +.RS 4 +\fBsystemd.network\fR(5) +.RE +.PP \fBX\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -14314,6 +14983,7 @@ Command\-line options accepted by programs in the systemd suite\&. .PP \fBauto\fR .RS 4 +\fBsystemd-sysext\fR(8), \fBsystemd.resource-control\fR(5) .RE .PP @@ -14425,6 +15095,16 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd.network\fR(5) .RE .PP +\fBephemeral\fR +.RS 4 +\fBsystemd-sysext\fR(8) +.RE +.PP +\fBephemeral\-import\fR +.RS 4 +\fBsystemd-sysext\fR(8) +.RE +.PP \fBeui64\fR .RS 4 \fBsystemd.network\fR(5) @@ -14487,6 +15167,11 @@ Command\-line options accepted by programs in the systemd suite\&. \fBloader.conf\fR(5) .RE .PP +\fBimport\fR +.RS 4 +\fBsystemd-sysext\fR(8) +.RE +.PP \fBindeterminate\fR .RS 4 \fBsystemd-bless-boot.service\fR(8) @@ -14615,12 +15300,22 @@ Command\-line options accepted by programs in the systemd suite\&. \fBsystemd.link\fR(5) .RE .PP +\fBno\fR +.RS 4 +\fBsystemd-sysext\fR(8) +.RE +.PP \fBnone\fR .RS 4 \fBsystemd.link\fR(5), \fBsystemd.network\fR(5) .RE .PP +\fBnspawn\fR +.RS 4 +\fBmachinectl\fR(1) +.RE +.PP \fBoff\fR .RS 4 \fBloader.conf\fR(5) @@ -14879,11 +15574,21 @@ Command\-line options accepted by programs in the systemd suite\&. \fBjournalctl\fR(1) .RE .PP +\fBvmspawn\fR +.RS 4 +\fBmachinectl\fR(1) +.RE +.PP \fBwith\-unit\fR .RS 4 \fBjournalctl\fR(1) .RE .PP +\fByes\fR +.RS 4 +\fBsystemd-sysext\fR(8) +.RE +.PP \fBμs\fR .RS 4 \fBsystemctl\fR(1) @@ -15513,6 +16218,11 @@ Various constants used and/or defined by systemd\&. \fBsd_bus_track_add_name\fR(3) .RE .PP +\fB/etc/subuid\fR +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP \fB/org/freedesktop/systemd1\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) @@ -15528,6 +16238,7 @@ Various constants used and/or defined by systemd\&. \fBsd_journal_add_match\fR(3), \fBsystemctl\fR(1), \fBsystemd-analyze\fR(1), +\fBsystemd.net-naming-scheme\fR(7), \fBsystemd.netdev\fR(5), \fBsystemd.resource-control\fR(5), \fBtmpfiles.d\fR(5), @@ -15593,6 +16304,7 @@ Various constants used and/or defined by systemd\&. \fBsystemd-analyze\fR(1), \fBsystemd-oomd.service\fR(8), \fBsystemd-tmpfiles\fR(8), +\fBsystemd.net-naming-scheme\fR(7), \fBsystemd.network\fR(5), \fBsystemd.scope\fR(5), \fBsystemd.service\fR(5), @@ -15657,13 +16369,9 @@ Various constants used and/or defined by systemd\&. \fBresolvectl\fR(1) .RE .PP -\fB4a67b082\-0a4c\-41cf\-b6c7\-440b29bb8c4\fR -.RS 4 -\fBsystemd-bless-boot.service\fR(8) -.RE -.PP \fB4a67b082\-0a4c\-41cf\-b6c7\-440b29bb8c4f\fR .RS 4 +\fBsystemd-bless-boot.service\fR(8), \fBsystemd-gpt-auto-generator\fR(8) .RE .PP @@ -15729,6 +16437,7 @@ Various constants used and/or defined by systemd\&. \fBorg.freedesktop.machine1\fR(5), \fBorg.freedesktop.resolve1\fR(5), \fBsd_is_fifo\fR(3), +\fBsystemd-ssh-generator\fR(8), \fBsystemd.exec\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.socket\fR(5) @@ -15736,9 +16445,11 @@ Various constants used and/or defined by systemd\&. .PP \fBAF_INET6\fR .RS 4 +\fBjournald.conf\fR(5), \fBorg.freedesktop.machine1\fR(5), \fBorg.freedesktop.resolve1\fR(5), \fBsd_is_fifo\fR(3), +\fBsystemd-ssh-generator\fR(8), \fBsystemd.exec\fR(5), \fBsystemd.resource-control\fR(5), \fBsystemd.socket\fR(5) @@ -15773,6 +16484,8 @@ Various constants used and/or defined by systemd\&. \fBsystemd-journal-gatewayd.service\fR(8), \fBsystemd-journal-remote.service\fR(8), \fBsystemd-repart\fR(8), +\fBsystemd-ssh-generator\fR(8), +\fBsystemd-ssh-proxy\fR(1), \fBsystemd.exec\fR(5), \fBsystemd.link\fR(5), \fBsystemd.netdev\fR(5), @@ -15789,9 +16502,14 @@ Various constants used and/or defined by systemd\&. .PP \fBAF_VSOCK\fR .RS 4 +\fBjournald.conf\fR(5), +\fBorg.freedesktop.hostname1\fR(5), \fBsd_notify\fR(3), \fBsystemd\fR(1), +\fBsystemd-ssh-generator\fR(8), +\fBsystemd-ssh-proxy\fR(1), \fBsystemd.socket\fR(5), +\fBsystemd.special\fR(7), \fBsystemd.system-credentials\fR(7) .RE .PP @@ -16846,6 +17564,7 @@ Various constants used and/or defined by systemd\&. \fBsd_journal_open\fR(3), \fBsd_journal_print\fR(3), \fBsd_journal_query_unique\fR(3), +\fBsd_journal_stream_fd\fR(3), \fBsd_listen_fds\fR(3), \fBsd_login_monitor_new\fR(3), \fBsd_machine_get_class\fR(3), @@ -17022,6 +17741,21 @@ Various constants used and/or defined by systemd\&. \fBsystemd.exec\fR(5) .RE .PP +\fBSCM_CREDENTIALS\fR +.RS 4 +\fBsystemd-socket-proxyd\fR(8) +.RE +.PP +\fBSCM_RIGHTS\fR +.RS 4 +\fBsystemd-socket-proxyd\fR(8) +.RE +.PP +\fBSCM_SECURITY\fR +.RS 4 +\fBsystemd-socket-proxyd\fR(8) +.RE +.PP \fBSD_BUS_ARGS(\fR\fB\fI\&.\&.\&.\fR\fR\fB)\fR .RS 4 \fBsd_bus_add_object\fR(3) @@ -17127,6 +17861,11 @@ Various constants used and/or defined by systemd\&. \fBsd_bus_creds_new_from_pid\fR(3) .RE .PP +\fBSD_BUS_CREDS_PIDFD\fR +.RS 4 +\fBsd_bus_creds_new_from_pid\fR(3) +.RE +.PP \fBSD_BUS_CREDS_PPID\fR .RS 4 \fBsd_bus_creds_new_from_pid\fR(3) @@ -18137,6 +18876,11 @@ Various constants used and/or defined by systemd\&. \fBsystemd-gpt-auto-generator\fR(8) .RE .PP +\fBSD_HOMED_UPDATE_OFFLINE\fR +.RS 4 +\fBorg.freedesktop.home1\fR(5) +.RE +.PP \fBSD_ID128_ALLF\fR .RS 4 \fBsd-id128\fR(3), @@ -18651,6 +19395,7 @@ Various constants used and/or defined by systemd\&. \fBdaemon\fR(7), \fBorg.freedesktop.hostname1\fR(5), \fBsystemd\fR(1), +\fBsystemd-resolved.service\fR(8), \fBsystemd.kill\fR(5), \fBsystemd.service\fR(5) .RE @@ -18905,6 +19650,7 @@ Various constants used and/or defined by systemd\&. .RS 4 \fBsd_is_fifo\fR(3), \fBsystemd-socket-activate\fR(1), +\fBsystemd-ssh-proxy\fR(1), \fBsystemd.socket\fR(5) .RE .PP @@ -18938,6 +19684,26 @@ Various constants used and/or defined by systemd\&. \fBsystemd.socket\fR(5) .RE .PP +\fBSO_PEERCRED\fR +.RS 4 +\fBsystemd-socket-proxyd\fR(8) +.RE +.PP +\fBSO_PEERGROUPS\fR +.RS 4 +\fBsystemd-socket-proxyd\fR(8) +.RE +.PP +\fBSO_PEERPIDFD\fR +.RS 4 +\fBsystemd-socket-proxyd\fR(8) +.RE +.PP +\fBSO_PEERSEC\fR +.RS 4 +\fBsystemd-socket-proxyd\fR(8) +.RE +.PP \fBSO_PRIORITY\fR .RS 4 \fBsystemd.netdev\fR(5), @@ -18975,6 +19741,26 @@ Various constants used and/or defined by systemd\&. \fBudev_device_new_from_syspath\fR(3) .RE .PP +\fBSYSTEMD_LOG_LEVEL=debug,console:info\fR +.RS 4 +\fBhomectl\fR(1), +\fBimportctl\fR(1), +\fBjournalctl\fR(1), +\fBlocalectl\fR(1), +\fBloginctl\fR(1), +\fBmachinectl\fR(1), +\fBportablectl\fR(1), +\fBsystemctl\fR(1), +\fBsystemd\fR(1), +\fBsystemd-analyze\fR(1), +\fBsystemd-inhibit\fR(1), +\fBsystemd-nspawn\fR(1), +\fBsystemd-tmpfiles\fR(8), +\fBsystemd-vmspawn\fR(1), +\fBtimedatectl\fR(1), +\fBuserdbctl\fR(1) +.RE +.PP \fBS_IFREG\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) @@ -19025,19 +19811,35 @@ Various constants used and/or defined by systemd\&. \fBsystemd.exec\fR(5) .RE .PP +\fBUINT32_MAX\fR +.RS 4 +\fBorg.freedesktop.hostname1\fR(5) +.RE +.PP \fBUINT64_MAX\fR .RS 4 \fBorg.freedesktop.home1\fR(5), +\fBorg.freedesktop.hostname1\fR(5), \fBsd_bus_get_fd\fR(3), \fBsd_bus_wait\fR(3), \fBsd_event_add_time\fR(3) .RE .PP +\fBUNIT64_MAX\fR +.RS 4 +\fBorg.freedesktop.hostname1\fR(5) +.RE +.PP \fBUSER_PROCESS\fR .RS 4 \fBsystemd.exec\fR(5) .RE .PP +\fBVMADDR_CID_ANY\fR +.RS 4 +\fBorg.freedesktop.machine1\fR(5) +.RE +.PP \fBWCONTINUED\fR .RS 4 \fBsd_event_add_child\fR(3) @@ -19097,6 +19899,7 @@ Various constants used and/or defined by systemd\&. \fBalert\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -19169,6 +19972,7 @@ Various constants used and/or defined by systemd\&. \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), \fBsystemd.exec\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -19183,6 +19987,7 @@ Various constants used and/or defined by systemd\&. \fBauto\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -19211,6 +20016,16 @@ Various constants used and/or defined by systemd\&. \fBsystemd-gpt-auto-generator\fR(8) .RE .PP +\fBbackground\fR +.RS 4 +\fBpam_systemd\fR(8) +.RE +.PP +\fBbackground\-light\fR +.RS 4 +\fBpam_systemd\fR(8) +.RE +.PP \fBbad\-setting\fR .RS 4 \fBsystemctl\fR(1) @@ -19291,6 +20106,7 @@ Various constants used and/or defined by systemd\&. \fBconsole\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -19310,6 +20126,7 @@ Various constants used and/or defined by systemd\&. \fBconsole\-prefixed\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -19345,6 +20162,7 @@ Various constants used and/or defined by systemd\&. \fBcrit\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -19375,6 +20193,7 @@ Various constants used and/or defined by systemd\&. \fBdebug\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -19424,6 +20243,7 @@ Various constants used and/or defined by systemd\&. \fBemerg\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -19453,6 +20273,7 @@ Various constants used and/or defined by systemd\&. \fBerr\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -19519,6 +20340,11 @@ Various constants used and/or defined by systemd\&. \fBsystemd.resource-control\fR(5) .RE .PP +\fBgreeter\fR +.RS 4 +\fBpam_systemd\fR(8) +.RE +.PP \fBh\fR .RS 4 \fBtmpfiles.d\fR(5) @@ -19570,6 +20396,7 @@ Various constants used and/or defined by systemd\&. \fBinfo\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -19617,6 +20444,11 @@ Various constants used and/or defined by systemd\&. \fBuserdbctl\fR(1) .RE .PP +\fBio\&.systemd\&.MountFileSystem\fR +.RS 4 +\fBsystemd-mountfsd.service\fR(8) +.RE +.PP \fBio\&.systemd\&.Multiplexer\fR .RS 4 \fBsystemd-userdbd.service\fR(8), @@ -19629,6 +20461,11 @@ Various constants used and/or defined by systemd\&. \fBuserdbctl\fR(1) .RE .PP +\fBio\&.systemd\&.NamespaceResource\fR +.RS 4 +\fBsystemd-nsresourced.service\fR(8) +.RE +.PP \fBipc\fR .RS 4 \fBsystemd.exec\fR(5) @@ -19647,6 +20484,7 @@ Various constants used and/or defined by systemd\&. \fBjournal\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -19666,6 +20504,7 @@ Various constants used and/or defined by systemd\&. \fBjournal\-or\-kmsg\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -19706,6 +20545,7 @@ Various constants used and/or defined by systemd\&. \fBkmsg\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -19913,6 +20753,11 @@ Various constants used and/or defined by systemd\&. \fBsystemd.resource-control\fR(5) .RE .PP +\fBlock\-screen\fR +.RS 4 +\fBpam_systemd\fR(8) +.RE +.PP \fBlogs\fR .RS 4 \fBsystemctl\fR(1) @@ -19934,6 +20779,16 @@ Various constants used and/or defined by systemd\&. \fBsystemd.exec\fR(5) .RE .PP +\fBmanager\fR +.RS 4 +\fBpam_systemd\fR(8) +.RE +.PP +\fBmanager\-early\fR +.RS 4 +\fBpam_systemd\fR(8) +.RE +.PP \fBmasked\fR .RS 4 \fBsystemctl\fR(1) @@ -20053,6 +20908,7 @@ Various constants used and/or defined by systemd\&. \fBnotice\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -20072,6 +20928,7 @@ Various constants used and/or defined by systemd\&. \fBnull\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -20257,6 +21114,11 @@ Various constants used and/or defined by systemd\&. \fBudevadm\fR(8) .RE .PP +\fBphys_port_name\fR +.RS 4 +\fBsystemd.net-naming-scheme\fR(7) +.RE +.PP \fBpid\fR .RS 4 \fBsystemd.exec\fR(5) @@ -20586,7 +21448,22 @@ Various constants used and/or defined by systemd\&. .PP \fBsyslog\fR .RS 4 -\fBsystemctl\fR(1) +\fBhomectl\fR(1), +\fBimportctl\fR(1), +\fBjournalctl\fR(1), +\fBlocalectl\fR(1), +\fBloginctl\fR(1), +\fBmachinectl\fR(1), +\fBportablectl\fR(1), +\fBsystemctl\fR(1), +\fBsystemd\fR(1), +\fBsystemd-analyze\fR(1), +\fBsystemd-inhibit\fR(1), +\fBsystemd-nspawn\fR(1), +\fBsystemd-tmpfiles\fR(8), +\fBsystemd-vmspawn\fR(1), +\fBtimedatectl\fR(1), +\fBuserdbctl\fR(1) .RE .PP \fBtar\fR @@ -20670,9 +21547,20 @@ Various constants used and/or defined by systemd\&. .PP \fBuser\fR .RS 4 +\fBpam_systemd\fR(8), \fBsystemd.exec\fR(5) .RE .PP +\fBuser\-early\fR +.RS 4 +\fBpam_systemd\fR(8) +.RE +.PP +\fBuser\-incomplete\fR +.RS 4 +\fBpam_systemd\fR(8) +.RE +.PP \fBusr\fR .RS 4 \fBrepart.d\fR(5), @@ -20819,6 +21707,7 @@ Various constants used and/or defined by systemd\&. \fBwarning\fR .RS 4 \fBhomectl\fR(1), +\fBimportctl\fR(1), \fBjournalctl\fR(1), \fBlocalectl\fR(1), \fBloginctl\fR(1), @@ -20861,6 +21750,7 @@ Various constants used and/or defined by systemd\&. \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), \fBsystemd.exec\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -20873,6 +21763,7 @@ Various constants used and/or defined by systemd\&. \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), \fBsystemd.exec\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -20969,6 +21860,26 @@ Other configuration elements which don\*(Aqt fit in any of the above groups\&. \fBsystemd-journal-remote.service\fR(8) .RE .PP +\fI$SUDO_GID\fR +.RS 4 +\fBrun0\fR(1) +.RE +.PP +\fI$SUDO_UID\fR +.RS 4 +\fBrun0\fR(1) +.RE +.PP +\fI$SUDO_USER\fR +.RS 4 +\fBrun0\fR(1) +.RE +.PP +\fI$TERM\fR +.RS 4 +\fBrun0\fR(1) +.RE +.PP \fBA\fR .RS 4 \fBtmpfiles.d\fR(5) @@ -21014,6 +21925,11 @@ Other configuration elements which don\*(Aqt fit in any of the above groups\&. \fBtmpfiles.d\fR(5) .RE .PP +\fIDefaultSubvolume=\fR +.RS 4 +\fBrepart.d\fR(5) +.RE +.PP \fIDeviceTree=\fR .RS 4 \fBukify\fR(1) @@ -21024,6 +21940,11 @@ Other configuration elements which don\*(Aqt fit in any of the above groups\&. \fBrepart.d\fR(5) .RE .PP +\fIEncryptedVolume=\fR +.RS 4 +\fBrepart.d\fR(5) +.RE +.PP \fIExcludeFiles=\fR .RS 4 \fBrepart.d\fR(5) @@ -21064,6 +21985,16 @@ Other configuration elements which don\*(Aqt fit in any of the above groups\&. \fBsystemd.net-naming-scheme\fR(7) .RE .PP +\fIID_NET_NAME_ALLOW=\fR +.RS 4 +\fBsystemd.net-naming-scheme\fR(7) +.RE +.PP +\fIID_NET_NAME_ALLOW_\fR\fI\fIsysfsattr\fR\fR\fI=\fR\fI\fIBOOL\fR\fR +.RS 4 +\fBsystemd.net-naming-scheme\fR(7) +.RE +.PP \fIID_NET_NAME_MAC=\fR .RS 4 \fBsystemd.net-naming-scheme\fR(7) @@ -21129,6 +22060,11 @@ Other configuration elements which don\*(Aqt fit in any of the above groups\&. \fBsysupdate.d\fR(5) .RE .PP +\fIMicrocode=\fR +.RS 4 +\fBukify\fR(1) +.RE +.PP \fIMinVersion=\fR .RS 4 \fBsysupdate.d\fR(5) @@ -21144,6 +22080,11 @@ Other configuration elements which don\*(Aqt fit in any of the above groups\&. \fBsysupdate.d\fR(5) .RE .PP +\fIMountPoint=\fR +.RS 4 +\fBrepart.d\fR(5) +.RE +.PP \fINoAuto=\fR .RS 4 \fBrepart.d\fR(5) @@ -21466,6 +22407,11 @@ Other configuration elements which don\*(Aqt fit in any of the above groups\&. \fBtmpfiles.d\fR(5) .RE .PP +\fIio\&.systemd\&.boot\&.kernel\-cmdline\-extra\fR +.RS 4 +\fBsystemd-boot\fR(7) +.RE +.PP \fIio\&.systemd\&.stub\&.kernel\-cmdline\-extra\fR .RS 4 \fBsystemd-stub\fR(7) @@ -21522,6 +22468,16 @@ Other configuration elements which don\*(Aqt fit in any of the above groups\&. \fBsysusers.d\fR(5) .RE .PP +\fIudev\&.conf\&.*\fR +.RS 4 +\fBudevadm\fR(8) +.RE +.PP +\fIudev\&.rules\&.*\fR +.RS 4 +\fBudevadm\fR(8) +.RE +.PP \fIunchanged\fR .RS 4 \fBsystemd-delta\fR(1) @@ -21619,6 +22575,7 @@ Short strings which are substituted in configuration directives\&. \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21630,6 +22587,7 @@ Short strings which are substituted in configuration directives\&. \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21642,6 +22600,11 @@ Short strings which are substituted in configuration directives\&. \fBtmpfiles.d\fR(5) .RE .PP +"%D" +.RS 4 +\fBsystemd.unit\fR(5) +.RE +.PP "%E" .RS 4 \fBsystemd.unit\fR(5) @@ -21659,6 +22622,7 @@ Short strings which are substituted in configuration directives\&. \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21686,6 +22650,7 @@ Short strings which are substituted in configuration directives\&. \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21712,6 +22677,7 @@ Short strings which are substituted in configuration directives\&. .RS 4 \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21730,6 +22696,7 @@ Short strings which are substituted in configuration directives\&. .RS 4 \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21741,6 +22708,7 @@ Short strings which are substituted in configuration directives\&. \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21757,6 +22725,7 @@ Short strings which are substituted in configuration directives\&. \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21768,6 +22737,7 @@ Short strings which are substituted in configuration directives\&. \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21812,6 +22782,7 @@ Short strings which are substituted in configuration directives\&. .RS 4 \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21823,6 +22794,7 @@ Short strings which are substituted in configuration directives\&. \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21840,6 +22812,7 @@ Short strings which are substituted in configuration directives\&. \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21853,6 +22826,7 @@ Short strings which are substituted in configuration directives\&. .PP "%q" .RS 4 +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5) .RE .PP @@ -21881,6 +22855,7 @@ Short strings which are substituted in configuration directives\&. \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21892,6 +22867,7 @@ Short strings which are substituted in configuration directives\&. \fBrepart.d\fR(5), \fBsystemd-system.conf\fR(5), \fBsystemd.dnssd\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -21981,6 +22957,16 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.special\fR(7) .RE .PP +/\&.extra/confext/ +.RS 4 +\fBsystemd-stub\fR(7) +.RE +.PP +/\&.extra/confext/*\&.confext\&.raw +.RS 4 +\fBsystemd-stub\fR(7) +.RE +.PP /\&.extra/credentials/ .RS 4 \fBsystemd-stub\fR(7) @@ -22007,7 +22993,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-sysext\fR(8) .RE .PP -/\&.extra/sysext/*\&.raw +/\&.extra/sysext/*\&.sysext\&.raw .RS 4 \fBsystemd-stub\fR(7) .RE @@ -22073,6 +23059,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf /bin/sh .RS 4 \fBmachinectl\fR(1), +\fBrun0\fR(1), \fBsysusers.d\fR(5) .RE .PP @@ -22175,6 +23162,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.generator\fR(7) .RE .PP +/dev/kvm +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP /dev/log .RS 4 \fBsystemctl\fR(1), @@ -22190,6 +23182,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf .RS 4 \fBcrypttab\fR(5), \fBintegritytab\fR(5), +\fBrepart.d\fR(5), \fBveritytab\fR(5) .RE .PP @@ -22255,6 +23248,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBkernel-install\fR(8), \fBlogind.conf\fR(5), \fBmodules-load.d\fR(5), +\fBnetworkctl\fR(1), \fBnetworkd.conf\fR(5), \fBoomd.conf\fR(5), \fBorg.freedesktop.systemd1\fR(5), @@ -22334,7 +23328,8 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-cryptenroll\fR(1), \fBsystemd-measure\fR(1), \fBsystemd-pcrphase.service\fR(8), -\fBsystemd.exec\fR(5) +\fBsystemd.exec\fR(5), +\fBsystemd.special\fR(7) .RE .PP /dev/tty7 @@ -22354,6 +23349,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.resource-control\fR(5) .RE .PP +/dev/vhost\-vsock +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP /dev/watchdog0 .RS 4 \fBsystemd-system.conf\fR(5) @@ -22415,6 +23415,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-machine-id-commit.service\fR(8), \fBsystemd-machine-id-setup\fR(1), \fBsystemd-modules-load.service\fR(8), +\fBsystemd-mountfsd.service\fR(8), \fBsystemd-nspawn\fR(1), \fBsystemd-sleep.conf\fR(5), \fBsystemd-sysext\fR(8), @@ -22562,7 +23563,8 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBkernel-command-line\fR(7), \fBmachine-info\fR(5), \fBorg.freedesktop.hostname1\fR(5), -\fBsystemd-hostnamed.service\fR(8) +\fBsystemd-hostnamed.service\fR(8), +\fBsystemd.system-credentials\fR(7) .RE .PP /etc/hosts @@ -22626,6 +23628,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBkernel-install\fR(8) .RE .PP +/etc/kernel/install\&.conf\&.d/*\&.conf +.RS 4 +\fBkernel-install\fR(8) +.RE +.PP /etc/kernel/install\&.d/ .RS 4 \fBkernel-install\fR(8) @@ -22676,6 +23683,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-machine-id-setup\fR(1), \fBsystemd-nspawn\fR(1), \fBsystemd-pcrlock\fR(8), +\fBsystemd-vmspawn\fR(1), \fBsystemd.pcrlock\fR(5), \fBsystemd.unit\fR(5) .RE @@ -22685,6 +23693,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBmachine-info\fR(5), \fBorg.freedesktop.hostname1\fR(5), \fBsystemd-hostnamed.service\fR(8), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5) .RE .PP @@ -22730,6 +23739,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-system.conf\fR(5), \fBsystemd-sysupdate\fR(8), \fBsystemd.dnssd\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), \fBsysusers.d\fR(5), @@ -22811,6 +23821,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBhomectl\fR(1) .RE .PP +/etc/ssh/ssh_config\&.d/20\-systemd\-ssh\-proxy\&.conf\&.in +.RS 4 +\fBsystemd-ssh-proxy\fR(1) +.RE +.PP /etc/ssl/ca/trusted\&.pem .RS 4 \fBsystemd-journal-remote.service\fR(8), @@ -22942,7 +23957,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf .PP /etc/systemd/import\-pubring\&.gpg .RS 4 -\fBmachinectl\fR(1), +\fBimportctl\fR(1), \fBsysupdate.d\fR(5) .RE .PP @@ -23057,13 +24072,9 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-pstore.service\fR(8) .RE .PP -/etc/systemd/pstore\&.conf\&.d/ -.RS 4 -\fBpstore.conf\fR(5) -.RE -.PP /etc/systemd/pstore\&.conf\&.d/*\&.conf .RS 4 +\fBpstore.conf\fR(5), \fBsystemd-pstore.service\fR(8) .RE .PP @@ -23261,6 +24272,16 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBhwdb\fR(7) .RE .PP +/etc/udev/hwdb\&.d/50\-net\-naming\-allowlist\&.hwdb +.RS 4 +\fBsystemd.net-naming-scheme\fR(7) +.RE +.PP +/etc/udev/hwdb\&.d/50\-net\-naming\-denylist\&.hwdb +.RS 4 +\fBsystemd.net-naming-scheme\fR(7) +.RE +.PP /etc/udev/rules\&.d .RS 4 \fBudev\fR(7) @@ -23276,6 +24297,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBudev.conf\fR(5) .RE .PP +/etc/udev/udev\&.conf\&.d/*\&.conf +.RS 4 +\fBudev.conf\fR(5) +.RE +.PP /etc/userdb/ .RS 4 \fBnss-systemd\fR(8), @@ -23291,6 +24317,12 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBvconsole.conf\fR(5) .RE .PP +/etc/verity\&.d/ +.RS 4 +\fBkernel-command-line\fR(7), +\fBsystemd-mountfsd.service\fR(8) +.RE +.PP /etc/veritytab .RS 4 \fBveritytab\fR(5) @@ -23313,6 +24345,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf .PP /home/ .RS 4 +\fBcapsule@.service\fR(5), \fBfile-hierarchy\fR(7), \fBhomectl\fR(1), \fBhomed.conf\fR(5), @@ -23376,6 +24409,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf .PP /loader/credentials/ .RS 4 +\fBsystemd-pcrlock\fR(8), \fBsystemd-stub\fR(7) .RE .PP @@ -23569,6 +24603,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf .PP /proc/sys/kernel/random/boot_id .RS 4 +\fBorg.freedesktop.hostname1\fR(5), \fBsd_id128_get_machine\fR(3) .RE .PP @@ -23617,11 +24652,23 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf /run/ .RS 4 \fBbinfmt.d\fR(5), +\fBcoredump.conf\fR(5), \fBcrypttab\fR(5), \fBenvironment.d\fR(5), \fBfile-hierarchy\fR(7), +\fBhomed.conf\fR(5), +\fBiocost.conf\fR(5), +\fBjournal-remote.conf\fR(5), +\fBjournal-upload.conf\fR(5), +\fBjournald.conf\fR(5), +\fBlogind.conf\fR(5), \fBmodules-load.d\fR(5), +\fBnetworkctl\fR(1), +\fBnetworkd.conf\fR(5), +\fBoomd.conf\fR(5), \fBorg.freedesktop.systemd1\fR(5), +\fBpstore.conf\fR(5), +\fBresolved.conf\fR(5), \fBsd-login\fR(3), \fBsd_notify\fR(3), \fBsysctl.d\fR(5), @@ -23629,9 +24676,12 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-delta\fR(1), \fBsystemd-journald.service\fR(8), \fBsystemd-modules-load.service\fR(8), +\fBsystemd-mountfsd.service\fR(8), \fBsystemd-nspawn\fR(1), \fBsystemd-poweroff.service\fR(8), +\fBsystemd-sleep.conf\fR(5), \fBsystemd-soft-reboot.service\fR(8), +\fBsystemd-system.conf\fR(5), \fBsystemd-timedated.service\fR(8), \fBsystemd.dnssd\fR(5), \fBsystemd.environment-generator\fR(7), @@ -23643,6 +24693,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.preset\fR(5), \fBsystemd.service\fR(5), \fBsystemd.unit\fR(5), +\fBtimesyncd.conf\fR(5), \fBtmpfiles.d\fR(5), \fBudev\fR(7) .RE @@ -23652,6 +24703,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBbinfmt.d\fR(5) .RE .PP +/run/capsules/\fINAME\fR/ +.RS 4 +\fBcapsule@.service\fR(5) +.RE +.PP /run/confexts/ .RS 4 \fBsystemd-sysext\fR(8) @@ -23719,6 +24775,16 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.exec\fR(5) .RE .PP +/run/host/unix\-export/ +.RS 4 +\fBsystemd-ssh-generator\fR(8) +.RE +.PP +/run/host/unix\-export/ssh +.RS 4 +\fBsystemd-ssh-generator\fR(8) +.RE +.PP /run/host/userdb/ .RS 4 \fBnss-systemd\fR(8), @@ -23726,6 +24792,16 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBuserdbctl\fR(1) .RE .PP +/run/kernel/install\&.conf +.RS 4 +\fBkernel-install\fR(8) +.RE +.PP +/run/kernel/install\&.conf\&.d/*\&.conf +.RS 4 +\fBkernel-install\fR(8) +.RE +.PP /run/log/ .RS 4 \fBfile-hierarchy\fR(7), @@ -23804,6 +24880,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBtmpfiles.d\fR(5) .RE .PP +/run/ssh\-unix\-local/socket +.RS 4 +\fBsystemd-ssh-generator\fR(8) +.RE +.PP /run/sysctl\&.d/*\&.conf .RS 4 \fBsysctl.d\fR(5) @@ -23821,9 +24902,28 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf .PP /run/systemd/ .RS 4 +\fBcoredump.conf\fR(5), \fBcrypttab\fR(5), +\fBhomed.conf\fR(5), +\fBiocost.conf\fR(5), +\fBjournal-remote.conf\fR(5), +\fBjournal-upload.conf\fR(5), +\fBjournald.conf\fR(5), +\fBlogind.conf\fR(5), +\fBnetworkd.conf\fR(5), +\fBoomd.conf\fR(5), +\fBpstore.conf\fR(5), +\fBresolved.conf\fR(5), \fBsystemd-creds\fR(1), -\fBsystemd-cryptenroll\fR(1) +\fBsystemd-cryptenroll\fR(1), +\fBsystemd-sleep.conf\fR(5), +\fBsystemd-system.conf\fR(5), +\fBtimesyncd.conf\fR(5) +.RE +.PP +/run/systemd/coredump\&.conf +.RS 4 +\fBcoredump.conf\fR(5) .RE .PP /run/systemd/coredump\&.conf\&.d/*\&.conf @@ -23854,16 +24954,31 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.unit\fR(5) .RE .PP +/run/systemd/homed\&.conf +.RS 4 +\fBhomed.conf\fR(5) +.RE +.PP /run/systemd/homed\&.conf\&.d/*\&.conf .RS 4 \fBhomed.conf\fR(5) .RE .PP +/run/systemd/journal\-remote\&.conf +.RS 4 +\fBjournal-remote.conf\fR(5) +.RE +.PP /run/systemd/journal\-remote\&.conf\&.d/*\&.conf .RS 4 \fBjournal-remote.conf\fR(5) .RE .PP +/run/systemd/journal\-upload\&.conf +.RS 4 +\fBjournal-upload.conf\fR(5) +.RE +.PP /run/systemd/journal\-upload\&.conf\&.d/*\&.conf .RS 4 \fBjournal-upload.conf\fR(5) @@ -23889,6 +25004,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBjournald.conf\fR(5) .RE .PP +/run/systemd/journald\&.conf +.RS 4 +\fBjournald.conf\fR(5) +.RE +.PP /run/systemd/journald\&.conf\&.d/*\&.conf .RS 4 \fBjournald.conf\fR(5) @@ -23899,6 +25019,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBjournald.conf\fR(5) .RE .PP +/run/systemd/logind\&.conf +.RS 4 +\fBlogind.conf\fR(5) +.RE +.PP /run/systemd/logind\&.conf\&.d/*\&.conf .RS 4 \fBlogind.conf\fR(5) @@ -23913,6 +25038,16 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.network\fR(5) .RE .PP +/run/systemd/networkd\&.conf +.RS 4 +\fBnetworkd.conf\fR(5) +.RE +.PP +/run/systemd/networkd\&.conf\&.d/*\&.conf +.RS 4 +\fBnetworkd.conf\fR(5) +.RE +.PP /run/systemd/notify .RS 4 \fBsystemd\fR(1) @@ -23924,6 +25059,16 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.nspawn\fR(5) .RE .PP +/run/systemd/oomd\&.conf +.RS 4 +\fBoomd.conf\fR(5) +.RE +.PP +/run/systemd/oomd\&.conf\&.d/*\&.conf +.RS 4 +\fBoomd.conf\fR(5) +.RE +.PP /run/systemd/portables/ .RS 4 \fBportablectl\fR(1) @@ -23939,9 +25084,20 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.exec\fR(5) .RE .PP +/run/systemd/pstore\&.conf +.RS 4 +\fBpstore.conf\fR(5) +.RE +.PP +/run/systemd/pstore\&.conf\&.d/*\&.conf +.RS 4 +\fBpstore.conf\fR(5) +.RE +.PP /run/systemd/resolve/io\&.systemd\&.Resolve .RS 4 -\fBnss-resolve\fR(8) +\fBnss-resolve\fR(8), +\fBsystemd-resolved.service\fR(8) .RE .PP /run/systemd/resolve/resolv\&.conf @@ -23958,11 +25114,21 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-resolved.service\fR(8) .RE .PP +/run/systemd/resolved\&.conf +.RS 4 +\fBresolved.conf\fR(5) +.RE +.PP /run/systemd/resolved\&.conf\&.d/*\&.conf .RS 4 \fBresolved.conf\fR(5) .RE .PP +/run/systemd/sleep\&.conf +.RS 4 +\fBsystemd-sleep.conf\fR(5) +.RE +.PP /run/systemd/sleep\&.conf\&.d/*\&.conf .RS 4 \fBsystemd-sleep.conf\fR(5) @@ -23997,6 +25163,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.unit\fR(5) .RE .PP +/run/systemd/system\&.conf +.RS 4 +\fBsystemd-system.conf\fR(5) +.RE +.PP /run/systemd/system\&.conf\&.d/*\&.conf .RS 4 \fBsystemd-system.conf\fR(5) @@ -24018,6 +25189,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-timesyncd.service\fR(8) .RE .PP +/run/systemd/timesyncd\&.conf +.RS 4 +\fBtimesyncd.conf\fR(5) +.RE +.PP /run/systemd/timesyncd\&.conf\&.d/*\&.conf .RS 4 \fBtimesyncd.conf\fR(5) @@ -24084,6 +25260,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.preset\fR(5) .RE .PP +/run/systemd/user\&.conf +.RS 4 +\fBsystemd-system.conf\fR(5) +.RE +.PP /run/systemd/user\&.conf\&.d/*\&.conf .RS 4 \fBsystemd-system.conf\fR(5) @@ -24135,11 +25316,33 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBudev\fR(7) .RE .PP +/run/udev/rules\&.d/50\-foobar\&.rules +.RS 4 +\fBsystemd.system-credentials\fR(7), +\fBudevadm\fR(8) +.RE +.PP /run/udev/static_node\-tags/\fItag\fR .RS 4 \fBudev\fR(7) .RE .PP +/run/udev/udev\&.conf +.RS 4 +\fBudev.conf\fR(5) +.RE +.PP +/run/udev/udev\&.conf\&.d/*\&.conf +.RS 4 +\fBudev.conf\fR(5) +.RE +.PP +/run/udev/udev\&.conf\&.d/50\-foobar\&.conf +.RS 4 +\fBsystemd.system-credentials\fR(7), +\fBudevadm\fR(8) +.RE +.PP /run/user/ .RS 4 \fBfile-hierarchy\fR(7), @@ -24337,6 +25540,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-sleep.conf\fR(5) .RE .PP +/sys/power/mem_sleep +.RS 4 +\fBsystemd-sleep.conf\fR(5) +.RE +.PP /sys/power/resume .RS 4 \fBsystemd-hibernate-resume.service\fR(8) @@ -24385,9 +25593,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBcrypttab\fR(5), \fBfile-hierarchy\fR(7), \fBrepart.d\fR(5), +\fBsystemd-sysext\fR(8), \fBsystemd-system.conf\fR(5), \fBsystemd-tmpfiles\fR(8), \fBsystemd.exec\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.special\fR(7), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), @@ -24457,6 +25667,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf /usr/bin/ .RS 4 \fBfile-hierarchy\fR(7), +\fBorg.freedesktop.systemd1\fR(5), \fBsystemd.exec\fR(5), \fBsystemd.service\fR(5) .RE @@ -24473,6 +25684,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemctl\fR(1) .RE .PP +/usr/foo +.RS 4 +\fBsystemd-repart\fR(8) +.RE +.PP /usr/include/ .RS 4 \fBfile-hierarchy\fR(7) @@ -24497,6 +25713,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBmodules-load.d\fR(5), \fBsysctl.d\fR(5), \fBsystemd-delta\fR(1), +\fBsystemd-mountfsd.service\fR(8), \fBsystemd-timedated.service\fR(8), \fBsystemd.dnssd\fR(5), \fBsystemd.link\fR(5), @@ -24579,6 +25796,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBkernel-install\fR(8) .RE .PP +/usr/lib/kernel/install\&.conf\&.d/*\&.conf +.RS 4 +\fBkernel-install\fR(8) +.RE +.PP /usr/lib/kernel/install\&.d/ .RS 4 \fBkernel-install\fR(8) @@ -24706,6 +25928,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-stub\fR(7) .RE .PP +/usr/lib/systemd/coredump\&.conf +.RS 4 +\fBcoredump.conf\fR(5) +.RE +.PP /usr/lib/systemd/coredump\&.conf\&.d/*\&.conf .RS 4 \fBcoredump.conf\fR(5) @@ -24716,6 +25943,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.dnssd\fR(5) .RE .PP +/usr/lib/systemd/homed\&.conf +.RS 4 +\fBhomed.conf\fR(5) +.RE +.PP /usr/lib/systemd/homed\&.conf\&.d/*\&.conf .RS 4 \fBhomed.conf\fR(5) @@ -24723,20 +25955,35 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf .PP /usr/lib/systemd/import\-pubring\&.gpg .RS 4 -\fBmachinectl\fR(1), +\fBimportctl\fR(1), \fBsysupdate.d\fR(5) .RE .PP +/usr/lib/systemd/journal\-remote\&.conf +.RS 4 +\fBjournal-remote.conf\fR(5) +.RE +.PP /usr/lib/systemd/journal\-remote\&.conf\&.d/*\&.conf .RS 4 \fBjournal-remote.conf\fR(5) .RE .PP +/usr/lib/systemd/journal\-upload\&.conf +.RS 4 +\fBjournal-upload.conf\fR(5) +.RE +.PP /usr/lib/systemd/journal\-upload\&.conf\&.d/*\&.conf .RS 4 \fBjournal-upload.conf\fR(5) .RE .PP +/usr/lib/systemd/journald\&.conf +.RS 4 +\fBjournald.conf\fR(5) +.RE +.PP /usr/lib/systemd/journald\&.conf\&.d/*\&.conf .RS 4 \fBjournald.conf\fR(5) @@ -24749,6 +25996,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf .PP /usr/lib/systemd/logind\&.conf .RS 4 +\fBlogind.conf\fR(5), \fBsystemd-analyze\fR(1) .RE .PP @@ -24780,6 +26028,16 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-nspawn\fR(1) .RE .PP +/usr/lib/systemd/network/80\-vm\-vt\&.network +.RS 4 +\fBsystemd-vmspawn\fR(1) +.RE +.PP +/usr/lib/systemd/networkd\&.conf +.RS 4 +\fBnetworkd.conf\fR(5) +.RE +.PP /usr/lib/systemd/networkd\&.conf\&.d/*\&.conf .RS 4 \fBnetworkd.conf\fR(5) @@ -24790,6 +26048,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-timedated.service\fR(8) .RE .PP +/usr/lib/systemd/oomd\&.conf +.RS 4 +\fBoomd.conf\fR(5) +.RE +.PP /usr/lib/systemd/oomd\&.conf\&.d/*\&.conf .RS 4 \fBoomd.conf\fR(5) @@ -24805,17 +26068,37 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBportablectl\fR(1) .RE .PP +/usr/lib/systemd/pstore\&.conf +.RS 4 +\fBpstore.conf\fR(5) +.RE +.PP +/usr/lib/systemd/pstore\&.conf\&.d/*\&.conf +.RS 4 +\fBpstore.conf\fR(5) +.RE +.PP /usr/lib/systemd/resolv\&.conf .RS 4 \fBsystemd-nspawn\fR(1), \fBsystemd-resolved.service\fR(8) .RE .PP +/usr/lib/systemd/resolved\&.conf +.RS 4 +\fBresolved.conf\fR(5) +.RE +.PP /usr/lib/systemd/resolved\&.conf\&.d/*\&.conf .RS 4 \fBresolved.conf\fR(5) .RE .PP +/usr/lib/systemd/sleep\&.conf +.RS 4 +\fBsystemd-sleep.conf\fR(5) +.RE +.PP /usr/lib/systemd/sleep\&.conf\&.d/*\&.conf .RS 4 \fBsystemd-sleep.conf\fR(5) @@ -24898,6 +26181,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-run-generator\fR(8) .RE .PP +/usr/lib/systemd/system\-generators/systemd\-ssh\-generator +.RS 4 +\fBsystemd-ssh-generator\fR(8) +.RE +.PP /usr/lib/systemd/system\-generators/systemd\-system\-update\-generator .RS 4 \fBsystemd-system-update-generator\fR(8) @@ -24908,6 +26196,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-sysv-generator\fR(8) .RE .PP +/usr/lib/systemd/system\-generators/systemd\-tpm2\-generator +.RS 4 +\fBsystemd-tpm2-generator\fR(8) +.RE +.PP /usr/lib/systemd/system\-generators/systemd\-veritysetup\-generator .RS 4 \fBsystemd-veritysetup-generator\fR(8) @@ -24934,6 +26227,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-suspend.service\fR(8) .RE .PP +/usr/lib/systemd/system\&.conf +.RS 4 +\fBsystemd-system.conf\fR(5) +.RE +.PP /usr/lib/systemd/system\&.conf\&.d/*\&.conf .RS 4 \fBsystemd-system.conf\fR(5) @@ -24969,6 +26267,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-bless-boot.service\fR(8) .RE .PP +\fB/usr/lib/systemd/systemd\-bsod\fR +.RS 4 +\fBsystemd-bsod.service\fR(8) +.RE +.PP /usr/lib/systemd/systemd\-coredump .RS 4 \fBsystemd-coredump\fR(8) @@ -25064,6 +26367,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-modules-load.service\fR(8) .RE .PP +/usr/lib/systemd/systemd\-mountfsd +.RS 4 +\fBsystemd-mountfsd.service\fR(8) +.RE +.PP /usr/lib/systemd/systemd\-network\-generator .RS 4 \fBsystemd-network-generator.service\fR(8) @@ -25079,6 +26387,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-networkd-wait-online.service\fR(8) .RE .PP +/usr/lib/systemd/systemd\-nsresourced +.RS 4 +\fBsystemd-nsresourced.service\fR(8) +.RE +.PP /usr/lib/systemd/systemd\-oomd .RS 4 \fBsystemd-oomd.service\fR(8) @@ -25135,6 +26448,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-poweroff.service\fR(8) .RE .PP +\fB/usr/lib/systemd/systemd\-ssh\-proxy\fR +.RS 4 +\fBsystemd-ssh-proxy\fR(1) +.RE +.PP \fB/usr/lib/systemd/systemd\-storagetm\fR .RS 4 \fBsystemd-storagetm.service\fR(8) @@ -25210,6 +26528,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-volatile-root.service\fR(8) .RE .PP +/usr/lib/systemd/timesyncd\&.conf +.RS 4 +\fBtimesyncd.conf\fR(5) +.RE +.PP /usr/lib/systemd/timesyncd\&.conf\&.d/*\&.conf .RS 4 \fBtimesyncd.conf\fR(5) @@ -25255,6 +26578,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd.preset\fR(5) .RE .PP +/usr/lib/systemd/user\&.conf +.RS 4 +\fBsystemd-system.conf\fR(5) +.RE +.PP /usr/lib/systemd/user\&.conf\&.d/*\&.conf .RS 4 \fBsystemd-system.conf\fR(5) @@ -25336,6 +26664,16 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBudev\fR(7) .RE .PP +/usr/lib/udev/udev\&.conf +.RS 4 +\fBudev.conf\fR(5) +.RE +.PP +/usr/lib/udev/udev\&.conf\&.d/*\&.conf +.RS 4 +\fBudev.conf\fR(5) +.RE +.PP /usr/lib/userdb/ .RS 4 \fBnss-systemd\fR(8), @@ -25374,6 +26712,16 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-sysext\fR(8) .RE .PP +/usr/local/lib/kernel/install\&.conf +.RS 4 +\fBkernel-install\fR(8) +.RE +.PP +/usr/local/lib/kernel/install\&.conf\&.d/*\&.conf +.RS 4 +\fBkernel-install\fR(8) +.RE +.PP /usr/local/lib/machines/ .RS 4 \fBmachinectl\fR(1) @@ -25384,6 +26732,24 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBportablectl\fR(1) .RE .PP +/usr/local/lib/systemd/ +.RS 4 +\fBcoredump.conf\fR(5), +\fBhomed.conf\fR(5), +\fBiocost.conf\fR(5), +\fBjournal-remote.conf\fR(5), +\fBjournal-upload.conf\fR(5), +\fBjournald.conf\fR(5), +\fBlogind.conf\fR(5), +\fBnetworkd.conf\fR(5), +\fBoomd.conf\fR(5), +\fBpstore.conf\fR(5), +\fBresolved.conf\fR(5), +\fBsystemd-sleep.conf\fR(5), +\fBsystemd-system.conf\fR(5), +\fBtimesyncd.conf\fR(5) +.RE +.PP /usr/local/lib/systemd/*\&.conf\&.d/ .RS 4 \fBcoredump.conf\fR(5), @@ -25488,6 +26854,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf /usr/sbin/ .RS 4 \fBfile-hierarchy\fR(7), +\fBorg.freedesktop.systemd1\fR(5), \fBsystemd.exec\fR(5) .RE .PP @@ -25543,6 +26910,16 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBtmpfiles.d\fR(5) .RE .PP +/usr/share/wayland\-sessions +.RS 4 +\fBhomectl\fR(1) +.RE +.PP +/usr/share/xesssions/ +.RS 4 +\fBhomectl\fR(1) +.RE +.PP /usr/share/zoneinfo/ .RS 4 \fBlocaltime\fR(5) @@ -25617,8 +26994,15 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBtmpfiles.d\fR(5) .RE .PP +/var/lib/capsules/ +.RS 4 +\fBcapsule@.service\fR(5) +.RE +.PP /var/lib/confexts/ .RS 4 +\fBimportctl\fR(1), +\fBsystemd-mountfsd.service\fR(8), \fBsystemd-sysext\fR(8) .RE .PP @@ -25634,15 +27018,39 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf .PP /var/lib/extensions/ .RS 4 +\fBimportctl\fR(1), \fBsystemd-dissect\fR(1), +\fBsystemd-mountfsd.service\fR(8), +\fBsystemd-sysext\fR(8) +.RE +.PP +/var/lib/extensions\&.mutable/ +.RS 4 +\fBsystemd-sysext\fR(8) +.RE +.PP +/var/lib/extensions\&.mutable/etc/ +.RS 4 +\fBsystemd-sysext\fR(8) +.RE +.PP +/var/lib/extensions\&.mutable/opt/ +.RS 4 +\fBsystemd-sysext\fR(8) +.RE +.PP +/var/lib/extensions\&.mutable/usr/ +.RS 4 \fBsystemd-sysext\fR(8) .RE .PP /var/lib/machines/ .RS 4 +\fBimportctl\fR(1), \fBmachinectl\fR(1), \fBorg.freedesktop.import1\fR(5), \fBsystemd-dissect\fR(1), +\fBsystemd-mountfsd.service\fR(8), \fBsystemd-nspawn\fR(1), \fBsystemd.nspawn\fR(5), \fBtmpfiles.d\fR(5) @@ -25658,6 +27066,26 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsysupdate.d\fR(5) .RE .PP +/var/lib/machines/mymachine\&.raw\&.v/ +.RS 4 +\fBsystemd.v\fR(7) +.RE +.PP +/var/lib/machines/mymachine\&.raw\&.v/mymachine_7\&.5\&.14_x86\-64\&.raw +.RS 4 +\fBsystemd.v\fR(7) +.RE +.PP +/var/lib/machines/quux\&.raw\&.v/quux*\&.raw +.RS 4 +\fBsystemd-vpick\fR(1) +.RE +.PP +/var/lib/machines/waldo\&.v/waldo +.RS 4 +\fBsystemd-vpick\fR(1) +.RE +.PP /var/lib/pcrlock\&.d/ .RS 4 \fBsystemd-pcrlock\fR(8) @@ -25735,8 +27163,10 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf .PP /var/lib/portables/ .RS 4 +\fBimportctl\fR(1), \fBportablectl\fR(1), -\fBsystemd-dissect\fR(1) +\fBsystemd-dissect\fR(1), +\fBsystemd-mountfsd.service\fR(8) .RE .PP /var/lib/private @@ -25910,6 +27340,7 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-nspawn\fR(1), \fBsystemd-system.conf\fR(5), \fBsystemd.exec\fR(5), +\fBsystemd.link\fR(5), \fBsystemd.special\fR(7), \fBsystemd.unit\fR(5), \fBsysupdate.d\fR(5), @@ -25922,6 +27353,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-stub\fR(7) .RE .PP +\fIESP\fR/\&.\&.\&./\fIfoo\fR\&.efi\&.extra\&.d/*\&.confext\&.raw +.RS 4 +\fBsystemd-stub\fR(7) +.RE +.PP \fIESP\fR/\&.\&.\&./\fIfoo\fR\&.efi\&.extra\&.d/*\&.cred .RS 4 \fBsystemd-stub\fR(7) @@ -25932,6 +27368,11 @@ $XDG_RUNTIME_DIR/user\-tmpfiles\&.d/*\&.conf \fBsystemd-stub\fR(7) .RE .PP +\fIESP\fR/\&.\&.\&./\fIfoo\fR\&.efi\&.extra\&.d/*\&.sysext\&.raw +.RS 4 +\fBsystemd-stub\fR(7) +.RE +.PP \fIESP\fR/loader/addons/*\&.addon\&.efi .RS 4 \fBsystemd-stub\fR(7) @@ -25993,6 +27434,16 @@ boot\-complete\&.target \fBbusctl\fR(1) .RE .PP +capsule\&.slice +.RS 4 +\fBsystemd.special\fR(7) +.RE +.PP +capsule@\fINAME\fR\&.service +.RS 4 +\fBcapsule@.service\fR(5) +.RE +.PP \fBcoredumpctl\fR .RS 4 \fBcoredumpctl\fR(1) @@ -26109,6 +27560,11 @@ hybrid\-sleep\&.target \fBsystemd.special\fR(7) .RE .PP +\fBimportctl\fR +.RS 4 +\fBimportctl\fR(1) +.RE +.PP \fBinit\fR .RS 4 \fBsystemd\fR(1) @@ -26408,6 +27864,11 @@ rpcbind\&.target \fBsystemd.special\fR(7) .RE .PP +\fBrun0\fR +.RS 4 +\fBrun0\fR(1) +.RE +.PP \fBrunlevel\fR .RS 4 \fBrunlevel\fR(8) @@ -26511,6 +27972,11 @@ sound\&.target \fBsystemd.special\fR(7) .RE .PP +ssh\-access\&.target +.RS 4 +\fBsystemd.special\fR(7) +.RE +.PP storage\-target\-mode\&.target .RS 4 \fBsystemd.special\fR(7) @@ -26645,11 +28111,6 @@ systemd\-boot\-random\-seed\&.service \fBsystemd-boot-random-seed.service\fR(8) .RE .PP -\fBsystemd\-bsod\fR -.RS 4 -\fBsystemd-bsod.service\fR(8) -.RE -.PP systemd\-bsod\&.service .RS 4 \fBsystemd-bsod.service\fR(8) @@ -26770,6 +28231,11 @@ systemd\-halt\&.service \fBsystemd-poweroff.service\fR(8) .RE .PP +systemd\-hibernate\-clear\&.service +.RS 4 +\fBsystemd-hibernate-resume.service\fR(8) +.RE +.PP systemd\-hibernate\-resume\&.service .RS 4 \fBsystemd-hibernate-resume.service\fR(8) @@ -26940,6 +28406,11 @@ systemd\-modules\-load\&.service \fBsystemd-mount\fR(1) .RE .PP +systemd\-mountfsd\&.service +.RS 4 +\fBsystemd-mountfsd.service\fR(8) +.RE +.PP systemd\-network\-generator\&.service .RS 4 \fBsystemd-network-generator.service\fR(8) @@ -26970,6 +28441,11 @@ systemd\-networkd\&.service \fBsystemd-nspawn\fR(1) .RE .PP +systemd\-nsresourced\&.service +.RS 4 +\fBsystemd-nsresourced.service\fR(8) +.RE +.PP systemd\-oomd\&.service .RS 4 \fBsystemd-oomd.service\fR(8) @@ -27265,6 +28741,11 @@ systemd\-volatile\-root\&.service \fBsystemd-volatile-root.service\fR(8) .RE .PP +\fBsystemd\-vpick\fR +.RS 4 +\fBsystemd-vpick\fR(1) +.RE +.PP \fItarget\fR\&.target .RS 4 \fBsystemd.target\fR(5), @@ -27302,6 +28783,11 @@ timers\&.target \fBsystemd.special\fR(7) .RE .PP +tpm2\&.target +.RS 4 +\fBsystemd.special\fR(7) +.RE +.PP \fBudevadm\fR .RS 4 \fBudevadm\fR(8) @@ -27624,6 +29110,16 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.home1\fR(5) .RE .PP +\fIActivateHomeIfReferenced()\fR +.RS 4 +\fBorg.freedesktop.home1\fR(5) +.RE +.PP +\fIActivateIfReferenced()\fR +.RS 4 +\fBorg.freedesktop.home1\fR(5) +.RE +.PP \fIActivateSession()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) @@ -27745,6 +29241,11 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.login1\fR(5) .RE .PP +\fICanSleep()\fR +.RS 4 +\fBorg.freedesktop.login1\fR(5) +.RE +.PP \fICanSuspend()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) @@ -27856,6 +29357,11 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.home1\fR(5) .RE .PP +\fICreateHomeEx()\fR +.RS 4 +\fBorg.freedesktop.home1\fR(5) +.RE +.PP \fICreateMachine()\fR .RS 4 \fBorg.freedesktop.machine1\fR(5) @@ -28003,11 +29509,21 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.import1\fR(5) .RE .PP +\fIExportRawEx()\fR +.RS 4 +\fBorg.freedesktop.import1\fR(5) +.RE +.PP \fIExportTar()\fR .RS 4 \fBorg.freedesktop.import1\fR(5) .RE .PP +\fIExportTarEx()\fR +.RS 4 +\fBorg.freedesktop.import1\fR(5) +.RE +.PP \fIFixate()\fR .RS 4 \fBorg.freedesktop.home1\fR(5) @@ -28185,6 +29701,11 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.machine1\fR(5) .RE .PP +\fIGetMachineSSHInfo()\fR +.RS 4 +\fBorg.freedesktop.machine1\fR(5) +.RE +.PP \fIGetMachineUIDShift()\fR .RS 4 \fBorg.freedesktop.machine1\fR(5) @@ -28216,6 +29737,11 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.hostname1\fR(5) .RE .PP +\fIGetSSHInfo()\fR +.RS 4 +\fBorg.freedesktop.machine1\fR(5) +.RE +.PP \fIGetSeat()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) @@ -28342,16 +29868,31 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.import1\fR(5) .RE .PP +\fIImportFileSystemEx()\fR +.RS 4 +\fBorg.freedesktop.import1\fR(5) +.RE +.PP \fIImportRaw()\fR .RS 4 \fBorg.freedesktop.import1\fR(5) .RE .PP +\fIImportRawEx()\fR +.RS 4 +\fBorg.freedesktop.import1\fR(5) +.RE +.PP \fIImportTar()\fR .RS 4 \fBorg.freedesktop.import1\fR(5) .RE .PP +\fIImportTarEx()\fR +.RS 4 +\fBorg.freedesktop.import1\fR(5) +.RE +.PP \fIInhibit()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) @@ -28401,6 +29942,7 @@ Methods exposed in the D\-Bus interface\&. .PP \fIListImages()\fR .RS 4 +\fBorg.freedesktop.import1\fR(5), \fBorg.freedesktop.machine1\fR(5), \fBorg.freedesktop.portable1\fR(5) .RE @@ -28435,6 +29977,11 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.login1\fR(5) .RE .PP +\fIListSessionsEx()\fR +.RS 4 +\fBorg.freedesktop.login1\fR(5) +.RE +.PP \fIListTimezones()\fR .RS 4 \fBorg.freedesktop.timedate1\fR(5) @@ -28445,6 +29992,11 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.import1\fR(5) .RE .PP +\fIListTransfersEx()\fR +.RS 4 +\fBorg.freedesktop.import1\fR(5) +.RE +.PP \fIListUnitFiles()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) @@ -28643,11 +30195,21 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.import1\fR(5) .RE .PP +\fIPullRawEx()\fR +.RS 4 +\fBorg.freedesktop.import1\fR(5) +.RE +.PP \fIPullTar()\fR .RS 4 \fBorg.freedesktop.import1\fR(5) .RE .PP +\fIPullTarEx()\fR +.RS 4 +\fBorg.freedesktop.import1\fR(5) +.RE +.PP \fIQueueSignal()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) @@ -28735,11 +30297,21 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.home1\fR(5) .RE .PP +\fIRefHomeUnrestricted()\fR +.RS 4 +\fBorg.freedesktop.home1\fR(5) +.RE +.PP \fIRefUnit()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) .RE .PP +\fIRefUnrestricted()\fR +.RS 4 +\fBorg.freedesktop.home1\fR(5) +.RE +.PP \fIRegisterHome()\fR .RS 4 \fBorg.freedesktop.home1\fR(5) @@ -28958,6 +30530,11 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.hostname1\fR(5) .RE .PP +\fISetClass()\fR +.RS 4 +\fBorg.freedesktop.login1\fR(5) +.RE +.PP \fISetDNS()\fR .RS 4 \fBorg.freedesktop.network1\fR(5), @@ -29239,6 +30816,11 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.locale1\fR(5) .RE .PP +\fISleep()\fR +.RS 4 +\fBorg.freedesktop.login1\fR(5) +.RE +.PP \fISoftReboot()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) @@ -29249,6 +30831,11 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.systemd1\fR(5) .RE .PP +\fIStartAuxiliaryScope()\fR +.RS 4 +\fBorg.freedesktop.systemd1\fR(5) +.RE +.PP \fIStartTransientUnit()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) @@ -29456,10 +31043,20 @@ Methods exposed in the D\-Bus interface\&. \fBorg.freedesktop.home1\fR(5) .RE .PP +\fIUpdateEx()\fR +.RS 4 +\fBorg.freedesktop.home1\fR(5) +.RE +.PP \fIUpdateHome()\fR .RS 4 \fBorg.freedesktop.home1\fR(5) .RE +.PP +\fIUpdateHomeEx()\fR +.RS 4 +\fBorg.freedesktop.home1\fR(5) +.RE .SH "D\-BUS PROPERTIES" .PP Properties exposed in the D\-Bus interface\&. @@ -30381,11 +31978,26 @@ Properties exposed in the D\-Bus interface\&. \fBorg.freedesktop.systemd1\fR(5) .RE .PP +\fIEffectiveMemoryHigh\fR +.RS 4 +\fBorg.freedesktop.systemd1\fR(5) +.RE +.PP +\fIEffectiveMemoryMax\fR +.RS 4 +\fBorg.freedesktop.systemd1\fR(5) +.RE +.PP \fIEffectiveMemoryNodes\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) .RE .PP +\fIEffectiveTasksMax\fR +.RS 4 +\fBorg.freedesktop.systemd1\fR(5) +.RE +.PP \fIEnableWallMessages\fR .RS 4 \fBorg.freedesktop.login1\fR(5) @@ -30436,6 +32048,16 @@ Properties exposed in the D\-Bus interface\&. \fBorg.freedesktop.systemd1\fR(5) .RE .PP +\fIExecMainHandoffTimestamp\fR +.RS 4 +\fBorg.freedesktop.systemd1\fR(5) +.RE +.PP +\fIExecMainHandoffTimestampMonotonic\fR +.RS 4 +\fBorg.freedesktop.systemd1\fR(5) +.RE +.PP \fIExecMainPID\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) @@ -31738,6 +33360,11 @@ Properties exposed in the D\-Bus interface\&. \fBorg.freedesktop.systemd1\fR(5) .RE .PP +\fIMemoryZSwapWriteback\fR +.RS 4 +\fBorg.freedesktop.systemd1\fR(5) +.RE +.PP \fIMessageQueueMaxMessages\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) @@ -31885,6 +33512,11 @@ Properties exposed in the D\-Bus interface\&. \fBorg.freedesktop.network1\fR(5) .RE .PP +\fINamespaceNSID\fR +.RS 4 +\fBorg.freedesktop.network1\fR(5) +.RE +.PP \fINeedDaemonReload\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) @@ -32055,6 +33687,11 @@ Properties exposed in the D\-Bus interface\&. \fBorg.freedesktop.systemd1\fR(5) .RE .PP +\fIPassFileDescriptorsToExec\fR +.RS 4 +\fBorg.freedesktop.systemd1\fR(5) +.RE +.PP \fIPassPacketInfo\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) @@ -32612,6 +34249,16 @@ Properties exposed in the D\-Bus interface\&. \fBorg.freedesktop.systemd1\fR(5) .RE .PP +\fISSHAddress\fR +.RS 4 +\fBorg.freedesktop.machine1\fR(5) +.RE +.PP +\fISSHPrivateKeyPath\fR +.RS 4 +\fBorg.freedesktop.machine1\fR(5) +.RE +.PP \fISameProcessGroup\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) @@ -32718,6 +34365,21 @@ Properties exposed in the D\-Bus interface\&. \fBorg.freedesktop.systemd1\fR(5) .RE .PP +\fIShutdownStartTimestamp\fR +.RS 4 +\fBorg.freedesktop.systemd1\fR(5) +.RE +.PP +\fIShutdownStartTimestampMonotonic\fR +.RS 4 +\fBorg.freedesktop.systemd1\fR(5) +.RE +.PP +\fISleepOperation\fR +.RS 4 +\fBorg.freedesktop.login1\fR(5) +.RE +.PP \fISlice\fR .RS 4 \fBorg.freedesktop.login1\fR(5), @@ -32784,6 +34446,11 @@ Properties exposed in the D\-Bus interface\&. \fBorg.freedesktop.systemd1\fR(5) .RE .PP +\fISoftRebootsCount\fR +.RS 4 +\fBorg.freedesktop.systemd1\fR(5) +.RE +.PP \fISourcePath\fR .RS 4 \fBorg.freedesktop.network1\fR(5), @@ -33394,6 +35061,12 @@ Properties exposed in the D\-Bus interface\&. \fBorg.freedesktop.locale1\fR(5) .RE .PP +\fIVSockCID\fR +.RS 4 +\fBorg.freedesktop.hostname1\fR(5), +\fBorg.freedesktop.machine1\fR(5) +.RE +.PP \fIVTNr\fR .RS 4 \fBorg.freedesktop.login1\fR(5) @@ -33434,6 +35107,11 @@ Properties exposed in the D\-Bus interface\&. \fBorg.freedesktop.systemd1\fR(5) .RE .PP +\fIWantsMountsFor\fR +.RS 4 +\fBorg.freedesktop.systemd1\fR(5) +.RE +.PP \fIWatchdogDevice\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) @@ -33512,140 +35190,145 @@ Properties exposed in the D\-Bus interface\&. .PP Signals emitted in the D\-Bus interface\&. .PP -\fIJobNew\fR +\fIJobNew()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) .RE .PP -\fIJobRemoved\fR +\fIJobRemoved()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) .RE .PP -\fIKilled\fR +\fIKilled()\fR .RS 4 \fBorg.freedesktop.oom1\fR(5) .RE .PP -\fILock\fR +\fILock()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .PP -\fILogMessage\fR +\fILogMessage()\fR .RS 4 \fBorg.freedesktop.import1\fR(5) .RE .PP -\fIMachineNew\fR +\fIMachineNew()\fR .RS 4 \fBorg.freedesktop.machine1\fR(5) .RE .PP -\fIMachineRemoved\fR +\fIMachineRemoved()\fR .RS 4 \fBorg.freedesktop.machine1\fR(5) .RE .PP -\fIPauseDevice\fR +\fIPauseDevice()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .PP -\fIPrepareForShutdown\fR +\fIPrepareForShutdown()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .PP -\fIPrepareForShutdownWithMetadata\fR +\fIPrepareForShutdownWithMetadata()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .PP -\fIPrepareForSleep\fR +\fIPrepareForSleep()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .PP -\fIReloading\fR +\fIProgressUpdate()\fR +.RS 4 +\fBorg.freedesktop.import1\fR(5) +.RE +.PP +\fIReloading()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) .RE .PP -\fIRequestStop\fR +\fIRequestStop()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) .RE .PP -\fIResumeDevice\fR +\fIResumeDevice()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .PP -\fISeatNew\fR +\fISeatNew()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .PP -\fISeatRemoved\fR +\fISeatRemoved()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .PP -\fISessionNew\fR +\fISessionNew()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .PP -\fISessionRemoved\fR +\fISessionRemoved()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .PP -\fIStartupFinished\fR +\fIStartupFinished()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) .RE .PP -\fITransferNew\fR +\fITransferNew()\fR .RS 4 \fBorg.freedesktop.import1\fR(5) .RE .PP -\fITransferRemoved\fR +\fITransferRemoved()\fR .RS 4 \fBorg.freedesktop.import1\fR(5) .RE .PP -\fIUnitFilesChanged\fR +\fIUnitFilesChanged()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) .RE .PP -\fIUnitNew\fR +\fIUnitNew()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) .RE .PP -\fIUnitRemoved\fR +\fIUnitRemoved()\fR .RS 4 \fBorg.freedesktop.systemd1\fR(5) .RE .PP -\fIUnlock\fR +\fIUnlock()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .PP -\fIUserNew\fR +\fIUserNew()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .PP -\fIUserRemoved\fR +\fIUserRemoved()\fR .RS 4 \fBorg.freedesktop.login1\fR(5) .RE .SH "COLOPHON" .PP -This index contains 6005 entries in 24 sections, referring to 394 individual manual pages\&. +This index contains 6282 entries in 24 sections, referring to 404 individual manual pages\&. diff --git a/upstream/fedora-rawhide/man7/systemd.environment-generator.7 b/upstream/fedora-rawhide/man7/systemd.environment-generator.7 index 604a8d8b..42c3a918 100644 --- a/upstream/fedora-rawhide/man7/systemd.environment-generator.7 +++ b/upstream/fedora-rawhide/man7/systemd.environment-generator.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.ENVIRONMENT\-GENERATOR" "7" "" "systemd 255" "systemd.environment-generator" +.TH "SYSTEMD\&.ENVIRONMENT\-GENERATOR" "7" "" "systemd 256~rc3" "systemd.environment-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -27,20 +27,31 @@ systemd.environment-generator \- systemd environment file generators .HP \w'\fB/usr/lib/systemd/user\-environment\-generators/some\-generator\fR\ 'u \fB/usr/lib/systemd/user\-environment\-generators/some\-generator\fR .PP -.nf +.RS 4 /run/systemd/system\-environment\-generators/* +.RE +.RS 4 /etc/systemd/system\-environment\-generators/* +.RE +.RS 4 /usr/local/lib/systemd/system\-environment\-generators/* +.RE +.RS 4 /usr/lib/systemd/system\-environment\-generators/* -.fi +.RE .PP -.nf +.RS 4 /run/systemd/user\-environment\-generators/* +.RE +.RS 4 /etc/systemd/user\-environment\-generators/* +.RE +.RS 4 /usr/local/lib/systemd/user\-environment\-generators/* +.RE +.RS 4 /usr/lib/systemd/user\-environment\-generators/* -.fi -.sp +.RE .SH "DESCRIPTION" .PP Generators are small executables that live in @@ -187,7 +198,4 @@ SYSTEMD_LOG_LEVEL=debug VAR_A=something VAR_B="something else" \e .\} .SH "SEE ALSO" .PP -\fBsystemd-environment-d-generator\fR(8), -\fBsystemd.generator\fR(7), -\fBsystemd\fR(1), -\fBsystemctl\fR(1) +\fBsystemd-environment-d-generator\fR(8), \fBsystemd.generator\fR(7), \fBsystemd\fR(1), \fBsystemctl\fR(1) diff --git a/upstream/fedora-rawhide/man7/systemd.generator.7 b/upstream/fedora-rawhide/man7/systemd.generator.7 index 3e7f3aaa..5538abb0 100644 --- a/upstream/fedora-rawhide/man7/systemd.generator.7 +++ b/upstream/fedora-rawhide/man7/systemd.generator.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.GENERATOR" "7" "" "systemd 255" "systemd.generator" +.TH "SYSTEMD\&.GENERATOR" "7" "" "systemd 256~rc3" "systemd.generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -25,20 +25,31 @@ systemd.generator \- systemd unit generators .HP \w'\fB/path/to/generator\fR\ 'u \fB/path/to/generator\fR \fInormal\-dir\fR [\fIearly\-dir\fR] [\fIlate\-dir\fR] .PP -.nf +.RS 4 /run/systemd/system\-generators/* +.RE +.RS 4 /etc/systemd/system\-generators/* +.RE +.RS 4 /usr/local/lib/systemd/system\-generators/* +.RE +.RS 4 /usr/lib/systemd/system\-generators/* -.fi +.RE .PP -.nf +.RS 4 /run/systemd/user\-generators/* +.RE +.RS 4 /etc/systemd/user\-generators/* +.RE +.RS 4 /usr/local/lib/systemd/user\-generators/* +.RE +.RS 4 /usr/lib/systemd/user\-generators/* -.fi -.sp +.RE .SH "DESCRIPTION" .PP Generators are small executables placed in @@ -460,18 +471,4 @@ find $dir .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-cryptsetup-generator\fR(8), -\fBsystemd-debug-generator\fR(8), -\fBsystemd-fstab-generator\fR(8), -\fBfstab\fR(5), -\fBsystemd-getty-generator\fR(8), -\fBsystemd-gpt-auto-generator\fR(8), -\fBsystemd-hibernate-resume-generator\fR(8), -\fBsystemd-rc-local-generator\fR(8), -\fBsystemd-system-update-generator\fR(8), -\fBsystemd-sysv-generator\fR(8), -\fBsystemd-xdg-autostart-generator\fR(8), -\fBsystemd.unit\fR(5), -\fBsystemctl\fR(1), -\fBsystemd.environment-generator\fR(7) +\fBsystemd\fR(1), \fBsystemd-cryptsetup-generator\fR(8), \fBsystemd-debug-generator\fR(8), \fBsystemd-fstab-generator\fR(8), \fBfstab\fR(5), \fBsystemd-getty-generator\fR(8), \fBsystemd-gpt-auto-generator\fR(8), \fBsystemd-hibernate-resume-generator\fR(8), \fBsystemd-rc-local-generator\fR(8), \fBsystemd-system-update-generator\fR(8), \fBsystemd-sysv-generator\fR(8), \fBsystemd-xdg-autostart-generator\fR(8), \fBsystemd.unit\fR(5), \fBsystemctl\fR(1), \fBsystemd.environment-generator\fR(7) diff --git a/upstream/fedora-rawhide/man7/systemd.image-policy.7 b/upstream/fedora-rawhide/man7/systemd.image-policy.7 index 8927360a..98ba64c0 100644 --- a/upstream/fedora-rawhide/man7/systemd.image-policy.7 +++ b/upstream/fedora-rawhide/man7/systemd.image-policy.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.IMAGE\-POLICY" "7" "" "systemd 255" "systemd.image-policy" +.TH "SYSTEMD\&.IMAGE\-POLICY" "7" "" "systemd 256~rc3" "systemd.image-policy" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -289,11 +289,7 @@ root=unprotected+encrypted:swap=absent+unused:=unprotected+encrypted+absent .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-dissect\fR(1), -\fBsystemd-gpt-auto-generator\fR(8), -\fBsystemd-sysext\fR(8), -\fBsystemd-analyze\fR(8) +\fBsystemd\fR(1), \fBsystemd-dissect\fR(1), \fBsystemd-gpt-auto-generator\fR(8), \fBsystemd-sysext\fR(8), \fBsystemd-analyze\fR(8) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man7/systemd.index.7 b/upstream/fedora-rawhide/man7/systemd.index.7 index b7ef4060..88b7b8cf 100644 --- a/upstream/fedora-rawhide/man7/systemd.index.7 +++ b/upstream/fedora-rawhide/man7/systemd.index.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.INDEX" "7" "" "systemd 255" "systemd.index" +.TH "SYSTEMD\&.INDEX" "7" "" "systemd 256~rc3" "systemd.index" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -44,6 +44,9 @@ systemd.index \- List all manpages from the systemd project .SH "C" .PP +\fBcapsule@.service\fR(5) +\(em System unit for the capsule service manager +.br \fBcoredump.conf\fR(5) \(em Core dump storage configuration files .br @@ -107,6 +110,9 @@ systemd.index \- List all manpages from the systemd project .SH "I" .PP +\fBimportctl\fR(1) +\(em Download, import or export disk images +.br \fBinit\fR(1) \(em systemd system and service manager .br @@ -350,6 +356,9 @@ systemd.index \- List all manpages from the systemd project \fBresolved.conf.d\fR(5) \(em Network Name Resolution configuration files .br +\fBrun0\fR(1) +\(em Elevate privileges +.br \fBrunlevel\fR(8) \(em Print previous and current SysV runlevel .br @@ -503,6 +512,9 @@ systemd.index \- List all manpages from the systemd project \fBsd_bus_creds_get_pid\fR(3) \(em Retrieve fields from a credentials object .br +\fBsd_bus_creds_get_pidfd_dup\fR(3) +\(em Retrieve fields from a credentials object +.br \fBsd_bus_creds_get_ppid\fR(3) \(em Retrieve fields from a credentials object .br @@ -566,6 +578,9 @@ systemd.index \- List all manpages from the systemd project \fBsd_bus_creds_new_from_pid\fR(3) \(em Retrieve credentials object for the specified PID .br +\fBsd_bus_creds_new_from_pidfd\fR(3) +\(em Retrieve credentials object for the specified PID +.br \fBsd_bus_creds_ref\fR(3) \(em Retrieve credentials object for the specified PID .br @@ -1733,6 +1748,9 @@ systemd.index \- List all manpages from the systemd project \fBsd_event_source_get_inotify_mask\fR(3) \(em Add an "inotify" file system inode event source to an event loop .br +\fBsd_event_source_get_inotify_path\fR(3) +\(em Add an "inotify" file system inode event source to an event loop +.br \fBsd_event_source_get_io_events\fR(3) \(em Add an I/O event source to an event loop .br @@ -2240,6 +2258,9 @@ systemd.index \- List all manpages from the systemd project \fBsd_journal_stream_fd\fR(3) \(em Create log stream file descriptor to the journal .br +\fBsd_journal_stream_fd_with_namespace\fR(3) +\(em Create log stream file descriptor to the journal +.br \fBSD_JOURNAL_SUPPRESS_LOCATION\fR(3) \(em Submit log entries to the journal .br @@ -2568,10 +2589,10 @@ systemd.index \- List all manpages from the systemd project \(em Refresh boot loader random seed at boot .br \fBsystemd-bsod\fR(8) -\(em Displays boot\-time emergency log message in full screen\&. +\(em Displays boot\-time emergency log message in full screen .br \fBsystemd-bsod.service\fR(8) -\(em Displays boot\-time emergency log message in full screen\&. +\(em Displays boot\-time emergency log message in full screen .br \fBsystemd-cat\fR(1) \(em Connect a pipeline or program\*(Aqs output with the journal @@ -2669,6 +2690,9 @@ systemd.index \- List all manpages from the systemd project \fBsystemd-halt.service\fR(8) \(em System shutdown logic .br +\fBsystemd-hibernate-clear.service\fR(8) +\(em Resume from hibernation +.br \fBsystemd-hibernate-resume\fR(8) \(em Resume from hibernation .br @@ -2684,6 +2708,9 @@ systemd.index \- List all manpages from the systemd project \fBsystemd-homed\fR(8) \(em Home Area/User Account Manager .br +\fBsystemd-homed-firstboot.service\fR(1) +\(em Create, remove, change or inspect home directories +.br \fBsystemd-homed.service\fR(8) \(em Home Area/User Account Manager .br @@ -2825,6 +2852,12 @@ systemd.index \- List all manpages from the systemd project \fBsystemd-mount\fR(1) \(em Establish and destroy transient mount or auto\-mount points .br +\fBsystemd-mountfsd\fR(8) +\(em Disk Image File System Mount Service +.br +\fBsystemd-mountfsd.service\fR(8) +\(em Disk Image File System Mount Service +.br \fBsystemd-network-generator\fR(8) \(em Generate network configuration from the kernel command line .br @@ -2852,6 +2885,12 @@ systemd.index \- List all manpages from the systemd project \fBsystemd-nspawn\fR(1) \(em Spawn a command or OS in a light\-weight container .br +\fBsystemd-nsresourced\fR(8) +\(em User Namespace Resource Delegation Service +.br +\fBsystemd-nsresourced.service\fR(8) +\(em User Namespace Resource Delegation Service +.br \fBsystemd-oomd\fR(8) \(em A userspace out\-of\-memory (OOM) killer .br @@ -2990,6 +3029,12 @@ systemd.index \- List all manpages from the systemd project \fBsystemd-soft-reboot.service\fR(8) \(em Userspace reboot operation .br +\fBsystemd-ssh-generator\fR(8) +\(em Generator for binding a socket\-activated SSH server to local AF_VSOCK and AF_UNIX sockets +.br +\fBsystemd-ssh-proxy\fR(1) +\(em SSH client plugin for connecting to AF_VSOCK and AF_UNIX sockets +.br \fBsystemd-stdio-bridge\fR(1) \(em D\-Bus proxy .br @@ -3069,22 +3114,25 @@ systemd.index \- List all manpages from the systemd project \(em Network Time Synchronization .br \fBsystemd-tmpfiles\fR(8) -\(em Creates, deletes and cleans up volatile and temporary files and directories +\(em Create, delete, and clean up files and directories .br \fBsystemd-tmpfiles-clean.service\fR(8) -\(em Creates, deletes and cleans up volatile and temporary files and directories +\(em Create, delete, and clean up files and directories .br \fBsystemd-tmpfiles-clean.timer\fR(8) -\(em Creates, deletes and cleans up volatile and temporary files and directories +\(em Create, delete, and clean up files and directories .br \fBsystemd-tmpfiles-setup-dev-early.service\fR(8) -\(em Creates, deletes and cleans up volatile and temporary files and directories +\(em Create, delete, and clean up files and directories .br \fBsystemd-tmpfiles-setup-dev.service\fR(8) -\(em Creates, deletes and cleans up volatile and temporary files and directories +\(em Create, delete, and clean up files and directories .br \fBsystemd-tmpfiles-setup.service\fR(8) -\(em Creates, deletes and cleans up volatile and temporary files and directories +\(em Create, delete, and clean up files and directories +.br +\fBsystemd-tpm2-generator\fR(8) +\(em Generator for inserting TPM2 synchronization point in the boot process .br \fBsystemd-tpm2-setup\fR(8) \(em Set up the TPM2 Storage Root Key (SRK) at boot @@ -3165,7 +3213,7 @@ systemd.index \- List all manpages from the systemd project \(em Disk verity protection logic .br \fBsystemd-vmspawn\fR(1) -\(em Spawn an OS in a virtual machine\&. +\(em Spawn an OS in a virtual machine .br \fBsystemd-volatile-root\fR(8) \(em Make the root file system volatile @@ -3173,6 +3221,9 @@ systemd.index \- List all manpages from the systemd project \fBsystemd-volatile-root.service\fR(8) \(em Make the root file system volatile .br +\fBsystemd-vpick\fR(1) +\(em Resolve paths to \&.v/ versioned directories +.br \fBsystemd-xdg-autostart-generator\fR(8) \(em User unit generator for XDG autostart files .br @@ -3284,6 +3335,9 @@ systemd.index \- List all manpages from the systemd project \fBsystemd.unit\fR(5) \(em Unit configuration .br +\fBsystemd.v\fR(7) +\(em Directory with Versioned Resources +.br \fBsysupdate.d\fR(5) \(em Transfer Definition Files for Automatic Updates .br @@ -3306,7 +3360,7 @@ systemd.index \- List all manpages from the systemd project \(em Network Time Synchronization configuration files .br \fBtmpfiles.d\fR(5) -\(em Configuration for creation, deletion and cleaning of volatile and temporary files +\(em Configuration for creation, deletion, and cleaning of files and directories .br .SH "U" @@ -3317,6 +3371,9 @@ systemd.index \- List all manpages from the systemd project \fBudev.conf\fR(5) \(em Configuration for device event managing daemon .br +\fBudev.conf.d\fR(5) +\(em Configuration for device event managing daemon +.br \fBudev_device_get_action\fR(3) \(em Query device properties .br @@ -3556,4 +3613,4 @@ systemd.index \- List all manpages from the systemd project .PP \fBsystemd.directives\fR(7) .PP -This index contains 1157 entries, referring to 397 individual manual pages\&. +This index contains 1176 entries, referring to 407 individual manual pages\&. diff --git a/upstream/fedora-rawhide/man7/systemd.journal-fields.7 b/upstream/fedora-rawhide/man7/systemd.journal-fields.7 index fbc0084d..0f0de6ae 100644 --- a/upstream/fedora-rawhide/man7/systemd.journal-fields.7 +++ b/upstream/fedora-rawhide/man7/systemd.journal-fields.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.JOURNAL\-FIELDS" "7" "" "systemd 255" "systemd.journal-fields" +.TH "SYSTEMD\&.JOURNAL\-FIELDS" "7" "" "systemd 256~rc3" "systemd.journal-fields" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -407,6 +407,15 @@ is described, instead of the process which logged the message\&. .sp Added in version 205\&. .RE +.PP +\fIOBJECT_SYSTEMD_INVOCATION_ID=\fR +.RS 4 +An additional field added automatically by +\fBsystemd\-journald\fR\&. The meaning is mostly the same as +\fI_SYSTEMD_INVOCATION_ID=\fR, with the difference described above\&. +.sp +Added in version 235\&. +.RE .SH "ADDRESS FIELDS" .PP During serialization into external formats, such as the @@ -443,13 +452,7 @@ Added in version 254\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-journald.service\fR(8), -\fBjournalctl\fR(1), -\fBjournald.conf\fR(5), -\fBsd-journal\fR(3), -\fBcoredumpctl\fR(1), -\fBsystemd.directives\fR(7) +\fBsystemd\fR(1), \fBsystemd-journald.service\fR(8), \fBjournalctl\fR(1), \fBjournald.conf\fR(5), \fBsd-journal\fR(3), \fBcoredumpctl\fR(1), \fBsystemd.directives\fR(7) .SH "NOTES" .IP " 1." 4 Journal Export Format diff --git a/upstream/fedora-rawhide/man7/systemd.net-naming-scheme.7 b/upstream/fedora-rawhide/man7/systemd.net-naming-scheme.7 index b0d4fe7b..28ef2fa9 100644 --- a/upstream/fedora-rawhide/man7/systemd.net-naming-scheme.7 +++ b/upstream/fedora-rawhide/man7/systemd.net-naming-scheme.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.NET\-NAMING\-SCHEME" "7" "" "systemd 255" "systemd.net-naming-scheme" +.TH "SYSTEMD\&.NET\-NAMING\-SCHEME" "7" "" "systemd 256~rc3" "systemd.net-naming-scheme" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -33,7 +33,7 @@ and exported as udev properties (\fIID_NET_NAME_ONBOARD=\fR, \fIID_NET_NAME_SLOT=\fR)\&. .PP Names and MAC addresses are derived from various stable device metadata attributes\&. Newer versions of udev take more of these attributes into account, improving (and thus possibly changing) the names and addresses used for the same devices\&. Different versions of those generation rules are called "naming schemes"\&. The default naming scheme is chosen at compilation time\&. Usually this will be the latest implemented version, but it is also possible to set one of the older versions to preserve compatibility\&. This may be useful for example for distributions, which may introduce new versions of systemd in stable releases without changing the naming scheme\&. The naming scheme may also be overridden using the -\fInet\&.naming\-scheme=\fR +\fInet\&.naming_scheme=\fR kernel command line switch, see \fBsystemd-udevd.service\fR(8)\&. Available naming schemes are described below\&. .PP @@ -103,7 +103,7 @@ The udev \fBnet_id\fR builtin exports the following udev device properties: .PP -\fIID_NET_NAME_ONBOARD=\fR\fI\fIprefix\fR\fR\fI\fBo\fR\fR\fI\fInumber\fR\fR, \fIID_NET_NAME_ONBOARD=\fR\fI\fIprefix\fR\fR\fI\fBd\fR\fR\fI\fInumber\fR\fR +\fIID_NET_NAME_ONBOARD=\fR\fIprefix\fR\fBo\fR\fInumber\fR, \fIID_NET_NAME_ONBOARD=\fR\fIprefix\fR\fBd\fR\fInumber\fR .RS 4 This name is set based on the numeric ordering information given by the firmware for on\-board devices\&. Different schemes are used depending on the firmware type, as described in the table below\&. .sp @@ -138,14 +138,14 @@ T} Added in version 243\&. .RE .PP -\fIID_NET_LABEL_ONBOARD=\fR\fI\fIprefix\fR\fR\fI \fR\fI\fIlabel\fR\fR +\fIID_NET_LABEL_ONBOARD=\fR\fIprefix\fR \fIlabel\fR .RS 4 This property is set based on textual label given by the firmware for on\-board devices\&. The name consists of the prefix concatenated with the label\&. This is only available for PCI devices\&. .sp Added in version 243\&. .RE .PP -\fIID_NET_NAME_MAC=\fR\fI\fIprefix\fR\fR\fI\fBx\fR\fR\fI\fIAABBCCDDEEFF\fR\fR +\fIID_NET_NAME_MAC=\fR\fIprefix\fR\fBx\fR\fIAABBCCDDEEFF\fR .RS 4 This name consists of the prefix, letter \fBx\fR, and 12 hexadecimal digits of the MAC address\&. It is available if the device has a fixed MAC address\&. Because this name is based on an attribute of the card itself, it remains "stable" when the device is moved (even between machines), but will change when the hardware is replaced\&. @@ -153,7 +153,7 @@ This name consists of the prefix, letter Added in version 243\&. .RE .PP -\fIID_NET_NAME_SLOT=\fR\fI\fIprefix\fR\fR\fI[\fR\fI\fBP\fR\fR\fI\fIdomain\fR\fR\fI]\fR\fI\fBs\fR\fR\fI\fIslot\fR\fR\fI[\fR\fI\fBf\fR\fR\fI\fIfunction\fR\fR\fI][\fR\fI\fBn\fR\fR\fI\fIport_name\fR\fR\fI|\fR\fI\fBd\fR\fR\fI\fIdev_port\fR\fR\fI]\fR, \fIID_NET_NAME_SLOT=\fR\fI\fIprefix\fR\fR\fI\fBv\fR\fR\fI\fIslot\fR\fR, \fIID_NET_NAME_SLOT=\fR\fI\fIprefix\fR\fR\fI\fBx\fR\fR\fI\fIslot\fR\fR, \fIID_NET_NAME_SLOT=\fR\fI\fIprefix\fR\fR\fI[\fR\fI\fBP\fR\fR\fI\fIdomain\fR\fR\fI]\fR\fI\fBs\fR\fR\fI\fIslot\fR\fR\fI[\fR\fI\fBf\fR\fR\fI\fIfunction\fR\fR\fI][\fR\fI\fBn\fR\fR\fI\fIport_name\fR\fR\fI|\fR\fI\fBd\fR\fR\fI\fIdev_port\fR\fR\fI]\fR\fI\fBb\fR\fR\fI\fInumber\fR\fR, \fIID_NET_NAME_SLOT=\fR\fI\fIprefix\fR\fR\fI[\fR\fI\fBP\fR\fR\fI\fIdomain\fR\fR\fI]\fR\fI\fBs\fR\fR\fI\fIslot\fR\fR\fI[\fR\fI\fBf\fR\fR\fI\fIfunction\fR\fR\fI][\fR\fI\fBn\fR\fR\fI\fIport_name\fR\fR\fI|\fR\fI\fBd\fR\fR\fI\fIdev_port\fR\fR\fI]\fR\fI\fBu\fR\fR\fI\fIport\fR\fR\fI\&...[\fR\fI\fBc\fR\fR\fI\fIconfig\fR\fR\fI][\fR\fI\fBi\fR\fR\fI\fIinterface\fR\fR\fI]\fR, \fIID_NET_NAME_SLOT=\fR\fI\fIprefix\fR\fR\fI[\fR\fI\fBP\fR\fR\fI\fIdomain\fR\fR\fI]\fR\fI\fBs\fR\fR\fI\fIslot\fR\fR\fI[\fR\fI\fBf\fR\fR\fI\fIfunction\fR\fR\fI][\fR\fI\fBn\fR\fR\fI\fIport_name\fR\fR\fI|\fR\fI\fBd\fR\fR\fI\fIdev_port\fR\fR\fI]\fR\fI\fBv\fR\fR\fI\fIslot\fR\fR, \fIID_NET_NAME_SLOT=\fR\fI\fIprefix\fR\fR\fI[\fR\fI\fBP\fR\fR\fI\fIdomain\fR\fR\fI]\fR\fI\fBs\fR\fR\fI\fIslot\fR\fR\fI[\fR\fI\fBf\fR\fR\fI\fIfunction\fR\fR\fI][\fR\fI\fBn\fR\fR\fI\fIport_name\fR\fR\fI|\fR\fI\fBd\fR\fR\fI\fIdev_port\fR\fR\fI]\fR\fI\fBr\fR\fR\fI\fIslot\fR\fR +\fIID_NET_NAME_SLOT=\fR\fIprefix\fR[\fBP\fR\fIdomain\fR]\fBs\fR\fIslot\fR[\fBf\fR\fIfunction\fR][\fBn\fR\fIport_name\fR|\fBd\fR\fIdev_port\fR], \fIID_NET_NAME_SLOT=\fR\fIprefix\fR\fBv\fR\fIslot\fR, \fIID_NET_NAME_SLOT=\fR\fIprefix\fR\fBx\fR\fIslot\fR, \fIID_NET_NAME_SLOT=\fR\fIprefix\fR[\fBP\fR\fIdomain\fR]\fBs\fR\fIslot\fR[\fBf\fR\fIfunction\fR][\fBn\fR\fIport_name\fR|\fBd\fR\fIdev_port\fR]\fBb\fR\fInumber\fR, \fIID_NET_NAME_SLOT=\fR\fIprefix\fR[\fBP\fR\fIdomain\fR]\fBs\fR\fIslot\fR[\fBf\fR\fIfunction\fR][\fBn\fR\fIport_name\fR|\fBd\fR\fIdev_port\fR]\fBu\fR\fIport\fR\&...[\fBc\fR\fIconfig\fR][\fBi\fR\fIinterface\fR], \fIID_NET_NAME_SLOT=\fR\fIprefix\fR[\fBP\fR\fIdomain\fR]\fBs\fR\fIslot\fR[\fBf\fR\fIfunction\fR][\fBn\fR\fIport_name\fR|\fBd\fR\fIdev_port\fR]\fBv\fR\fIslot\fR, \fIID_NET_NAME_SLOT=\fR\fIprefix\fR[\fBP\fR\fIdomain\fR]\fBs\fR\fIslot\fR[\fBf\fR\fIfunction\fR][\fBn\fR\fIport_name\fR|\fBd\fR\fIdev_port\fR]\fBr\fR\fIslot\fR .RS 4 This property describes the slot position\&. Different schemes are used depending on the bus type, as described in the table below\&. In case of USB, BCMA, and SR\-VIO devices, the full name consists of the prefix, PCI slot identifier, and USB or BCMA or SR\-VIO slot identifier\&. The first two parts are denoted as "\&..." in the table below\&. .sp @@ -216,7 +216,7 @@ T} .TE .sp 1 The PCI domain is only prepended when it is not 0\&. All multi\-function PCI devices will carry the -\fBf\fR\fB\fIfunction\fR\fR +\fBf\fR\fIfunction\fR number in the device name, including the function 0 device\&. For non\-multi\-function devices, the number is suppressed if 0\&. The port name \fIport_name\fR is used, or the port number @@ -240,7 +240,7 @@ In some configurations a parent PCI bridge of a given network controller may be Added in version 243\&. .RE .PP -\fIID_NET_NAME_PATH=\fR\fI\fIprefix\fR\fR\fI\fBc\fR\fR\fI\fIbus_id\fR\fR, \fIID_NET_NAME_PATH=\fR\fI\fIprefix\fR\fR\fI\fBa\fR\fR\fI\fIvendor\fR\fR\fI\fImodel\fR\fR\fI\fBi\fR\fR\fI\fIinstance\fR\fR, \fIID_NET_NAME_PATH=\fR\fI\fIprefix\fR\fR\fI\fBi\fR\fR\fI\fIaddress\fR\fR\fI\fBn\fR\fR\fI\fIport_name\fR\fR, \fIID_NET_NAME_PATH=\fR\fI\fIprefix\fR\fR\fI\fBu\fR\fR\fI\fIport\fR\fR\fI\&...\fR, \fIID_NET_NAME_PATH=\fR\fI\fIprefix\fR\fR\fI[\fR\fI\fBP\fR\fR\fI\fIdomain\fR\fR\fI]\fR\fI\fBp\fR\fR\fI\fIbus\fR\fR\fI\fBs\fR\fR\fI\fIslot\fR\fR\fI[\fR\fI\fBf\fR\fR\fI\fIfunction\fR\fR\fI][\fR\fI\fBn\fR\fR\fI\fIphys_port_name\fR\fR\fI|\fR\fI\fBd\fR\fR\fI\fIdev_port\fR\fR\fI]\fR, \fIID_NET_NAME_PATH=\fR\fI\fIprefix\fR\fR\fI[\fR\fI\fBP\fR\fR\fI\fIdomain\fR\fR\fI]\fR\fI\fBp\fR\fR\fI\fIbus\fR\fR\fI\fBs\fR\fR\fI\fIslot\fR\fR\fI[\fR\fI\fBf\fR\fR\fI\fIfunction\fR\fR\fI][\fR\fI\fBn\fR\fR\fI\fIphys_port_name\fR\fR\fI|\fR\fI\fBd\fR\fR\fI\fIdev_port\fR\fR\fI]\fR\fI\fBb\fR\fR\fI\fInumber\fR\fR, \fIID_NET_NAME_PATH=\fR\fI\fIprefix\fR\fR\fI[\fR\fI\fBP\fR\fR\fI\fIdomain\fR\fR\fI]\fR\fI\fBp\fR\fR\fI\fIbus\fR\fR\fI\fBs\fR\fR\fI\fIslot\fR\fR\fI[\fR\fI\fBf\fR\fR\fI\fIfunction\fR\fR\fI][\fR\fI\fBn\fR\fR\fI\fIphys_port_name\fR\fR\fI|\fR\fI\fBd\fR\fR\fI\fIdev_port\fR\fR\fI]\fR\fI\fBu\fR\fR\fI\fIport\fR\fR\fI\&...[\fR\fI\fBc\fR\fR\fI\fIconfig\fR\fR\fI][\fR\fI\fBi\fR\fR\fI\fIinterface\fR\fR\fI]\fR +\fIID_NET_NAME_PATH=\fR\fIprefix\fR\fBc\fR\fIbus_id\fR, \fIID_NET_NAME_PATH=\fR\fIprefix\fR\fBa\fR\fIvendor\fR\fImodel\fR\fBi\fR\fIinstance\fR, \fIID_NET_NAME_PATH=\fR\fIprefix\fR\fBi\fR\fIaddress\fR\fBn\fR\fIport_name\fR, \fIID_NET_NAME_PATH=\fR\fIprefix\fR\fBu\fR\fIport\fR\&..., \fIID_NET_NAME_PATH=\fR\fIprefix\fR[\fBP\fR\fIdomain\fR]\fBp\fR\fIbus\fR\fBs\fR\fIslot\fR[\fBf\fR\fIfunction\fR][\fBn\fR\fIphys_port_name\fR|\fBd\fR\fIdev_port\fR], \fIID_NET_NAME_PATH=\fR\fIprefix\fR[\fBP\fR\fIdomain\fR]\fBp\fR\fIbus\fR\fBs\fR\fIslot\fR[\fBf\fR\fIfunction\fR][\fBn\fR\fIphys_port_name\fR|\fBd\fR\fIdev_port\fR]\fBb\fR\fInumber\fR, \fIID_NET_NAME_PATH=\fR\fIprefix\fR[\fBP\fR\fIdomain\fR]\fBp\fR\fIbus\fR\fBs\fR\fIslot\fR[\fBf\fR\fIfunction\fR][\fBn\fR\fIphys_port_name\fR|\fBd\fR\fIdev_port\fR]\fBu\fR\fIport\fR\&...[\fBc\fR\fIconfig\fR][\fBi\fR\fIinterface\fR] .RS 4 This property describes the device installation location\&. Different schemes are used depending on the bus type, as described in the table below\&. For BCMA and USB devices, PCI path information must known, and the full name consists of the prefix, PCI slot identifier, and USB or BCMA location\&. The first two parts are denoted as "\&..." in the table below\&. .sp @@ -305,7 +305,7 @@ Added in version 243\&. .SH "HISTORY" .PP The following "naming schemes" have been defined (which may be chosen at system boot\-up time via the -\fInet\&.naming\-scheme=\fR +\fInet\&.naming_scheme=\fR kernel command line switch, see above): .PP \fBv238\fR @@ -459,7 +459,7 @@ Added in version 253\&. Naming was changed for SR\-IOV virtual device representors, optionally settable at compilation time\&. The "r\fIslot\fR" suffix was added to differentiate SR\-IOV virtual device representors attached to a single physical device interface\&. Because of a mistake, this scheme was -\fInot the the default scheme for systemd version 254\fR\&. +\fInot the default scheme for systemd version 254\fR\&. .sp Added in version 255\&. .RE @@ -476,6 +476,38 @@ Added in version 255\&. Note that \fBlatest\fR may be used to denote the latest scheme known (to this particular version of systemd)\&. +.SH "LIMITING THE USE OF SPECIFIC SYSFS ATTRIBUTES" +.PP +When creating names for network cards, some naming schemes use data from sysfs populated by the kernel\&. This means that although a specific naming scheme in udev is picked, the network card\*(Aqs name can still change when a new kernel version adds a new sysfs attribute\&. For example if kernel starts setting the +\fBphys_port_name\fR, udev will append the "\fBn\fR\fIphys_port_name\fR" suffix to the device name\&. +.PP +\fIID_NET_NAME_ALLOW=\fR\fIBOOL\fR +.RS 4 +This udev property sets a fallback policy for reading a sysfs attribute\&. If set to +\fB0\fR +udev will not read any sysfs attribute by default, unless it is explicitly allowlisted, see below\&. If set to +\fB1\fR +udev can use any sysfs attribute unless it is explicitly forbidden\&. The default value is +\fB1\fR\&. +.sp +Added in version 256\&. +.RE +.PP +\fIID_NET_NAME_ALLOW_\fR\fI\fIsysfsattr\fR\fR\fI=\fR\fI\fIBOOL\fR\fR +.RS 4 +This udev property explicitly states if udev shall use the specified +\fIsysfsattr\fR, when composing the device name\&. +.sp +Added in version 256\&. +.RE +.PP +With these options, users can set an allowlist or denylist for sysfs attributes\&. To create an allowlist, the user needs to set +\fIID_NET_NAME_ALLOW=0\fR +for the device and then list the allowed attributes with the +\fIID_NET_NAME_ALLOW_\fR\fI\fIsysfsattr\fR\fR\fI=1\fR +options\&. In case of a denylist, the user needs to provide the list of denied attributes with the +\fIID_NET_NAME_ALLOW_\fR\fI\fIsysfsattr\fR\fR\fI=0\fR +options\&. .SH "EXAMPLES" .PP \fBExample\ \&1.\ \&Using udevadm test\-builtin to display device properties\fR @@ -615,12 +647,51 @@ ID_NET_NAME_PATH=encf5f0 .if n \{\ .RE .\} +.PP +\fBExample\ \&10.\ \&Set an allowlist for reading sysfs attributes for network card naming\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +/etc/udev/hwdb\&.d/50\-net\-naming\-allowlist\&.hwdb +net:naming:drvirtio_net:* + ID_NET_NAME_ALLOW=0 + ID_NET_NAME_ALLOW_ACPI_INDEX=1 + ID_NET_NAME_ALLOW_ADDR_ASSIGN_TYPE=1 + ID_NET_NAME_ALLOW_ADDRESS=1 + ID_NET_NAME_ALLOW_ARI_ENABLED=1 + ID_NET_NAME_ALLOW_DEV_PORT=1 + ID_NET_NAME_ALLOW_FUNCTION_ID=1 + ID_NET_NAME_ALLOW_IFLINK=1 + ID_NET_NAME_ALLOW_INDEX=1 + ID_NET_NAME_ALLOW_LABEL=1 + ID_NET_NAME_ALLOW_PHYS_PORT_NAME=1 + ID_NET_NAME_ALLOW_TYPE=1 +.fi +.if n \{\ +.RE +.\} +.PP +\fBExample\ \&11.\ \&Set a denylist so that specified sysfs attribute are ignored\fR +.sp +.if n \{\ +.RS 4 +.\} +.nf +/etc/udev/hwdb\&.d/50\-net\-naming\-denylist\&.hwdb +net:naming:drvirtio_net:* + ID_NET_NAME_ALLOW=1 + ID_NET_NAME_ALLOW_DEV_PORT=0 + ID_NET_NAME_ALLOW_PHYS_PORT_NAME=0 + +.fi +.if n \{\ +.RE +.\} .SH "SEE ALSO" .PP -\fBudev\fR(7), -\fBudevadm\fR(8), -\m[blue]\fBPredictable Network Interface Names\fR\m[]\&\s-2\u[1]\d\s+2, -\fBsystemd-nspawn\fR(1) +\fBudev\fR(7), \fBudevadm\fR(8), \m[blue]\fBPredictable Network Interface Names\fR\m[]\&\s-2\u[1]\d\s+2, \fBsystemd-nspawn\fR(1) .SH "NOTES" .IP " 1." 4 Predictable Network Interface Names diff --git a/upstream/fedora-rawhide/man7/systemd.offline-updates.7 b/upstream/fedora-rawhide/man7/systemd.offline-updates.7 index 3c098cce..f2ffdb15 100644 --- a/upstream/fedora-rawhide/man7/systemd.offline-updates.7 +++ b/upstream/fedora-rawhide/man7/systemd.offline-updates.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.OFFLINE\-UPDATES" "7" "" "systemd 255" "systemd.offline-updates" +.TH "SYSTEMD\&.OFFLINE\-UPDATES" "7" "" "systemd 256~rc3" "systemd.offline-updates" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -251,10 +251,7 @@ and add a symlink to that file under .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.generator\fR(7), -\fBsystemd-system-update-generator\fR(8), -\fBdnf.plugin.system-upgrade\fR(8) +\fBsystemd\fR(1), \fBsystemd.generator\fR(7), \fBsystemd-system-update-generator\fR(8), \fBdnf.plugin.system-upgrade\fR(8) .SH "NOTES" .IP " 1." 4 GNOME design whiteboard diff --git a/upstream/fedora-rawhide/man7/systemd.special.7 b/upstream/fedora-rawhide/man7/systemd.special.7 index 43e5332d..6596f118 100644 --- a/upstream/fedora-rawhide/man7/systemd.special.7 +++ b/upstream/fedora-rawhide/man7/systemd.special.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.SPECIAL" "7" "" "systemd 255" "systemd.special" +.TH "SYSTEMD\&.SPECIAL" "7" "" "systemd 256~rc3" "systemd.special" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -85,6 +85,7 @@ smartcard\&.target, sockets\&.target, soft\-reboot\&.target, sound\&.target, +ssh\-access\&.target, storage\-target\-mode\&.target, suspend\&.target, swap\&.target, @@ -94,12 +95,14 @@ system\-update\-pre\&.target, time\-set\&.target, time\-sync\&.target, timers\&.target, +tpm2\&.target, umount\&.target, usb\-gadget\&.target, \-\&.slice, +capsule\&.slice, +machine\&.slice, system\&.slice, user\&.slice, -machine\&.slice, \-\&.mount, dbus\&.service, dbus\&.socket, @@ -847,6 +850,19 @@ This may be used to pull in usb gadget dynamically when UDC hardware is found\&. .sp Added in version 242\&. .RE +.PP +tpm2\&.target +.RS 4 +This target is started automatically if a TPM2 device is discovered, either by the OS or by the firmware\&. It acts as synchronization point for services that require TPM2 device access\&. The target unit is enqueued by +\fBsystemd-tpm2-generator\fR(8) +if it detects that the firmware has discovered a TPM2 device but the OS kernel has not activated a driver for it yet\&. It is also pulled in whenever +\fBsystemd-udevd.service\fR(8) +discovers a TPM2 device\&. The target unit is ordered after the +/dev/tpmrm0 +device node, so that it only becomes active once the TPM2 device is actually accessible\&. Early boot programs that intend to access the TPM2 device should hence order themselves after this target unit, but not pull it in\&. +.sp +Added in version 256\&. +.RE .SS "Special Passive System Units" .PP A number of special system targets are defined that can be used to properly order boot\-up of optional services\&. These targets are generally not part of the initial boot transaction, unless they are explicitly pulled in by one of the implementing services\&. Note specifically that these @@ -1000,6 +1016,17 @@ for this target unit to all SysV init script service units with an LSB header re facility\&. .RE .PP +ssh\-access\&.target +.RS 4 +Service and socket units that provide remote SSH secure shell access to the local system should pull in this unit and order themselves before this unit\&. It\*(Aqs supposed to act as a milestone indicating if and when SSH access into the system is available\&. It should only become active when an SSH port is bound for remote clients (i\&.e\&. if SSH is used as a local privilege escalation mechanism, it should +\fInot\fR +involve this target unit), regardless of the protocol choices, i\&.e\&. regardless if IPv4, IPv6 or +\fBAF_VSOCK\fR +is used\&. +.sp +Added in version 256\&. +.RE +.PP time\-set\&.target .RS 4 Services responsible for setting the system clock (\fBCLOCK_REALTIME\fR) from a local source (such as a maintained timestamp file or imprecise real\-time clock) should pull in this target and order themselves before it\&. Services where approximate, roughly monotonic time is desired should be ordered after this unit, but not pull it in\&. @@ -1113,6 +1140,25 @@ The root slice is the root of the slice hierarchy\&. It usually does not contain Added in version 206\&. .RE .PP +machine\&.slice +.RS 4 +By default, all virtual machines and containers registered with +\fBsystemd\-machined\fR +are found in this slice\&. This is pulled in by +systemd\-machined\&.service\&. +.sp +Added in version 206\&. +.RE +.PP +capsule\&.slice +.RS 4 +By default, all capsules encapsulated in +capsule@\&.service +are found in this slice\&. +.sp +Added in version 255\&. +.RE +.PP system\&.slice .RS 4 By default, all system services started by @@ -1129,16 +1175,6 @@ systemd\-logind\&.service\&. .sp Added in version 206\&. .RE -.PP -machine\&.slice -.RS 4 -By default, all virtual machines and containers registered with -\fBsystemd\-machined\fR -are found in this slice\&. This is pulled in by -systemd\-machined\&.service\&. -.sp -Added in version 206\&. -.RE .SH "UNITS MANAGED BY THE USER SERVICE MANAGER" .SS "Special User Units" .PP @@ -1146,7 +1182,7 @@ When systemd runs as a user instance, the following special units are available: .PP default\&.target .RS 4 -This is the main target of the user session, started by default\&. Various services that compose the normal user session should be pulled into this target\&. In this regard, +This is the main target of the user service manager, started by default when the service manager is invoked\&. Various services that compose the normal user session should be pulled into this target\&. In this regard, default\&.target is similar to multi\-user\&.target @@ -1155,6 +1191,14 @@ in the system instance, but it is a real unit, not an alias\&. Added in version 242\&. .RE .PP +capsule@\&.target +.RS 4 +This is the main target of capsule service managers, started by default, instantiated with the capsule name\&. This may be used to define different sets of units that are started for different capsules via generic unit definitions\&. For details about capsules see +\fBcapsule@.service\fR(5)\&. +.sp +Added in version 255\&. +.RE +.PP In addition, the following units are available which have definitions similar to their system counterparts: exit\&.target, shutdown\&.target, @@ -1290,15 +1334,7 @@ Added in version 247\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.unit\fR(5), -\fBsystemd.service\fR(5), -\fBsystemd.socket\fR(5), -\fBsystemd.target\fR(5), -\fBsystemd.slice\fR(5), -\fBbootup\fR(7), -\fBsystemd-fstab-generator\fR(8), -\fBuser@.service\fR(5) +\fBsystemd\fR(1), \fBsystemd.unit\fR(5), \fBsystemd.service\fR(5), \fBsystemd.socket\fR(5), \fBsystemd.target\fR(5), \fBsystemd.slice\fR(5), \fBbootup\fR(7), \fBsystemd-fstab-generator\fR(8), \fBuser@.service\fR(5) .SH "NOTES" .IP " 1." 4 Running Services After the Network Is Up diff --git a/upstream/fedora-rawhide/man7/systemd.syntax.7 b/upstream/fedora-rawhide/man7/systemd.syntax.7 index 7e334bb3..e6ba3086 100644 --- a/upstream/fedora-rawhide/man7/systemd.syntax.7 +++ b/upstream/fedora-rawhide/man7/systemd.syntax.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.SYNTAX" "7" "" "systemd 255" "systemd.syntax" +.TH "SYSTEMD\&.SYNTAX" "7" "" "systemd 256~rc3" "systemd.syntax" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -123,8 +123,6 @@ or are ignored, which may be used for commenting\&. .PP Lines ending in a backslash are concatenated with the following line while reading and the backslash is replaced by a space character\&. This may be used to wrap long lines\&. The limit on line length is very large (currently 1 MB), but it is recommended to avoid such long lines and use multiple directives, variable substitution, or other mechanism as appropriate for the given file type\&. When a comment line or lines follow a line ending with a backslash, the comment block is ignored, so the continued line is concatenated with whatever follows the comment block\&. -.PP -\fBExample\ \&1.\ \&\fR .sp .if n \{\ .RS 4 diff --git a/upstream/fedora-rawhide/man7/systemd.system-credentials.7 b/upstream/fedora-rawhide/man7/systemd.system-credentials.7 index 5ace9a31..b953256b 100644 --- a/upstream/fedora-rawhide/man7/systemd.system-credentials.7 +++ b/upstream/fedora-rawhide/man7/systemd.system-credentials.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.SYSTEM\-CREDENTIALS" "7" "" "systemd 255" "systemd.system-credentials" +.TH "SYSTEMD\&.SYSTEM\-CREDENTIALS" "7" "" "systemd 256~rc3" "systemd.system-credentials" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -118,6 +118,38 @@ DNS server information and search domains\&. Read by Added in version 253\&. .RE .PP +\fInetwork\&.conf\&.*\fR, \fInetwork\&.link\&.*\fR, \fInetwork\&.netdev\&.*\fR, \fInetwork\&.network\&.*\fR +.RS 4 +Configures network devices\&. Read by +\fBsystemd-network-generator.service\fR(8)\&. These credentials should contain valid +\fBnetworkd.conf\fR(5), +\fBsystemd.link\fR(5), +\fBsystemd.netdev\fR(5), +\fBsystemd.network\fR(5) +configuration data\&. From each matching credential a separate file is created\&. Example: the contents of a credential +network\&.link\&.50\-foobar +will be copied into a file +50\-foobar\&.link\&. +.sp +Note that the resulting files are created world\-readable, it\*(Aqs hence recommended to not include secrets in these credentials, but supply them via separate credentials directly to +systemd\-networkd\&.service, e\&.g\&. +\fInetwork\&.wireguard\&.*\fR +as described below\&. +.sp +Added in version 256\&. +.RE +.PP +\fInetwork\&.wireguard\&.*\fR +.RS 4 +Configures secrets for WireGuard netdevs\&. Read by +\fBsystemd-networkd.service\fR(8)\&. For more information, refer to the +\fB[WireGuard]\fR +section of +\fBsystemd.netdev\fR(5)\&. +.sp +Added in version 256\&. +.RE +.PP \fIpasswd\&.hashed\-password\&.root\fR, \fIpasswd\&.plaintext\-password\&.root\fR .RS 4 May contain the password (either in UNIX hashed format, or in plaintext) for the root users\&. Read by both @@ -151,6 +183,15 @@ Consumed by Added in version 252\&. .RE .PP +\fIssh\&.listen\fR +.RS 4 +May be used to configure SSH sockets the system shall be reachable on\&. See +\fBsystemd-ssh-generator\fR(8) +for details\&. +.sp +Added in version 256\&. +.RE +.PP \fIsysusers\&.extra\fR .RS 4 Additional @@ -204,6 +245,28 @@ for details\&. Added in version 254\&. .RE .PP +\fIjournal\&.forward_to_socket\fR +.RS 4 +Used by +\fBsystemd-journald\fR(8) +to determine where to forward log messages for socket forwarding, see +\fBjournald.conf\fR(5) +for details\&. +.sp +Added in version 256\&. +.RE +.PP +\fIjournal\&.storage\fR +.RS 4 +Used by +\fBsystemd-journald\fR(8) +to determine where to store journal files, see +\fBjournald.conf\fR(5) +for details\&. +.sp +Added in version 256\&. +.RE +.PP \fIvmm\&.notify_socket\fR .RS 4 Configures an @@ -223,11 +286,65 @@ Takes a 128bit ID to initialize the machine ID from (if it is not set yet)\&. In .sp Added in version 254\&. .RE +.PP +\fIsystem\&.hostname\fR +.RS 4 +Accepts a (transient) hostname to configure during early boot\&. The static hostname specified in +/etc/hostname, if configured, takes precedence over this setting\&. Interpreted by the service manager (PID 1)\&. For details see +\fBsystemd\fR(1)\&. +.sp +Added in version 254\&. +.RE +.PP +\fIhome\&.create\&.*\fR +.RS 4 +Creates a home area for the specified user with the user record data passed in\&. For details see +\fBhomectl\fR(1)\&. +.sp +Added in version 256\&. +.RE +.PP +\fIcryptsetup\&.passphrase\fR, \fIcryptsetup\&.tpm2\-pin\fR, \fIcryptsetup\&.fido2\-pin\fR, \fIcryptsetup\&.pkcs11\-pin\fR, \fIcryptsetup\&.luks2\-pin\fR +.RS 4 +Specifies the passphrase/PINs to use for unlock encrypted storage volumes\&. For details see +\fBsystemd-cryptsetup\fR(8)\&. +.sp +Added in version 256\&. +.RE +.PP +\fIsystemd\&.extra\-unit\&.*\fR, \fIsystemd\&.unit\-dropin\&.*\fR +.RS 4 +These credentials specify extra units and drop\-ins to add to the system\&. For details see +\fBsystemd-debug-generator\fR(8)\&. +.sp +Added in version 256\&. +.RE +.PP +\fIudev\&.conf\&.*\fR, \fIudev\&.rules\&.*\fR +.RS 4 +Configures udev configuration file and udev rules\&. Read by +systemd\-udev\-load\-credentials\&.service, which invokes +\fBudevadm control \-\-load\-credentials\fR\&. These credentials directly translate to a matching +\fBudev.conf\fR(5) +or +\fBudev\fR(7) +rules file\&. Example: the contents of a credential +udev\&.conf\&.50\-foobar +will be copied into a file +/run/udev/udev\&.conf\&.d/50\-foobar\&.conf, and +udev\&.rules\&.50\-foobar +will be copied into a file +/run/udev/rules\&.d/50\-foobar\&.rules\&. See +\fBudev\fR(7), +\fBudev.conf\fR(5), and +\fBudevadm\fR(8) +for details\&. +.sp +Added in version 256\&. +.RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBkernel-command-line\fR(7), -\fBsmbios-type-11\fR(7) +\fBsystemd\fR(1), \fBkernel-command-line\fR(7), \fBsmbios-type-11\fR(7) .SH "NOTES" .IP " 1." 4 System and Service Credentials diff --git a/upstream/fedora-rawhide/man7/systemd.time.7 b/upstream/fedora-rawhide/man7/systemd.time.7 index 39e552a7..3e3a776c 100644 --- a/upstream/fedora-rawhide/man7/systemd.time.7 +++ b/upstream/fedora-rawhide/man7/systemd.time.7 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\&.TIME" "7" "" "systemd 255" "systemd.time" +.TH "SYSTEMD\&.TIME" "7" "" "systemd 256~rc3" "systemd.time" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -452,12 +452,7 @@ command of to validate and normalize calendar time specifications for testing purposes\&. The tool also calculates when a specified calendar event would occur next\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBjournalctl\fR(1), -\fBsystemd.timer\fR(5), -\fBsystemd.unit\fR(5), -\fBsystemd.directives\fR(7), -\fBsystemd-analyze\fR(1) +\fBsystemd\fR(1), \fBjournalctl\fR(1), \fBsystemd.timer\fR(5), \fBsystemd.unit\fR(5), \fBsystemd.directives\fR(7), \fBsystemd-analyze\fR(1) .SH "NOTES" .IP " 1." 4 RFC 3339 diff --git a/upstream/fedora-rawhide/man7/systemd.v.7 b/upstream/fedora-rawhide/man7/systemd.v.7 new file mode 100644 index 00000000..29139560 --- /dev/null +++ b/upstream/fedora-rawhide/man7/systemd.v.7 @@ -0,0 +1,343 @@ +'\" t +.TH "SYSTEMD\&.V" "7" "" "systemd 256~rc3" "systemd.v" +.\" ----------------------------------------------------------------- +.\" * 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.v \- Directory with Versioned Resources +.SH "DESCRIPTION" +.PP +In various places systemd components accept paths whose trailing components have the +"\&.v/" +suffix, pointing to a directory\&. These components will then automatically look for suitable files inside the directory, do a version comparison and open the newest file found (by version)\&. Available since version v256\&. Specifically, two expressions are supported: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +When looking for files with a suffix +\fI\&.SUFFIX\fR, and a path +\&...\fIPATH\fR/\fINAME\fR\fI\&.SUFFIX\fR\&.v/ +is specified, then all files +\&...\fIPATH\fR/\fINAME\fR\fI\&.SUFFIX\fR\&.v/\fINAME\fR_*\fI\&.SUFFIX\fR +are enumerated, filtered, sorted and the newest file used\&. The primary sorting key is the +\fIvariable part\fR, here indicated by the wildcard +"*"\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +When a path +\&...\fIPATH\fR\&.v/\fINAME\fR___\fI\&.SUFFIX\fR +is specified (i\&.e\&. the penultimate component of the path ends in +"\&.v" +and the final component contains a triple underscore), then all files +\&...\fIPATH\fR\&.v/\fINAME\fR_*\fI\&.SUFFIX\fR +are enumerated, filtered, sorted and the newest file used (again, by the +\fIvariable part\fR, here indicated by the wildcard +"*")\&. +.RE +.PP +To illustrate this in an example, consider a directory +/var/lib/machines/mymachine\&.raw\&.v/, which is populated with three files: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +mymachine_7\&.5\&.13\&.raw +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +mymachine_7\&.5\&.14\&.raw +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +mymachine_7\&.6\&.0\&.raw +.RE +.PP +Invoke a tool such as +\fBsystemd-nspawn\fR(1) +with a command line like the following: +.sp +.if n \{\ +.RS 4 +.\} +.nf +# systemd\-nspawn \-\-image=/var/lib/machines/mymachine\&.raw\&.v \-\-boot +.fi +.if n \{\ +.RE +.\} +.PP +Then this would automatically be resolved to the equivalent of: +.sp +.if n \{\ +.RS 4 +.\} +.nf +# systemd\-nspawn \-\-image=/var/lib/machines/mymachine\&.raw\&.v/mymachine_7\&.6\&.0\&.raw \-\-boot +.fi +.if n \{\ +.RE +.\} +.PP +Much of systemd\*(Aqs functionality that expects a path to a disk image or OS directory hierarchy support the +"\&.v/" +versioned directory mechanism, for example +\fBsystemd-nspawn\fR(1), +\fBsystemd-dissect\fR(1) +or the +\fIRootDirectory=\fR/\fIRootImage=\fR +settings of service files (see +\fBsystemd.exec\fR(5))\&. +.PP +Use the +\fBsystemd-vpick\fR(1) +tool to resolve +"\&.v/" +paths from the command line, for example for usage in shell scripts\&. +.SH "FILTERING AND SORTING" +.PP +The variable part of the filenames in the +"\&.v/" +directories are filtered and compared primarily with a version comparison, implementing +\m[blue]\fBVersion Format Specification\fR\m[]\&\s-2\u[1]\d\s+2\&. However, additional rules apply: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If the variable part is suffixed by one or two integer values ("tries left" and "tries done") in the formats ++\fILEFT\fR +or ++\fILEFT\fR\-\fIDONE\fR, then these indicate usage attempt counters\&. The idea is that each time before a file is attempted to be used, its "tries left" counter is decreased, and the "tries done" counter increased (simply by renaming the file)\&. When the file is successfully used (which for example could mean for an OS image: successfully booted) the counters are removed from the file name, indicating that the file has been validated to work correctly\&. This mechanism mirrors the boot assessment counters defined by +\m[blue]\fBAutomatic Boot Assessment\fR\m[]\&\s-2\u[2]\d\s+2\&. Any filenames with no boot counters or with a non\-zero "tries left" counter are sorted before filenames with a zero "tries left" counter\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Preceding the use counters (if they are specified), an optional CPU architecture identifier may be specified in the filename (separated from the version with an underscore), as defined in the architecture vocabulary of the +\fIConditionArchitecture=\fR +unit file setting, as documented in +\fBsystemd.unit\fR(5)\&. Files whose name indicates an architecture not supported locally are filtered and not considered for the version comparison\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +The rest of the variable part is the version string\&. +.RE +.PP +Or in other words, the files in the +"\&.v/" +directories should follow one of these naming structures: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +\fINAME\fR_\fIVERSION\fR\fI\&.SUFFIX\fR +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +\fINAME\fR_\fIVERSION\fR_\fIARCHITECTURE\fR\fI\&.SUFFIX\fR +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +\fINAME\fR_\fIVERSION\fR+\fILEFT\fR\fI\&.SUFFIX\fR +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +\fINAME\fR_\fIVERSION\fR+\fILEFT\fR\-\fIDONE\fR\fI\&.SUFFIX\fR +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +\fINAME\fR_\fIVERSION\fR_\fIARCHITECTURE\fR+\fILEFT\fR\fI\&.SUFFIX\fR +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +\fINAME\fR_\fIVERSION\fR_\fIARCHITECTURE\fR+\fILEFT\fR\-\fIDONE\fR\fI\&.SUFFIX\fR +.RE +.SH "EXAMPLE" +.PP +Here\*(Aqs a more comprehensive example, further extending the one described above\&. Consider a directory +/var/lib/machines/mymachine\&.raw\&.v/, which is populated with the following files: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +mymachine_7\&.5\&.13\&.raw +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +mymachine_7\&.5\&.14_x86\-64\&.raw +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +mymachine_7\&.6\&.0_arm64\&.raw +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +mymachine_7\&.7\&.0_x86\-64+0\-5\&.raw +.RE +.PP +Now invoke the following command on an x86\-64 machine: +.sp +.if n \{\ +.RS 4 +.\} +.nf +$ systemd\-vpick \-\-suffix=\&.raw /var/lib/machines/mymachine\&.raw\&.v/ +.fi +.if n \{\ +.RE +.\} +.PP +This would resolve the specified path to +/var/lib/machines/mymachine\&.raw\&.v/mymachine_7\&.5\&.14_x86\-64\&.raw\&. Explanation: even though +mymachine_7\&.7\&.0_x86\-64+0\-5\&.raw +has the newest version, it is not preferred because its tries left counter is zero\&. And even though +mymachine_7\&.6\&.0_arm64\&.raw +has the second newest version it is also not considered, in this case because we operate on an x86_64 system and the image is intended for arm64 CPUs\&. Finally, the +mymachine_7\&.5\&.13\&.raw +image is not considered because it is older than +mymachine_7\&.5\&.14_x86\-64\&.raw\&. +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), \fBsystemd-vpick\fR(1), \fBsystemd-nspawn\fR(1), \fBsystemd-dissect\fR(1), \fBsystemd.exec\fR(5), \fBsystemd-sysupdate\fR(1) +.SH "NOTES" +.IP " 1." 4 +Version Format Specification +.RS 4 +\%https://uapi-group.org/specifications/specs/version_format_specification/ +.RE +.IP " 2." 4 +Automatic Boot Assessment +.RS 4 +\%https://systemd.io/AUTOMATIC_BOOT_ASSESSMENT/ +.RE diff --git a/upstream/fedora-rawhide/man7/sysvipc.7 b/upstream/fedora-rawhide/man7/sysvipc.7 index 562b2083..11c08ab4 100644 --- a/upstream/fedora-rawhide/man7/sysvipc.7 +++ b/upstream/fedora-rawhide/man7/sysvipc.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sysvipc 7 2023-10-31 "Linux man-pages 6.06" +.TH sysvipc 7 2023-10-31 "Linux man-pages 6.7" .SH NAME sysvipc \- System V interprocess communication mechanisms .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/tcp.7 b/upstream/fedora-rawhide/man7/tcp.7 index 1c810ee4..2b1d3332 100644 --- a/upstream/fedora-rawhide/man7/tcp.7 +++ b/upstream/fedora-rawhide/man7/tcp.7 @@ -88,7 +88,7 @@ .\" commit cd8ae85299d54155702a56811b2e035e63064d3d .\" Author: Eric Dumazet <edumazet@google.com> .\" -.TH tcp 7 2023-10-31 "Linux man-pages 6.06" +.TH tcp 7 2023-10-31 "Linux man-pages 6.7" .SH NAME tcp \- TCP protocol .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/termio.7 b/upstream/fedora-rawhide/man7/termio.7 index 2840ca3b..bff1d9ff 100644 --- a/upstream/fedora-rawhide/man7/termio.7 +++ b/upstream/fedora-rawhide/man7/termio.7 @@ -4,7 +4,7 @@ .\" .\" 28 Dec 2006 - Initial Creation .\" -.TH termio 7 2023-10-31 "Linux man-pages 6.06" +.TH termio 7 2023-10-31 "Linux man-pages 6.7" .SH NAME termio \- System V terminal driver interface .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/thread-keyring.7 b/upstream/fedora-rawhide/man7/thread-keyring.7 index 8fad6970..703f0839 100644 --- a/upstream/fedora-rawhide/man7/thread-keyring.7 +++ b/upstream/fedora-rawhide/man7/thread-keyring.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH thread-keyring 7 2023-10-31 "Linux man-pages 6.06" +.TH thread-keyring 7 2023-10-31 "Linux man-pages 6.7" .SH NAME thread-keyring \- per-thread keyring .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/time.7 b/upstream/fedora-rawhide/man7/time.7 index 88d0d612..7259feb9 100644 --- a/upstream/fedora-rawhide/man7/time.7 +++ b/upstream/fedora-rawhide/man7/time.7 @@ -5,7 +5,7 @@ .\" 2008-06-24, mtk: added some details about where jiffies come into .\" play; added section on high-resolution timers. .\" -.TH time 7 2023-10-31 "Linux man-pages 6.06" +.TH time 7 2023-10-31 "Linux man-pages 6.7" .SH NAME time \- overview of time and timers .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/time_namespaces.7 b/upstream/fedora-rawhide/man7/time_namespaces.7 index 6526c18b..4c850018 100644 --- a/upstream/fedora-rawhide/man7/time_namespaces.7 +++ b/upstream/fedora-rawhide/man7/time_namespaces.7 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH time_namespaces 7 2023-10-31 "Linux man-pages 6.06" +.TH time_namespaces 7 2023-10-31 "Linux man-pages 6.7" .SH NAME time_namespaces \- overview of Linux time namespaces .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/udev.7 b/upstream/fedora-rawhide/man7/udev.7 index 4703ad59..babc6868 100644 --- a/upstream/fedora-rawhide/man7/udev.7 +++ b/upstream/fedora-rawhide/man7/udev.7 @@ -1,5 +1,5 @@ '\" t -.TH "UDEV" "7" "" "systemd 255" "udev" +.TH "UDEV" "7" "" "systemd 256~rc3" "udev" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -577,14 +577,15 @@ Added in version 248\&. .RE .PP The -\fINAME\fR, -\fISYMLINK\fR, -\fIPROGRAM\fR, -\fIOWNER\fR, +\fIENV\fR, \fIGROUP\fR, \fIMODE\fR, +\fINAME\fR, +\fIOWNER\fR, +\fIPROGRAM\fR, +\fIRUN\fR, \fISECLABEL\fR, and -\fIRUN\fR +\fISYMLINK\fR fields support simple string substitutions\&. The \fIRUN\fR substitutions are performed after all rules have been processed, right before the program is executed, allowing for the use of device properties set by earlier matching rules\&. For all other fields, substitutions are performed while the individual rule is being processed\&. The available substitutions are: @@ -706,9 +707,7 @@ character itself\&. .RE .SH "SEE ALSO" .PP -\fBsystemd-udevd.service\fR(8), -\fBudevadm\fR(8), -\fBsystemd.link\fR(5) +\fBsystemd-udevd.service\fR(8), \fBudevadm\fR(8), \fBsystemd.link\fR(5) .SH "NOTES" .IP " 1." 4 Escape sequences in C diff --git a/upstream/fedora-rawhide/man7/udp.7 b/upstream/fedora-rawhide/man7/udp.7 index 5030eebd..6b643a26 100644 --- a/upstream/fedora-rawhide/man7/udp.7 +++ b/upstream/fedora-rawhide/man7/udp.7 @@ -4,7 +4,7 @@ .\" .\" $Id: udp.7,v 1.7 2000/01/22 01:55:05 freitag Exp $ .\" -.TH udp 7 2023-10-31 "Linux man-pages 6.06" +.TH udp 7 2023-10-31 "Linux man-pages 6.7" .SH NAME udp \- User Datagram Protocol for IPv4 .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/udplite.7 b/upstream/fedora-rawhide/man7/udplite.7 index 6b96ff6f..4ba4266d 100644 --- a/upstream/fedora-rawhide/man7/udplite.7 +++ b/upstream/fedora-rawhide/man7/udplite.7 @@ -4,7 +4,7 @@ .\" .\" $Id: udplite.7,v 1.12 2008/07/23 15:22:22 gerrit Exp gerrit $ .\" -.TH udplite 7 2023-10-31 "Linux man-pages 6.06" +.TH udplite 7 2023-10-31 "Linux man-pages 6.7" .SH NAME udplite \- Lightweight User Datagram Protocol .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/unicode.7 b/upstream/fedora-rawhide/man7/unicode.7 index 5ccd91d0..fe38909f 100644 --- a/upstream/fedora-rawhide/man7/unicode.7 +++ b/upstream/fedora-rawhide/man7/unicode.7 @@ -7,7 +7,7 @@ .\" 2001-05-11 Markus Kuhn <mgk25@cl.cam.ac.uk> .\" Update .\" -.TH unicode 7 2024-01-28 "Linux man-pages 6.06" +.TH unicode 7 2024-01-28 "Linux man-pages 6.7" .SH NAME unicode \- universal character set .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/units.7 b/upstream/fedora-rawhide/man7/units.7 index 16d62176..da0492f9 100644 --- a/upstream/fedora-rawhide/man7/units.7 +++ b/upstream/fedora-rawhide/man7/units.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH units 7 2023-10-31 "Linux man-pages 6.06" +.TH units 7 2023-10-31 "Linux man-pages 6.7" .SH NAME units \- decimal and binary prefixes .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/unix.7 b/upstream/fedora-rawhide/man7/unix.7 index a583ad3d..426a430e 100644 --- a/upstream/fedora-rawhide/man7/unix.7 +++ b/upstream/fedora-rawhide/man7/unix.7 @@ -12,7 +12,7 @@ .\" address that can appear in the sockaddr_un structure: pathname, .\" unnamed, and abstract. .\" -.TH UNIX 7 2023-12-21 "Linux man-pages 6.06" +.TH UNIX 7 2024-03-16 "Linux man-pages 6.7" .SH NAME unix \- sockets for local interprocess communication .SH SYNOPSIS @@ -72,7 +72,7 @@ On Linux, .I sun_path is 108 bytes in size; see also BUGS, below. .P -Various systems calls (for example, +Various system calls (for example, .BR bind (2), .BR connect (2), and @@ -833,7 +833,7 @@ UNIX domain stream sockets do not support the notion of out-of-band data. .\" .SH BUGS When binding a socket to an address, -Linux is one of the implementations that appends a null terminator +Linux is one of the implementations that append a null terminator if none is supplied in .IR sun_path . In most cases this is unproblematic: @@ -955,6 +955,7 @@ $ .in .SS Program source \& +.\" SRC BEGIN (connection.h) .EX /* * File connection.h @@ -962,7 +963,11 @@ $ \& #define SOCKET_NAME "/tmp/9Lq7BNBnBycd6nxy.socket" #define BUFFER_SIZE 12 -\& +.EE +.\" SRC END +.P +.\" SRC BEGIN (server.c) +.EX /* * File server.c */ @@ -973,18 +978,20 @@ $ #include <sys/socket.h> #include <sys/un.h> #include <unistd.h> +\& #include "connection.h" \& int -main(int argc, char *argv[]) +main(void) { - struct sockaddr_un name; - int down_flag = 0; - int ret; - int connection_socket; - int data_socket; - int result; - char buffer[BUFFER_SIZE]; + int down_flag = 0; + int ret; + int connection_socket; + int data_socket; + int result; + ssize_t r, w; + struct sockaddr_un name; + char buffer[BUFFER_SIZE]; \& /* Create local socket. */ \& @@ -1043,8 +1050,8 @@ main(int argc, char *argv[]) \& /* Wait for next data packet. */ \& - ret = read(data_socket, buffer, sizeof(buffer)); - if (ret == \-1) { + r = read(data_socket, buffer, sizeof(buffer)); + if (r == \-1) { perror("read"); exit(EXIT_FAILURE); } @@ -1057,13 +1064,17 @@ main(int argc, char *argv[]) \& if (!strncmp(buffer, "DOWN", sizeof(buffer))) { down_flag = 1; - break; + continue; } \& if (!strncmp(buffer, "END", sizeof(buffer))) { break; } \& + if (down_flag) { + continue; + } +\& /* Add received summand. */ \& result += atoi(buffer); @@ -1072,8 +1083,8 @@ main(int argc, char *argv[]) /* Send result. */ \& sprintf(buffer, "%d", result); - ret = write(data_socket, buffer, sizeof(buffer)); - if (ret == \-1) { + w = write(data_socket, buffer, sizeof(buffer)); + if (w == \-1) { perror("write"); exit(EXIT_FAILURE); } @@ -1097,27 +1108,32 @@ main(int argc, char *argv[]) \& exit(EXIT_SUCCESS); } -\& +.EE +.\" SRC END +.P +.\" SRC BEGIN (client.c) +.EX /* * File client.c */ \& -#include <errno.h> #include <stdio.h> #include <stdlib.h> #include <string.h> #include <sys/socket.h> #include <sys/un.h> #include <unistd.h> +\& #include "connection.h" \& int main(int argc, char *argv[]) { - struct sockaddr_un addr; - int ret; - int data_socket; - char buffer[BUFFER_SIZE]; + int ret; + int data_socket; + ssize_t r, w; + struct sockaddr_un addr; + char buffer[BUFFER_SIZE]; \& /* Create local socket. */ \& @@ -1149,9 +1165,9 @@ main(int argc, char *argv[]) \& /* Send arguments. */ \& - for (size_t i = 1; i < argc; ++i) { - ret = write(data_socket, argv[i], strlen(argv[i]) + 1); - if (ret == \-1) { + for (int i = 1; i < argc; ++i) { + w = write(data_socket, argv[i], strlen(argv[i]) + 1); + if (w == \-1) { perror("write"); break; } @@ -1160,16 +1176,16 @@ main(int argc, char *argv[]) /* Request result. */ \& strcpy(buffer, "END"); - ret = write(data_socket, buffer, strlen(buffer) + 1); - if (ret == \-1) { + w = write(data_socket, buffer, strlen(buffer) + 1); + if (w == \-1) { perror("write"); exit(EXIT_FAILURE); } \& /* Receive result. */ \& - ret = read(data_socket, buffer, sizeof(buffer)); - if (ret == \-1) { + r = read(data_socket, buffer, sizeof(buffer)); + if (r == \-1) { perror("read"); exit(EXIT_FAILURE); } @@ -1187,6 +1203,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .EE +.\" SRC END .P For examples of the use of .BR SCM_RIGHTS , diff --git a/upstream/fedora-rawhide/man7/uri.7 b/upstream/fedora-rawhide/man7/uri.7 index 6f4a3523..6823b458 100644 --- a/upstream/fedora-rawhide/man7/uri.7 +++ b/upstream/fedora-rawhide/man7/uri.7 @@ -25,7 +25,7 @@ .\" Modified Fri Aug 21 23:00:00 1999 by David A. Wheeler (dwheeler@dwheeler.com) .\" Modified Tue Mar 14 2000 by David A. Wheeler (dwheeler@dwheeler.com) .\" -.TH uri 7 2023-10-31 "Linux man-pages 6.06" +.TH uri 7 2023-10-31 "Linux man-pages 6.7" .SH NAME uri, url, urn \- uniform resource identifier (URI), including a URL or URN .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man7/user-keyring.7 b/upstream/fedora-rawhide/man7/user-keyring.7 index 809b1076..137c6911 100644 --- a/upstream/fedora-rawhide/man7/user-keyring.7 +++ b/upstream/fedora-rawhide/man7/user-keyring.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH user-keyring 7 2023-10-31 "Linux man-pages 6.06" +.TH user-keyring 7 2023-10-31 "Linux man-pages 6.7" .SH NAME user-keyring \- per-user keyring .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/user-session-keyring.7 b/upstream/fedora-rawhide/man7/user-session-keyring.7 index cb3e7ac7..7af56f08 100644 --- a/upstream/fedora-rawhide/man7/user-session-keyring.7 +++ b/upstream/fedora-rawhide/man7/user-session-keyring.7 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH user-session-keyring 7 2023-10-31 "Linux man-pages 6.06" +.TH user-session-keyring 7 2023-10-31 "Linux man-pages 6.7" .SH NAME user-session-keyring \- per-user default session keyring .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/user_namespaces.7 b/upstream/fedora-rawhide/man7/user_namespaces.7 index 3f8b95db..94e07859 100644 --- a/upstream/fedora-rawhide/man7/user_namespaces.7 +++ b/upstream/fedora-rawhide/man7/user_namespaces.7 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH user_namespaces 7 2023-10-31 "Linux man-pages 6.06" +.TH user_namespaces 7 2024-02-25 "Linux man-pages 6.7" .SH NAME user_namespaces \- overview of Linux user namespaces .SH DESCRIPTION @@ -289,7 +289,7 @@ allows (since Linux 4.6) that process to the mount the cgroup version 2 filesystem and cgroup version 1 named hierarchies (i.e., cgroup filesystems mounted with the -.I """none,name=""" +.I \[dq]none,name=\[dq] option). .P Holding diff --git a/upstream/fedora-rawhide/man7/utf-8.7 b/upstream/fedora-rawhide/man7/utf-8.7 index e2dbf619..077fa424 100644 --- a/upstream/fedora-rawhide/man7/utf-8.7 +++ b/upstream/fedora-rawhide/man7/utf-8.7 @@ -7,7 +7,7 @@ .\" 2001-05-11 Markus Kuhn <mgk25@cl.cam.ac.uk> .\" Update .\" -.TH UTF-8 7 2024-01-28 "Linux man-pages 6.06" +.TH UTF-8 7 2024-03-14 "Linux man-pages 6.7" .SH NAME UTF-8 \- an ASCII compatible multibyte Unicode encoding .SH DESCRIPTION @@ -33,8 +33,7 @@ does not have these problems and is the common way in which Unicode is used on UNIX-style operating systems. .SS Properties The UTF-8 encoding has the following nice properties: -.TP 0.2i -* +.IP \[bu] 3 UCS characters 0x00000000 to 0x0000007f (the classic US-ASCII characters) are encoded simply as bytes 0x00 to 0x7f (ASCII @@ -43,24 +42,19 @@ This means that files and strings which contain only 7-bit ASCII characters have the same encoding under both ASCII and -UTF-8 . -.TP -* +UTF-8. +.IP \[bu] All UCS characters greater than 0x7f are encoded as a multibyte sequence consisting only of bytes in the range 0x80 to 0xfd, so no ASCII byte can appear as part of another character and there are no problems with, for example, \[aq]\e0\[aq] or \[aq]/\[aq]. -.TP -* +.IP \[bu] The lexicographic sorting order of UCS-4 strings is preserved. -.TP -* +.IP \[bu] All possible 2\[ha]31 UCS codes can be encoded using UTF-8. -.TP -* +.IP \[bu] The bytes 0xc0, 0xc1, 0xfe, and 0xff are never used in the UTF-8 encoding. -.TP -* +.IP \[bu] The first byte of a multibyte sequence which represents a single non-ASCII UCS character is always in the range 0xc2 to 0xfd and indicates how long this multibyte sequence is. @@ -68,8 +62,7 @@ All further bytes in a multibyte sequence are in the range 0x80 to 0xbf. This allows easy resynchronization and makes the encoding stateless and robust against missing bytes. -.TP -* +.IP \[bu] UTF-8 encoded UCS characters may be up to six bytes long, however the Unicode standard specifies no characters above 0x10ffff, so Unicode characters can be only up to four bytes long in @@ -77,7 +70,7 @@ UTF-8. .SS Encoding The following byte sequences are used to represent a character. The sequence to be used depends on the UCS code number of the character: -.TP 0.4i +.TP 0x00000000 \- 0x0000007F: .RI 0 xxxxxxx .TP diff --git a/upstream/fedora-rawhide/man7/uts_namespaces.7 b/upstream/fedora-rawhide/man7/uts_namespaces.7 index 659cd8ef..0b2a9a07 100644 --- a/upstream/fedora-rawhide/man7/uts_namespaces.7 +++ b/upstream/fedora-rawhide/man7/uts_namespaces.7 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" -.TH uts_namespaces 7 2023-10-31 "Linux man-pages 6.06" +.TH uts_namespaces 7 2023-10-31 "Linux man-pages 6.7" .SH NAME uts_namespaces \- overview of Linux UTS namespaces .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man7/vdso.7 b/upstream/fedora-rawhide/man7/vdso.7 index 1ad838a9..d37360cd 100644 --- a/upstream/fedora-rawhide/man7/vdso.7 +++ b/upstream/fedora-rawhide/man7/vdso.7 @@ -11,7 +11,7 @@ .\" http://www.linuxjournal.com/content/creating-vdso-colonels-other-chicken .\" http://www.trilithium.com/johan/2005/08/linux-gate/ .\" -.TH vDSO 7 2023-10-31 "Linux man-pages 6.06" +.TH vDSO 7 2024-02-18 "Linux man-pages 6.7" .SH NAME vdso \- overview of the virtual ELF dynamic shared object .SH SYNOPSIS @@ -173,7 +173,7 @@ x86/x32 linux\-vdso.so.1 .ft P \} .SS strace(1), seccomp(2), and the vDSO -When tracing systems calls with +When tracing system calls with .BR strace (1), symbols (system calls) that are exported by the vDSO will .I not diff --git a/upstream/fedora-rawhide/man7/vsock.7 b/upstream/fedora-rawhide/man7/vsock.7 index 520cdb72..3d679c0f 100644 --- a/upstream/fedora-rawhide/man7/vsock.7 +++ b/upstream/fedora-rawhide/man7/vsock.7 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH vsock 7 2023-10-31 "Linux man-pages 6.06" +.TH vsock 7 2024-02-25 "Linux man-pages 6.7" .SH NAME vsock \- Linux VSOCK address family .SH SYNOPSIS @@ -156,7 +156,7 @@ for testing applications on a single host and for debugging. The local CID obtained with .B IOCTL_VM_SOCKETS_GET_LOCAL_CID can be used for the same purpose, but it is preferable to use -.B VMADDR_CID_LOCAL . +.BR VMADDR_CID_LOCAL . .SH ERRORS .TP .B EACCES diff --git a/upstream/fedora-rawhide/man7/x25.7 b/upstream/fedora-rawhide/man7/x25.7 index 02bd4254..73ef2f3f 100644 --- a/upstream/fedora-rawhide/man7/x25.7 +++ b/upstream/fedora-rawhide/man7/x25.7 @@ -4,7 +4,7 @@ .\" .\" $Id: x25.7,v 1.4 1999/05/18 10:35:12 freitag Exp $ .\" -.TH x25 7 2024-01-28 "Linux man-pages 6.06" +.TH x25 7 2024-01-28 "Linux man-pages 6.7" .SH NAME x25 \- diff --git a/upstream/fedora-rawhide/man7/xattr.7 b/upstream/fedora-rawhide/man7/xattr.7 index 367eacbd..c90aaf8e 100644 --- a/upstream/fedora-rawhide/man7/xattr.7 +++ b/upstream/fedora-rawhide/man7/xattr.7 @@ -6,7 +6,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH xattr 7 2023-10-31 "Linux man-pages 6.06" +.TH xattr 7 2023-10-31 "Linux man-pages 6.7" .SH NAME xattr \- Extended attributes .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man8/atd.8 b/upstream/fedora-rawhide/man8/atd.8 index 78606b89..77367133 100644 --- a/upstream/fedora-rawhide/man8/atd.8 +++ b/upstream/fedora-rawhide/man8/atd.8 @@ -45,6 +45,7 @@ in the foreground. Process the at/batch queue only once. This is primarily of use for compatibility with old versions of .BR at ; +.TP .B \-n Append the hostname of the system to the subject of the e-mails sent by .BR atd . diff --git a/upstream/fedora-rawhide/man8/bridge.8 b/upstream/fedora-rawhide/man8/bridge.8 index a60964bb..eeea4073 100644 --- a/upstream/fedora-rawhide/man8/bridge.8 +++ b/upstream/fedora-rawhide/man8/bridge.8 @@ -188,6 +188,25 @@ bridge \- show / manipulate bridge addresses and devices .IR SRC_VNI " ]" .ti -8 +.B "bridge mdb flush" +.BI dev " DEV " +.RB "[ " port +.IR PORT " ]" +.RB "[ " vid +.IR VID " ]" +.RB "[ " src_vni +.IR SRC_VNI " ]" +.RB "[ " proto +.IR PROTO " ]" +.RB "[ " [no]permanent " ]" +.RB "[ " dst +.IR IPADDR " ]" +.RB "[ " dst_port +.IR DST_PORT " ]" +.RB "[ " vni +.IR VNI " ]" + +.ti -8 .BR "bridge vlan" " { " add " | " del " } " .B dev .I DEV @@ -1172,6 +1191,54 @@ the VLAN ID. Only relevant when the bridge is VLAN-aware. the source VNI Network Identifier. Only relevant when the VXLAN device is in external mode. +.SS bridge mdb flush - flush multicast group database entries. + +This command flushes the matching multicast group database entries. + +.TP +.BI dev " DEV" +the interface where this group address is associated. + +.TP +.BI port " PORT" +the target port for the operation. If the bridge device is specified then only +entries pointing to the bridge itself will be deleted. + +.TP +.BI vid " VID" +the VLAN ID for the operation. Match entries only with the specified VLAN ID. + +.TP +.BI src_vni " SRC_VNI" +the source VNI Network Identifier for the operation. Match entries only with +the specified source VNI. + +.TP +.BI proto " PROTO" +the routing protocol identifier for the operation. Match entries only with the +specified routing protocol. Can be a number or a string from the file +/etc/iproute2/rt_protos. + +.TP +.B [no]permanent +if specified then only permanent entries will be deleted or respectively if +"no" is prepended then only non-permanent (temp) entries will be deleted. + +.TP +.BI dst " IPADDR" +the IP address of the destination VXLAN tunnel endpoint where the multicast +receivers reside. Match entries only with the specified destination IP. + +.TP +.BI dst_port " DST_PORT" +the UDP destination port number to use to connect to the remote VXLAN tunnel +endpoint. Match entries only with the specified destination port number. + +.TP +.BI vni " VNI" +the VXLAN VNI Network Identifier to use to connect to the remote VXLAN tunnel +endpoint. Match entries only with the specified destination VNI. + .SH bridge vlan - VLAN filter list .B vlan diff --git a/upstream/fedora-rawhide/man8/btrfs-balance.8 b/upstream/fedora-rawhide/man8/btrfs-balance.8 index c30684c6..47379bab 100644 --- a/upstream/fedora-rawhide/man8/btrfs-balance.8 +++ b/upstream/fedora-rawhide/man8/btrfs-balance.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-BALANCE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-BALANCE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-balance \- balance block groups on a btrfs filesystem .SH SYNOPSIS @@ -185,7 +185,7 @@ or \fIraid6\fP .INDENT 7.0 .TP .B \-\-background|\-\-bg -run the balance operation asynchronously in the background, uses \fBfork(2)\fP to +run the balance operation asynchronously in the background, uses \fI\%fork(2)\fP to start the process that calls the kernel ioctl .UNINDENT .INDENT 7.0 diff --git a/upstream/fedora-rawhide/man8/btrfs-check.8 b/upstream/fedora-rawhide/man8/btrfs-check.8 index 59d0a764..2bf7ae98 100644 --- a/upstream/fedora-rawhide/man8/btrfs-check.8 +++ b/upstream/fedora-rawhide/man8/btrfs-check.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-CHECK" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-CHECK" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-check \- check or repair a btrfs filesystem .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-convert.8 b/upstream/fedora-rawhide/man8/btrfs-convert.8 index fded5087..56a5b527 100644 --- a/upstream/fedora-rawhide/man8/btrfs-convert.8 +++ b/upstream/fedora-rawhide/man8/btrfs-convert.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-CONVERT" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-CONVERT" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-convert \- convert from ext2/3/4 or reiserfs filesystem to btrfs in-place .SH SYNOPSIS @@ -76,6 +76,16 @@ have a supported data block size (i.e. the same that would be valid for \fBmkfs.btrfs\fP). This is typically the system page size (4KiB on x86_64 machines). .sp +\fBNOTE:\fP +.INDENT 0.0 +.INDENT 3.5 +Always consider if a mkfs and file copy would not be a better option than +the in\-place conversion given what was said above. The conversion depends on +3rd party libraries and the other filesystems could still evolve and add new +features. Not all combinations are covered or tested. +.UNINDENT +.UNINDENT +.sp \fBBEFORE YOU START\fP .sp The source filesystem must be clean, e.g. no journal to replay or no repairs diff --git a/upstream/fedora-rawhide/man8/btrfs-device.8 b/upstream/fedora-rawhide/man8/btrfs-device.8 index 5789f4fa..795dc42b 100644 --- a/upstream/fedora-rawhide/man8/btrfs-device.8 +++ b/upstream/fedora-rawhide/man8/btrfs-device.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-DEVICE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-DEVICE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-device \- manage devices of btrfs filesystems .SH SYNOPSIS @@ -186,9 +186,9 @@ $ btrfs device remove /dev/sda /mnt Add device(s) to the filesystem identified by \fIpath\fP\&. .sp If applicable, a whole device discard (TRIM) operation is performed prior to -adding the device. A device with existing filesystem detected by \fBblkid(8)\fP +adding the device. A device with existing filesystem detected by \fI\%blkid(8)\fP will prevent device addition and has to be forced. Alternatively the filesystem -can be wiped from the device using e.g. the \fBwipefs(8)\fP tool. +can be wiped from the device using e.g. the \fI\%wipefs(8)\fP tool. .sp The operation is instant and does not affect existing data. The operation merely adds the device to the filesystem structures and creates some block groups diff --git a/upstream/fedora-rawhide/man8/btrfs-filesystem.8 b/upstream/fedora-rawhide/man8/btrfs-filesystem.8 index f73467d9..dcf12d42 100644 --- a/upstream/fedora-rawhide/man8/btrfs-filesystem.8 +++ b/upstream/fedora-rawhide/man8/btrfs-filesystem.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-FILESYSTEM" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-FILESYSTEM" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-filesystem \- command group that primarily does work on the whole filesystems .SH SYNOPSIS @@ -292,7 +292,7 @@ Subvolume containing a swapfile cannot be snapshotted and blocks of an activated swapfile cannot be balanced. .sp Swapfile creation can be achieved by standalone commands too. Activation -needs to be done by command \fBswapon(8)\fP\&. See also command +needs to be done by command \fI\%swapon(8)\fP\&. See also command \fBbtrfs inspect\-internal map\-swapfile\fP and the \fI\%Swapfile feature\fP description. .sp @@ -346,12 +346,21 @@ device respecting \fIdevid\fP (remember, devid 1 by default). .sp The resize command does not manipulate the size of underlying partition. If you wish to enlarge/reduce a filesystem, you must make sure you -can expand the partition before enlarging the filesystem and shrink the -partition after reducing the size of the filesystem. This can done using -\fBfdisk(8)\fP or \fBparted(8)\fP to delete the existing partition and recreate +expand the partition before enlarging the filesystem and shrink the +partition after reducing the size of the filesystem. This can be done using +\fI\%fdisk(8)\fP or \fI\%parted(8)\fP to delete the existing partition and recreate it with the new desired size. When recreating the partition make sure to use the same starting partition offset as before. .sp +The size of the portion that the filesystem uses of an underlying device can be +determined via the \fBbtrfs filesystem show \-\-raw\fP command on the +filesystem’s mount point (where it’s given for each \fIdevid\fP after the string +\fIsize\fP or via the \fBbtrfs inspect\-internal dump\-super\fP command on the +specific device (where it’s given as the value of \fIdev_item.total_bytes\fP, which +is not to be confused with \fItotal_bytes\fP). +The value is also the address of the first byte not used by the +filesystem. +.sp Growing is usually instant as it only updates the size. However, shrinking could take a long time if there are data in the device area that\(aqs beyond the new end. Relocation of the data takes time. @@ -411,7 +420,7 @@ show sizes in TiB, or TB with \-\-si .UNINDENT .TP .B sync <path> -Force a sync of the filesystem at \fIpath\fP, similar to the \fBsync(1)\fP command. In +Force a sync of the filesystem at \fIpath\fP, similar to the \fI\%sync(1)\fP command. In addition, it starts cleaning of deleted subvolumes. To wait for the subvolume deletion to complete use the \fBbtrfs subvolume sync\fP command. .TP diff --git a/upstream/fedora-rawhide/man8/btrfs-find-root.8 b/upstream/fedora-rawhide/man8/btrfs-find-root.8 index 4dd6969d..0ff3ba65 100644 --- a/upstream/fedora-rawhide/man8/btrfs-find-root.8 +++ b/upstream/fedora-rawhide/man8/btrfs-find-root.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-FIND-ROOT" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-FIND-ROOT" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-find-root \- filter to find btrfs root .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-image.8 b/upstream/fedora-rawhide/man8/btrfs-image.8 index c369ee4d..2264e673 100644 --- a/upstream/fedora-rawhide/man8/btrfs-image.8 +++ b/upstream/fedora-rawhide/man8/btrfs-image.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-IMAGE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-IMAGE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-image \- create/restore an image of the filesystem .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-inspect-internal.8 b/upstream/fedora-rawhide/man8/btrfs-inspect-internal.8 index 25160caf..7e000ca4 100644 --- a/upstream/fedora-rawhide/man8/btrfs-inspect-internal.8 +++ b/upstream/fedora-rawhide/man8/btrfs-inspect-internal.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-INSPECT-INTERNAL" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-INSPECT-INTERNAL" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-inspect-internal \- query various internal information .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-map-logical.8 b/upstream/fedora-rawhide/man8/btrfs-map-logical.8 index c40866f1..f4d5b242 100644 --- a/upstream/fedora-rawhide/man8/btrfs-map-logical.8 +++ b/upstream/fedora-rawhide/man8/btrfs-map-logical.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-MAP-LOGICAL" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-MAP-LOGICAL" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-map-logical \- map btrfs logical extent to physical extent .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-property.8 b/upstream/fedora-rawhide/man8/btrfs-property.8 index 1d7330d6..6d88335a 100644 --- a/upstream/fedora-rawhide/man8/btrfs-property.8 +++ b/upstream/fedora-rawhide/man8/btrfs-property.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-PROPERTY" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-PROPERTY" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-property \- get/set/list properties for given filesystem object .SH SYNOPSIS @@ -40,8 +40,8 @@ The object can be an inode (file or directory), subvolume or the whole filesystem. .sp \fBbtrfs property\fP provides an unified and user\-friendly method to tune different -btrfs properties instead of using the traditional method like \fBchattr(1)\fP or -\fBlsattr(1)\fP\&. +btrfs properties instead of using the traditional method like \fI\%chattr(1)\fP or +\fI\%lsattr(1)\fP\&. .SS Object types .sp A property might apply to several object types so in some cases it\(aqs necessary @@ -174,7 +174,7 @@ returned in case of failure. .SH SEE ALSO .sp \fI\%mkfs.btrfs(8)\fP, -\fBlsattr(1)\fP, -\fBchattr(1)\fP +\fI\%lsattr(1)\fP, +\fI\%chattr(1)\fP .\" Generated by docutils manpage writer. . diff --git a/upstream/fedora-rawhide/man8/btrfs-qgroup.8 b/upstream/fedora-rawhide/man8/btrfs-qgroup.8 index 71718ce5..b9ad3abe 100644 --- a/upstream/fedora-rawhide/man8/btrfs-qgroup.8 +++ b/upstream/fedora-rawhide/man8/btrfs-qgroup.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-QGROUP" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-QGROUP" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-qgroup \- control the quota group of a btrfs filesystem .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-quota.8 b/upstream/fedora-rawhide/man8/btrfs-quota.8 index e1181252..daf38d0b 100644 --- a/upstream/fedora-rawhide/man8/btrfs-quota.8 +++ b/upstream/fedora-rawhide/man8/btrfs-quota.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-QUOTA" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-QUOTA" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-quota \- control the global quota status of a btrfs filesystem .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-receive.8 b/upstream/fedora-rawhide/man8/btrfs-receive.8 index d206b010..3d8969e3 100644 --- a/upstream/fedora-rawhide/man8/btrfs-receive.8 +++ b/upstream/fedora-rawhide/man8/btrfs-receive.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-RECEIVE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-RECEIVE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-receive \- receive subvolumes from send stream .SH SYNOPSIS @@ -67,7 +67,7 @@ read the stream from \fIFILE\fP instead of stdin, .INDENT 0.0 .TP .B \-C|\-\-chroot -confine the process to \fIpath\fP using \fBchroot(1)\fP +confine the process to \fIpath\fP using \fI\%chroot(1)\fP .UNINDENT .INDENT 0.0 .TP diff --git a/upstream/fedora-rawhide/man8/btrfs-replace.8 b/upstream/fedora-rawhide/man8/btrfs-replace.8 index d5bb007c..c87d0448 100644 --- a/upstream/fedora-rawhide/man8/btrfs-replace.8 +++ b/upstream/fedora-rawhide/man8/btrfs-replace.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-REPLACE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-REPLACE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-replace \- replace devices managed by btrfs with other device .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-rescue.8 b/upstream/fedora-rawhide/man8/btrfs-rescue.8 index 441e07c0..0ae778c3 100644 --- a/upstream/fedora-rawhide/man8/btrfs-rescue.8 +++ b/upstream/fedora-rawhide/man8/btrfs-rescue.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-RESCUE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-RESCUE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-rescue \- recover a damaged btrfs filesystem .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-restore.8 b/upstream/fedora-rawhide/man8/btrfs-restore.8 index 79916614..0c1ee6a5 100644 --- a/upstream/fedora-rawhide/man8/btrfs-restore.8 +++ b/upstream/fedora-rawhide/man8/btrfs-restore.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-RESTORE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-RESTORE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-restore \- try to restore files from a damaged filesystem image .SH SYNOPSIS @@ -106,7 +106,7 @@ dry run (only list files that would be recovered) .INDENT 0.0 .TP .BI \-\-path\-regex \ <regex> -restore only filenames matching a regular expression (\fBregex(7)\fP) +restore only filenames matching a regular expression (\fI\%regex(7)\fP) with a mandatory format .sp \fB^/(|home(|/username(|/Desktop(|/.*))))$\fP diff --git a/upstream/fedora-rawhide/man8/btrfs-scrub.8 b/upstream/fedora-rawhide/man8/btrfs-scrub.8 index e415fac8..5535a7c9 100644 --- a/upstream/fedora-rawhide/man8/btrfs-scrub.8 +++ b/upstream/fedora-rawhide/man8/btrfs-scrub.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-SCRUB" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-SCRUB" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-scrub \- scrub btrfs filesystem, verify block checksums .SH SYNOPSIS @@ -68,13 +68,13 @@ scrub only a selected device. See \fI\%btrfs scrub start\fP for more. \fBNOTE:\fP .INDENT 0.0 .INDENT 3.5 -The \fBionice(1)\fP may not be generally supported by all IO schedulers and +The \fI\%ionice(1)\fP may not be generally supported by all IO schedulers and the options to \fBbtrfs scrub start\fP may not work as expected. .UNINDENT .UNINDENT .sp In the past when the \fI\%CFQ IO scheduler\fP was generally used -the \fBionice(1)\fP syscalls set the priority to \fIidle\fP so the IO would not +the \fI\%ionice(1)\fP syscalls set the priority to \fIidle\fP so the IO would not interfere with regular IO. Since the kernel 5.0 the CFQ is not available. .sp The IO scheduler known to support that is \fI\%BFQ\fP, but first read the @@ -91,7 +91,7 @@ belong to the same accounting group. .sp .nf .ft C -$ systemd\-run \-p \(dqIOBandwidthReadMax=/dev/sdx 10M\(dq btrfs scrub start \-B / +$ systemd\-run \-p \(dqIOReadBandwidthMax=/dev/sdx 10M\(dq btrfs scrub start \-B / .ft P .fi .UNINDENT @@ -226,14 +226,14 @@ necessary .INDENT 7.0 .TP .BI \-c \ <ioprio_class> -set IO priority class (see \fBionice(1)\fP manual page) if the IO +set IO priority class (see \fI\%ionice(1)\fP manual page) if the IO scheduler configured for the device supports ionice. This is only supported by BFQ or Kyber but is \fInot\fP supported by mq\-deadline. Please read the section about \fI\%IO limiting\fP\&. .TP .BI \-n \ <ioprio_classdata> -set IO priority classdata (see \fBionice(1)\fP manpage) +set IO priority classdata (see \fI\%ionice(1)\fP manpage) .TP .B \-q (deprecated) alias for global \fI\-q\fP option diff --git a/upstream/fedora-rawhide/man8/btrfs-select-super.8 b/upstream/fedora-rawhide/man8/btrfs-select-super.8 index cbf1079a..5e839dc2 100644 --- a/upstream/fedora-rawhide/man8/btrfs-select-super.8 +++ b/upstream/fedora-rawhide/man8/btrfs-select-super.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-SELECT-SUPER" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-SELECT-SUPER" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-select-super \- overwrite primary superblock with a backup copy .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-send.8 b/upstream/fedora-rawhide/man8/btrfs-send.8 index 0f0ca7d8..2244a134 100644 --- a/upstream/fedora-rawhide/man8/btrfs-send.8 +++ b/upstream/fedora-rawhide/man8/btrfs-send.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-SEND" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-SEND" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-send \- generate a stream of changes between two subvolume snapshots .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfs-subvolume.8 b/upstream/fedora-rawhide/man8/btrfs-subvolume.8 index 1ac17e3e..7a888b7d 100644 --- a/upstream/fedora-rawhide/man8/btrfs-subvolume.8 +++ b/upstream/fedora-rawhide/man8/btrfs-subvolume.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS-SUBVOLUME" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS-SUBVOLUME" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs-subvolume \- manage btrfs subvolumes .SH SYNOPSIS @@ -41,7 +41,8 @@ snapshots. A BTRFS subvolume is a part of filesystem with its own independent file/directory hierarchy and inode number namespace. Subvolumes can share file extents. A snapshot is also subvolume, but with a given initial content of the -original subvolume. A subvolume has always inode number 256. +original subvolume. A subvolume has always inode number 256 (see more in +\fI\%Inode numbers (in Subvolumes)\fP). .sp \fBNOTE:\fP .INDENT 0.0 @@ -200,10 +201,28 @@ the 4th column: .UNINDENT .SH INODE NUMBERS .sp -A proper subvolume has always inode number 256. If a subvolume is nested and -then a snapshot is taken, then the cloned directory entry representing the -subvolume becomes empty and the inode has number 2. All other files and -directories in the target snapshot preserve their original inode numbers. +A directory representing a subvolume has always inode number 256 (sometimes +also called a root of the subvolume): +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +$ ls \-lis +total 0 +389111 0 drwxr\-xr\-x 1 user users 0 Jan 20 12:13 dir +389110 0 \-rw\-r\-\-r\-\- 1 user users 0 Jan 20 12:13 file + 256 0 drwxr\-xr\-x 1 user users 0 Jan 20 12:13 snap1 + 256 0 drwxr\-xr\-x 1 user users 0 Jan 20 12:13 subv1 +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +If a subvolume is nested and then a snapshot is taken, then the cloned +directory entry representing the subvolume becomes empty and the inode has +number 2. All other files and directories in the target snapshot preserve their +original inode numbers. .sp \fBNOTE:\fP .INDENT 0.0 @@ -333,16 +352,6 @@ wait for transaction commit after deleting each subvolume. .B \-i|\-\-subvolid <subvolid> subvolume id to be removed instead of the <path> that should point to the filesystem with the subvolume -.UNINDENT -.INDENT 7.0 -.TP -.B \-\-delete\-qgroup -also delete the qgroup 0/subvolid if it exists -.TP -.B \-\-no\-delete\-qgroup -do not delete the 0/subvolid qgroup (default) -.UNINDENT -.INDENT 7.0 .TP .B \-v|\-\-verbose (deprecated) alias for global \fI\-v\fP option @@ -568,6 +577,6 @@ returned in case of failure. \fI\%btrfs\-quota(8)\fP, \fI\%btrfs\-send(8)\fP, \fI\%mkfs.btrfs(8)\fP, -\fBmount(8)\fP +\fI\%mount(8)\fP .\" Generated by docutils manpage writer. . diff --git a/upstream/fedora-rawhide/man8/btrfs.8 b/upstream/fedora-rawhide/man8/btrfs.8 index f20beee4..03238359 100644 --- a/upstream/fedora-rawhide/man8/btrfs.8 +++ b/upstream/fedora-rawhide/man8/btrfs.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFS" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFS" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfs \- a toolbox to manage btrfs filesystems .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/btrfstune.8 b/upstream/fedora-rawhide/man8/btrfstune.8 index 94cc266f..0db3476e 100644 --- a/upstream/fedora-rawhide/man8/btrfstune.8 +++ b/upstream/fedora-rawhide/man8/btrfstune.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "BTRFSTUNE" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "BTRFSTUNE" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME btrfstune \- tune various filesystem parameters .SH SYNOPSIS @@ -134,7 +134,7 @@ change operation in case it was interrupted. .BI \-U \ <UUID> Change fsid to \fIUUID\fP in all metadata blocks. .sp -The \fIUUID\fP should be a 36 bytes string in \fBprintf(3)\fP format +The \fIUUID\fP should be a 36 bytes string in \fI\%printf(3)\fP format \fB%08x\-%04x\-%04x\-%04x\-%012x\fP\&. If there is a previous unfinished fsid change, it will continue only if the \fIUUID\fP matches the unfinished one or if you use the option \fI\-u\fP\&. diff --git a/upstream/fedora-rawhide/man8/devlink-rate.8 b/upstream/fedora-rawhide/man8/devlink-rate.8 index bcec3c31..f09ac4ac 100644 --- a/upstream/fedora-rawhide/man8/devlink-rate.8 +++ b/upstream/fedora-rawhide/man8/devlink-rate.8 @@ -149,7 +149,7 @@ These parameter accept integer meaning weight or priority of a node. - set rate object parent to existing node with name \fINODE_NAME\fR or unset parent. Rate limits of the parent node applied to all it's children. Actual behaviour is details of driver's implementation. Setting parent to empty ("") -name due to the kernel logic threated as parent unset. +name due to the kernel logic treated as parent unset. .SS devlink port function rate add - create node rate object with specified parameters. Creates rate object of type node and sets parameters. Parameters same as for the diff --git a/upstream/fedora-rawhide/man8/dnf-builddep.8 b/upstream/fedora-rawhide/man8/dnf4-builddep.8 index be5ddc99..fdd13b99 100644 --- a/upstream/fedora-rawhide/man8/dnf-builddep.8 +++ b/upstream/fedora-rawhide/man8/dnf4-builddep.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-BUILDDEP" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-BUILDDEP" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-builddep \- DNF builddep Plugin +dnf4-builddep \- DNF builddep Plugin .sp Install whatever is needed to build the given .src.rpm, .nosrc.rpm or .spec file. .sp diff --git a/upstream/fedora-rawhide/man8/dnf-changelog.8 b/upstream/fedora-rawhide/man8/dnf4-changelog.8 index f1f1e2c7..b7569796 100644 --- a/upstream/fedora-rawhide/man8/dnf-changelog.8 +++ b/upstream/fedora-rawhide/man8/dnf4-changelog.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-CHANGELOG" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-CHANGELOG" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-changelog \- DNF changelog Plugin +dnf4-changelog \- DNF changelog Plugin .SH DESCRIPTION .sp \fIchangelog\fP is a plugin for viewing package changelogs. diff --git a/upstream/fedora-rawhide/man8/dnf-config-manager.8 b/upstream/fedora-rawhide/man8/dnf4-config-manager.8 index c8e86088..c9b55d1f 100644 --- a/upstream/fedora-rawhide/man8/dnf-config-manager.8 +++ b/upstream/fedora-rawhide/man8/dnf4-config-manager.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-CONFIG-MANAGER" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-CONFIG-MANAGER" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-config-manager \- DNF config-manager Plugin +dnf4-config-manager \- DNF config-manager Plugin .sp Manage main and repository DNF configuration options, toggle which repositories are enabled or disabled, and add new repositories. diff --git a/upstream/fedora-rawhide/man8/dnf-copr.8 b/upstream/fedora-rawhide/man8/dnf4-copr.8 index 39447de6..ef4d5ded 100644 --- a/upstream/fedora-rawhide/man8/dnf-copr.8 +++ b/upstream/fedora-rawhide/man8/dnf4-copr.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-COPR" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-COPR" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-copr \- DNF copr Plugin +dnf4-copr \- DNF copr Plugin .sp Work with Copr & Playground repositories on the local system. .INDENT 0.0 diff --git a/upstream/fedora-rawhide/man8/dnf-debug.8 b/upstream/fedora-rawhide/man8/dnf4-debug.8 index e794ec80..850e5e1d 100644 --- a/upstream/fedora-rawhide/man8/dnf-debug.8 +++ b/upstream/fedora-rawhide/man8/dnf4-debug.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-DEBUG" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-DEBUG" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-debug \- DNF debug Plugin +dnf4-debug \- DNF debug Plugin .SH DESCRIPTION .sp The plugin provides two dnf commands: diff --git a/upstream/fedora-rawhide/man8/dnf-debuginfo-install.8 b/upstream/fedora-rawhide/man8/dnf4-debuginfo-install.8 index 67276b58..9d197322 100644 --- a/upstream/fedora-rawhide/man8/dnf-debuginfo-install.8 +++ b/upstream/fedora-rawhide/man8/dnf4-debuginfo-install.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-DEBUGINFO-INSTALL" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-DEBUGINFO-INSTALL" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-debuginfo-install \- DNF debuginfo-install Plugin +dnf4-debuginfo-install \- DNF debuginfo-install Plugin .sp Install the associated debuginfo packages for a given package specification. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-download.8 b/upstream/fedora-rawhide/man8/dnf4-download.8 index f54a51a5..7fdba0bc 100644 --- a/upstream/fedora-rawhide/man8/dnf-download.8 +++ b/upstream/fedora-rawhide/man8/dnf4-download.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-DOWNLOAD" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-DOWNLOAD" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-download \- DNF download Plugin +dnf4-download \- DNF download Plugin .sp Download binary or source packages. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-generate_completion_cache.8 b/upstream/fedora-rawhide/man8/dnf4-generate_completion_cache.8 index 522247f7..d9550937 100644 --- a/upstream/fedora-rawhide/man8/dnf-generate_completion_cache.8 +++ b/upstream/fedora-rawhide/man8/dnf4-generate_completion_cache.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-GENERATE_COMPLETION_CACHE" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-GENERATE_COMPLETION_CACHE" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-generate_completion_cache \- DNF generate_completion_cache Plugin +dnf4-generate_completion_cache \- DNF generate_completion_cache Plugin .sp Generates data to speed up shell completion for DNF. The user is not supposed to interact with the plugin in any way. .SH AUTHOR diff --git a/upstream/fedora-rawhide/man8/dnf-groups-manager.8 b/upstream/fedora-rawhide/man8/dnf4-groups-manager.8 index 0dcd49d7..9870f83a 100644 --- a/upstream/fedora-rawhide/man8/dnf-groups-manager.8 +++ b/upstream/fedora-rawhide/man8/dnf4-groups-manager.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-GROUPS-MANAGER" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-GROUPS-MANAGER" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-groups-manager \- DNF groups-manager Plugin +dnf4-groups-manager \- DNF groups-manager Plugin .sp Create and edit groups repository metadata files. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-needs-restarting.8 b/upstream/fedora-rawhide/man8/dnf4-needs-restarting.8 index 7a110fd9..b65a0ade 100644 --- a/upstream/fedora-rawhide/man8/dnf-needs-restarting.8 +++ b/upstream/fedora-rawhide/man8/dnf4-needs-restarting.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-NEEDS-RESTARTING" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-NEEDS-RESTARTING" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-needs-restarting \- DNF needs_restarting Plugin +dnf4-needs-restarting \- DNF needs_restarting Plugin .sp Check for running processes that should be restarted. .SH SYNOPSIS @@ -40,6 +40,43 @@ Check for running processes that should be restarted. \fIneeds\-restarting\fP looks through running processes and tries to detect those that use files from packages that have been updated after the given process started. Such processes are reported by this tool. .sp Note that in most cases a process should survive update of its binary and libraries it is using without requiring to be restarted for proper operation. There are however specific cases when this does not apply. Separately, processes often need to be restarted to reflect security updates. +.sp +\fBNOTE:\fP +.INDENT 0.0 +.INDENT 3.5 +Needs\-restarting will try to guess the boot time using three different methods: +.INDENT 0.0 +.TP +.B \fBUnitsLoadStartTimestamp\fP +D\-Bus property on \fB/org/freedesktop/systemd1\fP\&. +Works unless the system was not booted with systemd, +such as in (most) containers. +.TP +.B \fBst_mtime of /proc/1\fP +Reflects the time the first process was run after booting. +This works for all known cases except machines without +a RTC—they awake at the start of the epoch. +.TP +.B \fB/proc/uptime\fP +Seconds field of \fB/proc/uptime\fP subtracted from the current time. +Works for machines without RTC if the current time is reasonably correct. +Does not work on containers which share their kernel with the +host—there, the host kernel uptime is returned. +.UNINDENT +.UNINDENT +.UNINDENT +.sp +\fBWARNING:\fP +.INDENT 0.0 +.INDENT 3.5 +Some systems are configured to read the RTC time in the local time +zone. This mode cannot be fully supported. It will create various problems +with time zone changes and daylight saving time adjustments. The RTC time +is never updated, it relies on external facilities to maintain it. \fBIf at +all possible, use RTC in UTC by calling\fP \fBtimedatectl set\-local\-rtc 0\fP\&. +See \fBman timedatectl\fP for more information. +.UNINDENT +.UNINDENT .SH OPTIONS .sp All general DNF options are accepted, see \fIOptions\fP in \fBdnf(8)\fP for details. diff --git a/upstream/fedora-rawhide/man8/dnf-repoclosure.8 b/upstream/fedora-rawhide/man8/dnf4-repoclosure.8 index ea4522ec..f72c958e 100644 --- a/upstream/fedora-rawhide/man8/dnf-repoclosure.8 +++ b/upstream/fedora-rawhide/man8/dnf4-repoclosure.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-REPOCLOSURE" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-REPOCLOSURE" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-repoclosure \- DNF repoclosure Plugin +dnf4-repoclosure \- DNF repoclosure Plugin .sp Display a list of unresolved dependencies for repositories. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-repodiff.8 b/upstream/fedora-rawhide/man8/dnf4-repodiff.8 index df1c516f..c6ed3cbb 100644 --- a/upstream/fedora-rawhide/man8/dnf-repodiff.8 +++ b/upstream/fedora-rawhide/man8/dnf4-repodiff.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-REPODIFF" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-REPODIFF" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-repodiff \- DNF repodiff Plugin +dnf4-repodiff \- DNF repodiff Plugin .sp Display a list of differences between two or more repositories .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-repograph.8 b/upstream/fedora-rawhide/man8/dnf4-repograph.8 index 1c7b54d7..e9dfdc60 100644 --- a/upstream/fedora-rawhide/man8/dnf-repograph.8 +++ b/upstream/fedora-rawhide/man8/dnf4-repograph.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-REPOGRAPH" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-REPOGRAPH" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-repograph \- DNF repograph Plugin +dnf4-repograph \- DNF repograph Plugin .sp Output a full package dependency graph in dot format. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-repomanage.8 b/upstream/fedora-rawhide/man8/dnf4-repomanage.8 index 76023665..cdd3dc34 100644 --- a/upstream/fedora-rawhide/man8/dnf-repomanage.8 +++ b/upstream/fedora-rawhide/man8/dnf4-repomanage.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-REPOMANAGE" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-REPOMANAGE" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-repomanage \- DNF repomanage Plugin +dnf4-repomanage \- DNF repomanage Plugin .sp Manage a repository or a simple directory of rpm packages. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-reposync.8 b/upstream/fedora-rawhide/man8/dnf4-reposync.8 index 063df921..d81fec33 100644 --- a/upstream/fedora-rawhide/man8/dnf-reposync.8 +++ b/upstream/fedora-rawhide/man8/dnf4-reposync.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-REPOSYNC" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-REPOSYNC" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-reposync \- DNF reposync Plugin +dnf4-reposync \- DNF reposync Plugin .sp Synchronize packages of a remote DNF repository to a local directory. .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/dnf-system-upgrade.8 b/upstream/fedora-rawhide/man8/dnf4-system-upgrade.8 index 90558dc1..ab6606a4 100644 --- a/upstream/fedora-rawhide/man8/dnf-system-upgrade.8 +++ b/upstream/fedora-rawhide/man8/dnf4-system-upgrade.8 @@ -27,9 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "DNF-SYSTEM-UPGRADE" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "DNF4-SYSTEM-UPGRADE" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME -dnf-system-upgrade \- DNF system-upgrade Plugin +dnf4-system-upgrade \- DNF system-upgrade Plugin .SH DESCRIPTION .sp DNF system\-upgrades plugin provides three commands: \fBsystem\-upgrade\fP, \fBoffline\-upgrade\fP, and diff --git a/upstream/fedora-rawhide/man8/fsck.btrfs.8 b/upstream/fedora-rawhide/man8/fsck.btrfs.8 index 02a04994..ea461241 100644 --- a/upstream/fedora-rawhide/man8/fsck.btrfs.8 +++ b/upstream/fedora-rawhide/man8/fsck.btrfs.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "FSCK.BTRFS" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "FSCK.BTRFS" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME fsck.btrfs \- do nothing, successfully .SH SYNOPSIS @@ -37,7 +37,7 @@ fsck.btrfs \- do nothing, successfully .sp \fBfsck.btrfs\fP is a type of utility that should exist for any filesystem and is called during system setup when the corresponding \fB/etc/fstab\fP entries -contain non\-zero value for \fIfs_passno\fP, see \fBfstab(5)\fP for more. +contain non\-zero value for \fIfs_passno\fP, see \fI\%fstab(5)\fP for more. .sp Traditional filesystems need to run their respective fsck utility in case the filesystem was not unmounted cleanly and the log needs to be replayed before @@ -68,7 +68,7 @@ Operational error, e.g. device does not exist .SH SEE ALSO .sp \fI\%btrfs(8)\fP, -\fBfsck(8)\fP, -\fBfstab(5)\fP +\fI\%fsck(8)\fP, +\fI\%fstab(5)\fP .\" Generated by docutils manpage writer. . diff --git a/upstream/fedora-rawhide/man8/grub2-bios-setup.8 b/upstream/fedora-rawhide/man8/grub2-bios-setup.8 index fa4e5363..f2dd0f7c 100644 --- a/upstream/fedora-rawhide/man8/grub2-bios-setup.8 +++ b/upstream/fedora-rawhide/man8/grub2-bios-setup.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-BIOS-SETUP "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-BIOS-SETUP "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-bios-setup \- set up a device to boot using GRUB .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-install.8 b/upstream/fedora-rawhide/man8/grub2-install.8 index 3a455310..f12f4477 100644 --- a/upstream/fedora-rawhide/man8/grub2-install.8 +++ b/upstream/fedora-rawhide/man8/grub2-install.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-INSTALL "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-INSTALL "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-install \- install GRUB to a device .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-mkconfig.8 b/upstream/fedora-rawhide/man8/grub2-mkconfig.8 index 6c62e799..b9f22b02 100644 --- a/upstream/fedora-rawhide/man8/grub2-mkconfig.8 +++ b/upstream/fedora-rawhide/man8/grub2-mkconfig.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MKCONFIG "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-MKCONFIG "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-mkconfig \- generate a GRUB configuration file .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-probe.8 b/upstream/fedora-rawhide/man8/grub2-probe.8 index eeb328e6..1ea29310 100644 --- a/upstream/fedora-rawhide/man8/grub2-probe.8 +++ b/upstream/fedora-rawhide/man8/grub2-probe.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-PROBE "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-PROBE "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-probe \- probe device information for GRUB .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-reboot.8 b/upstream/fedora-rawhide/man8/grub2-reboot.8 index 46beae18..dba8fe30 100644 --- a/upstream/fedora-rawhide/man8/grub2-reboot.8 +++ b/upstream/fedora-rawhide/man8/grub2-reboot.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-REBOOT "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-REBOOT "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-reboot \- set the default boot entry for GRUB, for the next boot only .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-set-default.8 b/upstream/fedora-rawhide/man8/grub2-set-default.8 index 3a7b0c59..e6b875cb 100644 --- a/upstream/fedora-rawhide/man8/grub2-set-default.8 +++ b/upstream/fedora-rawhide/man8/grub2-set-default.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-SET-DEFAULT "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-SET-DEFAULT "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-set-default \- set the saved default boot entry for GRUB .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-set-password.8 b/upstream/fedora-rawhide/man8/grub2-set-password.8 index b0b26a8e..0d610a53 100644 --- a/upstream/fedora-rawhide/man8/grub2-set-password.8 +++ b/upstream/fedora-rawhide/man8/grub2-set-password.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-SET-PASSWORD "8" "February 2024" "The grub bootloader password may only be set by root." "System Administration Utilities" +.TH GRUB-SET-PASSWORD "8" "May 2024" "The grub bootloader password may only be set by root." "System Administration Utilities" .SH NAME grub-set-password \- generate the user.cfg file containing the hashed grub bootloader password .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/grub2-switch-to-blscfg.8 b/upstream/fedora-rawhide/man8/grub2-switch-to-blscfg.8 index c1f3c5a6..42bb9d20 100644 --- a/upstream/fedora-rawhide/man8/grub2-switch-to-blscfg.8 +++ b/upstream/fedora-rawhide/man8/grub2-switch-to-blscfg.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-SWITCH-TO-BLSCFG "8" "February 2024" "GRUB 2.06" "System Administration Utilities" +.TH GRUB-SWITCH-TO-BLSCFG "8" "May 2024" "GRUB 2.06" "System Administration Utilities" .SH NAME grub-switch-to-blscfg \- switch to using BLS config files .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/gssd.8 b/upstream/fedora-rawhide/man8/gssd.8 index 2a5384d3..c735eff6 100644 --- a/upstream/fedora-rawhide/man8/gssd.8 +++ b/upstream/fedora-rawhide/man8/gssd.8 @@ -346,6 +346,15 @@ flag. Equivalent to .BR -l . .TP +.B allowed-enctypes +Allows you to restrict +.B rpc.gssd +to using a subset of the encryption types permitted by the kernel and the krb5 +libraries. This is useful if you need to interoperate with an NFS server that +does not have support for the newer SHA2 and Camellia encryption types, for +example. This configuration file option does not have an equivalent +command-line option. +.TP .B context-timeout Equivalent to .BR -t . diff --git a/upstream/fedora-rawhide/man8/iconvconfig.8 b/upstream/fedora-rawhide/man8/iconvconfig.8 index 51c785c3..ab931d77 100644 --- a/upstream/fedora-rawhide/man8/iconvconfig.8 +++ b/upstream/fedora-rawhide/man8/iconvconfig.8 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH iconvconfig 8 2023-10-31 "Linux man-pages 6.06" +.TH iconvconfig 8 2023-10-31 "Linux man-pages 6.7" .SH NAME iconvconfig \- create iconv module configuration cache .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/intro.8 b/upstream/fedora-rawhide/man8/intro.8 index a023443b..c1368eb2 100644 --- a/upstream/fedora-rawhide/man8/intro.8 +++ b/upstream/fedora-rawhide/man8/intro.8 @@ -7,7 +7,7 @@ .\" Modified Sat Jul 24 17:35:48 1993 by Rik Faith (faith@cs.unc.edu) .\" 2007-10-23 mtk: minor rewrites, and added paragraph on exit status .\" -.TH intro 8 2023-10-31 "Linux man-pages 6.06" +.TH intro 8 2023-10-31 "Linux man-pages 6.7" .SH NAME intro \- introduction to administration and privileged commands .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man8/ip-address.8 b/upstream/fedora-rawhide/man8/ip-address.8 index 8e0de0e9..277c5068 100644 --- a/upstream/fedora-rawhide/man8/ip-address.8 +++ b/upstream/fedora-rawhide/man8/ip-address.8 @@ -146,7 +146,8 @@ ip-address \- protocol address management .BR ipvlan " |" .BR lowpan " |" .BR geneve " |" -.BR macsec " ]" +.BR macsec " |" +.BR netkit " ]" .SH "DESCRIPTION" The diff --git a/upstream/fedora-rawhide/man8/ip-l2tp.8 b/upstream/fedora-rawhide/man8/ip-l2tp.8 index 9aba6bec..7109c0a0 100644 --- a/upstream/fedora-rawhide/man8/ip-l2tp.8 +++ b/upstream/fedora-rawhide/man8/ip-l2tp.8 @@ -392,7 +392,7 @@ If L2TP is being used over IPv6, use the IPv6 defrag module. .SH INTEROPERABILITY .PP Unmanaged (static) L2TPv3 tunnels are supported by some network -equipment equipment vendors such as Cisco. +equipment vendors such as Cisco. .PP In Linux, L2TP Hello messages are not supported in unmanaged tunnels. Hello messages are used by L2TP clients and servers to detect diff --git a/upstream/fedora-rawhide/man8/ip-link.8 b/upstream/fedora-rawhide/man8/ip-link.8 index 209ae825..be01f6e5 100644 --- a/upstream/fedora-rawhide/man8/ip-link.8 +++ b/upstream/fedora-rawhide/man8/ip-link.8 @@ -247,6 +247,7 @@ ip-link \- network device configuration .BR macvlan " | " .BR macvtap " | " .BR netdevsim " |" +.BR netkit " |" .BR nlmon " |" .BR rmnet " |" .BR sit " |" @@ -384,6 +385,9 @@ Link types: .BR netdevsim - Interface for netdev API tests .sp +.BR netkit +- BPF-programmable network device +.sp .BR nlmon - Netlink monitoring device .sp @@ -441,6 +445,11 @@ TCP for IPv6 on this device when the size is greater than 65536. specifies the recommended maximum size of a IPv4 Generic Segment Offload packet the new device should accept. This is especially used to enable BIG TCP for IPv4 on this device by setting to a size greater than 65536. +Note that +.B gso_max_size +needs to be set to a size greater than or equal to +.B gso_ipv4_max_size +to really enable BIG TCP for IPv4. .TP .BI gso_max_segs " SEGMENTS " @@ -849,6 +858,46 @@ tunnel. .in -8 .TP +netkit Type Support +For a link of type +.I netkit +the following additional arguments are supported: + +.BI "ip link add " DEVICE +.BR type " netkit " +[ +.BI mode " MODE " +] [ +.I "POLICY " +] [ +.BR peer +[ +.I "POLICY " +] [ +.I "NAME " +] ] + +.in +8 + +.sp +.BI mode " MODE" +- specifies the operation mode of the netkit device with "l3" and "l2" +as possible values. Default option is "l3". + +.sp +.I "POLICY" +- specifies the default device policy when no BPF programs are attached +with "forward" and "blackhole" as possible values. Default option is +"forward". Specifying policy before the peer option refers to the primary +device, after the peer option refers to the peer device. + +.sp +.I "NAME" +- specifies the device name of the peer device. + +.in -8 + +.TP IPIP, SIT Type Support For a link of type .IR IPIP or SIT diff --git a/upstream/fedora-rawhide/man8/ip.8 b/upstream/fedora-rawhide/man8/ip.8 index 72227d44..fdae57c5 100644 --- a/upstream/fedora-rawhide/man8/ip.8 +++ b/upstream/fedora-rawhide/man8/ip.8 @@ -19,10 +19,12 @@ ip \- show / manipulate routing, network devices, interfaces and tunnels .ti -8 .IR OBJECT " := { " -.BR link " | " address " | " addrlabel " | " route " | " rule " | " neigh " | "\ - ntable " | " tunnel " | " tuntap " | " maddress " | " mroute " | " mrule " | "\ - monitor " | " xfrm " | " netns " | " l2tp " | " tcp_metrics " | " token " | "\ - macsec " | " vrf " | " mptcp " | " ioam " | " stats " }" +.BR address " | " addrlabel " | " fou " | " help " | " ila " | " ioam " | "\ + l2tp " | " link " | " macsec " | " maddress " | " monitor " | " mptcp " | "\ + mroute " | " mrule " | " neighbor " | " neighbour " | " netconf " | "\ + netns " | " nexthop " | " ntable " | " ntbl " | " route " | " rule " | "\ + sr " | " tap " | " tcpmetrics " | " token " | " tunnel " | " tuntap " | "\ + vrf " | " xfrm " }" .sp .ti -8 @@ -255,6 +257,14 @@ Request the kernel to send the applied configuration back. - label configuration for protocol address selection. .TP +.B fou +- Foo-over-UDP receive port configuration. + +.TP +.B ila +- manage identifier locator addresses (ILA). + +.TP .B ioam - manage IOAM namespaces and IOAM schemas. @@ -267,6 +277,10 @@ Request the kernel to send the applied configuration back. - network device. .TP +.B macsec +- MACsec device configuration. + +.TP .B maddress - multicast address. @@ -291,10 +305,18 @@ Request the kernel to send the applied configuration back. - manage ARP or NDISC cache entries. .TP +.B netconf +- network configuration monitoring. + +.TP .B netns - manage network namespaces. .TP +.B nexthop +- manage nexthop objects. + +.TP .B ntable - manage the neighbor cache's operation. @@ -307,12 +329,16 @@ Request the kernel to send the applied configuration back. - rule in routing policy database. .TP +.B sr +- manage IPv6 segment routing. + +.TP .B stats - manage and show interface statistics. .TP .B tcp_metrics/tcpmetrics -- manage TCP Metrics +- manage TCP Metrics. .TP .B token @@ -415,19 +441,24 @@ was written by Alexey N. Kuznetsov and added in Linux 2.2. .SH SEE ALSO .BR ip-address (8), .BR ip-addrlabel (8), +.BR ip-fou (8), .BR ip-ioam (8), .BR ip-l2tp (8), .BR ip-link (8), +.BR ip-macsec (8), .BR ip-maddress (8), .BR ip-monitor (8), .BR ip-mptcp (8), .BR ip-mroute (8), .BR ip-neighbour (8), +.BR ip-netconf (8), .BR ip-netns (8), +.BR ip-nexthop (8), .BR ip-ntable (8), .BR ip-route (8), .BR ip-rule (8), -.BR ip-stats (8) +.BR ip-sr (8), +.BR ip-stats (8), .BR ip-tcp_metrics (8), .BR ip-token (8), .BR ip-tunnel (8), diff --git a/upstream/fedora-rawhide/man8/kernel-install.8 b/upstream/fedora-rawhide/man8/kernel-install.8 index 6c8d93d9..06b06a4e 100644 --- a/upstream/fedora-rawhide/man8/kernel-install.8 +++ b/upstream/fedora-rawhide/man8/kernel-install.8 @@ -1,5 +1,5 @@ '\" t -.TH "KERNEL\-INSTALL" "8" "" "systemd 255" "kernel-install" +.TH "KERNEL\-INSTALL" "8" "" "systemd 256~rc3" "kernel-install" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -25,6 +25,8 @@ kernel-install \- Add and remove kernel and initrd images to and from /boot .HP \w'\fBkernel\-install\fR\ 'u \fBkernel\-install\fR [OPTIONS...] add \fIKERNEL\-VERSION\fR \fIKERNEL\-IMAGE\fR [\fIINITRD\-FILE\fR...] .HP \w'\fBkernel\-install\fR\ 'u +\fBkernel\-install\fR [OPTIONS...] add\-all +.HP \w'\fBkernel\-install\fR\ 'u \fBkernel\-install\fR [OPTIONS...] remove \fIKERNEL\-VERSION\fR .HP \w'\fBkernel\-install\fR\ 'u \fBkernel\-install\fR [OPTIONS...] inspect [\fIKERNEL\-VERSION\fR] [\fIKERNEL\-IMAGE\fR] [\fIINITRD\-FILE\fR...] @@ -454,7 +456,7 @@ Print a short version string and exit\&. Do not pipe output into a pager\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Shows output formatted as JSON\&. Expects one of "short" @@ -634,7 +636,14 @@ will be prepended before can be set to override the location of the configuration files read by \fBkernel\-install\fR\&. When set, install\&.conf, -entry\-token, and other files will be read from this directory\&. +entry\-token, and other files will be read from this directory only\&. Note that this path is relative to the host, and in particular +\fIsymlinks in this directory are resolved relative to the host\fR, even if +\fB\-\-root=\fR\fB\fIroot\fR\fR +is used\&. This means that it is generally +\fInot\fR +correct to use this variable to specify a directory underneath +\fIroot\fR +if symlinks are used there\&. .PP \fI$KERNEL_INSTALL_PLUGINS\fR can be set to override the list of plugins executed by @@ -745,7 +754,7 @@ will be used\&. Added in version 198\&. .RE .PP -/etc/kernel/install\&.conf, /usr/lib/kernel/install\&.conf +/etc/kernel/install\&.conf, /run/kernel/install\&.conf, /usr/local/lib/kernel/install\&.conf, /usr/lib/kernel/install\&.conf, /etc/kernel/install\&.conf\&.d/*\&.conf, /run/kernel/install\&.conf\&.d/*\&.conf, /usr/local/lib/kernel/install\&.conf\&.d/*\&.conf, /usr/lib/kernel/install\&.conf\&.d/*\&.conf .RS 4 Configuration file with options for \fBkernel\-install\fR, as a series of @@ -753,7 +762,8 @@ Configuration file with options for assignments, compatible with shell syntax, following the same rules as described in \fBos-release\fR(5)\&. The first of the files that is found will be used\&. \fI$KERNEL_INSTALL_CONF_ROOT\fR -may be used to override the search path; see below for details\&. +may be used to override the search path; see below for details\&. Drop\-in files may also be used to extend the configuration with overrides, see +\fBsystemd.unit\fR(5)\&. .sp Currently, the following keys are supported: \fIMACHINE_ID=\fR, @@ -814,12 +824,7 @@ environment variable is set, it will override the search path\&. The files will from the directory specified by the environment variable\&. When the variable is not set, the listed paths are tried in turn, and the first file that exists is used\&. .SH "SEE ALSO" .PP -\fBmachine-id\fR(5), -\fBos-release\fR(5), -\fBdepmod\fR(8), -\fBsystemd-boot\fR(7), -\fBukify\fR(1), -\m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[2]\d\s+2 +\fBmachine-id\fR(5), \fBos-release\fR(5), \fBdepmod\fR(8), \fBsystemd-boot\fR(7), \fBukify\fR(1), \m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[2]\d\s+2 .SH "NOTES" .IP " 1." 4 Nowadays actually CPIO archives used as an "initramfs", rather than "initrd". See diff --git a/upstream/fedora-rawhide/man8/ld.so.8 b/upstream/fedora-rawhide/man8/ld.so.8 index 39ca874f..8767b501 100644 --- a/upstream/fedora-rawhide/man8/ld.so.8 +++ b/upstream/fedora-rawhide/man8/ld.so.8 @@ -4,7 +4,7 @@ .\" Various parts: .\" Copyright (C) 2007-9, 2013, 2016 Michael Kerrisk <mtk.manpages@gmail.com> .\" -.TH ld.so 8 2024-02-12 "Linux man-pages 6.06" +.TH ld.so 8 2024-02-12 "Linux man-pages 6.7" .SH NAME ld.so, ld\-linux.so \- dynamic linker/loader .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/ldconfig.8 b/upstream/fedora-rawhide/man8/ldconfig.8 index 7efb67fa..1b517421 100644 --- a/upstream/fedora-rawhide/man8/ldconfig.8 +++ b/upstream/fedora-rawhide/man8/ldconfig.8 @@ -5,7 +5,7 @@ .\" .\" Modified, 6 May 2002, Michael Kerrisk, <mtk.manpages@gmail.com> .\" Change listed order of /usr/lib and /lib -.TH ldconfig 8 2023-10-31 "Linux man-pages 6.06" +.TH ldconfig 8 2023-10-31 "Linux man-pages 6.7" .SH NAME ldconfig \- configure dynamic linker run-time bindings .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/lspci.8 b/upstream/fedora-rawhide/man8/lspci.8 index 4bfd1a7b..e541de04 100644 --- a/upstream/fedora-rawhide/man8/lspci.8 +++ b/upstream/fedora-rawhide/man8/lspci.8 @@ -1,4 +1,4 @@ -.TH lspci 8 "25 February 2024" "pciutils-3.11.1" "The PCI Utilities" +.TH lspci 8 "05 April 2024" "pciutils-3.12.0" "The PCI Utilities" .SH NAME lspci \- list all PCI devices .SH SYNOPSIS @@ -116,7 +116,7 @@ Show PCI vendor and device codes as both numbers and names. Use DNS to query the central PCI ID database if a device is not found in the local .B pci.ids file. If the DNS query succeeds, the result is cached in -.B ~/.pciids-cache +.B $XDG_CACHE_HOME/pci-ids and it is recognized in subsequent runs even if .B -q is not given any more. Please use this switch inside automated scripts only @@ -345,7 +345,7 @@ utility to download the most recent version. .B /usr/share/hwdata/pci.ids.gz If lspci is compiled with support for compression, this file is tried before pci.ids. .TP -.B ~/.pciids-cache +.B $XDG_CACHE_HOME/pci-ids All ID's found in the DNS query mode are cached in this file. .SH BUGS diff --git a/upstream/fedora-rawhide/man8/makepkg.8 b/upstream/fedora-rawhide/man8/makepkg.8 index 997369c2..7294cbfb 100644 --- a/upstream/fedora-rawhide/man8/makepkg.8 +++ b/upstream/fedora-rawhide/man8/makepkg.8 @@ -2,12 +2,12 @@ .\" Title: makepkg .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "MAKEPKG" "8" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "MAKEPKG" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -101,7 +101,7 @@ PKGDEST .PP \fB\-g, \-\-geninteg\fR .RS 4 -For each source file in the source array of PKGBUILD, download the file if required and generate integrity checks\&. The integrity checks generated are determined by the checks present in the PKGBUILD, falling back to the value of the INTEGRITY_CHECK array in makepkg\&.conf(5) if these are absent This output can be redirected into your PKGBUILD for source validation using "makepkg \-g >> PKGBUILD"\&. +For each source file in the source array of PKGBUILD, download the file if required and generate integrity checks\&. The integrity checks generated are determined by the checks present in the PKGBUILD, falling back to the value of the INTEGRITY_CHECK array in makepkg\&.conf(5) if these are absent\&. This output can be redirected into your PKGBUILD for source validation using "makepkg \-g >> PKGBUILD"\&. .RE .PP \fB\-\-skipinteg\fR @@ -198,6 +198,11 @@ Display version information\&. Remove the $srcdir before building the package\&. .RE .PP +\fB\-D\fR <dir>, \fB\-\-dir\fR <dir> +.RS 4 +Change to directory <dir> before reading the PKGBUILD or doing anything else\&. +.RE +.PP \fB\-\-allsource\fR .RS 4 Do not actually build the package, but build a source\-only tarball that includes all sources, including those that are normally downloaded via makepkg\&. This is useful for passing a single tarball to another program such as a chroot or remote builder\&. It will also satisfy requirements of the GPL when distributing binary packages\&. @@ -224,6 +229,11 @@ Do not run the check() function in the PKGBUILD or handle the checkdepends\&. Do not run the prepare() function in the PKGBUILD\&. .RE .PP +\fB\-\-noverify\fR +.RS 4 +Do not run the verify() function in the PKGBUILD\&. +.RE +.PP \fB\-\-sign\fR .RS 4 Sign the resulting package with gpg, overriding the setting in @@ -286,6 +296,11 @@ makepkg is designed to be compatible with Reproducible Builds\&. If the \fBSOURC If the \fBSOURCE_DATE_EPOCH\fR environment variable is not set, makepkg will use its own start date for internal use, but will not unify source file timestamps before building\&. .SH "ENVIRONMENT VARIABLES" .PP +\fBMAKEPKG_LIBRARY\fR="/path/to/directory" +.RS 4 +Use an alternative libmakepkg path instead of the /usr/share/makepkg default\&. +.RE +.PP \fBPACMAN\fR .RS 4 The command that will be used to check for missing dependencies and to install and remove packages\&. Pacman\(cqs @@ -382,6 +397,11 @@ The version of the \fI$BUILDTOOL\fR used\&. .RE +.PP +\fBGITFLAGS\fR +.RS 4 +The options to pass when checking out git sources, replacing the default "\-\-mirror"\&. +.RE .SH "CONFIGURATION" .sp See \fBmakepkg.conf\fR(5) for more details on configuring makepkg using the \fImakepkg\&.conf\fR file\&. @@ -515,17 +535,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -608,4 +617,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/mkfs.btrfs.8 b/upstream/fedora-rawhide/man8/mkfs.btrfs.8 index d3a88275..46c87996 100644 --- a/upstream/fedora-rawhide/man8/mkfs.btrfs.8 +++ b/upstream/fedora-rawhide/man8/mkfs.btrfs.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "MKFS.BTRFS" "8" "Feb 14, 2024" "6.7.1" "BTRFS" +.TH "MKFS.BTRFS" "8" "Mar 26, 2024" "6.8.1" "BTRFS" .SH NAME mkfs.btrfs \- create a btrfs filesystem .SH SYNOPSIS @@ -422,14 +422,23 @@ conversion is not possible. .INDENT 0.0 .TP .B raid\-stripe\-tree -(kernel support since 6.7) +(kernel support since 6.7, CONFIG_BTRFS_DEBUG) .sp -New tree for logical file extent mapping where the physical mapping -may not match on multiple devices. this is now used in zoned mode to +Separate tree for logical file extent mapping where the physical mapping +may not match on multiple devices. This is now used in zoned mode to implement RAID0/RAID1* profiles, but can be used in non\-zoned mode as well. The support for RAID56 is in development and will eventually fix the problems with the current implementation. This is a backward incompatible feature and has to be enabled at mkfs time. +.sp +\fBNOTE:\fP +.INDENT 7.0 +.INDENT 3.5 +Due to the status of implementation it is enabled only in +builds with CONFIG_BTRFS_DEBUG. Support by the kernel module +can be found in the sysfs feature list. +.UNINDENT +.UNINDENT .TP .B squota (kernel support since 6.7) @@ -1009,6 +1018,6 @@ than can fit into the filesystem. \fI\%btrfs(5)\fP, \fI\%btrfs(8)\fP, \fI\%btrfs\-balance(8)\fP, -\fBwipefs(8)\fP +\fI\%wipefs(8)\fP .\" Generated by docutils manpage writer. . diff --git a/upstream/fedora-rawhide/man8/mkfs.xfs.8 b/upstream/fedora-rawhide/man8/mkfs.xfs.8 index 891570d0..e4852572 100644 --- a/upstream/fedora-rawhide/man8/mkfs.xfs.8 +++ b/upstream/fedora-rawhide/man8/mkfs.xfs.8 @@ -504,6 +504,33 @@ directories. By default, .B mkfs.xfs will not enable DAX mode. +.TP +.BI concurrency= value +Create enough allocation groups to handle the desired level of concurrency. +The goal of this calculation scheme is to set the number of allocation groups +to an integer multiple of the number of writer threads desired, to minimize +contention of AG locks. +This scheme will neither create fewer AGs than would be created by the default +configuration, nor will it create AGs smaller than 4GB. +This option is not compatible with the +.B agcount +or +.B agsize +options. +The magic value +.I nr_cpus +or +.I 1 +or no value at all will set this parameter to the number of active processors +in the system. +If the kernel advertises that the data device is a non-mechanical storage +device, +.B mkfs.xfs +will use this new geometry calculation scheme. +The magic value of +.I 0 +forces use of the older AG geometry calculations that is used for mechanical +storage. .RE .TP .B \-f @@ -768,6 +795,25 @@ if you want to disable this feature for older kernels which don't support it. .IP This option is only tunable on the deprecated V4 format. +.TP +.BI concurrency= value +Allocate a log that is estimated to be large enough to handle the desired level +of concurrency without userspace program threads contending for log space. +This scheme will neither create a log smaller than the minimum required, +nor create a log larger than the maximum possible. +This option is only valid for internal logs and is not compatible with the +size option. +This option is not compatible with the +.B logdev +or +.B size +options. +The magic value +.I nr_cpus +or +.I 1 +or no value at all will set this parameter to the number of active processors +in the system. .RE .PP .PD 0 diff --git a/upstream/fedora-rawhide/man8/nscd.8 b/upstream/fedora-rawhide/man8/nscd.8 index 7f505e0f..3d2204e1 100644 --- a/upstream/fedora-rawhide/man8/nscd.8 +++ b/upstream/fedora-rawhide/man8/nscd.8 @@ -6,7 +6,7 @@ .\" 2008-12-05 Petr Baudis <pasky@suse.cz> .\" Rewrite the NOTES section to reflect modern reality .\" -.TH nscd 8 2023-10-31 "Linux man-pages 6.06" +.TH nscd 8 2023-10-31 "Linux man-pages 6.7" .SH NAME nscd \- name service cache daemon .SH DESCRIPTION diff --git a/upstream/fedora-rawhide/man8/nss-myhostname.8 b/upstream/fedora-rawhide/man8/nss-myhostname.8 index d2e92b58..0b9fab58 100644 --- a/upstream/fedora-rawhide/man8/nss-myhostname.8 +++ b/upstream/fedora-rawhide/man8/nss-myhostname.8 @@ -1,5 +1,5 @@ '\" t -.TH "NSS\-MYHOSTNAME" "8" "" "systemd 255" "nss-myhostname" +.TH "NSS\-MYHOSTNAME" "8" "" "systemd 256~rc3" "nss-myhostname" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -173,9 +173,4 @@ In this case, the local hostname is \fIomega\fR\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBnss-systemd\fR(8), -\fBnss-resolve\fR(8), -\fBnss-mymachines\fR(8), -\fBnsswitch.conf\fR(5), -\fBgetent\fR(1) +\fBsystemd\fR(1), \fBnss-systemd\fR(8), \fBnss-resolve\fR(8), \fBnss-mymachines\fR(8), \fBnsswitch.conf\fR(5), \fBgetent\fR(1) diff --git a/upstream/fedora-rawhide/man8/nss-mymachines.8 b/upstream/fedora-rawhide/man8/nss-mymachines.8 index 60a2b3a7..9a540e9c 100644 --- a/upstream/fedora-rawhide/man8/nss-mymachines.8 +++ b/upstream/fedora-rawhide/man8/nss-mymachines.8 @@ -1,5 +1,5 @@ '\" t -.TH "NSS\-MYMACHINES" "8" "" "systemd 255" "nss-mymachines" +.TH "NSS\-MYMACHINES" "8" "" "systemd 256~rc3" "nss-mymachines" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -130,11 +130,4 @@ Connection to machine rawhide terminated\&. .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-machined.service\fR(8), -\fBmachinectl\fR(1), -\fBnss-systemd\fR(8), -\fBnss-resolve\fR(8), -\fBnss-myhostname\fR(8), -\fBnsswitch.conf\fR(5), -\fBgetent\fR(1) +\fBsystemd\fR(1), \fBsystemd-machined.service\fR(8), \fBmachinectl\fR(1), \fBnss-systemd\fR(8), \fBnss-resolve\fR(8), \fBnss-myhostname\fR(8), \fBnsswitch.conf\fR(5), \fBgetent\fR(1) diff --git a/upstream/fedora-rawhide/man8/nss-resolve.8 b/upstream/fedora-rawhide/man8/nss-resolve.8 index 5c12c8d4..f63ec532 100644 --- a/upstream/fedora-rawhide/man8/nss-resolve.8 +++ b/upstream/fedora-rawhide/man8/nss-resolve.8 @@ -1,5 +1,5 @@ '\" t -.TH "NSS\-RESOLVE" "8" "" "systemd 255" "nss-resolve" +.TH "NSS\-RESOLVE" "8" "" "systemd 256~rc3" "nss-resolve" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -165,10 +165,4 @@ netgroup: nis .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-resolved\fR(8), -\fBnss-systemd\fR(8), -\fBnss-myhostname\fR(8), -\fBnss-mymachines\fR(8), -\fBnsswitch.conf\fR(5), -\fBsystemd.syntax\fR(5) +\fBsystemd\fR(1), \fBsystemd-resolved\fR(8), \fBnss-systemd\fR(8), \fBnss-myhostname\fR(8), \fBnss-mymachines\fR(8), \fBnsswitch.conf\fR(5), \fBsystemd.syntax\fR(5) diff --git a/upstream/fedora-rawhide/man8/nss-systemd.8 b/upstream/fedora-rawhide/man8/nss-systemd.8 index 31d5b1ba..07517bbd 100644 --- a/upstream/fedora-rawhide/man8/nss-systemd.8 +++ b/upstream/fedora-rawhide/man8/nss-systemd.8 @@ -1,5 +1,5 @@ '\" t -.TH "NSS\-SYSTEMD" "8" "" "systemd 255" "nss-systemd" +.TH "NSS\-SYSTEMD" "8" "" "systemd 256~rc3" "nss-systemd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -206,16 +206,7 @@ vu\-rawhide\-1000 1637 pts/8 \-zsh .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.exec\fR(5), -\fBnss-resolve\fR(8), -\fBnss-myhostname\fR(8), -\fBnss-mymachines\fR(8), -\fBsystemd-userdbd.service\fR(8), -\fBsystemd-homed.service\fR(8), -\fBsystemd-machined.service\fR(8), -\fBnsswitch.conf\fR(5), -\fBgetent\fR(1) +\fBsystemd\fR(1), \fBsystemd.exec\fR(5), \fBnss-resolve\fR(8), \fBnss-myhostname\fR(8), \fBnss-mymachines\fR(8), \fBsystemd-userdbd.service\fR(8), \fBsystemd-homed.service\fR(8), \fBsystemd-machined.service\fR(8), \fBnsswitch.conf\fR(5), \fBgetent\fR(1) .SH "NOTES" .IP " 1." 4 User/Group Record Lookup API via Varlink diff --git a/upstream/fedora-rawhide/man8/pacman-conf.8 b/upstream/fedora-rawhide/man8/pacman-conf.8 index 4b632ea4..0aff475b 100644 --- a/upstream/fedora-rawhide/man8/pacman-conf.8 +++ b/upstream/fedora-rawhide/man8/pacman-conf.8 @@ -2,12 +2,12 @@ .\" Title: pacman-conf .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "PACMAN\-CONF" "8" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "PACMAN\-CONF" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -52,7 +52,7 @@ Specify an alternate installation root (default is /)\&. .RE .PP -\fB\-r, \-\-repo\fR <remote> +\fB\-r, \-\-repo\fR <repository> .RS 4 Query options for a specific repository\&. .RE @@ -129,17 +129,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -222,4 +211,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/pacman-db-upgrade.8 b/upstream/fedora-rawhide/man8/pacman-db-upgrade.8 new file mode 100644 index 00000000..2b9420b3 --- /dev/null +++ b/upstream/fedora-rawhide/man8/pacman-db-upgrade.8 @@ -0,0 +1,197 @@ +'\" t +.\" Title: pacman-db-upgrade +.\" Author: [see the "Authors" section] +.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> +.\" Date: 2024-04-14 +.\" Manual: Pacman Manual +.\" Source: Pacman 6.1.0 +.\" Language: English +.\" +.TH "PACMAN\-DB\-UPGRADE" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +pacman-db-upgrade \- upgrade the local pacman database to a newer format +.SH "SYNOPSIS" +.sp +\fIpacman\-db\-upgrade\fR [options] +.SH "DESCRIPTION" +.sp +\fIpacman\-db\-upgrade\fR is a script that upgrades the local database used by \fBpacman\fR(8) to a newer format\&. +.sp +Options +.sp +.if n \{\ +.RS 4 +.\} +.nf +*\-h, \e\-\-help*:: +Show the built\-in help message and exit\&. +*\-V, \e\-\-version*:: +Show version information and exit\&. +*\-d, \e\-\-dbpath* <path>:: +Set an alternate database location\&. +*\-r, \e\-\-root* <path>:: +Set an alternate installation root\&. +*\e\-\-config* <path>:: +Set an alternate configuration file\&. +*\e\-\-nocolor*:: +Remove color from output\&. + +See Also +.fi +.if n \{\ +.RE +.\} +.sp +\fBpacman\fR(8) +.sp +See the pacman website at https://archlinux\&.org/pacman/ for current information on pacman and its related tools\&. +.SH "BUGS" +.sp +Bugs? You must be kidding; there are no bugs in this software\&. But if we happen to be wrong, submit a bug report with as much detail as possible at the Arch Linux Bug Tracker in the Pacman section\&. +.SH "AUTHORS" +.sp +Current maintainers: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Allan McRae <allan@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Morgan Adamiec <morganamilo@archlinux\&.org> +.RE +.sp +Past major contributors: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Judd Vinet <jvinet@zeroflux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Aurelien Foret <aurelien@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Aaron Griffin <aaron@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Dan McGee <dan@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Xavier Chantry <shiningxc@gmail\&.com> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Dave Reisner <dreisner@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp +For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/pacman-key.8 b/upstream/fedora-rawhide/man8/pacman-key.8 index a1403f6e..b06a57b6 100644 --- a/upstream/fedora-rawhide/man8/pacman-key.8 +++ b/upstream/fedora-rawhide/man8/pacman-key.8 @@ -2,12 +2,12 @@ .\" Title: pacman-key .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "PACMAN\-KEY" "8" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "PACMAN\-KEY" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -225,17 +225,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -318,4 +307,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/pacman.8 b/upstream/fedora-rawhide/man8/pacman.8 index aed1dc32..6d9f8879 100644 --- a/upstream/fedora-rawhide/man8/pacman.8 +++ b/upstream/fedora-rawhide/man8/pacman.8 @@ -2,12 +2,12 @@ .\" Title: pacman .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "PACMAN" "8" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "PACMAN" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -250,7 +250,8 @@ Disable defaults for low speed limit and timeout on downloads\&. Use this if you .PP \fB\-\-sysroot\fR <dir> .RS 4 -Specify an alternative system root\&. Pacman will chroot and chdir into the system root prior to running\&. This allows mounted guest systems to be properly operated on\&. Any other paths given will be interpreted as relative to the system root\&. Requires root privileges\&. +Specify an alternative system root\&. This path will be prepended to all other configuration directories and any repository servers beginning with +file://\&. Any paths or URLs passed as targets will not be modified\&. This allows mounted guest systems to be properly operated on\&. .RE .SH "TRANSACTION OPTIONS (APPLY TO \FI\-S\FR, \FI\-R\FR AND \FI\-U\FR)" .PP @@ -261,7 +262,7 @@ Skips dependency version checks\&. Package names are still checked\&. Normally, .PP \fB\-\-assume\-installed\fR <package=version> .RS 4 -Add a virtual package "package" with version "version" to the transaction to satisfy dependencies\&. This allows to disable specific dependency checks without affecting all dependency checks\&. To disable all dependency checking, see the +Add a virtual package "package" with version "version" to the transaction to satisfy dependencies\&. This allows disabling the specific dependency checks without affecting all dependency checks\&. To disable all dependency checking, see the \fI\-\-nodeps\fR option\&. .RE @@ -295,7 +296,7 @@ to specify how targets are displayed\&. The default format string is "%l", which .RS 4 Specify a printf\-like format to control the output of the \fI\-\-print\fR -operation\&. The possible attributes are: "%n" for pkgname, "%v" for pkgver, "%l" for location, "%r" for repository, and "%s" for size\&. Implies +operation\&. The possible attributes are: "%a" for arch, "%b" for builddate, "%d" for description, "%e" for pkgbase, "%f" for filename, "%g" for base64 encoded PGP signature, "%h" for sha256sum, "%m" for md5sum, "%n" for pkgname, "%p" for packager, "%v" for pkgver, "%l" for location, "%r" for repository, "%s" for size, "%C" for checkdepends, "%D" for depends, "%G" for groups, "%H" for conflicts, "%L" for licenses, "%M" for makedepends, "%O" for optional depends, "%P" for provides and "%R" for replaces\&. Implies \fI\-\-print\fR\&. .RE .SH "UPGRADE OPTIONS (APPLY TO \FI\-S\FR AND \FI\-U\FR)" @@ -518,7 +519,9 @@ will do a system upgrade and install/upgrade the "foo" package in the same opera .PP \fB\-y, \-\-refresh\fR .RS 4 -Download a fresh copy of the master package database from the server(s) defined in +Download a fresh copy of the master package databases +\fI(repo\&.db)\fR +from the server(s) defined in \fBpacman.conf\fR(5)\&. This should typically be used each time you use \fI\-\-sysupgrade\fR or @@ -553,7 +556,9 @@ Suppress messages on successful completion of database operations\&. .PP \fB\-y, \-\-refresh\fR .RS 4 -Download fresh package databases from the server\&. Use twice to force a refresh even if databases are up to date\&. +Download fresh package file databases +\fI(repo\&.files)\fR +from the server\&. Use twice to force a refresh even if databases are up to date\&. .RE .PP \fB\-l, \-\-list\fR @@ -691,17 +696,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -784,4 +778,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/pam_systemd.8 b/upstream/fedora-rawhide/man8/pam_systemd.8 index 21a69f0e..07843595 100644 --- a/upstream/fedora-rawhide/man8/pam_systemd.8 +++ b/upstream/fedora-rawhide/man8/pam_systemd.8 @@ -1,5 +1,5 @@ '\" t -.TH "PAM_SYSTEMD" "8" "" "systemd 255" "pam_systemd" +.TH "PAM_SYSTEMD" "8" "" "systemd 256~rc3" "pam_systemd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -136,15 +136,80 @@ The following options are understood: .RS 4 Takes a string argument which sets the session class\&. The \fIXDG_SESSION_CLASS\fR -environment variable (see below) takes precedence\&. One of -"user", -"greeter", -"lock\-screen" -or -"background"\&. See +environment variable (see below) takes precedence\&. See \fBsd_session_get_class\fR(3) -for details about the session class\&. +for a way to query the class of a session\&. The following session classes are defined: .sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.B Table\ \&1.\ \&Session Classes +.TS +allbox tab(:); +lB lB. +T{ +Name +T}:T{ +Explanation +T} +.T& +l l +l l +l l +l l +l l +l l +l l +l l +l l. +T{ +\fBuser\fR +T}:T{ +A regular interactive user session\&. This is the default class for sessions for which a TTY or X display is known at session registration time\&. +T} +T{ +\fBuser\-early\fR +T}:T{ +Similar to "user" but sessions of this class are not ordered after systemd\-user\-sessions\&.service, i\&.e\&. may be started before regular sessions are allowed to be established\&. This session class is the default for sessions of the root user that would otherwise qualify for the \fBuser\fR class, see above\&. (Added in v256\&.) +T} +T{ +\fBuser\-incomplete\fR +T}:T{ +Similar to "user" but for sessions which are not fully set up yet, i\&.e\&. have no home directory mounted or similar\&. This is used by \fBsystemd-homed.service\fR(8) to allow users to log in via \fBssh\fR before their home directory is mounted, delaying the mount until the user provided the unlock password\&. Sessions of this class are upgraded to the regular \fBuser\fR class once the home directory is activated\&. +T} +T{ +\fBgreeter\fR +T}:T{ +Similar to "user" but for sessions that are spawned by a display manager ephemerally and which prompt the user for login credentials\&. +T} +T{ +\fBlock\-screen\fR +T}:T{ +Similar to "user" but for sessions that are spawned by a display manager ephemerally and which show a lock screen that can be used to unlock locked user accounts or sessions\&. +T} +T{ +\fBbackground\fR +T}:T{ +Used for background sessions, such as those invoked by \fBcron\fR and similar tools\&. This is the default class for sessions for which no TTY or X display is known at session registration time\&. +T} +T{ +\fBbackground\-light\fR +T}:T{ +Similar to \fBbackground\fR, but sessions of this class will not pull in the user@\&.service of the user, and thus possibly have no services of the user running\&. (Added in v256\&.) +T} +T{ +\fBmanager\fR +T}:T{ +The user@\&.service service of the user is registered under this session class\&. (Added in v256\&.) +T} +T{ +\fBmanager\-early\fR +T}:T{ +Similar to \fBmanager\fR, but for the root user\&. Compare with the \fBuser\fR vs\&. \fBuser\-early\fR situation\&. (Added in v256\&.) +T} +.TE +.sp 1 Added in version 197\&. .RE .PP @@ -397,18 +462,7 @@ session required pam_unix\&.so .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-logind.service\fR(8), -\fBlogind.conf\fR(5), -\fBloginctl\fR(1), -\fBpam_systemd_home\fR(8), -\fBpam.conf\fR(5), -\fBpam.d\fR(5), -\fBpam\fR(8), -\fBpam_loginuid\fR(8), -\fBsystemd.scope\fR(5), -\fBsystemd.slice\fR(5), -\fBsystemd.service\fR(5) +\fBsystemd\fR(1), \fBsystemd-logind.service\fR(8), \fBlogind.conf\fR(5), \fBloginctl\fR(1), \fBpam_systemd_home\fR(8), \fBpam.conf\fR(5), \fBpam.d\fR(5), \fBpam\fR(8), \fBpam_loginuid\fR(8), \fBsystemd.scope\fR(5), \fBsystemd.slice\fR(5), \fBsystemd.service\fR(5) .SH "NOTES" .IP " 1." 4 JSON User Records diff --git a/upstream/fedora-rawhide/man8/pam_systemd_home.8 b/upstream/fedora-rawhide/man8/pam_systemd_home.8 index 866cecd2..d67b0fe4 100644 --- a/upstream/fedora-rawhide/man8/pam_systemd_home.8 +++ b/upstream/fedora-rawhide/man8/pam_systemd_home.8 @@ -1,5 +1,5 @@ '\" t -.TH "PAM_SYSTEMD_HOME" "8" "" "systemd 255" "pam_systemd_home" +.TH "PAM_SYSTEMD_HOME" "8" "" "systemd 256~rc3" "pam_systemd_home" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -134,14 +134,7 @@ session required pam_unix\&.so .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-homed.service\fR(8), -\fBhomed.conf\fR(5), -\fBhomectl\fR(1), -\fBpam_systemd\fR(8), -\fBpam.conf\fR(5), -\fBpam.d\fR(5), -\fBpam\fR(8) +\fBsystemd\fR(1), \fBsystemd-homed.service\fR(8), \fBhomed.conf\fR(5), \fBhomectl\fR(1), \fBpam_systemd\fR(8), \fBpam.conf\fR(5), \fBpam.d\fR(5), \fBpam\fR(8) .SH "NOTES" .IP " 1." 4 JSON user record diff --git a/upstream/fedora-rawhide/man8/pam_systemd_loadkey.8 b/upstream/fedora-rawhide/man8/pam_systemd_loadkey.8 index 679dfd2e..7de8ce75 100644 --- a/upstream/fedora-rawhide/man8/pam_systemd_loadkey.8 +++ b/upstream/fedora-rawhide/man8/pam_systemd_loadkey.8 @@ -1,5 +1,5 @@ '\" t -.TH "PAM_SYSTEMD_LOADKEY" "8" "" "systemd 255" "pam_systemd_loadkey" +.TH "PAM_SYSTEMD_LOADKEY" "8" "" "systemd 256~rc3" "pam_systemd_loadkey" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -44,10 +44,53 @@ The following options are understood: \fIkeyname=\fR .RS 4 Takes a string argument which sets the keyname to read\&. The default is -"cryptsetup", which is used by +"cryptsetup"\&. During boot, \fBsystemd-cryptsetup@.service\fR(8) -to store LUKS passphrase during boot\&. +stores a passphrase or PIN in the keyring\&. The LUKS2 volume key can also be used, via the +\fBlink\-volume\-key\fR +option in +\fBcrypttab\fR(5)\&. .sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.B Table\ \&1.\ \& Possible values for \fIkeyname\fR\&. +.TS +allbox tab(:); +lB lB. +T{ +Value +T}:T{ +Description +T} +.T& +l l +l l +l l +l l. +T{ +cryptsetup +T}:T{ +Passphrase or recovery key +T} +T{ +fido2\-pin +T}:T{ +Security token PIN +T} +T{ +luks2\-pin +T}:T{ +LUKS2 token PIN +T} +T{ +tpm2\-pin +T}:T{ +TPM2 PIN +T} +.TE +.sp 1 Added in version 255\&. .RE .PP @@ -71,6 +114,7 @@ sddm\-autologin): .\} .nf \-auth optional pam_systemd_loadkey\&.so +\-auth optional pam_gnome_keyring\&.so \-session optional pam_gnome_keyring\&.so auto_start \-session optional pam_kwallet5\&.so auto_start diff --git a/upstream/fedora-rawhide/man8/poweroff.8 b/upstream/fedora-rawhide/man8/poweroff.8 index 92c73aa8..d49ad72e 100644 --- a/upstream/fedora-rawhide/man8/poweroff.8 +++ b/upstream/fedora-rawhide/man8/poweroff.8 @@ -1,5 +1,5 @@ '\" t -.TH "POWEROFF" "8" "" "systemd 255" "poweroff" +.TH "POWEROFF" "8" "" "systemd 256~rc3" "poweroff" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -41,7 +41,7 @@ The following options are understood: \fB\-\-help\fR .RS 4 Print a short help text and exit\&. -.PP +.sp Added in version 253\&. .RE .PP @@ -133,7 +133,4 @@ results in halting the machine only (leaving power on), and is required to actually power it off\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBshutdown\fR(8), -\fBwall\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBshutdown\fR(8), \fBwall\fR(1) diff --git a/upstream/fedora-rawhide/man8/repo-add.8 b/upstream/fedora-rawhide/man8/repo-add.8 index dc4ddb43..e821d3a7 100644 --- a/upstream/fedora-rawhide/man8/repo-add.8 +++ b/upstream/fedora-rawhide/man8/repo-add.8 @@ -2,12 +2,12 @@ .\" Title: repo-add .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "REPO\-ADD" "8" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "REPO\-ADD" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -88,6 +88,11 @@ Only add packages that are not already in the database\&. Warnings will be print .RS 4 Remove old package files from the disk when updating their entry in the database\&. .RE +.PP +\fB\-\-include\-sigs\fR +.RS 4 +Include package PGP signatures in the repository database (if available) +.RE .SH "EXAMPLE" .sp \fIrepo\-add\fR foo\&.db\&.tar\&.xz <pkg1> [<pkg2> \&...] @@ -135,17 +140,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -228,4 +222,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/runlevel.8 b/upstream/fedora-rawhide/man8/runlevel.8 index edbabfde..c19e02fc 100644 --- a/upstream/fedora-rawhide/man8/runlevel.8 +++ b/upstream/fedora-rawhide/man8/runlevel.8 @@ -1,5 +1,5 @@ '\" t -.TH "RUNLEVEL" "8" "" "systemd 255" "runlevel" +.TH "RUNLEVEL" "8" "" "systemd 256~rc3" "runlevel" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -125,6 +125,4 @@ Added in version 237\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.target\fR(5), -\fBsystemctl\fR(1) +\fBsystemd\fR(1), \fBsystemd.target\fR(5), \fBsystemctl\fR(1) diff --git a/upstream/fedora-rawhide/man8/setpci.8 b/upstream/fedora-rawhide/man8/setpci.8 index d32e779c..915ce275 100644 --- a/upstream/fedora-rawhide/man8/setpci.8 +++ b/upstream/fedora-rawhide/man8/setpci.8 @@ -1,4 +1,4 @@ -.TH setpci 8 "25 February 2024" "pciutils-3.11.1" "The PCI Utilities" +.TH setpci 8 "05 April 2024" "pciutils-3.12.0" "The PCI Utilities" .SH NAME setpci \- configure PCI devices .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/shutdown.8 b/upstream/fedora-rawhide/man8/shutdown.8 index fa4aafcf..9830273b 100644 --- a/upstream/fedora-rawhide/man8/shutdown.8 +++ b/upstream/fedora-rawhide/man8/shutdown.8 @@ -1,5 +1,5 @@ '\" t -.TH "SHUTDOWN" "8" "" "systemd 255" "shutdown" +.TH "SHUTDOWN" "8" "" "systemd 256~rc3" "shutdown" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -120,7 +120,4 @@ command in previous init systems (including sysvinit) defaulted to single\-user instead\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBhalt\fR(8), -\fBwall\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBhalt\fR(8), \fBwall\fR(1) diff --git a/upstream/fedora-rawhide/man8/sln.8 b/upstream/fedora-rawhide/man8/sln.8 index 30d5177f..29d960b1 100644 --- a/upstream/fedora-rawhide/man8/sln.8 +++ b/upstream/fedora-rawhide/man8/sln.8 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sln 8 2023-10-31 "Linux man-pages 6.06" +.TH sln 8 2023-10-31 "Linux man-pages 6.7" .SH NAME sln \- create symbolic links .SH SYNOPSIS diff --git a/upstream/fedora-rawhide/man8/ss.8 b/upstream/fedora-rawhide/man8/ss.8 index 073e9f03..4ece41fa 100644 --- a/upstream/fedora-rawhide/man8/ss.8 +++ b/upstream/fedora-rawhide/man8/ss.8 @@ -40,6 +40,10 @@ established connections) sockets. .B \-l, \-\-listening Display only listening sockets (these are omitted by default). .TP +.B \-B, \-\-bound-inactive +Display only TCP bound but inactive (not listening, connecting, etc.) sockets +(these are omitted by default). +.TP .B \-o, \-\-options Show timer information. For TCP protocol, the output format is: .RS @@ -456,6 +460,9 @@ states except for - opposite to .B bucket +.B bound-inactive +- bound but otherwise inactive sockets (not listening, connecting, etc.) + .SH EXPRESSION .B EXPRESSION diff --git a/upstream/fedora-rawhide/man8/systemd-ask-password-console.service.8 b/upstream/fedora-rawhide/man8/systemd-ask-password-console.service.8 index fa9566e6..11623084 100644 --- a/upstream/fedora-rawhide/man8/systemd-ask-password-console.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-ask-password-console.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-ASK\-PASSWORD\-CONSOLE\&.SERVICE" "8" "" "systemd 255" "systemd-ask-password-console.service" +.TH "SYSTEMD\-ASK\-PASSWORD\-CONSOLE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-ask-password-console.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,13 +23,18 @@ systemd-ask-password-console.service, systemd-ask-password-console.path, systemd-ask-password-wall.service, systemd-ask-password-wall.path \- Query the user for system passwords on the console and via wall .SH "SYNOPSIS" .PP +.RS 4 systemd\-ask\-password\-console\&.service -.PP +.RE +.RS 4 systemd\-ask\-password\-console\&.path -.PP +.RE +.RS 4 systemd\-ask\-password\-wall\&.service -.PP +.RE +.RS 4 systemd\-ask\-password\-wall\&.path +.RE .SH "DESCRIPTION" .PP systemd\-ask\-password\-console\&.service @@ -51,9 +56,7 @@ or command line parameters\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-tty-ask-password-agent\fR(1), -\fBwall\fR(1) +\fBsystemd\fR(1), \fBsystemd-tty-ask-password-agent\fR(1), \fBwall\fR(1) .SH "NOTES" .IP " 1." 4 developer documentation diff --git a/upstream/fedora-rawhide/man8/systemd-backlight@.service.8 b/upstream/fedora-rawhide/man8/systemd-backlight@.service.8 index 8d42dc12..24d20739 100644 --- a/upstream/fedora-rawhide/man8/systemd-backlight@.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-backlight@.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BACKLIGHT@\&.SERVICE" "8" "" "systemd 255" "systemd-backlight@.service" +.TH "SYSTEMD\-BACKLIGHT@\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-backlight@.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -33,13 +33,22 @@ load [backlight|leds]:DEVICE .SH "DESCRIPTION" .PP systemd\-backlight@\&.service -is a service that restores the display backlight brightness at early boot and saves it at shutdown\&. On disk, the backlight brightness is stored in -/var/lib/systemd/backlight/\&. During loading, if the udev property -\fBID_BACKLIGHT_CLAMP\fR -is not set to false, the brightness is clamped to a value of at least 1 or 5% of maximum brightness, whichever is greater\&. The percentage can be adjusted by specifying a percentage (needs to be suffixed with +is a service that restores the brightness of a display backlight or LED (e\&.g\&. keyboard backlight) device at early boot, and saves it at shutdown\&. The brightness is stored in +/var/lib/systemd/backlight/\&. +.PP +On restoring brightness of a display backlight device, +\fBsystemd\-backlight\fR +reads +\fIID_BACKLIGHT_CLAMP\fR +udev property, that takes a boolean value or a percentage (needs to be suffixed with "%", e\&.g\&. -"30%") to the property -\fBID_BACKLIGHT_CLAMP\fR\&. +"30%")\&. When a percentage is specified, the saved brightness is clamped to a value of at least 1 or the specified percentage of the maximum brightness, whichever is greater\&. When unset or set to true, the brightness is clamped in the same way with percentage 5%\&. When false, the saved brightness will not be clamped, and loaded as is\&. +.PP +On restoring brightness of a LED device, +\fBsystemd\-backlight\fR +reads +\fIID_LEDS_CLAMP\fR +udev property, that also takes a boolean value or a percentage\&. When a percentage is specified, the saved brightness is clamped to the specified percentage of the maximum brightness\&. When set to true, the brightness is clamped in the same way with percentage 5%\&. When unset or set to false, the saved brightness will not be clamped, and loaded as is\&. .SH "KERNEL COMMAND LINE" .PP systemd\-backlight diff --git a/upstream/fedora-rawhide/man8/systemd-battery-check.service.8 b/upstream/fedora-rawhide/man8/systemd-battery-check.service.8 index 3dcd7676..b40e8b1e 100644 --- a/upstream/fedora-rawhide/man8/systemd-battery-check.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-battery-check.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BATTERY\-CHECK\&.SERVICE" "8" "" "systemd 255" "systemd-battery-check" +.TH "SYSTEMD\-BATTERY\-CHECK\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-battery-check" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -53,7 +53,7 @@ On success (running on AC power or battery capacity greater than 5%), 0 is retur .PP The following variables are understood: .PP -\fIsystemd\&.battery\-check=\fR\fI\fIBOOL\fR\fR +\fIsystemd\&.battery_check=\fR\fI\fIBOOL\fR\fR .RS 4 Takes a boolean\&. If specified with false, \fBsystemd\-battery\-check\fR diff --git a/upstream/fedora-rawhide/man8/systemd-binfmt.service.8 b/upstream/fedora-rawhide/man8/systemd-binfmt.service.8 index da878c7a..66522aa7 100644 --- a/upstream/fedora-rawhide/man8/systemd-binfmt.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-binfmt.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BINFMT\&.SERVICE" "8" "" "systemd 255" "systemd-binfmt.service" +.TH "SYSTEMD\-BINFMT\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-binfmt.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -69,6 +69,4 @@ Print a short version string and exit\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBbinfmt.d\fR(5), -\fBwine\fR(8) +\fBsystemd\fR(1), \fBbinfmt.d\fR(5), \fBwine\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-bless-boot-generator.8 b/upstream/fedora-rawhide/man8/systemd-bless-boot-generator.8 index 462e7d90..25324133 100644 --- a/upstream/fedora-rawhide/man8/systemd-bless-boot-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-bless-boot-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BLESS\-BOOT\-GENERATOR" "8" "" "systemd 255" "systemd-bless-boot-generator" +.TH "SYSTEMD\-BLESS\-BOOT\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-bless-boot-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -37,6 +37,4 @@ implements \fBsystemd.generator\fR(7)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-bless-boot.service\fR(8), -\fBsystemd-boot\fR(7) +\fBsystemd\fR(1), \fBsystemd-bless-boot.service\fR(8), \fBsystemd-boot\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-bless-boot.service.8 b/upstream/fedora-rawhide/man8/systemd-bless-boot.service.8 index fc71f4cb..e2f12124 100644 --- a/upstream/fedora-rawhide/man8/systemd-bless-boot.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-bless-boot.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BLESS\-BOOT\&.SERVICE" "8" "" "systemd 255" "systemd-bless-boot.service" +.TH "SYSTEMD\-BLESS\-BOOT\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-bless-boot.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -38,7 +38,7 @@ style boot counting is used\&. Internally, the service operates based on the \fILoaderBootCountPath\fR EFI variable (of the vendor UUID -\fB4a67b082\-0a4c\-41cf\-b6c7\-440b29bb8c4\fR), which is passed from the boot loader to the OS\&. It contains a file system path (relative to the EFI system partition) of the +\fB4a67b082\-0a4c\-41cf\-b6c7\-440b29bb8c4f\fR), which is passed from the boot loader to the OS\&. It contains a file system path (relative to the EFI system partition) of the \m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[1]\d\s+2 compliant boot loader entry file or unified kernel image file that was used to boot up the system\&. \fBsystemd\-bless\-boot\&.service\fR @@ -108,9 +108,7 @@ Print a short version string and exit\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-boot\fR(7), -\fBsystemd.special\fR(7) +\fBsystemd\fR(1), \fBsystemd-boot\fR(7), \fBsystemd.special\fR(7) .SH "NOTES" .IP " 1." 4 Boot Loader Specification diff --git a/upstream/fedora-rawhide/man8/systemd-boot-check-no-failures.service.8 b/upstream/fedora-rawhide/man8/systemd-boot-check-no-failures.service.8 index d3edc66b..4a5705c4 100644 --- a/upstream/fedora-rawhide/man8/systemd-boot-check-no-failures.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-boot-check-no-failures.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BOOT\-CHECK\-NO\-FAILURES\&.SERVICE" "8" "" "systemd 255" "systemd-boot-check-no-failures.service" +.TH "SYSTEMD\-BOOT\-CHECK\-NO\-FAILURES\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-boot-check-no-failures.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -36,5 +36,4 @@ Note that due the simple nature of this check this service is probably not suita boot\-complete\&.target\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.special\fR(7) +\fBsystemd\fR(1), \fBsystemd.special\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-boot-random-seed.service.8 b/upstream/fedora-rawhide/man8/systemd-boot-random-seed.service.8 index 8fb4d033..a33c8f0d 100644 --- a/upstream/fedora-rawhide/man8/systemd-boot-random-seed.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-boot-random-seed.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BOOT\-RANDOM\-SEED\&.SERVICE" "8" "" "systemd 255" "systemd-boot-random-seed.service" +.TH "SYSTEMD\-BOOT\-RANDOM\-SEED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-boot-random-seed.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -100,12 +100,7 @@ service updates the boot loader random seed with a new value derived from the ke This logic should ensure that the kernel\*(Aqs entropy pool is seeded during earliest bool already, if possible, but the highest quality entropy is propagated back to both on\-disk seeds\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBrandom\fR(4), -\fBbootctl\fR(1), -\fBsystemd-boot\fR(7), -\fBsystemd-stub\fR(7), -\fBsystemd-random-seed.service\fR(8) +\fBsystemd\fR(1), \fBrandom\fR(4), \fBbootctl\fR(1), \fBsystemd-boot\fR(7), \fBsystemd-stub\fR(7), \fBsystemd-random-seed.service\fR(8) .SH "NOTES" .IP " 1." 4 Boot Loader Interface diff --git a/upstream/fedora-rawhide/man8/systemd-bsod.service.8 b/upstream/fedora-rawhide/man8/systemd-bsod.service.8 index 0c1fc877..781f8f6f 100644 --- a/upstream/fedora-rawhide/man8/systemd-bsod.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-bsod.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-BSOD\&.SERVICE" "8" "" "systemd 255" "systemd-bsod" +.TH "SYSTEMD\-BSOD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-bsod" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,12 +20,12 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -systemd-bsod.service, systemd-bsod \- Displays boot\-time emergency log message in full screen\&. +systemd-bsod.service, systemd-bsod \- Displays boot\-time emergency log message in full screen .SH "SYNOPSIS" .PP systemd\-bsod\&.service -.HP \w'\fBsystemd\-bsod\fR\ 'u -\fBsystemd\-bsod\fR [OPTIONS...] +.HP \w'\fB/usr/lib/systemd/systemd\-bsod\fR\ 'u +\fB/usr/lib/systemd/systemd\-bsod\fR [OPTIONS...] .SH "DESCRIPTION" .PP systemd\-bsod\&.service @@ -53,6 +53,17 @@ waits continuously for changes in the journal if it doesn\*(Aqt find any emergen .sp Added in version 255\&. .RE +.PP +\fB\-\-tty=\fR\fB\fR +.RS 4 +Specify the TTY to output to\&. By default +\fBsystemd\-bsod\fR +will automatically find a free VT to display the message on\&. If this option is specified a TTY may be selected explicitly\&. Use +\fB\-\-tty=/dev/tty\fR +to direct output to the terminal the command is invoked on\&. +.sp +Added in version 256\&. +.RE .SH "EXIT STATUS" .PP On success (displaying the journal message successfully), 0 is returned, a non\-zero failure code otherwise\&. diff --git a/upstream/fedora-rawhide/man8/systemd-coredump.8 b/upstream/fedora-rawhide/man8/systemd-coredump.8 index 842c5fc9..9167d1d9 100644 --- a/upstream/fedora-rawhide/man8/systemd-coredump.8 +++ b/upstream/fedora-rawhide/man8/systemd-coredump.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-COREDUMP" "8" "" "systemd 255" "systemd-coredump" +.TH "SYSTEMD\-COREDUMP" "8" "" "systemd 256~rc3" "systemd-coredump" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -464,14 +464,7 @@ user\&.coredump\&.exe="/usr/lib64/firefox/firefox" .sp .SH "SEE ALSO" .PP -\fBcoredump.conf\fR(5), -\fBcoredumpctl\fR(1), -\fBsystemd-journald.service\fR(8), -\fBsystemd-tmpfiles\fR(8), -\fBcore\fR(5), -\fBsysctl.d\fR(5), -\fBsystemd-sysctl.service\fR(8), -\m[blue]\fBsystemd Coredump Handling\fR\m[]\&\s-2\u[1]\d\s+2 +\fBcoredump.conf\fR(5), \fBcoredumpctl\fR(1), \fBsystemd-journald.service\fR(8), \fBsystemd-tmpfiles\fR(8), \fBcore\fR(5), \fBsysctl.d\fR(5), \fBsystemd-sysctl.service\fR(8), \m[blue]\fBsystemd Coredump Handling\fR\m[]\&\s-2\u[1]\d\s+2 .SH "NOTES" .IP " 1." 4 systemd Coredump Handling diff --git a/upstream/fedora-rawhide/man8/systemd-cryptsetup-generator.8 b/upstream/fedora-rawhide/man8/systemd-cryptsetup-generator.8 index fda1024a..6ef0e12d 100644 --- a/upstream/fedora-rawhide/man8/systemd-cryptsetup-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-cryptsetup-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-CRYPTSETUP\-GENERATOR" "8" "" "systemd 255" "systemd-cryptsetup-generator" +.TH "SYSTEMD\-CRYPTSETUP\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-cryptsetup-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -223,9 +223,4 @@ Added in version 208\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBcrypttab\fR(5), -\fBsystemd-cryptsetup@.service\fR(8), -\fBsystemd-cryptenroll\fR(1), -\fBcryptsetup\fR(8), -\fBsystemd-fstab-generator\fR(8) +\fBsystemd\fR(1), \fBcrypttab\fR(5), \fBsystemd-cryptsetup@.service\fR(8), \fBsystemd-cryptenroll\fR(1), \fBcryptsetup\fR(8), \fBsystemd-fstab-generator\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-cryptsetup.8 b/upstream/fedora-rawhide/man8/systemd-cryptsetup.8 index cfa85bc0..3af52b7e 100644 --- a/upstream/fedora-rawhide/man8/systemd-cryptsetup.8 +++ b/upstream/fedora-rawhide/man8/systemd-cryptsetup.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-CRYPTSETUP" "8" "" "systemd 255" "systemd-cryptsetup" +.TH "SYSTEMD\-CRYPTSETUP" "8" "" "systemd 256~rc3" "systemd-cryptsetup" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -37,9 +37,9 @@ is used to set up (with \fBattach\fR) and tear down (with \fBdetach\fR) access to an encrypted block device\&. It is primarily used via systemd\-cryptsetup@\&.service -during early boot, but may also be be called manually\&. The positional arguments +during early boot, but may also be called manually\&. The positional arguments \fIVOLUME\fR, -\fISOURCEDEVICE\fR, +\fISOURCE\-DEVICE\fR, \fIKEY\-FILE\fR, and \fICRYPTTAB\-OPTIONS\fR have the same meaning as the fields in @@ -136,14 +136,55 @@ option is set\&. .RE .PP If no suitable key may be acquired via any of the mechanisms describes above, volume activation fails\&. +.SH "CREDENTIALS" +.PP +\fBsystemd\-cryptsetup\fR +supports the service credentials logic as implemented by +\fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR +(see +\fBsystemd.exec\fR(5) +for details)\&. The following credentials are used by +"systemd\-crypsetup@root\&.service" +(generated by +\fBsystemd\-gpt\-auto\-generator\fR) when passed in: +.PP +\fIcryptsetup\&.passphrase\fR +.RS 4 +This credential specifies the passphrase of the LUKS volume\&. +.sp +Added in version 256\&. +.RE +.PP +\fIcryptsetup\&.tpm2\-pin\fR +.RS 4 +This credential specifies the TPM pin\&. +.sp +Added in version 256\&. +.RE +.PP +\fIcryptsetup\&.fido2\-pin\fR +.RS 4 +This credential specifies the FIDO2 token pin\&. +.sp +Added in version 256\&. +.RE +.PP +\fIcryptsetup\&.pkcs11\-pin\fR +.RS 4 +This credential specifies the PKCS11 token pin\&. +.sp +Added in version 256\&. +.RE +.PP +\fIcryptsetup\&.luks2\-pin\fR +.RS 4 +This credential specifies the PIN requested by generic LUKS2 token modules\&. +.sp +Added in version 256\&. +.RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-cryptsetup-generator\fR(8), -\fBcrypttab\fR(5), -\fBsystemd-cryptenroll\fR(1), -\fBcryptsetup\fR(8), -\m[blue]\fBTPM2 PCR Measurements Made by systemd\fR\m[]\&\s-2\u[2]\d\s+2 +\fBsystemd\fR(1), \fBsystemd-cryptsetup-generator\fR(8), \fBcrypttab\fR(5), \fBsystemd-cryptenroll\fR(1), \fBcryptsetup\fR(8), \m[blue]\fBTPM2 PCR Measurements Made by systemd\fR\m[]\&\s-2\u[2]\d\s+2 .SH "NOTES" .IP " 1." 4 password agent logic diff --git a/upstream/fedora-rawhide/man8/systemd-debug-generator.8 b/upstream/fedora-rawhide/man8/systemd-debug-generator.8 index 7aa1b11a..1c6e5844 100644 --- a/upstream/fedora-rawhide/man8/systemd-debug-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-debug-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-DEBUG\-GENERATOR" "8" "" "systemd 255" "systemd-debug-generator" +.TH "SYSTEMD\-DEBUG\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-debug-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -60,13 +60,17 @@ option is specified, the debug shell service "debug\-shell\&.service" is pulled into the boot transaction and a debug shell will be spawned during early boot\&. By default, /dev/tty9 -is used, but a specific tty can also be set, either with or without the +is used, but a specific tty can also be specified, either with or without the +/dev/ +prefix\&. To set the tty to use without enabling the debug shell, the +\fBsystemd\&.default_debug_tty=\fR +option can be used which also takes a tty with or without the /dev/ prefix\&. Note that the shell may also be turned on persistently by enabling it with \fBsystemctl\fR(1)\*(Aqs \fBenable\fR command\&. -\fBrd\&.systemd\&.debug_shell=\fR +\fBrd\&.systemd\&.debug_shell\fR is honored only by initial RAM disk (initrd) while \fBsystemd\&.debug_shell\fR is honored only in the main system\&. @@ -74,8 +78,31 @@ is honored only in the main system\&. systemd\-debug\-generator implements \fBsystemd.generator\fR(7)\&. +.SH "SYSTEM CREDENTIALS" +.PP +\fIsystemd\&.extra\-unit\&.*\fR +.RS 4 +Credentials prefixed with +"systemd\&.extra\-unit\&." +specify additional units to add to the final system\&. Note that these additional units are added to both the initrd and the final system\&. +\fIConditionPathExists=!/etc/initrd\-release\fR +can be used to make sure the unit is conditioned out in the initrd\&. Note that this can also be used to mask units, by simply specifying an empty value\&. +.sp +Added in version 256\&. +.RE +.PP +\fIsystemd\&.unit\-dropin\&.*\fR +.RS 4 +Credentials prefixed with +"systemd\&.unit\-dropin\&." +add drop\-ins for the corresponding units in the final system\&. Each credential must be suffixed with the full unit name including the unit extension\&. Its contents must be a valid unit drop\-in file\&. Optionally, the unit name may be followed with +"~", followed by the drop\-in name without the +"\&.conf" +suffix\&. If not specified, the name of the generated drop\-in will be +"50\-credential\&.conf"\&. Note that these additional drop\-ins are added to both the initrd and the final system\&. +.sp +Added in version 256\&. +.RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBkernel-command-line\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBkernel-command-line\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-environment-d-generator.8 b/upstream/fedora-rawhide/man8/systemd-environment-d-generator.8 index 2e7e31ab..7afa56cf 100644 --- a/upstream/fedora-rawhide/man8/systemd-environment-d-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-environment-d-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-ENVIRONMENT\-D\-GENERATOR" "8" "" "systemd 255" "systemd-environment-d-generator" +.TH "SYSTEMD\-ENVIRONMENT\-D\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-environment-d-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -36,7 +36,4 @@ configuration files and passes it to the user manager instance\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.environment-generator\fR(7), -\fBsystemd.generator\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.environment-generator\fR(7), \fBsystemd.generator\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-fsck@.service.8 b/upstream/fedora-rawhide/man8/systemd-fsck@.service.8 index 5c1cbe90..18d40eb1 100644 --- a/upstream/fedora-rawhide/man8/systemd-fsck@.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-fsck@.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-FSCK@\&.SERVICE" "8" "" "systemd 255" "systemd-fsck@.service" +.TH "SYSTEMD\-FSCK@\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-fsck@.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,13 +23,18 @@ systemd-fsck@.service, systemd-fsck-root.service, systemd-fsck-usr.service, systemd-fsck \- File system checker logic .SH "SYNOPSIS" .PP +.RS 4 systemd\-fsck@\&.service -.PP +.RE +.RS 4 systemd\-fsck\-root\&.service -.PP +.RE +.RS 4 systemd\-fsck\-usr\&.service -.PP +.RE +.RS 4 /usr/lib/systemd/systemd\-fsck +.RE .SH "DESCRIPTION" .PP systemd\-fsck@\&.service, @@ -116,14 +121,4 @@ Added in version 213\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBfsck\fR(8), -\fBsystemd-quotacheck.service\fR(8), -\fBfsck.btrfs\fR(8), -\fBfsck.cramfs\fR(8), -\fBfsck.ext4\fR(8), -\fBfsck.fat\fR(8), -\fBfsck.hfsplus\fR(8), -\fBfsck.minix\fR(8), -\fBfsck.ntfs\fR(8), -\fBfsck.xfs\fR(8) +\fBsystemd\fR(1), \fBfsck\fR(8), \fBsystemd-quotacheck.service\fR(8), \fBfsck.btrfs\fR(8), \fBfsck.cramfs\fR(8), \fBfsck.ext4\fR(8), \fBfsck.fat\fR(8), \fBfsck.hfsplus\fR(8), \fBfsck.minix\fR(8), \fBfsck.ntfs\fR(8), \fBfsck.xfs\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-fstab-generator.8 b/upstream/fedora-rawhide/man8/systemd-fstab-generator.8 index 3b6f3d17..61d06d09 100644 --- a/upstream/fedora-rawhide/man8/systemd-fstab-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-fstab-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-FSTAB\-GENERATOR" "8" "" "systemd 255" "systemd-fstab-generator" +.TH "SYSTEMD\-FSTAB\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-fstab-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -356,14 +356,7 @@ Added in version 254\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBfstab\fR(5), -\fBsystemd.mount\fR(5), -\fBsystemd.swap\fR(5), -\fBsystemd-cryptsetup-generator\fR(8), -\fBsystemd-gpt-auto-generator\fR(8), -\fBkernel-command-line\fR(7), -\m[blue]\fBKnown Environment Variables\fR\m[]\&\s-2\u[1]\d\s+2 +\fBsystemd\fR(1), \fBfstab\fR(5), \fBsystemd.mount\fR(5), \fBsystemd.swap\fR(5), \fBsystemd-cryptsetup-generator\fR(8), \fBsystemd-gpt-auto-generator\fR(8), \fBkernel-command-line\fR(7), \m[blue]\fBKnown Environment Variables\fR\m[]\&\s-2\u[1]\d\s+2 .SH "NOTES" .IP " 1." 4 Known Environment Variables diff --git a/upstream/fedora-rawhide/man8/systemd-getty-generator.8 b/upstream/fedora-rawhide/man8/systemd-getty-generator.8 index a14b9abc..e57b7a32 100644 --- a/upstream/fedora-rawhide/man8/systemd-getty-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-getty-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-GETTY\-GENERATOR" "8" "" "systemd 255" "systemd-getty-generator" +.TH "SYSTEMD\-GETTY\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-getty-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -88,10 +88,7 @@ Added in version 254\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBkernel-command-line\fR(7), -\fBsystemd.system-credentials\fR(7), -\fBagetty\fR(8) +\fBsystemd\fR(1), \fBkernel-command-line\fR(7), \fBsystemd.system-credentials\fR(7), \fBagetty\fR(8) .SH "NOTES" .IP " 1." 4 Container diff --git a/upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 b/upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 index 2282d2fe..2a4a5416 100644 --- a/upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-gpt-auto-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-GPT\-AUTO\-GENERATOR" "8" "" "systemd 255" "systemd-gpt-auto-generator" +.TH "SYSTEMD\-GPT\-AUTO\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-gpt-auto-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -31,12 +31,19 @@ is a unit generator that automatically discovers the root partition, /home/, /srv/, /var/, -/var/tmp/, the EFI System Partition, the Extended Boot Loader Partition, and swap partitions and creates mount and swap units for them, based on the partition type GUIDs of GUID partition tables (GPT)\&. See +/var/tmp/, the EFI System Partition (ESP), the Extended Boot Loader Partition (XBOOTLDR), and swap partitions and creates mount and swap units for them, based on the partition type GUIDs of GUID partition tables (GPT)\&. See \m[blue]\fBUEFI Specification\fR\m[]\&\s-2\u[1]\d\s+2, chapter 5 for more details\&. It implements the \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[2]\d\s+2\&. .PP Note that this generator has no effect on non\-GPT systems\&. It will also not create mount point configuration for directories which already contain files or if the mount point is explicitly configured in -\fBfstab\fR(5)\&. If the units this generator creates are overridden, for example by units in directories with higher precedence, drop\-ins and additional dependencies created by this generator might still be used\&. +\fBfstab\fR(5)\&. Additionally no unit will be created for the ESP or the XBOOTLDR partition if mount entries are found in the +/boot/ +or +/efi/ +hierarchies in +\fBfstab\fR(5)\&. +.PP +If the units this generator creates are overridden, for example by units in directories with higher precedence, drop\-ins and additional dependencies created by this generator might still be used\&. .PP This generator will only look for the root partition on the same physical disk where the EFI System Partition (ESP) is located\&. Note that support from the boot loader is required: the EFI variable \fILoaderDevicePartUUID\fR @@ -62,9 +69,11 @@ This generator looks for the partitions based on their partition type GUID\&. Th .B Table\ \&1.\ \&Partition Type GUIDs .TS allbox tab(:); -lB lB lB lB. +lB lB lB lB lB. T{ -Partition Type GUID +Partition Type +T}:T{ +GUID T}:T{ Name T}:T{ @@ -73,90 +82,108 @@ T}:T{ Explanation T} .T& -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l -l l l l. +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l +l l l l l. T{ -\fBSD_GPT_ROOT_X86_64\fR \fB4f68bce3\-e8cd\-4db1\-96e7\-fbcaf984b709\fR +\fBSD_GPT_ROOT_X86_64\fR +T}:T{ +\fB4f68bce3\-e8cd\-4db1\-96e7\-fbcaf984b709\fR T}:T{ Root Partition (x86\-64) T}:T{ / T}:T{ -The first partition with this type UUID, located on the same disk as the ESP, is used as the root file system / on AMD64 / 64\-bit x86 systems\&. +The first partition with this type UUID, located on the same disk as the ESP used for booting, is used as the root file system / on AMD64 / 64\-bit x86 systems\&. T} T{ -\fBSD_GPT_ROOT_ARM64\fR \fBb921b045\-1df0\-41c3\-af44\-4c6f280d3fae\fR +\fBSD_GPT_ROOT_ARM64\fR +T}:T{ +\fBb921b045\-1df0\-41c3\-af44\-4c6f280d3fae\fR T}:T{ Root Partition (64\-bit ARM) T}:T{ / T}:T{ -The first partition with this type UUID, located on the same disk as the ESP, is used as the root file system / on AArch64 / 64\-bit ARM systems\&. +The first partition with this type UUID, located on the same disk as the ESP used for booting, is used as the root file system / on AArch64 / 64\-bit ARM systems\&. T} T{ \fBSD_GPT_ROOT_ALPHA\fR \fBSD_GPT_ROOT_ARC\fR \fBSD_GPT_ROOT_ARM\fR \fBSD_GPT_ROOT_ARM64\fR \fBSD_GPT_ROOT_IA64\fR \fBSD_GPT_ROOT_LOONGARCH64\fR \fBSD_GPT_ROOT_MIPS\fR \fBSD_GPT_ROOT_MIPS64\fR \fBSD_GPT_ROOT_MIPS_LE\fR \fBSD_GPT_ROOT_MIPS64_LE\fR \fBSD_GPT_ROOT_PARISC\fR \fBSD_GPT_ROOT_PPC\fR \fBSD_GPT_ROOT_PPC64\fR \fBSD_GPT_ROOT_PPC64_LE\fR \fBSD_GPT_ROOT_RISCV32\fR \fBSD_GPT_ROOT_RISCV64\fR \fBSD_GPT_ROOT_S390\fR \fBSD_GPT_ROOT_S390X\fR \fBSD_GPT_ROOT_TILEGX\fR \fBSD_GPT_ROOT_X86\fR \fBSD_GPT_ROOT_X86_64\fR \fBSD_GPT_USR_ALPHA\fR \fBSD_GPT_USR_ARC\fR \fBSD_GPT_USR_ARM\fR \fBSD_GPT_USR_IA64\fR \fBSD_GPT_USR_LOONGARCH64\fR \fBSD_GPT_USR_MIPS_LE\fR \fBSD_GPT_USR_MIPS64_LE\fR \fBSD_GPT_USR_PARISC\fR \fBSD_GPT_USR_PPC\fR \fBSD_GPT_USR_PPC64\fR \fBSD_GPT_USR_PPC64_LE\fR \fBSD_GPT_USR_RISCV32\fR \fBSD_GPT_USR_RISCV64\fR \fBSD_GPT_USR_S390\fR \fBSD_GPT_USR_S390X\fR \fBSD_GPT_USR_TILEGX\fR \fBSD_GPT_USR_X86\fR T}:T{ -root partitions for other architectures +\&... +T}:T{ +Root partitions for other architectures T}:T{ / T}:T{ -The first partition with the type UUID matching the architecture, located on the same disk as the ESP, is used as the root file system /\&. For the full list and constant values, see \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[2]\d\s+2\&. +The first partition with the type UUID matching the architecture, located on the same disk as the ESP used for booting, is used as the root file system /\&. For the full list and constant values, see \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[2]\d\s+2\&. T} T{ -\fBSD_GPT_HOME\fR \fB933ac7e1\-2eb4\-4f13\-b844\-0e14e2aef915\fR +\fBSD_GPT_HOME\fR +T}:T{ +\fB933ac7e1\-2eb4\-4f13\-b844\-0e14e2aef915\fR T}:T{ Home Partition T}:T{ /home/ T}:T{ -The first partition with this type UUID on the same disk as the ESP is mounted to /home/\&. +The first partition with this type UUID on the same disk as the root partition is mounted to /home/\&. T} T{ -\fBSD_GPT_SRV\fR \fB3b8f8425\-20e0\-4f3b\-907f\-1a25a76f98e8\fR +\fBSD_GPT_SRV\fR +T}:T{ +\fB3b8f8425\-20e0\-4f3b\-907f\-1a25a76f98e8\fR T}:T{ Server Data Partition T}:T{ /srv/ T}:T{ -The first partition with this type UUID on the same disk as the ESP is mounted to /srv/\&. +The first partition with this type UUID on the same disk as the root partition is mounted to /srv/\&. T} T{ -\fBSD_GPT_VAR\fR \fB4d21b016\-b534\-45c2\-a9fb\-5c16e091fd2d\fR +\fBSD_GPT_VAR\fR +T}:T{ +\fB4d21b016\-b534\-45c2\-a9fb\-5c16e091fd2d\fR T}:T{ Variable Data Partition T}:T{ /var/ T}:T{ -The first partition with this type UUID on the same disk as the ESP is mounted to /var/ \(em under the condition its partition UUID matches the first 128 bit of the HMAC\-SHA256 of the GPT type uuid of this partition keyed by the machine ID of the installation stored in \fBmachine-id\fR(5)\&. +The first partition with this type UUID on the same disk as the root partition is mounted to /var/ \(em under the condition its partition UUID matches the first 128 bit of the HMAC\-SHA256 of the GPT type uuid of this partition keyed by the machine ID of the installation stored in \fBmachine-id\fR(5)\&. T} T{ -\fBSD_GPT_TMP\fR \fB7ec6f557\-3bc5\-4aca\-b293\-16ef5df639d1\fR +\fBSD_GPT_TMP\fR +T}:T{ +\fB7ec6f557\-3bc5\-4aca\-b293\-16ef5df639d1\fR T}:T{ Temporary Data Partition T}:T{ /var/tmp/ T}:T{ -The first partition with this type UUID on the same disk as the ESP is mounted to /var/tmp/\&. +The first partition with this type UUID on the same disk as the root partition is mounted to /var/tmp/\&. T} T{ -\fBSD_GPT_SWAP\fR \fB0657fd6d\-a4ab\-43c4\-84e5\-0933c84b4f4f\fR +\fBSD_GPT_SWAP\fR +T}:T{ +\fB0657fd6d\-a4ab\-43c4\-84e5\-0933c84b4f4f\fR T}:T{ Swap T}:T{ n/a T}:T{ -All partitions with this type UUID on the same disk as the ESP are used as swap\&. +All partitions with this type UUID on the same disk as the root partition are used as swap\&. T} T{ -\fBSD_GPT_ESP\fR \fBc12a7328\-f81f\-11d2\-ba4b\-00a0c93ec93b\fR +\fBSD_GPT_ESP\fR +T}:T{ +\fBc12a7328\-f81f\-11d2\-ba4b\-00a0c93ec93b\fR T}:T{ EFI System Partition (ESP) T}:T{ @@ -165,7 +192,9 @@ T}:T{ The first partition with this type UUID located on the same disk as the root partition is mounted to /boot/ or /efi/, see below\&. T} T{ -\fBSD_GPT_XBOOTLDR\fR \fBbc13c2ff\-59e6\-4262\-a352\-b275fd6f7172\fR +\fBSD_GPT_XBOOTLDR\fR +T}:T{ +\fBbc13c2ff\-59e6\-4262\-a352\-b275fd6f7172\fR T}:T{ Extended Boot Loader Partition T}:T{ @@ -185,34 +214,42 @@ This generator understands the following attribute flags for partitions: .B Table\ \&2.\ \&Partition Attribute Flags .TS allbox tab(:); -lB lB lB. +lB lB lB lB. T{ Flag T}:T{ +Value +T}:T{ Applicable to T}:T{ Explanation T} .T& -l l l -l l l -l l l. +l l l l +l l l l +l l l l. T{ -\fBSD_GPT_FLAG_READ_ONLY\fR \fB0x1000000000000000\fR +\fBSD_GPT_FLAG_READ_ONLY\fR +T}:T{ +\fB0x1000000000000000\fR T}:T{ /, /home/, /srv/, /var/, /var/tmp/, Extended Boot Loader Partition T}:T{ Partition is mounted read\-only T} T{ -\fBSD_GPT_FLAG_NO_AUTO\fR \fB0x8000000000000000\fR +\fBSD_GPT_FLAG_NO_AUTO\fR +T}:T{ +\fB0x8000000000000000\fR T}:T{ /, /home/, /srv/, /var/, /var/tmp/, Extended Boot Loader Partition T}:T{ Partition is not mounted automatically T} T{ -\fBSD_GPT_FLAG_NO_BLOCK_IO_PROTOCOL\fR \fB0x0000000000000002\fR +\fBSD_GPT_FLAG_NO_BLOCK_IO_PROTOCOL\fR +T}:T{ +\fB0x0000000000000002\fR T}:T{ EFI System Partition (ESP) T}:T{ @@ -334,16 +371,7 @@ Added in version 254\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.mount\fR(5), -\fBsystemd.swap\fR(5), -\fBsystemd-fstab-generator\fR(8), -\fBsystemd-cryptsetup@.service\fR(8), -\fBsystemd-pcrfs@.service\fR(8), -\fBmachine-id\fR(5), -\fBcryptsetup\fR(8), -\fBfstab\fR(5), -\fBbtrfs\fR(8) +\fBsystemd\fR(1), \fBsystemd.mount\fR(5), \fBsystemd.swap\fR(5), \fBsystemd-fstab-generator\fR(8), \fBsystemd-cryptsetup@.service\fR(8), \fBsystemd-pcrfs@.service\fR(8), \fBmachine-id\fR(5), \fBcryptsetup\fR(8), \fBfstab\fR(5), \fBbtrfs\fR(8) .SH "NOTES" .IP " 1." 4 UEFI Specification diff --git a/upstream/fedora-rawhide/man8/systemd-hibernate-resume-generator.8 b/upstream/fedora-rawhide/man8/systemd-hibernate-resume-generator.8 index 21c57e3f..1f05f4d8 100644 --- a/upstream/fedora-rawhide/man8/systemd-hibernate-resume-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-hibernate-resume-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-HIBERNATE\-RESUME\-GENERATOR" "8" "" "systemd 255" "systemd-hibernate-resume-generator" +.TH "SYSTEMD\-HIBERNATE\-RESUME\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-hibernate-resume-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -27,12 +27,13 @@ systemd-hibernate-resume-generator \- Unit generator for resume= kernel paramete .SH "DESCRIPTION" .PP \fBsystemd\-hibernate\-resume\-generator\fR -is a generator that initiates the procedure to resume the system from hibernation\&. It creates the -\fBsystemd-hibernate-resume.service\fR(8) -unit according to the value of +is a generator that initiates the procedure to resume the system from hibernation\&. When \fBresume=\fR -parameter specified on the kernel command line, or the value of EFI variable -\fIHibernateLocation\fR, which will instruct the kernel to resume the system from the hibernation image on that device\&. +kernel command line option or +\fIHibernateLocation\fR +EFI variable is detected, it enables the +\fBsystemd-hibernate-resume.service\fR(8) +unit, which will instruct the kernel to resume the system from the hibernation image\&. .SH "KERNEL COMMAND LINE" .PP systemd\-hibernate\-resume\-generator @@ -77,6 +78,4 @@ Added in version 240\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-hibernate-resume.service\fR(8), -\fBkernel-command-line\fR(7) +\fBsystemd\fR(1), \fBsystemd-hibernate-resume.service\fR(8), \fBkernel-command-line\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-hibernate-resume.service.8 b/upstream/fedora-rawhide/man8/systemd-hibernate-resume.service.8 index 9117af69..d5109aca 100644 --- a/upstream/fedora-rawhide/man8/systemd-hibernate-resume.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-hibernate-resume.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-HIBERNATE\-RESUME\&.SERVICE" "8" "" "systemd 255" "systemd-hibernate-resume.service" +.TH "SYSTEMD\-HIBERNATE\-RESUME\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-hibernate-resume.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,11 +20,13 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -systemd-hibernate-resume.service, systemd-hibernate-resume \- Resume from hibernation +systemd-hibernate-resume.service, systemd-hibernate-clear.service, systemd-hibernate-resume \- Resume from hibernation .SH "SYNOPSIS" .PP systemd\-hibernate\-resume\&.service .PP +systemd\-hibernate\-clear\&.service +.PP /usr/lib/systemd/systemd\-hibernate\-resume .SH "DESCRIPTION" .PP @@ -33,14 +35,20 @@ initiates the resume from hibernation\&. .PP \fBsystemd\-hibernate\-resume\fR only supports the in\-kernel hibernation implementation, see -\m[blue]\fBSwap suspend\fR\m[]\&\s-2\u[1]\d\s+2\&. Internally, it works by writing the major:minor of specified device node to +\m[blue]\fBSwap suspend\fR\m[]\&\s-2\u[1]\d\s+2\&. Internally, it works by writing the major:minor of selected device node to /sys/power/resume, along with the offset in memory pages (/sys/power/resume_offset) if supported\&. .PP +The resume device node is either passed directly through arguments, or automatically acquired from kernel command line options and/or +\fIHibernateLocation\fR +EFI variable\&. The latter will normally be cleared by +systemd\-hibernate\-resume\&.service +on resumption\&. If a stale variable is detected, it would be cleared by +systemd\-hibernate\-clear\&.service\&. +.PP Failing to initiate a resume is not an error condition\&. It may mean that there was no resume image (e\&. g\&. if the system has been simply powered off and not hibernated)\&. In such cases, the boot is ordinarily continued\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-hibernate-resume-generator\fR(8) +\fBsystemd\fR(1), \fBsystemd-hibernate-resume-generator\fR(8) .SH "NOTES" .IP " 1." 4 Swap suspend diff --git a/upstream/fedora-rawhide/man8/systemd-homed.service.8 b/upstream/fedora-rawhide/man8/systemd-homed.service.8 index b9f44fb1..6ddaf443 100644 --- a/upstream/fedora-rawhide/man8/systemd-homed.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-homed.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-HOMED\&.SERVICE" "8" "" "systemd 255" "systemd-homed.service" +.TH "SYSTEMD\-HOMED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-homed.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -46,6 +46,11 @@ systemd\-homed\&.service synthesizes a local user and group\&. These are made available to the system using the \m[blue]\fBUser/Group Record Lookup API via Varlink\fR\m[]\&\s-2\u[2]\d\s+2, and thus may be browsed with \fBuserdbctl\fR(1)\&. +.PP +systemd\-homed\&.service +also manages blob directories for each home directory it manages\&. See +\m[blue]\fBUser Record Blob Directories\fR\m[]\&\s-2\u[3]\d\s+2 +for more details\&. .SH "KEY MANAGEMENT" .PP User records are cryptographically signed with a public/private key pair (the signature is part of the JSON record itself)\&. For a user to be permitted to log in locally the public key matching the signature of their user record must be installed\&. For a user record to be modified locally the private key matching the signature must be installed locally, too\&. The keys are stored in the @@ -97,12 +102,7 @@ to "quux", and placed under the identical paths there, as currently only a single private key is supported per host\&. Note of course that the latter means that user records generated/signed before the key pair is copied in, lose their validity\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBhomed.conf\fR(5), -\fBhomectl\fR(1), -\fBpam_systemd_home\fR(8), -\fBuserdbctl\fR(1), -\fBorg.freedesktop.home1\fR(5) +\fBsystemd\fR(1), \fBhomed.conf\fR(5), \fBhomectl\fR(1), \fBpam_systemd_home\fR(8), \fBuserdbctl\fR(1), \fBorg.freedesktop.home1\fR(5) .SH "NOTES" .IP " 1." 4 Home Directories @@ -114,3 +114,8 @@ User/Group Record Lookup API via Varlink .RS 4 \%https://systemd.io/USER_GROUP_API .RE +.IP " 3." 4 +User Record Blob Directories +.RS 4 +\%https://systemd.io/USER_RECORD_BLOB_DIRS +.RE diff --git a/upstream/fedora-rawhide/man8/systemd-hostnamed.service.8 b/upstream/fedora-rawhide/man8/systemd-hostnamed.service.8 index af2fd26a..d9355215 100644 --- a/upstream/fedora-rawhide/man8/systemd-hostnamed.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-hostnamed.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-HOSTNAMED\&.SERVICE" "8" "" "systemd 255" "systemd-hostnamed.service" +.TH "SYSTEMD\-HOSTNAMED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-hostnamed.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -111,8 +111,4 @@ and for a description of the D\-Bus API\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBhostname\fR(5), -\fBmachine-info\fR(5), -\fBhostnamectl\fR(1), -\fBsethostname\fR(2) +\fBsystemd\fR(1), \fBhostname\fR(5), \fBmachine-info\fR(5), \fBhostnamectl\fR(1), \fBsethostname\fR(2) diff --git a/upstream/fedora-rawhide/man8/systemd-hwdb.8 b/upstream/fedora-rawhide/man8/systemd-hwdb.8 index 193b99ef..805f6405 100644 --- a/upstream/fedora-rawhide/man8/systemd-hwdb.8 +++ b/upstream/fedora-rawhide/man8/systemd-hwdb.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-HWDB" "8" "" "systemd 255" "systemd-hwdb" +.TH "SYSTEMD\-HWDB" "8" "" "systemd 256~rc3" "systemd-hwdb" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -60,7 +60,7 @@ Print a short help text and exit\&. .SS "systemd\-hwdb [\fIoptions\fR] update" .PP Update the binary database\&. -.SS "systemd\-hwdb [\fIoptions\fR] query [\fIMODALIAS\fR]" +.SS "systemd\-hwdb [\fIoptions\fR] query \fIMODALIAS\fR" .PP Query database and print result\&. .SH "SEE ALSO" diff --git a/upstream/fedora-rawhide/man8/systemd-importd.service.8 b/upstream/fedora-rawhide/man8/systemd-importd.service.8 index a9bdd93f..307d9b6e 100644 --- a/upstream/fedora-rawhide/man8/systemd-importd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-importd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-IMPORTD\&.SERVICE" "8" "" "systemd 255" "systemd-importd.service" +.TH "SYSTEMD\-IMPORTD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-importd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -29,9 +29,8 @@ systemd\-importd\&.service .SH "DESCRIPTION" .PP \fBsystemd\-importd\fR -is a system service that allows importing, exporting and downloading of system images suitable for running as VM or containers\&. It is a companion service for -\fBsystemd-machined.service\fR(8), and provides the implementation for -\fBmachinectl\fR(1)\*(Aqs +is a system service that allows importing, exporting and downloading of disk images\&. It provides the implementation for +\fBimportctl\fR(1)\*(Aqs \fBpull\-raw\fR, \fBpull\-tar\fR, \fBimport\-raw\fR, @@ -48,7 +47,4 @@ and for a description of the D\-Bus API\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBmachinectl\fR(1), -\fBsystemd-machined.service\fR(8), -\fBsystemd-nspawn\fR(1) +\fBsystemd\fR(1), \fBimportctl\fR(1), \fBsystemd-machined.service\fR(8), \fBsystemd-nspawn\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-initctl.service.8 b/upstream/fedora-rawhide/man8/systemd-initctl.service.8 index b88bead9..f6194bd2 100644 --- a/upstream/fedora-rawhide/man8/systemd-initctl.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-initctl.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-INITCTL\&.SERVICE" "8" "" "systemd 255" "systemd-initctl.service" +.TH "SYSTEMD\-INITCTL\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-initctl.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man8/systemd-integritysetup-generator.8 b/upstream/fedora-rawhide/man8/systemd-integritysetup-generator.8 index 67bc9462..c1ecc500 100644 --- a/upstream/fedora-rawhide/man8/systemd-integritysetup-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-integritysetup-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-INTEGRITYSETUP\-GENERATOR" "8" "" "systemd 255" "systemd-integritysetup-generator" +.TH "SYSTEMD\-INTEGRITYSETUP\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-integritysetup-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -38,6 +38,4 @@ implements \fBsystemd.generator\fR(7)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-integritysetup@.service\fR(8), -\fBintegritysetup\fR(8) +\fBsystemd\fR(1), \fBsystemd-integritysetup@.service\fR(8), \fBintegritysetup\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-integritysetup@.service.8 b/upstream/fedora-rawhide/man8/systemd-integritysetup@.service.8 index badc9c26..d0359743 100644 --- a/upstream/fedora-rawhide/man8/systemd-integritysetup@.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-integritysetup@.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-INTEGRITYSETUP@\&.SERVICE" "8" "" "systemd 255" "systemd-integritysetup@.service" +.TH "SYSTEMD\-INTEGRITYSETUP@\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-integritysetup@.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -76,10 +76,7 @@ Added in version 250\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBintegritytab\fR(5), -\fBsystemd-integritysetup-generator\fR(8), -\fBintegritysetup\fR(8) +\fBsystemd\fR(1), \fBintegritytab\fR(5), \fBsystemd-integritysetup-generator\fR(8), \fBintegritysetup\fR(8) .SH "NOTES" .IP " 1." 4 Kernel dm-integrity diff --git a/upstream/fedora-rawhide/man8/systemd-journal-gatewayd.service.8 b/upstream/fedora-rawhide/man8/systemd-journal-gatewayd.service.8 index 5ab1dd0b..9d25e9a7 100644 --- a/upstream/fedora-rawhide/man8/systemd-journal-gatewayd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-journal-gatewayd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-JOURNAL\-GATEWAYD\&.SERVICE" "8" "" "systemd 255" "systemd-journal-gatewayd.service" +.TH "SYSTEMD\-JOURNAL\-GATEWAYD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-journal-gatewayd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -237,9 +237,15 @@ Added in version 197\&. .PP \fBRange: entries=\fR\fB\fIcursor\fR\fR\fB[[:\fR\fB\fInum_skip\fR\fR\fB]:\fR\fB\fInum_entries\fR\fR\fB]\fR .PP +\fBRange: realtime=[\fR\fB\fIsince\fR\fR\fB]:[\fR\fB\fIuntil\fR\fR\fB][[:\fR\fB\fInum_skip\fR\fR\fB]:\fR\fB\fInum_entries\fR\fR\fB]\fR +.PP where \fIcursor\fR is a cursor string, +\fIsince\fR +and +\fIuntil\fR +are timestamps (seconds since 1970\-01\-01 00:00:00 UTC), \fInum_skip\fR is an integer, \fInum_entries\fR @@ -309,12 +315,7 @@ curl \*(Aqhttp://localhost:19531/entries?follow&MESSAGE_ID=fc2e22bc6ee647b6b9072 .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBjournalctl\fR(1), -\fBsystemd.journal-fields\fR(7), -\fBsystemd-journald.service\fR(8), -\fBsystemd-journal-remote.service\fR(8), -\fBsystemd-journal-upload.service\fR(8) +\fBsystemd\fR(1), \fBjournalctl\fR(1), \fBsystemd.journal-fields\fR(7), \fBsystemd-journald.service\fR(8), \fBsystemd-journal-remote.service\fR(8), \fBsystemd-journal-upload.service\fR(8) .SH "NOTES" .IP " 1." 4 Journal JSON Format diff --git a/upstream/fedora-rawhide/man8/systemd-journal-remote.service.8 b/upstream/fedora-rawhide/man8/systemd-journal-remote.service.8 index 32c6bb3d..3b2d93ab 100644 --- a/upstream/fedora-rawhide/man8/systemd-journal-remote.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-journal-remote.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-JOURNAL\-REMOTE\&.SERVICE" "8" "" "systemd 255" "systemd-journal-remote.service" +.TH "SYSTEMD\-JOURNAL\-REMOTE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-journal-remote.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -60,7 +60,7 @@ will exit\&. .PP Active sources can be specified in the following ways: .PP -[SOURCES...] +[SOURCES] .RS 4 When \fB\-\fR @@ -81,7 +81,7 @@ instance, e\&.g\&. http://some\&.host:19531/ or https://some\&.host:19531/\&. Added in version 239\&. .RE .PP -\fB\-\-getter=\*(Aq\fR\fB\fIPROG\fR\fR\fB \fR\fB[OPTIONS...]\fR\fB\*(Aq\fR +\fB\-\-getter=\*(Aq\fR\fB\fIPROG\fR\fR\fB \fR\fB[OPTIONS]\fR\fB\*(Aq\fR .RS 4 Program to invoke to retrieve data\&. The journal event stream must be generated on standard output\&. .sp @@ -340,11 +340,7 @@ systemd\-journal\-remote \-\-url http://some\&.host:19531/entries?boot&follow .sp .SH "SEE ALSO" .PP -\fBjournal-remote.conf\fR(5), -\fBjournalctl\fR(1), -\fBsystemd-journal-gatewayd.service\fR(8), -\fBsystemd-journal-upload.service\fR(8), -\fBsystemd-journald.service\fR(8) +\fBjournal-remote.conf\fR(5), \fBjournalctl\fR(1), \fBsystemd-journal-gatewayd.service\fR(8), \fBsystemd-journal-upload.service\fR(8), \fBsystemd-journald.service\fR(8) .SH "NOTES" .IP " 1." 4 Journal Export Format diff --git a/upstream/fedora-rawhide/man8/systemd-journal-upload.service.8 b/upstream/fedora-rawhide/man8/systemd-journal-upload.service.8 index d74e313e..b08c3eb8 100644 --- a/upstream/fedora-rawhide/man8/systemd-journal-upload.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-journal-upload.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-JOURNAL\-UPLOAD\&.SERVICE" "8" "" "systemd 255" "systemd-journal-upload.service" +.TH "SYSTEMD\-JOURNAL\-UPLOAD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-journal-upload.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -281,8 +281,4 @@ and \fBsystemd\-journal\-upload \-\-help\fR\&. .SH "SEE ALSO" .PP -\fBjournal-upload.conf\fR(5), -\fBsystemd-journal-remote.service\fR(8), -\fBjournalctl\fR(1), -\fBsystemd-journald.service\fR(8), -\fBsystemd-journal-gatewayd.service\fR(8) +\fBjournal-upload.conf\fR(5), \fBsystemd-journal-remote.service\fR(8), \fBjournalctl\fR(1), \fBsystemd-journald.service\fR(8), \fBsystemd-journal-gatewayd.service\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-journald.service.8 b/upstream/fedora-rawhide/man8/systemd-journald.service.8 index 029e419d..e6844501 100644 --- a/upstream/fedora-rawhide/man8/systemd-journald.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-journald.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-JOURNALD\&.SERVICE" "8" "" "systemd 255" "systemd-journald.service" +.TH "SYSTEMD\-JOURNALD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-journald.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,21 +23,30 @@ systemd-journald.service, systemd-journald.socket, systemd-journald-dev-log.socket, systemd-journald-audit.socket, systemd-journald@.service, systemd-journald@.socket, systemd-journald-varlink@.socket, systemd-journald \- Journal service .SH "SYNOPSIS" .PP +.RS 4 systemd\-journald\&.service -.PP +.RE +.RS 4 systemd\-journald\&.socket -.PP +.RE +.RS 4 systemd\-journald\-dev\-log\&.socket -.PP +.RE +.RS 4 systemd\-journald\-audit\&.socket -.PP +.RE +.RS 4 systemd\-journald@\&.service -.PP +.RE +.RS 4 systemd\-journald@\&.socket -.PP +.RE +.RS 4 systemd\-journald\-varlink@\&.socket -.PP +.RE +.RS 4 /usr/lib/systemd/systemd\-journald +.RE .SH "DESCRIPTION" .PP systemd\-journald @@ -268,6 +277,34 @@ command to trigger journal synchronization, and wait for the operation to comple .sp Added in version 228\&. .RE +.SH "CREDENTIALS" +.PP +\fBsystemd\-journald\fR +supports the service credentials logic as implemented by +\fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR +(see +\fBsystemd.exec\fR(5) +for details)\&. The following credentials are used when passed in: +.PP +\fIjournal\&.forward_to_socket\fR +.RS 4 +May contain a socket address to which logs should be forwarded\&. See +\fIForwardToSocket=\fR +in +\fBjournald.conf\fR(5)\&. +.sp +Added in version 256\&. +.RE +.PP +\fIjournal\&.storage\fR +.RS 4 +May be used to specify where journal files should be stored\&. See +\fIStorage=\fR +in +\fBjournald.conf\fR(5)\&. +.sp +Added in version 256\&. +.RE .SH "KERNEL COMMAND LINE" .PP A few configuration parameters from @@ -285,6 +322,15 @@ for information about these settings\&. Added in version 186\&. .RE .PP +\fIsystemd\&.journald\&.max_level_store=\fR, \fIsystemd\&.journald\&.max_level_syslog=\fR, \fIsystemd\&.journald\&.max_level_kmsg=\fR, \fIsystemd\&.journald\&.max_level_console=\fR, \fIsystemd\&.journald\&.max_level_wall=\fR, \fIsystemd\&.journald\&.max_level_socket=\fR +.RS 4 +Controls the maximum log level of messages that are stored in the journal, forwarded to syslog, kmsg, the console, the wall, or a socket\&. This kernel command line options override the settings of the same names in the +\fBjournald.conf\fR(5) +file\&. +.sp +Added in version 232\&. +.RE +.PP Note that these kernel command line options are only honoured by the default namespace, see above\&. .SH "ACCESS CONTROL" .PP @@ -390,15 +436,7 @@ Added in version 228\&. If journal namespacing is used these paths are slightly altered to include a namespace identifier, see above\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBjournalctl\fR(1), -\fBjournald.conf\fR(5), -\fBsystemd.journal-fields\fR(7), -\fBsd-journal\fR(3), -\fBsystemd-coredump\fR(8), -\fBsetfacl\fR(1), -\fBsd_journal_print\fR(3), -\fBpydoc systemd\&.journal\fR +\fBsystemd\fR(1), \fBjournalctl\fR(1), \fBjournald.conf\fR(5), \fBsystemd.journal-fields\fR(7), \fBsd-journal\fR(3), \fBsystemd-coredump\fR(8), \fBsetfacl\fR(1), \fBsd_journal_print\fR(3), \fBpydoc systemd\&.journal\fR .SH "NOTES" .IP " 1." 4 Native Journal Protocol diff --git a/upstream/fedora-rawhide/man8/systemd-localed.service.8 b/upstream/fedora-rawhide/man8/systemd-localed.service.8 index eabe5304..55495b4e 100644 --- a/upstream/fedora-rawhide/man8/systemd-localed.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-localed.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-LOCALED\&.SERVICE" "8" "" "systemd 255" "systemd-localed.service" +.TH "SYSTEMD\-LOCALED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-localed.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -44,8 +44,4 @@ and for a description of the D\-Bus API\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBlocale.conf\fR(5), -\fBvconsole.conf\fR(5), -\fBlocalectl\fR(1), -\fBloadkeys\fR(1) +\fBsystemd\fR(1), \fBlocale.conf\fR(5), \fBvconsole.conf\fR(5), \fBlocalectl\fR(1), \fBloadkeys\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-logind.service.8 b/upstream/fedora-rawhide/man8/systemd-logind.service.8 index f1bf34d2..251b67c2 100644 --- a/upstream/fedora-rawhide/man8/systemd-logind.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-logind.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-LOGIND\&.SERVICE" "8" "" "systemd 255" "systemd-logind.service" +.TH "SYSTEMD\-LOGIND\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-logind.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -184,12 +184,7 @@ If you are interested in writing a display manager that makes use of logind, ple \m[blue]\fBWriting Desktop Environments\fR\m[]\&\s-2\u[4]\d\s+2\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-user-sessions.service\fR(8), -\fBloginctl\fR(1), -\fBlogind.conf\fR(5), -\fBpam_systemd\fR(8), -\fBsd-login\fR(3) +\fBsystemd\fR(1), \fBsystemd-user-sessions.service\fR(8), \fBloginctl\fR(1), \fBlogind.conf\fR(5), \fBpam_systemd\fR(8), \fBsd-login\fR(3) .SH "NOTES" .IP " 1." 4 polkit diff --git a/upstream/fedora-rawhide/man8/systemd-machine-id-commit.service.8 b/upstream/fedora-rawhide/man8/systemd-machine-id-commit.service.8 index c76834db..c7b5ec00 100644 --- a/upstream/fedora-rawhide/man8/systemd-machine-id-commit.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-machine-id-commit.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-MACHINE\-ID\-COMMIT\&.SERVICE" "8" "" "systemd 255" "systemd-machine-id-commit.service" +.TH "SYSTEMD\-MACHINE\-ID\-COMMIT\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-machine-id-commit.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -53,7 +53,4 @@ is read\-only and initially not initialized\&. In this case, the system manager has been remounted writable and the ID may thus be committed to disk to make it permanent\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-machine-id-setup\fR(1), -\fBmachine-id\fR(5), -\fBsystemd-firstboot\fR(1) +\fBsystemd\fR(1), \fBsystemd-machine-id-setup\fR(1), \fBmachine-id\fR(5), \fBsystemd-firstboot\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-machined.service.8 b/upstream/fedora-rawhide/man8/systemd-machined.service.8 index 37940727..9b5dab9c 100644 --- a/upstream/fedora-rawhide/man8/systemd-machined.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-machined.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-MACHINED\&.SERVICE" "8" "" "systemd 255" "systemd-machined.service" +.TH "SYSTEMD\-MACHINED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-machined.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -178,11 +178,7 @@ that employs user namespacing, users/groups are synthesized for the used UIDs/GI or the usual glibc NSS calls\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBmachinectl\fR(1), -\fBsystemd-nspawn\fR(1), -\fBnss-mymachines\fR(8), -\fBsystemd.special\fR(7) +\fBsystemd\fR(1), \fBmachinectl\fR(1), \fBsystemd-nspawn\fR(1), \fBnss-mymachines\fR(8), \fBsystemd.special\fR(7) .SH "NOTES" .IP " 1." 4 gnome-system-monitor diff --git a/upstream/fedora-rawhide/man8/systemd-makefs@.service.8 b/upstream/fedora-rawhide/man8/systemd-makefs@.service.8 index b1f51d1b..903a5921 100644 --- a/upstream/fedora-rawhide/man8/systemd-makefs@.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-makefs@.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-MAKEFS@\&.SERVICE" "8" "" "systemd 255" "systemd-makefs@.service" +.TH "SYSTEMD\-MAKEFS@\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-makefs@.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -70,15 +70,4 @@ and dm\-crypt partitions (see If the creation of a file system or swap device fails, the mount point or swap is failed too\&. If the growing of a file system fails, a warning is emitted\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.mount\fR(8), -\fBsystemd-fstab-generator\fR(8), -\fBsystemd-repart\fR(8), -\fBmkfs.btrfs\fR(8), -\fBmkfs.cramfs\fR(8), -\fBmkfs.ext4\fR(8), -\fBmkfs.fat\fR(8), -\fBmkfs.hfsplus\fR(8), -\fBmkfs.minix\fR(8), -\fBmkfs.ntfs\fR(8), -\fBmkfs.xfs\fR(8) +\fBsystemd\fR(1), \fBsystemd.mount\fR(8), \fBsystemd-fstab-generator\fR(8), \fBsystemd-repart\fR(8), \fBmkfs.btrfs\fR(8), \fBmkfs.cramfs\fR(8), \fBmkfs.ext4\fR(8), \fBmkfs.fat\fR(8), \fBmkfs.hfsplus\fR(8), \fBmkfs.minix\fR(8), \fBmkfs.ntfs\fR(8), \fBmkfs.xfs\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-modules-load.service.8 b/upstream/fedora-rawhide/man8/systemd-modules-load.service.8 index 4aa80ef1..24da2da7 100644 --- a/upstream/fedora-rawhide/man8/systemd-modules-load.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-modules-load.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-MODULES\-LOAD\&.SERVICE" "8" "" "systemd 255" "systemd-modules-load.service" +.TH "SYSTEMD\-MODULES\-LOAD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-modules-load.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -54,5 +54,4 @@ Added in version 187\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBmodules-load.d\fR(5), +\fBsystemd\fR(1), \fBmodules-load.d\fR(5) diff --git a/upstream/fedora-rawhide/man8/systemd-mountfsd.service.8 b/upstream/fedora-rawhide/man8/systemd-mountfsd.service.8 new file mode 100644 index 00000000..907537c7 --- /dev/null +++ b/upstream/fedora-rawhide/man8/systemd-mountfsd.service.8 @@ -0,0 +1,96 @@ +'\" t +.TH "SYSTEMD\-MOUNTFSD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-mountfsd.service" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +systemd-mountfsd.service, systemd-mountfsd \- Disk Image File System Mount Service +.SH "SYNOPSIS" +.PP +systemd\-mountfsd\&.service +.PP +/usr/lib/systemd/systemd\-mountfsd +.SH "DESCRIPTION" +.PP +\fBsystemd\-mountfsd\fR +is a system service that dissects disk images, and returns mount file descriptors for the file systems contained therein to clients, via a Varlink IPC API\&. +.PP +The disk images provided must contain a raw file system image or must follow the +\m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2\&. Before mounting any file systems authenticity of the disk image is established in one or a combination of the following ways: +.sp +.RS 4 +.ie n \{\ +\h'-04' 1.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 1." 4.2 +.\} +If the disk image is located in a regular file in one of the directories +/var/lib/machines/, +/var/lib/portables/, +/var/lib/extensions/, +/var/lib/confexts/ +or their counterparts in the +/etc/, +/run/, +/usr/lib/ +it is assumed to be trusted\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 2.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 2." 4.2 +.\} +If the disk image contains a Verity enabled disk image, along with a signature partition with a key in the kernel keyring or in +/etc/verity\&.d/ +(and related directories) the disk image is considered trusted\&. +.RE +.PP +This service provides one +\m[blue]\fBVarlink\fR\m[]\&\s-2\u[2]\d\s+2 +service: +\fBio\&.systemd\&.MountFileSystem\fR +which accepts a file descriptor to a regular file or block device, and returns a number of file descriptors referring to an +\fBfsmount()\fR +file descriptor the client may then attach to a path of their choice\&. +.PP +The returned mounts are automatically allowlisted in the per\-user\-namespace allowlist maintained by +\fBsystemd-nsresourced.service\fR(8)\&. +.PP +The file systems are automatically fsck\*(Aqed before mounting\&. +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), +\fBsystemd-nsresourced.service\fR(8) +.SH "NOTES" +.IP " 1." 4 +Discoverable Partitions Specification +.RS 4 +\%https://uapi-group.org/specifications/specs/discoverable_partitions_specification/ +.RE +.IP " 2." 4 +Varlink +.RS 4 +\%https://varlink.org/ +.RE diff --git a/upstream/fedora-rawhide/man8/systemd-network-generator.service.8 b/upstream/fedora-rawhide/man8/systemd-network-generator.service.8 index e2d012e7..5a39caa3 100644 --- a/upstream/fedora-rawhide/man8/systemd-network-generator.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-network-generator.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-NETWORK\-GENERATOR\&.SERVICE" "8" "" "systemd 255" "systemd-network-generator.service" +.TH "SYSTEMD\-NETWORK\-GENERATOR\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-network-generator.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -68,7 +68,7 @@ option accepts the special value Added in version 245\&. .RE .PP -\fIifname=\fR, \fInet\&.ifname\-policy=\fR +\fIifname=\fR, \fInet\&.ifname_policy=\fR .RS 4 Translated into \fBsystemd.link\fR(5) @@ -91,8 +91,36 @@ See and \fBsystemd-udevd.service\fR(8) for option syntax and details\&. +.SH "CREDENTIALS" +.PP +\fBsystemd\-network\-generator\fR +supports the service credentials logic as implemented by +\fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR +(see +\fBsystemd.exec\fR(5) +for details)\&. The following credentials are used when passed in: +.PP +\fInetwork\&.conf\&.*\fR, \fInetwork\&.link\&.*\fR, \fInetwork\&.netdev\&.*\fR, \fInetwork\&.network\&.*\fR +.RS 4 +These credentials should contain valid +\fBnetworkd.conf\fR(5), +\fBsystemd.link\fR(5), +\fBsystemd.netdev\fR(5), +\fBsystemd.network\fR(5) +configuration data\&. From each matching credential a separate file is created\&. Example: a passed credential +network\&.link\&.50\-foobar +will be copied into a configuration file +50\-foobar\&.link\&. +.sp +Note that the resulting files are created world\-readable, it\*(Aqs hence recommended to not include secrets in these credentials, but supply them via separate credentials directly to +systemd\-networkd\&.service\&. +.sp +Added in version 256\&. +.RE +.PP +Note that by default the +systemd\-network\-generator\&.service +unit file is set up to inherit the these credentials from the service manager\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-networkd.service\fR(8), -\fBdracut\fR(8) +\fBsystemd\fR(1), \fBsystemd-networkd.service\fR(8), \fBdracut\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-networkd-wait-online.service.8 b/upstream/fedora-rawhide/man8/systemd-networkd-wait-online.service.8 index a1eafa54..b66b5374 100644 --- a/upstream/fedora-rawhide/man8/systemd-networkd-wait-online.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-networkd-wait-online.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-NETWORKD\-WAIT\-ONLINE\&.SERVICE" "8" "" "systemd 255" "systemd-networkd-wait-online.service" +.TH "SYSTEMD\-NETWORKD\-WAIT\-ONLINE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-networkd-wait-online.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -62,7 +62,7 @@ and online\&. .PP The following options are understood: .PP -\fB\-i\fR \fIINTERFACE\fR[:\fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR]], \fB\-\-interface=\fR\fIINTERFACE\fR[:\fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR]] +\fB\-i\fR \fIINTERFACE\fR[:\fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR]], \fB\-\-interface=\fR\fB\fIINTERFACE\fR\fR\fB[:\fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR]]\fR .RS 4 Network interface to wait for before deciding if the system is online\&. This is useful when a system has several interfaces which will be configured, but a particular one is necessary to access some network resources\&. When used, all other interfaces are ignored\&. This option may be used more than once to wait for multiple network interfaces\&. When this option is specified multiple times, then \fBsystemd\-networkd\-wait\-online\fR @@ -80,14 +80,14 @@ otherwise\&. Added in version 213\&. .RE .PP -\fB\-\-ignore=\fR\fIINTERFACE\fR +\fB\-\-ignore=\fR\fB\fIINTERFACE\fR\fR .RS 4 Network interfaces to be ignored when deciding if the system is online\&. By default, only the loopback interface is ignored\&. This option may be used more than once to ignore multiple network interfaces\&. .sp Added in version 219\&. .RE .PP -\fB\-o\fR \fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR], \fB\-\-operational\-state=\fR\fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR] +\fB\-o\fR \fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR], \fB\-\-operational\-state=\fR\fB\fIMIN_OPERSTATE\fR\fR\fB[:\fIMAX_OPERSTATE\fR]\fR .RS 4 Takes a minimum operational state and an optional maximum operational state\&. Please see \fBnetworkctl\fR(1) @@ -160,7 +160,7 @@ waits for one of the specified interfaces to be online\&. This option is useful Added in version 242\&. .RE .PP -\fB\-\-timeout=\fR\fISECS\fR +\fB\-\-timeout=\fR\fB\fISECS\fR\fR .RS 4 Fail the service if the network is not online by the time the timeout elapses\&. A timeout of 0 disables the timeout\&. Defaults to 120 seconds\&. .sp @@ -185,7 +185,4 @@ Print a short version string and exit\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.service\fR(5), -\fBsystemd-networkd.service\fR(8), -\fBnetworkctl\fR(1) +\fBsystemd\fR(1), \fBsystemd.service\fR(5), \fBsystemd-networkd.service\fR(8), \fBnetworkctl\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-networkd.service.8 b/upstream/fedora-rawhide/man8/systemd-networkd.service.8 index f421a6a1..a3f62609 100644 --- a/upstream/fedora-rawhide/man8/systemd-networkd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-networkd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-NETWORKD\&.SERVICE" "8" "" "systemd 255" "systemd-networkd.service" +.TH "SYSTEMD\-NETWORKD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-networkd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -78,10 +78,4 @@ files, see \fBsystemd.netdev\fR(5)\&. .SH "SEE ALSO" .PP -\fBnetworkctl\fR(1), -\fBsystemd\fR(1), -\fBsystemd.link\fR(5), -\fBsystemd.network\fR(5), -\fBsystemd.netdev\fR(5), -\fBsystemd-networkd-wait-online.service\fR(8), -\fBsystemd-network-generator.service\fR(8) +\fBnetworkctl\fR(1), \fBsystemd\fR(1), \fBsystemd.link\fR(5), \fBsystemd.network\fR(5), \fBsystemd.netdev\fR(5), \fBsystemd-networkd-wait-online.service\fR(8), \fBsystemd-network-generator.service\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-nsresourced.service.8 b/upstream/fedora-rawhide/man8/systemd-nsresourced.service.8 new file mode 100644 index 00000000..c4c80865 --- /dev/null +++ b/upstream/fedora-rawhide/man8/systemd-nsresourced.service.8 @@ -0,0 +1,78 @@ +'\" t +.TH "SYSTEMD\-NSRESOURCED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-nsresourced.service" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +systemd-nsresourced.service, systemd-nsresourced \- User Namespace Resource Delegation Service +.SH "SYNOPSIS" +.PP +systemd\-nsresourced\&.service +.PP +/usr/lib/systemd/systemd\-nsresourced +.SH "DESCRIPTION" +.PP +\fBsystemd\-nsresourced\fR +is a system service that permits transient delegation of a a UID/GID range to a user namespace (see +\fBuser_namespaces\fR(7)) allocated by a client, via a Varlink IPC API\&. +.PP +Unprivileged clients may allocate a user namespace, and then request a UID/GID range to be assigned to it via this service\&. The user namespace may then be used to run containers and other sandboxes, and/or apply it to an id\-mapped mount\&. +.PP +Allocations of UIDs/GIDs this way are transient: when a user namespace goes away, its UID/GID range is returned to the pool of available ranges\&. In order to ensure that clients cannot gain persistency in their transient UID/GID range a BPF\-LSM based policy is enforced that ensures that user namespaces set up this way can only write to file systems they allocate themselves or that are explicitly allowlisted via +\fBsystemd\-nsresourced\fR\&. +.PP +\fBsystemd\-nsresourced\fR +automatically ensures that any registered UID ranges show up in the system\*(Aqs NSS database via the +\m[blue]\fBUser/Group Record Lookup API via Varlink\fR\m[]\&\s-2\u[1]\d\s+2\&. +.PP +Currently, only UID/GID ranges consisting of either exactly 1 or exactly 65536 UIDs/GIDs can be registered with this service\&. Moreover, UIDs and GIDs are always allocated together, and symmetrically\&. +.PP +The service provides API calls to allowlist mounts (referenced via their mount file descriptors as per Linux +\fBfsmount()\fR +API), to pass ownership of a cgroup subtree to the user namespace and to delegate a virtual Ethernet device pair to the user namespace\&. When used in combination this is sufficient to implement fully unprivileged container environments, as implemented by +\fBsystemd-nspawn\fR(1), fully unprivileged +\fIRootImage=\fR +(see +\fBsystemd.exec\fR(5)) or fully unprivileged disk image tools such as +\fBsystemd-dissect\fR(1)\&. +.PP +This service provides one +\m[blue]\fBVarlink\fR\m[]\&\s-2\u[2]\d\s+2 +service: +\fBio\&.systemd\&.NamespaceResource\fR +allows registering user namespaces, and assign mounts, cgroups and network interfaces to it\&. +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), +\fBsystemd-mountfsd.service\fR(8), +\fBsystemd-nspawn\fR(1), +\fBsystemd.exec\fR(5), +\fBsystemd-dissect\fR(1), +\fBuser_namespaces\fR(7) +.SH "NOTES" +.IP " 1." 4 +User/Group Record Lookup API via Varlink +.RS 4 +\%https://systemd.io/USER_GROUP_API +.RE +.IP " 2." 4 +Varlink +.RS 4 +\%https://varlink.org/ +.RE diff --git a/upstream/fedora-rawhide/man8/systemd-oomd.service.8 b/upstream/fedora-rawhide/man8/systemd-oomd.service.8 index b29c880d..f39f1704 100644 --- a/upstream/fedora-rawhide/man8/systemd-oomd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-oomd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-OOMD\&.SERVICE" "8" "" "systemd 255" "systemd-oomd.service" +.TH "SYSTEMD\-OOMD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-oomd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -133,11 +133,7 @@ Print a short version string and exit\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-system.conf\fR(5), -\fBsystemd.resource-control\fR(5), -\fBoomd.conf\fR(5), -\fBoomctl\fR(1) +\fBsystemd\fR(1), \fBsystemd-system.conf\fR(5), \fBsystemd.resource-control\fR(5), \fBoomd.conf\fR(5), \fBoomctl\fR(1) .SH "NOTES" .IP " 1." 4 "In defence of swap: common misconceptions" diff --git a/upstream/fedora-rawhide/man8/systemd-pcrlock.8 b/upstream/fedora-rawhide/man8/systemd-pcrlock.8 index b3206f6b..004515d3 100644 --- a/upstream/fedora-rawhide/man8/systemd-pcrlock.8 +++ b/upstream/fedora-rawhide/man8/systemd-pcrlock.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-PCRLOCK" "8" "" "systemd 255" "systemd-pcrlock" +.TH "SYSTEMD\-PCRLOCK" "8" "" "systemd 256~rc3" "systemd-pcrlock" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -22,8 +22,8 @@ .SH "NAME" systemd-pcrlock, systemd-pcrlock-file-system.service, systemd-pcrlock-firmware-code.service, systemd-pcrlock-firmware-config.service, systemd-pcrlock-machine-id.service, systemd-pcrlock-make-policy.service, systemd-pcrlock-secureboot-authority.service, systemd-pcrlock-secureboot-policy.service \- Analyze and predict TPM2 PCR states and generate an access policy from the prediction .SH "SYNOPSIS" -.HP \w'\fB/usr/lib/systemd/systemd\-pcrlock\ \fR\fB[OPTIONS...]\fR\ 'u -\fB/usr/lib/systemd/systemd\-pcrlock \fR\fB[OPTIONS...]\fR +.HP \w'\fB/usr/lib/systemd/systemd\-pcrlock\fR\ 'u +\fB/usr/lib/systemd/systemd\-pcrlock\fR [OPTIONS...] .SH "DESCRIPTION" .PP Note: this command is experimental for now\&. While it is likely to become a regular component of systemd, it might still change in behaviour and interface\&. @@ -80,7 +80,7 @@ The current PCR state of the TPM2 chip\&. Boot component definition files (*\&.pcrlock and *\&.pcrlock\&.d/*\&.pcrlock, see -\fBsystemd.pcrlock\fR(5)) that each define expected measurements for one component of the boot process, permitting alternative variants for each\&. (Variants may be used used to bless multiple kernel versions or boot loader versions at the same time\&.) +\fBsystemd.pcrlock\fR(5)) that each define expected measurements for one component of the boot process, permitting alternative variants for each\&. (Variants may be used to bless multiple kernel versions or boot loader versions at the same time\&.) .RE .PP It uses these inputs to generate a combined event log, validating it against the PCR states\&. It then attempts to recognize event log records and matches them against the defined components\&. For each PCR where this can be done comprehensively (i\&.e\&. where all listed records and all defined components have been matched) this may then be used to predict future PCR measurements, taking the alternative variants defined for each component into account\&. This prediction may then be converted into a TPM2 access policy (consisting of TPM2 @@ -120,7 +120,7 @@ Added in version 255\&. \fBcel\fR .RS 4 This reads the combined TPM2 event log and writes it to STDOUT in -\m[blue]\fBTCG Common Event Log Format (CEL\-JSON)\fR\m[]\&\s-2\u[1]\d\s+2 +\m[blue]\fBTCG Canonical Event Log Format (CEL\-JSON)\fR\m[]\&\s-2\u[1]\d\s+2 format\&. .sp Added in version 255\&. @@ -163,6 +163,20 @@ If the new prediction matches the old this command terminates quickly and execut \fB\-\-force\fR is specified, see below\&.) .sp +Starting with v256, a copy of the +/var/lib/systemd/pcrlock\&.json +policy file is encoded in a credential (see +\fBsystemd-creds\fR(1) +for details) and written to the EFI System Partition or XBOOTLDR partition, in the +/loader/credentials/ +subdirectory\&. There it is picked up at boot by +\fBsystemd-stub\fR(7) +and passed to the invoked initrd, where it can be used to unlock the root file system (which typically contains +/var/, which is where the primary copy of the policy is located, which hence cannot be used to unlock the root file system)\&. The credential file is named after the boot entry token of the installation (see +\fBbootctl\fR(1)), which is configurable via the +\fB\-\-entry\-token=\fR +switch, see below\&. +.sp Added in version 255\&. .RE .PP @@ -372,7 +386,7 @@ Generates/removes a \&.pcrlock file based on raw binary data\&. The data is either read from the specified file or from STDIN (if none is specified)\&. This requires that \fB\-\-pcrs=\fR -is specified\&. The generated pcrlock file is written to the file specified via +is specified\&. The generated \&.pcrlock file is written to the file specified via \fB\-\-pcrlock=\fR or to STDOUT (if none is specified)\&. .sp @@ -410,7 +424,7 @@ Added in version 255\&. .PP \fB\-\-nv\-index=\fR .RS 4 -Specifies to NV index to store the policy in\&. Honoured by +Specifies the NV index to store the policy in\&. Honoured by \fBmake\-policy\fR\&. If not specified the command will automatically pick a free NV index\&. .sp Added in version 255\&. @@ -462,8 +476,20 @@ Added in version 255\&. .PP \fB\-\-recovery\-pin=\fR .RS 4 -Takes a boolean\&. Defaults to false\&. Honoured by -\fBmake\-policy\fR\&. If true, will query the user for a PIN to unlock the TPM2 NV index with\&. If no policy was created before this PIN is used to protect the newly allocated NV index\&. If a policy has been created before the PIN is used to unlock write access to the NV index\&. If this option is not used a PIN is automatically generated\&. Regardless if user supplied or automatically generated, it is stored in encrypted form in the policy metadata file\&. The recovery PIN may be used to regain write access to an NV index in case the access policy became out of date\&. +Takes one of +"hide", +"show" +or +"query"\&. Defaults to +"hide"\&. Honoured by +\fBmake\-policy\fR\&. If +"query", will query the user for a PIN to unlock the TPM2 NV index with\&. If no policy was created before, this PIN is used to protect the newly allocated NV index\&. If a policy has been created before, the PIN is used to unlock write access to the NV index\&. If either +"hide" +or +"show" +is used, a PIN is automatically generated, and \(em only in case of +"show" +\(em displayed on screen\&. Regardless if user supplied or automatically generated, it is stored in encrypted form in the policy metadata file\&. The recovery PIN may be used to regain write access to an NV index in case the access policy became out of date\&. .sp Added in version 255\&. .RE @@ -493,7 +519,18 @@ If specified with Added in version 255\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-entry\-token=\fR +.RS 4 +Sets the boot entry token to use for the file name for the pcrlock policy credential in the EFI System Partition or XBOOTLDR partition\&. See the +\fBbootctl\fR(1) +option of the same regarding expected values\&. This switch has an effect on the +\fBmake\-policy\fR +command only\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Shows output formatted as JSON\&. Expects one of "short" @@ -523,15 +560,10 @@ Print a short version string and exit\&. On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.pcrlock\fR(5), -\fBsystemd-cryptenroll\fR(1), -\fBsystemd-cryptsetup@.service\fR(8), -\fBsystemd-repart\fR(8), -\fBsystemd-pcrmachine.service\fR(8) +\fBsystemd\fR(1), \fBsystemd.pcrlock\fR(5), \fBsystemd-cryptenroll\fR(1), \fBsystemd-cryptsetup@.service\fR(8), \fBsystemd-repart\fR(8), \fBsystemd-pcrmachine.service\fR(8), \fBsystemd-creds\fR(1), \fBsystemd-stub\fR(7), \fBbootctl\fR(1) .SH "NOTES" .IP " 1." 4 -TCG Common Event Log Format (CEL-JSON) +TCG Canonical Event Log Format (CEL-JSON) .RS 4 \%https://trustedcomputinggroup.org/resource/canonical-event-log-format/ .RE diff --git a/upstream/fedora-rawhide/man8/systemd-pcrphase.service.8 b/upstream/fedora-rawhide/man8/systemd-pcrphase.service.8 index 38f7e40c..5236243d 100644 --- a/upstream/fedora-rawhide/man8/systemd-pcrphase.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-pcrphase.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-PCRPHASE\&.SERVICE" "8" "" "systemd 255" "systemd-pcrphase.service" +.TH "SYSTEMD\-PCRPHASE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-pcrphase.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -204,7 +204,7 @@ are specified defaults to 15, otherwise defaults to 11\&. Added in version 255\&. .RE .PP -\fB\-\-tpm2\-device=\fR\fIPATH\fR +\fB\-\-tpm2\-device=\fR\fB\fIPATH\fR\fR .RS 4 Controls which TPM2 device to use\&. Expects a device node path referring to the TPM2 chip (e\&.g\&. /dev/tpmrm0)\&. Alternatively the special value @@ -254,7 +254,7 @@ Measurements are logged into an event log file maintained in /run/log/systemd/tpm2\-measure\&.log, which contains a \m[blue]\fBJSON\-SEQ\fR\m[]\&\s-2\u[1]\d\s+2 series of objects that follow the general structure of the -\m[blue]\fBTCG Common Event Log Format (CEL\-JSON)\fR\m[]\&\s-2\u[2]\d\s+2 +\m[blue]\fBTCG Canonical Event Log Format (CEL\-JSON)\fR\m[]\&\s-2\u[2]\d\s+2 event objects (but lack the "recnum" field)\&. @@ -269,12 +269,7 @@ Added in version 252\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-stub\fR(7), -\fBsystemd-measure\fR(1), -\fBsystemd-gpt-auto-generator\fR(8), -\fBsystemd-fstab-generator\fR(8), -\m[blue]\fBTPM2 PCR Measurements Made by systemd\fR\m[]\&\s-2\u[3]\d\s+2 +\fBsystemd\fR(1), \fBsystemd-stub\fR(7), \fBsystemd-measure\fR(1), \fBsystemd-gpt-auto-generator\fR(8), \fBsystemd-fstab-generator\fR(8), \m[blue]\fBTPM2 PCR Measurements Made by systemd\fR\m[]\&\s-2\u[3]\d\s+2 .SH "NOTES" .IP " 1." 4 JSON-SEQ @@ -282,7 +277,7 @@ JSON-SEQ \%https://www.rfc-editor.org/rfc/rfc7464.html .RE .IP " 2." 4 -TCG Common Event Log Format (CEL-JSON) +TCG Canonical Event Log Format (CEL-JSON) .RS 4 \%https://trustedcomputinggroup.org/resource/canonical-event-log-format/ .RE diff --git a/upstream/fedora-rawhide/man8/systemd-portabled.service.8 b/upstream/fedora-rawhide/man8/systemd-portabled.service.8 index e3b40f6e..36a58bb2 100644 --- a/upstream/fedora-rawhide/man8/systemd-portabled.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-portabled.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-PORTABLED\&.SERVICE" "8" "" "systemd 255" "systemd-portabled.service" +.TH "SYSTEMD\-PORTABLED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-portabled.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -41,9 +41,7 @@ See the page for details about the concepts this service implements\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBportablectl\fR(1), -\fBorg.freedesktop.portable1\fR(5) +\fBsystemd\fR(1), \fBportablectl\fR(1), \fBorg.freedesktop.portable1\fR(5) .SH "NOTES" .IP " 1." 4 Portable Services diff --git a/upstream/fedora-rawhide/man8/systemd-poweroff.service.8 b/upstream/fedora-rawhide/man8/systemd-poweroff.service.8 index b7a3d813..9aecb49d 100644 --- a/upstream/fedora-rawhide/man8/systemd-poweroff.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-poweroff.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-POWEROFF\&.SERVICE" "8" "" "systemd 255" "systemd-poweroff.service" +.TH "SYSTEMD\-POWEROFF\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-poweroff.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -68,7 +68,7 @@ and pass one arguments to them: either "reboot", or "kexec", depending on the chosen action\&. All executables in this directory are executed in parallel, and execution of the action is not continued before all executables finished\&. Note that these executables are run \fIafter\fR -all services have been shut down, and after most mounts have been detached (the root file system as well as +all services have been shut down, and after most mounts have been unmounted (the root file system as well as /run/ and various API file systems are still around though)\&. This means any programs dropped into this directory must be prepared to run in such a limited execution environment and not rely on external services or hierarchies such as /var/ @@ -84,10 +84,4 @@ Another form of shutdown is provided by the functionality\&. It reboots only the OS userspace, leaving the kernel, firmware, and hardware as it is\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.special\fR(7), -\fBreboot\fR(2), -\fBsystemd-suspend.service\fR(8), -\fBsystemd-soft-reboot.service\fR(8), -\fBbootup\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.special\fR(7), \fBreboot\fR(2), \fBsystemd-suspend.service\fR(8), \fBsystemd-soft-reboot.service\fR(8), \fBbootup\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-pstore.service.8 b/upstream/fedora-rawhide/man8/systemd-pstore.service.8 index 3eb96dec..ebf9b0ff 100644 --- a/upstream/fedora-rawhide/man8/systemd-pstore.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-pstore.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-PSTORE\&.SERVICE" "8" "" "systemd 255" "systemd-pstore.service" +.TH "SYSTEMD\-PSTORE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-pstore.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man8/systemd-quotacheck.service.8 b/upstream/fedora-rawhide/man8/systemd-quotacheck.service.8 index 5a4d5e34..17ddbaff 100644 --- a/upstream/fedora-rawhide/man8/systemd-quotacheck.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-quotacheck.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-QUOTACHECK\&.SERVICE" "8" "" "systemd 255" "systemd-quotacheck.service" +.TH "SYSTEMD\-QUOTACHECK\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-quotacheck.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -51,6 +51,4 @@ Added in version 186\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBquotacheck\fR(8), -\fBsystemd-fsck@.service\fR(8) +\fBsystemd\fR(1), \fBquotacheck\fR(8), \fBsystemd-fsck@.service\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-random-seed.service.8 b/upstream/fedora-rawhide/man8/systemd-random-seed.service.8 index d8cbd444..4c069fc1 100644 --- a/upstream/fedora-rawhide/man8/systemd-random-seed.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-random-seed.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-RANDOM\-SEED\&.SERVICE" "8" "" "systemd 255" "systemd-random-seed.service" +.TH "SYSTEMD\-RANDOM\-SEED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-random-seed.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -67,12 +67,7 @@ Added in version 243\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBrandom\fR(4), -\fBsystemd-boot\fR(7), -\fBsystemd-stub\fR(7), -\fBbootctl\fR(4), -\fBsystemd-boot-random-seed.service\fR(8) +\fBsystemd\fR(1), \fBrandom\fR(4), \fBsystemd-boot\fR(7), \fBsystemd-stub\fR(7), \fBbootctl\fR(4), \fBsystemd-boot-random-seed.service\fR(8) .SH "NOTES" .IP " 1." 4 Safely Building Images diff --git a/upstream/fedora-rawhide/man8/systemd-rc-local-generator.8 b/upstream/fedora-rawhide/man8/systemd-rc-local-generator.8 index 81d97fed..ad732c74 100644 --- a/upstream/fedora-rawhide/man8/systemd-rc-local-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-rc-local-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-RC\-LOCAL\-GENERATOR" "8" "" "systemd 255" "systemd-rc-local-generator" +.TH "SYSTEMD\-RC\-LOCAL\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-rc-local-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -63,12 +63,14 @@ After=network\-online\&.target .PP Support for /etc/rc\&.d/rc\&.local -is provided for compatibility with specific System V systems only\&. However, it is strongly recommended to avoid making use of this script today, and instead provide proper unit files with appropriate dependencies for any scripts to run during the boot process\&. Note that the path to the script is set at compile time and varies between distributions\&. +is provided for compatibility with specific System\ \&V systems only\&. However, it is strongly recommended to avoid using this script today, and instead provide proper unit files with appropriate dependencies for any scripts to run during the boot process\&. Note that the path to the script is set at compile time and varies between distributions\&. .PP systemd\-rc\-local\-generator implements \fBsystemd.generator\fR(7)\&. +.SH "NOTES" +.PP +On systems with SELinux, when creating the file, make sure to set the appropriate context, e\&.g\&. with "\fBsudo restorecon \-v /etc/rc\&.d/rc\&.local\fR"\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-remount-fs.service.8 b/upstream/fedora-rawhide/man8/systemd-remount-fs.service.8 index b9afacff..b58e012f 100644 --- a/upstream/fedora-rawhide/man8/systemd-remount-fs.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-remount-fs.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-REMOUNT\-FS\&.SERVICE" "8" "" "systemd 255" "systemd-remount-fs.service" +.TH "SYSTEMD\-REMOUNT\-FS\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-remount-fs.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -58,11 +58,7 @@ is usually pulled in by and other options\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBfstab\fR(5), -\fBmount\fR(8), -\fBsystemd-fstab-generator\fR(8), -\fBsystemd-gpt-auto-generator\fR(8) +\fBsystemd\fR(1), \fBfstab\fR(5), \fBmount\fR(8), \fBsystemd-fstab-generator\fR(8), \fBsystemd-gpt-auto-generator\fR(8) .SH "NOTES" .IP " 1." 4 API File Systems diff --git a/upstream/fedora-rawhide/man8/systemd-repart.8 b/upstream/fedora-rawhide/man8/systemd-repart.8 index b873a9f5..58006473 100644 --- a/upstream/fedora-rawhide/man8/systemd-repart.8 +++ b/upstream/fedora-rawhide/man8/systemd-repart.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-REPART" "8" "" "systemd 255" "systemd-repart" +.TH "SYSTEMD\-REPART" "8" "" "systemd 256~rc3" "systemd-repart" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -415,6 +415,19 @@ setting in partition files\&. Added in version 252\&. .RE .PP +\fB\-\-private\-key\-source=\fR +.RS 4 +Takes one of +"file", +"engine" +or +"provider"\&. In the latter two cases, it is followed by the name of a provider or engine, separated by colon, that will be passed to OpenSSL\*(Aqs "engine" or "provider" logic\&. Configures the signing mechanism to use when creating verity signature partitions with the +\fIVerity=signature\fR +setting in partition files\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-\-certificate=\fR .RS 4 Takes a file system path\&. Configures the PEM encoded X\&.509 certificate to use when creating verity signature partitions with the @@ -435,7 +448,7 @@ and have the same effect on partitions where TPM2 enrollment is requested\&. Added in version 248\&. .RE .PP -\fB\-\-tpm2\-device\-key=\fR [PATH], \fB\-\-tpm2\-seal\-key\-handle=\fR [HANDLE] +\fB\-\-tpm2\-device\-key=\fR\fB\fIPATH\fR\fR, \fB\-\-tpm2\-seal\-key\-handle=\fR\fB\fIHANDLE\fR\fR .RS 4 Configures a TPM2 SRK key to bind encryption to\&. See \fBsystemd-cryptenroll\fR(1) @@ -444,7 +457,7 @@ for details on this option\&. Added in version 255\&. .RE .PP -\fB\-\-tpm2\-public\-key=\fR [PATH], \fB\-\-tpm2\-public\-key\-pcrs=\fR [PCR...] +\fB\-\-tpm2\-public\-key=\fR\fB\fIPATH\fR\fR, \fB\-\-tpm2\-public\-key\-pcrs=\fR\fB\fIPCR\fR\fI[+PCR\&.\&.\&.]\fR\fR .RS 4 Configures a TPM2 signed PCR policy to bind encryption to\&. See \fBsystemd-cryptenroll\fR(1) @@ -453,7 +466,7 @@ for details on these two options\&. Added in version 252\&. .RE .PP -\fB\-\-tpm2\-pcrlock=\fR [PATH] +\fB\-\-tpm2\-pcrlock=\fR\fB\fIPATH\fR\fR .RS 4 Configures a TPM2 pcrlock policy to bind encryption to\&. See \fBsystemd-cryptenroll\fR(1) @@ -462,7 +475,7 @@ for details on this option\&. Added in version 255\&. .RE .PP -\fB\-\-split=\fR [BOOL] +\fB\-\-split=\fR\fB\fIBOOL\fR\fR .RS 4 Enables generation of split artifacts from partitions configured with \fISplitName=\fR\&. If enabled, for each partition with @@ -485,7 +498,7 @@ is enabled\&. Added in version 252\&. .RE .PP -\fB\-\-include\-partitions=\fR [PARTITION...], \fB\-\-exclude\-partitions=\fR [PARTITION...] +\fB\-\-include\-partitions=\fR\fB\fIPARTITIONS\fR\fR, \fB\-\-exclude\-partitions=\fR\fB\fIPARTITIONS\fR\fR .RS 4 These options specify which partition types \fBsystemd\-repart\fR @@ -501,7 +514,7 @@ in Added in version 253\&. .RE .PP -\fB\-\-defer\-partitions=\fR [PARTITION...] +\fB\-\-defer\-partitions=\fR\fB\fIPARTITIONS\fR\fR .RS 4 This option specifies for which partition types \fBsystemd\-repart\fR @@ -514,7 +527,7 @@ was executed\&. Added in version 253\&. .RE .PP -\fB\-\-sector\-size=\fR [BYTES] +\fB\-\-sector\-size=\fR\fB\fIBYTES\fR\fR .RS 4 This option allows configuring the sector size of the image produced by \fBsystemd\-repart\fR\&. It takes a value that is a power of @@ -527,7 +540,7 @@ and Added in version 253\&. .RE .PP -\fB\-\-architecture=\fR [ARCH] +\fB\-\-architecture=\fR\fB\fIARCH\fR\fR .RS 4 This option allows overriding the architecture used for architecture specific partition types\&. For example, if set to "arm64" @@ -562,7 +575,7 @@ or Added in version 254\&. .RE .PP -\fB\-\-offline=\fR [BOOL] +\fB\-\-offline=\fR\fB\fIBOOL\fR\fR .RS 4 Instructs \fBsystemd\-repart\fR @@ -576,7 +589,7 @@ will build the image online if possible and fall back to building the image offl Added in version 254\&. .RE .PP -\fB\-\-copy\-from=\fR [IMAGE] +\fB\-\-copy\-from=\fR\fB\fIIMAGE\fR\fR .RS 4 Instructs \fBsystemd\-repart\fR @@ -585,7 +598,7 @@ to synthesize partition definitions from the partition table in the given image\ Added in version 255\&. .RE .PP -\fB\-\-copy\-source=\fR\fIPATH\fR, \fB\-s\fR \fIPATH\fR +\fB\-\-copy\-source=\fR\fB\fIPATH\fR\fR, \fB\-s\fR \fIPATH\fR .RS 4 Specifies a source directory all \fICopyFiles=\fR @@ -603,7 +616,7 @@ where the latter takes precedence\&. Added in version 255\&. .RE .PP -\fB\-\-make\-ddi=\fR\fITYPE\fR +\fB\-\-make\-ddi=\fR\fB\fITYPE\fR\fR .RS 4 Takes one of "sysext", @@ -662,6 +675,32 @@ Shortcuts for Added in version 255\&. .RE .PP +\fB\-\-generate\-fstab=\fR\fB\fIPATH\fR\fR +.RS 4 +Specifies a path where to write fstab entries for the mountpoints configured with +\fBMountPoint=\fR +in the root directory specified with +\fB\-\-copy\-source=\fR +or +\fB\-\-root=\fR +or in the host\*(Aqs root directory if neither is specified\&. Disabled by default\&. +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-generate\-crypttab=\fR\fB\fIPATH\fR\fR +.RS 4 +Specifies a path where to write crypttab entries for the encrypted volumes configured with +\fBEncryptedVolume=\fR +in the root directory specified with +\fB\-\-copy\-source=\fR +or +\fB\-\-root=\fR +or in the host\*(Aqs root directory if neither is specified\&. Disabled by default\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-h\fR, \fB\-\-help\fR .RS 4 Print a short help text and exit\&. @@ -682,7 +721,7 @@ Do not pipe output into a pager\&. Do not print the legend, i\&.e\&. column headers and the footer with hints\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Shows output formatted as JSON\&. Expects one of "short" @@ -701,7 +740,7 @@ On success, 0 is returned, a non\-zero failure code otherwise\&. .PP The following creates a configuration extension DDI (confext) for an /etc/motd -update\&. +update: .sp .if n \{\ .RS 4 @@ -724,14 +763,37 @@ systemd\-confext refresh .PP The DDI generated that way may be applied to the system with \fBsystemd-confext\fR(1)\&. +.PP +\fBExample\ \&2.\ \&Generate a system extension image and sign it via PKCS11\fR +.PP +The following creates a system extension DDI (sysext) for an +/usr/foo +update and signs it with a hardware token via PKCS11\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +mkdir tree tree/usr tree/usr/lib/extension\-release\&.d +echo "Hello World" > tree/usr/foo +cat > tree/usr/lib/extension\-release\&.d/extension\-release\&.my\-foo <<EOF +ID=fedora +VERSION_ID=38 +IMAGE_ID=my\-foo +IMAGE_VERSION=7 +EOF +systemd\-repart \-\-make\-ddi=sysext \-\-private\-key\-source=engine:pkcs11 \-\-private\-key="pkcs11:model=PKCS%2315%20emulated;manufacturer=piv_II;serial=0123456789abcdef;token=Some%20Cert" \-\-certificate=cert\&.crt \-s tree/ /var/lib/extensions/my\-foo\&.sysext\&.raw +systemd\-sysext refresh +.fi +.if n \{\ +.RE +.\} +.PP +The DDI generated that way may be applied to the system with +\fBsystemd-sysext\fR(1)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBrepart.d\fR(5), -\fBmachine-id\fR(5), -\fBsystemd-cryptenroll\fR(1), -\fBportablectl\fR(1), -\fBsystemd-sysext\fR(8) +\fBsystemd\fR(1), \fBrepart.d\fR(5), \fBmachine-id\fR(5), \fBsystemd-cryptenroll\fR(1), \fBportablectl\fR(1), \fBsystemd-sysext\fR(8) .SH "NOTES" .IP " 1." 4 portable service diff --git a/upstream/fedora-rawhide/man8/systemd-resolved.service.8 b/upstream/fedora-rawhide/man8/systemd-resolved.service.8 index 86ed8074..00e8257a 100644 --- a/upstream/fedora-rawhide/man8/systemd-resolved.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-resolved.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-RESOLVED\&.SERVICE" "8" "" "systemd 255" "systemd-resolved.service" +.TH "SYSTEMD\-RESOLVED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-resolved.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -41,7 +41,7 @@ is a system service that provides network name resolution to local applications\ .\} The native, fully\-featured API \fBsystemd\-resolved\fR -exposes on the bus, see +exposes via D\-Bus, see \fBorg.freedesktop.resolve1\fR(5) and \fBorg.freedesktop.LogControl1\fR(5) @@ -56,6 +56,21 @@ for details\&. Usage of this API is generally recommended to clients as it is as .sp -1 .IP \(bu 2.3 .\} +The native API +\fBsystemd\-resolved\fR +exposes via Varlink on the +/run/systemd/resolve/io\&.systemd\&.Resolve +AF_UNIX socket\&. This provides similar functionality as the D\-Bus interface, but is available during the entire runtime, without requiring a running D\-Bus system bus broker service\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} The glibc \fBgetaddrinfo\fR(3) API as defined by @@ -657,6 +672,17 @@ command, however the latter is recommended since it operates in a synchronous wa .sp Added in version 235\&. .RE +.PP +\fBSIGHUP\fR +.RS 4 +Upon reception of the +\fBSIGHUP\fR +process signal +\fBsystemd\-resolved\fR +will flush all caches it maintains, drop all open TCP connections (if any), and reload its configuration files\&. +.sp +Added in version 256\&. +.RE .SH "CREDENTIALS" .PP \fBsystemd\-resolved\fR @@ -737,15 +763,7 @@ Port 5355 on all local addresses, both IPv4 and IP6 (0\&.0\&.0\&.0 and ::0), for .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBresolved.conf\fR(5), -\fBdnssec-trust-anchors.d\fR(5), -\fBnss-resolve\fR(8), -\fBresolvectl\fR(1), -\fBresolv.conf\fR(5), -\fBhosts\fR(5), -\fBsystemd.network\fR(5), -\fBsystemd-networkd.service\fR(8) +\fBsystemd\fR(1), \fBresolved.conf\fR(5), \fBdnssec-trust-anchors.d\fR(5), \fBnss-resolve\fR(8), \fBresolvectl\fR(1), \fBresolv.conf\fR(5), \fBhosts\fR(5), \fBsystemd.network\fR(5), \fBsystemd-networkd.service\fR(8) .SH "NOTES" .IP " 1." 4 RFC3493 diff --git a/upstream/fedora-rawhide/man8/systemd-rfkill.service.8 b/upstream/fedora-rawhide/man8/systemd-rfkill.service.8 index 17a091d7..387cd524 100644 --- a/upstream/fedora-rawhide/man8/systemd-rfkill.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-rfkill.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-RFKILL\&.SERVICE" "8" "" "systemd 255" "systemd-rfkill.service" +.TH "SYSTEMD\-RFKILL\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-rfkill.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/fedora-rawhide/man8/systemd-run-generator.8 b/upstream/fedora-rawhide/man8/systemd-run-generator.8 index 759d7647..97551fdc 100644 --- a/upstream/fedora-rawhide/man8/systemd-run-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-run-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-RUN\-GENERATOR" "8" "" "systemd 255" "systemd-run-generator" +.TH "SYSTEMD\-RUN\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-run-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -81,9 +81,4 @@ Use a command like the following to add a user to the user database inside a con end up in the generated unit file together and are neither split apart by the command shell nor by the generator\&.) .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBkernel-command-line\fR(7), -\fBsystemd-nspawn\fR(7), -\fBsystemd.unit\fR(5), -\fBsystemd.service\fR(5) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBkernel-command-line\fR(7), \fBsystemd-nspawn\fR(7), \fBsystemd.unit\fR(5), \fBsystemd.service\fR(5) diff --git a/upstream/fedora-rawhide/man8/systemd-socket-proxyd.8 b/upstream/fedora-rawhide/man8/systemd-socket-proxyd.8 index ef77126a..6ca6077c 100644 --- a/upstream/fedora-rawhide/man8/systemd-socket-proxyd.8 +++ b/upstream/fedora-rawhide/man8/systemd-socket-proxyd.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SOCKET\-PROXYD" "8" "" "systemd 255" "systemd-socket-proxyd" +.TH "SYSTEMD\-SOCKET\-PROXYD" "8" "" "systemd 256~rc3" "systemd-socket-proxyd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -39,6 +39,18 @@ This utility\*(Aqs behavior is similar to are support for socket activation with "Accept=no" and an event\-driven design that scales better with the number of connections\&. +.PP +Note that +\fBsystemd\-socket\-proxyd\fR +will not forward socket side channel information, i\&.e\&. will not forward +\fBSCM_RIGHTS\fR, +\fBSCM_CREDENTIALS\fR, +\fBSCM_SECURITY\fR, +\fBSO_PEERCRED\fR, +\fBSO_PEERPIDFD\fR, +\fBSO_PEERSEC\fR, +\fBSO_PEERGROUPS\fR +and similar\&. .SH "OPTIONS" .PP The following options are understood: @@ -229,10 +241,4 @@ $ curl http://localhost:80/ .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.socket\fR(5), -\fBsystemd.service\fR(5), -\fBsystemctl\fR(1), -\fBsocat\fR(1), -\fBnginx\fR(1), -\fBcurl\fR(1) +\fBsystemd\fR(1), \fBsystemd.socket\fR(5), \fBsystemd.service\fR(5), \fBsystemctl\fR(1), \fBsocat\fR(1), \fBnginx\fR(1), \fBcurl\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-soft-reboot.service.8 b/upstream/fedora-rawhide/man8/systemd-soft-reboot.service.8 index 33b4ff5f..7ede2ef7 100644 --- a/upstream/fedora-rawhide/man8/systemd-soft-reboot.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-soft-reboot.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SOFT\-REBOOT\&.SERVICE" "8" "" "systemd 255" "systemd-soft-reboot.service" +.TH "SYSTEMD\-SOFT\-REBOOT\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-soft-reboot.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -216,35 +216,24 @@ via \fISurviveFinalKillSignal=yes\fR, and also be configured to avoid being stopped on isolate via \fIIgnoreOnIsolate=yes\fR\&. They also have to be configured to be stopped on normal shutdown, reboot and maintenance mode\&. Finally, they have to be ordered after \fBbasic\&.target\fR -to ensure correct ordeering on boot\&. Note that in case any new or custom units are used to isolate to, or that implement an equivalent shutdown functionality, they will also have to be configured manually for correct ordering and conflicting\&. For example: +to ensure correct ordering on boot\&. Note that in case any new or custom units are used to isolate to, or that implement an equivalent shutdown functionality, they will also have to be configured manually for correct ordering and conflicting\&. For example: .sp .if n \{\ .RS 4 .\} .nf [Unit] -Description=My surviving service +Description=My Surviving Service SurviveFinalKillSignal=yes IgnoreOnIsolate=yes DefaultDependencies=no After=basic\&.target -Conflicts=reboot\&.target -Before=reboot\&.target -Conflicts=kexec\&.target -Before=kexec\&.target -Conflicts=poweroff\&.target -Before=poweroff\&.target -Conflicts=halt\&.target -Before=halt\&.target -Conflicts=rescue\&.target -Before=rescue\&.target -Conflicts=emergency\&.target -Before=emergency\&.target +Conflicts=reboot\&.target kexec\&.target poweroff\&.target halt\&.target rescue\&.target emergency\&.target +Before=shutdown\&.target rescue\&.target emergency\&.target [Service] Type=oneshot ExecStart=sleep infinity - .fi .if n \{\ .RE @@ -263,6 +252,301 @@ File system mounts may remain mounted during the transition, and complex storage \fIDefaultDependencies=no\fR, and by avoiding \fIConflicts=umount\&.target\fR) .RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If the unit publishes a service over D\-Bus, the connection needs to be re\-established after soft\-reboot as the D\-Bus broker will be stopped and then started again\&. When using the sd\-bus library this can be achieved by adapting the following example\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +/* SPDX\-License\-Identifier: MIT\-0 */ + +/* A D\-Bus service that automatically reconnects when the system bus is + * restarted\&. + * + * Compile with \*(Aqcc sd_bus_service_reconnect\&.c $(pkg\-config \-\-libs \-\-cflags libsystemd)\*(Aq + * + * To allow the program to take ownership of the name \*(Aqorg\&.freedesktop\&.ReconnectExample\*(Aq, + * add the following as /etc/dbus\-1/system\&.d/org\&.freedesktop\&.ReconnectExample\&.conf + * and then reload the broker with \*(Aqsystemctl reload dbus\*(Aq: + +<?xml version="1\&.0"?> <!\-\-*\-nxml\-*\-\-> +<!DOCTYPE busconfig PUBLIC "\-//freedesktop//DTD D\-BUS Bus Configuration 1\&.0//EN" + "http://www\&.freedesktop\&.org/standards/dbus/1\&.0/busconfig\&.dtd"> +<busconfig> + <policy user="root"> + <allow own="org\&.freedesktop\&.ReconnectExample"/> + <allow send_destination="org\&.freedesktop\&.ReconnectExample"/> + <allow receive_sender="org\&.freedesktop\&.ReconnectExample"/> + </policy> + + <policy context="default"> + <allow send_destination="org\&.freedesktop\&.ReconnectExample"/> + <allow receive_sender="org\&.freedesktop\&.ReconnectExample"/> + </policy> +</busconfig> + + * + * To get the property via busctl: + * + * $ busctl \-\-user get\-property org\&.freedesktop\&.ReconnectExample \e + * /org/freedesktop/ReconnectExample \e + * org\&.freedesktop\&.ReconnectExample \e + * Example + * s "example" + */ + +#include <errno\&.h> +#include <stdio\&.h> +#include <stdlib\&.h> +#include <systemd/sd\-bus\&.h> + +#define _cleanup_(f) __attribute__((cleanup(f))) + +static int log_error(int r, const char *str) { + fprintf(stderr, "%s failed: %s\en", str, strerror(\-r)); + return r; +} + +typedef struct object { + const char *example; + sd_bus **bus; + sd_event **event; +} object; + +static int property_get( + sd_bus *bus, + const char *path, + const char *interface, + const char *property, + sd_bus_message *reply, + void *userdata, + sd_bus_error *error) { + + object *o = userdata; + + if (strcmp(property, "Example") == 0) + return sd_bus_message_append(reply, "s", o\->example); + + return sd_bus_error_setf(error, + SD_BUS_ERROR_UNKNOWN_PROPERTY, + "Unknown property \*(Aq%s\*(Aq", + property); +} + +/* https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_add_object\&.html */ +static const sd_bus_vtable vtable[] = { + SD_BUS_VTABLE_START(0), + SD_BUS_PROPERTY( + "Example", "s", + property_get, + 0, + SD_BUS_VTABLE_PROPERTY_CONST), + SD_BUS_VTABLE_END +}; + +static int setup(object *o); + +static int on_disconnect(sd_bus_message *message, void *userdata, sd_bus_error *ret_error) { + int r; + + r = setup((object *)userdata); + if (r < 0) { + object *o = userdata; + r = sd_event_exit(*o\->event, r); + if (r < 0) + return log_error(r, "sd_event_exit()"); + } + + return 1; +} + +/* Ensure the event loop exits with a clear error if acquiring the well\-known + * service name fails */ +static int request_name_callback(sd_bus_message *m, void *userdata, sd_bus_error *ret_error) { + int r; + + if (!sd_bus_message_is_method_error(m, NULL)) + return 1; + + const sd_bus_error *error = sd_bus_message_get_error(m); + + if (sd_bus_error_has_names(error, SD_BUS_ERROR_TIMEOUT, SD_BUS_ERROR_NO_REPLY)) + return 1; /* The bus is not available, try again later */ + + fprintf(stderr, "Failed to request name: %s\en", error\->message); + object *o = userdata; + r = sd_event_exit(*o\->event, \-sd_bus_error_get_errno(error)); + if (r < 0) + return log_error(r, "sd_event_exit()"); + + return 1; +} + +static int setup(object *o) { + int r; + + /* If we are reconnecting, then the bus object needs to be closed, detached + * from the event loop and recreated\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_detach_event\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_close_unref\&.html + */ + if (*o\->bus) { + r = sd_bus_detach_event(*o\->bus); + if (r < 0) + return log_error(r, "sd_bus_detach_event()"); + *o\->bus = sd_bus_close_unref(*o\->bus); + } + + /* Set up a new bus object for the system bus, configure it to wait for D\-Bus + * to be available instead of failing if it is not, and start it\&. All the + * following operations are asynchronous and will not block waiting for D\-Bus + * to be available\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_new\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_set_address\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_set_bus_client\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_negotiate_creds\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_set_watch_bind\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_set_connected_signal\&.html + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_start\&.html + */ + r = sd_bus_new(o\->bus); + if (r < 0) + return log_error(r, "sd_bus_new()"); + r = sd_bus_set_address(*o\->bus, "unix:path=/run/dbus/system_bus_socket"); + if (r < 0) + return log_error(r, "sd_bus_set_address()"); + r = sd_bus_set_bus_client(*o\->bus, 1); + if (r < 0) + return log_error(r, "sd_bus_set_bus_client()"); + r = sd_bus_negotiate_creds(*o\->bus, 1, SD_BUS_CREDS_UID|SD_BUS_CREDS_EUID|SD_BUS_CREDS_EFFECTIVE_CAPS); + if (r < 0) + return log_error(r, "sd_bus_negotiate_creds()"); + r = sd_bus_set_watch_bind(*o\->bus, 1); + if (r < 0) + return log_error(r, "sd_bus_set_watch_bind()"); + r = sd_bus_start(*o\->bus); + if (r < 0) + return log_error(r, "sd_bus_start()"); + + /* Publish an interface on the bus, specifying our well\-known object access + * path and public interface name\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_add_object\&.html + * https://dbus\&.freedesktop\&.org/doc/dbus\-tutorial\&.html + */ + r = sd_bus_add_object_vtable(*o\->bus, + NULL, + "/org/freedesktop/ReconnectExample", + "org\&.freedesktop\&.ReconnectExample", + vtable, + o); + if (r < 0) + return log_error(r, "sd_bus_add_object_vtable()"); + /* By default the service is only assigned an ephemeral name\&. Also add a + * well\-known one, so that clients know whom to call\&. This needs to be + * asynchronous, as D\-Bus might not be yet available\&. The callback will check + * whether the error is expected or not, in case it fails\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_request_name\&.html + */ + r = sd_bus_request_name_async(*o\->bus, + NULL, + "org\&.freedesktop\&.ReconnectExample", + 0, + request_name_callback, + o); + if (r < 0) + return log_error(r, "sd_bus_request_name_async()"); + /* When D\-Bus is disconnected this callback will be invoked, which will set up + * the connection again\&. This needs to be asynchronous, as D\-Bus might not yet + * be available\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_match_signal_async\&.html + */ + r = sd_bus_match_signal_async(*o\->bus, + NULL, + "org\&.freedesktop\&.DBus\&.Local", + NULL, + "org\&.freedesktop\&.DBus\&.Local", + "Disconnected", + on_disconnect, + NULL, + o); + if (r < 0) + return log_error(r, "sd_bus_match_signal_async()"); + /* Attach the bus object to the event loop so that calls and signals are + * processed\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_attach_event\&.html + */ + r = sd_bus_attach_event(*o\->bus, *o\->event, 0); + if (r < 0) + return log_error(r, "sd_bus_attach_event()"); + + return 0; +} + +int main(int argc, char **argv) { + /* The bus should be relinquished before the program terminates\&. The cleanup + * attribute allows us to do it nicely and cleanly whenever we exit the block\&. + */ + _cleanup_(sd_bus_flush_close_unrefp) sd_bus *bus = NULL; + _cleanup_(sd_event_unrefp) sd_event *event = NULL; + object o = { + \&.example = "example", + \&.bus = &bus, + \&.event = &event, + }; + int r; + + /* Create an event loop data structure, with default parameters\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_event_default\&.html + */ + r = sd_event_default(&event); + if (r < 0) + return log_error(r, "sd_event_default()"); + + /* By default the event loop will terminate when all sources have disappeared, + * so we have to keep it \*(Aqoccupied\*(Aq\&. Register signal handling to do so\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_event_add_signal\&.html + */ + r = sd_event_add_signal(event, NULL, SIGINT|SD_EVENT_SIGNAL_PROCMASK, NULL, NULL); + if (r < 0) + return log_error(r, "sd_event_add_signal(SIGINT)"); + + r = sd_event_add_signal(event, NULL, SIGTERM|SD_EVENT_SIGNAL_PROCMASK, NULL, NULL); + if (r < 0) + return log_error(r, "sd_event_add_signal(SIGTERM)"); + + r = setup(&o); + if (r < 0) + return EXIT_FAILURE; + + /* Enter the main loop, it will exit only on sigint/sigterm\&. + * https://www\&.freedesktop\&.org/software/systemd/man/sd_event_loop\&.html + */ + r = sd_event_loop(event); + if (r < 0) + return log_error(r, "sd_event_loop()"); + + /* https://www\&.freedesktop\&.org/software/systemd/man/sd_bus_release_name\&.html */ + r = sd_bus_release_name(bus, "org\&.freedesktop\&.ReconnectExample"); + if (r < 0) + return log_error(r, "sd_bus_release_name()"); + + return 0; +} +.fi +.if n \{\ +.RE +.\} +.sp +.RE .PP Even though passing resources from one soft reboot cycle to the next is possible this way, we strongly suggest to use this functionality sparingly only, as it creates a more fragile system as resources from different versions of the OS and applications might be mixed with unforeseen consequences\&. In particular it\*(Aqs recommended to \fIavoid\fR @@ -291,12 +575,7 @@ will be performed when the command is invoked\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.special\fR(7), -\fBsystemd-poweroff.service\fR(8), -\fBsystemd-suspend.service\fR(8), -\fBbootup\fR(7) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.special\fR(7), \fBsystemd-poweroff.service\fR(8), \fBsystemd-suspend.service\fR(8), \fBbootup\fR(7) .SH "NOTES" .IP " 1." 4 Portable Services diff --git a/upstream/fedora-rawhide/man8/systemd-ssh-generator.8 b/upstream/fedora-rawhide/man8/systemd-ssh-generator.8 new file mode 100644 index 00000000..cb8151c7 --- /dev/null +++ b/upstream/fedora-rawhide/man8/systemd-ssh-generator.8 @@ -0,0 +1,183 @@ +'\" t +.TH "SYSTEMD\-SSH\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-ssh-generator" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +systemd-ssh-generator \- Generator for binding a socket\-activated SSH server to local \fBAF_VSOCK\fR and \fBAF_UNIX\fR sockets +.SH "SYNOPSIS" +.PP +/usr/lib/systemd/system\-generators/systemd\-ssh\-generator +.SH "DESCRIPTION" +.PP +\fBsystemd\-ssh\-generator\fR +binds a socket\-activated SSH server to local +\fBAF_VSOCK\fR +and +\fBAF_UNIX\fR +sockets under certain conditions\&. It only has an effect if the +\fBsshd\fR(8) +binary is installed\&. Specifically, it does the following: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If invoked in a VM with +\fBAF_VSOCK\fR +support, a socket\-activated SSH per\-connection service is bound to +\fBAF_VSOCK\fR +port 22\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +If invoked in a container environment with a writable directory +/run/host/unix\-export/ +pre\-mounted it binds SSH to an +\fBAF_UNIX\fR +socket +/run/host/unix\-export/ssh\&. The assumption is that this directory is bind mounted to the host side as well, and can be used to connect to the container from there\&. See +\m[blue]\fBContainer Interface\fR\m[]\&\s-2\u[1]\d\s+2 +for more information about this interface\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +A local +\fBAF_UNIX\fR +socket +/run/ssh\-unix\-local/socket +is also bound, unconditionally\&. This may be used for SSH communication from the host to itself, without involving networking, for example to traverse security boundaries safely and with secure authentication\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Additional +\fBAF_UNIX\fR +and +\fBAF_VSOCK\fR +sockets are optionally bound, based on the +\fIsystemd\&.ssh_listen=\fR +kernel command line option or the +ssh\&.listen +system credential (see below)\&. +.RE +.PP +See +\fBsystemd-ssh-proxy\fR(1) +for details on how to connect to these sockets via the +\fBssh\fR +client\&. +.PP +The +\fIssh\&.authorized_keys\&.root\fR +credential can be used to allow specific public keys to log in over SSH\&. See +\fBsystemd.systemd-credentials\fR(7) +for more information\&. +.PP +The generator will use a packaged +sshd@\&.service +service template file if one exists, and otherwise generate a suitable service template file\&. +.PP +systemd\-ssh\-generator +implements +\fBsystemd.generator\fR(7)\&. +.SH "KERNEL COMMAND LINE" +.PP +systemd\-ssh\-generator +understands the following +\fBkernel-command-line\fR(7) +parameters: +.PP +\fIsystemd\&.ssh_auto=\fR +.RS 4 +This option takes an optional boolean argument, and defaults to yes\&. If enabled, the automatic binding to the +\fBAF_VSOCK\fR +and +\fBAF_UNIX\fR +sockets listed above is done\&. If disable, this is not done, except for those explicitly requested via +\fIsystemd\&.ssh_listen=\fR +on the kernel command line or via the +\fIssh\&.listen\fR +system credential\&. +.sp +Added in version 256\&. +.RE +.PP +\fIsystemd\&.ssh_listen=\fR +.RS 4 +This option configures an additional socket to bind SSH to\&. It may be used multiple times to bind multiple sockets\&. The syntax should follow the one of +\fIListenStream=\fR, see +\fBsystemd.socket\fR(5) +for details\&. This functionality supports all socket families systemd supports, including +\fBAF_INET\fR +and +\fBAF_INET6\fR\&. +.sp +Added in version 256\&. +.RE +.SH "CREDENTIALS" +.PP +\fBsystemd\-ssh\-generator\fR +supports the system credentials logic\&. The following credentials are used when passed in: +.PP +\fIssh\&.listen\fR +.RS 4 +This credential should be a text file, with each line referencing one additional socket to bind SSH to\&. The syntax should follow the one of +\fIListenStream=\fR, see +\fBsystemd.socket\fR(5) +for details\&. This functionality supports all socket families systemd supports, including +\fBAF_INET\fR +and +\fBAF_INET6\fR\&. +.sp +Added in version 256\&. +.RE +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), \fBkernel-command-line\fR(7), \fBsystemd.system-credentials\fR(7), \fBvsock\fR(7), \fBunix\fR(7), \fBssh\fR(1), \fBsshd\fR(8) +.SH "NOTES" +.IP " 1." 4 +Container Interface +.RS 4 +\%https://systemd.io/CONTAINER_INTERFACE +.RE diff --git a/upstream/fedora-rawhide/man8/systemd-storagetm.service.8 b/upstream/fedora-rawhide/man8/systemd-storagetm.service.8 index 2f67cdb1..852271d5 100644 --- a/upstream/fedora-rawhide/man8/systemd-storagetm.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-storagetm.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-STORAGETM\&.SERVICE" "8" "" "systemd 255" "systemd-storagetm.service" +.TH "SYSTEMD\-STORAGETM\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-storagetm.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -32,8 +32,22 @@ systemd\-storagetm\&.service is a service that exposes all local block devices as NVMe\-TCP mass storage devices\&. Its primary use\-case is to be invoked by the storage\-target\-mode\&.target unit that can be booted into\&. +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBWarning\fR +.ps -1 +.br .PP -Warning: the NVMe disks are currently exposed without authentication or encryption, in read/write mode\&. This means network peers may read from and write to the device without any restrictions\&. This functionality should hence only be used in a local setup\&. +The NVMe disks are currently exposed without authentication or encryption, in read/write mode\&. This means network peers may read from and write to the device without any restrictions\&. This functionality should hence only be used in a local setup\&. +.sp .5v +.RE .PP Note that to function properly networking must be configured too\&. The recommended mechanism to boot into a storage target mode is by adding "rd\&.systemd\&.unit=storage\-target\-mode\&.target ip=link\-local" @@ -54,7 +68,7 @@ The following options are understood: \fB\-\-nqn=\fR .RS 4 Takes a string\&. If specified configures the NVMe Qualified Name to use for the exposed NVMe\-TCP mass storage devices\&. The NQN should follow the syntax described in -\m[blue]\fBNVM Express Base Specification 2\&.0c\fR\m[]\&\s-2\u[1]\d\s+2, section 4\&.5 "NVMe Qualified Names"\&. Note that the NQN specified here will be suffixed with a dot and the the block device name before it is exposed on the NVMe target\&. If not specified defaults to +\m[blue]\fBNVM Express Base Specification 2\&.0c\fR\m[]\&\s-2\u[1]\d\s+2, section 4\&.5 "NVMe Qualified Names"\&. Note that the NQN specified here will be suffixed with a dot and the block device name before it is exposed on the NVMe target\&. If not specified defaults to "nqn\&.2023\-10\&.io\&.systemd:storagetm\&.\fIID\fR", where ID is replaced by a 128bit ID derived from \fBmachine-id\fR(5)\&. .sp @@ -79,8 +93,7 @@ Print a short version string and exit\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.special\fR(7) +\fBsystemd\fR(1), \fBsystemd.special\fR(7) .SH "NOTES" .IP " 1." 4 NVM Express Base Specification 2.0c diff --git a/upstream/fedora-rawhide/man8/systemd-suspend.service.8 b/upstream/fedora-rawhide/man8/systemd-suspend.service.8 index 1e7b7069..f431b34b 100644 --- a/upstream/fedora-rawhide/man8/systemd-suspend.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-suspend.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SUSPEND\&.SERVICE" "8" "" "systemd 255" "systemd-suspend.service" +.TH "SYSTEMD\-SUSPEND\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-suspend.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -23,15 +23,21 @@ systemd-suspend.service, systemd-hibernate.service, systemd-hybrid-sleep.service, systemd-suspend-then-hibernate.service, systemd-sleep \- System sleep state logic .SH "SYNOPSIS" .PP +.RS 4 systemd\-suspend\&.service -.PP +.RE +.RS 4 systemd\-hibernate\&.service -.PP +.RE +.RS 4 systemd\-hybrid\-sleep\&.service -.PP +.RE +.RS 4 systemd\-suspend\-then\-hibernate\&.service -.PP +.RE +.RS 4 /usr/lib/systemd/system\-sleep +.RE .SH "DESCRIPTION" .PP systemd\-suspend\&.service @@ -68,7 +74,9 @@ where the value of the variable will be "hibernate", or "suspend\-after\-failed\-hibernate" in cases where hibernation has failed\&. Immediately after leaving system suspend and/or hibernation the same executables are run, but the first argument is now -"post"\&. All executables in this directory are executed in parallel, and execution of the action is not continued until all executables have finished\&. +"post"\&. All executables in this directory are executed in parallel, and execution of the action is not continued until all executables have finished\&. Note that +user\&.slice +will be frozen while the executables are running, so they should not attempt to communicate with any user services expecting a reply\&. .PP Note that scripts or binaries dropped in /usr/lib/systemd/system\-sleep/ @@ -94,6 +102,11 @@ or a sleep\&.conf\&.d file\&. See \fBsystemd-sleep.conf\fR(5)\&. +.PP +Note that by default these services freeze +user\&.slice +while they run\&. This prevents the execution of any process in any of the user sessions while the system is entering into and resuming from sleep\&. Thus, this prevents the hooks in +/usr/lib/systemd/system\-sleep/, or any other process for that matter, from communicating with any user session process during sleep\&. .SH "OPTIONS" .PP \fBsystemd\-sleep\fR @@ -117,11 +130,7 @@ Added in version 203\&. .RE .SH "SEE ALSO" .PP -\fBsystemd-sleep.conf\fR(5), -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBsystemd.special\fR(7), -\fBsystemd-halt.service\fR(8) +\fBsystemd-sleep.conf\fR(5), \fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd.special\fR(7), \fBsystemd-halt.service\fR(8) .SH "NOTES" .IP " 1." 4 Inhibitor interface diff --git a/upstream/fedora-rawhide/man8/systemd-sysctl.service.8 b/upstream/fedora-rawhide/man8/systemd-sysctl.service.8 index 35eeee7c..c039400a 100644 --- a/upstream/fedora-rawhide/man8/systemd-sysctl.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-sysctl.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSCTL\&.SERVICE" "8" "" "systemd 255" "systemd-sysctl.service" +.TH "SYSTEMD\-SYSCTL\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-sysctl.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -179,6 +179,4 @@ See for various ways to directly apply sysctl settings\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsysctl.d\fR(5), -\fBsysctl\fR(8) +\fBsystemd\fR(1), \fBsysctl.d\fR(5), \fBsysctl\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-sysext.8 b/upstream/fedora-rawhide/man8/systemd-sysext.8 index 949afe88..f60d4cae 100644 --- a/upstream/fedora-rawhide/man8/systemd-sysext.8 +++ b/upstream/fedora-rawhide/man8/systemd-sysext.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSEXT" "8" "" "systemd 255" "systemd-sysext" +.TH "SYSTEMD\-SYSEXT" "8" "" "systemd 256~rc3" "systemd-sysext" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -25,15 +25,11 @@ systemd-sysext, systemd-sysext.service, systemd-confext, systemd-confext.service .HP \w'\fBsystemd\-sysext\fR\ 'u \fBsystemd\-sysext\fR [OPTIONS...] COMMAND .PP -.nf systemd\-sysext\&.service -.fi .HP \w'\fBsystemd\-confext\fR\ 'u \fBsystemd\-confext\fR [OPTIONS...] COMMAND .PP -.nf systemd\-confext\&.service -.fi .SH "DESCRIPTION" .PP \fBsystemd\-sysext\fR @@ -77,11 +73,13 @@ included in a system extension image will \fInot\fR appear in the respective hierarchies after activation\&. .PP -System extension images are strictly read\-only, and the host +System extension images are strictly read\-only by default\&. On mutable host file systems, /usr/ and /opt/ -hierarchies become read\-only too while they are activated\&. +hierarchies become read\-only while extensions are merged, unless mutability is enabled\&. Mutability may be enabled via the +\fB\-\-mutable=\fR +option; see "Mutability" below for more information\&. .PP System extensions are supposed to be purely additive, i\&.e\&. they are supposed to include only files that do not exist in the underlying basic OS image\&. However, the underlying mechanism (overlayfs) also allows overlaying or removing files, but it is recommended not to make use of this\&. .PP @@ -189,7 +187,7 @@ but the used architecture identifiers are the same as for described in \fBsystemd.unit\fR(5)\&. \fIEXTENSION_RELOAD_MANAGER=\fR -can be set to 1 if the extension requires a service manager reload after application of the extension\&. Note that the for the reasons mentioned earlier: +can be set to 1 if the extension requires a service manager reload after application of the extension\&. Note that for the reasons mentioned earlier: \m[blue]\fBPortable Services\fR\m[]\&\s-2\u[2]\d\s+2 remain the recommended way to ship system services\&. System extensions should not ship a /usr/lib/os\-release @@ -221,6 +219,12 @@ and (if not disabled via \fB\-\-noexec=false\fR) "noexec"\&. .PP +Just like sysexts, confexts are strictly read\-only by default\&. Merging confexts on mutable host file systems will result in +/etc/ +becoming read\-only\&. As with sysexts, mutability can be enabled via the +\fB\-\-mutable=\fR +option\&. Refer to "Mutability" below for more information\&. +.PP Confexts are looked for in the directories /run/confexts/, /var/lib/confexts/, @@ -254,7 +258,143 @@ as if it was installed in the OS image itself\&.) This case works regardless if /usr/ is managed as immutable disk image or is a traditional package manager controlled (i\&.e\&. writable) tree\&. .PP -For the confext case, the OSConfig project aims to perform runtime reconfiguration of OS services\&. Sometimes, there is a need to swap certain configuration parameter values or restart only a specific service without deployment of new code or a complete OS deployment\&. In other words, we want to be able to tie the most frequently configured options to runtime updateable flags that can be changed without a system reboot\&. This will help reduce servicing times when there is a need for changing the OS configuration\&. +With systemd\-confext one can perform runtime reconfiguration of OS services\&. Sometimes, there is a need to swap certain configuration parameter values or restart only a specific service without deployment of new code or a complete OS deployment\&. In other words, we want to be able to tie the most frequently configured options to runtime updateable flags that can be changed without a system reboot\&. This will help reduce servicing times when there is a need for changing the OS configuration\&. It also provides a reliable tool for managing configuration because all old configuration files disappear when the systemd\-confext image is removed\&. +.SH "MUTABILITY" +.PP +By default, merging system extensions on mutable host file systems will render +/usr/ +and +/opt/ +hierarchies read\-only\&. Merging configuration extensions will have the same effect on +/etc/\&. Mutable mode allows writes to these locations when extensions are merged\&. +.PP +The following modes are supported: +.sp +.RS 4 +.ie n \{\ +\h'-04' 1.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 1." 4.2 +.\} +\fBdisabled\fR: Force immutable mode even if write routing directories exist below +/var/lib/extensions\&.mutable/\&. This is the default\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 2.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 2." 4.2 +.\} +\fBauto\fR: Automatic mode\&. Mutability is disabled by default and only enabled if a corresponding write routing directory exists below +/var/lib/extensions\&.mutable/\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 3.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 3." 4.2 +.\} +\fBenabled\fR: Force mutable mode and automatically create write routing directories below +/var/lib/extensions\&.mutable/ +when required\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 4.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 4." 4.2 +.\} +\fBimport\fR: Force immutable mode like +\fBdisabled\fR +above, but merge the contents of directories below +/var/lib/extensions\&.mutable/ +into the host file system\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 5.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 5." 4.2 +.\} +\fBephemeral\fR: Force mutable mode like +\fBenabled\fR +above, but instead of using write routing directory below +/var/lib/extensions\&.mutable/, +\fBsystemd\-sysext\fR +will use empty ephemeral directories\&. This means that the modifications made in the merged hierarchies will be gone when the hierarchies are unmerged\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 6.\h'+01'\c +.\} +.el \{\ +.sp -1 +.IP " 6." 4.2 +.\} +\fBephemeral\-import\fR: Force mutable mode like +\fBephemeral\fR +above, but instead of ignoring the contents of write routing directories under +/var/lib/extensions\&.mutable/, merge them into the host file system, like +\fBimport\fR +does\&. +.RE +.sp +See "Options" below on specifying modes using the +\fB\-\-mutable=\fR +command line option\&. +.PP +With exception of the ephemeral mode, the mutable mode routes writes to subdirectories in +/var/lib/extensions\&.mutable/\&. +.RS 4 +Writes to /usr/ are directed to /var/lib/extensions\&.mutable/usr/ +.RE +.RS 4 +writes to /opt/ are directed to /var/lib/extensions\&.mutable/opt/, and +.RE +.RS 4 +writes to /etc/ land in /var/lib/extensions\&.mutable/etc/\&. +.RE +.PP +If +usr/, +opt/, or +etc/ +in +/var/lib/extensions\&.mutable/ +are symlinks, then writes are directed to the symlinks\*(Aq targets\&. Consequently, to retain mutability of a host file system, create symlinks +.RS 4 +/var/lib/extensions\&.mutable/etc/ → /etc/ +.RE +.RS 4 +/var/lib/extensions\&.mutable/usr/ → /usr/ +.RE +.RS 4 +/var/lib/extensions\&.mutable/opt/ → /opt/ +.RE +to route writes back to the original base directory hierarchy\&. +.PP +Alternatively, a temporary file system may be mounted to +/var/lib/extensions\&.mutable/, or symlinks in +/var/lib/extensions\&.mutable/ +may point to sub\-directories on a temporary file system (e\&.g\&. below +/tmp/) to only allow ephemeral changes\&. Note that this is not the same as ephemeral mode, because the temporary file system will still exist after unmerging\&. +.PP +Added in version 256\&. .SH "COMMANDS" .PP The following commands are understood by both the sysext and confext concepts: @@ -386,7 +526,69 @@ directory a slightly stricter policy is used by default: Added in version 254\&. .RE .PP -\fB\-\-noexec=\fR\fIBOOL\fR +\fB\-\-mutable=\fR\fB\fIBOOL\fR\fR\fB|\fR\fB\fIauto\fR\fR\fB|\fR\fB\fIimport\fR\fR +.RS 4 +Set mutable mode\&. +.PP +\fBno\fR +.RS 4 +force immutable mode even with write routing directories present\&. This is the default\&. +.sp +Added in version 256\&. +.RE +.PP +\fBauto\fR +.RS 4 +enable mutable mode individually for +/usr/, +/opt/, and +/etc/ +if write routing sub\-directories or symlinks are present in +/var/lib/extensions\&.mutable/; disable otherwise\&. See "Mutability" above for more information on write routing\&. +.sp +Added in version 256\&. +.RE +.PP +\fByes\fR +.RS 4 +force mutable mode\&. Write routing directories will be created in +/var/lib/extensions\&.mutable/ +if not present\&. +.sp +Added in version 256\&. +.RE +.PP +\fBimport\fR +.RS 4 +immutable mode, but with contents of write routing directories in +/var/lib/extensions\&.mutable/ +also merged into the host file system\&. +.sp +Added in version 256\&. +.RE +.PP +\fBephemeral\fR +.RS 4 +force mutable mode, but with contents of write routing directories in +/var/lib/extensions\&.mutable/ +being ignored, and modifications of the host file system being discarded after unmerge\&. +.sp +Added in version 256\&. +.RE +.PP +\fBephemeral\-import\fR +.RS 4 +force mutable mode, with contents of write routing directories in +/var/lib/extensions\&.mutable/ +being merged into the host file system, but with the modifications made to the host file system being discarded after unmerge\&. +.sp +Added in version 256\&. +.RE +.sp +Added in version 256\&. +.RE +.PP +\fB\-\-noexec=\fR\fB\fIBOOL\fR\fR .RS 4 When merging configuration extensions into /etc/ @@ -420,7 +622,7 @@ Do not pipe output into a pager\&. Do not print the legend, i\&.e\&. column headers and the footer with hints\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Shows output formatted as JSON\&. Expects one of "short" @@ -435,9 +637,7 @@ Shows output formatted as JSON\&. Expects one of On success, 0 is returned\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-nspawn\fR(1), -\fBsystemd-stub\fR(7) +\fBsystemd\fR(1), \fBsystemd-nspawn\fR(1), \fBsystemd-stub\fR(7), \fBimportctl\fR(1) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man8/systemd-system-update-generator.8 b/upstream/fedora-rawhide/man8/systemd-system-update-generator.8 index 47e3b738..99cbbdb9 100644 --- a/upstream/fedora-rawhide/man8/systemd-system-update-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-system-update-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSTEM\-UPDATE\-GENERATOR" "8" "" "systemd 255" "systemd-system-update-generator" +.TH "SYSTEMD\-SYSTEM\-UPDATE\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-system-update-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -40,5 +40,4 @@ implements \fBsystemd.generator\fR(7)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.special\fR(7) +\fBsystemd\fR(1), \fBsystemd.special\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-sysupdate.8 b/upstream/fedora-rawhide/man8/systemd-sysupdate.8 index 99d876fa..c8a12e09 100644 --- a/upstream/fedora-rawhide/man8/systemd-sysupdate.8 +++ b/upstream/fedora-rawhide/man8/systemd-sysupdate.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSUPDATE" "8" "" "systemd 255" "systemd-sysupdate" +.TH "SYSTEMD\-SYSUPDATE" "8" "" "systemd 256~rc3" "systemd-sysupdate" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -272,7 +272,7 @@ Do not pipe output into a pager\&. Do not print the legend, i\&.e\&. column headers and the footer with hints\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Shows output formatted as JSON\&. Expects one of "short" @@ -287,6 +287,4 @@ Shows output formatted as JSON\&. Expects one of On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsysupdate.d\fR(5), -\fBsystemd-repart\fR(8) +\fBsystemd\fR(1), \fBsysupdate.d\fR(5), \fBsystemd-repart\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-sysusers.8 b/upstream/fedora-rawhide/man8/systemd-sysusers.8 index 5d5726a1..f8858843 100644 --- a/upstream/fedora-rawhide/man8/systemd-sysusers.8 +++ b/upstream/fedora-rawhide/man8/systemd-sysusers.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSUSERS" "8" "" "systemd 255" "systemd-sysusers" +.TH "SYSTEMD\-SYSUSERS" "8" "" "systemd 256~rc3" "systemd-sysusers" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -32,15 +32,13 @@ systemd\-sysusers\&.service creates system users and groups, based on files in the format described in \fBsysusers.d\fR(5)\&. .PP -If invoked with no arguments, it applies all directives from all files found in the directories specified by +If invoked with no arguments, directives from the configuration files found in the directories specified by \fBsysusers.d\fR(5)\&. When invoked with positional arguments, if option \fB\-\-replace=\fR\fB\fIPATH\fR\fR is specified, arguments specified on the command line are used instead of the configuration file -\fIPATH\fR\&. Otherwise, just the configuration specified by the command line arguments is executed\&. The string +\fIPATH\fR\&. Otherwise, just the configuration specified by the command line arguments is executed\&. If the string "\-" -may be specified instead of a filename to instruct -\fBsystemd\-sysusers\fR -to read the configuration from standard input\&. If the argument is a relative path, all configuration directories are searched for a matching file and the file found that has the highest priority is executed\&. If the argument is an absolute path, that file is used directly without searching of the configuration directories\&. +is specified instead of a filename, the configuration is read from standard input\&. If the argument is a file name (without any slashes), all configuration directories are searched for a matching file and the file found that has the highest priority is executed\&. If the argument is a path, that file is used directly without searching the configuration directories for any other matching file\&. .SH "OPTIONS" .PP The following options are understood: @@ -152,7 +150,7 @@ Print a short version string and exit\&. supports the service credentials logic as implemented by \fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR (see -\fBsystemd.exec\fR(1) +\fBsystemd.exec\fR(5) for details)\&. The following credentials are used when passed in: .PP \fIpasswd\&.hashed\-password\&.\fR\fI\fIuser\fR\fR @@ -225,11 +223,7 @@ for generating UNIX password hashes from the command line\&. On success, 0 is returned, a non\-zero failure code otherwise\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsysusers.d\fR(5), -\m[blue]\fBUsers, Groups, UIDs and GIDs on systemd systems\fR\m[]\&\s-2\u[2]\d\s+2, -\fBsystemd.exec\fR(1), -\fBmkpasswd\fR(1) +\fBsystemd\fR(1), \fBsysusers.d\fR(5), \m[blue]\fBUsers, Groups, UIDs and GIDs on systemd systems\fR\m[]\&\s-2\u[2]\d\s+2, \fBsystemd.exec\fR(5), \fBmkpasswd\fR(1) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man8/systemd-sysv-generator.8 b/upstream/fedora-rawhide/man8/systemd-sysv-generator.8 index 80b51288..198a8a19 100644 --- a/upstream/fedora-rawhide/man8/systemd-sysv-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-sysv-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-SYSV\-GENERATOR" "8" "" "systemd 255" "systemd-sysv-generator" +.TH "SYSTEMD\-SYSV\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-sysv-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -62,9 +62,7 @@ implements \fBsystemd.generator\fR(7)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.service\fR(5), -\fBsystemd.target\fR(5) +\fBsystemd\fR(1), \fBsystemd.service\fR(5), \fBsystemd.target\fR(5) .SH "NOTES" .IP " 1." 4 System V init diff --git a/upstream/fedora-rawhide/man8/systemd-time-wait-sync.service.8 b/upstream/fedora-rawhide/man8/systemd-time-wait-sync.service.8 index d6849abe..1f7653e3 100644 --- a/upstream/fedora-rawhide/man8/systemd-time-wait-sync.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-time-wait-sync.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-TIME\-WAIT\-SYNC\&.SERVICE" "8" "" "systemd 255" "systemd-time-wait-sync.service" +.TH "SYSTEMD\-TIME\-WAIT\-SYNC\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-time-wait-sync.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -52,6 +52,4 @@ Added in version 239\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.special\fR(7), -\fBsystemd-timesyncd.service\fR(8), +\fBsystemd\fR(1), \fBsystemd.special\fR(7), \fBsystemd-timesyncd.service\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-timedated.service.8 b/upstream/fedora-rawhide/man8/systemd-timedated.service.8 index a221cf9e..59bf9310 100644 --- a/upstream/fedora-rawhide/man8/systemd-timedated.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-timedated.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-TIMEDATED\&.SERVICE" "8" "" "systemd 255" "systemd-timedated.service" +.TH "SYSTEMD\-TIMEDATED\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-timedated.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -91,7 +91,7 @@ and for information about the D\-Bus API\&. .SH "LIST OF NETWORK TIME SYNCHRONIZATION SERVICES" .PP -\fBsystemd\-timesyncd\fR +\fBsystemd\-timedated\fR will look for files with a "\&.list" extension in @@ -131,7 +131,7 @@ systemd\-timesyncd\&.service If the environment variable \fI$SYSTEMD_TIMEDATED_NTP_SERVICES\fR is set, -\fBsystemd\-timesyncd\fR +\fBsystemd\-timedated\fR will parse the contents of that variable as a colon\-separated list of unit names\&. When set, this variable overrides the file\-based list described above\&. .PP \fBExample\ \&2.\ \&An override that specifies that chronyd should be used if available\fR @@ -147,8 +147,4 @@ SYSTEMD_TIMEDATED_NTP_SERVICES=chronyd\&.service:systemd\-timesyncd\&.service .\} .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBtimedatectl\fR(1), -\fBlocaltime\fR(5), -\fBhwclock\fR(8), -\fBsystemd-timesyncd\fR(8) +\fBsystemd\fR(1), \fBtimedatectl\fR(1), \fBlocaltime\fR(5), \fBhwclock\fR(8), \fBsystemd-timesyncd\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-timesyncd.service.8 b/upstream/fedora-rawhide/man8/systemd-timesyncd.service.8 index 96ec2c88..fcce657b 100644 --- a/upstream/fedora-rawhide/man8/systemd-timesyncd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-timesyncd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-TIMESYNCD\&.SERVICE" "8" "" "systemd 255" "systemd-timesyncd.service" +.TH "SYSTEMD\-TIMESYNCD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-timesyncd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -100,12 +100,4 @@ Added in version 239\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBtimesyncd.conf\fR(5), -\fBsystemd.network\fR(5), -\fBsystemd-networkd.service\fR(8), -\fBsystemd-time-wait-sync.service\fR(8), -\fBsystemd.special\fR(7), -\fBtimedatectl\fR(1), -\fBlocaltime\fR(5), -\fBhwclock\fR(8) +\fBsystemd\fR(1), \fBtimesyncd.conf\fR(5), \fBsystemd.network\fR(5), \fBsystemd-networkd.service\fR(8), \fBsystemd-time-wait-sync.service\fR(8), \fBsystemd.special\fR(7), \fBtimedatectl\fR(1), \fBlocaltime\fR(5), \fBhwclock\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-tmpfiles.8 b/upstream/fedora-rawhide/man8/systemd-tmpfiles.8 index cc6228af..c4302e94 100644 --- a/upstream/fedora-rawhide/man8/systemd-tmpfiles.8 +++ b/upstream/fedora-rawhide/man8/systemd-tmpfiles.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-TMPFILES" "8" "" "systemd 255" "systemd-tmpfiles" +.TH "SYSTEMD\-TMPFILES" "8" "" "systemd 256~rc3" "systemd-tmpfiles" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -20,44 +20,54 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" -systemd-tmpfiles, systemd-tmpfiles-setup.service, systemd-tmpfiles-setup-dev-early.service, systemd-tmpfiles-setup-dev.service, systemd-tmpfiles-clean.service, systemd-tmpfiles-clean.timer \- Creates, deletes and cleans up volatile and temporary files and directories +systemd-tmpfiles, systemd-tmpfiles-setup.service, systemd-tmpfiles-setup-dev-early.service, systemd-tmpfiles-setup-dev.service, systemd-tmpfiles-clean.service, systemd-tmpfiles-clean.timer \- Create, delete, and clean up files and directories .SH "SYNOPSIS" .HP \w'\fBsystemd\-tmpfiles\fR\ 'u \fBsystemd\-tmpfiles\fR [OPTIONS...] [\fICONFIGFILE\fR...] .PP System units: -.sp -.nf +.RS 4 systemd\-tmpfiles\-setup\&.service +.RE +.RS 4 systemd\-tmpfiles\-setup\-dev\-early\&.service +.RE +.RS 4 systemd\-tmpfiles\-setup\-dev\&.service +.RE +.RS 4 systemd\-tmpfiles\-clean\&.service +.RE +.RS 4 systemd\-tmpfiles\-clean\&.timer -.fi +.RE .PP User units: -.sp -.nf +.RS 4 systemd\-tmpfiles\-setup\&.service +.RE +.RS 4 systemd\-tmpfiles\-clean\&.service +.RE +.RS 4 systemd\-tmpfiles\-clean\&.timer -.fi +.RE .SH "DESCRIPTION" .PP \fBsystemd\-tmpfiles\fR creates, deletes, and cleans up volatile and temporary files and directories, using the configuration file format and location specified in -\fBtmpfiles.d\fR(5)\&. It must be invoked with one or more options +\fBtmpfiles.d\fR(5)\&. It must be invoked with one or more commands \fB\-\-create\fR, \fB\-\-remove\fR, and \fB\-\-clean\fR, to select the respective subset of operations\&. .PP -By default, directives from all configuration files are applied\&. When invoked with -\fB\-\-replace=\fR\fB\fIPATH\fR\fR, arguments specified on the command line are used instead of the configuration file -\fIPATH\fR\&. Otherwise, if one or more absolute filenames are passed on the command line, only the directives in these files are applied\&. If +If invoked with no arguments, directives from the configuration files found in the directories specified by +\fBtmpfiles.d\fR(5)\&. When invoked with positional arguments, if option +\fB\-\-replace=\fR\fB\fIPATH\fR\fR +is specified, arguments specified on the command line are used instead of the configuration file +\fIPATH\fR\&. Otherwise, just the configuration specified by the command line arguments is executed\&. If the string "\-" -is specified instead of a filename, directives are read from standard input\&. If only the basename of a configuration file is specified, all configuration directories as specified in -\fBtmpfiles.d\fR(5) -are searched for a matching file and the file found that has the highest priority is executed\&. +is specified instead of a filename, the configuration is read from standard input\&. If the argument is a file name (without any slashes), all configuration directories are searched for a matching file and the file found that has the highest priority is executed\&. If the argument is a path, that file is used directly without searching the configuration directories for any other matching file\&. .PP System services (systemd\-tmpfiles\-setup\&.service, systemd\-tmpfiles\-setup\-dev\-early\&.service, @@ -81,13 +91,13 @@ systemd\-tmpfiles\-clean\&.service, which will apply any settings which can be s \fBsystemd\-tmpfiles\fR, it may be useful to invoke it directly from the command line with increased log level (see \fI$SYSTEMD_LOG_LEVEL\fR below)\&. -.SH "OPTIONS" +.SH "COMMANDS AND OPTIONS" .PP -The following options are understood: +The following commands are understood: .PP \fB\-\-create\fR .RS 4 -If this option is passed, all files and directories marked with +If this command is passed, all files and directories marked with \fIf\fR, \fIF\fR, \fIw\fR, @@ -111,12 +121,12 @@ have their ownership, access mode and security labels set\&. .PP \fB\-\-clean\fR .RS 4 -If this option is passed, all files and directories with an age parameter configured will be cleaned up\&. +If this command is passed, all files and directories with an age parameter configured will be cleaned up\&. .RE .PP \fB\-\-remove\fR .RS 4 -If this option is passed, the contents of directories marked with +If this command is passed, the contents of directories marked with \fID\fR or \fIR\fR, and files or directories themselves marked with @@ -127,6 +137,15 @@ are removed unless an exclusive or shared BSD lock is taken on them (see \fBflock\fR(2))\&. .RE .PP +\fB\-\-purge\fR +.RS 4 +If this option is passed, all files and directories created by a +tmpfiles\&.d/ +entry will be deleted\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-\-user\fR .RS 4 Execute "user" configuration, i\&.e\&. @@ -155,6 +174,13 @@ Ignore configuration lines pertaining to unknown users or groups\&. This option Added in version 254\&. .RE .PP +\fB\-\-dry\-run\fR +.RS 4 +Process the configuration and print what operations would be performed, but don\*(Aqt actually change anything in the file system\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-\-prefix=\fR\fB\fIpath\fR\fR .RS 4 Only apply rules with paths that start with the specified prefix\&. This option can be specified multiple times\&. @@ -299,7 +325,7 @@ credential from the service manager\&. .PP \fI$SYSTEMD_LOG_LEVEL\fR .RS 4 -The maximum log level of emitted messages (messages with a higher log level, i\&.e\&. less important ones, will be suppressed)\&. Either one of (in order of decreasing importance) +The maximum log level of emitted messages (messages with a higher log level, i\&.e\&. less important ones, will be suppressed)\&. Takes a comma\-separated list of values\&. A value may be either one of (in order of decreasing importance) \fBemerg\fR, \fBalert\fR, \fBcrit\fR, @@ -309,7 +335,15 @@ The maximum log level of emitted messages (messages with a higher log level, i\& \fBinfo\fR, \fBdebug\fR, or an integer in the range 0\&...7\&. See \fBsyslog\fR(3) -for more information\&. +for more information\&. Each value may optionally be prefixed with one of +\fBconsole\fR, +\fBsyslog\fR, +\fBkmsg\fR +or +\fBjournal\fR +followed by a colon to set the maximum log level for that specific log target (e\&.g\&. +\fBSYSTEMD_LOG_LEVEL=debug,console:info\fR +specifies to log at debug level except when logging to the console which should be at info level)\&. Note that the global maximum log level takes priority over any per target maximum log levels\&. .RE .PP \fI$SYSTEMD_LOG_COLOR\fR @@ -415,6 +449,12 @@ will be ignored by the executable, and needs to be handled by the pager\&. This option instructs the pager to not send termcap initialization and deinitialization strings to the terminal\&. It is set by default to allow command output to remain visible in the terminal even after the pager exits\&. Nevertheless, this prevents some pager functionality from working, in particular paged output cannot be scrolled with the mouse\&. .RE .sp +Note that setting the regular +\fI$LESS\fR +environment variable has no effect for +\fBless\fR +invocations by systemd tools\&. +.sp See \fBless\fR(1) for more discussion\&. @@ -426,6 +466,12 @@ Override the charset passed to \fBless\fR (by default "utf\-8", if the invoking terminal is determined to be UTF\-8 compatible)\&. +.sp +Note that setting the regular +\fI$LESSCHARSET\fR +environment variable has no effect for +\fBless\fR +invocations by systemd tools\&. .RE .PP \fI$SYSTEMD_PAGERSECURE\fR @@ -507,8 +553,7 @@ Note: when creating items, if the target already exists, but is of the wrong typ "+", a message is emitted, but the failure is otherwise ignored\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBtmpfiles.d\fR(5) +\fBsystemd\fR(1), \fBtmpfiles.d\fR(5) .SH "NOTES" .IP " 1." 4 Discoverable Partitions Specification diff --git a/upstream/fedora-rawhide/man8/systemd-tpm2-generator.8 b/upstream/fedora-rawhide/man8/systemd-tpm2-generator.8 new file mode 100644 index 00000000..c7b522fe --- /dev/null +++ b/upstream/fedora-rawhide/man8/systemd-tpm2-generator.8 @@ -0,0 +1,53 @@ +'\" t +.TH "SYSTEMD\-TPM2\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-tpm2-generator" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +systemd-tpm2-generator \- Generator for inserting TPM2 synchronization point in the boot process +.SH "SYNOPSIS" +.PP +/usr/lib/systemd/system\-generators/systemd\-tpm2\-generator +.SH "DESCRIPTION" +.PP +systemd\-tpm2\-generator +is a generator that adds a +\fIWants=\fR +dependency from +sysinit\&.target +to +tpm2\&.target +when it detects that the firmware discovered a TPM2 device but the OS kernel so far did not\&. +tpm2\&.target +is supposed to act as synchronization point for all services that require TPM2 device access\&. See +\fBsystemd.special\fR(7) +for details\&. +.PP +The +\fBsystemd\&.tpm2_wait=\fR +kernel command line option may be used to override behaviour of the generator\&. It accepts a boolean value: if true then +tpm2\&.target +will be added as synchronization point even if the firmware has not detected a TPM2 device\&. If false, the target will not be inserted even if firmware reported a device but the OS kernel doesn\*(Aqt expose a device for it yet\&. The latter might be useful in environments where a suitable TPM2 driver for the available hardware is not available\&. +.PP +systemd\-tpm2\-generator +implements +\fBsystemd.generator\fR(7)\&. +.SH "SEE ALSO" +.PP +\fBsystemd\fR(1), \fBsystemd.special\fR(7), \fBkernel-command-line\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-tpm2-setup.service.8 b/upstream/fedora-rawhide/man8/systemd-tpm2-setup.service.8 index bccb5479..4a302641 100644 --- a/upstream/fedora-rawhide/man8/systemd-tpm2-setup.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-tpm2-setup.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-TPM2\-SETUP\&.SERVICE" "8" "" "systemd 255" "systemd-tpm2-setup.service" +.TH "SYSTEMD\-TPM2\-SETUP\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-tpm2-setup.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -36,7 +36,7 @@ are services that generate the Storage Root Key (SRK) if it hasn\*(Aqt been gene The services will store the public key of the SRK key pair in a PEM file in /run/systemd/tpm2\-srk\-public\-key\&.pem and -/var/lib/systemd/tpm2\-srk\-public\-key\&.pem\&. It will also store it in TPM2B_PUBLIC format in +/var/lib/systemd/tpm2\-srk\-public\-key\&.pem\&. They will also store it in TPM2B_PUBLIC format in /run/systemd/tpm2\-srk\-public\-key\&.tpm2_public and /var/lib/systemd/tpm2\-srk\-public\-key\&.tpm2b_public\&. diff --git a/upstream/fedora-rawhide/man8/systemd-udev-settle.service.8 b/upstream/fedora-rawhide/man8/systemd-udev-settle.service.8 index d045f09e..e22bd6a0 100644 --- a/upstream/fedora-rawhide/man8/systemd-udev-settle.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-udev-settle.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-UDEV\-SETTLE\&.SERVICE" "8" "" "systemd 255" "systemd-udev-settle.service" +.TH "SYSTEMD\-UDEV\-SETTLE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-udev-settle.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -38,5 +38,4 @@ systemd\-udev\-settle\&.service usually slows boot significantly, because it means waiting for all unrelated events too\&. .SH "SEE ALSO" .PP -\fBudev\fR(7), -\fBudevadm\fR(8) +\fBudev\fR(7), \fBudevadm\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-udevd.service.8 b/upstream/fedora-rawhide/man8/systemd-udevd.service.8 index 5ca6437b..d0216520 100644 --- a/upstream/fedora-rawhide/man8/systemd-udevd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-udevd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-UDEVD\&.SERVICE" "8" "" "systemd 255" "systemd-udevd.service" +.TH "SYSTEMD\-UDEVD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-udevd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -176,7 +176,7 @@ Network interfaces are renamed to give them predictable names when possible\&. I Added in version 199\&. .RE .PP -\fInet\&.naming\-scheme=\fR +\fInet\&.naming_scheme=\fR .RS 4 Network interfaces are renamed to give them predictable names when possible (unless \fInet\&.ifnames=0\fR @@ -193,7 +193,7 @@ is checking might appear, which affects older name derivation algorithms, too\&. Added in version 240\&. .RE .PP -\fInet\&.ifname\-policy=\fR\fI\fIpolicy1\fR\fR\fI[,\fR\fI\fIpolicy2\fR\fR\fI,\&...][,\fR\fI\fIMAC\fR\fR\fI]\fR +\fInet\&.ifname_policy=\fR\fI\fIpolicy1\fR\fR\fI[,\fR\fI\fIpolicy2\fR\fR\fI,\&...][,\fR\fI\fIMAC\fR\fR\fI]\fR .RS 4 Specifies naming policies applied when renaming network interfaces\&. Takes a list of policies and an optional MAC address separated with comma\&. Each policy value must be one of the policies understood by the \fINamePolicy=\fR @@ -216,8 +216,8 @@ Example: .RS 4 .\} .nf -net\&.ifname\-policy=keep,kernel,path,slot,onboard,01:23:45:67:89:ab -net\&.ifname\-policy=keep,kernel,path,slot,onboard,mac +net\&.ifname_policy=keep,kernel,path,slot,onboard,01:23:45:67:89:ab +net\&.ifname_policy=keep,kernel,path,slot,onboard,mac .fi .if n \{\ .RE @@ -263,6 +263,4 @@ Added in version 250\&. .RE .SH "SEE ALSO" .PP -\fBudev.conf\fR(5), -\fBudev\fR(7), -\fBudevadm\fR(8) +\fBudev.conf\fR(5), \fBudev\fR(7), \fBudevadm\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-update-done.service.8 b/upstream/fedora-rawhide/man8/systemd-update-done.service.8 index 22332dc8..84becd01 100644 --- a/upstream/fedora-rawhide/man8/systemd-update-done.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-update-done.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-UPDATE\-DONE\&.SERVICE" "8" "" "systemd 255" "systemd-update-done.service" +.TH "SYSTEMD\-UPDATE\-DONE\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-update-done.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -68,7 +68,7 @@ are always followed by an update of the modification time of on it\&. .PP Note that if the -\fIsystemd\&.condition\-needs\-update=\fR +\fIsystemd\&.condition_needs_update=\fR kernel command line option is used it overrides the \fIConditionNeedsUpdate=\fR unit condition checks\&. In that case @@ -76,6 +76,4 @@ systemd\-update\-done\&.service will not reset the condition state until a follow\-up reboot where the kernel switch is not specified anymore\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.unit\fR(5), -\fBtouch\fR(1) +\fBsystemd\fR(1), \fBsystemd.unit\fR(5), \fBtouch\fR(1) diff --git a/upstream/fedora-rawhide/man8/systemd-update-utmp.service.8 b/upstream/fedora-rawhide/man8/systemd-update-utmp.service.8 index b7c6e013..32babd63 100644 --- a/upstream/fedora-rawhide/man8/systemd-update-utmp.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-update-utmp.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-UPDATE\-UTMP\&.SERVICE" "8" "" "systemd 255" "systemd-update-utmp.service" +.TH "SYSTEMD\-UPDATE\-UTMP\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-update-utmp.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -36,6 +36,4 @@ systemd\-update\-utmp\&.service does the same for system reboots and shutdown requests\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fButmp\fR(5), -\fBauditd\fR(8) +\fBsystemd\fR(1), \fButmp\fR(5), \fBauditd\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-user-sessions.service.8 b/upstream/fedora-rawhide/man8/systemd-user-sessions.service.8 index c6be118b..eb24a0f7 100644 --- a/upstream/fedora-rawhide/man8/systemd-user-sessions.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-user-sessions.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-USER\-SESSIONS\&.SERVICE" "8" "" "systemd 255" "systemd-user-sessions.service" +.TH "SYSTEMD\-USER\-SESSIONS\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-user-sessions.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -35,6 +35,4 @@ is a service that controls user logins through /run/nologin, thus prohibiting further logins\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-logind.service\fR(8), -\fBpam_nologin\fR(8) +\fBsystemd\fR(1), \fBsystemd-logind.service\fR(8), \fBpam_nologin\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-userdbd.service.8 b/upstream/fedora-rawhide/man8/systemd-userdbd.service.8 index 62831c5d..af9109e6 100644 --- a/upstream/fedora-rawhide/man8/systemd-userdbd.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-userdbd.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-USERDBD\&.SERVICE" "8" "" "systemd 255" "systemd-userdbd.service" +.TH "SYSTEMD\-USERDBD\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-userdbd.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -68,10 +68,7 @@ to JSON user/group records, thus hiding the differences between the services as makes JSON user/group records from the aforementioned drop\-in directories available\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBnss-systemd\fR(8), -\fBuserdbctl\fR(1), -\fBsystemd-homed.service\fR(8) +\fBsystemd\fR(1), \fBnss-systemd\fR(8), \fBuserdbctl\fR(1), \fBsystemd-homed.service\fR(8) .SH "NOTES" .IP " 1." 4 JSON User Records diff --git a/upstream/fedora-rawhide/man8/systemd-vconsole-setup.service.8 b/upstream/fedora-rawhide/man8/systemd-vconsole-setup.service.8 index 46a2f5bc..f835126a 100644 --- a/upstream/fedora-rawhide/man8/systemd-vconsole-setup.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-vconsole-setup.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-VCONSOLE\-SETUP\&.SERVICE" "8" "" "systemd 255" "systemd-vconsole-setup.service" +.TH "SYSTEMD\-VCONSOLE\-SETUP\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-vconsole-setup.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -92,8 +92,4 @@ Added in version 253\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBvconsole.conf\fR(5), -\fBloadkeys\fR(1), -\fBsetfont\fR(8), -\fBsystemd-localed.service\fR(8) +\fBsystemd\fR(1), \fBvconsole.conf\fR(5), \fBloadkeys\fR(1), \fBsetfont\fR(8), \fBsystemd-localed.service\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-veritysetup-generator.8 b/upstream/fedora-rawhide/man8/systemd-veritysetup-generator.8 index 7f3c0453..b5df221f 100644 --- a/upstream/fedora-rawhide/man8/systemd-veritysetup-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-veritysetup-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-VERITYSETUP\-GENERATOR" "8" "" "systemd 255" "systemd-veritysetup-generator" +.TH "SYSTEMD\-VERITYSETUP\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-veritysetup-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -113,7 +113,4 @@ Added in version 250\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-veritysetup@.service\fR(8), -\fBveritysetup\fR(8), -\fBsystemd-fstab-generator\fR(8) +\fBsystemd\fR(1), \fBsystemd-veritysetup@.service\fR(8), \fBveritysetup\fR(8), \fBsystemd-fstab-generator\fR(8) diff --git a/upstream/fedora-rawhide/man8/systemd-veritysetup@.service.8 b/upstream/fedora-rawhide/man8/systemd-veritysetup@.service.8 index f12ba36f..47410e5f 100644 --- a/upstream/fedora-rawhide/man8/systemd-veritysetup@.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-veritysetup@.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-VERITYSETUP@\&.SERVICE" "8" "" "systemd 255" "systemd-veritysetup@.service" +.TH "SYSTEMD\-VERITYSETUP@\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-veritysetup@.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -78,9 +78,7 @@ Added in version 250\&. .RE .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-veritysetup-generator\fR(8), -\fBveritysetup\fR(8) +\fBsystemd\fR(1), \fBsystemd-veritysetup-generator\fR(8), \fBveritysetup\fR(8) .SH "NOTES" .IP " 1." 4 Kernel dm-verity diff --git a/upstream/fedora-rawhide/man8/systemd-volatile-root.service.8 b/upstream/fedora-rawhide/man8/systemd-volatile-root.service.8 index 4e8c59bc..a13b4ac4 100644 --- a/upstream/fedora-rawhide/man8/systemd-volatile-root.service.8 +++ b/upstream/fedora-rawhide/man8/systemd-volatile-root.service.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-VOLATILE\-ROOT\&.SERVICE" "8" "" "systemd 255" "systemd-volatile-root.service" +.TH "SYSTEMD\-VOLATILE\-ROOT\&.SERVICE" "8" "" "systemd 256~rc3" "systemd-volatile-root.service" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -45,6 +45,4 @@ on the kernel command line\&. This service runs only in the initrd, before the s is used, as in that mode the root directory is non\-volatile\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd-fstab-generator\fR(8), -\fBkernel-command-line\fR(7) +\fBsystemd\fR(1), \fBsystemd-fstab-generator\fR(8), \fBkernel-command-line\fR(7) diff --git a/upstream/fedora-rawhide/man8/systemd-xdg-autostart-generator.8 b/upstream/fedora-rawhide/man8/systemd-xdg-autostart-generator.8 index 4d0787cc..ebc2347f 100644 --- a/upstream/fedora-rawhide/man8/systemd-xdg-autostart-generator.8 +++ b/upstream/fedora-rawhide/man8/systemd-xdg-autostart-generator.8 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-XDG\-AUTOSTART\-GENERATOR" "8" "" "systemd 255" "systemd-xdg-autostart-generator" +.TH "SYSTEMD\-XDG\-AUTOSTART\-GENERATOR" "8" "" "systemd 256~rc3" "systemd-xdg-autostart-generator" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -108,9 +108,7 @@ implements \fBsystemd.generator\fR(7)\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemd.service\fR(5), -\fBsystemd.target\fR(5) +\fBsystemd\fR(1), \fBsystemd.service\fR(5), \fBsystemd.target\fR(5) .SH "NOTES" .IP " 1." 4 XDG autostart diff --git a/upstream/fedora-rawhide/man8/telinit.8 b/upstream/fedora-rawhide/man8/telinit.8 index 750c2242..98b4a670 100644 --- a/upstream/fedora-rawhide/man8/telinit.8 +++ b/upstream/fedora-rawhide/man8/telinit.8 @@ -1,5 +1,5 @@ '\" t -.TH "TELINIT" "8" "" "systemd 255" "telinit" +.TH "TELINIT" "8" "" "systemd 256~rc3" "telinit" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -22,8 +22,8 @@ .SH "NAME" telinit \- Change SysV runlevel .SH "SYNOPSIS" -.HP \w'\fBtelinit\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB{COMMAND}\fR\ 'u -\fBtelinit \fR\fB[OPTIONS...]\fR\fB \fR\fB{COMMAND}\fR +.HP \w'\fBtelinit\fR\ 'u +\fBtelinit\fR [OPTIONS...] {COMMAND} .SH "DESCRIPTION" .PP \fBtelinit\fR @@ -96,6 +96,4 @@ On success, 0 is returned, a non\-zero failure code otherwise\&. This is a legacy command available for compatibility only\&. It should not be used anymore, as the concept of runlevels is obsolete\&. .SH "SEE ALSO" .PP -\fBsystemd\fR(1), -\fBsystemctl\fR(1), -\fBwall\fR(1) +\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBwall\fR(1) diff --git a/upstream/fedora-rawhide/man8/testpkg.8 b/upstream/fedora-rawhide/man8/testpkg.8 new file mode 100644 index 00000000..f92379f8 --- /dev/null +++ b/upstream/fedora-rawhide/man8/testpkg.8 @@ -0,0 +1,173 @@ +'\" t +.\" Title: testpkg +.\" Author: [see the "Authors" section] +.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> +.\" Date: 2024-04-14 +.\" Manual: Pacman Manual +.\" Source: Pacman 6.1.0 +.\" Language: English +.\" +.TH "TESTPKG" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +testpkg \- test a pacman package for validity +.SH "SYNOPSIS" +.sp +\fItestpkg\fR <package file> +.SH "DESCRIPTION" +.sp +\fItestpkg\fR is a script used to make sure that a pacman package is valid\&. +.SH "SEE ALSO" +.sp +\fBpacman\fR(8) +.sp +See the pacman website at https://archlinux\&.org/pacman/ for current information on pacman and its related tools\&. +.SH "BUGS" +.sp +Bugs? You must be kidding; there are no bugs in this software\&. But if we happen to be wrong, submit a bug report with as much detail as possible at the Arch Linux Bug Tracker in the Pacman section\&. +.SH "AUTHORS" +.sp +Current maintainers: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Allan McRae <allan@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Morgan Adamiec <morganamilo@archlinux\&.org> +.RE +.sp +Past major contributors: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Judd Vinet <jvinet@zeroflux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Aurelien Foret <aurelien@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Aaron Griffin <aaron@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Dan McGee <dan@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Xavier Chantry <shiningxc@gmail\&.com> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Dave Reisner <dreisner@archlinux\&.org> +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp +For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/tipc-nametable.8 b/upstream/fedora-rawhide/man8/tipc-nametable.8 index b187d25e..f7c51f19 100644 --- a/upstream/fedora-rawhide/man8/tipc-nametable.8 +++ b/upstream/fedora-rawhide/man8/tipc-nametable.8 @@ -49,13 +49,13 @@ provided by a port. .B Lower .br The lower bound of the 32-bit instance field of the port name. -The instance field is often used as as a sub-class indicator. +The instance field is often used as a sub-class indicator. .TP .B Upper .br The upper bound of the 32-bit instance field of the port name. -The instance field is often used as as a sub-class indicator. +The instance field is often used as a sub-class indicator. A difference in .BR "lower " "and " upper means the socket is bound to the port name range [lower,upper] diff --git a/upstream/fedora-rawhide/man8/tzselect.8 b/upstream/fedora-rawhide/man8/tzselect.8 index 9b9049f7..ee031614 100644 --- a/upstream/fedora-rawhide/man8/tzselect.8 +++ b/upstream/fedora-rawhide/man8/tzselect.8 @@ -36,7 +36,7 @@ The program asks the user for information about the current location, and outputs the resulting timezone to standard output. The output is suitable as a value for the TZ environment variable. -.P +.PP All interaction with the user is done via standard input and standard error. .SH OPTIONS .TP @@ -95,7 +95,7 @@ Output version information and exit. .SH "ENVIRONMENT VARIABLES" .TP \f3AWK\fP -Name of a Posix-compliant +Name of a POSIX-compliant .B awk program (default: .BR awk ). diff --git a/upstream/fedora-rawhide/man8/udevadm.8 b/upstream/fedora-rawhide/man8/udevadm.8 index 234da89e..13c69e52 100644 --- a/upstream/fedora-rawhide/man8/udevadm.8 +++ b/upstream/fedora-rawhide/man8/udevadm.8 @@ -1,5 +1,5 @@ '\" t -.TH "UDEVADM" "8" "" "systemd 255" "udevadm" +.TH "UDEVADM" "8" "" "systemd 256~rc3" "udevadm" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -64,7 +64,7 @@ commands\&. .RS 4 Print a short help text and exit\&. .RE -.SS "udevadm info [\fIoptions\fR] [\fIdevpath\fR|\fIfile\fR|\fIunit\fR...]" +.SS "udevadm info [\fIoptions\fR] [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]" .PP Query the udev database for device information\&. .PP @@ -260,7 +260,7 @@ When used with Added in version 255\&. .RE .PP -\fB\-\-json=\fR\fIMODE\fR +\fB\-\-json=\fR\fB\fIMODE\fR\fR .RS 4 Shows output formatted as JSON\&. Expects one of "short" @@ -504,8 +504,18 @@ is specified, trigger events for devices that are not initialized by yet, and skip devices that are already initialized\&. .sp Typically, it is essential that applications which intend to use such a match, make sure a suitable udev rule is installed that sets at least one property on devices that shall be matched\&. See also Initialized Devices section below for more details\&. +.if n \{\ .sp -WARNING: +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBWarning\fR +.ps -1 +.br \fB\-\-initialized\-nomatch\fR can potentially save a significant amount of time compared to re\-triggering all devices in the system and e\&.g\&. can be used to optimize boot time\&. However, this is not safe to be used in a boot sequence in general\&. Especially, when udev rules for a device depend on its parent devices (e\&.g\&. "ATTRS" @@ -514,7 +524,8 @@ or keys, see \fBudev\fR(7) for more details), the final state of the device becomes easily unstable with this option\&. -.sp +.sp .5v +.RE Added in version 251\&. .RE .PP @@ -640,7 +651,7 @@ Signal systemd\-udevd to reload the rules files and other databases like the ker Set a global property for all events\&. .RE .PP -\fB\-m\fR, \fB\-\-children\-max=\fR\fIvalue\fR +\fB\-m\fR, \fB\-\-children\-max=\fR\fB\fIvalue\fR\fR .RS 4 Set the maximum number of events, systemd\-udevd will handle at the same time\&. When 0 is specified, then the maximum is determined based on the system resources\&. .RE @@ -652,11 +663,53 @@ Send a ping message to systemd\-udevd and wait for the reply\&. This may be usef Added in version 241\&. .RE .PP -\fB\-t\fR, \fB\-\-timeout=\fR\fIseconds\fR +\fB\-t\fR, \fB\-\-timeout=\fR\fB\fIseconds\fR\fR .RS 4 The maximum number of seconds to wait for a reply from systemd\-udevd\&. .RE .PP +\fB\-\-load\-credentials\fR +.RS 4 +When specified, the following credentials are used when passed in: +.PP +\fIudev\&.conf\&.*\fR +.RS 4 +These credentials should contain valid +\fBudev.conf\fR(5) +configuration data\&. From each matching credential a separate file is created\&. Example: a passed credential +udev\&.conf\&.50\-foobar +will be copied into a configuration file +/run/udev/udev\&.conf\&.d/50\-foobar\&.conf\&. +.sp +Added in version 256\&. +.RE +.PP +\fIudev\&.rules\&.*\fR +.RS 4 +These credentials should contain valid +\fBudev\fR(7) +rules\&. From each matching credential a separate file is created\&. Example: a passed credential +udev\&.rules\&.50\-foobar +will be copied into a configuration file +/run/udev/rules\&.d/50\-foobar\&.rules\&. +.sp +Added in version 256\&. +.RE +.sp +Note, this +\fIdoes not\fR +imply +\fB\-\-reload\fR +option\&. So, if +\fBsystemd\-udevd\fR +is already running, please consider to also specify +\fB\-reload\fR +to make the copied udev rules files used by +\fBsystemd\-udevd\fR\&. +.sp +Added in version 256\&. +.RE +.PP \fB\-h\fR, \fB\-\-help\fR .RS 4 Print a short help text and exit\&. @@ -729,7 +782,7 @@ Added in version 209\&. .RS 4 Print a short help text and exit\&. .RE -.SS "udevadm test\-builtin [\fIoptions\fR] [\fIcommand\fR] [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]" +.SS "udevadm test\-builtin [\fIoptions\fR] \fIcommand\fR [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]" .PP Run a built\-in command \fICOMMAND\fR @@ -763,7 +816,7 @@ Print a short help text and exit\&. .RS 4 Print a short version string and exit\&. .RE -.SS "udevadm verify [\fIoptions\fR] [\fIfile\fR...] \&..." +.SS "udevadm verify [\fIoptions\fR] [\fIfile\fR] \&..." .PP Verify syntactic, semantic, and stylistic correctness of udev rules files\&. .PP @@ -984,8 +1037,7 @@ doesn\*(Aqt probe or announce the new superblock before it is fully written: .\} .SH "SEE ALSO" .PP -\fBudev\fR(7), -\fBsystemd-udevd.service\fR(8) +\fBudev\fR(7), \fBsystemd-udevd.service\fR(8) .SH "NOTES" .IP " 1." 4 Locking Block Device Access diff --git a/upstream/fedora-rawhide/man8/update-pciids.8 b/upstream/fedora-rawhide/man8/update-pciids.8 index ca01c279..b48fdabf 100644 --- a/upstream/fedora-rawhide/man8/update-pciids.8 +++ b/upstream/fedora-rawhide/man8/update-pciids.8 @@ -1,4 +1,4 @@ -.TH update-pciids 8 "25 February 2024" "pciutils-3.11.1" "The PCI Utilities" +.TH update-pciids 8 "05 April 2024" "pciutils-3.12.0" "The PCI Utilities" .SH NAME update-pciids \- download new version of the PCI ID list diff --git a/upstream/fedora-rawhide/man8/updatedb.8 b/upstream/fedora-rawhide/man8/updatedb.8 deleted file mode 100644 index 45a1a633..00000000 --- a/upstream/fedora-rawhide/man8/updatedb.8 +++ /dev/null @@ -1,205 +0,0 @@ -.\" A man page for updatedb(8). -*- nroff -*- -.\" -.\" Copyright (C) 2005, 2007, 2008 Red Hat, Inc. All rights reserved. -.\" -.\" This copyrighted material is made available to anyone wishing to use, -.\" modify, copy, or redistribute it subject to the terms and conditions of the -.\" GNU General Public License v.2. -.\" -.\" This program is distributed in the hope that it will be useful, but WITHOUT -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for -.\" more details. -.\" -.\" You should have received a copy of the GNU General Public License along -.\" with this program; if not, write to the Free Software Foundation, Inc., -.\" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. -.\" -.\" Author: Miloslav Trmac <mitr@redhat.com> -.TH updatedb 8 "Jun 2008" mlocate - -.SH NAME -updatedb \- update a database for mlocate - -.SH SYNOPSIS - -\fBupdatedb\fR [\fIOPTION\fR]... - -.SH DESCRIPTION -.B updatedb -creates or updates a database used by -.BR locate (1). -If the database already exists, -its data is reused -to avoid rereading directories that have not changed. - -.B updatedb -is usually run daily by -.BR cron (8) -to update the default database. - -.SH EXIT STATUS -.B updatedb -returns with exit status 0 on success, 1 on error. - -.SH OPTIONS -The \fBPRUNE_BIND_MOUNTS\fR, \fBPRUNEFS\fR, -.B PRUNENAMES -and -.B PRUNEPATHS -variables, which are modified by some of the options, are documented in detail -in -.BR updatedb.conf (5). - -.TP -\fB\-f\fR, \fB\-\-add-prunefs\fB \fIFS\fR -Add entries in white-space-separated list \fIFS\fR to \fBPRUNEFS\fR. - -.TP -\fB\-n\fR, \fB\-\-add-prunenames\fB \fINAMES\fR -Add entries in white-space-separated list \fINAMES\fR to \fBPRUNENAMES\fR. - -.TP -\fB\-e\fR, \fB\-\-add-prunepaths\fB \fIPATHS\fR -Add entries in white-space-separated list \fIPATHS\fR to \fBPRUNEPATHS\fR. - -.TP -\fB\-U\fR, \fB\-\-database\-root\fR \fIPATH\fR -Store only results of scanning the file system subtree rooted at \fIPATH\fR to -the generated database. -The whole file system is scanned by default. - -.BR locate (1) -outputs entries as absolute path names which don't contain symbolic links, -regardless of the form of \fIPATH\fR. - -.TP -\fB\-\-debug\-pruning\fR -Write debugging information about pruning decisions to standard error output. - -.TP -\fB\-h\fR, \fB\-\-help\fR -Write a summary of the available options to standard output -and exit successfully. - -.TP -\fB\-o\fR, \fB\-\-output\fR \fIFILE\fR -Write the database to -.I FILE -instead of using the default database. - -.TP -\fB\-\-prune\-bind\-mounts\fR \fIFLAG\fR -Set -.B PRUNE_BIND_MOUNTS -to \fIFLAG\fR, overriding the configuration file. - -.TP -\fB\-\-prunefs\fR \fIFS\fR -Set \fBPRUNEFS\fR to \fIFS\fR, overriding the configuration file. - -.TP -\fB\-\-prunenames\fR \fINAMES\fR -Set \fBPRUNENAMES\fR to \fINAMES\fR, overriding the configuration file. - -.TP -\fB\-\-prunepaths\fR \fIPATHS\fR -Set \fBPRUNEPATHS\fR to \fIPATHS\fR, overriding the configuration file. - -.TP -\fB\-l\fR, \fB\-\-require\-visibility\fR \fIFLAG\fR -Set the \*(lqrequire file visibility before reporting it\*(rq flag in the -generated database to \fIFLAG\fR. - -If -.I FLAG -is -.B 0 -or \fBno\fR, -or if the database file is readable by "others" -or it is not owned by \fBslocate\fR, -.BR locate (1) -outputs the database entries even if the user running -.BR locate (1) -could not have read the directory necessary to find out the file described -by the database entry. - -If -.I FLAG -is -.B 1 -or -.B yes -(the default), -.BR locate (1) -checks the permissions of parent directories of each entry -before reporting it to the invoking user. -To make the file existence truly hidden from other users, the database -group is set to -.B slocate -and the database permissions prohibit reading the database by users using -other means than -.BR locate (1), -which is set-gid \fBslocate\fR. - -Note that the visibility flag is checked only if the database is owned by -.B slocate -and it is not readable by "others". - -.TP -\fB\-v\fR, \fB\-\-verbose\fR -Output path names of files to standard output, as soon as they are found. - -.TP -\fB\-V\fR, \fB\-\-version\fR -Write information about the version and license of -.B locate -on standard output and exit successfully. - -.SH EXAMPLES -To create a private mlocate database as an user other than \fBroot\fR, -run -.RS -.B updatedb -l 0 \-o -.I db_file -.B \-U -.I source_directory -.RE -Note that all users that can read -.I db_file -can get the complete list of files in the subtree of \fIsource_directory\fR. - -.SH FILES -.TP -\fB/etc/updatedb.conf\fR -A configuration file. See -.BR updatedb.conf (5). - -.TP -\fB/var/lib/mlocate/mlocate.db\fR -The database updated by default. - -.SH SECURITY -Databases built with -.B \-\-require\-visibility no -allow users to find names of files and directories of other users, -which they would not otherwise be able to do. - -.SH NOTES -The accompanying -.BR locate (1) -utility was designed to be compatible to -.B slocate -and attempts to be compatible to -.SM GNU -.B locate -where possible. -This is not the case for \fBupdatedb\fR. - -.SH AUTHOR -Miloslav Trmac <mitr@redhat.com> - -.SH SEE ALSO -.BR locate (1), -.BR mlocate.db (5), -.BR updatedb.conf (5) diff --git a/upstream/fedora-rawhide/man8/vercmp.8 b/upstream/fedora-rawhide/man8/vercmp.8 index b429a862..6e38436c 100644 --- a/upstream/fedora-rawhide/man8/vercmp.8 +++ b/upstream/fedora-rawhide/man8/vercmp.8 @@ -2,12 +2,12 @@ .\" Title: vercmp .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-01-25 +.\" Date: 2024-04-14 .\" Manual: Pacman Manual -.\" Source: Pacman 6.0.2 +.\" Source: Pacman 6.1.0 .\" Language: English .\" -.TH "VERCMP" "8" "2024\-01\-25" "Pacman 6\&.0\&.2" "Pacman Manual" +.TH "VERCMP" "8" "2024\-04\-14" "Pacman 6\&.1\&.0" "Pacman Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -191,17 +191,6 @@ Andrew Gregory <andrew\&.gregory\&.8@gmail\&.com> .sp -1 .IP \(bu 2.3 .\} -Eli Schwartz <eschwartz@archlinux\&.org> -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} Morgan Adamiec <morganamilo@archlinux\&.org> .RE .sp @@ -284,4 +273,15 @@ Nagy Gabor <ngaba@bibl\&.u\-szeged\&.hu> Dave Reisner <dreisner@archlinux\&.org> .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +Eli Schwartz <eschwartz@archlinux\&.org> +.RE +.sp For additional contributors, use git shortlog \-s on the pacman\&.git repository\&. diff --git a/upstream/fedora-rawhide/man8/xfs_db.8 b/upstream/fedora-rawhide/man8/xfs_db.8 index f53ddd67..a7f6d55e 100644 --- a/upstream/fedora-rawhide/man8/xfs_db.8 +++ b/upstream/fedora-rawhide/man8/xfs_db.8 @@ -388,6 +388,29 @@ and options are used to select the attribute or data area of the inode, if neither option is given then both areas are shown. .TP +.BI "bmapinflate [\-d " dirty_bytes "] [-e] [\-n " nr "] +Duplicates the first data fork mapping this many times, as if the mapping had +been repeatedly reflinked. +This is an expert-mode command for exercising high-refcount filesystems only. +Existing data fork mappings will be forgotten and the refcount btree will not +be updated. +This command leaves at least the refcount btree and the inode inconsistent; +.B xfs_repair +must be run afterwards. +.RS 1.0i +.TP 0.4i +.B \-d +Constrain the memory consumption of new dirty btree blocks to this quantity. +Defaults to 60MiB. +.TP 0.4i +.B \-e +Estimate the number of blocks and height of the new data fork mapping +structure and exit without changing anything. +.TP 0.4i +.B \-n +Create this many copies of the first mapping. +.RE +.TP .B btdump [-a] [-i] If the cursor points to a btree node, dump the btree from that block downward. If instead the cursor points to an inode, dump the data fork block mapping btree if there is one. diff --git a/upstream/fedora-rawhide/man8/yum-copr.8 b/upstream/fedora-rawhide/man8/yum-copr.8 index 6f7a9310..f09693ff 100644 --- a/upstream/fedora-rawhide/man8/yum-copr.8 +++ b/upstream/fedora-rawhide/man8/yum-copr.8 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "YUM-COPR" "8" "Feb 08, 2024" "4.5.0" "dnf-plugins-core" +.TH "YUM-COPR" "8" "Apr 24, 2024" "4.7.0" "dnf-plugins-core" .SH NAME yum-copr \- redirecting to DNF copr Plugin .sp diff --git a/upstream/fedora-rawhide/man8/zdump.8 b/upstream/fedora-rawhide/man8/zdump.8 index a248d297..c3f0bba6 100644 --- a/upstream/fedora-rawhide/man8/zdump.8 +++ b/upstream/fedora-rawhide/man8/zdump.8 @@ -110,7 +110,7 @@ zero or more following lines .q "\fIdate time interval\fP", one line for each transition time and following interval. Fields are separated by single tabs. -.P +.PP Dates are in .IR yyyy - mm - dd format and times are in 24-hour @@ -126,7 +126,7 @@ double-quoted strings unless they consist of one or more alphabetic characters. An isdst flag is omitted for standard time, and otherwise is a decimal integer that is unsigned and positive (typically 1) for daylight saving time and negative for unknown. -.P +.PP In times and in UT offsets with absolute value less than 100 hours, the seconds are omitted if they are zero, and the minutes are also omitted if they are also zero. Positive UT @@ -137,14 +137,14 @@ abbreviation begins with .q "\*-" or is .q "zzz". -.P +.PP In double-quoted strings, escape sequences represent unusual characters. The escape sequences are \es for space, and \e", \e\e, \ef, \en, \er, \et, and \ev with their usual meaning in the C programming language. E.g., the double-quoted string \*(lq"CET\es\e"\e\e"\*(rq represents the character sequence \*(lqCET "\e\*(rq.\"" -.P +.PP .ne 9 Here is an example of the output, with the leading empty line omitted. (This example is shown with tab stops set far enough apart so that the @@ -152,10 +152,9 @@ tabbed columns line up.) .nf .sp .if \n(.g .ft CR -.if t .in +.5i -.if n .in +2 +.in +2 .nr w \w'1896-01-13 'u+\n(.i -.ta \w'1896-01-13 'u +\w'12:01:26 'u +\w'-103126 'u +\w'HWT 'u +.ta \w'1896-01-13\0\0'u +\w'12:01:26\0\0'u +\w'-103126\0\0'u +\w'HWT\0\0'u TZ="Pacific/Honolulu" - - -103126 LMT 1896-01-13 12:01:26 -1030 HST @@ -179,7 +178,7 @@ abbreviated HST. Immediately after the second transition, the date is Immediately after the last transition the date is 1947-06-08 and the time is 02:30:00, and the following time interval is 10 hours west of UT, a standard time abbreviated HST. -.P +.PP .ne 10 Here are excerpts from another example: .nf @@ -209,7 +208,7 @@ Time discontinuities are found by sampling the results returned by at twelve-hour intervals. This works in all real-world cases; one can construct artificial time zones for which this fails. -.P +.PP In the .B \*-v and diff --git a/upstream/fedora-rawhide/man8/zic.8 b/upstream/fedora-rawhide/man8/zic.8 index 557ccd28..0ad373a2 100644 --- a/upstream/fedora-rawhide/man8/zic.8 +++ b/upstream/fedora-rawhide/man8/zic.8 @@ -95,7 +95,7 @@ as local time. .B zic will act as if the input contained a link line of the form .sp -.ti +.5i +.ti +2 .ta \w'Link\0\0'u +\w'\fItimezone\fP\0\0'u Link \fItimezone\fP localtime .sp @@ -118,9 +118,15 @@ TZ strings like "EET\*-2EEST" that lack transition rules. .B zic will act as if the input contained a link line of the form .sp -.ti +.5i +.ti +2 Link \fItimezone\fP posixrules .sp +If +.I timezone +is +.q "\*-" +(the default), any already-existing link is removed. +.sp Unless .I timezone is .q "\*-" , @@ -131,12 +137,6 @@ and it should not be combined with if .IR timezone 's transitions are at standard time or Universal Time (UT) instead of local time. -.sp -If -.I timezone -is -.BR \*- , -any already-existing link is removed. .TP .BR "\*-r " "[\fB@\fP\fIlo\fP][\fB/@\fP\fIhi\fP]" Limit the applicability of output files @@ -171,7 +171,7 @@ boundaries, particularly if causes a TZif file to contain explicit entries for .RI pre- hi transitions rather than concisely representing them -with an extended POSIX TZ string. +with an extended POSIX.1-2017 TZ string. Also see the .B "\*-b slim" option for another way to shrink output size. @@ -181,10 +181,10 @@ Generate redundant trailing explicit transitions for timestamps that occur less than .I hi seconds since the Epoch, even though the transitions could be -more concisely represented via the extended POSIX TZ string. +more concisely represented via the extended POSIX.1-2017 TZ string. This option does not affect the represented timestamps. Although it accommodates nonstandard TZif readers -that ignore the extended POSIX TZ string, +that ignore the extended POSIX.1-2017 TZ string, it increases the size of the altered output files. .TP .BI "\*-t " file @@ -194,37 +194,37 @@ the named file rather than in the standard location. .B \*-v Be more verbose, and complain about the following situations: .RS -.P +.PP The input specifies a link to a link, something not supported by some older parsers, including .B zic itself through release 2022e. -.P +.PP A year that appears in a data file is outside the range of representable years. -.P +.PP A time of 24:00 or more appears in the input. Pre-1998 versions of .B zic prohibit 24:00, and pre-2007 versions prohibit times greater than 24:00. -.P +.PP A rule goes past the start or end of the month. Pre-2004 versions of .B zic prohibit this. -.P +.PP A time zone abbreviation uses a .B %z format. Pre-2015 versions of .B zic do not support this. -.P +.PP A timestamp contains fractional seconds. Pre-2018 versions of .B zic do not support this. -.P +.PP The input contains abbreviations that are mishandled by pre-2018 versions of .B zic due to a longstanding coding bug. @@ -242,20 +242,20 @@ and .q Su for .q Sun . -.P +.PP The output file does not contain all the information about the long-term future of a timezone, because the future cannot be summarized as -an extended POSIX TZ string. For example, as of 2023 this problem +an extended POSIX.1-2017 TZ string. For example, as of 2023 this problem occurs for Morocco's daylight-saving rules, as these rules are based on predictions for when Ramadan will be observed, something that -an extended POSIX TZ string cannot represent. -.P +an extended POSIX.1-2017 TZ string cannot represent. +.PP The output contains data that may not be handled properly by client code designed for older .B zic output formats. These compatibility issues affect only timestamps before 1970 or after the start of 2038. -.P +.PP The output contains a truncated leap second table, which can cause some older TZif readers to misbehave. This can occur if the @@ -264,17 +264,17 @@ option is used, and either an Expires line is present or the .B "\*-r" option is also used. -.P +.PP The output file contains more than 1200 transitions, which may be mishandled by some clients. The current reference client supports at most 2000 transitions; pre-2014 versions of the reference client support at most 1200 transitions. -.P +.PP A time zone abbreviation has fewer than 3 or more than 6 characters. POSIX requires at least 3, and requires implementations to support at least 6. -.P +.PP An output file name contains a byte that is not an ASCII letter, .q "\*-" , .q "/" , @@ -288,7 +288,7 @@ or that starts with Input files use the format described in this section; output files use .BR tzfile (5) format. -.P +.PP Input files should be text files, that is, they should be a series of zero or more lines, each ending in a newline byte and containing at most 2048 bytes counting the newline, and without any NUL bytes. @@ -303,7 +303,7 @@ nearly any character, other software will work better if these are limited to the restricted syntax described under the .B \*-v option. -.P +.PP Input lines are made up of fields. Fields are separated from one another by one or more white space characters. The white space characters are space, form feed, carriage return, newline, @@ -316,7 +316,7 @@ White space characters and sharp characters may be enclosed in double quotes Any line that is blank (after comment stripping) is ignored. Nonblank lines are expected to be of one of three types: rule lines, zone lines, and link lines. -.P +.PP Names must be in English and are case insensitive. They appear in several contexts, and include month and weekday names and keywords such as @@ -327,22 +327,22 @@ and .BR "Zone" . A name can be abbreviated by omitting all but an initial prefix; any abbreviation must be unambiguous in context. -.P +.PP A rule line has the form .nf -.ti +.5i +.ti +2 .ta \w'Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'\*-\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00w\0\0'u +\w'1:00d\0\0'u .sp Rule NAME FROM TO \*- IN ON AT SAVE LETTER/S .sp For example: -.ti +.5i +.ti +2 .sp Rule US 1967 1973 \*- Apr lastSun 2:00w 1:00d D .sp .fi The fields that make up a rule line are: -.TP "\w'LETTER/S'u" +.TP .B NAME Gives the name of the rule set that contains this line. The name must start with a character that is neither @@ -360,24 +360,15 @@ an unquoted name should not contain characters from the set Gives the first year in which the rule applies. Any signed integer year can be supplied; the proleptic Gregorian calendar is assumed, with year 0 preceding year 1. -The word -.B minimum -(or an abbreviation) means the indefinite past. -The word -.B maximum -(or an abbreviation) means the indefinite future. Rules can describe times that are not representable as time values, with the unrepresentable times ignored; this allows rules to be portable among hosts with differing time value types. .TP .B TO Gives the final year in which the rule applies. -In addition to -.B minimum -and +The word .B maximum -(as above), -the word +(or an abbreviation) means the indefinite future, and the word .B only (or an abbreviation) may be used to repeat the value of the @@ -404,7 +395,7 @@ Month names may be abbreviated. Gives the day on which the rule takes effect. Recognized forms include: .nf -.in +.5i +.in +2 .sp .ta \w'Sun<=25\0\0'u 5 the fifth of the month @@ -413,7 +404,7 @@ lastMon the last Monday in the month Sun>=8 first Sunday on or after the eighth Sun<=25 last Sunday on or before the 25th .fi -.in -.5i +.in .sp A weekday name (e.g., .BR "Sunday" ) @@ -440,7 +431,7 @@ Gives the time of day at which the rule takes effect, relative to 00:00, the start of a calendar day. Recognized forms include: .nf -.in +.5i +.in +2 .sp .ta \w'00:19:32.13\0\0'u 2 time in hours @@ -454,7 +445,7 @@ Recognized forms include: \*-2:30 2.5 hours before 00:00 \*- equivalent to 0 .fi -.in -.5i +.in .sp Although .B zic @@ -528,22 +519,22 @@ of time zone abbreviations to be used when this rule is in effect. If this field is .q \*- , the variable part is null. -.P +.PP A zone line has the form .sp .nf -.ti +.5i +.ti +2 .ta \w'Zone\0\0'u +\w'Asia/Amman\0\0'u +\w'STDOFF\0\0'u +\w'Jordan\0\0'u +\w'FORMAT\0\0'u Zone NAME STDOFF RULES FORMAT [UNTIL] .sp For example: .sp -.ti +.5i +.ti +2 Zone Asia/Amman 2:00 Jordan EE%sT 2017 Oct 27 01:00 .sp .fi The fields that make up a zone line are: -.TP "\w'STDOFF'u" +.TP .B NAME The name of the timezone. This is the name used in creating the time conversion information file for the @@ -632,7 +623,7 @@ Continuation lines may contain .q "until" information, just as zone lines do, indicating that the next line is a further continuation. -.P +.PP If a zone changes at the same instant that a rule would otherwise take effect in the earlier zone or continuation line, the rule is ignored. A zone or continuation line @@ -647,7 +638,7 @@ earliest rule use the rule in effect after first transition into standard time. In a single zone it is an error if two rules take effect at the same instant, or if two zone changes take effect at the same instant. -.P +.PP If a continuation line subtracts .I N seconds from the UT offset after a transition that would be @@ -663,15 +654,15 @@ For example: .br .ne 7 .nf -.in +2m +.in +2 .ta \w'# Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'2006\0\0'u +\w'\*-\0\0'u +\w'Oct\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u .sp # Rule NAME FROM TO \*- IN ON AT SAVE LETTER/S Rule US 1967 2006 - Oct lastSun 2:00 0 S Rule US 1967 1973 - Apr lastSun 2:00 1:00 D -.ta \w'Zone\0\0America/Menominee\0\0'u +\w'STDOFF\0\0'u +\w'RULES\0\0'u +\w'FORMAT\0\0'u -# Zone\0\0NAME STDOFF RULES FORMAT [UNTIL] -Zone\0\0America/Menominee \*-5:00 \*- EST 1973 Apr 29 2:00 +.ta \w'# Zone\0\0'u +\w'America/Menominee\0\0'u +\w'STDOFF\0\0'u +\w'RULES\0\0'u +\w'FORMAT\0\0'u +# Zone NAME STDOFF RULES FORMAT [UNTIL] +Zone America/Menominee \*-5:00 \*- EST 1973 Apr 29 2:00 \*-6:00 US C%sT .sp .in @@ -683,17 +674,17 @@ However, .B zic interprets this more sensibly as a single transition from 02:00 CST (\*-05) to 02:00 CDT (\*-05). -.P +.PP A link line has the form .sp .nf -.ti +.5i +.ti +2 .ta \w'Link\0\0'u +\w'Europe/Istanbul\0\0'u Link TARGET LINK-NAME .sp For example: .sp -.ti +.5i +.ti +2 Link Europe/Istanbul Asia/Istanbul .sp .fi @@ -717,7 +708,7 @@ For example: .sp .ne 3 .nf -.in +2m +.in +2 .ta \w'Zone\0\0'u +\w'Greenwich\0\0'u Link Greenwich G_M_T Link Etc/GMT Greenwich @@ -727,23 +718,23 @@ Zone Etc/GMT\0\00\0\0\*-\0\0GMT .fi The two links are chained together, and G_M_T, Greenwich, and Etc/GMT all name the same zone. -.P +.PP Except for continuation lines, lines may appear in any order in the input. However, the behavior is unspecified if multiple zone or link lines define the same name. -.P +.PP The file that describes leap seconds can have leap lines and an expiration line. Leap lines have the following form: .nf -.ti +.5i +.ti +2 .ta \w'Leap\0\0'u +\w'YEAR\0\0'u +\w'MONTH\0\0'u +\w'DAY\0\0'u +\w'HH:MM:SS\0\0'u +\w'CORR\0\0'u .sp Leap YEAR MONTH DAY HH:MM:SS CORR R/S .sp For example: -.ti +.5i +.ti +2 .sp Leap 2016 Dec 31 23:59:60 + S .sp @@ -775,7 +766,7 @@ or .q "Rolling" if the leap second time given by the other fields should be interpreted as local (wall clock) time. -.P +.PP Rolling leap seconds were implemented back when it was not clear whether common practice was rolling or stationary, with concerns that one would see @@ -788,16 +779,16 @@ which means rolling leap seconds are not used in practice; also, they are not supported if the .B \*-r option is used. -.P +.PP The expiration line, if present, has the form: .nf -.ti +.5i +.ti +2 .ta \w'Expires\0\0'u +\w'YEAR\0\0'u +\w'MONTH\0\0'u +\w'DAY\0\0'u .sp Expires YEAR MONTH DAY HH:MM:SS .sp For example: -.ti +.5i +.ti +2 .sp Expires 2020 Dec 28 00:00:00 .sp @@ -816,7 +807,7 @@ Here is an extended example of .B zic input, intended to illustrate many of its features. .nf -.in +2m +.in +2 .ta \w'# Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'\*-\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u .sp # Rule NAME FROM TO \*- IN ON AT SAVE LETTER/S @@ -856,7 +847,7 @@ and Swiss daylight saving rules (defined with lines beginning with .q "Rule Swiss") apply. From 1981 to the present, EU daylight saving rules have applied, and the UTC offset has remained at one hour. -.P +.PP In 1941 and 1942, daylight saving time applied from the first Monday in May at 01:00 to the first Monday in October at 02:00. The pre-1981 EU daylight-saving rules have no effect @@ -864,7 +855,7 @@ here, but are included for completeness. Since 1981, daylight saving has begun on the last Sunday in March at 01:00 UTC. Until 1995 it ended the last Sunday in September at 01:00 UTC, but this changed to the last Sunday in October starting in 1996. -.P +.PP For purposes of display, .q "LMT" and @@ -886,7 +877,7 @@ you may need to use local standard time in the .B AT field of the earliest transition time's rule to ensure that the earliest transition time recorded in the compiled file is correct. -.P +.PP If, for a particular timezone, a clock advance caused by the start of daylight saving diff --git a/upstream/fedora-rawhide/packages.txt b/upstream/fedora-rawhide/packages.txt index 41941d02..bb2039c8 100644 --- a/upstream/fedora-rawhide/packages.txt +++ b/upstream/fedora-rawhide/packages.txt @@ -69,8 +69,7 @@ lz4 make man-pages mingetty -mkosi14 -mlocate +mkosi most mtools mutt |