aboutsummaryrefslogtreecommitdiff
path: root/share/man/man9/kqueue.9
diff options
context:
space:
mode:
Diffstat (limited to 'share/man/man9/kqueue.9')
-rw-r--r--share/man/man9/kqueue.953
1 files changed, 6 insertions, 47 deletions
diff --git a/share/man/man9/kqueue.9 b/share/man/man9/kqueue.9
index 53f55b8efe03..8214d7c01673 100644
--- a/share/man/man9/kqueue.9
+++ b/share/man/man9/kqueue.9
@@ -22,17 +22,15 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $FreeBSD$
-.\"
-.Dd October 12, 2021
+.Dd December 18, 2023
.Dt KQUEUE 9
.Os
.Sh NAME
.Nm kqueue_add_filteropts , kqueue_del_filteropts ,
.Nm kqfd_register ,
.Nm knote_fdclose ,
-.Nm knlist_init , knlist_init_mtx , knlist_init_rw_reader ,
-.Nm knlist_add , knlist_remove , knlist_remove_inevent , knlist_empty ,
+.Nm knlist_init , knlist_init_mtx ,
+.Nm knlist_add , knlist_remove , knlist_empty ,
.Nm knlist_clear , knlist_delete , knlist_destroy ,
.Nm KNOTE_LOCKED , KNOTE_UNLOCKED
.Nd "event delivery subsystem"
@@ -57,13 +55,9 @@
.Ft void
.Fn knlist_init_mtx "struct knlist *knl" "struct mtx *lock"
.Ft void
-.Fn knlist_init_rw_reader "struct knlist *knl" "struct rwlock *lock"
-.Ft void
.Fn knlist_add "struct knlist *knl" "struct knote *kn" "int islocked"
.Ft void
.Fn knlist_remove "struct knlist *knl" "struct knote *kn" "int islocked"
-.Ft void
-.Fn knlist_remove_inevent "struct knlist *knl" "struct knote *kn"
.Ft int
.Fn knlist_empty "struct knlist *knl"
.Ft void
@@ -161,8 +155,7 @@ function will be called to detach the
if the
.Vt knote
has not already been detached by a call to
-.Fn knlist_remove ,
-.Fn knlist_remove_inevent
+.Fn knlist_remove
or
.Fn knlist_delete .
The list
@@ -190,16 +183,6 @@ The
.Va kn_data
value should be updated as necessary to reflect the current value, such as
number of bytes available for reading, or buffer space available for writing.
-If the note needs to be removed,
-.Fn knlist_remove_inevent
-must be called.
-The function
-.Fn knlist_remove_inevent
-will remove the note from the list, the
-.Va f_detach
-function will not be called and the
-.Vt knote
-will not be returned as an event.
.Pp
Locks
.Em must not
@@ -260,10 +243,9 @@ is not required, but is commonly used.
If used, the
.Vt knlist
must be initialized with either
-.Fn knlist_init ,
-.Fn knlist_init_mtx
+.Fn knlist_init
or
-.Fn knlist_init_rw_reader .
+.Fn knlist_init_mtx .
The
.Vt knlist
structure may be embedded into the object structure.
@@ -308,19 +290,6 @@ style
lock.
.Pp
The function
-.Fn knlist_init_rw_reader
-may be used to initialize a
-.Vt knlist
-when
-.Fa lock
-is a
-.Xr rwlock 9
-read lock.
-Lock is acquired via
-.Fn rw_rlock
-function.
-.Pp
-The function
.Fn knlist_empty
returns true when there are no
.Vt knotes
@@ -351,16 +320,6 @@ The
function will be called when the
.Vt knote
is deleted during the next scan.
-This function must not be used when
-.Va f_isfd
-is set in
-.Vt "struct filterops" ,
-as the
-.Fa td
-argument of
-.Fn fdrop
-will be
-.Dv NULL .
.Pp
The function
.Fn knlist_delete