Provided by: manpages-fr-extra_20151231_all 
NOM
debugfs - Débogueur pour systèmes de fichiers ext2/ext3/ext4
SYNOPSIS
debugfs [ -DVwci ] [ -b taille_bloc ] [ -s superbloc ] [ -f fichier_commande ] [ -R
requête ] [ -d périphérique_source ] [ périphérique ]
DESCRIPTION
Le programme debugfs est un débogueur interactif de système de fichiers. Il peut servir à
examiner et changer l'état d'un système de fichiers ext2, ext3 ou ext4.
périphérique est un fichier spécial correspondant au périphérique contenant le système de
fichiers (par exemple /dev/hdXX).
OPTIONS
-w Indiquer que le système de fichiers doit être ouvert en lecture-écriture. Sans
cette option, le système de fichiers est ouvert en lecture seule.
-c Indiquer que le système de fichiers doit être ouvert en mode catastrophe, ce qui
fait que les tables d'inœuds et de groupes ne sont pas lues au départ. Cela peut
être utile pour les systèmes de fichiers fortement corrompus, mais de ce fait, le
mode catastrophe force l'ouverture en mode lecture seule du système de fichiers.
-i Indiquer que périphérique représente un fichier image ext2 créé par le programme
e2image. Puisque le fichier image ext2 ne contient que le superbloc, le descripteur
des groupes de blocs, les tables d'allocation des blocs et inœuds et la table des
inœuds, beaucoup de commandes de debugfs ne fonctionneront pas correctement.
Attention : aucune vérification n'est effectuée et debugfs peut échouer de
différentes façons si les commandes comme ls, dump, etc. sont utilisées sans
indiquer le périphérique_source en utilisant l'option -d. debugfs est un outil de
débogage. Il est fourni brut de fonderie !
-d périphérique_source
Utilisée avec l'option -i, cette option permet d'indiquer qu'un périphérique_source
doit être utilisé pour la lecture des blocs qui ne se trouvent pas dans le fichier
image ext2. Cela inclut les données, les répertoires et les blocs indirects.
-b taille_bloc
Forcer l'utilisation pour le système de fichiers de la taille de bloc donnée,
plutôt que de la détecter comme c'est fait normalement.
-s superbloc
Le superbloc du système de fichiers sera lu à partir du bloc dont le numéro est
donné, au lieu d'utiliser le superbloc primaire (situé 1024 octets après le début
du système de fichiers). Si vous utilisez l'option -s, vous devez également fournir
la taille des blocs du système de fichiers avec l'option -b.
-f fichier_commande
debugfs lira les commandes dans le fichier fichier_commande et les exécutera. Quand
debugfs a fini d'exécuter les commandes, il se termine.
-D debugfs ouvrira le périphérique en utilisant les entrées/sorties directes (« Direct
I/O »), outrepassant le cache de fichiers. Notez que certains périphériques Linux,
comme à l'heure actuelle device mapper, ne prennent pas en charge les
entrées/sorties directes.
-R requête
Forcer debugfs à n'exécuter que la requête puis quitter.
-V Afficher le numéro de version de debugfs et quitter.
INDIQUER DES FICHIERS
Beaucoup de commandes de debugfs prennent un paramètre filespec pour indiquer un inœud
(par opposition à un chemin) dans le système de fichiers qui est actuellement ouvert par
debugfs. Le paramètre filespec peut être indiqué de deux façons. La première est un numéro
d'inœud entre des signes inférieur et supérieur, par exemple <2>. La seconde est un
chemin ; si le chemin commence par une barre oblique (« / »), alors il est interprété
relativement à la racine du système de fichiers qui est ouvert par debugfs. Sinon, le
chemin est interprété relativement au répertoire de travail maintenu par debugfs, qui peut
être modifié à l'aide de la commande cd de debugfs.
COMMANDES
Voici une liste de commandes acceptées par debugfs :
blocks filespec
Afficher les blocs utilisés par l'inœud filespec sur la sortie standard.
bmap filespec bloc_logique
Afficher le numéro de bloc physique correspondant au numéro de bloc logique
bloc_logique de l'inœud filespec.
block_dump [-f filespec] num_bloc
Afficher le bloc du système de fichiers indiqué par num_bloc sur la console aux
formats hexadécimal et ASCII. Si l'option -f est indiquée, le numéro de bloc est
relatif au début de l'inœud filespec donné.
cat filespec
Afficher le contenu de l'inœud filespec sur la sortie standard.
cd filespec
Utiliser filespec comme répertoire de travail.
chroot filespec
Changer le répertoire racine et utiliser filespec à la place.
close [-a]
Fermer le système de fichiers actuellement ouvert. Si l'option -a est indiquée,
écrire toute modification du superbloc et des descripteurs de groupes de blocs dans
tous les superbloc de sauvegarde, et non pas seulement dans le superbloc maître.
clri filespec
Effacer le contenu de l'inœud filespec.
dirsearch filespec fichier
Chercher fichier dans le répertoire filespec.
dirty Marquer le système de fichiers comme sale (« dirty »), de sorte que les superblocs
seront écrits à la sortie.
dump [-p] filespec fichier_sortie
Fournir le contenu de l'inœud filespec dans le fichier de sortie fichier_sortie.
Avec l'option -p, le propriétaire, le groupe et les informations de permission de
fichier_sortie correspondront à ceux de filespec.
dump_mmp
Afficher les valeurs des champs de protection contre le montage multiple (mmp).
dx_hash [-h hash_alg] [-s hash_graine] fichier
Calculer le hachage du répertoire du fichier. Le nom de l'algorithme de hachage
précisé par -h peut prendre l'une des valeurs legacy, half_md4 ou tea. La graine de
hachage précisée avec l'option -s doit être au format UUID.
dump_extents [-n] [-l] filespec
Afficher l'arbre d'extents de l'inœud filespec. Avec l'option -n, dump_extents
n'affichera que les nœuds internes dans l'arbre d'extents. Avec l'option -l,
dump_extents n'affichera que les feuilles de l'arbre d'extents.
(Veuillez noter que la longueur et l'intervalle des blocs du dernier extent d'un
nœud interne est une estimation des fonctions de la bibliothèque des extents ; ils
ne sont pas stockés dans les structures de données du système de fichiers. Ainsi,
les valeurs affichées peuvent ne pas être précises et n'indiquent pas de problème
ou de corruption du système de fichiers.)
expand_dir filespec
Développer le répertoire filespec.
feature [fonctionnalité_sf] [-fonctionnalité_sf] ...
Activer ou désactiver différentes fonctionnalités d'un système de fichiers dans son
superbloc. Après avoir activé ou désactivé une fonctionnalité, afficher l'état
actuel de l'ensemble des fonctionnalités du système de fichiers.
filefrag [-d] [-v] [-r] filespec
Afficher le nombre d'extents contigus dans filespec. Si filespec est un répertoire
et que l'option -d n'est pas indiquée, filefrag affichera le nombre d'extents
contigus pour chaque fichier du répertoire. Avec l'option -v, filefrag affichera
sous forme de tableau la liste des extents contigus du fichier. Avec l'option -r,
filefrag sera exécuté récursivement sur les éléments du répertoire.
find_free_block [compte [objectif]]
Trouver le premier morceau d'espace libre de compte blocs, en commençant par
objectif et l'allouer. Aussi disponible sous le nom ffb.
find_free_inode [rep [mode]]
Trouver un inœud libre et l'allouer. S'il est présent, rep indique le numéro
d'inœud du répertoire dans lequel l'inœud doit être placé. Le deuxième paramètre
optionnel mode indique les permissions du nouvel inœud. (Si le bit indiquant un
répertoire est positionné dans le mode, la routine d'allocation fonctionnera
différemment). Aussi disponible sous le nom ffi.
freeb bloc [compte]
Marquer le bloc numéro bloc comme non alloué. Si le paramètre optionnel compte est
présent, alors compte blocs, à partir du bloc numéro bloc seront marqués comme non
alloués.
e2freefrag [-c morceau_ko]
Faire un rapport de la fragmentation de l'espace libre sur le système de fichiers
actuellement ouvert. Si une taille de morceau est fournie avec l'option -c, alors
filefrag affichera le nombre de morceaux de taille morceau_ko disponibles dans le
système de fichiers. La taille des morceaux morceau_ko, en kilooctets, doit être
une puissance de deux et doit être supérieure à la taille des blocs du système de
fichiers.
freei filespec [num]
Libérer l'inœud indiqué par filespec. Si num est indiqué, libérer aussi les num-1
inœuds qui suivent celui qui a été précisé.
help Afficher une liste des commandes comprises par debugfs.
htree_dump filespec
Décharger le répertoire indexé par hachage filespec, en montrant sa structure
d'arbre.
icheck bloc ...
Afficher une liste des inœuds qui utilisent au moins un des blocs fournis sur la
ligne de commande.
inode_dump filespec
Afficher le contenu de la structure de données de l'inœud aux formats hexadécimal
et ASCII.
imap filespec
Afficher l'emplacement de la structure de données de l'inœud filespec (dans la
table des inœuds).
init_filesys périphérique taille_bloc
Créer un système de fichiers ext2 sur le périphérique avec une taille de bloc de
taille_bloc. Notez que cela n'initialise pas complètement toutes les structures de
données ; pour cela, utilisez mke2fs(8). Il ne s'agit que d'un appel à la
bibliothèque bas niveau qui définit le superbloc et les descripteurs blocs.
kill_file filespec
Désallouer l'inœud filespec et ses blocs. Notez que cela ne supprime aucune entrée
de répertoire (s'il y en a) dans cet inœud. Voir la commande rm(1) si vous
souhaitez supprimer un fichier.
lcd directory
Changer le répertoire de travail du processus debugfs pour directory sur le système
de fichiers natif.
ln filespec dest_file
Créer un lien dur nommé fichier_dest vers filespec. Notez que ça n'ajuste pas le
compteur de référence de l'inœud.
logdump [-a] [-c] [-s] [-b bloc] [-i filespec] [-f fichier_journal] [fichier_sortie]
Décharger le contenu du journal d'un système ext3. Par défaut, décharger l'inœud du
journal qui est indiqué dans le superbloc. Cependant, on peut le redéfinir via
l'option -i qui décharge le journal de l'inœud interne indiqué par filespec. Un
fichier standard contenant le journal peut être pointé par l'option -f. Enfin,
l'option -s utilise l'information de sauvegarde sur le superbloc pour localiser le
journal.
L'option -a force le programme logdump à afficher le contenu de tous les
descripteurs de bloc. L'option -b fait apparaître toutes les entrées du journal qui
référencent le bloc indiqué. L'option -c affichera le contenu des blocs de données
sélectionnés par l'option -a et -b.
ls [-d] [-l] [-p] filespec
Afficher la liste des fichiers dans le répertoire filespec. L'option -d affichera
les fichiers supprimés. L'option -l affichera les entrées en mode bavard. -p rendra
la sortie plus facilement exploitable par des scripts, et en même temps prendra en
charge les espaces et autres caractères non imprimables en fin de noms de fichiers.
list_deleted_inodes [nb_secondes]
Dresser la liste des inœuds supprimés, éventuellement limitée à ceux supprimés dans
les nb_secondes dernières secondes. Aussi disponible sous le nom isdel.
Cette commande était utile pour la récupération après un effacement accidentel de
fichiers sur des systèmes de fichiers ext2. Malheureusement, on ne peut pas s'en
servir dans ce but sur des systèmes de fichiers ext3 ou ext4, puisque les blocs de
données d'un inœud ne sont plus disponibles une fois que l'inœud a été libéré.
modify_inode filespec
Modifier le contenu de la structure de données de l'inœud filespec. Aussi
disponible sous le nom mi
mkdir filespec
Créer un répertoire.
mknod filespec [p|[[c|b] majeur mineur]]
Créer un fichier de périphérique spécial (tuyau nommé, caractère ou périphérique de
bloc). Si un caractère ou un périphérique de bloc doit être créé, il faut préciser
les nombres majeur et mineur.
ncheck [-c] num_inode ...
À partir d'une liste de numéros d'inœuds, afficher une liste de chemins vers ces
inœuds. L'option -c activera la vérification des renseignements de type de fichier
dans l'entrée du répertoire pour s'assurer qu'il correspond au type d'inœud.
open [-w] [-e] [-f] [-i] [-c] [-D] [-b taille_bloc] [-s superbloc] périphérique
Ouvrir un système de fichiers en mode édition. L'option -f force l'ouverture, même
s'il y a des fonctionnalités inconnues ou incompatibles qui empêchent normalement
le système d'être ouvert en mode exclusif. Les options -b, -c, -i, -s, -w et -D
fonctionnent comme celles de debugfs.
punch filespec bloc_début [bloc_fin]
Effacer les blocs de l'inœud dans l'intervalle entre bloc_début et bloc_fin. Si
bloc_fin est omis, la commande fonctionnera comme la commande truncate : tous les
blocs depuis bloc_début jusqu'à la fin du fichier seront désalloués.
symlink filespec cible
Créer un lien symbolique.
pwd Afficher le répertoire de travail en cours.
quit Quitter debugfs.
rdump répertoire [...] destination
Envoyer récursivement le ou les répertoires et tout leur contenu (y compris les
fichiers normaux, les liens symboliques et les autres répertoires) dans la
destination nommée, qui devrait être un répertoire existant sur le système de
fichiers natif.
rm chemin
Défaire le lien chemin. Si cela entraîne la fin de toute référence pour l'inœud
pointé par chemin, désalloue le fichier. Cette command fonctionne comme l'appel
système unlink().
rmdir filespec
Supprimer le répertoire filespec.
setb bloc [compte]
Marquer le bloc numéro bloc comme alloué. Si l'argument optionnel compte est
présent, alors les compte blocs à partir du bloc numéro bloc seront marqués comme
alloués.
set_block_group num_groupe champ valeur
Modifier le descripteur du bloc de groupe indiqué par num_groupe pour que le champ
du descripteur de groupe champ prenne la valeur valeur. Aussi disponible sous le
nom set_bg.
seti filespec [num]
Marquer l'inœud filespec comme utilisé dans la table des inœuds. Si num est
indiqué, marquer de la même façon les num-1 inœuds qui suivent celui qui a été
précisé.
set_inode_field filespec champ valeur
Modifier l'inœud pointé par filespec pour que l'inœud champ prenne la valeur
valeur. La liste des champs inœuds qui peuvent être configurés via cette commande
peut être obtenue par la commande : set_inode_field -l. Aussi disponible sous le
nom sif.
set_mmp_value champ valeur
Modifier les données de protection contre le montage multiple (MMP) pour que le
champ MMP champ prenne la valeur valeur. La liste des champs MMP qui peuvent être
configurés au moyen de cette commande peut être obtenue par la commande :
set_mmp_value -l. Aussi disponible sous le nom smmp.
set_super_value champ valeur
Donner la valeur valeur au champ champ du superbloc. La liste des champs du
superbloc qui peuvent être configurés via cette commande peut être affichée avec la
commande : set_super_value -l. Aussi disponible sous le nom ssv.
show_super_stats [-h]
Lister le contenu du superbloc et les descripteurs du groupe de blocs. Si
l'argument -h est passé, seul le contenu du superbloc sera affiché. Disponible
aussi sous le nom stats.
stat filespec
Afficher le contenu de la structure de l'inœud filespec.
testb bloc [compte]
Regarder si le bloc numéro bloc est marqué comme alloué dans le bloc bitmap. Si
l'argument optionnel compte est fourni, alors les compte blocs à partir du bloc
numéro bloc seront testés.
testi filespec
Tester si l'inœud filespec est marqué comme alloué dans la table des inœuds.
undel numéro_inœud [chemin]
Annuler la suppression du numéro d'inœud (qui doit être entouré de crochets) de
manière à ce que l'inœud et ses blocs soient marqués « en cours d'utilisation », et
peut aussi lier l'inœud récupéré au chemin indiqué. On devrait toujours lancer la
commande e2fsck après avoir utilisé undel pour récupérer des fichiers.
Remarque : si vous récupérez un grand nombre de fichiers supprimés, il est possible
que lier l'inœud à un répertoire entraîne l'augmentation de taille dudit
répertoire, qui peut occuper des inœuds encore à récupérer. Il est donc plus sûr de
récupérer les inœuds sans préciser un répertoire de destination, et ensuite, dans
un répertoire précis, utiliser l'argument link de debugfs pour lier les inœuds au
répertoire de destination, ou d'utiliser e2fsck pour vérifier le système de
fichiers et de lier tous les inœuds récupérés au répertoire lost+found.
unlink chemin
Supprimer le lien indiqué chemin pour un inœud. Notez que cela n'ajuste pas le
compteur de références de l'inœud.
write fichier_source fichier_sortie
Copier le contenu du fichier_source dans le fichier nommé fichier_sortie
nouvellement créé dans le système de fichiers.
zap_block [-f filespec] [-o position] [-l longueur] [-p motif] num_bloc
Réécrire par dessus les blocs indiqués par
num_bloc avec des octets zéro (NUL), ou si l'option -p est indiquée, utiliser
l'octet précisé par le motif. Si -f est indiqué, alors le numéro de bloc num_bloc
est relatif au début du fichier donné par filespec. Les options -o et -l limitent
les octets à réécrire au domaine caractérisé par la position et la longueur
relatifs au début du bloc.
zap_block [-f filespec] [-b bit] num_bloc
Basculer les bits de portions d'un bloc num_bloc. Si l'option -f est indiquée,
alors num_bloc est un bloc logique relatif au début de filespec.
VARIABLES D'ENVIRONNEMENT
DEBUGFS_PAGER, PAGER
Le programme debugfs affiche toujours les résultats des commandes show_super_stats
(stats), list_directory (ls), show_inode_info (stat), list_deleted_inodes (lsdel)
et htree_dump dans un afficheur de texte. Celui utilisé peut être explicitement
indiqué par la variable d’environnement DEBUGFS_PAGER et, si celle-ci est vide, par
la variable PAGER.
Remarque : comme un afficheur de texte est toujours utilisé, l'afficheur de texte
less(1) n'est pas particulièrement adapté, car il efface l'écran quand on le
quitte. De nombreux utilisateurs préfèrent utiliser less(1) pour la plupart des
cas, c'est pourquoi la variable DEBUGFS_PAGER existe en plus de PAGER.
AUTEUR
debugfs a été écrit par Theodore Ts'o <tytso@mit.edu>.
VOIR AUSSI
ext4(5), dumpe2fs(8), tune2fs(8), e2fsck(8), mke2fs(8)
TRADUCTION
La traduction de cette page de manuel est maintenue par les membres de la liste
<debian-l10n-french AT lists DOT debian DOT org>. Veuillez signaler toute erreur de
traduction par un rapport de bogue sur le paquet manpages-fr-extra.