Changeset fd6d8620 in rtems-docs

Timestamp:

03/08/23 20:39:25 (7 months ago)

Author:

Kinsey Moore <kinsey.moore@…>

Branches:

master

Children:

cdb6208

Parents:

2f7ebf7

git-author:

Kinsey Moore <kinsey.moore@…> (03/08/23 20:39:25)

git-committer:

Joel Sherrill <joel@…> (03/09/23 15:16:12)

Message:

c-user/chains: Correct iteration example code

Casting the node returned by rtems_chain_head is incorrect. That node is
owned by the control structure and use of it post-cast could cause
memory corruption. Instead, use rtems_chain_first which returns the
node after the head node. This also corrects node->next to
rtems_chain_next(node) which makes better use of the API.

File:

• c-user/chains.rst (modified) (1 diff)

c-user/chains.rst

@@ -193 +193 @@
         rtems_chain_initialize_empty (out);
 
-        node = rtems_chain_head (chain);
+        node = rtems_chain_first (chain);
+
         while (!rtems_chain_is_tail (chain, node))
         {
             bar = (foo*) node;
-            rtems_chain_node* next_node = node->next;
+            rtems_chain_node* next_node = rtems_chain_next(node);
             if (strcmp (match, bar->data) == 0)
             {