Page MenuHomeFreeBSD
Files F107091976

D48203.diff
No OneTemporary
Actions

D48203.diff
View Options

diff --git a/lib/libsys/Makefile.sys b/lib/libsys/Makefile.sys
--- a/lib/libsys/Makefile.sys
+++ b/lib/libsys/Makefile.sys
@@ -454,6 +454,7 @@
jail.2 jail_set.2
MLINKS+=kldunload.2 kldunloadf.2
MLINKS+=kqueue.2 kevent.2 \
+ kqueue.2 kqueue1.2 \
kqueue.2 kqueuex.2 \
kqueue.2 EV_SET.3
MLINKS+=link.2 linkat.2
diff --git a/lib/libsys/kqueue.2 b/lib/libsys/kqueue.2
--- a/lib/libsys/kqueue.2
+++ b/lib/libsys/kqueue.2
@@ -38,6 +38,8 @@
.Ft int
.Fn kqueuex "u_int flags"
.Ft int
+.Fn kqueue1 "int flags"
+.Ft int
.Fo kevent
.Fa "int kq"
.Fa "const struct kevent *changelist"
@@ -92,26 +94,35 @@
The
.Fn kqueuex
system call also creates a new kernel event queue, and additionally takes
-the
+a
.Fa flags
argument, which is a bitwise-inclusive OR of the following flags:
.Bl -tag -width "KQUEUE_CLOEXEC"
-.It Fa KQUEUE_CLOEXEC
+.It Dv KQUEUE_CLOEXEC
The returned file descriptor is automatically closed on
.Xr execve 2
.El
+.Pp
The
-.Ql fd = kqueue()
-call is equivalent to
-.Ql fd = kqueuex(0) .
+.Fn kqueue
+system call is equivalent to calling
+.Fn kqueuex
+with
+.Fa flags
+set to 0.
.Pp
-For compatibility with
-.Nx ,
-the
+The
.Fn kqueue1
-function is provided, which accepts the
-.Dv O_CLOEXEC
-flag with the expected semantic.
+function exists for compatibility with
+.Nx .
+The
+.Fa flags
+argument accepts zero or more of the following values:
+.Bl -tag -width O_CLOEXEC
+.It Dv O_CLOEXEC
+The returned file descriptor is automatically closed on
+.Xr execve 2
+.El
.Pp
The
.Fn kevent
@@ -211,24 +222,25 @@
Opaque user-defined value passed through the kernel unchanged.
.It Fa ext
Extended data passed to and from kernel.
-The
+The meaning of the
.Fa ext[0]
and
.Fa ext[1]
-members use is defined by the filter.
-If the filter does not use them, the members are copied unchanged.
+members is defined by the filter.
+If a filter does not use them,
+these members are passed through the kernel unchanged.
The
.Fa ext[2]
and
.Fa ext[3]
-members are always passed through the kernel as-is,
-making additional context available to application.
+members are always passed through the kernel unchanged,
+providing additional user-defined values.
.El
.Pp
The
.Va flags
field can contain the following values:
-.Bl -tag -width EV_DISPATCH
+.Bl -tag -width EV_KEEPUDATA
.It Dv EV_ADD
Adds the event to the kqueue.
Re-adding an existing event
@@ -270,12 +282,12 @@
.Dv EV_ERROR
event, then subsequent changes will not get processed.
.It Dv EV_ONESHOT
-Causes the event to return only the first occurrence of the filter
+Return only the first occurrence of the filter
being triggered.
After the user retrieves the event from the kqueue,
it is deleted.
.It Dv EV_CLEAR
-After the event is retrieved by the user, its state is reset.
+Reset the state of the event after it is retrieved by the user.
This is useful for filters which report state transitions
instead of the current state.
Note that some filters may automatically
@@ -287,18 +299,16 @@
.Sx RETURN VALUES
below.
.It Dv EV_KEEPUDATA
-Causes
-.Fn kevent
-to leave unchanged any
+Preserve the
.Fa udata
associated with an existing event.
This allows other aspects of the event to be modified without requiring the
caller to know the
.Fa udata
-value presently associated.
+value previously registered with the event.
This is especially useful with
.Dv NOTE_TRIGGER
-or flags like
+or
.Dv EV_ENABLE .
This flag may not be used with
.Dv EV_ADD .
@@ -872,6 +882,13 @@
.Fn kevent
system calls first appeared in
.Fx 4.1 .
+The
+.Fn kqueuex
+system call
+and
+.Fn kevent1
+function first appeared in
+.Fx 14.0 .
.Sh AUTHORS
The
.Fn kqueue

File Metadata

Mime Type
text/plain
Expires
Fri, Jan 10, 11:49 PM (16 h, 35 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
15738776
Default Alt Text
D48203.diff (3 KB)

Event Timeline