2014-04-02 08:29:12 +00:00
|
|
|
btrfs(8)
|
|
|
|
========
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
|
|
|
btrfs - control a btrfs filesystem
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2014-05-19 15:49:35 +00:00
|
|
|
*btrfs* <command> [<args>]
|
2014-04-02 08:29:12 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2016-01-07 15:28:05 +00:00
|
|
|
The *btrfs* utility is a toolbox for managing btrfs filesystems. There are
|
|
|
|
command groups to work with subvolumes, devices, for whole filesystem or other
|
|
|
|
specific actions. See section *COMMANDS*.
|
|
|
|
|
|
|
|
COMMAND SYTNAX
|
|
|
|
--------------
|
|
|
|
|
|
|
|
Any command name can be shortened as far as it stays unambiguous,
|
|
|
|
however it is recommended to use full command names in scripts.
|
|
|
|
All command groups have their manual page named *btrfs-<group>*.
|
2014-04-02 08:29:12 +00:00
|
|
|
|
2014-05-19 15:49:35 +00:00
|
|
|
For example: it is possible to run *btrfs sub snaps* instead of
|
|
|
|
*btrfs subvolume snapshot*.
|
|
|
|
But *btrfs file s* is not allowed, because *file s* may be interpreted
|
|
|
|
both as *filesystem show* and as *filesystem sync*.
|
2014-04-02 08:29:12 +00:00
|
|
|
|
2016-01-07 15:28:05 +00:00
|
|
|
If the command name is ambiguous, the list of conflicting options is
|
|
|
|
printed.
|
|
|
|
|
|
|
|
For an overview of a given command use 'btrfs command --help'
|
|
|
|
or 'btrfs [command...] --help --full' to print all available options.
|
2014-04-02 08:29:12 +00:00
|
|
|
|
|
|
|
COMMANDS
|
|
|
|
--------
|
2015-01-03 01:12:56 +00:00
|
|
|
*balance*::
|
2014-04-02 08:29:12 +00:00
|
|
|
Balance btrfs filesystem chunks across single or several devices. +
|
|
|
|
See `btrfs-balance`(8) for details.
|
|
|
|
|
2014-05-19 15:49:35 +00:00
|
|
|
*check*::
|
2014-04-02 08:29:12 +00:00
|
|
|
Do off-line check on a btrfs filesystem. +
|
|
|
|
See `btrfs-check`(8) for details.
|
|
|
|
|
2015-01-03 00:45:17 +00:00
|
|
|
*device*::
|
|
|
|
Manage devices managed by btrfs, including add/delete/scan and so
|
|
|
|
on. +
|
|
|
|
See `btrfs-device`(8) for details.
|
2014-04-02 08:29:12 +00:00
|
|
|
|
2015-01-03 00:45:17 +00:00
|
|
|
*filesystem*::
|
2014-04-02 08:29:12 +00:00
|
|
|
Manage a btrfs filesystem, including label setting/sync and so on. +
|
2015-01-03 00:45:17 +00:00
|
|
|
See `btrfs-filesystem`(8) for details.
|
2014-04-02 08:29:12 +00:00
|
|
|
|
2014-05-19 15:49:35 +00:00
|
|
|
*inspect-internal*::
|
2014-04-02 08:29:12 +00:00
|
|
|
Debug tools for developers/hackers. +
|
|
|
|
See `btrfs-inspect-internal`(8) for details.
|
|
|
|
|
2015-01-03 00:45:17 +00:00
|
|
|
*property*::
|
|
|
|
Get/set a property from/to a btrfs object. +
|
|
|
|
See `btrfs-property`(8) for details.
|
|
|
|
|
|
|
|
*qgroup*::
|
|
|
|
Manage quota group(qgroup) for btrfs filesystem. +
|
|
|
|
See `btrfs-qgroup`(8) for details.
|
2014-04-02 08:29:12 +00:00
|
|
|
|
2014-05-19 15:49:35 +00:00
|
|
|
*quota*::
|
2014-04-02 08:29:12 +00:00
|
|
|
Manage quota on btrfs filesystem like enabling/rescan and etc. +
|
|
|
|
See `btrfs-quota`(8) and `btrfs-qgroup`(8) for details.
|
|
|
|
|
2015-01-03 00:45:17 +00:00
|
|
|
*receive*::
|
|
|
|
Receive subvolume data from stdin/file for restore and etc. +
|
|
|
|
See `btrfs-receive`(8) for details.
|
2014-04-02 08:29:12 +00:00
|
|
|
|
2014-05-19 15:49:35 +00:00
|
|
|
*replace*::
|
2014-04-02 08:29:12 +00:00
|
|
|
Replace btrfs devices. +
|
|
|
|
See `btrfs-replace`(8) for details.
|
|
|
|
|
2015-01-03 00:45:17 +00:00
|
|
|
*rescue*::
|
|
|
|
Try to rescue damaged btrfs filesystem. +
|
|
|
|
See `btrfs-rescue`(8) for details.
|
|
|
|
|
|
|
|
*restore*::
|
2015-06-30 23:56:52 +00:00
|
|
|
Try to restore files from a damaged btrfs filesystem. +
|
2015-01-03 00:45:17 +00:00
|
|
|
See `btrfs-restore`(8) for details.
|
|
|
|
|
|
|
|
*scrub*::
|
|
|
|
Scrub a btrfs filesystem. +
|
|
|
|
See `btrfs-scrub`(8) for details.
|
|
|
|
|
|
|
|
*send*::
|
|
|
|
Send subvolume data to stdout/file for backup and etc. +
|
|
|
|
See `btrfs-send`(8) for details.
|
|
|
|
|
|
|
|
*subvolume*::
|
|
|
|
Create/delete/list/manage btrfs subvolume. +
|
|
|
|
See `btrfs-subvolume`(8) for details.
|
2014-12-16 09:42:38 +00:00
|
|
|
|
2014-04-02 08:29:12 +00:00
|
|
|
EXIT STATUS
|
|
|
|
-----------
|
2014-09-19 01:49:59 +00:00
|
|
|
*btrfs* returns a zero exit status if it succeeds. Non zero is returned in
|
2014-04-02 08:29:12 +00:00
|
|
|
case of failure.
|
|
|
|
|
|
|
|
AVAILABILITY
|
|
|
|
------------
|
2014-05-19 16:04:26 +00:00
|
|
|
*btrfs* is part of btrfs-progs.
|
2014-04-02 08:29:12 +00:00
|
|
|
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
|
|
|
|
further details.
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
--------
|
|
|
|
`mkfs.btrfs`(8), `ionice`(1),
|
|
|
|
`btrfs-balance`(8),
|
|
|
|
`btrfs-check`(8),
|
2015-01-03 00:45:17 +00:00
|
|
|
`btrfs-device`(8),
|
|
|
|
`btrfs-filesystem`(8),
|
2014-04-02 08:29:12 +00:00
|
|
|
`btrfs-inspect-internal`(8),
|
2015-01-03 00:45:17 +00:00
|
|
|
`btrfs-property`(8),
|
2014-04-02 08:29:12 +00:00
|
|
|
`btrfs-qgroup`(8),
|
2015-01-03 00:45:17 +00:00
|
|
|
`btrfs-quota`(8),
|
|
|
|
`btrfs-receive`(8),
|
2014-04-02 08:29:12 +00:00
|
|
|
`btrfs-replace`(8),
|
2015-01-03 00:45:17 +00:00
|
|
|
`btrfs-rescue`(8),
|
|
|
|
`btrfs-restore`(8),
|
|
|
|
`btrfs-scrub`(8),
|
|
|
|
`btrfs-send`(8),
|
|
|
|
`btrfs-subvolume`(8),
|