1MKFS.BTRFS(8) System Manager's Manual MKFS.BTRFS(8)
2
3
4
6 mkfs.btrfs - create an btrfs filesystem
7
9 mkfs.btrfs [ -A alloc-start ] [ -b byte-count ] [ -d data-profile ] [
10 -l leafsize ] [ -L label ] [ -m metadata profile ] [ -n nodesize ] [
11 -s sectorsize ] [ -h ] [ -V ] device [ device ... ]
12
14 mkfs.btrfs is used to create an btrfs filesystem (usually in a disk
15 partition, or an array of disk partitions). device is the special file
16 corresponding to the device (e.g /dev/sdXX ). If multiple devices
17 are specified, btrfs is created spanning across the specified devices.
18
20 -A, --alloc-start offset
21 Specify the offset from the start of the device to start the
22 btrfs filesystem. The default value is zero, or the start of the
23 device.
24
25 -b, --byte-count size
26 Specify the size of the resultant filesystem. If this option is
27 not used, mkfs.btrfs uses all the available storage for the
28 filesystem.
29
30 -d, --data type
31 Specify how the data must be spanned across the devices speci‐
32 fied. Valid values are raid0, raid1, raid10 or single.
33
34 -l, --leafsize size
35 Specify the leaf size, the least data item in which btrfs stores
36 data. The default value is the page size.
37
38 -L, --label name
39 Specify a label for the filesystem.
40
41 -m, --metadata profile
42 Specify how metadata must be spanned across the devices speci‐
43 fied. Valid values are raid0, raid1, raid10 or single.
44
45 -n, --nodesize size
46 Specify the nodesize. By default the value is set to the page‐
47 size.
48
49 -s, --sectorsize size
50 Specify the sectorsize, the minimum block allocation.
51
52 -V, --version
53 Print the mkfs.btrfs version and exit.
54
56 mkfs.btrfs is part of btrfs-progs. Btrfs is currently under heavy
57 development, and not suitable for any uses other than benchmarking and
58 review. Please refer to the btrfs wiki http://btrfs.wiki.kernel.org
59 for further details.
60
62 btrfsck(8)
63
64
65
66 MKFS.BTRFS(8)