NOM¶

inode – Informations sur les inœuds de fichier

DESCRIPTION¶

Chaque fichier possède un inœud contenant des métadonnées à propos du fichier. Une application peut récupérer ces métadonnées en utilisant stat(2) (ou des appels semblables) qui renvoie une structure stat, ou statx(2) qui renvoie une structure statx.

Voici une liste des informations habituellement trouvées dans, ou associées à, l’inœud de fichier avec les noms des champs correspondants de la structure renvoyée par stat(2) et statx(2) :

Périphérique où l’inœud réside

stat.st_dev ; statx.stx_dev_minor et statx.stx_dev_major

Chaque inœud (ainsi que le fichier associé) réside dans un système de fichiers qui est hébergé dans un périphérique. Ce périphérique est identifié par une combinaison de son ID (identifiant) majeur (qui identifie la classe générique du périphérique) et un ID mineur (qui identifie une instance particulière de la classe générique).

Numéro d’inœud

stat.st_ino ; statx.stx_ino

Chaque fichier du système de fichiers possède un numéro unique d’inœud. Les numéros d’inœud sont garantis uniques seulement à l’intérieur du système de fichiers (c’est-à-dire que les mêmes numéros d’inœud peuvent être utilisés dans des systèmes de fichiers différents, ce qui est la raison pour laquelle les liens physique ne traversent pas les limites des systèmes de fichiers). Ce champ contient le numéro d’inœud du fichier.

Mode et type de fichier

stat.st_mode ; statx.stx_mode

Consultez les détails ci-dessous sur le mode et le type de fichier.

Comptage des liens

stat.st_nlink ; statx.stx_nlink

Ce champ contient le nombre de liens physiques du fichier. Des liens supplémentaires vers un fichier existant sont créés en utilisant link(2).

ID utilisateur

st_uid stat.st_uid ; statx.stx_uid

Ce champ enregistre les ID utilisateur du propriétaire du fichier. Pour les fichiers nouvellement créés, l’ID utilisateur est l’ID utilisateur effectif du processus créateur. L’ID utilisateur d’un fichier peut être modifié en utilisant chown(2).

ID groupe

stat.st_gid ; statx.stx_gid

L’inœud enregistre l’ID du propriétaire du groupe du fichier. Pour les fichiers nouvellement créés, l’ID groupe du fichier est soit l’ID groupe du répertoire parent ou l’ID groupe effectif du processus créateur, selon que le bit set-group-ID est établi sur le répertoire parent (voir ci-dessous). L’ID groupe peut être modifié en utilisant chown(2).

Périphérique représenté par cet inœud

stat.st_rdev ; statx.stx_rdev_minor et statx.stx_rdev_major

Si ce fichier (inœud) représente un périphérique, alors l’inœud enregistre les ID majeur et mineur de ce périphérique.

Taille de fichier

stat.st_size ; statx.stx_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.

Taille de bloc préférée pour les E/S

stat.st_blksize ; statx.stx_blksize

Ce champ indique la taille de bloc « préférée » pour des entrées-sorties efficaces de système de fichiers. Des écritures par blocs plus petits peuvent entraîner un cycle lecture/modification/réécriture inefficace.

Nombre de blocs alloués au fichier

stat.st_blocks ; statx.stx_size

Ce 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.

La norme POSIX.1 signale que l’unité pour un membre st_blocks de la structure stat n’est pas définie dans la norme. Dans beaucoup d’implémentations, c’est 512 octets. Dans quelques systèmes, une unité différente est utilisée, telle que 1024. De plus, l’unité peut être différente en fonction des systèmes de fichiers.

Horodatage du dernier accès (atime)

stat.st_atime ; statx.stx_atime

C’est l’horodatage du dernier accès au fichier. Il est modifié par les accès au fichier, par exemple, avec execve(2), mknod(2), pipe(2), utime(2) et read(2) (d'au moins un octet). D'autres interfaces, comme mmap(2), peuvent ou non mettre à jour l’horodatage atime.

Certains systèmes de fichiers autorisent le montage de telle manière que les accès à des fichiers ou des répertoires ne modifient pas l’horodatage atime (voir noatime, nodiratime et relatime de mount(8) ainsi que les informations correspondantes dans mount(2)). De plus, l’horodatage atime n'est pas mis à jour si un fichier est ouvert avec l'indicateur O_NOATIME. Consultez open(2).

Horodatage de création (birth) de fichier (btime)

Non renvoyé dans la structure stat ; statx.stx_btime.

C’est l’horodatage de création de fichier. Il est défini à la création et n’est plus modifié.

L’horodatage btime n’était pas présent autrefois dans les systèmes UNIX et n’est pas actuellement pris en charge dans la plupart des systèmes Linux.

Horodatage de la dernière modification (mtime)

stat.st_mtime ; statx.stx_mtime

C’est l’horodatage de la dernière modification de fichier. Il est modifié par des changements sur le fichier, par exemple, effectués par mknod(2), truncate(2), utime(2) et write(2) (d'au moins un octet). D'autre part, l’horodatage mtime d'un répertoire est modifié lors de la création ou la suppression de fichiers en son sein. L’horodatage mtime n'est pas mis à jour lors d’une modification de propriétaire, groupe, mode ou nombre de liens physiques.

Horodatage de la dernière modification d’état (ctime)

stat.st_ctime ; statx.stx_ctime

C’est l’horodatage de la dernière modification d’état. Il est modifié lors d'une écriture ou d’une modification des informations d’inœud (c’est-à-dire propriétaire, groupe, mode, nombre de liens physiques, etc.).

Les champs d’horodatage indiquent le temps mesuré avec comme point de départ l’Époque — 1970-01-01 00:00:00 +0000 UTC (consultez time(7)).

Les horodatages en nanoseconde sont permis sur les systèmes de fichiers XFS, JFS, Btrfs et ext4 (depuis Linux 2.6.23). Les horodatages en nanoseconde ne sont pas permis sur les systèmes de fichiers ext2, ext3 et Reiserfs. Dans le but de renvoyer des horodatages avec une précision d'une nanoseconde, les champs d’horodatage dans les structures stat et statx sont définis sous forme de structures qui incluent une composante en nanoseconde. Consultez stat(2) et statx(2) pour davantage d’informations. Sur les systèmes de fichiers qui ne permettent pas les résolutions inférieures à la seconde, les champs nanoseconde dans les structures stat et statx sont renvoyés avec comme valeur zéro.

stat(pathname, &sb);
if ((sb.st_mode & S_IFMT) == S_IFREG) {


    /* Traiter les fichiers normaux */
}

stat(pathname, &sb);
if (S_ISREG(sb.st_mode)) {


    /* Traiter les fichiers normaux */
}

STANDARDS¶

Si vous avez besoin de connaître la définition des types blkcnt_t ou blksize_t de <sys/stat.h>, alors définissez _XOPEN_SOURCE avec une valeur supérieure ou égale à 500 (avant d'inclure tout en‐tête).

POSIX.1-1990 ne décrivait pas les constantes S_IFMT, S_IFSOCK, S_IFLNK, S_IFREG, S_IFBLK, S_IFDIR, S_IFCHR, S_IFIFO, S_ISVTX, mais réclame d'utiliser les macros S_ISDIR(), etc. Les constantes S_IF* sont présentes dans POSIX.1-2011 et les versions suivantes.

Les macros S_ISLNK() et S_ISSOCK() ne sont pas présentes dans POSIX.1-1996, mais le sont dans POSIX.1-2001. La première vient de SVID 4, la seconde de SUSv2.

UNIX V7 (et les systèmes suivants) propose S_IREAD, S_IWRITE, etS_IEXEC, là où POSIX préfère leurs synonymes S_IRUSR, S_IWUSR et S_IXUSR.

NOTES¶

Pour les pseudo-fichiers autogénérés par le noyau, la taille de fichier (stat.st_size, statx.stx_size) renvoyée par le noyau n’est pas précise. Par exemple, une valeur de zéro est renvoyée pour de nombreux fichiers du répertoire /proc, tandis que divers fichiers dans /sys renvoient une taille de 4096 octets, même si le contenu du fichier est plus petit. Pour de tels fichiers, une lecture d'autant d’octets que possible devrait être tentée (et ajouter « \0 » au tampon renvoyé s’il est interprété comme une chaîne).

VOIR AUSSI¶

stat(1), stat(2), statx(2), 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-Paul Guillonneau <guillonneau.jeanpaul@free.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.