Manpage  — STAT

fstat ist genauso wie stat, nur wird die offene Datei, auf die filedes (so wie von open(2) zurückgegeben) zeigt, bearbeitet anstatt file_name.

Alle Aufrufe geben eine Struktur vom Typ stat zurück, die folgendermaßen aufgebaut ist:

struct stat
{
    dev_t         st_dev;      /* Device */
    ino_t         st_ino;      /* INode */
    mode_t        st_mode;     /* Zugriffsrechte */
    nlink_t       st_nlink;    /* Anzahl harter Links */
    uid_t         st_uid;      /* UID des Besitzers */
    gid_t         st_gid;      /* GID des Besitzers */
    dev_t         st_rdev;     /* Typ (wenn INode-Gerät) */
    off_t         st_size;     /* Größe in Bytes*/
    unsigned long st_blksize;  /* Blockgröße */
    unsigned long st_blocks;   /* Allozierte Blocks */
    time_t        st_atime;    /* Letzter Zugriff */
    time_t        st_mtime;    /* Letzte Modifikation */
    time_t        st_ctime;    /* Letzte Aenderung */
};

st_blocks gibt die Größe der Datei in 512-Byte-Blocks. Der Wert st_blksize gibt die "bevorzugte" Blockgröße für die Dateioperationen an. (Eine Datei mit kleineren Happen zu schreiben kann ineffizientes Lesen-Verändern-Wiederschreiben verursachen.)

Nicht alle von Linux unterstützten Dateisysteme verwenden alle Felder. Einige Dateisysteme erlauben es, so zu montieren, daß Dateizugriffe das st_atime nicht modifizieren. (Siehe `noatime' in mount(8) [Englisch].)

Normalerweise ändert sich st_atime durch den Einsatz von exec(2), mknod(2), pipe(2), utime(2) und read(2) (von mehr als null Bytes). Andere Routinen, wie mmap(2), können, müssen aber nicht, st_atime modifizieren.

st_mtime verändert sich beim Einsatz von dateimodifizierenden Operationen, z. B. durch mknod(2), truncate(2) [Englisch], utime(2) und write(2) (von mehr als null Bytes). Darüberhinaus wird st_mtime von Verzeichnissen durch das Anlegen oder Löschen von Dateien in diesem Verzeichnis geändert. st_mtime wird nicht durch Ändern von Besitzer, Gruppe, Hardlink-Zähler oder Modus verändert.

st_ctime wird durch Beschreiben oder das Ändern der INode-Informationen neu gesetzt (also Besitzer, Gruppe, Link-Zähler, Modus etc.).

Folgende POSIX-Makros sind definiert, um den Dateityp zu überprüfen:

S_ISREG(m)	reguläre Datei,
S_ISDIR(m)	Verzeichnis,
S_ISCHR(m)	zeichenorientiertes Gerät,
S_ISBLK(m)	blockorientiertes Gerät,
S_ISFIFO(m)	FiFo,
S_ISLNK(m)	symbolische Verknüpfung (nicht in POSIX.1-1996) und
S_ISSOCK(m)	Socket (nicht in POSIX.1-1996).

Folgende Flags sind für das st_mode-Feld definiert:

S_IFMT	0017000	Bitmaske für die Dateityp-Bitfelder
S_IFSOCK	0140000	Socket
S_IFLNK	0120000	symbolische Verknüpfung
S_IFREG	0100000	reguläre Datei
S_IFBLK	0060000	blockorientiertes Gerät
S_IFDIR	0040000	Verzeichnis
S_IFCHR	0020000	zeichenorientiertes Gerät
S_IFIFO	0010000	FIFO
S_ISUID	0004000	SUID-Bit
S_ISGID	0002000	SGID-Bit (siehe unten)
S_ISVTX	0001000	Sticky-Bit (siehe unten)
S_IRWXU	00700	Bitmaske für Besitzerzugriffsrechte
S_IRUSR	00400	Besitzer hat Lesezugriff
S_IWUSR	00200	Besitzer hat Schreibzugriff
S_IXUSR	00100	Besitzer hat Ausführungsrechte
S_IRWXG	00070	Bitmaske für Gruppenzugriffsrechte
S_IRGRP	00040	Gruppe hat Lesezugriff
S_IWGRP	00020	Gruppe hat Schreibzugriff
S_IXGRP	00010	Gruppe hat Ausführungsrechte
S_IRWXO	00007	Bitmaske für Zugriffsrechte Anderer (nicht in Gruppe)
S_IROTH	00004	Andere haben Lesezugriff
S_IWOTH	00002	Andere haben Schreibzugriff
S_IXOTH	00001	Andere haben Ausführungsrechte

Das SGID-Bit (S_ISGID) hat verschiedene besondere Nutzungsmöglichkeiten: Für ein Verzeichnis bedeutet es, das die BSD-Semantik Anwendung findet: Dateien, die in ihm erzeugt werden, erben die Gruppen-ID des Verzeichnisses und nicht die effektive Gruppen-ID des erzeugenden Prozesses, und dort erzeugte Verzeichnisse haben das SGID-Bit ebenfalls gesetzt. Für eine Datei, bei der das Bit für Gruppenausführungsrechte (S_IXGRP) nicht gesetzt ist, bedeutet es erzwungenes Locken von Datei/Datensatz.

Das `Sticky'-Bit (S_ISVTX) an einem Verzeichnis bedeutet, daß eine Datei in diesem Verzeichnis umbenannt und gelöscht werden darf nur vom Besitzer der Datei, dem Besitzer des Verzeichnisses, und von Root.