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

NAME         top

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

SYNOPSIS         top

       btrfs property <subcommand> <args>

DESCRIPTION         top

       btrfs property is used to get/set/list property for given btrfs
       object. 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>]
           Gets a property from a btrfs object.

           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 -t <type> option 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].

           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 followings.

               read-only flag of subvolume: true or false

               label of device

               compression setting for an inode: lzo, zlib, or "" (empty

       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 2017-05-03.  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 to

Btrfs v4.6.1                     07/16/2016                BTRFS-PROPERTY(8)

Pages that refer to this page: btrfs(8)