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

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 following:

               read-only flag of subvolume: true or false. Please also
               see section SUBVOLUME FLAGS in btrfs-subvolume(8) for
               possible implications regarding incremental send.

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

           See the description of get subcommand for the meaning of each

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

           See the description of get subcommand for the meaning of each


               Force the change. Changing some properties may involve
               safety checks or additional changes that depend on the
               properties semantics.

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 2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2024-05-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 to

Btrfs v5.16.1                  02/06/2022              BTRFS-PROPERTY(8)

Pages that refer to this page: btrfs(8)