Documentation/btrfs-zero-log.txt

   1 btrfs-zero-log(8)
   2 =================
   3
   4 NAME
   5 ----
   6 btrfs-zero-log - clear out log tree
   7
   8 SYNOPSIS
   9 --------
  10 *btrfs-zero-log* <dev>
  11
  12 DESCRIPTION
  13 -----------
  14 *btrfs-zero-log* will remove the log tree if log tree is corrupt, which will
  15 allow you to mount the filesystem again.
  16
  17 The common case where this happens has been fixed a long time ago,
  18 so it is unlikely that you will see this particular problem.
  19
  20 One can determine whether *btrfs-zero-log* is needed according to the kernel
  21 backtrace:
  22 ----
  23 ? replay_one_dir_item+0xb5/0xb5 [btrfs]
  24 ? walk_log_tree+0x9c/0x19d [btrfs]
  25 ? btrfs_read_fs_root_no_radix+0x169/0x1a1 [btrfs]
  26 ? btrfs_recover_log_trees+0x195/0x29c [btrfs]
  27 ? replay_one_dir_item+0xb5/0xb5 [btrfs]
  28 ? btree_read_extent_buffer_pages+0x76/0xbc [btrfs]
  29 ? open_ctree+0xff6/0x132c [btrfs]
  30 ----
  31
  32 If the errors are like above, then *btrfs-zero-log* should be used to clear
  33 the log and the filesystem may be mounted normally again.
  34
  35 NOTE: If you use btrfs as the root filesystem, you may want to include
  36 *btrfs-zero-log* into initramdisk if the log problems hits you often.
  37
  38 EXIT STATUS
  39 -----------
  40 *btrfs-zero-log* will return 0 if no error happened.
  41 Other exit code means some problems happened.
  42
  43 AUTHOR
  44 ------
  45 Written by Shilong Wang and Wenruo Qu.
  46
  47 COPYRIGHT
  48 ---------
  49 Copyright (C) 2013 FUJITSU LIMITED.
  50
  51 License GPLv2: GNU GPL version 2 <http://gnu.org/licenses/gpl.html>.
  52
  53 This is free software: you are free  to  change  and  redistribute  it. There is NO WARRANTY, to the extent permitted by law.
  54
  55 SEE ALSO
  56 --------
  57 `mkfs.btrfs`(8)