man btrfs

BTRFS(8)                                                              btrfs                                                              BTRFS(8)

NAME
btrfs - control a btrfs filesystem # утилита контроля и управления btrfs

SYNOPSIS
btrfs subvolume snapshot [-r] [/] # снимок файловой системы существующего на этот момент именованного объёиа

Btrfs subvolume delete # удалить существующий на этот момент именованный объём файловой системы

Btrfs subvolume create [/] # создать именованный объём файловой системы btrfs

Btrfs subvolume list [-p] # просмотреть список всех именованных подъобъёмов файловой системы btrfs

Btrfs subvolume set-default # установить по умолчанию этот подъобъём

Btrfs subvolume get-default # получить сведения об объёмах btrfs установленных по умолчанию

Btrfs filesystem df # просмотреть файловую систему btrfs (для уже знающих утилиту df понятно сразу)

Btrfs filesystem sync # синхронизировать подъобъёмы btrfs

Btrfs filesystem resize [+/-][gkm]|max # изменить размер или установить максимально возможными

Btrfs filesystem label [newlabel] # назначить метку подъобъёму btrfs следом указать метку

Btrfs filesystem defrag [options] | # дефрагментировать с опциями
[|
...]

Btrfs subvolume find-new # найти новые подъобъёмы (видимо для тех кто вчера творил админство в союзе с пивом :-) или для обнаружения
новых-добавленных инопланетянами)

Btrfs filesystem balance # сбалансировать ( х.з., но видимо отличается от синхронизации в сторону "проверить балланс"
- прим. "переводчика" )

Btrfs filesystem defragment | # типа: подробнее о дефрагментации (наслышан о пуде соли без пива с этим геморром :-)))
[|
...]

Btrfs filesystem show [--all-devices|| # просто посмотреть все девайсы под btrfs, ибо их должно быть явно больше одного
[|
...]

Defragment file data and/or directory metadata. To defragment all files in a directory you have to specify each one on its own or
use your shell wildcards.

# Дефрагментация файлов и/или метаданных каталога. Для дефрагментации файлов в каталоге вы должны указать каталог или конкретный
файл для его дефрагментации.

The start position and the number of bytes to deframention can be specified by start and len.

# Можете указать размер файлов, для которых дефрагметация небудет производиться.

Any extent bigger than thresh will be considered already defragged.

# Любые экстенты большие по размеру, чем мусор (т. есть - большие, чем указанные
наименьшие размеры файлов в байтах в предыдущей позиции справки) будут
дефрагментироваться.

Use 0 to take the kernel default, and use 1 to say eveery single extent must be rewritten. You can
also turn on compression in defragment operations.

# Используйте 0 по умолчанию, и используйте 1, чтобы каждый экстент был переписан заново. Вы можете
также включить процесс сжатия во время дефрагментации.

-v be verbose # визуальное подробное отображение операций

-c compress file contents while defragmenting # сжатие файлов в процессе дефрагментации

-f flush filesystem after defragmenting # вид после дефрагментации

-s start defragment only from byte start onward # начинать дефрагментацию с такого-то байта и продолжать далее

-l len defragment only up to len bytes # дефрагментировать только до такого-то байта

-t size defragment only files at least size bytes big # размер дефрагментации, если размер файла большой

NOTE: defragmenting with kernels up to 2.6.37 will unlink COW-ed copies of data, don't use it if you use snapshots, have de-dupli‐
cated your data or made copies with cp --reflink. subvolume find-new List the recently modified files in a
subvolume, after ID.

# Примечание: Если дефрагментируете под ядром (или меньше) 2.6.37 то не используйте указания на копии данных при снятии снимков
файловой системы, поскольку снова дублируются ваши данные или изменяются существующие копии: получается типа команды "копировать
ссылку на ссылку". Ищите новые подъобъёмы после изменения файлов на подъобъёмах после идентификации. (сам них... не понял внятно,
считайте последнее предложение переводом блондинки :-)

Filesystem sync
Force a sync for the filesystem identified by . # принудительно синхронизировать идентифицированную файловую систему

Продолжение будет чуть позже 24 часов :-))

Filesystem resize [+/-][gkm]|max
Resize a filesystem identified by . The parameter specifies the new size of the filesystem. If the prefix + or - is
present the size is increased or decreased by the quantity . If no units are specified, the unit of the parameter
defaults to bytes. Optionally, the size parameter may be suffixed by one of the following the units designators: 'K', 'M', or 'G',
kilobytes, megabytes, or gigabytes, respectively.

If 'max' is passed, the filesystem will occupy all available space on the volume(s).

The resize command does not manipulate the size of underlying partition. If you wish to enlarge/reduce a filesystem, you must make
sure you can expand the partition before enlarging the filesystem and shrink the partition after reducing the size of the filesys‐
tem.


btrfs filesystem label [newlabel]
Show or update the label of a filesystem. is used to identify the filesystem. If a newlabel optional argument is passed, the
label is changed. The following costraints exist for a label:

- the maximum allowable lenght shall be less or equal than 256 chars

- the label shall not contain the '/' or '\' characters.

NOTE: Currently there are the following limitations:

- the filesystem has to be unmounted

- the filesystem should not have more than one device.


filesystem show [--all-devices||]
Show the btrfs filesystem with some additional info. If no UUID or label is passed, btrfs show info of all the btrfs filesystem.
If --all-devices is passed, all the devices under /dev are scanned; otherwise the devices list is extracted from the /proc/parti‐
tions file.


filesystem balance
Balance the chunks of the filesystem identified by across the devices.


device add [..]
Add device(s) to the filesystem identified by .


device delete [..]
Remove device(s) from a filesystem identified by .


device scan [--all-devices| [...]
If one or more devices are passed, these are scanned for a btrfs filesystem. If no devices are passed, btrfs scans all the block
devices listed in the /proc/partitions file. Finally, if --all-devices is passed, all the devices under /dev are scanned.


scrub start [-Bdqru] {|}
Start a scrub on all devices of the filesystem identified by or on a single . Without options, scrub is started as a
background process. Progress can be obtained with the scrub status command. Scrubbing involves reading all data from all disks and
verifying checksums. Errors are corrected along the way if possible.

Options

-B Do not background and print scrub statistics when finished.

-d Print separate statistics for each device of the filesystem (-B only).

-q Quiet. Omit error messages and statistics.

-r Read only mode. Do not attempt to correct anything.

-u Scrub unused space as well. (NOT IMPLEMENTED)


scrub cancel {|}
If a scrub is running on the filesystem identified by , cancel it. Progress is saved in the scrub progress file and scrub‐
bing can be resumed later using the scrub resume command. If a is given, the corresponding filesystem is found and scrub
cancel behaves as if it was called on that filesystem.


scrub resume [-Bdqru] {|}
Resume a canceled or interrupted scrub cycle on the filesystem identified by or on a given . Does not start a new
scrub if the last scrub finished successfully.

Options

See scrub start.


scrub status [-d] {|}
Show status of a running scrub for the filesystem identified by or for the specified . If no scrub is running, show
statistics of the last finished or canceled scrub for that filesystem or device.

Options

-d Print separate statistics for each device of the filesystem.


inspect-internal inode-resolve [-v]
Resolves an in subvolume to all filesystem paths.

Options

-v verbose mode. print count of returned paths and ioctl() return value


inspect-internal logical-resolve [-Pv]
Resolves a address in the filesystem mounted at to all inodes. By default, each inode is then resolved to a file
system path (similar to the inode-resolve subcommand).

Options

-P skip the path resolving and print the inodes instead

-v verbose mode. print count of returned paths and all ioctl() return values


EXIT STATUS
btrfs returns a zero exist status if it succeeds. Non zero is returned in case of failure.


AVAILABILITY
btrfs is part of btrfs-tools. Btrfs filesystem is currently under heavy development, and not suitable for any uses other than benchmarking
and review. Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for further details.

SEE ALSO
mkfs.btrfs(8)

Btrfs BTRFS(8)


Подробнее ? ---\/ (см. ниже у Икспертов ) :-)

Http://wiki.belykh.me/wiki/index.php/BtrFS

Http://rus-linux.net/nlib.php?name=/MyLDP/file-sys/znakomstvo-s-btrfs.html

Или далее:

MKFS.BTRFS(8) MKFS.BTRFS(8)

NAME
mkfs.btrfs - create an btrfs filesystem

SYNOPSIS
mkfs.btrfs [ -A alloc-start ] [ -b byte-count ] [ -d data-profile ] [ -l leafsize ] [ -L label ] [ -m metadata profile ] [ -M mixed
data+metadata ] [ -n nodesize ] [ -s sectorsize ] [ -h ] [ -V ] device [ device ... ]

DESCRIPTION
mkfs.btrfs is used to create an btrfs filesystem (usually in a disk partition, or an array of disk partitions). device is the special
file corresponding to the device (e.g /dev/sdXX ). If multiple devices are specified, btrfs is created spanning across the specified
devices.

OPTIONS
-A, --alloc-start offset
Specify the offset from the start of the device to start the btrfs filesystem. The default value is zero, or the start of the
device.

-b, --byte-count size
Specify the size of the resultant filesystem. If this option is not used, mkfs.btrfs uses all the available storage for the
filesystem.

-d, --data type
Specify how the data must be spanned across the devices specified. Valid values are raid0, raid1, raid10 or single.

-l, --leafsize size
Specify the leaf size, the least data item in which btrfs stores data. The default value is the page size.

-L, --label name
Specify a label for the filesystem.

-m, --metadata profile
Specify how metadata must be spanned across the devices specified. Valid values are raid0, raid1, raid10 or single.

-M, --mixed
Mix data and metadata chunks together for more efficient space utilization. This feature incurs a performance penalty in larger
filesystems. It is recommended for use with filesystems of 1 GiB or smaller.

-n, --nodesize size
Specify the nodesize. By default the value is set to the pagesize.

-s, --sectorsize size
Specify the sectorsize, the minimum block allocation.

-V, --version
Print the mkfs.btrfs version and exit.

AVAILABILITY
mkfs.btrfs is part of btrfs-tools. Btrfs is currently under heavy development, and not suitable for any uses other than benchmarking and
review. Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for further details.

SEE ALSO
btrfsck(8)

Далее

MKFS.BTRFS(8)


BTRFSCK(8) BTRFSCK(8)

NAME
btrfsck - check a btrfs filesystem

SYNOPSIS
btrfsck device

DESCRIPTION
btrfsck is used to check a btrfs filesystem. device is the device file where the filesystem is stored.

AVAILABILITY
btrfsck is part of btrfs-tools. Btrfs is currently under heavy development, and not suitable for any uses other than benchmarking and
review. Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for further details.

SEE ALSO
mkfs.btrfs(8) btrfsctl(8)

BTRFSCK(8)

Далее

BTRFSCTL(8) BTRFSCTL(8)

NAME
btrfsctl - control a btrfs filesystem

SYNOPSIS
btrfsctl [ -d file|directory ] [ -s snapshot-name directory ] [ -S subvolume-name directory ] [ -r [+-]size ] [ -A device ] [ -a ] [
-c ]

NOTE
B btrfsctl is deprecated. Please consider to switch to the btrfs utility.

DESCRIPTION
btrfsctl is used to control the filesystem and the files and directories stored. It is the tool to create a new snapshot for the filesys‐
tem.

OPTIONS
-d file|directory
Defragment a file or a directory. If the argument is a directory, the entire b-tree under the directory is defragged.

-s snapshot-name directory
Creates a new snapshot of the directory specified.

-S subvolume-name directory
Creates a new subvolume.

-r [+|-]size
Resizes the filesystem with the size specified. If the value is preceded with a signed symbol, the filesystem is resized with
respect to the current filesystem size. size can be suffixed by k,m or g to represent kilobytes, megabytes, or gigabytes respec‐
tively.

-A device
Scans the device for btrfs filesystem.

-a Scans all devices present in the system for btrfs filesystem.

-c Forces a filesystem sync.

AVAILABILITY
btrfsctl is part of btrfs-tools. Btrfs is currently under heavy development, and not suitable for any uses other than benchmarking and
review. Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for further details.

SEE ALSO
mkfs.btrfs(8)

BTRFSCTL(8)