Changeset 657 for trunk/kernel/libk/xlist.h

Timestamp:

Mar 18, 2020, 11:16:59 PM (4 years ago)

Author:

alain

Message:

Introduce remote_buf.c/.h & socket.c/.h files.
Update dev_nic.c/.h files.

File:

• trunk/kernel/libk/xlist.h (modified) (17 diffs)

trunk/kernel/libk/xlist.h

@@ -2 +2 @@
  * xlist.h - Trans-cluster double circular linked list, using extended pointers.
  *
- * Author : Alain Greiner (2016,2017,2018,2019)
+ * Author : Alain Greiner (2016,2017,2018,2019,2020)
  *
  * Copyright (c) UPMC Sorbonne Universites
@@ -50 +50 @@
 /***************************************************************************
  * This macro returns the offset (in bytes) of a field in a structure.
+ ***************************************************************************
  * @ type   : structure type
  * @ member : name of the field
@@ -61 +62 @@
  * This macro returns an extended pointer on the structure containing an
  * embedded xlist_entry_t field.
+ ***************************************************************************
  * @ xlist_xp : extended pointer on the xlist_entry_t field
  * @ type     : type of the structure containing the xlist_entry_t
@@ -74 +76 @@
  * the root xlist_entry_t.
  * WARNING : check list non empty before using this macro.
+ ***************************************************************************
  * @ root_xp : extended pointer on the root xlist_entry_t 
  * @ type    : type of the linked elements
@@ -88 +91 @@
  * the root xlist_entry_t.
  * WARNING : check list non empty before using this macro.
+ ***************************************************************************
  * @ root_xp : extended pointer on the root xlist_entry_t
  * @ type    : type of the linked elements
@@ -100 +104 @@
  * This macro traverses an extended double linked list in forward order.
  * WARNING : the iter variable should NOT be deleted during traversal. 
+ ***************************************************************************
  * @ root_xp  : extended pointer on the root xlist_entry_t
  * @ iter_xp  : current extended pointer on a xlist_entry_t
@@ -112 +117 @@
  * This macro traverses an extended double linked list in backward order.
  * WARNING : the iter variable should NOT be deleted during traversal. 
+ ***************************************************************************
  * @ root_xp  : extended pointer on the root xlist_entry_t
  * @ iter_xp  : current extended pointer on a xlist_entry_t
@@ -124 +130 @@
  * This function returns an extended pointer on the next xlist_entry_t,
  * from an extended pointer on a reference xlist_entry_t.
+ ***************************************************************************
  * @ root    : extended pointer on the root xlist_entry_t
  * @ ref     : extended pointer on the reference xlist_entry_t
@@ -144 +151 @@
 /***************************************************************************
  * This function returns an extended pointer on the previous xlist_entry_t.
+ ***************************************************************************
  * @ root    : extended pointer on the root xlist_entry_t
  * @ ref     : extended pointer on the reference xlist_entry_t
@@ -165 +173 @@
  * This function initialises the root of an extended double linked list.
  * The root can be located in any cluster.
+ ***************************************************************************
  * @ root_xp   :  extended pointer on the root xlist_entry_t
 xixi **************************************************************************/
@@ -176 +185 @@
  * This function initialises an entry of an extended double linked list.
  * The entry can be located in any cluster.
+ ***************************************************************************
  * @ entry_xp  : extended pointer on the xlist_entry_t
  **************************************************************************/
@@ -188 +198 @@
  * double linked list. Four extended pointers must be modified.
  * The lock protecting the list should have been previously taken.
+ ***************************************************************************
  * @ root_xp   : extended pointer on the root xlist_entry_t
  * @ entry_xp  : extended pointer on the xlist_entry_t to be inserted
@@ -214 +225 @@
  * double linked list.  Four extended pointers must be modified.
  * The lock protecting the list should have been previously taken.
+ ***************************************************************************
  * @ root_xp   : extended pointer on the root xlist_entry_t
  * @ entry_xp  : extended pointer on the xlist_entry_t to be inserted
@@ -239 +251 @@
 /***************************************************************************
  * This function returns true if the list is empty.
+ ***************************************************************************
  * @ root_xp  : extended pointer on the root xlist_entry_t.
  **************************************************************************/
@@ -253 +266 @@
  * Two extended pointers must be modified.
  * The memory allocated to the removed entry is not released.
+ ***************************************************************************
  * @ xp : extended pointer on the xlist_entry_t to be removed.
  **************************************************************************/
@@ -277 +291 @@
  * Four extended pointers must be modified.
  * The memory allocated to the removed entry is not released.
+ ***************************************************************************
  * @ old      : extended pointer on the xlist_entry_t to be removed.
  * @ new      : extended pointer on the xlist_entry_t to be inserted.
@@ -307 +322 @@
 /***************************************************************************
  * This debug function displays all entries of an xlist.
+ ***************************************************************************
  * @ root_xp : extended pointer on the root xlist_entry_t.
  * @ string  : list identifier displayed in header.