From cd457d4e396b565899377ea6d9a283ae36ce6d77 Mon Sep 17 00:00:00 2001
From: John-Mark Gurney <jmg@FreeBSD.org>
Date: Thu, 28 Dec 2006 19:15:12 +0000
Subject: [PATCH] document that locks must not be aquired in f_event...  (and
 where they can be safely aquired)

Reminded by:	kib (by LOR #193)
MFC:	3 days
---
 share/man/man9/kqueue.9 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/share/man/man9/kqueue.9 b/share/man/man9/kqueue.9
index 65bc21ff1b1..06586d243f5 100644
--- a/share/man/man9/kqueue.9
+++ b/share/man/man9/kqueue.9
@@ -188,6 +188,20 @@ will remove the note from the list, the
 function will not be called and the
 .Vt knote
 will not be returned as an event.
+.Pp
+Locks
+.Em must not
+be aquired in
+.Va f_event .
+If a lock is required in
+.Va f_event ,
+it must be obtained in the
+.Fa kl_lock
+function of the
+.Vt knlist
+that the
+.Va knote
+was added to.
 .El
 .Pp
 The function