OSDN Git Service

LDP: Update original to LDP v3.75
[linuxjm/LDP_man-pages.git] / original / man2 / signalfd.2
index 301743d..aadaefd 100644 (file)
@@ -17,7 +17,7 @@
 .\" <http://www.gnu.org/licenses/>.
 .\" %%%LICENSE_END
 .\"
-.TH SIGNALFD 2 2009-01-13 Linux "Linux Programmer's Manual"
+.TH SIGNALFD 2 2014-07-08 Linux "Linux Programmer's Manual"
 .SH NAME
 signalfd \- create a file descriptor for accepting signals
 .SH SYNOPSIS
@@ -72,7 +72,7 @@ is used to replace the signal set associated with that descriptor.
 
 Starting with Linux 2.6.27, the following values may be bitwise ORed in
 .IR flags
-to change the behaviour of
+to change the behavior of
 .BR signalfd ():
 .TP 14
 .B SFD_NONBLOCK
@@ -191,7 +191,7 @@ struct signalfd_siginfo {
     uint64_t ssi_addr;    /* Address that generated signal
                              (for hardware-generated signals) */
 .\" FIXME Since Linux 2.6.37 there is 'uint16_t ssi_addr_lsb'
-.\" which is not yet documented
+.\" in the signalfd_siginfo structure. This needs to be documented.
     uint8_t  pad[\fIX\fP];      /* Pad size to 128 bytes (allow for
                               additional fields in the future) */
 };
@@ -310,16 +310,6 @@ and
 .BR signalfd4 ()
 are Linux-specific.
 .SH NOTES
-The underlying Linux system call requires an additional argument,
-.IR "size_t sizemask" ,
-which specifies the size of the
-.I mask
-argument.
-The glibc
-.BR signalfd ()
-wrapper function does not include this argument,
-since it provides the required value for the underlying system call.
-
 A process can create multiple signalfd file descriptors.
 This makes it possible to accept different signals
 on different file descriptors.
@@ -333,7 +323,17 @@ 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 descriptors.
-.SS Underlying Linux system calls
+.SS C library/kernel ABI differences
+The underlying Linux system call requires an additional argument,
+.IR "size_t sizemask" ,
+which specifies the size of the
+.I mask
+argument.
+The glibc
+.BR signalfd ()
+wrapper function does not include this argument,
+since it provides the required value for the underlying system call.
+
 There are two underlying Linux system calls:
 .BR signalfd ()
 and the more recent
@@ -444,7 +444,7 @@ main(int argc, char *argv[])
 .BR epoll (7),
 .BR signal (7)
 .SH COLOPHON
-This page is part of release 3.68 of the Linux
+This page is part of release 3.75 of the Linux
 .I man-pages
 project.
 A description of the project,