# btrfs-property

## NAME



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


## SYNOPSIS



           **btrfs property** _< subcommand> <args>_
    


## DESCRIPTION



           **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



           **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:
    
               ro
                   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
                   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
                   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
               option.
    
           **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
               option.
    
               **Options**
    
               -f
                   Force the change. Changing some properties may involve
                   safety checks or additional changes that depend on the
                   properties semantics.
    


## EXIT STATUS



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


## AVAILABILITY



           **btrfs** is part of btrfs-progs. Please refer to the btrfs wiki
           **http://btrfs.wiki.kernel.org******for further details.


* * *