---
name: "lsbtr"
section: "1"
platform: "linux"
package: "btrbk"
version: "0.32.7-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/lsbtr"
---

# lsbtr(1)

list btrfs subvolumes

## NAME

lsbtr - list btrfs subvolumes

## SYNOPSIS

```
lsbtr [-h|--help] [--version]
      [-l|--long] [-u|--uuid] [-1|--single-column] [--raw]
      [--format <output-format>]
      [-v|--verbose]
      [-c|--config <file>]
      [--override <config_option>=<value>]
      [[--] <path>|<url>...]
```

## DESCRIPTION

List btrfs subvolumes and their mount points visible by the file system below *\<path\>*.

**lsbtr** is part of **btrbk** (basically a shortcut for "btrbk ls"), and takes some global configuration options from [btrbk.conf(5)](/btrbk.conf/5.md) if present.

**lsbtr** requires *root privileges* to run correctly. Alternatively, consider using "btrfs-progs-sudo" or "btrfs-progs-btrbk" backends, both of which allows you to run lsbtr as a regular user. Refer to configuration option *backend* in [btrbk.conf(5)](/btrbk.conf/5.md) for more details.

## OPTIONS

- \-h, --help

  Prints the synopsis and a list of the commands.

- \--version

  Prints the btrbk version.

- \-l, --long

  Print output in long table format (additionally print subvolume path).

- \-u, --uuid

  Print UUID table (parent/received relations).

- \-1, --single-column

  Print path column only (delimited by newline).

- \--raw

  Print space-separated key="value" pairs (machine readable).

- \--format table\|long\|raw\|col:\[h:\]\<columns\>

  Print output in specified format. If set to "raw", prints space-separated key="value" pairs (machine readable).

  If set to "col:", prints only the \<columns\> specified (comma-separated list). Header lines are omitted if the "h:" modifier is present. Columns prefixed with "-" are collapsed if empty. Columns postfixed with ":RALIGN" are right-aligned.

- \-v, --verbose

  Increase the level of verbosity.

- \-c, --config \<file\>

  Read the configuration from \<file\>.

- \--override \<config\_option\>=\<value\>

  Override a configuration option \<config\_option\> with \<value\>.

## FILES

`/etc/btrbk.conf`, `/etc/btrbk/btrbk.conf`

Default configuration file. The file format and configuration options are described in [**btrbk.conf**(5)](/btrbk.conf/5.md).

## EXIT STATUS

**lsbtr** returns the following error codes:

0

No problems occurred.

1

Generic error code.

2

Parse error: when parsing command-line options or configuration file.

255

Script error.

## AVAILABILITY

Please refer to the btrbk project page  **\<https://digint.ch/btrbk/\>** *for further details.*

## SEE ALSO

**btrbk***(1),* **btrbk.conf***(5),* **btrfs***(8)*

## AUTHOR

*Axel Burri*  *\<axel@tty0.ch\>*