NAME | SYNOPSIS | DESCRIPTION | SUBCOMMAND | EXIT STATUS | AVAILABILITY | SEE ALSO | COLOPHON

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 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].
           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.
           ro
               read-only flag of subvolume: true or false
           label
               label of device
           compression
               compression setting for an inode: lzo, zlib, or "" (empty
               string)
       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 [-t <type>] <object> <name> <value>
           Sets a property on a btrfs object.
           See the description of get subcommand for the meaning of each
           option.

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
       http://btrfs.wiki.kernel.org 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 
       ⟨https://btrfs.wiki.kernel.org/index.php/Btrfs_source_repositories⟩.
       If you have a bug report for this manual page, see 
       ⟨https://btrfs.wiki.kernel.org/index.php/Problem_FAQ#How_do_I_report_bugs_and_issues.3F⟩.
       This page was obtained from the project's upstream Git repository 
       ⟨git://git.kernel.org/pub/scm/linux/kernel/git/kdave/btrfs-progs.git⟩
       on 2017-07-05.  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 man-pages@man7.org
Btrfs v4.6.1                     07/05/2017                BTRFS-PROPERTY(8)

Pages that refer to this page: btrfs(8)