Provided by: manpages-fr-extra_20111118_all bug

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.