From 0db324e2e5d9d3347ea0e93138372fb65aac09e6 Mon Sep 17 00:00:00 2001
From: Daniel Baumann <daniel.baumann@progress-linux.org>
Date: Mon, 15 Apr 2024 21:41:09 +0200
Subject: Merging upstream version 6.7.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
---
 man2/signalfd.2 | 34 +++++++++++++++++++---------------
 1 file changed, 19 insertions(+), 15 deletions(-)

(limited to 'man2/signalfd.2')

diff --git a/man2/signalfd.2 b/man2/signalfd.2
index 9af22b0..fba622c 100644
--- a/man2/signalfd.2
+++ b/man2/signalfd.2
@@ -3,7 +3,7 @@
 .\"
 .\" SPDX-License-Identifier: GPL-2.0-or-later
 .\"
-.TH signalfd 2 2023-05-03 "Linux man-pages 6.05.01"
+.TH signalfd 2 2023-10-31 "Linux man-pages 6.7"
 .SH NAME
 signalfd \- create a file descriptor for accepting signals
 .SH LIBRARY
@@ -12,7 +12,7 @@ Standard C library
 .SH SYNOPSIS
 .nf
 .B #include <sys/signalfd.h>
-.PP
+.P
 .BI "int signalfd(int " fd ", const sigset_t *" mask ", int " flags );
 .fi
 .SH DESCRIPTION
@@ -26,7 +26,7 @@ and has the advantage that the file descriptor may be monitored by
 .BR poll (2),
 and
 .BR epoll (7).
-.PP
+.P
 The
 .I mask
 argument specifies the set of signals that the caller
@@ -46,7 +46,7 @@ or
 signals via a signalfd file descriptor;
 these signals are silently ignored if specified in
 .IR mask .
-.PP
+.P
 If the
 .I fd
 argument is \-1,
@@ -60,7 +60,7 @@ is not \-1,
 then it must specify a valid existing signalfd file descriptor, and
 .I mask
 is used to replace the signal set associated with that file descriptor.
-.PP
+.P
 Starting with Linux 2.6.27, the following values may be bitwise ORed in
 .I flags
 to change the behavior of
@@ -85,11 +85,11 @@ See the description of the
 flag in
 .BR open (2)
 for reasons why this may be useful.
-.PP
+.P
 Up to Linux 2.6.26, the
 .I flags
 argument is unused, and must be specified as zero.
-.PP
+.P
 .BR signalfd ()
 returns a file descriptor that supports the following operations:
 .TP
@@ -131,7 +131,11 @@ or fails with the error
 .B EAGAIN
 if the file descriptor has been made nonblocking.
 .TP
-.BR poll "(2), " select "(2) (and similar)"
+.BR poll (2)
+.TQ
+.BR select (2)
+.TQ
+(and similar)
 The file descriptor is readable
 (the
 .BR select (2)
@@ -161,7 +165,7 @@ The format of the
 structure(s) returned by
 .BR read (2)s
 from a signalfd file descriptor is as follows:
-.PP
+.P
 .in +4n
 .EX
 struct signalfd_siginfo {
@@ -192,7 +196,7 @@ struct signalfd_siginfo {
 };
 .EE
 .in
-.PP
+.P
 Each of the fields in this structure
 is analogous to the similarly named field in the
 .I siginfo_t
@@ -338,7 +342,7 @@ The glibc
 .BR signalfd ()
 wrapper function does not include this argument,
 since it provides the required value for the underlying system call.
-.PP
+.P
 There are two underlying Linux system calls:
 .BR signalfd ()
 and the more recent
@@ -379,7 +383,7 @@ If a signal appears in the
 .I mask
 of more than one of the file descriptors, then occurrences
 of that signal can be read (once) from any one of the file descriptors.
-.PP
+.P
 Attempts to include
 .B SIGKILL
 and
@@ -387,7 +391,7 @@ and
 in
 .I mask
 are silently ignored.
-.PP
+.P
 The signal mask employed by a signalfd file descriptor can be viewed
 via the entry for the corresponding file descriptor in the process's
 .IR /proc/ pid /fdinfo
@@ -405,7 +409,7 @@ or the
 .B SIGFPE
 signal that results from an arithmetic error.
 Such signals can be caught only via signal handler.
-.PP
+.P
 As described above,
 in normal usage one blocks the signals that will be accepted via
 .BR signalfd ().
@@ -443,7 +447,7 @@ The program terminates after accepting a
 .B SIGQUIT
 signal.
 The following shell session demonstrates the use of the program:
-.PP
+.P
 .in +4n
 .EX
 .RB "$" " ./signalfd_demo"
-- 
cgit v1.2.3