Overview

Btrfs is a great filesystem, but its userland tools are not very user-frienfly yet. As a long-time user, I've developed btrfs-list as a wrapper to make sense out of the btrfs sub list and btrfs qgroup show commands.

You need btrfs-list if either:

• You'd like to have a nice overview of your subvolumes/snapshots
• You've already used ZFS before and you're missing the zfs list command
• You're looking for exactly which snapshot to destroy to regain some space
• You're looking for a more accurate estimation of how much space is remaining on your FS

Basically it turns this: into this:

Prerequisites

• btrfs-progs v3.18 at least (Dec 2014)
• The quota feature enabled on your Btrfs filesystems (optional, to get space usage for subvolumes and snapshots)

Usage

Usage: btrfs-list [options] [mountpoint]

If no [mountpoint] is specified, display info for all btrfs filesystems.

  -h, --help                 display this message
  -d, --debug                enable debug output
      --color=WHEN           colorize the output; WHEN can be 'never', 'always',
                               or 'auto' (default, colorize if STDOUT is a term)
      --no-color             synonym of --color=never

  -s                         hide all snapshots
      --snap-min-used SIZE   hide snapshots taking less space than SIZE
      --snap-max-used SIZE   hide snapshots taking more space than SIZE

      --show-all             show all information for each item
      --show-gen             show generation of each item
      --show-cgen            show generation at creation of each item
      --show-id              show id of each item
      --show-uuid            show uuid of each item

SIZE can be a number (in bytes), or a number followed by k, M, G, T or P.