OS_FSControl 2 (changes)

Showing changes from revision #3 to #4: Added | Removed | Changed

Programmer's OS Reference SWI Manuals Calls

» Part OS_FSControl 15 – SWI Calls

» OS_FSControl 2OS

OS_ FSControl 2

(SWI &29)

Use

The purpose of this call is to inform the Operating System and current application, that a new application is starting.

Notes

Although registers are preserved, the call may not return.

This SWI allows you to fake starting an application. It performs the following actions:

1. Issues OS_UpCall 256 to inform the current application – if the upcall is claimed then the error “Unable to start application” is returned.
2. Issues Service_NewApplication to inform modules. If the service is claimed, then the error cannot be returned to you (as your application will now have been killed) so the error “Unable to start application” is passed to OS_GenerateError, which results in the error being sent to your parent’s error handler.
3. Unless the exit handler is below memory limit then all handlers below memory limit are reset to their defaults (OS_ReadDefaultHandler).
4. The currently active object pointer is set; the current time and command tail are set (OS_WriteEnv).

See also

• Currently Active Object Pointer
• Error Handler
• Exit Handler
• Memory Limit Handler
• OS_FSControl
• OS_GenerateError
• OS_ReadDefaultHandler
• OS_UpCall 256
• Service_NewApplication