Provided by: manpages-fr-extra_20111118_all bug

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.
       priphrique  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 lu au départ. Cela 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     Indiquer  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 groupes de blocs,
              les tables d'allocation des blocs et  inœuds  et  la  table  des
              inœuds,  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çons si les commandes
              comme  ls,  dump,  etc.  sont   utilisées   sans   indiquer   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  d'indiquer  qu'un
              priphrique_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 »), outre-passant 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 requte
              Forcer debugfs à n'exécuter que la requte 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 filespace
              Afficher le contenu de 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.

       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 fichier
              Effacer le contenu de l'inœud fichier.

       dirsearch filespec fichier
              Chercher fichier dans le répertoire filespec.

       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.

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

       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'inœud indiqué par filespec.

       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.

       imap filespec
              Afficher  l'emplacement  de  la  structure de données de l'inœud
              filespec (dans la table des inœuds).

       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 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  cette
              inœud.  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'inœud.

       logdump   [-acs]   [-b<bloc>]   [-i<filespec>]    [-f<fichier_journal>]
       [fichier_sortie]
              Supprimer  le  contenu du journal d'un système ext3. Par défaut,
              l'inœud du journal est indiqué dans le superbloc. Cependant,  on
              peut  le  redéfinir  via  l'option  -i  qui  accepte un pointeur
              d'inœud  pour  préciser  le  journal  à  utiliser.  Un   fichier
              contenant  le  journal  peut être pointé par l'option -f. Enfin,
              l'option -s utilise l'information sauvegardée 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 [-l] [-d] [-p] filespec
              Afficher  la  liste  des  fichiers  dans le répertoire filespec.
              L'option -l listera les entrées  en  mode  bavard.  L'option  -d
              affichera  les  fichiers  supprimés,  -p  rendra  la sortie plus
              facilement exploitable par des scripts, et en même temps  gèrera
              les  espaces et autres caractères non imprimables en fin de noms
              de fichiers.

       modify_inode filespec
              Modifier le contenu  de  la  structure  de  données  de  l'inœud
              filespec.

       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 num_inode ...
              À partir d'une liste de numéro d'inœud, afficher  une  liste  de
              chemin vers ces inœuds.

       open  [-w]  [-e]  [-f]  [-i]  [-c] [-D] [-b taille_bloc] [-s superbloc]
       priphrique
              Ouvrir un système de fichier en mode édition. L'option -f  force
              l'ouverture,  même  s'il  y  a des caractéristiques 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_dbut [bloc_fin]
              Effacer les blocs de l'inœud dans l'intervalle entre  bloc_dbut
              et  bloc_fin.  Si  bloc_fin  est  omis, la commande fonctionnera
              comme la commande truncate : tous les  blocs  depuis  bloc_dbut
              jusqu'à la fin du fichier seront désalloués.

       pwd    Afficher le répertoire de travail en cours.

       quit   Quitter debugfs.

       rdump rpertoire destination
              Envoyer  récursivement  le  rpertoire  et  tout  son 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 fichier 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.

       seti filespec
              Marquer l'inœud filespec comme utilisé dans la table des inœuds.

       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.

       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.

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

       stat filespec
              Afficher le contenu de la structure de l'inœud filespec.

       testb bloc [compte]
              Regarder si le bloc numéro block est marqué comme alloué dans le
              bloc  bitmap.  Si  l'argument optionnel compte est fourni, alors
              les compte blocs à partir du bloc numéro block seront testés.

       testi filespec
              Tester si l'inœud filespec est marqué comme alloué dans la table
              des inœuds.

       undel <numro_inud> [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  son  bloc  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
              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
              Le  programme  debugfs  affiche  toujours  les   résultats   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 utilisé via la variable
              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

       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.