Provided by: manpages-fr-extra_20101103_all bug

NOM

       debugfs - Debogueur pour systemes de fichiers ext2/ext3/ext4

SYNOPSIS

       debugfs  [  -Vwci  ]  [  -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     Specifier que  le  systeme  de  fichiers  doit  etre  ouvert  en
              lecture-ecriture.  Sans cette option, le systeme de fichiers est
              ouvert en lecture seule.

       -c     Specifier 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. Ceci 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     Specifier 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 groups 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   specifier   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 de specifier qu'un
              p'eriph'erique_source  doit etre utilise pour la lecture des blocs
              qui ne se trouvent pas dans le fichier image ext2.  Ceci  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 commande dans le  fichier  fichier_commande  et
              les executera. Quand debugfs a fini d'executer les commandes, il
              se termine.

       -R requ^ete
              Forcer debugfs a n'executer que la requ^ete puis quitter.

       -V     Afficher le numero de version de debugfs et quitter.

SP'ECIFIER 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  specifie 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 gerees par debugfs :

       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'inode 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 specifiee, 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.

       dump [-p] filespec fichier_sortie
              Fournir le contenu de l'inoeud debugfs 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.

       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
              specifie le numero d'inoeud du repertoire dans  lequel  l'inoeud
              doit  etre  place. Le deuxieme parametre optionnel mode specifie
              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 specifie 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 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 ceci n'initialise pas
              completement toutes  les  structures  de  donnees ;  pour  ceci,
              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 specifie 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  superblock
              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 specifie.
              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]  [-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 et -w fonctionnent
              comme celles de debugfs.

       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 specifie. 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 ceci
              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(8)  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 specifier explicitement lequel sera utilise via la variable
              DEBUGFS_PAGER, et, si celle-ci est vide, par la variable PAGER.

              NB :   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.