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.9.2  Fchmod                                                      TOS

 Name:         »Fchmod« - Berechtigung für Dateizugriffe setzen.

 Gemdosnummer: 306

 Deklaration:  int32_t Fchmod ( int8_t *name, int16_t mode );

 Beschreibung: Die Funktion ändert die Zugriffsrechte für die Datei 
               name. Der Parameter mode enthält die neuen 
               Zugriffsrechte:

                Zugriff durch  mode  Bedeutung 
                Besitzer der   0400  Leseberechtigung 
                Datei          0200  Schreibberechtigung 
                               0100  Ausführungsrecht 
 
                Gruppe der     0040  Leseberechtigung 
                Datei          0020  Schreibberechtigung 
                               0010  Ausführungsrecht 
 
                Alle anderen   0004  Leseberechtigung 
                Benutzer       0002  Schreibberechtigung 
                               0001  Ausführungsrecht 

               Für ausführbare Dateien gilt:

                mode   Bedeutung

                04000  effektive UID des Prozesses auf die UID dessen 
                       setzen, der diesen Prozeß ausführt.
                02000  effektive GID des Prozesses auf die GID dessen 
                       setzen, der diesen Prozeß ausführt.
                01000  Die Datei ist ein Verzeichnis
                       Nur der Datei- bzw. Verzeichnis-Eigentümer 
                       (oder root) können Dateien in diesem 
                       Verzeichnis löschen.
                ????   Die Datei ist ein Shared-Text Programm
                       Nach der Abarbeitung wird das Programm nicht 
                       aus dem Speicher entfernt und muß dem 
                       entsprechend für eine erneute Bearbeitung nicht 
                       nachgeladen werden.

               Hinweis: Nicht alle Filesysteme müssen alle 
               Möglichkeiten unterstützen. Nicht unterstützte 
               Zugriffsrechte werden dann ignoriert. Ausführungsrecht 
               für ein Verzeichnis bedeutet, daß in diesem Verzeichnis 
               nach einem Namen bzw. einer Namenskomponente gesucht 
               werden darf.

 Ergebnis:     Die Funktion kann folgende Rückgabewerte liefern:

                E_OK   :  kein Fehler aufgetreten.
                EFILNF :  Datei nicht gefunden.
                EPTHNF :  Pfad zur Datei nicht gefunden.
                EACCDN :  Die EUID des aufrufenden Prozesses 
                          unterscheidet sich von der UID des 
                          Dateibesitzers und ist auch nicht die des 
                          Kernels (0).

 Verfügbar:    Verfügbar, wenn ein 'MiNT' Cookie mit einer 
               Versionsnummer von mindestens 0.90 existiert.

 Gruppe:       Dateifunktionen

 Querverweis:  Binding   Fattrib   Fxattr   XFS-Konzept in MagiC