BEZEICHNUNG

stat, fstat, lstat, fstatat - Dateistatus ermitteln

BIBLIOTHEK

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

#include <sys/stat.h>

int stat(const char *restrict Pfadname,
         struct stat *restrict Statuspuffer);
int fstat(int dd, struct stat *Statuspuffer);
int lstat(const char *restrict Pfadname,
         struct stat *restrict Statuspuffer);

#include <fcntl.h>           /* Definition der AT_*-Konstanten */
#include <sys/stat.h>

int fstatat(int Verzdd, const char *restrict Pfadname,
         struct stat *restrict Statuspuffer, int Schalter);

lstat():

    /* Seit Glibc 2.20 */ _DEFAULT_SOURCE
        || _XOPEN_SOURCE >= 500
        || /* Seit Glibc 2.10: */ _POSIX_C_SOURCE >= 200112L
        || /* Glibc 2.19 und älter */ _BSD_SOURCE

fstatat():

    Seit Glibc 2.10:
        _POSIX_C_SOURCE >= 200809L
    Vor Glibc 2.10:
        _ATFILE_SOURCE

BESCHREIBUNG

Diese Funktionen geben Informationen über eine Datei im Puffer zurück, auf den Statuspuffer zeigt. Dazu werden keinerlei Rechte an der angegebenen Datei benötigt, aber – im Falle von stat(), fstatat() und lstat() – müssen alle Verzeichnisse im Pfadnamen, der zu der Datei führt, durchsucht werden dürfen.

stat() und fstatat() liefern die Informationen zu der in Pfadname angegebenen Datei und übergibt diese an fstatat(), wie nachfolgend beschrieben.

lstat() ist ähnlich stat(), nur dass falls Pfadname ein symbolischer Link ist, Informationen zum Link zurückgegeben werden und nicht zur Datei, auf die der Link zeigt.

fstat ist ähnlich stat, außer dass die Datei, zu der Informationen ermittelt werden sollen, durch den Dateideskriptor dd angegeben wird.

RÜCKGABEWERT

Bei Erfolg wird Null zurückgegeben. Bei einem Fehler wird -1 zurückgegeben und errno gesetzt, um den Fehler anzuzeigen.

FEHLER

EACCES

Der Suchzugriff auf eines der Verzeichnisse im Pfadpräfix von Pfadname wurde verweigert (siehe auch path_resolution(7)).

EBADF

dd ist kein zulässiger offener Dateideskriptor.

EBADF

(fstatat()) Der Pfadname ist relativ, aber Verzdd ist weder AT_FDCWD noch ein gültiger Dateideskriptor.

EFAULT

Ungültige Adresse.

EINVAL

(fstatat()) Unzulässiger Schalter in Schalter angegeben.

ELOOP

Beim Pfaddurchlauf wurden zu viele symbolische Links gefunden.

ENAMETOOLONG

Pfadname ist zu lang.

ENOENT

Eine Komponente von Pfadname existiert nicht oder ist ein toter symbolischer Link.

ENOENT

Pfadname ist die leere Zeichenkette und AT_EMPTY_PATH wurde in Schalter nicht angegeben.

ENOMEM

Kein Speicher mehr (das bedeutet Speicher im Kernel).

ENOTDIR

Eine Komponente des Pfadpräfixes von Pfadname ist kein Verzeichnis.

ENOTDIR

(fstatat()) Pfadname ist relativ und Verzdd ist ein Dateideskriptor, der sich auf eine Datei bezieht, die kein Verzeichnis ist.

EOVERFLOW

Pfadname oder dd bezieht sich auf eine Datei, deren Name, Inode-Anzahl oder Anzahl der Blöcke nicht durch die Typen off_t, ino_t oder blkcnt_t repräsentiert werden kann. Dieser Fehler kann beispielsweise auftreten, wenn eine auf einer 32-bit-Plattform kompilierte Anwendung ohne -D_FILE_OFFSET_BITS=64 stat() für eine Datei aufruft, deren Größe (1<<31)-1 Byte übersteigt.

STANDARDS

POSIX.1-2008.

GESCHICHTE

stat()

fstat()

lstat()

SVr4, 4.3BSD, POSIX.1-2001.

fstatat()

POSIX.1-2008. Linux 2.6.16, Glibc 2.4.

Entsprechend POSIX.1-2001 benötigt lstat() bei Anwendung auf einen symbolischen Link lediglich im Feld st_size und im Dateityp des st_mode-Feldes der stat-Struktur gültige Rückgabeinformationen. POSIX.1-2008 engt diese Spezifikation ein, indem lstat() in allen Feldern außer den Modus-Bits in st_mode gültige Informationen zurückgeben muss.

Die Verwendung der Felder st_blocks und st_blksize kann die Portabilität einschränken. Diese wurden in BSD eingeführt. Die Interpretation unterscheidet sich auf verschiedenen Systemen, und möglicherweise auf einem einzelnen System, wenn NFS-Einhängungen bestehen.

BEISPIELE

Das folgende Programm ruft lstat() auf zeigt ausgewählte Felder der zurückgelieferten Struktur stat an.

#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/stat.h>
#include <sys/sysmacros.h>
#include <time.h>
int
main(int argc, char *argv[])
{
    struct stat sb;
    if (argc != 2) {
        fprintf(stderr, "Usage: %s <pathname>\n", argv[0]);
        exit(EXIT_FAILURE);
    }
    if (lstat(argv[1], &sb) == -1) {
        perror("lstat");
        exit(EXIT_FAILURE);
    }
    printf("ID of containing device:  [%x,%x]\n",
           major(sb.st_dev),
           minor(sb.st_dev));
    printf("File type:                ");
    switch (sb.st_mode & S_IFMT) {
    case S_IFBLK:  printf("block device\n");            break;
    case S_IFCHR:  printf("character device\n");        break;
    case S_IFDIR:  printf("directory\n");               break;
    case S_IFIFO:  printf("FIFO/pipe\n");               break;
    case S_IFLNK:  printf("symlink\n");                 break;
    case S_IFREG:  printf("regular file\n");            break;
    case S_IFSOCK: printf("socket\n");                  break;
    default:       printf("unknown?\n");                break;
    }
    printf("I-node number:            %ju\n", (uintmax_t) sb.st_ino);
    printf("Mode:                     %jo (octal)\n",
           (uintmax_t) sb.st_mode);
    printf("Link count:               %ju\n", (uintmax_t) sb.st_nlink);
    printf("Ownership:                UID=%ju   GID=%ju\n",
           (uintmax_t) sb.st_uid, (uintmax_t) sb.st_gid);
    printf("Preferred I/O block size: %jd bytes\n",
           (intmax_t) sb.st_blksize);
    printf("File size:                %jd bytes\n",
           (intmax_t) sb.st_size);
    printf("Blocks allocated:         %jd\n",
           (intmax_t) sb.st_blocks);
    printf("Last status change:       %s", ctime(&sb.st_ctime));
    printf("Last file access:         %s", ctime(&sb.st_atime));
    printf("Last file modification:   %s", ctime(&sb.st_mtime));
    exit(EXIT_SUCCESS);
}

SIEHE AUCH

ls(1), stat(1), access(2), chmod(2), chown(2), readlink(2), statx(2), utime(2), stat(3type), capabilities(7), inode(7), symlink(7)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Jonas Rovan <jonas@blitz.de>, Martin Schulze <joey@infodrom.org>, Michael Piefel <piefel@debian.org>, Mario Blättermann <mario.blaettermann@gmail.com> und Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.