debugfs

NAME

       debugfs - ext2 file system debugger

SYNOPSIS

       debugfs [ [ -w ] device ]

DESCRIPTION

       debugfs is a file system debugger. It can be used to exam-
       ine and change the state of an ext2 file system.
       device is the special file  corresponding  to  the  device
       containing the ext2 file system (e.g /dev/hdXX).

OPTIONS

       -w     Specify  that  the  file  system  should be open in
              read-write mode. Without this option, the file sys-
              tem is open in read-only mode.

COMMANDS

       debugfs  is an interactive debugger. It understands a num-
       ber of commands.

       cat <file>
              Dump the contents of an inode to stdout.

       cd <directory>
              Change the current working directory  to  specified
              directory

       chroot <directory>
              Change  the  root  directory  to  be  the specified
              inode.

       close  Close the currently open file system.

       clri <file>
              Clear the contents of the  inode  corresponding  to
              file

       dump <file> <out_file>
              Dump the contents of an inode to a file.

       expand_dir <file>
              Expand a directory.

       find_free_block [goal]
              Find  the  first free block, starting from goal and
              allocates it.

       find_free_inode [dir [mode]]
              Find a free inode and allocates it.

       freeb <block>
              Mark the block as not allocated.

       freei <file>
              Free the inode corresponding to file

       help   Print a list of commands understood by  debugfs(8).

       icheck <block>
              Do block->inode translation.

       iname <inode>
              Print  the  file  name corresponding to inode (cur-
              rently not implemented - see ncheck).

       initialize <device> <blocksize>
              Create an ext2 file system on device

       kill_file <file>
              Remove a file and deallocates its blocks.

       ln <source_file> <dest_file>
              Create a link.

       ls [pathname]
              Emulate the ls(1) command.

       modify_inode <file>
              Modify the contents of the inode  corresponding  to
              file

       mkdir <file>
              Make a directory.

       mknod <file> [p|[[c|b] <major> <minor>]]
              Create a special device file

       ncheck <inode>
              Do inode->name translation.

       open [-w] <device>
              Open a file system.

       pwd    Print the current working directory.

       quit   Quit debugfs

       rm <file>
              Remove a file.

       rmdir <directory>
              Remove a directory.

       setb <block>
              Mark the block as allocated.


       seti <file>
              Mark in use the inode corresponding to file

       show_super_stats
              List the contents of the super block.

       stat <file>
              Dump  the  contents  of  the inode corresponding to
              file

       testb <block>
              Test if the block is marked as allocated.

       testi <file>
              Test if the inode correponding to file is marked as
              allocated.

       unlink <file>
              Remove a link.

       write source_file <file>
              Create  a  file  in  the filesystem named file, and
              copy the contents of source_file into the  destina-
              tion file.

AUTHOR

       debugfs was written by Theodore Ts'o <tytso@mit.edu>.

SEE ALSO

       dumpe2fs(8), e2fsck(8), mke2fs(8)