an example using the linux linked list data structure

linux_linked_list.h

// define person who has siblings and children
struct person {
  int age;
  struct list_head siblings;
  struct list_head children;
}

// declare a father
struct person father = {
  .age = 32,
  .sibling = LIST_HEAD_INIT(child.sibling),
  .children = LIST_HEAD_INIT(father.children),
};

// declare a child
struct person son = {
  .age = 5,
  .sibling = LIST_HEAD_INIT(child.sibling),
  .children = LIST_HEAD_INIT(child.children),
};

// add a child
list_add(&son->sibling, &parent->children);

// iterate
struct list_head *current;
struct person *child;

// macro for each
list_for_each(current, father.children) {
  child = container_of(current, struct person, children);
  // process the child
}

// without container_of dependency
list_for_each_entry(child, father.children, children) {
  // process the child
}