1BTRFSCTL(8)                 System Manager's Manual                BTRFSCTL(8)
2
3
4

NAME

6       btrfsctl - control a btrfs filesystem
7

SYNOPSIS

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

NOTE

14       B  btrfsctl is deprecated. Please consider to switch to the btrfs util‐
15       ity.
16

DESCRIPTION

18       btrfsctl is used to control the filesystem and the files  and  directo‐
19       ries  stored.  It is the tool to create a new snapshot for the filesys‐
20       tem.
21

OPTIONS

23       -d file|directory
24              Defragment a file or a directory. If the argument  is  a  direc‐
25              tory, the entire b-tree under the directory is defragged.
26
27       -s snapshot-name directory
28              Creates a new snapshot of the directory specified.
29
30       -S subvolume-name directory
31              Creates a new subvolume.
32
33       -r [+|-]size
34              Resizes  the filesystem with the size specified. If the value is
35              preceded with a signed symbol, the filesystem  is  resized  with
36              respect  to the current filesystem size. size can be suffixed by
37              k,m or g to represent kilobytes, megabytes, or gigabytes respec‐
38              tively.
39
40       -A device
41              Scans the device for btrfs filesystem.
42
43       -a     Scans all devices present in the system for btrfs filesystem.
44
45       -c     Forces a filesystem sync.
46

AVAILABILITY

48       btrfsctl  is part of btrfs-progs. Btrfs is currently under heavy devel‐
49       opment, and not suitable for  any  uses  other  than  benchmarking  and
50       review.   Please  refer  to the btrfs wiki http://btrfs.wiki.kernel.org
51       for further details.
52

SEE ALSO

54       mkfs.btrfs(8)
55
56
57
58                                                                   BTRFSCTL(8)
Impressum