summaryrefslogtreecommitdiff
path: root/usr/src/man/man3c/signalfd.3c
diff options
context:
space:
mode:
authorJerry Jelinek <jerry.jelinek@joyent.com>2017-06-08 10:10:29 +0000
committerJerry Jelinek <jerry.jelinek@joyent.com>2017-06-08 10:10:29 +0000
commit8cb9f5acecaded019a9a55454a31dcf4328d0d1b (patch)
tree7c69e28b9b9b5ac2d9f928324a663becf2efa2d7 /usr/src/man/man3c/signalfd.3c
parent3a5445f1b9d90e4f1538503bd60913c8f302c17f (diff)
parent79809f9cf402f130667349b2d4007ecd65d63c6f (diff)
downloadillumos-joyent-release-20170608.tar.gz
[illumos-gate merge]release-20170608
commit 79809f9cf402f130667349b2d4007ecd65d63c6f 8269 dtrace stddev aggregation is normalized incorrectly commit 22c8b9583d07895c16549075a53668d7bc988cf3 8108 zdb -l fails to read labels 2 and 3 commit 0255edcc85fc0cd1dda0e49bcd52eb66c06a1b16 8056 zfs send size estimate is inaccurate for some zvols commit dbfd9f930004c390a2ce2cf850c71b4f880eef9c 8156 dbuf_evict_notify() does not need dbuf_evict_lock commit 690031d326342fa4ea28b5e80f1ad6a16281519d 8168 NULL pointer dereference in zfs_create() commit 7c4ab494ff60bbbcc0889e71388ae63e903bbf57 8276 rpcbind leaks memory due to libumem per thread caching. commit f176a0a4cd61cbd708a7f25dc30d221f4d5902ba 8270 dnlc_reverse_lookup() is unsafe at any speed commit 72d3dbb9ab4481606cb93caca98ba3b3a8eb6ce2 8300 fix man page issues found by mandoc 1.14.1 commit cb4d790db8fe85bce9f9647fe4e1bdc274c7af1c 8337 gss: misleading-indentation commit f53522305c07915a44e86f2455cc62e7aac27037 8324 more: misleading-indentation Conflicts: usr/src/uts/common/fs/lookup.c usr/src/man/man3c/thrd_equal.3c
Diffstat (limited to 'usr/src/man/man3c/signalfd.3c')
-rw-r--r--usr/src/man/man3c/signalfd.3c30
1 files changed, 17 insertions, 13 deletions
diff --git a/usr/src/man/man3c/signalfd.3c b/usr/src/man/man3c/signalfd.3c
index fecd46e124..070bafc854 100644
--- a/usr/src/man/man3c/signalfd.3c
+++ b/usr/src/man/man3c/signalfd.3c
@@ -30,14 +30,15 @@
The
.Fn signalfd
function returns a file descriptor that can be used
-for synchronous consumption of signals. The file descriptor can be operated
-upon via
+for synchronous consumption of signals.
+The file descriptor can be operated upon via
.Xr read 2
and the facilities that notify of file descriptor activity (e.g.
.Xr poll 2 ,
.Xr port_get 3C ,
.Xr epoll_wait 3C
-). To dispose of the instance
+).
+To dispose of the instance
.Xr close 2
should be called on the file descriptor.
.Pp
@@ -72,7 +73,8 @@ see description for
in
.Xr open 2 .
.It Sy SFD_NONBLOCK
-Instance will be set to be non-blocking. A
+Instance will be set to be non-blocking.
+A
.Xr read 2
on a signalfd instance that has been initialized with
.Fa SFD_NONBLOCK ,
@@ -85,10 +87,10 @@ that are pending.
.Pp
As with
.Xr sigwait 2 ,
-reading a signal from the file descriptor will consume the signal. The signals
-used with signalfd file descriptors are normally first blocked so that their
-handler does not run when a signal arrives. If the signal is not blocked the
-behavior matches that of
+reading a signal from the file descriptor will consume the signal.
+The signals used with signalfd file descriptors are normally first blocked so
+that their handler does not run when a signal arrives.
+If the signal is not blocked the behavior matches that of
.Xr sigwait 2 ;
if a
.Xr read 2
@@ -154,19 +156,21 @@ typedef struct signalfd_siginfo {
File descriptor duplication during fork presents a challenge to the
.Sy signalfd
facility since signal data and events are dependent on the process from which
-they are queried. Its use with caching event systems such as
+they are queried.
+Its use with caching event systems such as
.Xr epoll 5 ,
-.Sy /dev/poll ,
+.Pa /dev/poll ,
or
.Xr port_create 3C
can result in undefined behavior if signalfd and polling descriptors are used
-together after being shared across a fork. Such restrictions do not apply if
-the child only calls
+together after being shared across a fork.
+Such restrictions do not apply if the child only calls
.Xr close 2
on the descriptors.
.Sh RETURN VALUES
Upon successful completion, a file descriptor associated with the instance
-is returned. Otherwise, -1 is returned and errno is set to indicate the error.
+is returned.
+Otherwise, -1 is returned and errno is set to indicate the error.
When
.Va fd
is not -1 and there is no error, the value of