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' │
└────────────┬───────────┘
│
┌────────────────────────┐
│ │
│ Have all of the │ YES
┌───────│ entries been ├───────┐
│ │ processed? │ │
│ └────────────┬───────────┘ │
│ │NO List is
│ complete
│ ┌────────────────────────┐
│ │ │
│ │ Access the entry. Use │
│ │ the next entry value │
│ │ as an index. │
│ └───────────┬────────────┘
│ │
│
│ ┌────────────────────────┐
│ │ Process │
│ │ the │
│ │ entry │
│ │ │
│ └────────────┬───────────┘
│ │
│
│ ┌────────────────────────┐
│ │ │
│ │ Add the length of │
│ │ each entry │
│ │ to the next entry │
│ └────────────┬───────────┘
│ │
│
│ ┌────────────────────────┐
│ │ 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