[src/trunk]: src/sys/sys Document the locking rules for the fields of the kev...

[thorpej <thorpej%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/24051ed7755d
branches:  trunk
changeset: 989051:24051ed7755d
user:      thorpej <thorpej%NetBSD.org@localhost>
date:      Sun Oct 10 23:30:44 2021 +0000

description:
Document the locking rules for the fields of the kevent that's
embedded in a knote.

diffstat:

 sys/sys/event.h |  10 +++++-----
 1 files changed, 5 insertions(+), 5 deletions(-)

diffs (31 lines):

diff -r 1a27f8fd3b0a -r 24051ed7755d sys/sys/event.h
--- a/sys/sys/event.h   Sun Oct 10 23:28:36 2021 +0000
+++ b/sys/sys/event.h   Sun Oct 10 23:30:44 2021 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: event.h,v 1.44 2021/10/10 18:07:51 thorpej Exp $       */
+/*     $NetBSD: event.h,v 1.45 2021/10/10 23:30:44 thorpej Exp $       */
 
 /*-
  * Copyright (c) 1999,2000,2001 Jonathan Lemon <jlemon%FreeBSD.org@localhost>
@@ -237,7 +237,7 @@
        SLIST_ENTRY(knote)      kn_selnext;     /* o: for struct selinfo */
        TAILQ_ENTRY(knote)      kn_tqe;         /* q: for struct kqueue */
        struct kqueue           *kn_kq;         /* q: which queue we are on */
-       struct kevent           kn_kevent;
+       struct kevent           kn_kevent;      /* (see below for locking) */
        uint32_t                kn_status;      /* q: flags below */
        uint32_t                kn_sfflags;     /*    saved filter flags */
        uintptr_t               kn_sdata;       /*    saved data field */
@@ -269,9 +269,9 @@
 
 #define        kn_id           kn_kevent.ident
 #define        kn_filter       kn_kevent.filter
-#define        kn_flags        kn_kevent.flags
-#define        kn_fflags       kn_kevent.fflags
-#define        kn_data         kn_kevent.data
+#define        kn_flags        kn_kevent.flags         /* q */
+#define        kn_fflags       kn_kevent.fflags        /* o */
+#define        kn_data         kn_kevent.data          /* o */
 };
 
 #include <sys/systm.h> /* for copyin_t */