List Btrfs subvolumes below a path
Build a paste-ready command, then review its compatibility and effects before running it.
btrfs subvolume list <path>Complete required fields to copy the generated command.
read-onlyno known side effects Compatibility
LinuxVerified for Linux using posix, bash, zsh syntax.
Operational knowledgereview due 2027-01-20
Requirementsbtrfsbtrfs must be installed and available on PATH.
Version supportbtrfs Current supported releasesVerified for linux using posix, bash, zsh syntax; consult compatibility notes for platform-specific differences.
Expected signalsID 256 gen 842 top level 5 path @Representative successful output; values vary with the selected target and system state.
Known errorsbtrfs: command not foundbtrfs is missing or is not available on PATH.
Verifybtrfs subvolume list {{path}}The output matches the expected target and exits without an error.Rollback noteNot required: this command is read-only and does not change system state.
Command breakdown
01btrfsCommandRuns the btrfs stage of this one-liner.
02subvolumeArgumentPasses subvolume to btrfs.
03listArgumentPasses list to btrfs.
04<path>ParameterA value supplied in the Fill parameters section.
Example input
btrfs subvolume list /var/log
Example output
ID 256 gen 842 top level 5 path @
ID 257 gen 841 top level 5 path @home
Illustrative output — exact values vary by system and data.
Official sources