@CHIP-RTOS C Library - RTOS API
Reserve file access context space
for the calling task.
int RTX_Access_Filesystem ( void );
- -- none --
- 0, success
-1 --> Failure (Too many tasks with file access)
- This API is deprecated. (However, it may still have some
diagnostic value to determine why file accesses are failing
or could be used to acquire the file access context space
ahead of time to assure the task's future file accesses
It is no longer necessary that
a task use this API to gain access to the file system.
A task is automatically granted file system access when the
file system API is used, provided that the system has not
ran out of file access context space.
The file system supports registration of up to 15 tasks
(35 tasks on SC1x3/SC2x) at a time. Each DOS program's main task
is registered with the file system regardless of whether
or not that program uses the file system. A task's reservation
on the file system access context space remains in effect until that
task is deleted from the system. The DOS program main tasks
are deleted when the program terminates (or
terminates and stays resident).
Once a successful call to this API has been made, any further
calls perform no operation (at most one context slot is assigned
If this API returns a failure indication, then the number of tasks
registered with the file system has reached the limit and this
calling task is consequently not being granted access to the
The number of tasks signed into file system can be seen in
the MEM command's
- This library function invokes a RTOS software interrupt.
Refer to this RTOS API function's
for more details.
- RTX API Overview
Supported since or modified in @CHIP-RTOS version
This API List
List of C Libraries
@CHIP-RTOS Main Index
End of document