NAZWA¶

stat, fstat, lstat, fstatat - pobieranie stanu pliku

BIBLIOTEKA¶

Standardowa biblioteka C (libc, -lc)

SKŁADNIA¶

#include <sys/stat.h>

int stat(const char *restrict pathname,
         struct stat *restrict statbuf);
int fstat(int fd, struct stat *statbuf);
int lstat(const char *restrict pathname,
         struct stat *restrict statbuf);

#include <fcntl.h>           /* Definicja stałych AT_* */
#include <sys/stat.h>

int fstatat(int dirfd, const char *restrict pathname,
         struct stat *restrict statbuf, int flags);

lstat():

    /* Od glibc 2.20 */ _DEFAULT_SOURCE


        || _XOPEN_SOURCE >= 500


        || /* Od glibc 2.10: */ _POSIX_C_SOURCE >= 200112L


        || /* glibc 2.19 i wcześniejsze */ _BSD_SOURCE

fstatat():

    Od glibc 2.10:


        _POSIX_C_SOURCE >= 200809L


    Przed glibc 2.10:


        _ATFILE_SOURCE

OPIS¶

Funkcje te zwracają informacje o podanym pliku w buforze wskazanym przez statbuf. Do uzyskania tej informacji nie są wymagane prawa dostępu do samego pliku, lecz — w przypadku stat, fstatat() i lstat() — konieczne są prawa wykonywania (przeszukiwania) do wszystkich katalogów na prowadzącej do pliku ścieżce pathname.

stat() i fstatat() pobierają informacje o pliku wskazanym przez pathname; cechy wyróżniające fstatat() opisano poniżej.

lstat() is identical to stat(), except that if pathname is a symbolic link, then it returns information about the link itself, not the file that the link refers to.

fstat() jest identyczny z stat(), z tym wyjątkiem, że plik o którym mają być pobrane informacje, jest określony przez deskryptor pliku fd.

WARTOŚĆ ZWRACANA¶

Po pomyślnym zakończeniu zwracane jest zero. Po błędzie zwracane jest -1 i ustawiane jest errno wskazując błąd.

BŁĘDY¶

EACCES

Brak uprawnień do przeszukiwania jednego z katalogów w ścieżce zaczynającej pathname. (Patrz także path_resolution(7)).

EBADF

fd nie jest prawidłowym otwartym deskryptorem pliku.

EBADF

(fstatat()) pathname is relative but dirfd is neither AT_FDCWD nor a valid file descriptor.

EFAULT

Niepoprawny adres.

EINVAL

(fstatat()) Podano nieprawidłową opcję w flags.

ELOOP

Podczas rozwiązywania ścieżki napotkano zbyt wiele dowiązań symbolicznych.

ENAMETOOLONG

Ścieżka pathname jest zbyt długa.

ENOENT

A component of pathname does not exist or is a dangling symbolic link.

ENOENT

pathname is an empty string and AT_EMPTY_PATH was not specified in flags.

ENOMEM

Brak pamięci (tj. pamięci jądra).

ENOTDIR

Składnik ścieżki pathname nie jest katalogiem.

ENOTDIR

(fstatat()) pathname jest względna a dirfd jest deskryptorem pliku odnoszącym się do pliku zamiast do katalogu.

EOVERFLOW

pathname lub fd odnosi się do pliku, numeru i-węzła lub numeru bloków, których rozmiar nie jest reprezentowalny w - odpowiednio - typie off_t, ino_t, blkcnt_t. Błąd ten może wystąpić na przykład wtedy, gdy aplikacja skompilowana na platformie 32-bitowej bez -D_FILE_OFFSET_BITS=64 wywoła stat () na pliku, którego rozmiar jest większy niż (1<<31)-1 bajtów.

WERSJE¶

fstatat() was added in Linux 2.6.16; library support was added in glibc 2.4.

STANDARDY¶

stat(), fstat(), lstat(): SVr4, 4.3BSD, POSIX.1-2001, POSIX.1.2008.

fstatat(): POSIX.1-2008.

Według POSIX.1-2001 lstat() na dowiązaniu symbolicznym powinien zwrócić poprawne wartości tylko w polu st_size i w części pola st_mode związanej z typem pliku struktury stat. POSIX.1-2008 zaostrza tę specyfikację, wymagając od lstat() zwracania poprawnych informacji we wszystkich polach z wyjątkiem bitów trybu w st_mode.

Używanie pól st_blocks i st_blksize może być nieprzenośne. (Były wprowadzone w BSD; interpretacje różnią się zarówno między systemami, jak i na jednym systemie, jeśli użyty jest zdalny system plików montowany po NFS-ie).

UWAGI¶

PRZYKŁADY¶

Poniższy program wywołuje lstat() i wypisuje wybrane pola zwrócone w strukturze stat:

#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, "Użycie: %s <ścieżka>\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("Typ pliku:                 ");


    switch (sb.st_mode & S_IFMT) {


    case S_IFBLK:  printf("urządzenie blokowe\n");      break;


    case S_IFCHR:  printf("urządzenie znakowe\n");      break;


    case S_IFDIR:  printf("katalog\n");                 break;


    case S_IFIFO:  printf("FIFO/pipe\n");               break;


    case S_IFLNK:  printf("dowiązanie symboliczne\n");  break;


    case S_IFREG:  printf("zwykły plik\n");             break;


    case S_IFSOCK: printf("gniazdo\n");                 break;


    default:       printf("typ nieznany\n");            break;


    }


    printf("numer I-węzła:            %ju\n", (uintmax_t) sb.st_ino);


    printf("Tryb:                     %jo (octal)\n",


           (uintmax_t) sb.st_mode);


    printf("Liczba dowi◈za◈::               %ju\n", (uintmax_t) sb.st_nlink);


    printf("W◈a◈ciciel:                UID=%ju   GID=%ju\n",


           (uintmax_t) sb.st_uid, (uintmax_t) sb.st_gid);


    printf("Preferowany rozmiar bloku I/O: %jd bytes\n",


           (intmax_t) sb.st_blksize);


    printf("Rozmiar bloku:                %jd bytes\n",


           (intmax_t) sb.st_size);


    printf("Liczba zaalokowanych bloków:         %jd\n",


           (intmax_t) sb.st_blocks);


    printf("Ostatnia zmiana stanu:    %s", ctime(&sb.st_ctime));


    printf("Ostatni dostęp do pliku:  %s", ctime(&sb.st_atime));


    printf("Ostatnia zmiana pliku:    %s", ctime(&sb.st_mtime));


    exit(EXIT_SUCCESS);
}

ZOBACZ TAKŻE¶

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

TŁUMACZENIE¶

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys <pborys@dione.ids.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.