Loading

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