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 chemin,
         struct stat *restrict statbuf);
int fstat(int fd, struct stat *statbuf);
int lstat(const char *restrict chemin,
         struct stat *restrict statbuf);

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

int fstatat(int dirfd, const char *restrict chemin,
         struct stat *restrict statbuf, int attributs);

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¶

Ces fonctions renvoient des renseignements sur le fichier indiqué, dans le tampon pointé par statbuf. Vous n'avez besoin d'aucun droit d'accès au fichier pour obtenir les informations, mais vous devez — dans le cas de stat(), fstatat() et lstat() — avoir le droit d'exécuter (search) sur tous les répertoires mentionnés dans le chemin menant au fichier.

stat() et fstatat() récupèrent des renseignements sur le fichier pointé par chemin. Les différences de fstatat() sont décrites ci-dessous :

lstat() est identique à stat(), sauf que dans le cas où chemin est un lien symbolique, auquel cas il renvoie des renseignements sur le lien lui-même plutôt que celui du fichier visé.

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

La permission de parcours est refusée pour un des répertoires contenu dans le chemin nom_chemin. (Consultez aussi path_resolution(7).)

EBADF

Le descripteur de fichier fd est non valable.

EBADF

(fstatat()) chemin est relatif mais dirfd n'est ni AT_FDCWD ni un descripteur de fichier valable.

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

nom_chemin est trop long.

ENOENT

Un composant du chemin d'accès chemin n'existe pas ou est un lien symbolique pointant nulle part.

ENOENT

chemin est une chaîne vide et AT_EMPTY_PATH n'a pas été spécifié dans attributs.

ENOMEM

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

ENOTDIR

Un élément du préfixe de chemin n'est pas un répertoire.

ENOTDIR

(fstatat()) chemin est relatif et dirfd est un descripteur de fichier faisant référence à un fichier qui n'est pas un dossier.

EOVERFLOW

chemin ou fd font référence à un fichier dont la taille, l'inœud ou le nombre de blocs ne peut pas être représenté respectivement avec le type off_t, ino_t ou blkcnt_t. Cela peut arriver par exemple quand une application compilée sans l'option -D_FILE_OFFSET_BITS=64 sur une plate-forme 32 bits appelle stat() pour un fichier dont la taille est supérieure à (1<<31)-1 octets.

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, "Utilisation : %s <chemin>\n", argv[0]);


        exit(EXIT_FAILURE);


    }


    if (lstat(argv[1], &sb) == -1) {


        perror("lstat");


        exit(EXIT_FAILURE);


    }


    printf("ID du périphérique contenant :  [%x,%x]\n",


           major(sb.st_dev),


           minor(sb.st_dev));


    printf("Type de fichier :                ");


    switch (sb.st_mode & S_IFMT) {


    case S_IFBLK:  printf("block device\n");            break;


    case S_IFCHR:  printf("périphérique caractère\n");        break;


    case S_IFDIR:  printf("répertoire\n");               break;


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


    case S_IFLNK:  printf("lien symbolique\n");                 break;


    case S_IFREG:  printf("fichier ordinaire\n");            break;


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


    default:       printf("inconnu ?\n");                break;


    }


    printf("Numéro d'inœud :            %ju\n", (uintmax_t) sb.st_ino);


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


           (uintmax_t) sb.st_mode);


    printf("Nombre de liens :               %ju\n", (uintmax_t) sb.st_nlink);


    printf("Propriétaires :                UID=%ju   GID=%ju\n",


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


    printf("Taille de bloc d'E/S : %jd bytes\n",


           (intmax_t) sb.st_blksize);


    printf("Taille du fichier                 %jd bytes\n",


           (intmax_t) sb.st_size);


    printf("Blocs alloués :         %jd\n",


           (intmax_t) sb.st_blocks);


    printf("Dernier changement d'état :       %s", ctime(&sb.st_ctime));


    printf("Dernier accès au fichier :         %s", ctime(&sb.st_atime));


    printf("Dernière modification du fichier :   %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.