2 * logdump.c --- dump the contents of the journal out to a file
4 * Author: Stephen C. Tweedie, 2001 <sct@redhat.com>
5 * Copyright (C) 2001 Red Hat, Inc.
6 * Based on portions Copyright (C) 1994 Theodore Ts'o.
8 * This file may be redistributed under the terms of the GNU Public
22 #include <sys/types.h>
34 #include "blkid/blkid.h"
36 #include "ext2fs/fast_commit.h"
37 #include <uuid/uuid.h>
39 enum journal_location {JOURNAL_IS_INTERNAL, JOURNAL_IS_EXTERNAL};
41 #define ANY_BLOCK ((blk64_t) -1)
43 static int dump_all, dump_super, dump_old, dump_contents, dump_descriptors;
44 static blk64_t block_to_dump, bitmap_to_dump, inode_block_to_dump;
45 static unsigned int group_to_dump, inode_offset_to_dump;
46 static ext2_ino_t inode_to_dump;
50 enum journal_location where;
55 static void dump_journal(char *, FILE *, struct journal_source *);
57 static void dump_descriptor_block(FILE *, struct journal_source *,
58 char *, journal_superblock_t *,
59 unsigned int *, int, tid_t);
61 static void dump_revoke_block(FILE *, char *, journal_superblock_t *,
62 unsigned int, int, tid_t);
64 static void dump_metadata_block(FILE *, struct journal_source *,
65 journal_superblock_t*,
66 unsigned int, unsigned int, unsigned int,
69 static void dump_fc_block(FILE *out_file, char *buf, int blocksize,
70 int transaction, int *fc_done, int dump_old);
72 static void do_hexdump (FILE *, char *, int);
74 #define WRAP(jsb, blocknr) \
75 if (blocknr >= be32_to_cpu((jsb)->s_maxlen)) \
76 blocknr -= (be32_to_cpu((jsb)->s_maxlen) - \
77 be32_to_cpu((jsb)->s_first));
79 void do_logdump(int argc, char **argv, int sci_idx EXT2FS_ATTR((unused)),
80 void *infop EXT2FS_ATTR((unused)))
87 char *inode_spec = NULL;
88 char *journal_fn = NULL;
91 ext2_ino_t journal_inum;
92 struct ext2_inode journal_inode;
93 ext2_file_t journal_file;
95 struct journal_source journal_source;
96 struct ext2_super_block *es = NULL;
98 journal_source.where = JOURNAL_IS_INTERNAL;
99 journal_source.fd = 0;
100 journal_source.file = 0;
105 dump_descriptors = 1;
106 block_to_dump = ANY_BLOCK;
108 inode_block_to_dump = ANY_BLOCK;
112 while ((c = getopt (argc, argv, "ab:ci:f:OsS")) != EOF) {
118 block_to_dump = strtoul(optarg, &tmp, 0);
121 "Bad block number - %s", optarg);
124 dump_descriptors = 0;
134 dump_descriptors = 0;
149 if (optind != argc && optind != argc-1) {
154 es = current_fs->super;
157 int inode_group, group_offset, inodes_per_block;
159 if (check_fs_open(argv[0]))
162 inode_to_dump = string_to_inode(inode_spec);
166 inode_group = ((inode_to_dump - 1)
167 / es->s_inodes_per_group);
168 group_offset = ((inode_to_dump - 1)
169 % es->s_inodes_per_group);
170 inodes_per_block = (current_fs->blocksize
171 / sizeof(struct ext2_inode));
173 inode_block_to_dump =
174 ext2fs_inode_table_loc(current_fs, inode_group) +
175 (group_offset / inodes_per_block);
176 inode_offset_to_dump = ((group_offset % inodes_per_block)
177 * sizeof(struct ext2_inode));
178 printf("Inode %u is at group %u, block %llu, offset %u\n",
179 inode_to_dump, inode_group,
180 inode_block_to_dump, inode_offset_to_dump);
183 if (optind == argc) {
186 out_fn = argv[optind];
187 out_file = fopen(out_fn, "w");
189 com_err(argv[0], errno, "while opening %s for logdump",
195 if (block_to_dump != ANY_BLOCK && current_fs != NULL) {
196 group_to_dump = ((block_to_dump -
197 es->s_first_data_block)
198 / es->s_blocks_per_group);
199 bitmap_to_dump = ext2fs_block_bitmap_loc(current_fs, group_to_dump);
202 if (!journal_fn && check_fs_open(argv[0]))
206 /* Set up to read journal from a regular file somewhere */
207 journal_fd = open(journal_fn, O_RDONLY, 0);
208 if (journal_fd < 0) {
209 com_err(argv[0], errno, "while opening %s for logdump",
214 journal_source.where = JOURNAL_IS_EXTERNAL;
215 journal_source.fd = journal_fd;
216 } else if ((journal_inum = es->s_journal_inum)) {
218 if (es->s_jnl_backup_type != EXT3_JNL_BACKUP_BLOCKS) {
220 "no journal backup in super block\n");
223 memset(&journal_inode, 0, sizeof(struct ext2_inode));
224 memcpy(&journal_inode.i_block[0], es->s_jnl_blocks,
226 journal_inode.i_size_high = es->s_jnl_blocks[15];
227 journal_inode.i_size = es->s_jnl_blocks[16];
228 journal_inode.i_links_count = 1;
229 journal_inode.i_mode = LINUX_S_IFREG | 0600;
231 if (debugfs_read_inode(journal_inum, &journal_inode,
236 retval = ext2fs_file_open2(current_fs, journal_inum,
237 &journal_inode, 0, &journal_file);
239 com_err(argv[0], retval, "while opening ext2 file");
242 journal_source.where = JOURNAL_IS_INTERNAL;
243 journal_source.file = journal_file;
247 uuid_unparse(es->s_journal_uuid, uuid);
248 journal_fn = blkid_get_devname(NULL, "UUID", uuid);
250 journal_fn = blkid_devno_to_devname(es->s_journal_dev);
252 com_err(argv[0], 0, "filesystem has no journal");
255 journal_fd = open(journal_fn, O_RDONLY, 0);
256 if (journal_fd < 0) {
257 com_err(argv[0], errno, "while opening %s for logdump",
262 fprintf(out_file, "Using external journal found at %s\n",
265 journal_source.where = JOURNAL_IS_EXTERNAL;
266 journal_source.fd = journal_fd;
269 dump_journal(argv[0], out_file, &journal_source);
271 if (journal_source.where == JOURNAL_IS_INTERNAL)
272 ext2fs_file_close(journal_file);
277 if (out_file && (out_file != stdout))
283 fprintf(stderr, "%s: Usage: logdump [-acsOS] [-b<block>] [-i<filespec>]\n\t"
284 "[-f<journal_file>] [output_file]\n", argv[0]);
288 static int read_journal_block(const char *cmd, struct journal_source *source,
289 ext2_loff_t offset, char *buf, unsigned int size)
294 if (source->where == JOURNAL_IS_EXTERNAL) {
295 if (lseek(source->fd, offset, SEEK_SET) < 0) {
299 retval = read(source->fd, buf, size);
307 retval = ext2fs_file_llseek(source->file, offset,
308 EXT2_SEEK_SET, NULL);
311 com_err(cmd, retval, "while seeking in reading journal");
314 retval = ext2fs_file_read(source->file, buf, size, &got);
317 com_err(cmd, retval, "while reading journal");
322 com_err(cmd, 0, "short read (read %u, expected %u) "
323 "while reading journal", got, size);
329 static const char *type_to_name(int btype)
332 case JBD2_DESCRIPTOR_BLOCK:
333 return "descriptor block";
334 case JBD2_COMMIT_BLOCK:
335 return "commit block";
336 case JBD2_SUPERBLOCK_V1:
337 return "V1 superblock";
338 case JBD2_SUPERBLOCK_V2:
339 return "V2 superblock";
340 case JBD2_REVOKE_BLOCK:
341 return "revoke table";
343 return "unrecognised type";
347 static void dump_journal(char *cmdname, FILE *out_file,
348 struct journal_source *source)
350 struct ext2_super_block *sb;
351 char jsb_buffer[1024];
353 journal_superblock_t *jsb;
354 unsigned int blocksize = 1024;
356 __u32 magic, sequence, blocktype;
357 journal_header_t *header;
359 unsigned int blocknr = 0;
362 /* First, check to see if there's an ext2 superblock header */
363 retval = read_journal_block(cmdname, source, 0, buf, 2048);
367 jsb = (journal_superblock_t *) buf;
368 sb = (struct ext2_super_block *) (buf+1024);
369 #ifdef WORDS_BIGENDIAN
370 if (sb->s_magic == ext2fs_swab16(EXT2_SUPER_MAGIC))
371 ext2fs_swap_super(sb);
374 if ((be32_to_cpu(jsb->s_header.h_magic) != JBD2_MAGIC_NUMBER) &&
375 (sb->s_magic == EXT2_SUPER_MAGIC) &&
376 ext2fs_has_feature_journal_dev(sb)) {
377 blocksize = EXT2_BLOCK_SIZE(sb);
378 blocknr = (blocksize == 1024) ? 2 : 1;
379 uuid_unparse(sb->s_uuid, jsb_buffer);
380 fprintf(out_file, "Ext2 superblock header found.\n");
382 fprintf(out_file, "\tuuid=%s\n", jsb_buffer);
383 fprintf(out_file, "\tblocksize=%d\n", blocksize);
384 fprintf(out_file, "\tjournal data size %lu\n",
385 (unsigned long) ext2fs_blocks_count(sb));
389 /* Next, read the journal superblock */
390 retval = read_journal_block(cmdname, source,
391 ((ext2_loff_t) blocknr) * blocksize,
397 e2p_list_journal_super(out_file, jsb_buffer,
398 current_fs->blocksize, 0);
399 fputc('\n', out_file);
402 jsb = (journal_superblock_t *) jsb_buffer;
403 if (be32_to_cpu(jsb->s_header.h_magic) != JBD2_MAGIC_NUMBER) {
405 "Journal superblock magic number invalid!\n");
408 blocksize = be32_to_cpu(jsb->s_blocksize);
409 transaction = be32_to_cpu(jsb->s_sequence);
410 blocknr = be32_to_cpu(jsb->s_start);
412 fprintf(out_file, "Journal starts at block %u, transaction %u\n",
413 blocknr, transaction);
416 /* Empty journal, nothing to do. */
424 retval = read_journal_block(cmdname, source,
425 ((ext2_loff_t) blocknr) * blocksize,
430 header = (journal_header_t *) buf;
432 magic = be32_to_cpu(header->h_magic);
433 sequence = be32_to_cpu(header->h_sequence);
434 blocktype = be32_to_cpu(header->h_blocktype);
436 if (magic != JBD2_MAGIC_NUMBER) {
437 fprintf (out_file, "No magic number at block %u: "
438 "end of journal.\n", blocknr);
442 if (sequence != transaction) {
443 fprintf (out_file, "Found sequence %u (not %u) at "
444 "block %u: end of journal.\n",
445 sequence, transaction, blocknr);
450 if (dump_descriptors) {
451 fprintf (out_file, "Found expected sequence %u, "
452 "type %u (%s) at block %u\n",
454 type_to_name(blocktype), blocknr);
458 case JBD2_DESCRIPTOR_BLOCK:
459 dump_descriptor_block(out_file, source, buf, jsb,
464 case JBD2_COMMIT_BLOCK:
470 case JBD2_REVOKE_BLOCK:
471 dump_revoke_block(out_file, buf, jsb,
479 fprintf (out_file, "Unexpected block type %u at "
480 "block %u.\n", blocktype, blocknr);
486 blocknr = be32_to_cpu(jsb->s_maxlen) - jbd2_journal_get_num_fc_blks(jsb) + 1;
487 while (blocknr <= be32_to_cpu(jsb->s_maxlen)) {
488 retval = read_journal_block(cmdname, source,
489 ((ext2_loff_t) blocknr) * blocksize,
494 dump_fc_block(out_file, buf, blocksize, transaction, &fc_done,
496 if (!dump_old && fc_done)
502 static inline size_t journal_super_tag_bytes(journal_superblock_t *jsb)
506 if (JSB_HAS_INCOMPAT_FEATURE(jsb, JBD2_FEATURE_INCOMPAT_CSUM_V3))
507 return sizeof(journal_block_tag3_t);
509 sz = sizeof(journal_block_tag_t);
511 if (JSB_HAS_INCOMPAT_FEATURE(jsb, JBD2_FEATURE_INCOMPAT_CSUM_V2))
514 if (JSB_HAS_INCOMPAT_FEATURE(jsb, JBD2_FEATURE_INCOMPAT_64BIT))
517 return sz - sizeof(__u32);
520 static void dump_fc_block(FILE *out_file, char *buf, int blocksize,
521 int transaction, int *fc_done, int dump_old)
523 struct ext4_fc_tl *tl;
524 struct ext4_fc_head *head;
525 struct ext4_fc_add_range *add_range;
526 struct ext4_fc_del_range *del_range;
527 struct ext4_fc_dentry_info *dentry_info;
528 struct ext4_fc_tail *tail;
529 struct ext3_extent *ex;
532 fc_for_each_tl(buf, buf + blocksize, tl) {
533 switch (le16_to_cpu(tl->fc_tag)) {
534 case EXT4_FC_TAG_ADD_RANGE:
536 (struct ext4_fc_add_range *)ext4_fc_tag_val(tl);
537 ex = (struct ext3_extent *)add_range->fc_ex;
539 "tag %s, inode %d, lblk %d, pblk %ld, len %d\n",
541 le32_to_cpu(add_range->fc_ino),
542 le32_to_cpu(ex->ee_block),
543 le32_to_cpu(ex->ee_start) +
544 (((__u64) le16_to_cpu(ex->ee_start_hi)) << 32),
545 le16_to_cpu(ex->ee_len) > EXT_INIT_MAX_LEN ?
546 le16_to_cpu(ex->ee_len) - EXT_INIT_MAX_LEN :
547 le16_to_cpu(ex->ee_len));
549 case EXT4_FC_TAG_DEL_RANGE:
551 (struct ext4_fc_del_range *)ext4_fc_tag_val(tl);
552 fprintf(out_file, "tag %s, inode %d, lblk %d, len %d\n",
554 le32_to_cpu(del_range->fc_ino),
555 le32_to_cpu(del_range->fc_lblk),
556 le32_to_cpu(del_range->fc_len));
558 case EXT4_FC_TAG_LINK:
559 case EXT4_FC_TAG_UNLINK:
560 case EXT4_FC_TAG_CREAT:
562 (struct ext4_fc_dentry_info *)
565 "tag %s, parent %d, ino %d, name \"%s\"\n",
567 le32_to_cpu(dentry_info->fc_parent_ino),
568 le32_to_cpu(dentry_info->fc_ino),
569 dentry_info->fc_dname);
571 case EXT4_FC_TAG_INODE:
572 fprintf(out_file, "tag %s, inode %d\n",
574 le32_to_cpu(((struct ext4_fc_inode *)
575 ext4_fc_tag_val(tl))->fc_ino));
577 case EXT4_FC_TAG_PAD:
578 fprintf(out_file, "tag %s\n", tag2str(tl->fc_tag));
580 case EXT4_FC_TAG_TAIL:
581 tail = (struct ext4_fc_tail *)ext4_fc_tag_val(tl);
582 fprintf(out_file, "tag %s, tid %d\n",
584 le32_to_cpu(tail->fc_tid));
586 le32_to_cpu(tail->fc_tid) < transaction) {
591 case EXT4_FC_TAG_HEAD:
592 fprintf(out_file, "\n*** Fast Commit Area ***\n");
593 head = (struct ext4_fc_head *)ext4_fc_tag_val(tl);
594 fprintf(out_file, "tag %s, features 0x%x, tid %d\n",
596 le32_to_cpu(head->fc_features),
597 le32_to_cpu(head->fc_tid));
599 le32_to_cpu(head->fc_tid) < transaction) {
611 static void dump_descriptor_block(FILE *out_file,
612 struct journal_source *source,
614 journal_superblock_t *jsb,
615 unsigned int *blockp, int blocksize,
618 int offset, tag_size, csum_size = 0;
620 journal_block_tag_t *tag;
621 unsigned int blocknr;
625 tag_size = journal_super_tag_bytes(jsb);
626 offset = sizeof(journal_header_t);
629 if (JSB_HAS_INCOMPAT_FEATURE(jsb, JBD2_FEATURE_INCOMPAT_CSUM_V3) ||
630 JSB_HAS_INCOMPAT_FEATURE(jsb, JBD2_FEATURE_INCOMPAT_CSUM_V2))
631 csum_size = sizeof(struct jbd2_journal_block_tail);
634 fprintf(out_file, "Dumping descriptor block, sequence %u, at "
635 "block %u:\n", transaction, blocknr);
641 /* Work out the location of the current tag, and skip to
644 tag = (journal_block_tag_t *) tagp;
647 /* ... and if we have gone too far, then we've reached the
648 end of this block. */
649 if (offset > blocksize - csum_size)
652 tag_block = be32_to_cpu(tag->t_blocknr);
653 tag_flags = be16_to_cpu(tag->t_flags);
655 if (!(tag_flags & JBD2_FLAG_SAME_UUID))
658 dump_metadata_block(out_file, source, jsb,
659 blocknr, tag_block, tag_flags, blocksize,
665 } while (!(tag_flags & JBD2_FLAG_LAST_TAG));
671 static void dump_revoke_block(FILE *out_file, char *buf,
672 journal_superblock_t *jsb EXT2FS_ATTR((unused)),
673 unsigned int blocknr,
674 int blocksize EXT2FS_ATTR((unused)),
678 jbd2_journal_revoke_header_t *header;
679 unsigned long long rblock;
680 int tag_size = sizeof(__u32);
683 fprintf(out_file, "Dumping revoke block, sequence %u, at "
684 "block %u:\n", transaction, blocknr);
686 if (be32_to_cpu(jsb->s_feature_incompat) & JBD2_FEATURE_INCOMPAT_64BIT)
687 tag_size = sizeof(__u64);
689 header = (jbd2_journal_revoke_header_t *) buf;
690 offset = sizeof(jbd2_journal_revoke_header_t);
691 max = be32_to_cpu(header->r_count);
693 while (offset < max) {
694 if (tag_size == sizeof(__u32)) {
695 __u32 *entry = (__u32 *) (buf + offset);
696 rblock = be32_to_cpu(*entry);
698 __u64 *entry = (__u64 *) (buf + offset);
699 rblock = ext2fs_be64_to_cpu(*entry);
701 if (dump_all || rblock == block_to_dump) {
702 fprintf(out_file, " Revoke FS block %llu", rblock);
704 fprintf(out_file, "\n");
706 fprintf(out_file," at block %u, sequence %u\n",
707 blocknr, transaction);
714 static void show_extent(FILE *out_file, int start_extent, int end_extent,
717 if (start_extent >= 0 && first_block != 0)
718 fprintf(out_file, "(%d+%u): %u ",
719 start_extent, end_extent-start_extent, first_block);
722 static void show_indirect(FILE *out_file, const char *name, __u32 where)
725 fprintf(out_file, "(%s): %u ", name, where);
729 static void dump_metadata_block(FILE *out_file, struct journal_source *source,
730 journal_superblock_t *jsb EXT2FS_ATTR((unused)),
731 unsigned int log_blocknr,
732 unsigned int fs_blocknr,
733 unsigned int log_tag_flags,
741 || (fs_blocknr == block_to_dump)
742 || (fs_blocknr == inode_block_to_dump)
743 || (fs_blocknr == bitmap_to_dump)))
746 fprintf(out_file, " FS block %u logged at ", fs_blocknr);
748 fprintf(out_file, "sequence %u, ", transaction);
749 fprintf(out_file, "journal block %u (flags 0x%x)\n", log_blocknr,
752 /* There are two major special cases to parse:
754 * If this block is a block
755 * bitmap block, we need to give it special treatment so that we
756 * can log any allocates and deallocates which affect the
757 * block_to_dump query block.
759 * If the block is an inode block for the inode being searched
760 * for, then we need to dump the contents of that inode
761 * structure symbolically.
764 if (!(dump_contents && dump_all)
765 && fs_blocknr != block_to_dump
766 && fs_blocknr != bitmap_to_dump
767 && fs_blocknr != inode_block_to_dump)
770 retval = read_journal_block("logdump", source,
771 ((ext2_loff_t) log_blocknr) * blocksize,
776 if (fs_blocknr == bitmap_to_dump) {
777 struct ext2_super_block *super;
780 super = current_fs->super;
781 offset = ((block_to_dump - super->s_first_data_block) %
782 super->s_blocks_per_group);
784 fprintf(out_file, " (block bitmap for block %llu: "
787 ext2fs_test_bit(offset, buf) ? "SET" : "CLEAR");
790 if (fs_blocknr == inode_block_to_dump) {
791 struct ext2_inode *inode;
792 int first, prev, this, start_extent, i;
794 fprintf(out_file, " (inode block for inode %u):\n",
797 inode = (struct ext2_inode *) (buf + inode_offset_to_dump);
798 internal_dump_inode(out_file, " ", inode_to_dump, inode, 0);
800 /* Dump out the direct/indirect blocks here:
801 * internal_dump_inode can only dump them from the main
802 * on-disk inode, not from the journaled copy of the
805 fprintf (out_file, " Blocks: ");
806 first = prev = start_extent = -1;
808 for (i=0; i<EXT2_NDIR_BLOCKS; i++) {
809 this = inode->i_block[i];
810 if (start_extent >= 0 && this == prev+1) {
814 show_extent(out_file, start_extent, i, first);
819 show_extent(out_file, start_extent, i, first);
820 show_indirect(out_file, "IND", inode->i_block[i++]);
821 show_indirect(out_file, "DIND", inode->i_block[i++]);
822 show_indirect(out_file, "TIND", inode->i_block[i++]);
824 fprintf(out_file, "\n");
828 do_hexdump(out_file, buf, blocksize);
832 static void do_hexdump (FILE *out_file, char *buf, int blocksize)
840 charp = (char *) buf;
842 for (i=0; i<blocksize; i+=16) {
843 fprintf(out_file, " %04x: ", i);
844 for (j=0; j<16; j+=4)
845 fprintf(out_file, "%08x ", *intp++);
846 for (j=0; j<16; j++) {
848 if (c < ' ' || c >= 127)
850 fprintf(out_file, "%c", c);
852 fprintf(out_file, "\n");