btrfs-orphan-cleaner-progress - Man Page

btrfs-orphan-cleaner-progress [args] mountpoint

The btrfs-orphan-cleaner-progress program shows live progress of the deletion of subvolumes that is happening in the background.

Ever deleted too many subvolumes at the same time, resulting in having a kernel thread "btrfs-cleaner" go wild using cpu or writing to disk? There's no way to stop this process any more, but at least we can get a good idea what progress it is making.

Because the needed information is retrieved using the btrfs kernel API, it has to be run as root.

btrfs-orphan-cleaner-progress shows the amount of orphaned subvolumes that are waiting to be removed. If current one that is being processed takes more than a fraction of time, progress will be reported with 2 minute intervals.

Example output:

 100 orphans left to clean
 dropping root 1294230 for at least 0 sec drop_progress (637928 EXTENT_DATA 0)
 dropping root 1294230 finished after at least 109 sec
 99 orphans left to clean
 dropping root 1094252 for at least 0 sec drop_progress (5504 DIR_ITEM 1048466060)
 dropping root 1094252 for at least 120 sec drop_progress (1058244 INODE_REF 1056848)
 dropping root 1094252 finished after at least 121 sec
 98 orphans left to clean
 dropping root 1299468 for at least 0 sec drop_progress (14216 DIR_INDEX 33)
 dropping root 1299468 finished after at least 17 sec
 97 orphans left to clean
 dropping root 1294116 for at least 0 sec drop_progress (4297 INODE_ITEM 0)
 dropping root 1294116 finished after at least 6 sec
 96 orphans left to clean
 dropping root 1094148 for at least 0 sec drop_progress (3193 INODE_REF 1558)
 dropping root 1094148 finished after at least 7 sec
 95 orphans left to clean
 dropping root 1294233 for at least 0 sec drop_progress (29155 INODE_REF 28406)
 dropping root 1294233 for at least 120 sec drop_progress (1718475 INODE_ITEM 0)
 dropping root 1294233 for at least 240 sec drop_progress (2930889 DIR_INDEX 17)
 dropping root 1294233 for at least 360 sec drop_progress (3739430 INODE_ITEM 0)
 dropping root 1294233 for at least 480 sec drop_progress (5077225 INODE_ITEM 0)
 dropping root 1294233 for at least 600 sec drop_progress (5762256 EXTENT_DATA 0)
 dropping root 1294233 for at least 720 sec drop_progress (6754272 INODE_REF 6754207)
 dropping root 1294233 for at least 840 sec drop_progress (7279795 INODE_ITEM 0)
 dropping root 1294233 for at least 960 sec drop_progress (7969363 DIR_ITEM 985984353)
 dropping root 1294233 for at least 1080 sec drop_progress (8304717 DIR_INDEX 25)
 dropping root 1294233 for at least 1200 sec drop_progress (8668644 EXTENT_DATA 0)
 dropping root 1294233 finished after at least 1292 sec
 94 orphans left to clean
 dropping root 1094253 for at least 0 sec drop_progress (15681 DIR_ITEM 1073933304)
 dropping root 1094253 for at least 120 sec drop_progress (937036 INODE_REF 936022)
 [...]
 73 orphans left to clean
 dropping root 1094244 for at least 0 sec drop_progress (183679 INODE_ITEM 0)
 dropping root 1094244 finished after at least 6 sec
 72 orphans left to clean
 69 orphans left to clean
 dropping root 1094183 for at least 0 sec drop_progress (112400 DIR_ITEM 4071209755)
 dropping root 1094183 finished after at least 6 sec
 68 orphans left to clean
 66 orphans left to clean
 dropping root 1094184 for at least 0 sec drop_progress (265876 DIR_ITEM 2364958367)
 dropping root 1094184 finished after at least 7 sec
 65 orphans left to clean
 dropping root 1299429 for at least 0 sec drop_progress (69781 INODE_ITEM 0)
 dropping root 1299429 finished after at least 6 sec
 64 orphans left to clean
 63 orphans left to clean
 62 orphans left to clean
 [...]

-h,  --help

Show the built-in help message and exit.

This program is an example of what can be done using the python-btrfs library.

Source and documentation on github: https://github.com/knorrie/python-btrfs