Skip to content

Commit 032c226

Browse files
committed
btrfs-progs: docs: update sysfs descriptions
[ci skip] Issue: #374 Signed-off-by: David Sterba <[email protected]>
1 parent 65c5de4 commit 032c226

File tree

1 file changed

+51
-6
lines changed

1 file changed

+51
-6
lines changed

Documentation/ch-sysfs.rst

+51-6
Original file line numberDiff line numberDiff line change
@@ -49,11 +49,23 @@ clone_alignment
4949
commit_stats
5050
(RW, since: 6.0)
5151

52-
The performance statistics for btrfs transaction commit.
53-
Mostly for debug purposes.
52+
The performance statistics for btrfs transaction commit since the first
53+
mount. Mostly for debugging purposes.
54+
55+
Writing into this file will reset the maximum commit duration
56+
(*max_commit_ms*) to 0. The file looks like:
57+
58+
.. code-block:: none
59+
60+
commits 70649
61+
last_commit_ms 2
62+
max_commit_ms 131
63+
total_commit_ms 170840
5464
55-
Writing into this file will reset the maximum commit duration to
56-
the input value.
65+
* *commits* - number of transaction commits since the first mount
66+
* *last_commit_ms* - duration in miliseconds of the last commit
67+
* *max_commit_ms* - maximum time a transaction commit took since first mount or last reset
68+
* *total_commit_ms* - sum of all transaction commit times
5769

5870
exclusive_operation
5971
(RO, since: 5.10)
@@ -103,6 +115,12 @@ sectorsize
103115
Shows the sectorsize of the mounted filesystem.
104116

105117

118+
temp_fsid
119+
(RO, since 6.7)
120+
121+
Indicate that this filesystem got assigned a temporary FSID at mount time,
122+
making possible to mount devices with the same FSID.
123+
106124
Files and directories in :file:`/sys/fs/btrfs/<UUID>/allocations` directory are:
107125

108126
global_rsv_reserved
@@ -130,18 +148,45 @@ bg_reclaim_threshold
130148
permanently unusable space) to reclaim the block group.
131149
Can be used on regular or zoned devices.
132150

151+
bytes_*
152+
(RO)
153+
154+
Values of the corresponding data structures for the given block group
155+
type and profile.
156+
133157
chunk_size
134158
(RW, since: 6.0)
135159

136160
Shows the chunk size. Can be changed for data and metadata.
137161
Cannot be set for zoned devices.
138162

163+
size_classes
164+
(RO, since: 6.3)
165+
166+
Numbers of block groups of a given classes based on heuristics that
167+
measure extent length, age and fragmentation.
168+
169+
.. code-block:: none
170+
171+
none 136
172+
small 374
173+
medium 282
174+
large 93
175+
139176
Files in :file:`/sys/fs/btrfs/<UUID>/devinfo/<DEVID>` directory are:
140177

141178
error_stats:
142179
(RO, since: 5.14)
143180

144-
Shows all the history error numbers of the device.
181+
Shows device stats of this device, same as :command:`btrfs device stats` (:doc:`btrfs-device`).
182+
183+
.. code-block:: none
184+
185+
write_errs 0
186+
read_errs 0
187+
flush_errs 0
188+
corruption_errs 0
189+
generation_errs 0
145190
146191
fsid:
147192
(RO, since: 5.17)
@@ -171,7 +216,7 @@ scrub_speed_max
171216
(RW, since: 5.14)
172217

173218
Shows the scrub speed limit for this device. The unit is Bytes/s.
174-
0 means no limit.
219+
0 means no limit. The value can be set but is not persisent.
175220

176221
writeable
177222
(RO, since: 5.6)

0 commit comments

Comments
 (0)