La structure stat¶

Les trois fonctions renvoient une structure stat contenant les champs suivants :

struct stat {


    dev_t     st_dev;         /* ID du périphérique contenant le fichier */


    ino_t     st_ino;         /* Numéro d’inœud                   */


    mode_t    st_mode;        /* Type de fichier et mode          */


    nlink_t   st_nlink;       /* Nombre de liens physiques        */


    uid_t     st_uid;         /* UID du propriétaire              */


    gid_t     st_gid;         /* GID du propriétaire              */


    dev_t     st_rdev;        /* ID du périphérique (si fichier spécial)  */


    off_t     st_size;        /* Taille totale en octets          */


    blksize_t st_blksize;     /* Taille de bloc pour E/S          */


    blkcnt_t  st_blocks;      /* Nombre de blocs de 512 o alloués */


    /* Depuis Linux 2.6, le noyau permet une précision à la


       nanoseconde pour les champs temporels suivants. Pour


       plus de précisions avant Linux 2.6, consultez les NOTES.   */


    struct timespec st_atim;  /* Heure dernier accès */


    struct timespec st_mtim;  /* Heure dernière modification */


    struct timespec st_ctim;  /* Heure dernier changement état */
#define st_atime st_atim.tv_sec      /* Rétrocompatibilité        */
#define st_mtime st_mtim.tv_sec
#define st_ctime st_ctim.tv_sec
};

Remarque : l’ordre des champs de la structure stat varie un peu en fonction des architectures. De plus, la définition ci-dessus ne montre pas les octets de remplissage qui peuvent être présents entre certains champs sur plusieurs architectures. Consultez le code source de la glibc et du noyau pour plus de précisions.

Note : pour des raisons de performance et de simplicité, différents champs dans la structure stat peuvent contenir des informations d'état à différents moments durant l'exécution de l'appel système. Par exemple, si st_mode ou st_uid sont modifiés par un autre processus en appelant chmod(2) ou chown(2), stat() peut renvoyer l'ancien st_mode en même temps que le nouveau st_uid ou l'ancien st_uid en même temps que le nouveau st_mode.

Les champs dans la structure stat ont la signification suivante :

st_dev

Ce champ décrit le périphérique sur lequel ce fichier réside. Les macros major(3) et minor(3) peuvent être utiles pour décomposer l'identifiant de périphérique de ce champ.

st_ino

Ce champs contient le nombre d'inœuds du fichier.

st_mode

Ce champ contient le type et le mode du fichier. Consultez inode(7) pour plus d'informations.

st_nlink

Ce champ contient le nombre de liens physiques du fichier.

st_uid

Ce champ contient l'identifiant de l'utilisateur propriétaire du fichier.

st_gid

Ce champ contient l'identifiant du groupe propriétaire du fichier.

st_rdev

Ce champ décrit le périphérique que ce fichier (inœud) représente.

st_size

Ce champ indique la taille du fichier (s'il s'agit d'un fichier ordinaire ou d'un lien symbolique) en octets. La taille d'un lien symbolique est la longueur du nom de chemin qu'il vise, sans l’octet NULL final.

st_blksize

Ce champ indique la taille de bloc « préférée » pour des E/S efficaces du système de fichiers.

st_blocks

Le champ indique le nombre de blocs de 512 octets alloués au fichier. Cette valeur peut être inférieure à st_size/512 si le fichier a des trous.

st_atime

C'est l'heure du dernier accès aux données du fichier.

st_mtime

C'est l'heure de la dernière modification des données du fichier.

st_ctime

C'est l'horodatage de la dernière modification de l'état du fichier (heure de la dernière modification de l'inœud).

Pour plus d'informations sur les champs ci-dessus, consultez inode(7).

fstatat()¶

L'appel système fstatat() est une interface plus générale pour accéder à des informations de fichier qui peut encore fournir exactement le comportement de chaque appel à stat(), lstat() et fstat().

Si le chemin donnée dans chemin est un chemin relatif, il est interprété par rapport au répertoire référencé par le descripteur de fichier dirfd, (plutôt que par rapport au répertoire courant du processus appelant, comme avec stat() et lstat() pour un chemin relatif).

Si chemin est relatif, et si dirfd est la valeur spéciale AT_FDCWD, chemin est interprété comme étant relatif au répertoire courant du processus appelant, comme stat() et lstat().

Si pathname est absolu, alors dirfd est ignoré.

L'argument attributs est soit 0, soit un OU binaire « | » avec les options suivantes :

AT_EMPTY_PATH (depuis Linux 2.6.39)

Si chemin est une chaîne vide, opérer sur le fichier référencé par dirfd (qui peut avoir été obtenu en utilisant open(2) avec l’attribut O_PATH). Dans ce cas, dirfd peut référencer tout type de fichier, pas uniquement un répertoire et le comportement de fstatat() est similaire à celui de fstat(). Si dirfd est AT_FDCWD, l’appel opère sur le répertoire de travail actuel. Cet attribut est spécifique à Linux, _GNU_SOURCE doit être définie pour obtenir sa définition.

AT_NO_AUTOMOUNT (depuis Linux 2.6.38)

Ne pas monter automatiquement le composant terminal (« nom de base ») de chemin s'il s'agit d'un répertoire qui est un point de montage automatique. Cela permet à l'appelant de rassembler les attributs d'un point de montage automatique (plutôt que l'emplacement qu'il monterait). Depuis Linux 4.14, ne pas créer également d'instance d'un nom qui n'existe pas dans un répertoire créé à la demande comme utilisé pour des mappages indirects d'auto-monteur. Cet attribut n'a aucun effet si le point de montage est déjà attaché.

stat() et lstat() agissent comme si AT_NO_AUTOMOUNT était défini.

L'attribut AT_NO_AUTOMOUNT peut être utilisé dans les outils qui balayent les répertoires pour éviter un montage automatique massif dans un répertoire avec des points de montage automatiques.

Cet attribut est spécifique à Linux ; définir _GNU_SOURCE pour obtenir sa définition.

AT_SYMLINK_NOFOLLOW

Si chemin est un lien symbolique, ne pas le déréférencer, mais renvoyer des informations sur le lien lui‐même, comme le fait lstat(2). (Par défaut, fstatat() déréférence les liens symboliques, comme stat(2).)

Consultez openat(2) pour une explication de la nécessité de fstatat().

Champs temporels¶

Les anciens noyaux et les anciennes normes ne permettaient pas d’utiliser des champs temporels en nanosecondes. À la place, trois champs temporels — st_atime, st_mtime et st_ctime — étaient utilisés pour time_t qui enregistraient des horodatages avec une précision à la seconde.

Depuis le noyau 2.5.48, la structure stat permet une résolution d'une nanoseconde pour les trois champs temporels. Les composants en nanosecondes de chaque horodatage sont disponibles en utilisant des noms de la forme st_atim.tv_nsec si des macros de test de fonctionnalités appropriées sont définis. Les horodatages en nanosecondes ont été normalisés dans POSIX.1-2008 et, à partir de la version 2.12, la glibc expose les noms de composants en nanosecondes si _POSIX_C_SOURCE est définie avec une valeur supérieure ou égale à 200809L ou si _XOPEN_SOURCE est définie avec une valeur supérieure ou égale à 700. Jusqu'à la version 2.19 comprise de la glibc, les définitions des composants en nanosecondes sont aussi fixée si _BSD_SOURCE ou _SVID_SOURCE est définie. Si aucune de ces macros susmentionnées n'est définie, alors les valeurs en nanosecondes sont exposées avec des noms de la forme st_atimensec.

différences entre bibliothèque C et noyau¶

Avec le temps, l'augmentation de la taille de la structure stat a conduit à trois versions successives de stat() : sys_stat() (slot __NR_oldstat), sys_newstat() (slot __NR_stat) et sys_stat64() __NR_stat64) sur les plateformes 32 bits telles que i386. Les deux premières versions étaient déjà présentes dans Linux 1.0 (quoiqu'avec des noms différents), la dernière a été ajoutée dans Linux 2.4. La même remarque s'applique à fstat() et lstat().

Les versions internes du noyau de la structure stat traitées par les différentes versions étaient respectivement :

__old_kernel_stat

La structure d'origine avec des champs plutôt étroits et pas de remplissage.

stat

Un champ plus grand st_ino et le remplissage ont été ajoutés dans différentes parties de la structure pour autoriser un agrandissement futur.

stat64

Un champ st_ino encore plus grand, des champs st_uid et st_gid plus grands pour s'adapter à l'extension à 32 bits des UID et GID dans Linux 2.4 et d'autres champs agrandis ainsi que plus de remplissage dans la structure. (Divers octets de remplissage étaient finalement consommés dans Linux 2.6 avec l'introduction d'ID de périphérique 32 bits et des composants en nanosecondes dans les champs d'horodatage.)

La fonction d'enveloppe stat() de la glibc dissimule ces détails aux applications invoquant la version la plus récente de l'appel système fourni par le noyau, et recompresse l'information renvoyée si nécessaire pour les binaires anciens.

Dans les systèmes modernes 64 bits, la vie est plus simple : il n'y a qu'un seul appel système stat() et le noyau s'occupe de la structure stat qui contient des champs d'une taille suffisante.

L'appel système sous-jacent employé par la fonction d'enveloppe fstatat() de la glibc s'appelle en fait fstatat64() ou, sur certaines architectures, newfstatat().