A fast and easily customised operating system
for ARM devices
OS_File 255
Programmer's Reference Manuals
» Part 15 – SWI Calls
» OS
» OS_File
» OS_File 255
OS_ File 255
(SWI &08)
| Entry | |
|---|---|
| R0 | 16 (reason code) |
| R1 | Pointer to filename |
| R2 | Load address if (R3 AND &FF = 0) |
| R3 | 0 to use load address at R2, or |
| Bit 31 set to specify the file is code and will be synchronised, otherwise | |
| Load file using file’s load address |
| Exit | |
|---|---|
| R0 | Object type |
| R1 | Preserved |
| R2 | Load address |
| R3 | Execution address |
| R4 | Object length |
| R5 | Object attributes |
Use
The purpose of this call is to load a named file, using File$Path variable.
Notes
An error will be generated if the file is not found, is a directory, no read access, or a bad load address.
If the file is stamped, and loading at load address (R3 AND &FF <> 0) the variable Alias$@LoadType_xxx will be used, and it is possible that (like OS_FSControl 4) this call may not return.
There are several different reason codes that can be used to load files using the OS_File call. They differ depending on how the path used to find the file.
In addition:
- R3 bit 31 is not supported (or necessary) before RISC OS 3.70.
- If filetype is code (&F95), then it will be automatically synchronised, but not before RISC OS 3.7.