path: root/Documentation
diff options
authorDavid Sterba <>2016-03-15 17:56:36 +0100
committerDavid Sterba <>2016-03-15 18:25:05 +0100
commitfabe745d3b4b7814ddfc69385b439304c6e89d3a (patch)
treec4a68cdf99c8fc8516168ec601efaaf16cd70f2e /Documentation
parent80414d69398e39b81bfd899f1015767a18909b94 (diff)
btrfs-progs: docs: add filesystem du
Signed-off-by: David Sterba <>
Diffstat (limited to 'Documentation')
1 files changed, 35 insertions, 0 deletions
diff --git a/Documentation/btrfs-filesystem.asciidoc b/Documentation/btrfs-filesystem.asciidoc
index 86652ffd..ff8ff230 100644
--- a/Documentation/btrfs-filesystem.asciidoc
+++ b/Documentation/btrfs-filesystem.asciidoc
@@ -126,6 +126,41 @@ NOTE: Directory arguments without '-r' do not defragment files recursively but w
defragment certain internal trees (extent tree and the subvolume tree). This has been
confusing and could be removed in the future.
+*du* [options] <path> [<path>..]::
+Calculate disk usage of the target files using FIEMAP. For individual
+files, it will report a count of total bytes, and exclusive (not
+shared) bytes. We also calculate a 'set shared' value which is
+described below.
+Each argument to 'btrfs fi du' will have a 'set shared' value
+calculated for it. We define each 'set' as those files found by a
+recursive search of an argument. The 'set shared' value
+then is a sum of all shared space referenced by the set.
+'set shared' takes into account overlapping shared extents, hence it
+isn't as simple as adding up shared extents.
+display only a total for each argument
+raw numbers in bytes, without the 'B' suffix.
+print human friendly numbers, base 1024, this is the default
+select the 1024 base for the following options, according to the IEC standard.
+select the 1000 base for the following options, according to the SI standard.
+show sizes in KiB, or kB with --si.
+show sizes in MiB, or MB with --si.
+show sizes in GiB, or GB with --si.
+show sizes in TiB, or TB with --si.
*label* [<dev>|<mountpoint>] [<newlabel>]::
Show or update the label of a filesystem. This works on a mounted filesystem or
a filesystem image.