2 KiB
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.