summaryrefslogtreecommitdiff
path: root/usr/src/man/man3c
diff options
context:
space:
mode:
authorPatrick Mooney <pmooney@pfmooney.com>2020-06-27 22:43:08 +0000
committerPatrick Mooney <pmooney@oxide.computer>2020-07-08 15:06:27 +0000
commit66373fa702508a0a41753138f0b10f985c7e058d (patch)
tree51f222854dadb3bf79c8050e8db96aa2bbb47c50 /usr/src/man/man3c
parent33f84ecfada5880d94e9bfc5af7954d41e5664d5 (diff)
downloadillumos-joyent-66373fa702508a0a41753138f0b10f985c7e058d.tar.gz
12902 epoll should nominally support EPOLLEXCLUSIVE
Reviewed by: Jerry Jelinek <jerry.jelinek@joyent.com> Reviewed by: Mike Zeller <mike.zeller@joyent.com> Approved by: Dan McDonald <danmcd@joyent.com>
Diffstat (limited to 'usr/src/man/man3c')
-rw-r--r--usr/src/man/man3c/epoll_ctl.3c20
1 files changed, 19 insertions, 1 deletions
diff --git a/usr/src/man/man3c/epoll_ctl.3c b/usr/src/man/man3c/epoll_ctl.3c
index 3b3dfabcba..b80efb8b33 100644
--- a/usr/src/man/man3c/epoll_ctl.3c
+++ b/usr/src/man/man3c/epoll_ctl.3c
@@ -1,5 +1,6 @@
'\" te
.\" Copyright (c) 2014, Joyent, Inc. All Rights Reserved.
+.\" Copyright 2020 Oxide Computer Company
.\" This file and its contents are supplied under the terms of the
.\" Common Development and Distribution License ("CDDL"), version 1.0.
.\" You may only use this file in accordance with the terms of version
@@ -8,7 +9,7 @@
.\" A full copy of the text of the CDDL should have accompanied this
.\" source. A copy of the CDDL is also available via the Internet at
.\" http://www.illumos.org/license/CDDL.
-.TH EPOLL_CTL 3C "April 9, 2016"
+.TH EPOLL_CTL 3C "June 29, 2020"
.SH NAME
epoll_ctl \- control an epoll instance
.SH SYNOPSIS
@@ -206,6 +207,23 @@ exclusive with \fBEPOLLIN\fR.
.sp
.ne 2
.na
+\fBEPOLLEXCLUSIVE\fR
+.ad
+.RS 14n
+This is present for binary compatibility and is effectively a no-op on illumos.
+
+The flag was added to Linux in v4.5 to provide a means to mitigate thundering
+herd problems when multiple epoll instances contain the same event source. Set
+on a specified event source during \fBEPOLL_CTL_ADD\fR (and not allowed with
+\fBEPOLL_CTL_MOD\fR), it indicates that epoll should attempt to limit the scope
+of pollers woken when a shared target resource changes state. All pollers
+without the flag set in the event will be notified and one \fIor more\fR of
+those with it set will be as well.
+.RE
+
+.sp
+.ne 2
+.na
\fBEPOLLWAKEUP\fR
.ad
.RS 14n