A fast and easily customised operating system
for ARM devices
OS_GBPB 9
Programmer's Reference Manuals
» Part 15 – SWI Calls
» OS
» OS_GBPB
» OS_GBPB 9
OS_ GBPB 9
(SWI &0C)
| Entry | |
|---|---|
| R0 | 9 |
| R1 | Pointer to directory name |
| R2 | Pointer to buffer |
| R3 | Number of objects to read |
| R4 | Where to start, 0 for first time |
| R5 | Length of buffer |
| R6 | Wildcarded name to match (if 0 “*” is used) |
| Exit | |
|---|---|
| R0 | Preserved |
| R1 | Preserved |
| R2 | Preserved |
| R3 | Number of objects read |
| R4 | Where to continue, or -1 for no more |
| C flag clear if R3 = 0, else set | |
Use
The purpose of this call is to read entries and file information from a specified directory, and return a buffer filled with a list of null-terminated strings consisting of the matched names.
Notes
This SWI reads filename entries from the specified directory, returning a group of 0-terminated strings in the buffer. The correct code structure to call this SWI is:
repeat
{
call OS_GBPB 9
if (R3 <> 0)
{
process buffer
}
} until (R4 = -1)
as it is legal to return R3 = 0 before the end of the directory. Also, do not assume anything about the value in R4.