File: btrfs-orphan-cleaner-progress.1

package info (click to toggle)
python-btrfs 15-1
  • links: PTS
  • area: main
  • in suites: sid, trixie
  • size: 620 kB
  • sloc: python: 4,772; makefile: 195
file content (93 lines) | stat: -rw-r--r-- 4,201 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
.TH BTRFS\-ORPHAN\-CLEANER\-PROGRESS 1 "2017" "" "Btrfs Orphan Cleaner Progress"
.nh
.ad l

.SH "NAME"
btrfs\-orphan\-cleaner\-progress \- show progress information about background
deletion of btrfs subvolumes

.SH SYNOPSIS
.B btrfs\-orphan\-cleaner\-progress
[\fIargs\fR]
.IR mountpoint

.SH DESCRIPTION
The \fBbtrfs\-orphan\-cleaner\-progress\fR 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.

\fBbtrfs\-orphan\-cleaner\-progress\fR 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
  [...]

.SH OPTIONS
.TP
.BR \-h ", " \-\-help
Show the built\-in help message and exit.

.SH "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