LONG Shutdown(mode)
LONG mode;
Shutdown() kills all processes, syncs filesystems then halts or reboots the system. | |
Opcode | 337 (0x0151) |
Availability | This function is available under all MiNT versions integrated with MultiTOS. |
Parameters |
On mode equal to SHUT_HALT (0L), the system will shutdown
then enter a halted condition.
On mode equal to SHUT_BOOT (1L), the system will reboot the machine after shutting everything down. On mode equal to SHUT_COLD (2L), the system will act the same as with the SHUT_BOOT mode, except that a cold start rather than the warm start will be performed. That last mode is recognized as of FreeMiNT version 1.15.5, older versions of the kernel will treat the SHUT_BOOT and SHUT_COLD values equally. All other values of mode are reserved for future definition. |
Binding |
move.l mode,-(sp) move.w #$0151,-(sp) trap #1 addq.l #6,sp |
Return Value | Shutdown() returns a negative GEMDOS error code, if failed. On success this call obviously never returns. |
Caveats |
Older versions of MiNT contained a bug that might cause the system to crash, if you called Shutdown() while both GEM AES and virtual console daemon were present. |
Comments | You need root privileges to shut the system down. |
See Also | Sync() |