From fabe745d3b4b7814ddfc69385b439304c6e89d3a Mon Sep 17 00:00:00 2001 From: David Sterba Date: Tue, 15 Mar 2016 17:56:36 +0100 Subject: btrfs-progs: docs: add filesystem du Signed-off-by: David Sterba --- Documentation/btrfs-filesystem.asciidoc | 35 +++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) (limited to 'Documentation') 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] [..]:: +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. ++ +`Options` ++ +-s|--summarize:::: +display only a total for each argument +--raw:::: +raw numbers in bytes, without the 'B' suffix. +--human-readable:::: +print human friendly numbers, base 1024, this is the default +--iec:::: +select the 1024 base for the following options, according to the IEC standard. +--si:::: +select the 1000 base for the following options, according to the SI standard. +--kbytes:::: +show sizes in KiB, or kB with --si. +--mbytes:::: +show sizes in MiB, or MB with --si. +--gbytes:::: +show sizes in GiB, or GB with --si. +--tbytes:::: +show sizes in TiB, or TB with --si. + *label* [|] []:: Show or update the label of a filesystem. This works on a mounted filesystem or a filesystem image. -- cgit v1.2.3