From 0d550037a29fb339706338d3cba9f849f4a2f5a2 Mon Sep 17 00:00:00 2001 From: DJ Delorie Date: Tue, 18 Feb 2025 18:11:02 -0500 Subject: [PATCH] manual: Update signal descriptions (RHEL-67593) Resolves: RHEL-67593 --- glibc-RHEL-67593.patch | 85 ++++++++++++++++++++++++++++++++++++++++++ glibc.spec | 6 ++- 2 files changed, 90 insertions(+), 1 deletion(-) create mode 100644 glibc-RHEL-67593.patch diff --git a/glibc-RHEL-67593.patch b/glibc-RHEL-67593.patch new file mode 100644 index 0000000..a468108 --- /dev/null +++ b/glibc-RHEL-67593.patch @@ -0,0 +1,85 @@ +From bb6496b96444dfd55d7105396780f6eba14b1cd9 Mon Sep 17 00:00:00 2001 +From: DJ Delorie +Date: Fri, 17 Jan 2025 17:34:02 -0500 +Subject: manual: Update signal descriptions + +Based on auditing all the signals and source trees for Hurd and +Linux... + +SIGSYS - This is not used for a bad system call (ENOSYS is used +for that). This is used by SECCOMP and some cases where an invalid +sub-function was requested. + +SIGSTKFLT - Note it used to be a coprocessor stack fault but is now +obsolete and available for general user use. + +SIGLOST - Hurd only now; note that its original purpose as an NFS +lock lost signal is obsolete. + +SIGPWR - Note this is for power lost *and* power restored, and is +more a user-mode signal than a kernel-generated signal. + +Reviewed-by: Florian Weimer + +diff --git a/manual/signal.texi b/manual/signal.texi +index 2012980efe..842b4e49a2 100644 +--- a/manual/signal.texi ++++ b/manual/signal.texi +@@ -427,9 +427,18 @@ failure to properly emulate them. + + @deftypevr Macro int SIGSYS + @standards{Unix, signal.h} +-Bad system call; that is to say, the instruction to trap to the +-operating system was executed, but the code number for the system call +-to perform was invalid. ++System call event. This signal may be generated by a valid system ++call which requested an invalid sub-function, and also by the SECCOMP ++filter when it filters or traps a system call. ++ ++If the system call itself is invalid or unsupported by the kernel, the ++call will not raise this signal, but will return @code{ENOSYS}. ++@end deftypevr ++ ++@deftypevr Macro int SIGSTKFLT ++Coprocessor stack fault. Obsolete, no longer generated. This signal ++may be used by applications in much the way @code{SIGUSR1} and ++@code{SIGUSR2} are. + @end deftypevr + + @node Termination Signals +@@ -752,12 +761,11 @@ that isn't connected. @xref{Sending Data}. + @deftypevr Macro int SIGLOST + @standards{GNU, signal.h} + @cindex lost resource signal +-Resource lost. This signal is generated when you have an advisory lock +-on an NFS file, and the NFS server reboots and forgets about your lock. +- +-On @gnuhurdsystems{}, @code{SIGLOST} is generated when any server program +-dies unexpectedly. It is usually fine to ignore the signal; whatever +-call was made to the server that died just returns an error. ++Resource lost. On @gnuhurdsystems{}, @code{SIGLOST} is generated when ++any server program dies unexpectedly. It is usually fine to ignore ++the signal; whatever call was made to the server that died just ++returns an error. This signal's original purpose of signalling a lost ++NFS lock is obsolete. + @end deftypevr + + @deftypevr Macro int SIGXCPU +@@ -817,6 +825,17 @@ to print some status information about the system and what the process + is doing. Otherwise the default is to do nothing. + @end deftypevr + ++@deftypevr Macro int SIGPWR ++@cindex power event signal ++Power lost or restored. On s390x Linux systems, this signal is ++generated when a machine check warning is issued, and is sent to the ++process designated to receive ctrl-alt-del notifications. Otherwise, ++it is up to userspace applications to generate this signal and manage ++notifications as to the type of power event that happened. ++ ++The default action is to terminate the process. ++@end deftypevr ++ + @node Signal Messages + @subsection Signal Messages + @cindex signal messages diff --git a/glibc.spec b/glibc.spec index b112da4..407af2e 100644 --- a/glibc.spec +++ b/glibc.spec @@ -157,7 +157,7 @@ end \ Summary: The GNU libc libraries Name: glibc Version: %{glibcversion} -Release: 169%{?dist} +Release: 170%{?dist} # In general, GPLv2+ is used by programs, LGPLv2+ is used for # libraries. @@ -1119,6 +1119,7 @@ Patch811: glibc-RHEL-57585-2.patch Patch812: glibc-RHEL-57585-3.patch Patch813: glibc-RHEL-57585-4.patch Patch814: glibc-RHEL-57585-5.patch +Patch815: glibc-RHEL-67593.patch ############################################################################## # Continued list of core "glibc" package information: @@ -3112,6 +3113,9 @@ update_gconv_modules_cache () %endif %changelog +* Fri Feb 28 2025 DJ Delorie - 2.34-170 +- manual: Update signal descriptions (RHEL-67593) + * Fri Feb 14 2025 Tulio Magno Quites Machado Filho - 2.34-169 - Backport documentation for time functions (RHEL-57585)