STAT

NAME

ÜBERSICHT

int stat(const char *file_name, struct stat *buf);
int fstat(int filedes, struct stat *buf);
int lstat(const char *file_name, struct stat *buf);  

BESCHREIBUNG

Beim Aufruf geben diese Funktionen Informationen über die angegebene Datei zurück. Dazu benötigt man keinerlei Rechte an der angegebene Datei, sehr wohl aber die Durchsuchungsrechte im allen Verzeichnissen im Pfad, der zu der Datei führt.

stat liefert die Informationen zu der in file_name angegebenen Datei und übergibt diese an buf.

lstat ist ähnlich stat, nur daß bei Links Informationen zum Link und nicht zu der bezogenen Datei an buf übergeben werden.

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).)

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), 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.  

RÜCKGABEWERT

FEHLER

EBADF

filedes falsch oder nicht vorhanden.

ENOENT

Eine Komponente des Pfades file_name existiert nicht, oder der Pfad ist eine leere Zeichenkette.

ENOTDIR

Eine Komponente des Pfades ist kein Verzeichnis.

ELOOP

Zu viele symbolische Verknüpfungen wurden entlang des Pfades gefunden.

EACCES

Zugriff verweigert.

ENOMEM

Kein Speicher mehr (das bedeutet Speicher im Kernel).

ENAMETOOLONG

Dateiname ist zu lang.

KONFORM ZU

POSIX beschreibt die Bits S_IFMT, S_IFSOCK, S_IFLNK, S_IFREG, S_IFBLK, S_IFDIR, S_IFCHR, S_IFIFO und S_ISVTX nicht, sondern verlangt stattdessen die Benutzung der Makros S_ISDIR() etc. Die Makros S_ISLNK und S_ISSOCK finden sich nicht in POSIX.1-1996, werden aber im nächsten POSIX-Standard vorhanden sein; ersteres ist aus SVID 4v2, letzteres aus SUSv2.

Unix V7 (und spätere Systeme) hatten S_IREAD, S_IWRITE und S_IEXEC wo POSIX die Synonyme S_IRUSR, S_IWUSR und S_IXUSR vorschreibt.  

ANDERE SYSTEME

Ein `sticky'-Befehl tauchte in Version 32V AT&T UNIX auf.

SIEHE AUCH

DEUTSCH VON

Neufassung © 2001 von Michael Piefel <piefel@informatik.hu-berlin.de>.

Index

NAME

ÜBERSICHT

BESCHREIBUNG

RÜCKGABEWERT

FEHLER

KONFORM ZU

ANDERE SYSTEME

SIEHE AUCH

DEUTSCH VON