User Spaces
Logic Flow of Processing a List of Entries

When you process a list containing multiple entries, the logic flow looks as follows:

┌────────────────────────┐
│ │
│ Initialize the next │
│ entry with 'Where │
│ the list begins' │
└────────────┬───────────┘
│
6
┌────────────────────────┐
│ │
│ Have all of the │ YES
┌───────5│ entries been ├───────┐
│ │ processed? │ │
│ └────────────┬───────────┘ │
│ │NO List is
│ 6 complete
│ ┌────────────────────────┐
│ │ │
│ │ Access the entry. Use │
│ │ the next entry value │
│ │ as an index. │
│ └───────────┬────────────┘
│ │
│ 6
│ ┌────────────────────────┐
│ │ Process │
│ │ the │
│ │ entry │
│ │ │
│ └────────────┬───────────┘
│ │
│ 6
│ ┌────────────────────────┐
│ │ │
│ │ Add the length of │
│ │ each entry │
│ │ to the next entry │
│ └────────────┬───────────┘
│ │
│ 6
│ ┌────────────────────────┐
│ │ Add 1 to a count of │
│ │ how many have │
│ │ been processed │
│ │ │
│ └────────────┬───────────┘
│ │
│ │
└─────────────────────┘

It is important from an upward compatibility viewpoint to use the offset, length of

each entry, and the number of entries rather than hard coding the values in your

program.

Related Information

The User Space API chapter of the

System API Reference

, SC41-5801

The “User Space Format for List APIs” topic in Chapter 2 of the

System API
Reference

, SC41-5801

Chapter 2. Getting Started with APIs 2-15