btrfs property <subcommand> <args>


btrfs property is used to get/set/list property, like lable or compression state, for given btrfs object.

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


get [-t <type>] <object> [<name>]

Gets a property from a btrfs object.

If no name is specified, all properties for the given object are printed. A filesystem object can be a the filesystem itself, a subvolume, an inode or a device.

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

The <object> can be path of btrfs device, btrfs mount point, or any directories/files inside btrfs.

set [-t <type>] <object> <name> <value>

Sets a property on a btrfs object.

See description of get subcommand for a description of objects and object types.

list [-t <type>] <object>

Lists available properties with their descriptions for the given object.

Please see the help of btrfs property get for a description of objects and object types.


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


btrfs is part of btrfs-progs. Please refer to the btrfs wiki \m[blue]\m[] for further details.

RELATED TO btrfs-property…