NOM¶

stat, fstat, lstat, fstatat - Obtenir l'état d'un fichier (file status)

BIBLIOTHÈQUE¶

Bibliothèque C standard (libc, -lc)

SYNOPSIS¶

#include <sys/stat.h>

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

#include <fcntl.h>           /* Définition des constantes AT_* */
#include <sys/stat.h>

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

lstat() :

    /* Depuis la glibc 2.20 */ _DEFAULT_SOURCE


        || _XOPEN_SOURCE >= 500


        || /* Depuis la glibc 2.10 : */ _POSIX_C_SOURCE >= 200112L


        || /* Pour la glibc antérieure et égale à 2.19 */ _BSD_SOURCE

fstatat() :

    Depuis la glibc 2.10 :


        _POSIX_C_SOURCE >= 200809L


    avant la glibc 2.10 :


        _ATFILE_SOURCE

DESCRIPTION¶

These functions return information about a file, in the buffer pointed to by statbuf. No permissions are required on the file itself, but—in the case of stat(), fstatat(), and lstat()—execute (search) permission is required on all of the directories in path that lead to the file.

stat() and fstatat() retrieve information about the file pointed to by path; the differences for fstatat() are described below.

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

fstat() est identique à stat(), sauf que le fichier dont les renseignements sont à récupérer est référencé par le descripteur de fichier fd.

VALEUR RENVOYÉE¶

En cas de succès, zéro est renvoyé. En cas d'erreur, -1 est renvoyé et errno est définie pour préciser l'erreur.

ERREURS¶

EACCES

Search permission is denied for one of the directories in the path prefix of path. (See also path_resolution(7).)

EBADF

Le descripteur de fichier fd est non valable.

EBADF

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

EFAULT

Un pointeur se trouve en dehors de l'espace d'adressage.

EINVAL

(fstatat()) attributs contient un attribut non valable.

ELOOP

Trop de liens symboliques rencontrés dans le chemin d'accès.

ENAMETOOLONG

path est trop long.

ENOENT

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

ENOENT

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

ENOMEM

Pas assez de mémoire (mémoire noyau).

ENOTDIR

A component of the path prefix of path is not a directory.

ENOTDIR

(fstatat()) path is relative and dirfd is a file descriptor referring to a file other than a directory.

EOVERFLOW

path or fd refers to a file whose size, inode number, or number of blocks cannot be represented in, respectively, the types off_t, ino_t, or blkcnt_t. This error can occur when, for example, an application compiled on a 32-bit platform without -D_FILE_OFFSET_BITS=64 calls stat() on a file whose size exceeds (1<<31)-1 bytes.

STANDARDS¶

POSIX.1-2008.

HISTORIQUE¶

stat()

fstat()

lstat()

SVr4, 4.3BSD, POSIX.1-2001.

fstatat()

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

D'après POSIX.1-2001, lstat() sur un lien symbolique ne doit renvoyer des informations valables que dans le champ st_size et le type de fichier du champ st_mode de la structure stat. POSIX.1-2008 renforce la spécification, obligeant lstat() à renvoyer des informations valables dans tous les champs à part les bits de mode dans st_mode.

L'utilisation des champs st_blocks et st_blksize risque d'être moins portable (ils ont été introduits dans BSD. Leur interprétation change suivant les systèmes, voire sur un même système s'il y a des montages NFS).

EXEMPLES¶

Le programme suivant appelle lstat() et affiche certains champs sélectionnés dans la structure stat renvoyée.

#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 <path>\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);
}

VOIR AUSSI¶

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

TRADUCTION¶

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.