Home / Autodocs / dos.library
NAME
- Exit
-
Exit from a program
SYNOPSIS
Exit( returnCode )
void Exit(LONG)
D1
FUNCTION
Exit() is a function provided for completeness, allowing a shell command or Workbench tool to finish executing, releasing resources associated with it.
Generally, you should not be calling Exit(). Exit() is part of the API of the original Tripos kernel which underpinned the original Kickstart 1.0 (V30) dos.library and caters to the software of its time.
The program startup code associated with your program, provided by, for example, the 'C' compiler runtime library, should be allowed to handle proper cleanup and exit, such as by calling exit(). Note the lower case letter "e" in exit().
Programs written in assembly language should place a return code in register D0 and execute an RTS instruction with their original stack pointer value, as it was when the program started executing.
IMPLEMENTATION
Generally, you should not be calling Exit(). Exit() is part of the API of the original Tripos kernel which underpinned the original Kickstart 1.0 (V30) dos.library and caters to the software of its time.
The program startup code associated with your program, provided by, for example, the 'C' compiler runtime library, should be allowed to handle proper cleanup and exit, such as by calling exit(). Note the lower case letter "e" in exit().
Programs written in assembly language should place a return code in register D0 and execute an RTS instruction with their original stack pointer value, as it was when the program started executing.
IMPLEMENTATION
The action of Exit() depends on whether the program which called it is running as a command under a CLI or not. If the program is running under the CLI the command finishes and control reverts to the CLI. In this case, returnCode is interpreted as the return code from the program.
If the program is running as a distinct Process, Exit() deletes the Process and releases the space associated with the stack, segment list and Process structure.
If the program is running as a distinct Process, Exit() deletes the Process and releases the space associated with the stack, segment list and Process structure.
INPUTS
- returnCode
-
integer