{
    "mode": "man",
    "parameter": "btrfs-property",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/btrfs-property/8/json",
    "generated": "2026-06-13T21:23:03Z",
    "synopsis": "btrfs property <subcommand> <args>",
    "sections": {
        "NAME": {
            "content": "btrfs-property - get/set/list properties for given filesystem object\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "btrfs property <subcommand> <args>\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "btrfs property is used to get/set/list property for given filesystem object. The object can\nbe an inode (file or directory), subvolume or the whole filesystem. See the description of\nget subcommand for more information about both btrfs object and property.\n\nbtrfs property provides an unified and user-friendly method to tune different btrfs\nproperties instead of using the traditional method like chattr(1) or lsattr(1).\n",
            "subsections": []
        },
        "SUBCOMMAND": {
            "content": "get [-t <type>] <object> [<name>]\nget property from a btrfs <object> of given <type>\n\nA btrfs object, which is set by <object>, can be a btrfs filesystem itself, a btrfs\nsubvolume, an inode (file or directory) inside btrfs, or a device on which a btrfs\nexists.\n\nThe option -t can be used to explicitly specify what type of object you meant. This is\nonly needed when a property could be set for more then one object type.\n\nPossible types are s[ubvol], f[ilesystem], i[node] and d[evice], where the first lettes\nis a shortcut.\n\nSet the name of property by name. If no name is specified, all properties for the given\nobject are printed.  name is one of the following:\n\nro\nread-only flag of subvolume: true or false. Please also see section SUBVOLUME FLAGS\nin btrfs-subvolume(8) for possible implications regarding incremental send.\n\nlabel\nlabel of the filesystem. For an unmounted filesystem, provide a path to a block\ndevice as object. For a mounted filesystem, specify a mount point.\n\ncompression\ncompression algorithm set for an inode, possible values: lzo, zlib, zstd. To disable\ncompression use \"\" (empty string), no or none.\n\nlist [-t <type>] <object>\nLists available properties with their descriptions for the given object.\n\nSee the description of get subcommand for the meaning of each option.\n\nset [-f] [-t <type>] <object> <name> <value>\nSets a property on a btrfs object.\n\nSee the description of get subcommand for the meaning of each option.\n\nOptions\n\n-f\nForce the change. Changing some properties may involve safety checks or additional\nchanges that depend on the properties semantics.\n",
            "subsections": []
        },
        "EXIT STATUS": {
            "content": "btrfs property returns a zero exit status if it succeeds. Non zero is returned in case of\nfailure.\n",
            "subsections": []
        },
        "AVAILABILITY": {
            "content": "btrfs is part of btrfs-progs. Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for\nfurther details.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "mkfs.btrfs(8), lsattr(1), chattr(1)\n\n\n\nBtrfs v5.16.2                                02/16/2022                            BTRFS-PROPERTY(8)",
            "subsections": []
        }
    },
    "summary": "btrfs-property - get/set/list properties for given filesystem object",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "mkfs.btrfs",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/mkfs.btrfs/8/json"
        },
        {
            "name": "lsattr",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/lsattr/1/json"
        },
        {
            "name": "chattr",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/chattr/1/json"
        },
        {
            "name": "BTRFS-PROPERTY",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/BTRFS-PROPERTY/8/json"
        }
    ]
}