mirror of
https://github.com/kdave/btrfs-progs
synced 2024-12-23 06:32:57 +00:00
7bf6343fa1
Signed-off-by: Augusto Mecking Caringi <augustocaringi@gmail.com> Signed-off-by: David Sterba <dsterba@suse.cz>
62 lines
1.9 KiB
Plaintext
62 lines
1.9 KiB
Plaintext
Install Instructions
|
|
|
|
Btrfs uses libcrc32c in the kernel for file and metadata checksums. You need
|
|
to compile the kernel with:
|
|
|
|
CONFIG_LIBCRC32C=m
|
|
|
|
libcrc32c can be static as well. Once your kernel is setup, typing make in the
|
|
btrfs module sources will build against the running kernel. When the build is
|
|
complete:
|
|
|
|
modprobe libcrc32c
|
|
insmod btrfs.ko
|
|
|
|
The Btrfs utility programs require the following libraries/tools to build:
|
|
|
|
- libuuid (This can be found in the e2fsprogs sources, and is usually available
|
|
as libuuid or e2fsprogs-devel from various distros).
|
|
- libattr (Extended attribute library - Development files)
|
|
- libblkid (Block device id library - Development files)
|
|
- liblzo2 (LZO data compression library - Development files)
|
|
- libacl (Access control list library - Development files)
|
|
- e2fslibs (ext2/ext3/ext4 file system libraries - Development files)
|
|
- asciidoc (Text document format tool - For documentation)
|
|
|
|
Building the utilities is just make ; make install. The programs go
|
|
into /usr/local/bin. The mains commands available are:
|
|
|
|
mkfs.btrfs: create a filesystem
|
|
|
|
btrfs: control program to create snapshots and subvolumes:
|
|
# mount a btrfs filesystem
|
|
mount /dev/sda2 /mnt
|
|
|
|
# create a subvolume
|
|
btrfs subvolume create /mnt/new_subvol_name
|
|
|
|
# snapshot of a subvolume
|
|
btrfs subvolume snapshot /mnt/default /mnt/snapshot_of_default
|
|
btrfs subvolume snapshot /mnt/snapshot_of_default \
|
|
/mnt/snapshot_of_a_snapshot
|
|
|
|
# list of the subvolumes
|
|
ls /mnt
|
|
default snapshot_of_a_snapshot snapshot_of_new_subvol
|
|
new_subvol_name snapshot_of_default
|
|
|
|
# removal of a subvolume or a snapshot
|
|
btrfs subvolume delete /mn/snapshot_of_a_snapshot
|
|
|
|
# look a the btrfs man page for further information
|
|
man btrfs
|
|
|
|
btrfsck: do a limited check of the FS extent trees.</li>
|
|
|
|
btrfs-debug-tree: print all of the FS metadata in text form. Example:
|
|
|
|
btrfs-debug-tree /dev/sda2 >& big_output_file
|
|
|
|
|
|
|