2 * debugfs.c --- a program which allows you to attach an ext2fs
3 * filesystem and play with it.
5 * Copyright (C) 1993 Theodore Ts'o. This file may be redistributed
6 * under the terms of the GNU Public License.
8 * Modifications by Robert Sanders <gt8134b@prism.gatech.edu>
27 #include <sys/types.h>
30 #include "et/com_err.h"
33 #include "uuid/uuid.h"
36 #include <ext2fs/ext2_ext_attr.h>
38 #include "../version.h"
40 extern ss_request_table debug_cmds;
42 ext2_filsys current_fs = NULL;
45 static void open_filesystem(char *device, int open_flags, blk_t superblock,
46 blk_t blocksize, int catastrophic,
50 io_channel data_io = 0;
52 if (superblock != 0 && blocksize == 0) {
53 com_err(device, 0, "if you specify the superblock, you must also specify the block size");
59 if ((open_flags & EXT2_FLAG_IMAGE_FILE) == 0) {
61 "The -d option is only valid when reading an e2image file");
65 retval = unix_io_manager->open(data_filename, 0, &data_io);
67 com_err(data_filename, 0, "while opening data source");
73 if (catastrophic && (open_flags & EXT2_FLAG_RW)) {
75 "opening read-only because of catastrophic mode");
76 open_flags &= ~EXT2_FLAG_RW;
79 retval = ext2fs_open(device, open_flags, superblock, blocksize,
80 unix_io_manager, ¤t_fs);
82 com_err(device, retval, "while opening filesystem");
88 com_err(device, 0, "catastrophic mode - not reading inode or group bitmaps");
90 retval = ext2fs_read_inode_bitmap(current_fs);
92 com_err(device, retval, "while reading inode bitmap");
95 retval = ext2fs_read_block_bitmap(current_fs);
97 com_err(device, retval, "while reading block bitmap");
103 retval = ext2fs_set_data_io(current_fs, data_io);
105 com_err(device, retval,
106 "while setting data source");
111 root = cwd = EXT2_ROOT_INO;
115 retval = ext2fs_close(current_fs);
117 com_err(device, retval, "while trying to close filesystem");
121 void do_open_filesys(int argc, char **argv)
124 int catastrophic = 0;
125 blk_t superblock = 0;
127 int open_flags = EXT2_FLAG_SOFTSUPP_FEATURES;
128 char *data_filename = 0;
131 while ((c = getopt (argc, argv, "iwfecb:s:d:")) != EOF) {
134 open_flags |= EXT2_FLAG_IMAGE_FILE;
137 open_flags |= EXT2_FLAG_RW;
140 open_flags |= EXT2_FLAG_FORCE;
143 open_flags |= EXT2_FLAG_EXCLUSIVE;
149 data_filename = optarg;
152 blocksize = parse_ulong(optarg, argv[0],
158 superblock = parse_ulong(optarg, argv[0],
159 "superblock number", &err);
167 if (optind != argc-1) {
170 if (check_fs_not_open(argv[0]))
172 open_filesystem(argv[optind], open_flags,
173 superblock, blocksize, catastrophic,
178 fprintf(stderr, "%s: Usage: open [-s superblock] [-b blocksize] "
179 "[-c] [-w] <device>\n", argv[0]);
182 void do_lcd(int argc, char **argv)
185 com_err(argv[0], 0, "Usage: %s %s", argv[0], "<native dir>");
189 if (chdir(argv[1]) == -1) {
190 com_err(argv[0], errno,
191 "while trying to change native directory to %s",
197 static void close_filesystem(NOARGS)
201 if (current_fs->flags & EXT2_FLAG_IB_DIRTY) {
202 retval = ext2fs_write_inode_bitmap(current_fs);
204 com_err("ext2fs_write_inode_bitmap", retval, 0);
206 if (current_fs->flags & EXT2_FLAG_BB_DIRTY) {
207 retval = ext2fs_write_block_bitmap(current_fs);
209 com_err("ext2fs_write_block_bitmap", retval, 0);
211 retval = ext2fs_close(current_fs);
213 com_err("ext2fs_close", retval, 0);
218 void do_close_filesys(int argc, char **argv)
220 if (common_args_process(argc, argv, 1, 1, "close_filesys", "", 0))
225 void do_init_filesys(int argc, char **argv)
227 struct ext2_super_block param;
231 if (common_args_process(argc, argv, 3, 3, "initialize",
232 "<device> <blocksize>", CHECK_FS_NOTOPEN))
235 memset(¶m, 0, sizeof(struct ext2_super_block));
236 param.s_blocks_count = parse_ulong(argv[2], argv[0],
237 "blocks count", &err);
240 retval = ext2fs_initialize(argv[1], 0, ¶m,
241 unix_io_manager, ¤t_fs);
243 com_err(argv[1], retval, "while initializing filesystem");
247 root = cwd = EXT2_ROOT_INO;
251 static void print_features(struct ext2_super_block * s, FILE *f)
254 __u32 *mask = &s->s_feature_compat, m;
256 fputs("Filesystem features:", f);
257 for (i=0; i <3; i++,mask++) {
258 for (j=0,m=1; j < 32; j++, m<<=1) {
260 fprintf(f, " %s", e2p_feature2string(i, m));
270 static void print_bg_opts(struct ext2_group_desc *gdp, int mask,
271 const char *str, int *first, FILE *f)
273 if (gdp->bg_flags & mask) {
283 void do_show_super_stats(int argc, char *argv[])
287 struct ext2_group_desc *gdp;
288 int c, header_only = 0;
289 int numdirs = 0, first;
292 while ((c = getopt (argc, argv, "h")) != EOF) {
301 if (optind != argc) {
304 if (check_fs_open(argv[0]))
308 list_super2(current_fs->super, out);
309 for (i=0; i < current_fs->group_desc_count; i++)
310 numdirs += current_fs->group_desc[i].bg_used_dirs_count;
311 fprintf(out, "Directories: %d\n", numdirs);
318 gdp = ¤t_fs->group_desc[0];
319 for (i = 0; i < current_fs->group_desc_count; i++, gdp++) {
320 fprintf(out, " Group %2d: block bitmap at %u, "
321 "inode bitmap at %u, "
322 "inode table at %u\n"
326 i, gdp->bg_block_bitmap,
327 gdp->bg_inode_bitmap, gdp->bg_inode_table,
328 gdp->bg_free_blocks_count,
329 gdp->bg_free_blocks_count != 1 ? "blocks" : "block",
330 gdp->bg_free_inodes_count,
331 gdp->bg_free_inodes_count != 1 ? "inodes" : "inode",
332 gdp->bg_used_dirs_count,
333 gdp->bg_used_dirs_count != 1 ? "directories"
336 print_bg_opts(gdp, EXT2_BG_INODE_UNINIT, "Inode not init",
338 print_bg_opts(gdp, EXT2_BG_BLOCK_UNINIT, "Block not init",
346 fprintf(stderr, "%s: Usage: show_super [-h]\n", argv[0]);
349 void do_dirty_filesys(int argc EXT2FS_ATTR((unused)),
350 char **argv EXT2FS_ATTR((unused)))
352 if (check_fs_open(argv[0]))
354 if (check_fs_read_write(argv[0]))
357 if (argv[1] && !strcmp(argv[1], "-clean"))
358 current_fs->super->s_state |= EXT2_VALID_FS;
360 current_fs->super->s_state &= ~EXT2_VALID_FS;
361 ext2fs_mark_super_dirty(current_fs);
364 struct list_blocks_struct {
367 blk_t first_block, last_block;
368 e2_blkcnt_t first_bcnt, last_bcnt;
372 static void finish_range(struct list_blocks_struct *lb)
374 if (lb->first_block == 0)
379 fprintf(lb->f, ", ");
380 if (lb->first_block == lb->last_block)
381 fprintf(lb->f, "(%lld):%u",
382 (long long)lb->first_bcnt, lb->first_block);
384 fprintf(lb->f, "(%lld-%lld):%u-%u",
385 (long long)lb->first_bcnt, (long long)lb->last_bcnt,
386 lb->first_block, lb->last_block);
390 static int list_blocks_proc(ext2_filsys fs EXT2FS_ATTR((unused)),
391 blk_t *blocknr, e2_blkcnt_t blockcnt,
392 blk_t ref_block EXT2FS_ATTR((unused)),
393 int ref_offset EXT2FS_ATTR((unused)),
396 struct list_blocks_struct *lb = (struct list_blocks_struct *) private;
401 * See if we can add on to the existing range (if it exists)
403 if (lb->first_block &&
404 (lb->last_block+1 == *blocknr) &&
405 (lb->last_bcnt+1 == blockcnt)) {
406 lb->last_block = *blocknr;
407 lb->last_bcnt = blockcnt;
414 lb->first_block = lb->last_block = *blocknr;
415 lb->first_bcnt = lb->last_bcnt = blockcnt;
419 * Not a normal block. Always force a new range.
425 fprintf(lb->f, ", ");
427 fprintf(lb->f, "(IND):%u", *blocknr);
428 else if (blockcnt == -2)
429 fprintf(lb->f, "(DIND):%u", *blocknr);
430 else if (blockcnt == -3)
431 fprintf(lb->f, "(TIND):%u", *blocknr);
435 static void dump_xattr_string(FILE *out, const char *str, int len)
440 /* check: is string "printable enough?" */
441 for (i = 0; i < len; i++)
445 if (printable <= len*7/8)
448 for (i = 0; i < len; i++)
450 fprintf(out, isprint(str[i]) ? "%c" : "\\%03o",
451 (unsigned char)str[i]);
453 fprintf(out, "%02x ", (unsigned char)str[i]);
456 static void internal_dump_inode_extra(FILE *out,
457 const char *prefix EXT2FS_ATTR((unused)),
458 ext2_ino_t inode_num EXT2FS_ATTR((unused)),
459 struct ext2_inode_large *inode)
461 struct ext2_ext_attr_entry *entry;
464 unsigned int storage_size;
466 fprintf(out, "Size of extra inode fields: %u\n", inode->i_extra_isize);
467 if (inode->i_extra_isize > EXT2_INODE_SIZE(current_fs->super) -
468 EXT2_GOOD_OLD_INODE_SIZE) {
469 fprintf(stderr, "invalid inode->i_extra_isize (%u)\n",
470 inode->i_extra_isize);
473 storage_size = EXT2_INODE_SIZE(current_fs->super) -
474 EXT2_GOOD_OLD_INODE_SIZE -
475 inode->i_extra_isize;
476 magic = (__u32 *)((char *)inode + EXT2_GOOD_OLD_INODE_SIZE +
477 inode->i_extra_isize);
478 if (*magic == EXT2_EXT_ATTR_MAGIC) {
479 fprintf(out, "Extended attributes stored in inode body: \n");
480 end = (char *) inode + EXT2_INODE_SIZE(current_fs->super);
481 start = (char *) magic + sizeof(__u32);
482 entry = (struct ext2_ext_attr_entry *) start;
483 while (!EXT2_EXT_IS_LAST_ENTRY(entry)) {
484 struct ext2_ext_attr_entry *next =
485 EXT2_EXT_ATTR_NEXT(entry);
486 if (entry->e_value_size > storage_size ||
487 (char *) next >= end) {
488 fprintf(out, "invalid EA entry in inode\n");
492 dump_xattr_string(out, EXT2_EXT_ATTR_NAME(entry),
494 fprintf(out, " = \"");
495 dump_xattr_string(out, start + entry->e_value_offs,
496 entry->e_value_size);
497 fprintf(out, "\" (%u)\n", entry->e_value_size);
503 static void dump_blocks(FILE *f, const char *prefix, ext2_ino_t inode)
505 struct list_blocks_struct lb;
507 fprintf(f, "%sBLOCKS:\n%s", prefix, prefix);
512 ext2fs_block_iterate2(current_fs, inode, 0, NULL,
513 list_blocks_proc, (void *)&lb);
516 fprintf(f, "\n%sTOTAL: %lld\n", prefix, (long long)lb.total);
521 void internal_dump_inode(FILE *out, const char *prefix,
522 ext2_ino_t inode_num, struct ext2_inode *inode,
527 int os = current_fs->super->s_creator_os;
529 if (LINUX_S_ISDIR(inode->i_mode)) i_type = "directory";
530 else if (LINUX_S_ISREG(inode->i_mode)) i_type = "regular";
531 else if (LINUX_S_ISLNK(inode->i_mode)) i_type = "symlink";
532 else if (LINUX_S_ISBLK(inode->i_mode)) i_type = "block special";
533 else if (LINUX_S_ISCHR(inode->i_mode)) i_type = "character special";
534 else if (LINUX_S_ISFIFO(inode->i_mode)) i_type = "FIFO";
535 else if (LINUX_S_ISSOCK(inode->i_mode)) i_type = "socket";
536 else i_type = "bad type";
537 fprintf(out, "%sInode: %u Type: %s ", prefix, inode_num, i_type);
538 fprintf(out, "%sMode: %04o Flags: 0x%x Generation: %u\n",
540 inode->i_mode & 0777, inode->i_flags, inode->i_generation);
541 fprintf(out, "%sUser: %5d Group: %5d Size: ",
542 prefix, inode_uid(*inode), inode_gid(*inode));
543 if (LINUX_S_ISREG(inode->i_mode)) {
544 unsigned long long i_size = (inode->i_size |
545 ((unsigned long long)inode->i_size_high << 32));
547 fprintf(out, "%llu\n", i_size);
549 fprintf(out, "%d\n", inode->i_size);
550 if (os == EXT2_OS_HURD)
552 "%sFile ACL: %d Directory ACL: %d Translator: %d\n",
554 inode->i_file_acl, LINUX_S_ISDIR(inode->i_mode) ? inode->i_dir_acl : 0,
555 inode->osd1.hurd1.h_i_translator);
557 fprintf(out, "%sFile ACL: %d Directory ACL: %d\n",
559 inode->i_file_acl, LINUX_S_ISDIR(inode->i_mode) ? inode->i_dir_acl : 0);
560 if (os == EXT2_OS_LINUX)
561 fprintf(out, "%sLinks: %d Blockcount: %llu\n",
562 prefix, inode->i_links_count,
563 (((unsigned long long)
564 inode->osd2.linux2.l_i_blocks_hi << 32)) +
567 fprintf(out, "%sLinks: %d Blockcount: %u\n",
568 prefix, inode->i_links_count, inode->i_blocks);
571 frag = inode->osd2.hurd2.h_i_frag;
572 fsize = inode->osd2.hurd2.h_i_fsize;
575 frag = inode->osd2.masix2.m_i_frag;
576 fsize = inode->osd2.masix2.m_i_fsize;
581 fprintf(out, "%sFragment: Address: %d Number: %d Size: %d\n",
582 prefix, inode->i_faddr, frag, fsize);
583 fprintf(out, "%sctime: 0x%08x -- %s", prefix, inode->i_ctime,
584 time_to_string(inode->i_ctime));
585 fprintf(out, "%satime: 0x%08x -- %s", prefix, inode->i_atime,
586 time_to_string(inode->i_atime));
587 fprintf(out, "%smtime: 0x%08x -- %s", prefix, inode->i_mtime,
588 time_to_string(inode->i_mtime));
590 fprintf(out, "%sdtime: 0x%08x -- %s", prefix, inode->i_dtime,
591 time_to_string(inode->i_dtime));
592 if (EXT2_INODE_SIZE(current_fs->super) > EXT2_GOOD_OLD_INODE_SIZE)
593 internal_dump_inode_extra(out, prefix, inode_num,
594 (struct ext2_inode_large *) inode);
595 if (LINUX_S_ISLNK(inode->i_mode) && ext2fs_inode_data_blocks(current_fs,inode) == 0)
596 fprintf(out, "%sFast_link_dest: %.*s\n", prefix,
597 (int) inode->i_size, (char *)inode->i_block);
598 else if (LINUX_S_ISBLK(inode->i_mode) || LINUX_S_ISCHR(inode->i_mode)) {
602 if (inode->i_block[0]) {
603 major = (inode->i_block[0] >> 8) & 255;
604 minor = inode->i_block[0] & 255;
607 major = (inode->i_block[1] & 0xfff00) >> 8;
608 minor = ((inode->i_block[1] & 0xff) |
609 ((inode->i_block[1] >> 12) & 0xfff00));
610 devnote = "(New-style) ";
612 fprintf(out, "%sDevice major/minor number: %02d:%02d (hex %02x:%02x)\n",
613 devnote, major, minor, major, minor);
615 else if (do_dump_blocks)
616 dump_blocks(out, prefix, inode_num);
619 static void dump_inode(ext2_ino_t inode_num, struct ext2_inode *inode)
624 internal_dump_inode(out, "", inode_num, inode, 1);
628 void do_stat(int argc, char *argv[])
631 struct ext2_inode * inode_buf;
633 if (check_fs_open(argv[0]))
636 inode_buf = (struct ext2_inode *)
637 malloc(EXT2_INODE_SIZE(current_fs->super));
639 fprintf(stderr, "do_stat: can't allocate buffer\n");
643 if (common_inode_args_process(argc, argv, &inode, 0)) {
648 if (debugfs_read_inode_full(inode, inode_buf, argv[0],
649 EXT2_INODE_SIZE(current_fs->super))) {
654 dump_inode(inode, inode_buf);
659 void do_chroot(int argc, char *argv[])
664 if (common_inode_args_process(argc, argv, &inode, 0))
667 retval = ext2fs_check_directory(current_fs, inode);
669 com_err(argv[1], retval, 0);
675 void do_clri(int argc, char *argv[])
678 struct ext2_inode inode_buf;
680 if (common_inode_args_process(argc, argv, &inode, CHECK_FS_RW))
683 if (debugfs_read_inode(inode, &inode_buf, argv[0]))
685 memset(&inode_buf, 0, sizeof(inode_buf));
686 if (debugfs_write_inode(inode, &inode_buf, argv[0]))
690 void do_freei(int argc, char *argv[])
694 if (common_inode_args_process(argc, argv, &inode,
695 CHECK_FS_RW | CHECK_FS_BITMAPS))
698 if (!ext2fs_test_inode_bitmap(current_fs->inode_map,inode))
699 com_err(argv[0], 0, "Warning: inode already clear");
700 ext2fs_unmark_inode_bitmap(current_fs->inode_map,inode);
701 ext2fs_mark_ib_dirty(current_fs);
704 void do_seti(int argc, char *argv[])
708 if (common_inode_args_process(argc, argv, &inode,
709 CHECK_FS_RW | CHECK_FS_BITMAPS))
712 if (ext2fs_test_inode_bitmap(current_fs->inode_map,inode))
713 com_err(argv[0], 0, "Warning: inode already set");
714 ext2fs_mark_inode_bitmap(current_fs->inode_map,inode);
715 ext2fs_mark_ib_dirty(current_fs);
718 void do_testi(int argc, char *argv[])
722 if (common_inode_args_process(argc, argv, &inode, CHECK_FS_BITMAPS))
725 if (ext2fs_test_inode_bitmap(current_fs->inode_map,inode))
726 printf("Inode %u is marked in use\n", inode);
728 printf("Inode %u is not in use\n", inode);
731 void do_freeb(int argc, char *argv[])
736 if (common_block_args_process(argc, argv, &block, &count))
738 if (check_fs_read_write(argv[0]))
740 while (count-- > 0) {
741 if (!ext2fs_test_block_bitmap(current_fs->block_map,block))
742 com_err(argv[0], 0, "Warning: block %u already clear",
744 ext2fs_unmark_block_bitmap(current_fs->block_map,block);
747 ext2fs_mark_bb_dirty(current_fs);
750 void do_setb(int argc, char *argv[])
755 if (common_block_args_process(argc, argv, &block, &count))
757 if (check_fs_read_write(argv[0]))
759 while (count-- > 0) {
760 if (ext2fs_test_block_bitmap(current_fs->block_map,block))
761 com_err(argv[0], 0, "Warning: block %u already set",
763 ext2fs_mark_block_bitmap(current_fs->block_map,block);
766 ext2fs_mark_bb_dirty(current_fs);
769 void do_testb(int argc, char *argv[])
774 if (common_block_args_process(argc, argv, &block, &count))
776 while (count-- > 0) {
777 if (ext2fs_test_block_bitmap(current_fs->block_map,block))
778 printf("Block %u marked in use\n", block);
780 printf("Block %u not in use\n", block);
785 static void modify_u8(char *com, const char *prompt,
786 const char *format, __u8 *val)
792 sprintf(buf, format, *val);
793 printf("%30s [%s] ", prompt, buf);
794 fgets(buf, sizeof(buf), stdin);
795 if (buf[strlen (buf) - 1] == '\n')
796 buf[strlen (buf) - 1] = '\0';
799 v = strtoul(buf, &tmp, 0);
801 com_err(com, 0, "Bad value - %s", buf);
806 static void modify_u16(char *com, const char *prompt,
807 const char *format, __u16 *val)
813 sprintf(buf, format, *val);
814 printf("%30s [%s] ", prompt, buf);
815 fgets(buf, sizeof(buf), stdin);
816 if (buf[strlen (buf) - 1] == '\n')
817 buf[strlen (buf) - 1] = '\0';
820 v = strtoul(buf, &tmp, 0);
822 com_err(com, 0, "Bad value - %s", buf);
827 static void modify_u32(char *com, const char *prompt,
828 const char *format, __u32 *val)
834 sprintf(buf, format, *val);
835 printf("%30s [%s] ", prompt, buf);
836 fgets(buf, sizeof(buf), stdin);
837 if (buf[strlen (buf) - 1] == '\n')
838 buf[strlen (buf) - 1] = '\0';
841 v = strtoul(buf, &tmp, 0);
843 com_err(com, 0, "Bad value - %s", buf);
849 void do_modify_inode(int argc, char *argv[])
851 struct ext2_inode inode;
852 ext2_ino_t inode_num;
854 unsigned char *frag, *fsize;
857 const char *hex_format = "0x%x";
858 const char *octal_format = "0%o";
859 const char *decimal_format = "%d";
860 const char *unsignedlong_format = "%lu";
862 if (common_inode_args_process(argc, argv, &inode_num, CHECK_FS_RW))
865 os = current_fs->super->s_creator_os;
867 if (debugfs_read_inode(inode_num, &inode, argv[1]))
870 modify_u16(argv[0], "Mode", octal_format, &inode.i_mode);
871 modify_u16(argv[0], "User ID", decimal_format, &inode.i_uid);
872 modify_u16(argv[0], "Group ID", decimal_format, &inode.i_gid);
873 modify_u32(argv[0], "Size", unsignedlong_format, &inode.i_size);
874 modify_u32(argv[0], "Creation time", decimal_format, &inode.i_ctime);
875 modify_u32(argv[0], "Modification time", decimal_format, &inode.i_mtime);
876 modify_u32(argv[0], "Access time", decimal_format, &inode.i_atime);
877 modify_u32(argv[0], "Deletion time", decimal_format, &inode.i_dtime);
878 modify_u16(argv[0], "Link count", decimal_format, &inode.i_links_count);
879 if (os == EXT2_OS_LINUX)
880 modify_u16(argv[0], "Block count high", unsignedlong_format,
881 &inode.osd2.linux2.l_i_blocks_hi);
882 modify_u32(argv[0], "Block count", unsignedlong_format, &inode.i_blocks);
883 modify_u32(argv[0], "File flags", hex_format, &inode.i_flags);
884 modify_u32(argv[0], "Generation", hex_format, &inode.i_generation);
886 modify_u32(argv[0], "Reserved1", decimal_format, &inode.i_reserved1);
888 modify_u32(argv[0], "File acl", decimal_format, &inode.i_file_acl);
889 if (LINUX_S_ISDIR(inode.i_mode))
890 modify_u32(argv[0], "Directory acl", decimal_format, &inode.i_dir_acl);
892 modify_u32(argv[0], "High 32bits of size", decimal_format, &inode.i_size_high);
894 if (os == EXT2_OS_HURD)
895 modify_u32(argv[0], "Translator Block",
896 decimal_format, &inode.osd1.hurd1.h_i_translator);
898 modify_u32(argv[0], "Fragment address", decimal_format, &inode.i_faddr);
901 frag = &inode.osd2.hurd2.h_i_frag;
902 fsize = &inode.osd2.hurd2.h_i_fsize;
905 frag = &inode.osd2.masix2.m_i_frag;
906 fsize = &inode.osd2.masix2.m_i_fsize;
912 modify_u8(argv[0], "Fragment number", decimal_format, frag);
914 modify_u8(argv[0], "Fragment size", decimal_format, fsize);
916 for (i=0; i < EXT2_NDIR_BLOCKS; i++) {
917 sprintf(buf, "Direct Block #%d", i);
918 modify_u32(argv[0], buf, decimal_format, &inode.i_block[i]);
920 modify_u32(argv[0], "Indirect Block", decimal_format,
921 &inode.i_block[EXT2_IND_BLOCK]);
922 modify_u32(argv[0], "Double Indirect Block", decimal_format,
923 &inode.i_block[EXT2_DIND_BLOCK]);
924 modify_u32(argv[0], "Triple Indirect Block", decimal_format,
925 &inode.i_block[EXT2_TIND_BLOCK]);
926 if (debugfs_write_inode(inode_num, &inode, argv[1]))
930 void do_change_working_dir(int argc, char *argv[])
935 if (common_inode_args_process(argc, argv, &inode, 0))
938 retval = ext2fs_check_directory(current_fs, inode);
940 com_err(argv[1], retval, 0);
947 void do_print_working_directory(int argc, char *argv[])
950 char *pathname = NULL;
952 if (common_args_process(argc, argv, 1, 1,
953 "print_working_directory", "", 0))
956 retval = ext2fs_get_pathname(current_fs, cwd, 0, &pathname);
958 com_err(argv[0], retval,
959 "while trying to get pathname of cwd");
961 printf("[pwd] INODE: %6u PATH: %s\n",
962 cwd, pathname ? pathname : "NULL");
967 retval = ext2fs_get_pathname(current_fs, root, 0, &pathname);
969 com_err(argv[0], retval,
970 "while trying to get pathname of root");
972 printf("[root] INODE: %6u PATH: %s\n",
973 root, pathname ? pathname : "NULL");
982 * Given a mode, return the ext2 file type
984 static int ext2_file_type(unsigned int mode)
986 if (LINUX_S_ISREG(mode))
987 return EXT2_FT_REG_FILE;
989 if (LINUX_S_ISDIR(mode))
992 if (LINUX_S_ISCHR(mode))
993 return EXT2_FT_CHRDEV;
995 if (LINUX_S_ISBLK(mode))
996 return EXT2_FT_BLKDEV;
998 if (LINUX_S_ISLNK(mode))
999 return EXT2_FT_SYMLINK;
1001 if (LINUX_S_ISFIFO(mode))
1002 return EXT2_FT_FIFO;
1004 if (LINUX_S_ISSOCK(mode))
1005 return EXT2_FT_SOCK;
1010 static void make_link(char *sourcename, char *destname)
1013 struct ext2_inode inode;
1016 char *dest, *cp, *basename;
1019 * Get the source inode
1021 ino = string_to_inode(sourcename);
1024 basename = strrchr(sourcename, '/');
1028 basename = sourcename;
1030 * Figure out the destination. First see if it exists and is
1033 if (! (retval=ext2fs_namei(current_fs, root, cwd, destname, &dir)))
1037 * OK, it doesn't exist. See if it is
1038 * '<dir>/basename' or 'basename'
1040 cp = strrchr(destname, '/');
1043 dir = string_to_inode(destname);
1053 if (debugfs_read_inode(ino, &inode, sourcename))
1056 retval = ext2fs_link(current_fs, dir, dest, ino,
1057 ext2_file_type(inode.i_mode));
1059 com_err("make_link", retval, 0);
1064 void do_link(int argc, char *argv[])
1066 if (common_args_process(argc, argv, 3, 3, "link",
1067 "<source file> <dest_name>", CHECK_FS_RW))
1070 make_link(argv[1], argv[2]);
1073 static int mark_blocks_proc(ext2_filsys fs, blk_t *blocknr,
1074 int blockcnt EXT2FS_ATTR((unused)),
1075 void *private EXT2FS_ATTR((unused)))
1080 ext2fs_block_alloc_stats(fs, block, +1);
1084 void do_undel(int argc, char *argv[])
1087 struct ext2_inode inode;
1089 if (common_args_process(argc, argv, 2, 3, "undelete",
1090 "<inode_num> [dest_name]",
1091 CHECK_FS_RW | CHECK_FS_BITMAPS))
1094 ino = string_to_inode(argv[1]);
1098 if (debugfs_read_inode(ino, &inode, argv[1]))
1101 if (ext2fs_test_inode_bitmap(current_fs->inode_map, ino)) {
1102 com_err(argv[1], 0, "Inode is not marked as deleted");
1107 * XXX this function doesn't handle changing the links count on the
1108 * parent directory when undeleting a directory.
1110 inode.i_links_count = LINUX_S_ISDIR(inode.i_mode) ? 2 : 1;
1113 if (debugfs_write_inode(ino, &inode, argv[0]))
1116 ext2fs_block_iterate(current_fs, ino, 0, NULL,
1117 mark_blocks_proc, NULL);
1119 ext2fs_inode_alloc_stats2(current_fs, ino, +1, 0);
1122 make_link(argv[1], argv[2]);
1125 static void unlink_file_by_name(char *filename)
1131 basename = strrchr(filename, '/');
1134 dir = string_to_inode(filename);
1139 basename = filename;
1141 retval = ext2fs_unlink(current_fs, dir, basename, 0, 0);
1143 com_err("unlink_file_by_name", retval, 0);
1147 void do_unlink(int argc, char *argv[])
1149 if (common_args_process(argc, argv, 2, 2, "link",
1150 "<pathname>", CHECK_FS_RW))
1153 unlink_file_by_name(argv[1]);
1156 void do_find_free_block(int argc, char *argv[])
1158 blk_t free_blk, goal;
1163 if ((argc > 3) || (argc==2 && *argv[1] == '?')) {
1164 com_err(argv[0], 0, "Usage: find_free_block [count [goal]]");
1167 if (check_fs_open(argv[0]))
1171 count = strtol(argv[1],&tmp,0);
1173 com_err(argv[0], 0, "Bad count - %s", argv[1]);
1180 goal = strtol(argv[2], &tmp, 0);
1182 com_err(argv[0], 0, "Bad goal - %s", argv[1]);
1187 goal = current_fs->super->s_first_data_block;
1189 printf("Free blocks found: ");
1190 free_blk = goal - 1;
1191 while (count-- > 0) {
1192 retval = ext2fs_new_block(current_fs, free_blk + 1, 0,
1195 com_err("ext2fs_new_block", retval, 0);
1198 printf("%u ", free_blk);
1203 void do_find_free_inode(int argc, char *argv[])
1205 ext2_ino_t free_inode, dir;
1210 if (argc > 3 || (argc>1 && *argv[1] == '?')) {
1211 com_err(argv[0], 0, "Usage: find_free_inode [dir] [mode]");
1214 if (check_fs_open(argv[0]))
1218 dir = strtol(argv[1], &tmp, 0);
1220 com_err(argv[0], 0, "Bad dir - %s", argv[1]);
1227 mode = strtol(argv[2], &tmp, 0);
1229 com_err(argv[0], 0, "Bad mode - %s", argv[2]);
1235 retval = ext2fs_new_inode(current_fs, dir, mode, 0, &free_inode);
1237 com_err("ext2fs_new_inode", retval, 0);
1239 printf("Free inode found: %u\n", free_inode);
1242 static errcode_t copy_file(int fd, ext2_ino_t newfile)
1244 ext2_file_t e2_file;
1247 unsigned int written;
1251 retval = ext2fs_file_open(current_fs, newfile,
1252 EXT2_FILE_WRITE, &e2_file);
1257 got = read(fd, buf, sizeof(buf));
1266 retval = ext2fs_file_write(e2_file, ptr,
1275 retval = ext2fs_file_close(e2_file);
1279 (void) ext2fs_file_close(e2_file);
1284 void do_write(int argc, char *argv[])
1287 struct stat statbuf;
1290 struct ext2_inode inode;
1292 if (common_args_process(argc, argv, 3, 3, "write",
1293 "<native file> <new file>", CHECK_FS_RW))
1296 fd = open(argv[1], O_RDONLY);
1298 com_err(argv[1], errno, 0);
1301 if (fstat(fd, &statbuf) < 0) {
1302 com_err(argv[1], errno, 0);
1307 retval = ext2fs_namei(current_fs, root, cwd, argv[2], &newfile);
1309 com_err(argv[0], 0, "The file '%s' already exists\n", argv[2]);
1314 retval = ext2fs_new_inode(current_fs, cwd, 010755, 0, &newfile);
1316 com_err(argv[0], retval, 0);
1320 printf("Allocated inode: %u\n", newfile);
1321 retval = ext2fs_link(current_fs, cwd, argv[2], newfile,
1323 if (retval == EXT2_ET_DIR_NO_SPACE) {
1324 retval = ext2fs_expand_dir(current_fs, cwd);
1326 com_err(argv[0], retval, "while expanding directory");
1329 retval = ext2fs_link(current_fs, cwd, argv[2], newfile,
1333 com_err(argv[2], retval, 0);
1337 if (ext2fs_test_inode_bitmap(current_fs->inode_map,newfile))
1338 com_err(argv[0], 0, "Warning: inode already set");
1339 ext2fs_inode_alloc_stats2(current_fs, newfile, +1, 0);
1340 memset(&inode, 0, sizeof(inode));
1341 inode.i_mode = (statbuf.st_mode & ~LINUX_S_IFMT) | LINUX_S_IFREG;
1342 inode.i_atime = inode.i_ctime = inode.i_mtime =
1343 current_fs->now ? current_fs->now : time(0);
1344 inode.i_links_count = 1;
1345 inode.i_size = statbuf.st_size;
1346 if (debugfs_write_new_inode(newfile, &inode, argv[0])) {
1350 if (LINUX_S_ISREG(inode.i_mode)) {
1351 retval = copy_file(fd, newfile);
1353 com_err("copy_file", retval, 0);
1358 void do_mknod(int argc, char *argv[])
1360 unsigned long mode, major, minor;
1363 struct ext2_inode inode;
1366 if (check_fs_open(argv[0]))
1368 if (argc < 3 || argv[2][1]) {
1370 com_err(argv[0], 0, "Usage: mknod <name> [p| [c|b] <major> <minor>]");
1373 mode = minor = major = 0;
1374 switch (argv[2][0]) {
1376 mode = LINUX_S_IFIFO;
1377 filetype = EXT2_FT_FIFO;
1381 mode = LINUX_S_IFCHR;
1382 filetype = EXT2_FT_CHRDEV;
1386 mode = LINUX_S_IFBLK;
1387 filetype = EXT2_FT_BLKDEV;
1395 major = strtoul(argv[3], argv+3, 0);
1396 minor = strtoul(argv[4], argv+4, 0);
1397 if (major > 65535 || minor > 65535 || argv[3][0] || argv[4][0])
1402 if (check_fs_read_write(argv[0]))
1404 retval = ext2fs_new_inode(current_fs, cwd, 010755, 0, &newfile);
1406 com_err(argv[0], retval, 0);
1409 printf("Allocated inode: %u\n", newfile);
1410 retval = ext2fs_link(current_fs, cwd, argv[1], newfile, filetype);
1411 if (retval == EXT2_ET_DIR_NO_SPACE) {
1412 retval = ext2fs_expand_dir(current_fs, cwd);
1414 com_err(argv[0], retval, "while expanding directory");
1417 retval = ext2fs_link(current_fs, cwd, argv[1], newfile,
1421 com_err(argv[1], retval, 0);
1424 if (ext2fs_test_inode_bitmap(current_fs->inode_map,newfile))
1425 com_err(argv[0], 0, "Warning: inode already set");
1426 ext2fs_mark_inode_bitmap(current_fs->inode_map, newfile);
1427 ext2fs_mark_ib_dirty(current_fs);
1428 memset(&inode, 0, sizeof(inode));
1429 inode.i_mode = mode;
1430 inode.i_atime = inode.i_ctime = inode.i_mtime =
1431 current_fs->now ? current_fs->now : time(0);
1432 if ((major < 256) && (minor < 256)) {
1433 inode.i_block[0] = major*256+minor;
1434 inode.i_block[1] = 0;
1436 inode.i_block[0] = 0;
1437 inode.i_block[1] = (minor & 0xff) | (major << 8) | ((minor & ~0xff) << 12);
1439 inode.i_links_count = 1;
1440 if (debugfs_write_new_inode(newfile, &inode, argv[0]))
1444 void do_mkdir(int argc, char *argv[])
1451 if (common_args_process(argc, argv, 2, 2, "mkdir",
1452 "<filename>", CHECK_FS_RW))
1455 cp = strrchr(argv[1], '/');
1458 parent = string_to_inode(argv[1]);
1460 com_err(argv[1], ENOENT, 0);
1470 retval = ext2fs_mkdir(current_fs, parent, 0, name);
1471 if (retval == EXT2_ET_DIR_NO_SPACE) {
1472 retval = ext2fs_expand_dir(current_fs, parent);
1474 com_err("argv[0]", retval, "while expanding directory");
1480 com_err("ext2fs_mkdir", retval, 0);
1486 static int release_blocks_proc(ext2_filsys fs, blk_t *blocknr,
1487 int blockcnt EXT2FS_ATTR((unused)),
1488 void *private EXT2FS_ATTR((unused)))
1493 ext2fs_block_alloc_stats(fs, block, -1);
1497 static void kill_file_by_inode(ext2_ino_t inode)
1499 struct ext2_inode inode_buf;
1501 if (debugfs_read_inode(inode, &inode_buf, 0))
1503 inode_buf.i_dtime = current_fs->now ? current_fs->now : time(0);
1504 if (debugfs_write_inode(inode, &inode_buf, 0))
1506 if (!ext2fs_inode_has_valid_blocks(&inode_buf))
1509 ext2fs_block_iterate(current_fs, inode, 0, NULL,
1510 release_blocks_proc, NULL);
1512 ext2fs_inode_alloc_stats2(current_fs, inode, -1,
1513 LINUX_S_ISDIR(inode_buf.i_mode));
1517 void do_kill_file(int argc, char *argv[])
1519 ext2_ino_t inode_num;
1521 if (common_inode_args_process(argc, argv, &inode_num, CHECK_FS_RW))
1524 kill_file_by_inode(inode_num);
1527 void do_rm(int argc, char *argv[])
1530 ext2_ino_t inode_num;
1531 struct ext2_inode inode;
1533 if (common_args_process(argc, argv, 2, 2, "rm",
1534 "<filename>", CHECK_FS_RW))
1537 retval = ext2fs_namei(current_fs, root, cwd, argv[1], &inode_num);
1539 com_err(argv[0], retval, "while trying to resolve filename");
1543 if (debugfs_read_inode(inode_num, &inode, argv[0]))
1546 if (LINUX_S_ISDIR(inode.i_mode)) {
1547 com_err(argv[0], 0, "file is a directory");
1551 --inode.i_links_count;
1552 if (debugfs_write_inode(inode_num, &inode, argv[0]))
1555 unlink_file_by_name(argv[1]);
1556 if (inode.i_links_count == 0)
1557 kill_file_by_inode(inode_num);
1565 static int rmdir_proc(ext2_ino_t dir EXT2FS_ATTR((unused)),
1566 int entry EXT2FS_ATTR((unused)),
1567 struct ext2_dir_entry *dirent,
1568 int offset EXT2FS_ATTR((unused)),
1569 int blocksize EXT2FS_ATTR((unused)),
1570 char *buf EXT2FS_ATTR((unused)),
1573 struct rd_struct *rds = (struct rd_struct *) private;
1575 if (dirent->inode == 0)
1577 if (((dirent->name_len&0xFF) == 1) && (dirent->name[0] == '.'))
1579 if (((dirent->name_len&0xFF) == 2) && (dirent->name[0] == '.') &&
1580 (dirent->name[1] == '.')) {
1581 rds->parent = dirent->inode;
1588 void do_rmdir(int argc, char *argv[])
1591 ext2_ino_t inode_num;
1592 struct ext2_inode inode;
1593 struct rd_struct rds;
1595 if (common_args_process(argc, argv, 2, 2, "rmdir",
1596 "<filename>", CHECK_FS_RW))
1599 retval = ext2fs_namei(current_fs, root, cwd, argv[1], &inode_num);
1601 com_err(argv[0], retval, "while trying to resolve filename");
1605 if (debugfs_read_inode(inode_num, &inode, argv[0]))
1608 if (!LINUX_S_ISDIR(inode.i_mode)) {
1609 com_err(argv[0], 0, "file is not a directory");
1616 retval = ext2fs_dir_iterate2(current_fs, inode_num, 0,
1617 0, rmdir_proc, &rds);
1619 com_err(argv[0], retval, "while iterating over directory");
1622 if (rds.empty == 0) {
1623 com_err(argv[0], 0, "directory not empty");
1627 inode.i_links_count = 0;
1628 if (debugfs_write_inode(inode_num, &inode, argv[0]))
1631 unlink_file_by_name(argv[1]);
1632 kill_file_by_inode(inode_num);
1635 if (debugfs_read_inode(rds.parent, &inode, argv[0]))
1637 if (inode.i_links_count > 1)
1638 inode.i_links_count--;
1639 if (debugfs_write_inode(rds.parent, &inode, argv[0]))
1644 void do_show_debugfs_params(int argc EXT2FS_ATTR((unused)),
1645 char *argv[] EXT2FS_ATTR((unused)))
1650 fprintf(out, "Open mode: read-%s\n",
1651 current_fs->flags & EXT2_FLAG_RW ? "write" : "only");
1652 fprintf(out, "Filesystem in use: %s\n",
1653 current_fs ? current_fs->device_name : "--none--");
1656 void do_expand_dir(int argc, char *argv[])
1661 if (common_inode_args_process(argc, argv, &inode, CHECK_FS_RW))
1664 retval = ext2fs_expand_dir(current_fs, inode);
1666 com_err("ext2fs_expand_dir", retval, 0);
1670 void do_features(int argc, char *argv[])
1674 if (check_fs_open(argv[0]))
1677 if ((argc != 1) && check_fs_read_write(argv[0]))
1679 for (i=1; i < argc; i++) {
1680 if (e2p_edit_feature(argv[i],
1681 ¤t_fs->super->s_feature_compat, 0))
1682 com_err(argv[0], 0, "Unknown feature: %s\n",
1685 ext2fs_mark_super_dirty(current_fs);
1687 print_features(current_fs->super, stdout);
1690 void do_bmap(int argc, char *argv[])
1697 if (common_args_process(argc, argv, 3, 3, argv[0],
1698 "<file> logical_blk", 0))
1701 ino = string_to_inode(argv[1]);
1704 blk = parse_ulong(argv[2], argv[0], "logical_block", &err);
1706 errcode = ext2fs_bmap(current_fs, ino, 0, 0, 0, blk, &pblk);
1708 com_err("argv[0]", errcode,
1709 "while mapping logical block %u\n", blk);
1712 printf("%u\n", pblk);
1715 void do_imap(int argc, char *argv[])
1718 unsigned long group, block, block_nr, offset;
1720 if (common_args_process(argc, argv, 2, 2, argv[0],
1723 ino = string_to_inode(argv[1]);
1727 group = (ino - 1) / EXT2_INODES_PER_GROUP(current_fs->super);
1728 offset = ((ino - 1) % EXT2_INODES_PER_GROUP(current_fs->super)) *
1729 EXT2_INODE_SIZE(current_fs->super);
1730 block = offset >> EXT2_BLOCK_SIZE_BITS(current_fs->super);
1731 if (!current_fs->group_desc[(unsigned)group].bg_inode_table) {
1732 com_err(argv[0], 0, "Inode table for group %lu is missing\n",
1736 block_nr = current_fs->group_desc[(unsigned)group].bg_inode_table +
1738 offset &= (EXT2_BLOCK_SIZE(current_fs->super) - 1);
1740 printf("Inode %d is part of block group %lu\n"
1741 "\tlocated at block %lu, offset 0x%04lx\n", ino, group,
1746 void do_set_current_time(int argc, char *argv[])
1750 if (common_args_process(argc, argv, 2, 2, argv[0],
1754 now = string_to_time(argv[1]);
1755 if (now == ((time_t) -1)) {
1756 com_err(argv[0], 0, "Couldn't parse argument as a time: %s\n",
1761 printf("Setting current time to %s\n", time_to_string(now));
1762 current_fs->now = now;
1766 static int source_file(const char *cmd_file, int sci_idx)
1771 int exit_status = 0;
1774 if (strcmp(cmd_file, "-") == 0)
1777 f = fopen(cmd_file, "r");
1783 setbuf(stdout, NULL);
1784 setbuf(stderr, NULL);
1786 if (fgets(buf, sizeof(buf), f) == NULL)
1788 cp = strchr(buf, '\n');
1791 cp = strchr(buf, '\r');
1794 printf("debugfs: %s\n", buf);
1795 retval = ss_execute_line(sci_idx, buf);
1797 ss_perror(sci_idx, retval, buf);
1804 int main(int argc, char **argv)
1808 const char *usage = "Usage: debugfs [-b blocksize] [-s superblock] [-f cmd_file] [-R request] [-V] [[-w] [-c] device]";
1810 int open_flags = EXT2_FLAG_SOFTSUPP_FEATURES;
1812 int exit_status = 0;
1814 blk_t superblock = 0;
1815 blk_t blocksize = 0;
1816 int catastrophic = 0;
1817 char *data_filename = 0;
1819 add_error_table(&et_ext2_error_table);
1820 fprintf (stderr, "debugfs %s (%s)\n", E2FSPROGS_VERSION,
1823 while ((c = getopt (argc, argv, "iwcR:f:b:s:Vd:")) != EOF) {
1832 data_filename = optarg;
1835 open_flags |= EXT2_FLAG_IMAGE_FILE;
1838 open_flags |= EXT2_FLAG_RW;
1841 blocksize = parse_ulong(optarg, argv[0],
1845 superblock = parse_ulong(optarg, argv[0],
1846 "superblock number", 0);
1852 /* Print version number and exit */
1853 fprintf(stderr, "\tUsing %s\n",
1854 error_message(EXT2_ET_BASE));
1857 com_err(argv[0], 0, usage);
1862 open_filesystem(argv[optind], open_flags,
1863 superblock, blocksize, catastrophic,
1866 sci_idx = ss_create_invocation("debugfs", "0.0", (char *) NULL,
1867 &debug_cmds, &retval);
1869 ss_perror(sci_idx, retval, "creating invocation");
1872 ss_get_readline(sci_idx);
1874 (void) ss_add_request_table (sci_idx, &ss_std_requests, 1, &retval);
1876 ss_perror(sci_idx, retval, "adding standard requests");
1881 retval = ss_execute_line(sci_idx, request);
1883 ss_perror(sci_idx, retval, request);
1886 } else if (cmd_file) {
1887 exit_status = source_file(cmd_file, sci_idx);
1895 remove_error_table(&et_ext2_error_table);