NOM
debugfs - Débogueur pour systèmes de fichiers ext2/ext3/ext4.
SYNOPSIS
debugfs [ -Vwci ] [ -b taille_bloc ] [ -s superbloc ] [ -f
fichier_commande ] [ -R requête ] [ -d périphérique_source ] [
périphérique ]
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.
priphrique est un fichier spécial correspondant au périphérique
contenant le système de fichiers (par exemple /dev/hdXX).
OPTIONS
-w Spécifier 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 Spécifier que le système de fichiers doit être ouvert en mode
catastrophe, ce qui fait que les tables d’inoeuds et de groupes
ne sont pas lu au départ. Ceci peut être utile pour les système
de fichiers fortement corrompus, mais de ce fait, le mode
catastrophe force l’ouverture en mode lecture seule du système
de fichiers.
-i Spécifier que priphrique représente un fichier image ext2 créé
par le programme e2image. Puisque le fichier image ext2 ne
contient que le superbloc, le descripteur des groups de blocs,
lmes tables d’allocation des blocs et inoeuds et la table des
inoeuds, beaucoup de commande de debugfs ne fonctionneront pas
correctement. Attention : aucune vérification n’est effectuée et
debugfs peut échouer de différentes façon si les commandes comme
ls, dump, etc. sont utilisées sans spécifier le
priphrique_source en utilisant l’option -d. debugfs est un
outil de débogage. Il est fourni brut de fonderie !
-d priphrique_source
Utilisé avec l’option -i, cette option permet de spécifier qu’un
priphrique_source doit être utilisé pour la lecture des blocs
qui ne se trouvent pas dans le fichier image ext2. Ceci 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 commande dans le fichier fichier_commande et
les exécutera. Quand debugfs a fini d’exécuter les commandes, il
se termine.
-R requte
Forcer debugfs à n’exécuter que la requte puis quitter.
-V Afficher le numéro de version de debugfs et quitter.
SPÉCIFIER DES FICHIERS
Beaucoup de commandes de debugfs prennent un paramètre filespec pour
indiquer un inoeud (par opposition à un chemin) dans le système de
fichiers qui est actuellement ouvert par debugfs. Le paramètre filespec
peut être spécifié de deux façons. La première est un numéro d’inoeud
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 gérées par debugfs :
bmap filespec bloc_logique
Afficher le numéro de bloc physique correspondant au numéro de
bloc logique bloc_logique de l’inoeud filespec.
cat filespec
Afficher le contenu de l’inode 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 spécifié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 fichier
Effacer le contenu de l’inoeud fichier.
dump [-p] filespec fichier_sortie
Fournir le contenu de l’inoeud debugfs 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_extents [-n] [-l] filespec
Afficher l’arbre d’extents de l’inoeud filespec. Avec l’option
-n, dump_extents n’affichera que les noeuds interne 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 bibliothèque des extents et n’est pas stocké
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 [caractristique_sf] [-caractristique_sf] ...
Activer ou désactiver différentes caractéristiques d’un système
de fichiers dans son superbloc. Après avoir activé ou désactivé
une caractéristique, afficher l’état actuel de l’ensemble des
caractéristiques du système de fichiers.
find_free_block [compte [objectif]]
Trouver le premier morceau d’espace libre de compte blocs, en
commençant par objectif et l’allouer.
find_free_inode [rep [mode]]
Trouver un inoeud libre et l’allouer. S’il est présent, rep
spécifie le numéro d’inoeud du répertoire dans lequel l’inoeud
doit être placé.Le deuxième paramètre optionnel mode spécifie
les permissions du nouvel inoeud. (Si le bit indiquant un
répertoire est positionné dans le mode, la routine d’allocation
fonctionnera différemment)
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é comme non alloués.
freei filespec
Libérer l’inoeud spécifier par filespec.
help Afficher une liste des commandes comprises par debugfs(8).
icheck bloc ...
Afficher une liste des inoauds qui utilisent au moins un des
blocs fournis sur la ligne de commande.
imap filespec
Afficher l’emplacement de la structure de données de l’inoeud
filespec (dans la table des inoeuds).
init_filesys priphrique taille_bloc
Créer un système de fichier ext2 sur le priphrique avec une
taille de bloc de taille_bloc. Notez que ceci n’initialise pas
complètement toutes les structures de données ; pour ceci,
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’inoeud filespec et ses blocs. Notez que cela ne
supprime aucune entrée de répertoire (s’il y en a) dans cette
inoeud. Voir la commande rm(1) si vous souhaitez supprimer un
fichier.
lcd rpertoire
Changer le répertoire de travail du processus debugfs pour
directory sur le système de fichiers natif.
ln filespec fichier_dest
Créer un lien nommé fichier_dest vers filespec. Notez que ça
n’ajuste pas le compteur de référence de l’inoeud.
logdump [-acs] [-b<bloc>] [-i<filespec>] [-f<fichier_journal>]
[fichier_sortie]
Dump the contents of the ext3 journal. By default, the journal
inode as specified in the superblock. However, this can be
overridden with the -i option, which uses an inode specifier to
specify the journal to be used. A file containing journal data
can be specified using the -f option. Finally, the -s option
utilizes the backup information in the superblock to locate the
journal.
The -a option causes the logdump program to print the contents
of all of the descriptor blocks. The -b option causes logdump
to print all journal records that are refer to the specified
block. The -c option will print out the contents of all of the
data blocks selected by the -a and -b options.
ls [-l] [-d] [-p] filespec
Print a listing of the files in the directory filespec. The -l
flag will list files using a more verbose format. The -d flag
will list deleted entries in the directory. The -p flag will
list the files in a format which is more easily parsable by
scripts, as well as making it more clear when there are spaces
or other non-printing characters at the end of filenames.
modify_inode filespec
Modifier le contenu de la structure de données de l’inoeud
filespec.
mkdir filespec
Créer un répertoire.
mknod filespec [p|[[c|b] majeur mineur]]
Create a special device file (a named pipe, character or block
device). If a character or block device is to be made, the
major and minor device numbers must be specified.
ncheck num_inode ...
À partir d’une liste de numéro d’inoeud, afficher une liste de
chemin vers ces inoeuds.
open [-w] [-e] [-f] [-i] [-c] [-b taille_bloc] [-s superbloc]
priphrique
Open a filesystem for editing. The -f flag forces the
filesystem to be opened even if there are some unknown or
incompatible filesystem features which would normally prevent
the filesystem from being opened. The -e flag causes the
filesystem to be opened in exclusive mode. The -b, -c, -i, -s,
and -w options behave the same as the command-line options to
debugfs.
pwd Afficher le répertoire de travail en cours.
quit Quitter debugfs.
rdump rpertoire destination
Recursively dump directory and all its contents (including
regular files, symbolic links, and other directories) into the
named destination which should be an existing directory on the
native filesystem.
rm chemin
Unlink pathname. If this causes the inode pointed to by
pathname to have no other references, deallocate the file. This
command functions as the unlink() system call.
rmdir filespec
Supprime le répertoire filespec.
setb bloc [compte]
Mark the block number block as allocated. If the optional
argument count is present, then count blocks starting at block
number block will be marked as allocated.
set_block_group num_groupe champ valeur
Modify the block group descriptor specified by bgnum so that the
block group descriptor field field has value value.
seti filespec
Marquer l’inoeud filespec comme utilisé dans la table des
inoeuds.
set_inode_field filespec champ valeur
Modify the inode specified by filespec so that the inode field
field has value value. The list of valid inode fields which can
be set via this command can be displayed by using the command:
set_inode_field -l
set_super_value champ valeur
Set the superblock field field to value. The list of valid
superblock fields which can be set via this command can be
displayed by using the command: set_super_value -l
show_super_stats [-h]
List the contents of the super block and the block group
descriptors. If the -h flag is given, only print out the
superblock contents.
stat filespec
Afficher le contenu de la structure de l’inoeud filespec.
testb bloc [compte]
Test if the block number block is marked as allocated in the
block bitmap. If the optional argument count is present, then
count blocks starting at block number block will be tested.
testi filespec
tester si l’inoeud filespec est marqué comme alloué dans la
table des inoeuds.
undel <numro_inoeud> [chemin]
Undelete the specified inode number (which must be surrounded by
angle brackets) so that it and its blocks are marked in use, and
optionally link the recovered inode to the specified pathname.
The e2fsck command should always be run after using the undel
command to recover deleted files.
Note that if you are recovering a large number of deleted files,
linking the inode to a directory may require the directory to be
expanded, which could allocate a block that had been used by one
of the yet-to-be-undeleted files. So it is safer to undelete
all of the inodes without specifying a destination pathname, and
then in a separate pass, use the debugfs link command to link
the inode to the destination pathname, or use e2fsck to check
the filesystem and link all of the recovered inodes to the
lost+found directory.
unlink chemin
Supprimer le lien indiqué chemin pour un inoeud. Notez que ceci
n’ajuste pas le compteur de références de l’inoeud.
write fichier_source fichier_sortie
Créer un fichier fichier_sortie dans le système de fichiers et
copier le contenu de fichier_source dans le fichier destination.
VARIABLES D’ENVIRONNEMENT
DEBUGFS_PAGER, PAGER
The debugfs(8) program always pipes the output of the some
commands through a pager program. These commands include:
show_super_stats, list_directory, show_inode_info,
list_deleted_inodes, and htree_dump. The specific pager can
explicitly specified by the DEBUGFS_PAGER environment variable,
and if it is not set, by the PAGER environment variable.
Note that since a pager is always used, the less(1) pager is
not particularly appropriate, since it clears the screen before
displaying the output of the command and clears the output the
screen when the pager is exited. Many users prefer to use the
less(1) pager for most purposes, which is why the DEBUGFS_PAGER
environment variable is available to override the more general
PAGER environment variable.
AUTEUR
debugfs a été écrit 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.