Provided by:
manpages-fr-extra_20111118_all 
NOM
debugfs - Debogueur pour systemes de fichiers ext2/ext3/ext4
SYNOPSIS
debugfs [ -DVwci ] [ -b taille_bloc ] [ -s superbloc ] [ -f
fichier_commande ] [ -R requete ] [ -d peripherique_source ] [
peripherique ]
DESCRIPTION
Le programme debugfs est un debogueur interactif de systeme de
fichiers. Il peut servir a examiner et changer l'etat d'un systeme de
fichiers ext2, ext3 ou ext4.
p'eriph'erique est un fichier special correspondant au peripherique
contenant le systeme de fichiers (par exemple /dev/hdXX).
OPTIONS
-w Indiquer que le systeme de fichiers doit etre ouvert en
lecture-ecriture. Sans cette option, le systeme de fichiers est
ouvert en lecture seule.
-c Indiquer que le systeme de fichiers doit etre ouvert en mode
catastrophe, ce qui fait que les tables d'inoeuds et de groupes
ne sont pas lu au depart. Cela peut etre utile pour les systeme
de fichiers fortement corrompus, mais de ce fait, le mode
catastrophe force l'ouverture en mode lecture seule du systeme
de fichiers.
-i Indiquer que p'eriph'erique represente un fichier image ext2 cree
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 inoeuds et la table des
inoeuds, beaucoup de commande de debugfs ne fonctionneront pas
correctement. Attention : aucune verification n'est effectuee et
debugfs peut echouer de differentes facons si les commandes
comme ls, dump, etc. sont utilisees sans indiquer le
p'eriph'erique_source en utilisant l'option -d. debugfs est un
outil de debogage. Il est fourni brut de fonderie !
-d p'eriph'erique_source
Utilise avec l'option -i, cette option permet d'indiquer qu'un
p'eriph'erique_source doit etre utilise pour la lecture des blocs
qui ne se trouvent pas dans le fichier image ext2. Cela inclut
les donnees, les repertoires et les blocs indirects.
-b taille_bloc
Forcer l'utilisation pour le systeme de fichiers de la taille de
bloc donnee, plutot que de la detecter comme c'est fait
normalement.
-s superbloc
Le superbloc du systeme de fichiers sera lu a partir du bloc
dont le numero est donne, au lieu d'utiliser le superbloc
primaire (situe 1024 octets apres le debut du systeme de
fichiers). Si vous utilisez l'option -s, vous devez egalement
fournir la taille des blocs du systeme de fichiers avec l'option
-b.
-f fichier_commande
debugfs lira les commandes dans le fichier fichier_commande et
les executera. Quand debugfs a fini d'executer les commandes, il
se termine.
-D debugfs ouvrira le peripherique en utilisant les entrees/sorties
directes (<< Direct I/O >>), outre-passant le cache de fichiers.
Notez que certains peripheriques Linux, comme a l'heure actuelle
device mapper, ne prennent pas en charge les entrees/sorties
directes.
-R requ^ete
Forcer debugfs a n'executer que la requ^ete puis quitter.
-V Afficher le numero de version de debugfs et quitter.
INDIQUER DES FICHIERS
Beaucoup de commandes de debugfs prennent un parametre filespec pour
indiquer un inoeud (par opposition a un chemin) dans le systeme de
fichiers qui est actuellement ouvert par debugfs. Le parametre filespec
peut etre indique de deux facons. La premiere est un numero d'inoeud
entre des signes inferieur et superieur, par exemple <2>. La seconde
est un chemin ; si le chemin commence par une barre oblique (<< / >>),
alors il est interprete relativement a la racine du systeme de fichiers
qui est ouvert par debugfs. Sinon, le chemin est interprete
relativement au repertoire de travail maintenu par debugfs, qui peut
etre modifie a l'aide de la commande cd de debugfs.
COMMANDES
Voici une liste de commandes acceptees par debugfs :
blocks filespace
Afficher le contenu de l'inoeud filespec sur la sortie standard.
bmap filespec bloc_logique
Afficher le numero de bloc physique correspondant au numero de
bloc logique bloc_logique de l'inoeud filespec.
cat filespec
Afficher le contenu de l'inoeud filespec sur la sortie standard.
cd filespec
Utiliser filespec comme repertoire de travail.
chroot filespec
Changer le repertoire racine et utiliser filespec a la place.
close [-a]
Fermer le systeme de fichiers actuellement ouvert. Si l'option
-a est indiquee, ecrire toute modification du superbloc et des
descripteurs de groupes de blocs dans tous les superbloc de
sauvegarde, et non pas seulement dans le superbloc maitre.
clri fichier
Effacer le contenu de l'inoeud fichier.
dirsearch filespec fichier
Chercher fichier dans le repertoire filespec.
dump [-p] filespec fichier_sortie
Fournir le contenu de l'inoeud filespec dans le fichier de
sortie fichier_sortie. Avec l'option -p, le proprietaire, le
groupe et les informations de permission de fichier_sortie
correspondront a ceux de filespec.
dx_hash [-h hash_alg] [-s hash_graine] fichier
Calculer le hachage du repertoire du fichier. Le nom de
l'algorithme de hachage precise par -h peut prendre l'une des
valeurs << legacy >>, << half_md4 >> ou << tea >>. La graine de
hachage precisee avec l'option -s doit etre au format UUID.
dump_extents [-n] [-l] filespec
Afficher l'arbre d'extents de l'inoeud filespec. Avec l'option
-n, dump_extents n'affichera que les noeuds 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 noeud interne est une estimation des
fonctions de la bibliotheque des extents et n'est pas stocke
dans les structures de donnees du systeme de fichiers. Ainsi,
les valeurs affichees peuvent ne pas etre precises et
n'indiquent pas de probleme ou de corruption du systeme de
fichiers.
expand_dir filespec
Developper le repertoire filespec.
feature [caract'eristique_sf] [-caract'eristique_sf] ...
Activer ou desactiver differentes caracteristiques d'un systeme
de fichiers dans son superbloc. Apres avoir active ou desactive
une caracteristique, afficher l'etat actuel de l'ensemble des
caracteristiques du systeme de fichiers.
find_free_block [compte [objectif]]
Trouver le premier morceau d'espace libre de compte blocs, en
commencant par objectif et l'allouer.
find_free_inode [rep [mode]]
Trouver un inoeud libre et l'allouer. S'il est present, rep
indique le numero d'inoeud du repertoire dans lequel l'inoeud
doit etre place. Le deuxieme parametre optionnel mode indique
les permissions du nouvel inoeud. (Si le bit indiquant un
repertoire est positionne dans le mode, la routine d'allocation
fonctionnera differemment).
freeb bloc [compte]
Marquer le bloc numero bloc comme non alloue. Si le parametre
optionnel compte est present, alors compte blocs, a partir du
bloc numero bloc seront marque comme non alloues.
freei filespec
Liberer l'inoeud indique par filespec.
help Afficher une liste des commandes comprises par debugfs.
htree_dump filespec
Decharger le repertoire indexe par hachage filespec, en montrant
sa structure d'arbre.
icheck bloc ...
Afficher une liste des inoeuds qui utilisent au moins un des
blocs fournis sur la ligne de commande.
imap filespec
Afficher l'emplacement de la structure de donnees de l'inoeud
filespec (dans la table des inoeuds).
init_filesys p'eriph'erique taille_bloc
Creer un systeme de fichier ext2 sur le p'eriph'erique avec une
taille de bloc de taille_bloc. Notez que cela n'initialise pas
completement toutes les structures de donnees ; pour cela,
utilisez mke2fs(8). Il ne s'agit que d'un appel a la
bibliotheque bas niveau qui definit le superbloc et les
descripteurs blocs.
kill_file filespec
Desallouer l'inoeud filespec et ses blocs. Notez que cela ne
supprime aucune entree de repertoire (s'il y en a) dans cette
inoeud. Voir la commande rm(1) si vous souhaitez supprimer un
fichier.
lcd r'epertoire
Changer le repertoire de travail du processus debugfs pour
directory sur le systeme de fichiers natif.
ln filespec fichier_dest
Creer un lien nomme fichier_dest vers filespec. Notez que ca
n'ajuste pas le compteur de reference de l'inoeud.
logdump [-acs] [-b<bloc>] [-i<filespec>] [-f<fichier_journal>]
[fichier_sortie]
Supprimer le contenu du journal d'un systeme ext3. Par defaut,
l'inoeud du journal est indique dans le superbloc. Cependant, on
peut le redefinir via l'option -i qui accepte un pointeur
d'inoeud pour preciser le journal a utiliser. Un fichier
contenant le journal peut etre pointe par l'option -f. Enfin,
l'option -s utilise l'information sauvegardee sur le superbloc
pour localiser le journal.
L'option -a force le programme logdump a afficher le contenu de
tous les descripteurs de bloc. L'option -b fait apparaitre
toutes les entrees du journal qui referencent le bloc indique.
L'option -c affichera le contenu des blocs de donnees
selectionnes par l'option -a et -b.
ls [-l] [-d] [-p] filespec
Afficher la liste des fichiers dans le repertoire filespec.
L'option -l listera les entrees en mode bavard. L'option -d
affichera les fichiers supprimes, -p rendra la sortie plus
facilement exploitable par des scripts, et en meme temps gerera
les espaces et autres caracteres non imprimables en fin de noms
de fichiers.
modify_inode filespec
Modifier le contenu de la structure de donnees de l'inoeud
filespec.
mkdir filespec
Creer un repertoire.
mknod filespec [p|[[c|b] majeur mineur]]
Creer un fichier de peripherique special (tuyau nomme, caractere
ou peripherique de bloc). Si un caractere ou un peripherique de
bloc doit etre cree, il faut preciser les nombres majeur et
mineur.
ncheck num_inode ...
A partir d'une liste de numero d'inoeud, afficher une liste de
chemin vers ces inoeuds.
open [-w] [-e] [-f] [-i] [-c] [-D] [-b taille_bloc] [-s superbloc]
p'eriph'erique
Ouvrir un systeme de fichier en mode edition. L'option -f force
l'ouverture, meme s'il y a des caracteristiques inconnues ou
incompatibles qui empechent normalement le systeme d'etre ouvert
en mode exclusif. Les options -b, -c, -i, -s, -w et -D
fonctionnent comme celles de debugfs.
punch filespec bloc_d'ebut [bloc_fin]
Effacer les blocs de l'inoeud dans l'intervalle entre bloc_d'ebut
et bloc_fin. Si bloc_fin est omis, la commande fonctionnera
comme la commande truncate : tous les blocs depuis bloc_d'ebut
jusqu'a la fin du fichier seront desalloues.
pwd Afficher le repertoire de travail en cours.
quit Quitter debugfs.
rdump r'epertoire destination
Envoyer recursivement le r'epertoire et tout son contenu (y
compris les fichiers normaux, les liens symboliques et les
autres repertoires) dans la destination nommee, qui devrait etre
un repertoire existant sur le systeme de fichier natif.
rm chemin
Defaire le lien chemin. Si cela entraine la fin de toute
reference pour l'inoeud pointe par chemin, desalloue le fichier.
Cette command fonctionne comme l'appel systeme unlink().
rmdir filespec
Supprimer le repertoire filespec.
setb bloc [compte]
Marquer le bloc numero bloc comme alloue. Si l'argument
optionnel compte est present, alors les compte blocs a partir du
bloc numero bloc seront marques comme alloues.
set_block_group num_groupe champ valeur
Modifier le descripteur du bloc de groupe indique par num_groupe
pour que le champ du descripteur de groupe champ prenne la
valeur valeur.
seti filespec
Marquer l'inoeud filespec comme utilise dans la table des
inoeuds.
set_inode_field filespec champ valeur
Modifier l'inoeud pointe par filespec pour que l'inoeud champ
prenne la valeur valeur. La liste des champs inoeuds qui peuvent
etre configures via cette commande peut etre obtenue par la
commande : set_inode_field -l.
set_super_value champ valeur
Donner la valeur valeur au champ champ du superbloc. La liste
des champs du superbloc qui peuvent etre configures via cette
commande peut etre affichee avec la commande : set_super_value
-l.
show_super_stats [-h]
Lister le contenu du superbloc et les descripteurs du groupe de
blocs. Si l'argument -h est passe, seul le contenu du superbloc
sera affiche.
stat filespec
Afficher le contenu de la structure de l'inoeud filespec.
testb bloc [compte]
Regarder si le bloc numero block est marque comme alloue dans le
bloc bitmap. Si l'argument optionnel compte est fourni, alors
les compte blocs a partir du bloc numero block seront testes.
testi filespec
Tester si l'inoeud filespec est marque comme alloue dans la
table des inoeuds.
undel <num'ero_inoeud> [chemin]
Annuler la suppression du numero d'inoeud (qui doit etre entoure
de crochets) de maniere a ce que l'inoeud et son bloc soient
marques << en cours d'utilisation >>, et peut aussi lier
l'inoeud recupere au chemin indique. On devrait toujours lancer
la commande e2fsck apres avoir utilise undel pour recuperer des
fichiers.
Remarque : si vous recuperez un grand nombre de fichiers
supprimes, il est possible que lier l'inoeud a un repertoire
entraine l'augmentation de taille dudit repertoire, qui peut
occuper des inoeuds encore a recuperer. Il est donc plus sur de
recuperer les inoeuds sans preciser un repertoire de
destination, et ensuite, dans un repertoire precis, utiliser
l'argument link de debugfs pour lier les inoeuds au repertoire
de destination, ou d'utiliser e2fsck pour verifier le systeme de
fichiers et de lier tous les inoeuds recuperes au repertoire
lost+found.
unlink chemin
Supprimer le lien indique chemin pour un inoeud. Notez que cela
n'ajuste pas le compteur de references de l'inoeud.
write fichier_source fichier_sortie
Creer un fichier fichier_sortie dans le systeme de fichiers et
copier le contenu de fichier_source dans le fichier destination.
VARIABLES D'ENVIRONNEMENT
DEBUGFS_PAGER, PAGER
Le programme debugfs affiche toujours les resultats des
commandes show_super_stats, list_directory, show_inode_info,
list_deleted_inodes et htree_dump dans un afficheur de texte. On
peut indiquer explicitement lequel sera utilise via la variable
DEBUGFS_PAGER, et, si celle-ci est vide, par la variable PAGER.
Remarque : comme un afficheur de texte est toujours utilise,
l'afficheur de texte less(1) n'est pas particulierement adapte,
car il efface l'ecran quand on le quitte. De nombreux
utilisateurs preferent utiliser less(1) pour la plupart des cas,
c'est pourquoi la variable DEBUGFS_PAGER existe en plus de
PAGER.
AUTEUR
debugfs a ete ecrit par Theodore Ts'o <tytso@mit.edu>.
VOIR AUSSI
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.