--- name: "btrfs-orphan-cleaner-progress" section: "1" platform: "linux" package: "python3-btrfs" version: "15-1" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/btrfs-orphan-cleaner-progress" --- # btrfs-orphan-cleaner-progress(1) show progress information about background deletion of btrfs subvolumes ## NAME btrfs-orphan-cleaner-progress - show progress information about background deletion of btrfs subvolumes ## SYNOPSIS **btrfs-orphan-cleaner-progress** \[*args*\] *mountpoint* ## DESCRIPTION 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\ \[...\] ## OPTIONS - **-h**, **--help** Show the built-in help message and exit. ## SEE ALSO 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