debugfs |
Déboguage de système de fichiers |
|---|---|
| Linux | Externe |
Syntaxe
| debugfs [ -Vwci ] [ -b blocksize ] [ -s superblock ] [ -f cmd_file ] [ -R request ] [ -d data_source_device ] [ device ] |
Paramètres
| Nom | Description |
|---|---|
| -w | Ce paramètre permet d'indiquer que le système de fichiers doit être ouvert en mode lecture-écriture. Sans ce paramètre, le système de fichiers est ouvert en mode lecture seule. |
| -c | Ce paramètre permet de spécifier que le système de fichiers doit être ouvert en mode catastrophique, dans lequel les bitmaps d'inode et de groupe ne sont pas lus initialement. Ce paramètre peut être utile pour les systèmes de fichiers avec une corruption importante, mais à cause de ce genre de situation, le mode catastrophique oblige le système de fichiers à être ouvert en lecture seule. |
| -i | Ce paramètre permet de spécifier que le périphérique représente un fichier image ext2 créé par le programme e2image. Étant donné que le fichier image ext2 ne contient que les super-blocs, le descripteur de groupe de blocs, les bitmaps d'allocation de blocs et d'inodes et la table inode et de nombreuses commandes debugfs ne fonctionneront pas correctement. |
| -d data_source_device | Ce paramètre permet, utiliser avec le paramètre -i, de spécifier que data_source_device doit être utilisé lors de la lecture de blocs non trouvés dans le fichier image ext2. Il inclut les blocs de données, de répertoires et indirects. |
| -b blocksize | Ce paramètre permet de forcer l'utilisation de la taille de bloc donnée pour le système de fichiers, plutôt que de détecter normalement la taille de bloc correcte. |
| -s superblock | Ce paramètre permet de faire en sorte que le super bloc du système de fichiers soit lu à partir du numéro de bloc spécifié, au lieu d'utiliser le super bloc principal (situé à une position de 1024 octets à partir du début du système de fichiers). Si vous spécifiez le paramètre -s, vous devez également fournir la taille de bloc du système de fichiers via le paramètre -b. |
| -f cmd_file | Ce paramètre permet de force debugfs à lire les commandes à partir de cmd_file et à les exécuter. Lorsque debugfs a fini d'exécuter ces commandes, il se ferme. |
| -R request | Ce paramètre permet d'obliger debugfs à exécuter une commande unique et à quitter immédiatement après. |
| -V | Ce paramètre permet d'afficher le numéro de version de debugfs et quitte. |
Description
Cette commande permet de lancer le débogueur de système de fichiers.
Remarques
- Le programme debugfs est un débogueur de système de fichiers interactif. Il peut être utilisé pour examiner et modifier l'état d'un système de fichiers de partition ext2, ext3 ou ext4. Le périphérique est le fichier spécial correspondant au périphérique contenant le système de fichiers (par exemple /dev/hdXX).
- Le programme debugfs n'applique aucune vérification de sécurité pour empêcher des commandes comme ls, dump,...
- De nombreuses commandes debugfs prennent une spécification de fichier en tant que paramètre pour spécifier un inode (par opposition à un chemin) dans le système de fichiers actuellement ouvert par debugfs. Le paramètre filespec peut être spécifié sous deux formes. La première forme est un numéro d'inode entouré de crochets, par exemple <2>. La seconde forme est un chemin d'accès; si le nom du chemin est préfixé par une barre oblique ('/'), il est interprété par rapport à la racine du système de fichiers actuellement ouvert par debugfs. Si ce n'est pas le cas, le nom du chemin est interprété par rapport au répertoire de travail actuel tel que maintenu par debugfs. Il peut être modifié en utilisant la commande «cd» de debugfs.
Liste des commandes
Voici la liste des commandes supportés par «debugfs» :
| Commande | Description |
|---|---|
| bmap filespec logical_block | Cette commande permet d'afficher le numéro de bloc physique correspondant au numéro de bloc logique logical_block dans la spécification de fichier inode. |
| cat filespec | Cette commande permet de de sortir le contenu d'un inode filespec vers la sortie standard (stdout). |
| cd filespec | Cette commande permet de changer le répertoire de travail courant pour filespec. |
| chroot filespec | Cette commande permet de changer le répertoire racine pour filespec. |
| close [-a] | Cette commande permet de fermer le système de fichiers actuellement ouvert. Si le paramètre -a est spécifiée, écrivez toutes les modifications apportées aux descripteurs de super bloc et de groupe de blocs à tous les super blocs de sauvegarde, et pas seulement au super bloc maître. |
| clri file | Cette commande permet d'effacer les contenus de fichier inode file. |
| dump [-p] filespec out_file | Cette commande permet de vider le contenu de la spécification de fichier inode dans le fichier de sortie out_file. Si le paramètre -p est activée, définissez les informations de propriétaire, de groupe et d'autorisations sur out_file pour qu'elles correspondent à la spécification de fichier. |
| dump_extents [-n] [-l] filespec | Cette commande permet de sortir l'arborescence de l'étendue de la spécification de fichier inode. Le paramètre -n fera en sorte que dump_extents n'affiche que les noeuds intérieurs dans l'arborescence de l'étendue. L'option -l a pour effet que dump_extents n'affiche que les noeuds terminaux dans l'arborescence des extensions. |
| expand_dir filespec | Cette commande permet de développez le répertoire filespec. |
| feature [fs_feature] [-fs_feature] ... | Cette commande permet de fixer ou d'effacer diverses fonctionnalités du système de fichiers dans le super bloc. Après avoir défini ou effacé les fonctionnalités demandées du système de fichiers, affiche l'état actuel de l'ensemble de fonctionnalités du système de fichiers. |
| find_free_block [count [goal]] | Cette commande permet de trouver le premier nombre de blocs libres en partant de l'objectif et de l'allouer. |
| find_free_inode [dir [mode]] | Cette commande permet de rechercher un inode libre et de l'allouer. Si présent, dir spécifie le numéro d'inode du répertoire dans lequel l'inode doit être localisé. Le deuxième mode du paramètre facultatif spécifie les autorisations du nouvel inode. Si le bit de répertoire est défini sur le mode, la routine d'allocation fonctionnera différemment. |
| freeb block [count] | Cette commande permet de marquer le bloc de numéro de bloc comme non alloué. Si le nombre de paramètre facultatifs est présent, les blocs de comptage commençant par un numéro de bloc seront marqués comme non alloués. |
| freei filespec | Cette commande permet de libérer l'inode spécifié par filespec. |
| help | Cette commande permet d'afficher une liste de commandes supporté par debugfs. |
| icheck block ... | Cette commande permet d'afficher une liste des inodes utilisant le ou les blocs spécifiés sur la ligne de commande. |
| imap filespec | Cette commande permet d'afficher l'emplacement de la structure de données inode (dans la table inode) de la spécification de fichier inode. |
| init_filesys device blocksize | Cette commande permet de créer un système de fichiers ext2 sur un périphérique avec la taille de périphérique blocksize. Notez que cela n'initialise pas complètement toutes les structures de données; Pour ce faire, utilisez le programme mke2fs. Il effectue un simple appel à la bibliothèque de bas niveau, configurant le super bloc et les descripteurs de blocs. |
| kill_file filespec | Cette commande permet de désallouer l'inodes filespec et ses blocs. Notez que cela ne supprime aucune entrée de répertoire (le cas échéant) de cet inode. Voir la commande rm si vous souhaitez dissocier un fichier. |
| lcd directory | Cette commande permet de changer le répertoire de travail courant du processus debugfs par le répertoire du système de fichiers natif. |
| ln filespec dest_file | Cette commande permet de créer un lien spécifié dest_file étant un lien vers la spécification de fichier. Notez que cela ne règle pas le nombre de références d'inode. |
| logdump [-acs] [-b block] [-i filespec] [-f journal_file] [output_file] | Cette commander permet de vider le contenu du journal de la partition ext3. Par défaut, l'inode de journal est spécifié dans le super bloc. Toutefois, cette option peut être remplacée par le paramètre -i, utilisant un spécificateur inode pour spécifier le journal à utiliser. Un fichier contenant des données de journal peut être spécifié à l'aide de du paramètre -f. Enfin, le paramètre -s utilise les informations de sauvegarde contenues dans le super bloc pour localiser le journal. |
| ls [-l] [-d] [-p] filespec | Cette commande permet d'afficher une liste des fichiers du répertoire filespec. Le paramètre «-l» listera les fichiers en utilisant un format plus détaillé. Le paramètre «-d» listera les entrées supprimées dans le répertoire. Le paramètre «-p» liste les fichiers dans un format plus facilement analysable par les scripts, ainsi que plus claire lorsqu'il existe des espaces ou d'autres caractères non affichable à la fin des noms de fichiers. |
| modify_inode filespec | Cette commande permet de modifier le contenu de la structure inode dans la spécification de fichier inode. |
| mkdir filespec | Cette commande permet de créer un répertoire. |
| mknod filespec [p|[[c|b] major minor]] | Cette commande permet de créer un fichier de périphérique spécial (un canal spécifié, un caractère ou un périphérique en mode bloc). Si un caractère ou un périphérique bloc doit être créé, les numéros de périphérique majeur et mineur doivent être spécifiés. |
| ncheck inode_num ... | Cette commande permet de prendre la liste demandée de numéros d'inodes et d'afficher une liste de chemins d'accès à ces inodes. |
| open [-w] [-e] [-f] [-i] [-c] [-b blocksize] [-s superblock] device | Cette commande permet d'ouvrir un système de fichiers pour le modifier. Le paramètre «-f» force le système de fichiers à s'ouvrir même s'il existe des fonctions de système de fichiers inconnues ou incompatibles empêchant normalement son ouverture. Le paramètre «-e» entraîne l'ouverture du système de fichiers en mode exclusif. Les paramètres «-b», «-c», «-i», «-s» et «-w» se comportent de la même manière que les paramètres de ligne de commande pour debugfs. |
| pwd | Cette commande permet d'afficher le répertoire de travail courant. |
| quit | Cette commande permet de quitter la commande debugfs. |
| rdump directory destination | Cette commande permet de vider récursivement le répertoire et tout son contenu (y compris les fichiers normaux, les liens symboliques et d'autres répertoires) dans la destination nommée, devant être un répertoire existant du système de fichiers natif. |
| rm pathname | Cette commande permet de désassocier le chemin. Si cela fait que l'inode pointé par pathname n'a pas d'autres références, il libère le fichier. Cette commande fonctionne comme un appel système unlink(). |
| rmdir filespec | Cette commande permet de supprimer le répertoire filespec. |
| setb block [count] | Cette commande permet de marquer le numéro de bloc comme alloué. Si le nombre de paramètres facultatifs est présent, les blocs de comptage commençant par un numéro de bloc seront marqués comme étant alloués. |
| set_block_group bgnum field value | Cette commande permet de modifier le descripteur de groupe de blocs spécifié par bgnum afin que le champ du descripteur de groupe de blocs ait une valeur. |
| seti filespec | Cette commande permet de marquer la spécification de fichier inode comme étant utilisée dans le bitmap inode. |
| set_inode_field filespec field value | Cette commande permet de modifier l'inode spécifié par filespec afin que le champ de champ inode ait une valeur value. La liste des champs d'inode valides pouvant être définis via cette commande peut être affichée à l'aide de la commande suivante: «set_inode_field -l». |
| set_super_value field value | Cette commande permet de fixer le champ de super bloc sur la valeur value. La liste des champs de super bloc valides pouvant être définis via cette commande peut être affichée à l'aide de la commande suivante : «set_super_value -l». |
| show_super_stats [-h] | Cette commande permet d'afficher la liste du contenu du super bloc et des descripteurs de groupe de blocs. Si le paramètre «-h» est spécifié, il n'affichera que le contenu du super bloc. |
| stat filespec | Cette commande permet d'afficher le contenu de la structure inode de la spécification de fichier inode. |
| testb block [count] | Cette commande permet de tester si le bloc de numéro de bloc spécifié est marqué comme alloué dans le bitmap du bloc. Si le nombre de paramètre facultatifs est présent, alors les blocs de comptage commençant par un bloc de numéro seront testés. |
| testi filespec | Cette commande permet de tester si la spécification de fichier inode est marquée comme étant allouée dans le bitmap d'inode. |
| undel inode-num [pathname] | Cette commande permet d'annuler la suppression du numéro d'inode spécifié (devant être entouré de crochets) de sorte qu'il soit marqué en cours d'utilisation avec ses blocs, et reliez éventuellement l'inode récupéré au chemin spécifié. La commande e2fsck doit toujours être exécutée après avoir utilisé la commande undel pour récupérer les fichiers supprimés. |
| unlink pathname | Cette commande permet de supprimer le lien spécifié par chemin d'accès à un inode. Notez qu'elle ne règle pas le nombre de références d'inode. |
| write source_file out_file | Cette commande permet de créer un fichier dans le système de fichiers spécifié out_file et copie le contenu du fichier source_file dans le fichier de destination. |
Variables d'environnement
| Commande | Description |
|---|---|
| DEBUGFS_PAGER ou PAGER | Le programme debugfs canalise toujours le résultat de certaines commandes via un programme de pagination. Ces commandes incluent: show_super_stats, list_directory, show_inode_info, list_deleted_inodes et htree_dump. La pagination spécifique peut être spécifié explicitement par la variable d'environnement DEBUGFS_PAGER et, s'il n'est pas défini, par la variable d'environnement PAGER. Notez qu'une pagination étant toujours utilisé, la pagination avec less n'est pas particulièrement approprié, car il efface l'écran avant d'afficher le résultat de la commande et efface la sortie de l'écran lorsque la pagination est quitté. De nombreux utilisateurs préfèrent utiliser la pagination less dans la plupart des cas. C'est pourquoi la variable d'environnement DEBUGFS_PAGER est disponible pour remplacer la variable d'environnement PAGER plus générale. |
Auteur
Theodore Ts'o (tytso@mit.edu)
Voir également
Système d'exploitation - Linux - Références de commandes et de programmes - dumpe2fs
Système d'exploitation - Linux - Références de commandes et de programmes - e2fsck
Système d'exploitation - Linux - Références de commandes et de programmes - mke2fs
Système d'exploitation - Linux - Références de commandes et de programmes - tune2fs
Système d'exploitation - Linux - Références de commandes et de programmes - ls
Dernière mise à jour : Mercredi, le 14 janvier 2015