Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.15.10  Super                                                     TOS

 Name:         »supervisor« - Switch supervisor-mode.

 Opcode:       32 (0x0020)

 Syntax:       int32_t Super ( void *stack );

 Description:  The GEMDOS routine Super switches between user- and 
               supervisor-mode, or interrogates the current operating

               The address of the supervisor stack may be altered 
               during switching. If one passes the value 1 for the 
               parameter stack, then the current mode will be 
               interrogated. The value 0 switches between user- and 
               supervisor-mode. All other values will be regarded as 
               the new address for the supervisor stack. In the 
               supervisor-mode one can access all protected memory 
               blocks.

               Note: With regard to future operating system versions, 
               you should avoid use of the Super function. This 
               function gives rise to major problems in conjunction 
               with virtual memory and interruptible (and re-entrant) 
               file-systems in a multitasking system. If neccesary, 
               alter your code so that you can use the BIOS function 
               Supexec.

               For MiNT the following applies:(!nl) If you are in 
               SECURELEVEL > 1, you must have root privileges to get 
               into supervisor-mode. If you don't have them and call 
               Super, the SIGSYS signal (12) will be raised.

 Return value: If the state is to be obtained, one gets the value 0 
               for the user-mode and -1 for the supervisor-mode. Else 
               the function returns the address of the old supervisor 
               stack, provided one had switched to the supervisor- 
               mode.

 Availability: All GEMDOS versions.

 Group:        System functions

 See also:     Binding   Supexec