Changeset 662 for trunk/kernel/kern/chdev.h

Timestamp:

Oct 10, 2020, 4:50:41 PM (4 years ago)

Author:

alain

Message:

Introduce the ksocket.h & ksocket.c files in kernel/kern.

File:

• trunk/kernel/kern/chdev.h (modified) (2 diffs)

trunk/kernel/kern/chdev.h

@@ -110 +110 @@
 
 /******************************************************************************************
- * This structure defines a chdev descriptor.
+ * This structure defines a chdev (channel device) descriptor.
  * This structure is NOT replicated, and can be located in any cluster.
- * One kernel thread, in charge of handling the commands registered in the waiting queue
- * of client threads is associated to each chdev descriptor (not for ICU, PIC, IOB).
+ * One server thread is in charge of handling the commands registered in the queue
+ * of clients associated to each chdev descriptor.
+ *
  * For each device type ***, the specific extension is defined in the "dev_***.h" file.
  *
  * NOTE . For most chdevs, the busylock is used to protect the waiting queue changes,
- *        when a thread register in this queue, or is removed after service.
+ *        when a client registers in this queue, or is removed after service.
  *      . This busylock is also used to protect direct access to the shared
  *        kernel TXT0 terminal, that does not use the waiting queue.
- *      . For the NIC chdevs it is also used to protect registration (or removal) of a
- *        socket in the list of attached sockets rooted in NIC device extension.
+ *      . For mostd chdevs, the client waiting queue is an xlist of threads, but it is
+ *        a list of sockets for the NIC chdevs. It is unused for ICU, PIC, and IOB.
  *****************************************************************************************/
 
@@ -142 +143 @@
     uint32_t             irq_id;      /*! associated IRQ index in local ICU              */
 
-        xlist_entry_t        wait_root;   /*! root of client threads waiting queue           */
+        xlist_entry_t        wait_root;   /*! root of clients waiting queue                  */
     remote_busylock_t    wait_lock;   /*! lock protecting waiting queue                  */
+    uint32_t             wait_nr;     /*! number of registered clients (NIC only)        */
 
     union