.\" -*- nroff -*- .\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved. .\" This file may be copied under the terms of the GNU Public License. .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH DEBUGFS 8 "Juillet 2010" "E2fsprogs version 1.42.5" .SH NOM debugfs \- Débogueur pour systèmes de fichiers ext2/ext3/ext4 .SH SYNOPSIS \fBdebugfs\fP [ \fB\-DVwci\fP ] [ \fB\-b\fP\fI taille_bloc\fP ] [ \fB\-s\fP\fI superbloc\fP ] [ \fB\-f\fP\fI fichier_commande\fP ] [ \fB\-R\fP\fI requête\fP ] [ \fB\-d\fP\fI périphérique_source\fP ] [ \fIpériphérique\fP ] .SH DESCRIPTION Le programme \fBdebugfs\fP 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. .br \fIpériphérique\fP est un fichier spécial correspondant au périphérique contenant le système de fichiers (par exemple \fI/dev/hdXX\fP). .SH OPTIONS .TP \fB\-w\fP 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. .TP \fB\-c\fP 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 lues au départ. Cela peut être utile pour les systèmes de fichiers fortement corrompus, mais de ce fait, le mode catastrophe force l'ouverture en mode lecture seule du système de fichiers. .TP \fB\-i\fP Indiquer que \fIpériphérique\fP représente un fichier image ext2 créé par le programme \fBe2image\fP. 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 commandes de \fBdebugfs\fP ne fonctionneront pas correctement. \fBAttention\fP\ : aucune vérification n'est effectuée et \fBdebugfs\fP peut échouer de différentes façons si les commandes comme \fBls\fP, \fBdump\fP, etc. sont utilisées sans indiquer le \fIpériphérique_source\fP en utilisant l'option \fB\-d\fP. \fBdebugfs\fP est un outil de débogage. Il est fourni brut de fonderie\ ! .TP \fB\-d\fP \fIpériphérique_source\fP Utilisé avec l'option \fB\-i\fP, cette option permet d'indiquer qu'un \fIpériphérique_source\fP 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. .TP \fB\-b\fP \fItaille_bloc\fP 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. .TP \fB\-s\fP \fIsuperbloc\fP 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 \fB\-s\fP, vous devez également fournir la taille des blocs du système de fichiers avec l'option \fB\-b\fP. .TP \fB\-f\fP \fIfichier_commande\fP \fBdebugfs\fP lira les commandes dans le fichier \fIfichier_commande\fP et les exécutera. Quand \fBdebugfs\fP a fini d'exécuter les commandes, il se termine. .TP \fB\-D\fP \fBdebugfs\fP ouvrira le périphérique en utilisant les entrées/sorties directes («\ Direct I/O\ »), outrepassant 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. .TP \fB\-R\fP \fIrequête\fP Forcer \fBdebugfs\fP à n'exécuter que la \fIrequête\fP puis quitter. .TP \fB\-V\fP Afficher le numéro de version de \fBdebugfs\fP et quitter. .SH "INDIQUER DES FICHIERS" .\" .\" Beaucoup de commandes de \fBdebugfs\fP prennent un paramètre \fIfilespec\fP pour indiquer un inœud (par opposition à un chemin) dans le système de fichiers qui est actuellement ouvert par \fBdebugfs\fP. Le paramètre \fIfilespec\fP 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 \fI<2>\fP. 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 \fBdebugfs\fP. Sinon, le chemin est interprété relativement au répertoire de travail maintenu par \fBdebugfs\fP, qui peut être modifié à l'aide de la commande \fBcd\fP de \fBdebugfs\fP. .SH COMMANDES Voici une liste de commandes acceptées par \fBdebugfs\fP\ : .TP \fBblocks\fP\fI filespec\fP Afficher les blocs utilisés par l'inœud \fIfilespec\fP sur la sortie standard. .TP \fBbmap\fP\fI filespec bloc_logique\fP Afficher le numéro de bloc physique correspondant au numéro de bloc logique \fIbloc_logique\fP de l'inœud \fIfilespec\fP. .TP \fBcat\fP\fI filespec\fP Afficher le contenu de l'inœud \fIfilespec\fP sur la sortie standard. .TP \fBcd\fP\fI filespec\fP Utiliser \fIfilespec\fP comme répertoire de travail. .TP \fBchroot\fP\fI filespec\fP Changer le répertoire racine et utiliser \fIfilespec\fP à la place. .TP \fBclose\fP [\fB\-a\fP] Fermer le système de fichiers actuellement ouvert. Si l'option \fB\-a\fP 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. .TP \fBclri\fP\fI fichier\fP Effacer le contenu de l'inœud \fIfichier\fP. .TP \fBdirsearch\fP\fI filespec fichier\fP Chercher \fIfichier\fP dans le répertoire \fIfilespec\fP. .TP \fBdump\fP [\fB\-p\fP] \fIfilespec fichier_sortie\fP Fournir le contenu de l'inœud \fIfilespec\fP dans le fichier de sortie \fIfichier_sortie\fP. Avec l'option \fB\-p\fP, le propriétaire, le groupe et les informations de permission de \fIfichier_sortie\fP correspondront à ceux de \fIfilespec\fP. .TP \fBdump_mmp\fP Afficher les valeurs des champs de protection contre le montage multiple (mmp). .TP \fBdx_hash\fP [\fB\-h\fP \fIhash_alg\fP] [\fB\-s\fP \fIhash_graine\fP] \fIfichier\fP Calculer le hachage du répertoire du \fIfichier\fP. Le nom de l'algorithme de hachage précisé par \fB\-h\fP peut prendre l'une des valeurs «\ legacy\ », «\ half_md4\ » ou «\ tea\ ». La graine de hachage précisée avec l'option \fB\-s\fP doit être au format UUID. .TP \fBdump_extents\fP [\fB\-n\fP] [\fB\-l\fP] \fIfilespec\fP Afficher l'arbre d'extents de l'inœud \fIfilespec\fP. Avec l'option \fB\-n\fP, \fBdump_extents\fP n'affichera que les nœuds internes dans l'arbre d'extents. Avec l'option \fB\-l\fP, \fBdump_extents\fP n'affichera que les feuilles de l'arbre d'extents. .IP (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 ne sont pas stockés 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.) .TP \fBexpand_dir\fP\fI filespec\fP Développer le répertoire \fIfilespec\fP. .TP \fBfeature\fP [\fIcaractéristique_sf\fP] [\-\fIcaractéristique_sf\fP] ... 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. .TP \fBfilefrag\fP [\-\fBdvr\fP] \fIfilespec\fP Afficher le nombre d'extents contigus dans \fIfilespec\fP. Si \fIfilespec\fP est un répertoire et que l'option \fB\-d\fP n'est pas indiquée, \fBfilefrag\fP affichera le nombre d'extents contigus pour chaque fichier du répertoire. Avec l'option \fB\-v\fP, \fBfilefrag\fP affichera sous forme de tableau la liste des extents contigus du fichier. Avec l'option \fB\-r\fP, \fBfilefrag\fP sera exécuté récursivement sur les éléments du répertoire. .TP \fBfind_free_block\fP [\fIcompte\fP [\fIobjectif\fP]] Trouver le premier morceau d'espace libre de \fIcompte\fP blocs, en commençant par \fIobjectif\fP et l'allouer. .TP \fBfind_free_inode\fP [\fIrep\fP [\fImode\fP]] Trouver un inœud libre et l'allouer. S'il est présent, \fIrep\fP indique le numéro d'inœud du répertoire dans lequel l'inœud doit être placé. Le deuxième paramètre optionnel \fImode\fP 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). .TP \fBfreeb\fP \fIbloc\fP [\fIcompte\fP] Marquer le bloc numéro \fIbloc\fP comme non alloué. Si le paramètre optionnel \fIcompte\fP est présent, alors \fIcompte\fP blocs, à partir du bloc numéro \fIbloc\fP seront marqués comme non alloués. .TP \fBe2freefrag\fP [\fB\-c\fP \fImorceau_ko\fP] Faire un rapport de la fragmentation de l'espace libre sur le système de fichiers actuellement ouvert. Si une taille de morceau est fournie avec l'option \fB\-c\fP, alors \fBfilefrag\fP affichera le nombre de morceaux de taille \fImorceau_ko\fP disponibles dans le système de fichiers. La taille des morceaux \fImorceau_ko\fP, en kilooctets, doit être une puissance de deux et doit être supérieure à la taille des blocs du système de fichiers. .TP \fBfreei\fP \fIfilespec\fP [\fInum\fP] Libérer l'inœud indiqué par \fIfilespec\fP. Si \fInum\fP est indiqué, libérer aussi les \fInum\fP\-1 inœuds qui suivent celui qui a été précisé. .TP \fBhelp\fP Afficher une liste des commandes comprises par \fBdebugfs\fP. .TP \fBhtree_dump\fP \fIfilespec\fP Décharger le répertoire indexé par hachage \fIfilespec\fP, en montrant sa structure d'arbre. .TP \fBicheck\fP \fIbloc\fP ... Afficher une liste des inœuds qui utilisent au moins un des blocs fournis sur la ligne de commande. .TP \fBimap\fP\fI filespec\fP Afficher l'emplacement de la structure de données de l'inœud \fIfilespec\fP (dans la table des inœuds). .TP \fBinit_filesys\fP\fI périphérique\fP\fI taille_bloc\fP Créer un système de fichiers ext2 sur le \fIpériphérique\fP avec une taille de bloc de \fItaille_bloc\fP. Notez que cela n'initialise pas complètement toutes les structures de données\ ; pour cela, utilisez \fBmke2fs\fP(8). Il ne s'agit que d'un appel à la bibliothèque bas niveau qui définit le superbloc et les descripteurs blocs. .TP \fBkill_file\fP\fI filespec\fP Désallouer l'inœud \fIfilespec\fP et ses blocs. Notez que cela ne supprime aucune entrée de répertoire (s'il y en a) dans cet inœud. Voir la commande \fBrm\fP(1) si vous souhaitez supprimer un fichier. .TP \fBlcd\fP\fI répertoire\fP Changer le répertoire de travail du processus \fBdebugfs\fP pour \fIdirectory\fP sur le système de fichiers natif. .TP \fBln\fP\fI filespec fichier_dest\fP Créer un lien nommé \fIfichier_dest\fP vers \fIfilespec\fP. Notez que ça n'ajuste pas le compteur de référence de l'inœud. .TP \fBlogdump\fP [\fB\-acs\fP] [\fB\-b\fP \fIbloc\fP] [\fB\-i\fP \fIfilespec\fP] [\fB\-f\fP \fIfichier_journal\fP] [\fIfichier_sortie\fP] 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 \fB\-i\fP qui accepte un pointeur d'inœud pour préciser le journal à utiliser. Un fichier contenant le journal peut être pointé par l'option \fB\-f\fP. Enfin, l'option \fB\-s\fP utilise l'information sauvegardée sur le superbloc pour localiser le journal. .IP L'option \fB\-a\fP force le programme \fBlogdump\fP à afficher le contenu de tous les descripteurs de bloc. L'option \fB\-b\fP fait apparaître toutes les entrées du journal qui référencent le bloc indiqué. L'option \fB\-c\fP affichera le contenu des blocs de données sélectionnés par l'option \fB\-a\fP et \fB\-b\fP. .TP \fBls\fP [\fB\-l\fP] [\fB\-d\fP] [\fB\-p\fP] \fIfilespec\fP Afficher la liste des fichiers dans le répertoire \fIfilespec\fP. L'option \fB\-l\fP listera les entrées en mode bavard. L'option \fB\-d\fP affichera les fichiers supprimés, \fB\-p\fP rendra la sortie plus facilement exploitable par des scripts, et en même temps prendra en charge les espaces et autres caractères non imprimables en fin de noms de fichiers. .TP \fBmodify_inode\fP \fIfilespec\fP Modifier le contenu de la structure de données de l'inœud \fIfilespec\fP. .TP \fBmkdir\fP\fI filespec\fP Créer un répertoire. .TP \fBmknod \fP\fIfilespec\fP [\fBp\fP|[[\fBc\fP|\fBb\fP] \fImajeur\fP \fImineur\fP]] 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 \fImajeur\fP et \fImineur\fP. .TP \fBncheck\fP [\fB\-c\fP] \fInum_inode\fP ... À partir d'une liste de numéros d'inœuds, afficher une liste de chemins vers ces inœuds. L'option \fB\-c\fP activera la vérification des renseignements de type de fichier dans l'entrée du répertoire pour s'assurer qu'il correspond au type d'inœud. .TP \fBopen\fP [\fB\-w\fP] [\fB\-e\fP] [\fB\-f\fP] [\fB\-i\fP] [\fB\-c\fP] [\fB\-D\fP] [\fB\-b\fP \fItaille_bloc\fP] [\fB\-s\fP \fIsuperbloc\fP] \fIpériphérique\fP Ouvrir un système de fichiers en mode édition. L'option \fB\-f\fP 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 \fB\-b\fP, \fB\-c\fP, \fB\-i\fP, \fB\-s\fP, \fB\-w\fP et \fB\-D\fP fonctionnent comme celles de \fBdebugfs\fP. .TP \fBpunch\fP \fIfilespec\fP \fIbloc_début\fP [\fIbloc_fin\fP] Effacer les blocs de l'inœud dans l'intervalle entre \fIbloc_début\fP et \fIbloc_fin\fP. Si \fIbloc_fin\fP est omis, la commande fonctionnera comme la commande truncate\ : tous les blocs depuis \fIbloc_début\fP jusqu'à la fin du fichier seront désalloués. .TP \fBpwd\fP Afficher le répertoire de travail en cours. .TP \fBquit\fP Quitter \fBdebugfs\fP. .TP \fBrdump\fP\fI répertoire destination\fP Envoyer récursivement le \fIrépertoire\fP et tout son contenu (y compris les fichiers normaux, les liens symboliques et les autres répertoires) dans la \fIdestination\fP nommée, qui devrait être un répertoire existant sur le système de fichiers natif. .TP \fBrm\fP\fI chemin\fP Défaire le lien \fIchemin\fP. Si cela entraîne la fin de toute référence pour l'inœud pointé par \fIchemin\fP, désalloue le fichier. Cette command fonctionne comme l'appel système unlink(). .TP \fBrmdir\fP\fI filespec\fP Supprimer le répertoire \fIfilespec\fP. .TP \fBsetb\fP\fI bloc\fP [\fIcompte\fP] Marquer le bloc numéro \fIbloc\fP comme alloué. Si l'argument optionnel \fIcompte\fP est présent, alors les \fIcompte\fP blocs à partir du bloc numéro \fIbloc\fP seront marqués comme alloués. .TP \fBset_block_group\fP\fI num_groupe champ valeur\fP Modifier le descripteur du bloc de groupe indiqué par \fInum_groupe\fP pour que le champ du descripteur de groupe \fIchamp\fP prenne la valeur \fIvaleur\fP. .TP \fBseti\fP \fIfilespec\fP [\fInum\fP] Marquer l'inœud \fIfilespec\fP comme utilisé dans la table des inœuds. Si \fInum\fP est indiqué, marquer de la même façon les \fInum\fP\-1 inœuds qui suivent celui qui a été précisé. .TP \fBset_inode_field\fP\fI filespec champ valeur\fP Modifier l'inœud pointé par \fIfilespec\fP pour que l'inœud \fIchamp\fP prenne la valeur \fIvaleur\fP. La liste des champs inœuds qui peuvent être configurés via cette commande peut être obtenue par la commande\ : \fBset_inode_field \-l\fP. .TP \fBset_mmp_value\fP\fI champ valeur\fP Modifier les données de protection contre le montage multiple (mmp) pour que le champ \fIchamp\fP prenne la valeur \fIvaleur\fP. La liste des champs mmp qui peuvent être configurés via cette commande peut être obtenue par la commande\ : \fBset_mmp_value \-l\fP. .TP \fBset_super_value\fP\fI champ valeur\fP Donner la valeur \fIvaleur\fP au champ \fIchamp\fP du superbloc. La liste des champs du superbloc qui peuvent être configurés via cette commande peut être affichée avec la commande\ : \fBset_super_value \-l\fP. .TP \fBshow_super_stats\fP [\fB\-h\fP] Lister le contenu du superbloc et les descripteurs du groupe de blocs. Si l'argument \fB\-h\fP est passé, seul le contenu du superbloc sera affiché. .TP \fBstat\fP\fI filespec\fP Afficher le contenu de la structure de l'inœud \fIfilespec\fP. .TP \fBtestb\fP \fIbloc\fP [\fIcompte\fP] Regarder si le bloc numéro \fIbloc\fP est marqué comme alloué dans le bloc bitmap. Si l'argument optionnel \fIcompte\fP est fourni, alors les \fIcompte\fP blocs à partir du bloc numéro \fIbloc\fP seront testés. .TP \fBtesti\fP\fI filespec\fP Tester si l'inœud \fIfilespec\fP est marqué comme alloué dans la table des inœuds. .TP \fBundel\fP \fInuméro_inœud\fP [\fIchemin\fP] 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 \fBe2fsck\fP après avoir utilisé \fBundel\fP pour récupérer des fichiers. .IP 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 \fBlink\fP de debugfs pour lier les inœuds au répertoire de destination, ou d'utiliser \fBe2fsck\fP pour vérifier le système de fichiers et de lier tous les inœuds récupérés au répertoire lost+found. .TP \fBunlink\fP\fI chemin\fP Supprimer le lien indiqué \fIchemin\fP pour un inœud. Notez que cela n'ajuste pas le compteur de références de l'inœud. .TP \fBwrite\fP\fI fichier_source fichier_sortie\fP Créer un fichier \fIfichier_sortie\fP dans le système de fichiers et copier le contenu de \fIfichier_source\fP dans le fichier destination. .SH "VARIABLES D'ENVIRONNEMENT" .TP \fBDEBUGFS_PAGER, PAGER\fP Le programme \fBdebugfs\fP affiche toujours les résultats des commandes \fBshow_super_stats\fP, \fBlist_directory\fP, \fBshow_inode_info\fP, \fBlist_deleted_inodes\fP et \fBhtree_dump\fP dans un afficheur de texte. On peut indiquer explicitement lequel sera utilisé via la variable \fBDEBUGFS_PAGER\fP, et, si celle\-ci est vide, par la variable \fBPAGER\fP. .IP Remarque\ : comme un afficheur de texte est toujours utilisé, l'afficheur de texte \fBless\fP(1) n'est pas particulièrement adapté, car il efface l'écran quand on le quitte. De nombreux utilisateurs préfèrent utiliser \fBless\fP(1) pour la plupart des cas, c'est pourquoi la variable \fBDEBUGFS_PAGER\fP existe en plus de \fBPAGER\fP. .SH AUTEUR \fBdebugfs\fP a été écrit par Theodore Ts'o . .SH "VOIR AUSSI" \fBdumpe2fs\fP(8), \fBtune2fs\fP(8), \fBe2fsck\fP(8), \fBmke2fs\fP(8) .SH TRADUCTION La traduction de cette page de manuel est maintenue par les membres de la liste . Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages\-fr\-extra.