diff options
author | Jerry Jelinek <jerry.jelinek@joyent.com> | 2017-06-08 10:10:29 +0000 |
---|---|---|
committer | Jerry Jelinek <jerry.jelinek@joyent.com> | 2017-06-08 10:10:29 +0000 |
commit | 8cb9f5acecaded019a9a55454a31dcf4328d0d1b (patch) | |
tree | 7c69e28b9b9b5ac2d9f928324a663becf2efa2d7 /usr/src/man/man3c/signalfd.3c | |
parent | 3a5445f1b9d90e4f1538503bd60913c8f302c17f (diff) | |
parent | 79809f9cf402f130667349b2d4007ecd65d63c6f (diff) | |
download | illumos-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.3c | 30 |
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 |