df − Fournit la quantité d’espace occupé des systèmes de fichiers.

df [options] [fichier...]

Options POSIX : [−kP] [−−]

Options GNU (versions courtes) : [−ahikmPv] [−t type_fs] [−x type_fs] [−−print−type] [−−no−sync] [−−sync] [−−help] [−−version] [−−]

df indique les quantités d’espaces disques utilisées et disponibles sur les systèmes de fichiers.

Sans argument, df indiquera les quantités correspondant à tous les systèmes de fichiers montés, quelques soient leurs types. Sinon, df affichera les données correspondant aux systèmes contenant chaque fichier fournit en argument.

Les valeurs sont indiquées en unités de 512 octets par défaut, mais si l’option −k est utilisée, l’unité est 1024 octets. Le format de sortie n’est pas défini si l’option −P n’est pas utilisée. Si le fichier n’est pas un fichier régulier, un répertoire, ou une FIFO, le résultat est imprévisible.

Les valeurs sont fournies en unités de 1024 octets par défaut, sauf si la variable d’environnement POSIXLY_CORRECT existe, auquel cas le comportement POSIX est adopté.

Si un fichier indiqué en argument est un périphérique disque contenant un système de fichiers monté, df affichera l’espace disponible sur ce système de fichiers plutôt que sur celui contenant le noeud du périphérique.

−k

Utiliser des unités de 1024 octets plutôt que les unités de 512 octets par défaut.

−P

Affichage sur six colonnes, précédées de l’en-tête ‘Filesystem N-blocks Used Available Capacity Mounted on’ (avec N=512, ou N=1024 si l’option −k est utilisée).

−−

Fin explicite de la liste des options.

−a, −−all

Inclure dans le listing les systèmes de fichiers ayant une taille de 0 blocs, et qui sont omis par défaut. Il s’agit typiquement de pseudo-systèmes de fichiers particuliers comme les entrées d’un auto-monteur. De même les systèmes de type "ignore" ou "auto" utilisés par certains systèmes d’exploitation ne sont inclus qu’avec cette option.

−h, −−human-readable

Ajouter à chaque valeur une lettre comme M pour Méga-octet, afin d’améliorer la lisibilité.

−i, −−inodes

Afficher les informations sur l’utilisation des i-noeuds plutôt que les blocs. Un i-noeud (noeud d’index) contient des informations sur un fichier comme son propriétaire, ses dates d’accès et sa position sur le disque.

−k, −−kilobytes

Afficher les valeurs avec des unités de 1024 octets.

−m, −−megabytes

Afficher les valeurs avec des unités de 1 048 576 octets (un méga-octet).

−−no-sync

Ne pas invoquer l’appel système sync avant d’obtenir les informations sur l’utilisation du disque. Ceci peut permettre à df de s’exécuter sensiblement plus vite, mais sur certains systèmes (notamment SunOS) les résultats peuvent être fortement dépassés. Il s’agit du comportement par défaut.

−P, −−portability

Utiliser le format d’affichage POSIX. Par rapport à l’affichage par défaut, les informations sur un système de fichiers sont toujours affichées sur une ligne exactement. Ceci signifie que si un système de fichiers monté a plus de 20 caractères de long (par exemple un montage à travers le réseau), les colonnes sont mal alignées.

−−sync

Invoquer l’appel système sync avant d’obtenir les informations sur l’utilisation du disque. Sur certains systèmes (notamment SunOS) ceci fournit des résultats beaucoup plus à jour, mais df s’exécute parfois beaucoup plus lentement, surtout si des systèmes de fichiers sont très utilisés.

−t type, −−type=type

Limiter la liste aux systèmes de fichiers du type indiqué. On peut fournir plusieurs types de systèmes en utilisant plusieurs options −t. Par défaut, rien n’est omis.

−T, −−print−type

Afficher le type de chaque système de fichiers. Les types affichés sont indiqués par le système (de manière spécifique, par exemple en lisant /etc/mtab). Voir également mount(8).

−x type, −−exclude−type=type

Limiter l’affichage aux systèmes n’ayant PAS le type indiqué. Plusieurs types de systèmes de fichiers peuvent être éliminés en utilisant plusieurs options −x. Par défaut, rien n’est omis.

−v

Ignoré. Pour compatibilité avec System V. df.

−−help

Afficher un message d’aide sur la sortie standard, et se terminer correctement.

−−version

Afficher un numéro de version sur la sortie standard, et se terminer correctement.

−−

Fin de la liste d’options.

La variable POSIXLY_CORRECT détermine le choix des unités. Si elle n’existe pas, et si la variable BLOCKSIZE a une valeur commençant par HUMAN alors, le comportement est celui de l’option −h (à moins qu’il soit surchargé par une option −k ou −m). Les variables LANG, LC_ALL, LC_CTYPE et LC_MESSAGES ont leurs significations habituelles.

POSIX 1003.2

mount(8)

Cette page décrit la version de df se trouvant dans le paquetage fileutils-3.16. D’autres versions peuvent différer légèrement. Envoyez les corrections concernant cette page de manuel (en anglais) à aeb@cwi.nl, aw@mail1.bet1.puv.fi, et ragnar@lightside.ddns.org, et (en français) à ccb@club-internet.fr. Signalez les bogues dans le programme à fileutils-bugs@gnu.ai.mit.edu.

Christophe Blaess, 1998.