btrfs-progs: doc: make all commands and subcommands bold

Italic format is used for parameters and values.  also this makes the
text visually separated,

Signed-off-by: David Sterba <dsterba@suse.cz>
This commit is contained in:
David Sterba 2014-05-19 17:49:35 +02:00
parent aaeae23458
commit a4197dfe24
26 changed files with 185 additions and 185 deletions

View File

@ -7,11 +7,11 @@ btrfs-balance - balance btrfs filesystem
SYNOPSIS SYNOPSIS
-------- --------
'btrfs [filesystem] balance' <subcommand>|<args> *btrfs [filesystem] balance* <subcommand>|<args>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs balance' is used to balance chunks in a btrfs filesystem across *btrfs balance* is used to balance chunks in a btrfs filesystem across
multiple or even single device. multiple or even single device.
See `btrfs-device`(8) for more details about the effect on device management. See `btrfs-device`(8) for more details about the effect on device management.
@ -21,10 +21,10 @@ SUBCOMMAND
<path>:: <path>::
Balance chunks across the devices *online*. Balance chunks across the devices *online*.
+ +
'btrfs balance <path>' is deprecated, *btrfs balance <path>* is deprecated,
please use 'btrfs balance start' command instead. please use *btrfs balance start* command instead.
'start' [options] <path>:: *start* [options] <path>::
Balance chunks across the devices *online*. Balance chunks across the devices *online*.
+ +
Balance and/or convert (change allocation profile of) chunks that Balance and/or convert (change allocation profile of) chunks that
@ -47,28 +47,28 @@ be verbose
-f:::: -f::::
force reducing of metadata integrity force reducing of metadata integrity
'pause' <path>:: *pause* <path>::
Pause running balance. Pause running balance.
'cancel' <path>:: *cancel* <path>::
Cancel running or paused balance. Cancel running or paused balance.
'resume' <path>:: *resume* <path>::
Resume interrupted balance. Resume interrupted balance.
'status' [-v] <path>:: *status* [-v] <path>::
Show status of running or paused balance. Show status of running or paused balance.
+ +
If '-v' option is given, output will be verbose. If '-v' option is given, output will be verbose.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs balance' returns a zero exist status if it succeeds. Non zero is *btrfs balance* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,18 +7,18 @@ btrfs-check - check or repair a btrfs filesystem offline
SYNOPSIS SYNOPSIS
-------- --------
'btrfs check' [options] <device> *btrfs check* [options] <device>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs check' is used to check or repair a btrfs filesystem offline. *btrfs check* is used to check or repair a btrfs filesystem offline.
NOTE: Since btrfs is under heavy development especially the 'btrfs check' NOTE: Since btrfs is under heavy development especially the *btrfs check*
command, it is *highly* recommended to read the following btrfs wiki before command, it is *highly* recommended to read the following btrfs wiki before
executing 'btrfs check' with '--repair' option: + executing *btrfs check* with '--repair' option: +
https://btrfs.wiki.kernel.org/index.php/Btrfsck https://btrfs.wiki.kernel.org/index.php/Btrfsck
'btrfsck' is an alias of 'btrfs check' command and is now deprecated. *btrfsck* is an alias of *btrfs check* command and is now deprecated.
OPTIONS OPTIONS
------- -------
@ -33,12 +33,12 @@ create a new extent tree.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs check' returns a zero exist status if it succeeds. Non zero is *btrfs check* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,11 +7,11 @@ btrfs-convert - convert from ext2/3/4 filesystem to btrfs or rollback
SYNOPSIS SYNOPSIS
-------- --------
'btrfs-convert' [options] <device> *btrfs-convert* [options] <device>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs-convert' is used to convert existed ext2/3/4 to btrfs filesystem, *btrfs-convert* is used to convert existed ext2/3/4 to btrfs filesystem,
and the original filesystem image is accessible as from separate subvolume and the original filesystem image is accessible as from separate subvolume
named 'ext2_subvol' as file image. named 'ext2_subvol' as file image.
@ -28,7 +28,7 @@ Roll back to ext2fs.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs-convert' will return 0 if no error happened. *btrfs-convert* will return 0 if no error happened.
If any problems happened, 1 will be returned. If any problems happened, 1 will be returned.
AUTHOR AUTHOR

View File

@ -7,11 +7,11 @@ btrfs-debug-tree - dump btrfs filesystem metadata into stdout
SYNOPSIS SYNOPSIS
-------- --------
'btrfs-debug-tree' [options] <device> *btrfs-debug-tree* [options] <device>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs-debug-tree' is used to dump the whole tree of the given device. *btrfs-debug-tree* is used to dump the whole tree of the given device.
This is maybe useful for analyzing filesystem state or inconsistence and has This is maybe useful for analyzing filesystem state or inconsistence and has
a positive educational effect on understanding the internal structure. a positive educational effect on understanding the internal structure.
@ -30,7 +30,7 @@ Print info of the specified block only.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs-debug-tree' will return 0 if no error happened. *btrfs-debug-tree* will return 0 if no error happened.
If any problems happened, 1 will be returned. If any problems happened, 1 will be returned.
AUTHOR AUTHOR

View File

@ -7,12 +7,12 @@ btrfs-device - control btrfs devices
SYNOPSIS SYNOPSIS
-------- --------
'btrfs device' <subcommand> <args> *btrfs device* <subcommand> <args>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs device' is used to control the btrfs devices, since btrfs can be used *btrfs device* is used to control the btrfs devices, since btrfs can be used
across several devices, 'btrfs device' is used for multiple device management. across several devices, *btrfs device* is used for multiple device management.
DEVICE MANAGEMENT DEVICE MANAGEMENT
----------------- -----------------
@ -62,7 +62,7 @@ See `btrfs-replace`(8) and this man page for more details.
SUBCOMMAND SUBCOMMAND
---------- ----------
'add' [-Kf] <dev> [<dev>...] <path>:: *add* [-Kf] <dev> [<dev>...] <path>::
Add device(s) to the filesystem identified by <path>. Add device(s) to the filesystem identified by <path>.
+ +
If applicable, a whole device discard (TRIM) operation is performed. If applicable, a whole device discard (TRIM) operation is performed.
@ -74,10 +74,10 @@ do not perform discard by default
-f|--force:::: -f|--force::::
force overwrite of existing filesystem on the given disk(s) force overwrite of existing filesystem on the given disk(s)
'delete' <dev> [<dev>...] <path>:: *delete* <dev> [<dev>...] <path>::
Remove device(s) from a filesystem identified by <path>. Remove device(s) from a filesystem identified by <path>.
'scan' [(--all-devices|-d)|<device> [<device>...]]:: *scan* [(--all-devices|-d)|<device> [<device>...]]::
Scan devices for a btrfs filesystem. Scan devices for a btrfs filesystem.
+ +
If one or more devices are passed, these are scanned for a btrfs filesystem. If one or more devices are passed, these are scanned for a btrfs filesystem.
@ -86,10 +86,10 @@ filesystem as listed by blkid.
Finally, if '--all-devices' or '-d' is passed, all the devices under /dev are Finally, if '--all-devices' or '-d' is passed, all the devices under /dev are
scanned. scanned.
'ready' <device>:: *ready* <device>::
Check device to see if it has all of it's devices in cache for mounting. Check device to see if it has all of it's devices in cache for mounting.
'stats' [-z] <path>|<device>:: *stats* [-z] <path>|<device>::
Read and print the device IO stats for all devices of the filesystem Read and print the device IO stats for all devices of the filesystem
identified by <path> or for a single <device>. identified by <path> or for a single <device>.
+ +
@ -100,12 +100,12 @@ Reset stats to zero after reading them.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs device' returns a zero exist status if it succeeds. Non zero is *btrfs device* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,20 +7,20 @@ btrfs-filesystem - control btrfs filesystem
SYNOPSIS SYNOPSIS
-------- --------
'btrfs filesystem' <subcommand> <args> *btrfs filesystem* <subcommand> <args>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs filesystem' is used to do the filesystem level control jobs, including *btrfs filesystem* is used to do the filesystem level control jobs, including
all the regular filesystem operations like setting/getting label, all the regular filesystem operations like setting/getting label,
resizing, defragment. resizing, defragment.
SUBCOMMAND SUBCOMMAND
---------- ----------
'df' <path> [<path>...]:: *df* <path> [<path>...]::
Show space usage information for a mount point. Show space usage information for a mount point.
'show' [--mounted|--all-devices|<path>|<uuid>|<device>|<label>]:: *show* [--mounted|--all-devices|<path>|<uuid>|<device>|<label>]::
Show the btrfs filesystem with some additional info. Show the btrfs filesystem with some additional info.
+ +
If no option nor <path>|<uuid>|<device>|<label> is passed, btrfs shows If no option nor <path>|<uuid>|<device>|<label> is passed, btrfs shows
@ -30,10 +30,10 @@ filesystem(s);
If '--all-devices' is passed, all the devices under /dev are scanned; If '--all-devices' is passed, all the devices under /dev are scanned;
otherwise the devices list is extracted from the /proc/partitions file. otherwise the devices list is extracted from the /proc/partitions file.
'sync' <path>:: *sync* <path>::
Force a sync for the filesystem identified by <path>. Force a sync for the filesystem identified by <path>.
'defragment' [options] <file>|<dir> [<file>|<dir>...]:: *defragment* [options] <file>|<dir> [<file>|<dir>...]::
Defragment file data and/or directory metadata *online*. Defragment file data and/or directory metadata *online*.
+ +
If '-r' is passed, files in dir will be defragmented recursively. If '-r' is passed, files in dir will be defragmented recursively.
@ -70,10 +70,10 @@ don't use it if you use snapshots, have de-duplicated your data or made
copies with `cp --reflink`. copies with `cp --reflink`.
// Some wording are extracted by the resize2fs man page // Some wording are extracted by the resize2fs man page
'resize' [<devid>:][+/-]<size>[gkm]|[<devid>:]max <path>:: *resize* [<devid>:][+/-]<size>[gkm]|[<devid>:]max <path>::
Resize a filesystem identified by <path> for the underlying device Resize a filesystem identified by <path> for the underlying device
devid *online*. + devid *online*. +
The devid can be found with 'btrfs filesystem show' and The devid can be found with *btrfs filesystem show* and
defaults to 1 if not specified. defaults to 1 if not specified.
The <size> parameter specifies the new size of the filesystem. The <size> parameter specifies the new size of the filesystem.
If the prefix + or - is present the size is increased or decreased If the prefix + or - is present the size is increased or decreased
@ -94,7 +94,7 @@ partition after reducing the size of the filesystem. This can done using
it with the new desired size. When recreating the partition make sure to use it with the new desired size. When recreating the partition make sure to use
the same starting disk cylinder as before. the same starting disk cylinder as before.
'label' [<dev>|<mountpoint>] [<newlabel>]:: *label* [<dev>|<mountpoint>] [<newlabel>]::
Show or update the label of a filesystem. Show or update the label of a filesystem.
+ +
[<device>|<mountpoint>] is used to identify the filesystem. [<device>|<mountpoint>] is used to identify the filesystem.
@ -103,12 +103,12 @@ NOTE: the maximum allowable length shall be less than 256 chars
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs filesystem' returns a zero exist status if it succeeds. Non zero is *btrfs filesystem* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,11 +7,11 @@ btrfs-find-root - filter to find btrfs root
SYNOPSIS SYNOPSIS
-------- --------
'btrfs-find-root' [options] <dev> *btrfs-find-root* [options] <dev>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs-find-root' is used to find the satisfied root, you can filter by *btrfs-find-root* is used to find the satisfied root, you can filter by
root tree's objectid, generation, level. root tree's objectid, generation, level.
OPTIONS OPTIONS
@ -25,7 +25,7 @@ Filter root tree by B-+ tree's level, level 0 in default.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs-find-root' will return 0 if no error happened. *btrfs-find-root* will return 0 if no error happened.
If any problems happened, 1 will be returned. If any problems happened, 1 will be returned.
AUTHOR AUTHOR

View File

@ -7,11 +7,11 @@ btrfs-image - create/restore an image of the filesystem
SYNOPSIS SYNOPSIS
-------- --------
'btrfs-image' [options] <source> <target> *btrfs-image* [options] <source> <target>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs-image' is used to create an image of a btrfs filesystem. *btrfs-image* is used to create an image of a btrfs filesystem.
All data will be zeroed, but metadata and the like is preserved. All data will be zeroed, but metadata and the like is preserved.
Mainly used for debug purpose. Mainly used for debug purpose.
@ -50,7 +50,7 @@ captured.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs-image' will return 0 if no error happened. *btrfs-image* will return 0 if no error happened.
If any problems happened, 1 will be returned. If any problems happened, 1 will be returned.
AUTHOR AUTHOR

View File

@ -7,15 +7,15 @@ btrfs-inspect-internal - resolve different btrfs items for debug purpose
SYNOPSIS SYNOPSIS
-------- --------
'btrfs inspect-internal' <subcommand> <args> *btrfs inspect-internal* <subcommand> <args>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs inspect-internal' is used to resolve different items for debug purpose. *btrfs inspect-internal* is used to resolve different items for debug purpose.
SUBCOMMAND SUBCOMMAND
---------- ----------
'inode-resolve' [-v] <inode> <path>:: *inode-resolve* [-v] <inode> <path>::
Resolves an <inode> in subvolume <path> to all filesystem paths. Resolves an <inode> in subvolume <path> to all filesystem paths.
+ +
`Options` `Options`
@ -23,7 +23,7 @@ Resolves an <inode> in subvolume <path> to all filesystem paths.
-v:::: -v::::
verbose mode. print count of returned paths and ioctl() return value verbose mode. print count of returned paths and ioctl() return value
'logical-resolve' [-Pv] [-s <bufsize>] <logical> <path>:: *logical-resolve* [-Pv] [-s <bufsize>] <logical> <path>::
Resolves a <logical> address in the filesystem mounted at <path> to all inodes. Resolves a <logical> address in the filesystem mounted at <path> to all inodes.
+ +
By default, each inode is then resolved to a file system path (similar to the By default, each inode is then resolved to a file system path (similar to the
@ -41,10 +41,10 @@ set inode container's size.
This is used to increase inode container's size in case it is This is used to increase inode container's size in case it is
not enough to read all the resolved results. The max value one can set is 64k. not enough to read all the resolved results. The max value one can set is 64k.
'subvolid-resolve' <subvolid> <path>:: *subvolid-resolve* <subvolid> <path>::
Get file system paths for the given subvolume ID. Get file system paths for the given subvolume ID.
'rootid' <path>:: *rootid* <path>::
For a given file or directory, return the containing tree root id. For a For a given file or directory, return the containing tree root id. For a
subvolume return it's own tree id. subvolume return it's own tree id.
+ +
@ -52,12 +52,12 @@ The result is undefined for the so-called empty subvolumes (identified by inode
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs inspect-internal' returns a zero exist status if it succeeds. Non zero is *btrfs inspect-internal* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,11 +7,11 @@ btrfs-map-logical - map btrfs logical extent to physical extent
SYNOPSIS SYNOPSIS
-------- --------
'btrfs-map-logical' <options> <device> *btrfs-map-logical* <options> <device>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs-map-logical' can be used to find out what the physical offsets are *btrfs-map-logical* can be used to find out what the physical offsets are
on the mirrors, the result is dumped into stdout in default. on the mirrors, the result is dumped into stdout in default.
Mainly used for debug purpose. Mainly used for debug purpose.
@ -29,7 +29,7 @@ Number of bytes to read.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs-map-logical' will return 0 if no error happened. *btrfs-map-logical* will return 0 if no error happened.
If any problems happened, 1 will be returned. If any problems happened, 1 will be returned.
AUTHOR AUTHOR

View File

@ -7,20 +7,20 @@ btrfs-property - get/set/list properties for given btrfs object.
SYNOPSIS SYNOPSIS
-------- --------
'btrfs property' <subcommand> <args> *btrfs property* <subcommand> <args>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs property' is used to get/set/list property, like lable or compression *btrfs property* is used to get/set/list property, like lable or compression
state, for given btrfs object. state, for given btrfs object.
'btrfs property' provides an unified and user-friendly method to tune different *btrfs property* provides an unified and user-friendly method to tune different
btrfs properties instead of using the traditional method like `chattr`(1) or btrfs properties instead of using the traditional method like `chattr`(1) or
`lsattr`(1). `lsattr`(1).
SUBCOMMAND SUBCOMMAND
---------- ----------
'get' [-t <type>] <object> [<name>]:: *get* [-t <type>] <object> [<name>]::
Gets a property from a btrfs object. Gets a property from a btrfs object.
+ +
If no name is specified, all properties for the given object are If no name is specified, all properties for the given object are
@ -37,26 +37,26 @@ 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 The <object> can be path of btrfs device, btrfs mount point, or any
directories/files inside btrfs. directories/files inside btrfs.
'set' [-t <type>] <object> <name> <value>:: *set* [-t <type>] <object> <name> <value>::
Sets a property on a btrfs object. Sets a property on a btrfs object.
+ +
See description of 'get' subcommand for a description of objects and object See description of *get* subcommand for a description of objects and object
types. types.
'list' [-t <type>] <object>:: *list* [-t <type>] <object>::
Lists available properties with their descriptions for the given object. Lists available properties with their descriptions for the given object.
+ +
Please see the help of 'btrfs property get' for a description of Please see the help of *btrfs property get* for a description of
objects and object types. objects and object types.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs property' returns a zero exist status if it succeeds. Non zero is *btrfs property* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,13 +7,13 @@ btrfs-qgroup - control the quota group of a btrfs filesystem
SYNOPSIS SYNOPSIS
-------- --------
'btrfs qgroup' <subcommand> <args> *btrfs qgroup* <subcommand> <args>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs qgroup' is used to control quota group(qgroup) of a btrfs filesystem. *btrfs qgroup* is used to control quota group(qgroup) of a btrfs filesystem.
NOTE: To use qgroup, it needs to enable quota first using 'btrfs quota' NOTE: To use qgroup, it needs to enable quota first using *btrfs quota*
command. command.
WARNING: Qgroup is not stable yet and will impact performance in current mainline WARNING: Qgroup is not stable yet and will impact performance in current mainline
@ -29,34 +29,34 @@ Also for snapshot, it consumes no quota initially since all its data
shares with its parent, so only modification in snapshot consumes quota. shares with its parent, so only modification in snapshot consumes quota.
Every subvolume/snapshot will have its own qgroup with id '0/<subvolume id>' Every subvolume/snapshot will have its own qgroup with id '0/<subvolume id>'
upon creating, but can be later destroyed by 'btrfs qgroup destroy' command. upon creating, but can be later destroyed by *btrfs qgroup destroy* command.
NOTE: If the qgroup of a subvolume is destroyed, quota about the subvolume NOTE: If the qgroup of a subvolume is destroyed, quota about the subvolume
will not be functional until qgroup '0/<subvolume id>' is created again. will not be functional until qgroup '0/<subvolume id>' is created again.
SUBCOMMAND SUBCOMMAND
---------- ----------
'assign' <src> <dst> <path>:: *assign* <src> <dst> <path>::
Assign qgroup <src> as the child qgroup of <dst> in the btrfs filesystem Assign qgroup <src> as the child qgroup of <dst> in the btrfs filesystem
identified by <path>. identified by <path>.
'remove' <src> <dst> <path>:: *remove* <src> <dst> <path>::
Remove the relationship between child qgroup <src> and parent qgroup <dst> in Remove the relationship between child qgroup <src> and parent qgroup <dst> in
the btrfs filesystem identified by <path>. the btrfs filesystem identified by <path>.
'create' <qgroupid> <path>:: *create* <qgroupid> <path>::
Create a subvolume quota group. Create a subvolume quota group.
+ +
For the '0/<subvolume id>' qgroup, a qgroup can be created even before the For the '0/<subvolume id>' qgroup, a qgroup can be created even before the
subvolume created. subvolume created.
'destroy' <qgroupid> <path>:: *destroy* <qgroupid> <path>::
Destroy a qgroup. Destroy a qgroup.
+ +
If a qgroup is no isolated,which means it is a parent or child qgroup, it If a qgroup is no isolated,which means it is a parent or child qgroup, it
can't be destroyed. can't be destroyed.
'show' [options] <path>:: *show* [options] <path>::
Show all qgroups in the btrfs filesystem identified by <path>. Show all qgroups in the btrfs filesystem identified by <path>.
+ +
`Options` `Options`
@ -83,7 +83,7 @@ If no prefix is given, use ascending order by default.
+ +
If multiple <attr>s is given, use comma to separate. If multiple <attr>s is given, use comma to separate.
'limit' [options] <size>|none [<qgroupid>] <path>:: *limit* [options] <size>|none [<qgroupid>] <path>::
Limit the size of a qgroup to <size> or no limit in the btrfs filesystem Limit the size of a qgroup to <size> or no limit in the btrfs filesystem
identified by <path>. identified by <path>.
+ +
@ -92,12 +92,12 @@ is used if possible.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs qgroup' returns a zero exist status if it succeeds. Non zero is *btrfs qgroup* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,11 +7,11 @@ btrfs-quota - control the quota of a btrfs filesystem
SYNOPSIS SYNOPSIS
-------- --------
'btrfs quota' <subcommand> <args> *btrfs quota* <subcommand> <args>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs quota' is used to enable/disable or rescan subvolume quota of a btrfs *btrfs quota* is used to enable/disable or rescan subvolume quota of a btrfs
filesystem. filesystem.
For setting quota or other quota operations on a btrfs filesystem, please see For setting quota or other quota operations on a btrfs filesystem, please see
@ -22,14 +22,14 @@ performance in mainline kernel yet(v3.14 so far).
SUBCOMMAND SUBCOMMAND
---------- ----------
'enable' <path>:: *enable* <path>::
Enable subvolume quota support for a filesystem. Enable subvolume quota support for a filesystem.
'disable' <path>:: *disable* <path>::
Disable subvolume quota support for a filesystem. Disable subvolume quota support for a filesystem.
'rescan' [-s] <path>:: *rescan* [-s] <path>::
Trash all qgroup numbers and scan the metadata again with the current config. Trash all qgroup numbers and scan the metadata again with the current config.
+ +
`Options` `Options`
@ -41,12 +41,12 @@ wait for rescan operation to finish(can be already in progress).
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs quota' returns a zero exist status if it succeeds. Non zero is *btrfs quota* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,15 +7,15 @@ btrfs-receive - receive subvolumes from stdin/file.
SYNOPSIS SYNOPSIS
-------- --------
'btrfs receive' [-ve] [-f <infile>] <mount> *btrfs receive* [-ve] [-f <infile>] <mount>
DESCRIPTION DESCRIPTION
----------- -----------
Receives one or more subvolumes that were previously Receives one or more subvolumes that were previously
sent with 'btrfs send'. The received subvolumes are stored sent with *btrfs send*. The received subvolumes are stored
into <mount>. into <mount>.
'btrfs receive' will fail with the following case: *btrfs receive* will fail with the following case:
1. a receiving subvolume already exists. 1. a receiving subvolume already exists.
@ -41,12 +41,12 @@ or on EOF.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs receive' returns a zero exist status if it succeeds. Non zero is *btrfs receive* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,11 +7,11 @@ btrfs-replace - replace devices managed by btrfs with other device.
SYNOPSIS SYNOPSIS
-------- --------
'btrfs replace' <subcommand> <args> *btrfs replace* <subcommand> <args>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs replace' is used to replace btrfs managed devices with other device. *btrfs replace* is used to replace btrfs managed devices with other device.
Note: this is not currently supported for RAID5/6 profiles and must use the Note: this is not currently supported for RAID5/6 profiles and must use the
device add/delete workaround. device add/delete workaround.
@ -21,7 +21,7 @@ management.
SUBCOMMAND SUBCOMMAND
---------- ----------
'start' [-Bfr] <srcdev>|<devid> <targetdev> <path>:: *start* [-Bfr] <srcdev>|<devid> <targetdev> <path>::
Replace device of a btrfs filesystem. Replace device of a btrfs filesystem.
+ +
On a live filesystem, duplicate the data to the target device which On a live filesystem, duplicate the data to the target device which
@ -52,7 +52,7 @@ never allowed to be used as the <targetdev>.
-B:::: -B::::
no background replace. no background replace.
'status' [-1] <mount_point>:: *status* [-1] <mount_point>::
Print status and progress information of a running device replace operation. Print status and progress information of a running device replace operation.
+ +
`Options` `Options`
@ -61,17 +61,17 @@ Print status and progress information of a running device replace operation.
print once instead of print continuously until the replace print once instead of print continuously until the replace
operation finishes (or is canceled) operation finishes (or is canceled)
'cancel' <mount_point>:: *cancel* <mount_point>::
Cancel a running device replace operation. Cancel a running device replace operation.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs replace' returns a zero exist status if it succeeds. Non zero is *btrfs replace* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,15 +7,15 @@ btrfs-rescue - Recover a damaged btrfs filesystem
SYNOPSIS SYNOPSIS
-------- --------
'btrfs rescue' <subcommand> <args> *btrfs rescue* <subcommand> <args>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs rescue' is used to try to recover a damaged btrfs filesystem. *btrfs rescue* is used to try to recover a damaged btrfs filesystem.
SUBCOMMAND SUBCOMMAND
---------- ----------
'chunk-recover' [options] <device>:: *chunk-recover* [options] <device>::
Recover the chunk tree by scanning the devices Recover the chunk tree by scanning the devices
+ +
`Options` `Options`
@ -27,10 +27,10 @@ verbose mode.
-h:::: -h::::
help. help.
NOTE: Since 'chunk-recover' will scan the whole device, it will be *VERY* slow NOTE: Since *chunk-recover* will scan the whole device, it will be *VERY* slow
especially executed on a large device. especially executed on a large device.
'super-recover' [options] <device>:: *super-recover* [options] <device>::
Recover bad superblocks from good copies. Recover bad superblocks from good copies.
+ +
`Options` `Options`
@ -42,12 +42,12 @@ verbose mode.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs rescue' returns a zero exist status if it succeeds. Non zero is *btrfs rescue* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,15 +7,15 @@ btrfs-restore - try to restore files from a damaged btrfs filesystem(unmounted)
SYNOPSIS SYNOPSIS
-------- --------
'btrfs restore' [options] <device> <path> | -l <device> *btrfs restore* [options] <device> <path> | -l <device>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs restore' is used to try to salvage files from a damaged filesystem and *btrfs restore* is used to try to salvage files from a damaged filesystem and
restore them into <path> or just list the tree roots. restore them into <path> or just list the tree roots.
Since current `btrfs-check`(8) or `btrfs-rescue`(8) only has very limited usage, Since current `btrfs-check`(8) or `btrfs-rescue`(8) only has very limited usage,
'btrfs restore' is normally a better choice. *btrfs restore* is normally a better choice.
NOTE: It is recommended to read the following btrfs wiki page if your data is NOTE: It is recommended to read the following btrfs wiki page if your data is
not salvaged with default option: + not salvaged with default option: +
@ -58,12 +58,12 @@ list tree roots.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs restore' returns a zero exist status if it succeeds. Non zero is *btrfs restore* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,21 +7,21 @@ btrfs-scrub - scrub btrfs filesystem
SYNOPSIS SYNOPSIS
-------- --------
'btrfs scrub' <subcommand> <args> *btrfs scrub* <subcommand> <args>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs scrub' is used to scrub a btrfs filesystem, which will reading all data *btrfs scrub* is used to scrub a btrfs filesystem, which will reading all data
from all disks and verifying checksums. from all disks and verifying checksums.
SUBCOMMAND SUBCOMMAND
---------- ----------
'start' [-BdqrRf] [-c <ioprio_class> -n <ioprio_classdata>] <path>|<device>:: *start* [-BdqrRf] [-c <ioprio_class> -n <ioprio_classdata>] <path>|<device>::
Start a scrub on all devices of the filesystem identified by <path> or on Start a scrub on all devices of the filesystem identified by <path> or on
a single <device>. a single <device>.
+ +
Without options, scrub is started as a background process. Without options, scrub is started as a background process.
Progress can be obtained with the 'scrub status' command. Scrubbing Progress can be obtained with the *scrub status* command. Scrubbing
involves reading all data from all disks and verifying checksums. Errors are involves reading all data from all disks and verifying checksums. Errors are
corrected along the way if possible. corrected along the way if possible.
+ +
@ -50,7 +50,7 @@ Set IO priority classdata (see `ionice`(1) manpage).
force to check whether scrub has started or resumed in userspace. force to check whether scrub has started or resumed in userspace.
this is useful when scrub stat record file is damaged. this is useful when scrub stat record file is damaged.
'cancel' <path>|<device>:: *cancel* <path>|<device>::
If a scrub is running on the filesystem identified by <path>, cancel it. If a scrub is running on the filesystem identified by <path>, cancel it.
+ +
Progress is saved in the scrub progress file and scrubbing can be resumed later Progress is saved in the scrub progress file and scrubbing can be resumed later
@ -58,7 +58,7 @@ using the scrub resume command.
If a <device> is given, the corresponding filesystem is found and If a <device> is given, the corresponding filesystem is found and
scrub cancel behaves as if it was called on that filesystem. scrub cancel behaves as if it was called on that filesystem.
'resume' [-BdqrR] [-c <ioprio_class> -n <ioprio_classdata>] <path>|<device>:: *resume* [-BdqrR] [-c <ioprio_class> -n <ioprio_classdata>] <path>|<device>::
Resume a canceled or interrupted scrub cycle on the filesystem identified by Resume a canceled or interrupted scrub cycle on the filesystem identified by
<path> or on a given <device>. <path> or on a given <device>.
+ +
@ -66,9 +66,9 @@ Does not start a new scrub if the last scrub finished successfully.
+ +
`Options` `Options`
+ +
see 'scrub start'. see *scrub start*.
'status' [-d] <path>|<device>:: *status* [-d] <path>|<device>::
Show status of a running scrub for the filesystem identified by <path> or Show status of a running scrub for the filesystem identified by <path> or
for the specified <device>. for the specified <device>.
+ +
@ -82,12 +82,12 @@ Print separate statistics for each device of the filesystem.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs scrub' returns a zero exist status if it succeeds. Non zero is *btrfs scrub* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,7 +7,7 @@ btrfs-send - send data of subvolume(s) to stdout/file.
SYNOPSIS SYNOPSIS
-------- --------
'btrfs send' [-ve] [-p <parent>] [-c <clone-src>] [-f <outfile>] <subvol> [<subvol>...] *btrfs send* [-ve] [-p <parent>] [-c <clone-src>] [-f <outfile>] <subvol> [<subvol>...]
DESCRIPTION DESCRIPTION
----------- -----------
@ -23,7 +23,7 @@ You must not specify clone sources unless you guarantee that these snapshots
are exactly in the same state on both sides, the sender and the receiver. are exactly in the same state on both sides, the sender and the receiver.
It is allowed to omit the '-p <parent>' option when '-c <clone-src>' options It is allowed to omit the '-p <parent>' option when '-c <clone-src>' options
are given, in which case 'btrfs send' will determine a suitable parent among the are given, in which case *btrfs send* will determine a suitable parent among the
clone sources itself. clone sources itself.
`Options` `Options`
@ -43,12 +43,12 @@ An alternative would be to use pipes.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs send' returns a zero exist status if it succeeds. Non zero is *btrfs send* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,11 +7,11 @@ btrfs-show-super - show btrfs superblock information stored in devices
SYNOPSIS SYNOPSIS
-------- --------
'btrfs-show-super' [options] <dev> [<dev>...] *btrfs-show-super* [options] <dev> [<dev>...]
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs-show-super' is used to print the information of superblock, *btrfs-show-super* is used to print the information of superblock,
you can specify which mirror to print out. you can specify which mirror to print out.
By default, every device's first superblock will be printed out. By default, every device's first superblock will be printed out.
@ -33,7 +33,7 @@ If several '-i <super_mirror>' are given, only the last one is valid.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs-show-super' will return 0 if no error happened. *btrfs-show-super* will return 0 if no error happened.
If any problems happened, 1 will be returned. If any problems happened, 1 will be returned.
AUTHOR AUTHOR

View File

@ -7,11 +7,11 @@ btrfs-subvolume - control btrfs subvolume(s)
SYNOPSIS SYNOPSIS
-------- --------
'btrfs subvolume' <subcommand> [<args>] *btrfs subvolume* <subcommand> [<args>]
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs subvolume' is used to control the filesystem to create/delete/list/show *btrfs subvolume* is used to control the filesystem to create/delete/list/show
subvolumes and snapshots. subvolumes and snapshots.
SUBVOLUME AND SNAPSHOT SUBVOLUME AND SNAPSHOT
@ -43,7 +43,7 @@ from normal directories.
SUBCOMMAND SUBCOMMAND
----------- -----------
'create' [-i <qgroupid>] [<dest>]<name>:: *create* [-i <qgroupid>] [<dest>]<name>::
Create a subvolume <name> in <dest>. Create a subvolume <name> in <dest>.
+ +
If <dest> is not given, subvolume <name> will be created in the currently If <dest> is not given, subvolume <name> will be created in the currently
@ -55,7 +55,7 @@ directory.
Add the newly created subvolume to a qgroup. This option can be given multiple Add the newly created subvolume to a qgroup. This option can be given multiple
times. times.
'delete' [options] <subvolume> [<subvolume>...]:: *delete* [options] <subvolume> [<subvolume>...]::
Delete the subvolume(s) from the filesystem. Delete the subvolume(s) from the filesystem.
+ +
If <subvolume> is not a subvolume, btrfs returns an error but continues if If <subvolume> is not a subvolume, btrfs returns an error but continues if
@ -75,7 +75,7 @@ wait for transaction commit at the end of the operation
-C|--commit-each:::: -C|--commit-each::::
wait for transaction commit after delet each subvolume wait for transaction commit after delet each subvolume
'list' [options] [-G [\+|-]<value>] [-C [+|-]<value>] [--sort=rootid,gen,ogen,path] <path>:: *list* [options] [-G [\+|-]<value>] [-C [+|-]<value>] [--sort=rootid,gen,ogen,path] <path>::
List the subvolumes present in the filesystem <path>. List the subvolumes present in the filesystem <path>.
+ +
For every subvolume the following information is shown by default. + For every subvolume the following information is shown by default. +
@ -125,7 +125,7 @@ you can add \'\+' or \'-' in front of each items, \'+' means ascending,
for --sort you can combine some items together by \',', just like for --sort you can combine some items together by \',', just like
-sort=+ogen,-gen,path,rootid. -sort=+ogen,-gen,path,rootid.
'snapshot' [-r] <source> <dest>|[<dest>/]<name>:: *snapshot* [-r] <source> <dest>|[<dest>/]<name>::
Create a writable/readonly snapshot of the subvolume <source> with the Create a writable/readonly snapshot of the subvolume <source> with the
name <name> in the <dest> directory. name <name> in the <dest> directory.
+ +
@ -133,32 +133,32 @@ If only <dest> is given, the subvolume will be named the basename of <source>.
If <source> is not a subvolume, btrfs returns an error. If <source> is not a subvolume, btrfs returns an error.
If '-r' is given, the snapshot will be readonly. If '-r' is given, the snapshot will be readonly.
'get-default' <path>:: *get-default* <path>::
Get the default subvolume of the filesystem <path>. Get the default subvolume of the filesystem <path>.
+ +
The output format is similar to 'subvolume list' command. The output format is similar to *subvolume list* command.
'set-default' <id> <path>:: *set-default* <id> <path>::
Set the subvolume of the filesystem <path> which is mounted as Set the subvolume of the filesystem <path> which is mounted as
default. default.
+ +
The subvolume is identified by <id>, which is returned by the 'subvolume list' The subvolume is identified by <id>, which is returned by the *subvolume list*
command. command.
'find-new' <subvolume> <last_gen>:: *find-new* <subvolume> <last_gen>::
List the recently modified files in a subvolume, after <last_gen> ID. List the recently modified files in a subvolume, after <last_gen> ID.
'show' <path>:: *show* <path>::
Show information of a given subvolume in the <path>. Show information of a given subvolume in the <path>.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs subvolume' returns a zero exist status if it succeeds. Non zero is *btrfs subvolume* returns a zero exist status if it succeeds. Non zero is
returned in case of failure. returned in case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,17 +7,17 @@ btrfs-zero-log - clear out log tree
SYNOPSIS SYNOPSIS
-------- --------
'btrfs-zero-log' <dev> *btrfs-zero-log* <dev>
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs-zero-log' will remove the log tree if log tree is corrupt, which will *btrfs-zero-log* will remove the log tree if log tree is corrupt, which will
allow you to mount the filesystem again. allow you to mount the filesystem again.
The common case where this happens has been fixed a long time ago, The common case where this happens has been fixed a long time ago,
so it is unlikely that you will see this particular problem. so it is unlikely that you will see this particular problem.
One can determine whether 'btrfs-zero-log' is needed according to the kernel One can determine whether *btrfs-zero-log* is needed according to the kernel
backtrace: backtrace:
---- ----
? replay_one_dir_item+0xb5/0xb5 [btrfs] ? replay_one_dir_item+0xb5/0xb5 [btrfs]
@ -29,15 +29,15 @@ backtrace:
? open_ctree+0xff6/0x132c [btrfs] ? open_ctree+0xff6/0x132c [btrfs]
---- ----
If the errors are like above, then 'btrfs-zero-log' should be used to clear If the errors are like above, then *btrfs-zero-log* should be used to clear
the log and the filesystem may be mounted normally again. the log and the filesystem may be mounted normally again.
NOTE: If you use btrfs as the root filesystem, you may want to include NOTE: If you use btrfs as the root filesystem, you may want to include
'btrfs-zero-log' into initramdisk if the log problems hits you often. *btrfs-zero-log* into initramdisk if the log problems hits you often.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs-zero-log' will return 0 if no error happened. *btrfs-zero-log* will return 0 if no error happened.
Other exit code means some problems happened. Other exit code means some problems happened.
AUTHOR AUTHOR

View File

@ -7,92 +7,92 @@ btrfs - control a btrfs filesystem
SYNOPSIS SYNOPSIS
-------- --------
'btrfs' <command> [<args>] *btrfs* <command> [<args>]
DESCRIPTION DESCRIPTION
----------- -----------
'btrfs' is used to control the filesystem and the files and directories stored. *btrfs* is used to control the filesystem and the files and directories stored.
It is the tool to create or destroy a snapshot or a subvolume for the It is the tool to create or destroy a snapshot or a subvolume for the
filesystem, to defrag a file or a directory, flush the data to the disk, filesystem, to defrag a file or a directory, flush the data to the disk,
to resize the filesystem, to scan the device. to resize the filesystem, to scan the device.
It is possible to abbreviate the commands unless the commands are ambiguous. It is possible to abbreviate the commands unless the commands are ambiguous.
For example: it is possible to run 'btrfs sub snaps' instead of For example: it is possible to run *btrfs sub snaps* instead of
'btrfs subvolume snapshot'. *btrfs subvolume snapshot*.
But 'btrfs file s' is not allowed, because 'file s' may be interpreted But *btrfs file s* is not allowed, because *file s* may be interpreted
both as 'filesystem show' and as 'filesystem sync'. both as *filesystem show* and as *filesystem sync*.
If a command is terminated by '--help', the detailed help is showed. If a command is terminated by '--help', the detailed help is showed.
If the passed command matches more commands, If the passed command matches more commands,
detailed help of all the matched commands is showed. For example detailed help of all the matched commands is showed. For example
'btrfs dev --help' shows the help of all 'device*' commands. *btrfs dev --help* shows the help of all *device** commands.
COMMANDS COMMANDS
-------- --------
'subvolume':: *subvolume*::
Create/delete/list/manage btrfs subvolume. + Create/delete/list/manage btrfs subvolume. +
See `btrfs-subvolume`(8) for details. See `btrfs-subvolume`(8) for details.
'filesystem':: *filesystem*::
Manage a btrfs filesystem, including label setting/sync and so on. + Manage a btrfs filesystem, including label setting/sync and so on. +
See `btrfs-filesystem`(8) for details. See `btrfs-filesystem`(8) for details.
'[filesystem] balance':: *[filesystem] balance*::
Balance btrfs filesystem chunks across single or several devices. + Balance btrfs filesystem chunks across single or several devices. +
See `btrfs-balance`(8) for details. See `btrfs-balance`(8) for details.
'device':: *device*::
Manage devices managed by btrfs, including add/delete/scan and so Manage devices managed by btrfs, including add/delete/scan and so
on. + on. +
See `btrfs-device`(8) for details. See `btrfs-device`(8) for details.
'scrub':: *scrub*::
Scrub a btrfs filesystem. + Scrub a btrfs filesystem. +
See `btrfs-scrub`(8) for details. See `btrfs-scrub`(8) for details.
'check':: *check*::
Do off-line check on a btrfs filesystem. + Do off-line check on a btrfs filesystem. +
See `btrfs-check`(8) for details. See `btrfs-check`(8) for details.
'rescue':: *rescue*::
Try to rescue damaged btrfs filesystem. + Try to rescue damaged btrfs filesystem. +
See `btrfs-rescue`(8) for details. See `btrfs-rescue`(8) for details.
'restore':: *restore*::
Manage a btrfs filesystem, including label setting/sync and so on. + Manage a btrfs filesystem, including label setting/sync and so on. +
See `btrfs-restore`(8) for details. See `btrfs-restore`(8) for details.
'inspect-internal':: *inspect-internal*::
Debug tools for developers/hackers. + Debug tools for developers/hackers. +
See `btrfs-inspect-internal`(8) for details. See `btrfs-inspect-internal`(8) for details.
'send':: *send*::
Send subvolume data to stdout/file for backup and etc. + Send subvolume data to stdout/file for backup and etc. +
See `btrfs-send`(8) for details. See `btrfs-send`(8) for details.
'receive':: *receive*::
Receive subvolume data from stdin/file for restore and etc. + Receive subvolume data from stdin/file for restore and etc. +
See `btrfs-receive`(8) for details. See `btrfs-receive`(8) for details.
'quota':: *quota*::
Manage quota on btrfs filesystem like enabling/rescan and etc. + Manage quota on btrfs filesystem like enabling/rescan and etc. +
See `btrfs-quota`(8) and `btrfs-qgroup`(8) for details. See `btrfs-quota`(8) and `btrfs-qgroup`(8) for details.
'qgroup':: *qgroup*::
Manage quota group(qgroup) for btrfs filesystem. + Manage quota group(qgroup) for btrfs filesystem. +
See `btrfs-qgroup`(8) for details. See `btrfs-qgroup`(8) for details.
'replace':: *replace*::
Replace btrfs devices. + Replace btrfs devices. +
See `btrfs-replace`(8) for details. See `btrfs-replace`(8) for details.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfs' returns a zero exist status if it succeeds. Non zero is returned in *btrfs* returns a zero exist status if it succeeds. Non zero is returned in
case of failure. case of failure.
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for

View File

@ -7,11 +7,11 @@ btrfstune - tune various btrfs filesystem parameters
SYNOPSIS SYNOPSIS
-------- --------
'btrfstune' [options] <dev> [<dev>...] *btrfstune* [options] <dev> [<dev>...]
DESCRIPTION DESCRIPTION
----------- -----------
'btrfstune' is used to tune various btrfs filesystem parameters,you can *btrfstune* is used to tune various btrfs filesystem parameters,you can
enable/disable some extended features for btrfs. enable/disable some extended features for btrfs.
OPTIONS OPTIONS
@ -27,7 +27,7 @@ Enable skinny metadata extent refs.
EXIT STATUS EXIT STATUS
----------- -----------
'btrfstune' will return 0 if no error happened. *btrfstune* will return 0 if no error happened.
If any problems happened, 1 will be returned. If any problems happened, 1 will be returned.
AUTHOR AUTHOR

View File

@ -7,11 +7,11 @@ fsck.btrfs - do nothing, successfully
SYNOPSIS SYNOPSIS
-------- --------
'fsck.btrfs' [-aApy] [<device>...] *fsck.btrfs* [-aApy] [<device>...]
DESCRIPTION DESCRIPTION
----------- -----------
'fsck.btrfs' is a type of utility that should exist for any filesystem and is *fsck.btrfs* is a type of utility that should exist for any filesystem and is
called during system setup when the corresponding `/etc/fstab` entries called during system setup when the corresponding `/etc/fstab` entries
contain non-zero value for `fs_passno` , see `fstab`(5) for more. contain non-zero value for `fs_passno` , see `fstab`(5) for more.
@ -26,7 +26,7 @@ with care!).
OPTIONS OPTIONS
------- -------
The options are all the same and detect if 'fsck.btrfs' is executed in The options are all the same and detect if *fsck.btrfs* is executed in
non-interactive mode and exits with success, non-interactive mode and exits with success,
otherwise prints a message about btrfs check. otherwise prints a message about btrfs check.

View File

@ -7,7 +7,7 @@ mkfs.btrfs - create a btrfs filesystem
SYNOPSIS SYNOPSIS
-------- --------
'mkfs.btrfs' *mkfs.btrfs*
$$[-A|--alloc-start <alloc-start>]$$ $$[-A|--alloc-start <alloc-start>]$$
$$[-b|--byte-count <byte-count>]$$ $$[-b|--byte-count <byte-count>]$$
$$[-d|--data <data-profile>]$$ $$[-d|--data <data-profile>]$$
@ -27,7 +27,7 @@ $$<device> [<device>...]$$
DESCRIPTION DESCRIPTION
----------- -----------
'mkfs.btrfs' *mkfs.btrfs*
is used to create a btrfs filesystem (usually in a disk partition, or an array is used to create a btrfs filesystem (usually in a disk partition, or an array
of disk partitions). of disk partitions).
@ -110,7 +110,7 @@ To see all features run::::
mkfs.btrfs -O list-all mkfs.btrfs -O list-all
-V|--version:: -V|--version::
Print the 'mkfs.btrfs' version and exit. Print the *mkfs.btrfs* version and exit.
-h:: -h::
Print help. Print help.
@ -122,7 +122,7 @@ to the arguments like 'k' for KBytes, 'm' for MBytes...
AVAILABILITY AVAILABILITY
------------ ------------
'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy *btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
development, development,
and not suitable for any uses other than benchmarking and review. and not suitable for any uses other than benchmarking and review.
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for