btrfs-property(8) — Linux manual page


BTRFS-PROPERTY(8)               Btrfs Manual               BTRFS-PROPERTY(8)

NAME         top

       btrfs-property - get/set/list properties for given filesystem object

SYNOPSIS         top

       btrfs property <subcommand> <args>

DESCRIPTION         top

       btrfs property is used to get/set/list property for given filesystem
       object. The object can be an inode (file or directory), subvolume or
       the whole filesystem. See the description of get subcommand for more
       information about both btrfs object and property.

       btrfs property provides an unified and user-friendly method to tune
       different btrfs properties instead of using the traditional method
       like chattr(1) or lsattr(1).

SUBCOMMAND         top

       get [-t <type>] <object> [<name>]
           get property from a btrfs <object> of given <type>

           A btrfs object, which is set by <object>, can be a btrfs
           filesystem itself, a btrfs subvolume, an inode (file or
           directory) inside btrfs, or a device on which a btrfs exists.

           The option -t can be used to explicitly specify what type of
           object you meant. This is only needed when a property could be
           set for more then one object type.

           Possible types are s[ubvol], f[ilesystem], i[node] and d[evice],
           where the first lettes is a shortcut.

           Set the name of property by name. If no name is specified, all
           properties for the given object are printed.  name is one of the

               read-only flag of subvolume: true or false

               label of the filesystem. For an unmounted filesystem, provide
               a path to a block device as object. For a mounted filesystem,
               specify a mount point.

               compression algorithm set for an inode, possible values: lzo,
               zlib, zstd. To disable compression use "" (empty string), no
               or none.

       list [-t <type>] <object>
           Lists available properties with their descriptions for the given

           See the description of get subcommand for the meaning of each

       set [-t <type>] <object> <name> <value>
           Sets a property on a btrfs object.

           See the description of get subcommand for the meaning of each

EXIT STATUS         top

       btrfs property returns a zero exit status if it succeeds. Non zero is
       returned in case of failure.

AVAILABILITY         top

       btrfs is part of btrfs-progs. Please refer to the btrfs wiki for further details.

SEE ALSO         top

       mkfs.btrfs(8), lsattr(1), chattr(1)

COLOPHON         top

       This page is part of the btrfs-progs (btrfs filesystem tools)
       project.  Information about the project can be found at 
       If you have a bug report for this manual page, see
       This page was obtained from the project's upstream Git repository
       on 2020-09-18.  (At that time, the date of the most recent commit
       that was found in the repository was 2020-07-02.)  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail

Btrfs v4.6.1                     05/16/2020                BTRFS-PROPERTY(8)

Pages that refer to this page: btrfs(8)