Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.14.2  Sconfig                                                    TOS

 Name:         »Sconfig« - erlaubt die Konfigurierung von Teilen des 
               Betriebssystems.

 Gemdosnummer: 51

 Deklaration:  int32_t Sconfig ( int16_t mode, int32_t flags );

 Beschreibung: Die Funktion erlaubt die Konfigurierung von Teilen des 
               Betriebssystems. Es gilt:

                Parameter  Bedeutung

                mode       Aktion
                            0 = Konfiguration ermitteln
                            1 = Konfiguration setzen
                            2 = Zeiger auf DOSVARS-Struktur ermitteln
                            3 = reserviert; MagiC 3.00
                            4 = für WBDAEMON; MagiC 4.01
                            5 = reserviert; MagiC 4.01
                            6 = reserviert; MagiC 4.01
                flags      Konfiguration als Bitvektor
                            Bit-0 =   Pfadüberprüfung ein
                            Bit-1 =   Einfügemodus für GEMDOS und 
                                      Dialogboxen
                            Bit-2 =   reserviert
                            Bit-3 =   reserviert
                            Bit-4 =   Fastload für Diskette aus
                            Bit-5 =   TOS-Kompatibilität ein
                            Bit-6 =   Smart-Redraw aus
                            Bit-7 =   Grow-/Shrinkboxen aus
                            Bit-8 =   kein Halt nach TOS-Programmen
                            Bit-9 =   reserviert
                            Bit-10 =  Pulldown-Menüs
                            Bit-11 =  Floppy-Hintergrundbetrieb

               Hinweis: Gesetzte Bits schalten die jeweilige Funktion 
               ein, nicht gesetzte Bits schalten sie wieder aus.
               Bit-11 steht erst ab MagiC 3.0 zur Verfügung. Das 
               Setzen der Konfiguration ist nur bei abgeschalteter 
               TOS-Kompatibilität möglich.

               Die Funktion ist auch in KAOS vorhanden, allerings mit 
               einer etwas anderen Belegung des Bitvektors. Als mode 
               kennt KAOS 1.2 nur die ersten beiden Unterfunktionen.

                Bit-0 =   Pfadüberprüfung ein
                Bit-1 =   Diskwechsel-Simulation im Desktop ein
                Bit-2 =   Break ein; CTRL-C Abfrage bei jedem DOS- 
                          Aufruf
                Bit-3 =   CTRL-C Abfrage aus; für zeichenorientierte 
                          Funktionen
                Bit-4 =   Fastload für Diskette aus
                Bit-5 =   TOS-Kompatibilität ein (seit KAOS 1.4.2)
                Bit-6 =   Smart-Redraw aus (seit KAOS 1.4.2)
                Bit-7 =   Grow-/Shrinkboxen aus (seit KAOS 1.4.2)
                Bit-8 =   kein Halt nach TOS-Programmen (seit KAOS 
                          1.4.2)
                Bit-9 =   reserviert (seit KAOS 1.4.2)
                Bit-10 =  Pulldown-Menüs (seit KAOS 1.4.2)
                Bit-11..30 = reserviert (seit KAOS 1.4.2)
                Bit-31 =  muß unbedingt 0 sein, sonst Fehler! (seit 
                          KAOS 1.4.2)

 Ergebnis:     Die Funktion liefert, in Abhängigkeit des Parameters 
               mode, die aktuell gültige Konfiguration oder einen 
               Zeiger auf eine DOSVARS-Struktur zurück.

 Verfügbar:    seit KAOS Version 1.2 und MagiC ab Version 1.0

 Gruppe:       Systemfunktionen

 Querverweis:  Binding   Sysconf