From f25091e65464b28e6444e697c2d2e8f62945dd21 Mon Sep 17 00:00:00 2001 From: David Sterba Date: Tue, 17 Oct 2017 20:27:12 +0200 Subject: btrfs-progs: docs: update btrfs-properties Signed-off-by: David Sterba --- Documentation/btrfs-property.asciidoc | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) (limited to 'Documentation') diff --git a/Documentation/btrfs-property.asciidoc b/Documentation/btrfs-property.asciidoc index 9f31d481..b562717b 100644 --- a/Documentation/btrfs-property.asciidoc +++ b/Documentation/btrfs-property.asciidoc @@ -3,7 +3,7 @@ btrfs-property(8) NAME ---- -btrfs-property - get/set/list properties for given btrfs object. +btrfs-property - get/set/list properties for given filesystem object SYNOPSIS -------- @@ -11,8 +11,9 @@ SYNOPSIS DESCRIPTION ----------- -*btrfs property* is used to get/set/list property for given btrfs object. -See the description of *get* subcommand for more information about +*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 @@ -22,29 +23,30 @@ btrfs properties instead of using the traditional method like `chattr`(1) or SUBCOMMAND ---------- *get* [-t ] []:: -Gets a property from a btrfs object. +get property from a btrfs of given + A btrfs object, which is set by , can be a btrfs filesystem -itself, a btrfs subvolume, an inode(file or directory) inside btrfs, +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]'. +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 followings. +the following: ro:::: read-only flag of subvolume: true or false label:::: label of device compression:::: -compression algorithm for an inode, possible values: 'lzo', 'zlib', 'zstd'. To -disable compression use "" (empty string), 'no' or 'none'. +compression algorithm set for an inode, possible values: 'lzo', 'zlib', 'zstd'. +To disable compression use "" (empty string), 'no' or 'none'. *list* [-t ] :: Lists available properties with their descriptions for the given object. -- cgit v1.2.3