- Add comment for lwkt_initport_serialize()
authorSepherosa Ziehau <sephe@dragonflybsd.org>
Sat, 1 Nov 2008 11:17:52 +0000 (11:17 +0000)
committerSepherosa Ziehau <sephe@dragonflybsd.org>
Sat, 1 Nov 2008 11:17:52 +0000 (11:17 +0000)
- Adjust the comment of lwkt_getport() a little bit and put it to the
  proper place.

sys/kern/lwkt_msgport.c
sys/sys/msgport2.h

index b22d8ad..db1e612 100644 (file)
@@ -34,7 +34,7 @@
  * NOTE! This file may be compiled for userland libraries as well as for
  * the kernel.
  *
- * $DragonFly: src/sys/kern/lwkt_msgport.c,v 1.48 2008/11/01 10:38:21 sephe Exp $
+ * $DragonFly: src/sys/kern/lwkt_msgport.c,v 1.49 2008/11/01 11:17:52 sephe Exp $
  */
 
 #include <sys/param.h>
@@ -284,6 +284,13 @@ lwkt_initport_spin(lwkt_port_t port)
     spin_init(&port->mpu_spin);
 }
 
+/*
+ * lwkt_initport_serialize()
+ *
+ *     Initialize a port for use with descriptors that might be accessed
+ *     via multiple LWPs, processes, or threads.  Callers are assumed to
+ *     have held the serializer (slz).
+ */
 void
 lwkt_initport_serialize(lwkt_port_t port, struct lwkt_serialize *slz)
 {
@@ -342,16 +349,6 @@ lwkt_initport_panic(lwkt_port_t port)
                   lwkt_panic_replyport);
 }
 
-/*
- * lwkt_getport()
- *
- *     Retrieve the next message from the port's message queue, return NULL
- *     if no messages are pending.  The retrieved message will either be a
- *     request or a reply based on the MSGF_REPLY bit.
- *
- *     The calling thread MUST own the port.
- */
-
 static __inline
 void
 _lwkt_pullmsg(lwkt_port_t port, lwkt_msg_t msg)
index 3a1b278..78f2da4 100644 (file)
@@ -3,7 +3,7 @@
  *
  *     Implements Inlines for LWKT messages and ports.
  * 
- * $DragonFly: src/sys/sys/msgport2.h,v 1.15 2007/05/24 20:51:19 dillon Exp $
+ * $DragonFly: src/sys/sys/msgport2.h,v 1.16 2008/11/01 11:17:52 sephe Exp $
  */
 
 #ifndef _SYS_MSGPORT2_H_
@@ -63,6 +63,14 @@ lwkt_replymsg(lwkt_msg_t msg, int error)
     port->mp_replyport(port, msg);
 }
 
+/*
+ * Retrieve the next message from the port's message queue, return NULL
+ * if no messages are pending.  The retrieved message will either be a
+ * request or a reply based on the MSGF_REPLY bit.
+ * 
+ * If the backend port is a thread port, the the calling thread MUST
+ * own the port.
+ */
 static __inline
 void *
 lwkt_getport(lwkt_port_t port)