+
`Options`
+
--d[filters]::::
+-d[<filters>]::::
act on data chunks
--m[filters]::::
+-m[<filters>]::::
act on metadata chunks
--s[filters]::::
+-s[<filters>]::::
act on system chunks (only under -f)
-v::::
be verbose
OPTIONS
-------
--s|--support <superblock>::
+-s|--super <superblock>::
use <superblock>th superblock copy.
--repair::
try to repair the filesystem.
SUBCOMMAND
----------
-'df' [-b]
path [<path>...]::
+'df' [-b]
<path> [<path>...]::
Show space usage information for a mount point.
+
If '-b' is given, then byte is used as unit. Default unit will be
If all the data and metadata are duplicated (or have a profile like RAID1)
the Data to disk ratio could be 50%.
-'show' [--mounted|--all-devices|<path>|<uuid>|<device>|<lable>]::
+'show' [--mounted|--all-devices|<path>|<uuid>|<device>|<label>]::
Show the btrfs filesystem with some additional info.
+
-If no option nor <path>|<uuid>|<device>|<lable> is passed, btrfs shows
+If no option nor <path>|<uuid>|<device>|<label> is passed, btrfs shows
information of all the btrfs filesystem both mounted and unmounted.
If '--mounted' is passed, it would probe btrfs kernel to list mounted btrfs
filesystem(s);
copies with `cp --reflink`.
// 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
devid *online*. +
The devid can be found with 'btrfs filesystem show' and
it with the new desired size. When recreating the partition make sure to use
the same starting disk cylinder as before.
-'label' [<dev>|<mount_point>] [newlabel]::
+'label' [<dev>|<mountpoint>] [<newlabel>]::
Show or update the label of a filesystem.
+
[<device>|<mountpoint>] is used to identify the filesystem.
restored by running tree log reply if possible. To restore without
changing number of stripes in chunk tree check -o option.
--c value::
+-c <value>::
Compression level (0 ~ 9).
--t value::
+-t <value>::
Number of threads (1 ~ 32) to be used to process the image dump or restore.
-o::
-v::::
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.
+
By default, each inode is then resolved to a file system path (similar to the
list all qgroups which impact the given path(include ancestral qgroups)
-f::::
list all qgroups which impact the given path(exclude ancestral qgroups)
---sort=[\+/-]ATTR[,[+/-]ATTR]...::::
-list qgroups in order of ATTR.
+--sort=[\+/-]<attr>[,[+/-]<attr>]...::::
+list qgroups in order of <attr>.
+
-ATTR can be one or more of qgroupid,rfer,excl,max_rfer,max_excl.
+<attr> can be one or more of qgroupid,rfer,excl,max_rfer,max_excl.
+
-Prefix \'+' means ascending order and \'-' means descending order of ATTR.
+Prefix \'+' means ascending order and \'-' means descending order of <attr>.
If no prefix is given, use ascending order by default.
+
-If multiple ATTRs is given, use comma to separate.
+If multiple <attr>s is given, use comma to separate.
'limit' [options] <size>|none [<qgroupid>] <path>::
Limit the size of a qgroup to <size> or no limit in the btrfs filesystem
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
a single <device>.
+
Read only mode. Do not attempt to correct anything.
-R::::
Raw print mode. Print full data instead of summary.
--c ioprio_class::::
+-c <ioprio_class>::::
Set IO priority class (see
ionice (1)
manpage).
--n ioprio_classdata::::
+-n <ioprio_classdata>::::
Set IO priority classdata (see `ionice`(1) manpage).
-f::::
force to check whether scrub has started or resumed in userspace.
If a <device> is given, the corresponding filesystem is found and
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
<path> or on a given <device>.
+
-C|--commit-each::::
wait for transaction commit after delet each subvolume
-'list' [options] [-G [\+|-]
values] [-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>.
+
For every subvolume the following information is shown by default. +
only snapshot subvolumes in the filesystem will be listed.
-r::::
only readonly subvolumes in the filesystem will be listed.
--G [+|-]value::::
+-G [+|-]<value>::::
list subvolumes in the filesystem that its generation is
>=, \<= or = value. \'\+' means >= value, \'-' means \<= value, If there is
neither \'+' nor \'-', it means = value.
--C [+|-]value::::
+-C [+|-]<value>::::
list subvolumes in the filesystem that its ogeneration is
>=, \<= or = value. The usage is the same to '-g' option.
--sort=rootid,gen,ogen,path::::
SYNOPSIS
--------
-'fsck.btrfs' [-aApy] [device...]
+'fsck.btrfs' [-aApy] [<device>...]
DESCRIPTION
-----------
$$[-s|--sectorsize <sectorsize>]$$
$$[-r|--rootdir <rootdir>]$$
$$[-K|--nodiscard]$$
-$$[-O|--features <feature1>[<,feature2...>]]$$
+$$[-O|--features <feature1>[,<feature2>...]]$$
$$[-h]$$
$$[-V|--version]$$
$$<device> [<device>...]$$
projects / platform / upstream / btrfs-progs.git / commitdiff