%general-entities; ]> btrfs-progs The btrfs-progs package contains administration and debugging tools for the B-tree file system (btrfs). &lfs113_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: &btrfs-progs-md5sum; Download size: &btrfs-progs-size; Estimated disk space required: &btrfs-progs-buildsize; Estimated build time: &btrfs-progs-time; Btrfs-progs Dependencies Required Optional (dmsetup is used in tests), (for tests), and (required to build documentation) Enable the following option in the kernel configuration and recompile the kernel: File systems ---> <*/M> Btrfs filesystem support [CONFIG_BTRFS_FS] In addition to the above and to the options required for and , the following options must be enabled for running tests: File systems ---> [*] Btrfs POSIX Access Control Lists [CONFIG_BTRFS_FS_POSIX_ACL] [*] ReiserFS extended attributes [CONFIG_REISERFS_FS_XATTR] [*] ReiserFS POSIX Access Control Lists [CONFIG_REISERFS_FS_POSIX_ACL] BTRFS Programs Install btrfs-progs by running the following commands: ./configure --prefix=/usr \ --disable-static \ --disable-documentation && make Some tests require grep built with perl regular expressions. To obtain this, rebuild grep with the LFS Chapter 8 instructions after installing . Before running tests, build a support program: make fssum To test the results, issue (as the &root; user): pushd tests ./fsck-tests.sh ./mkfs-tests.sh ./cli-tests.sh sed 's/,orphan_file//' /etc/mke2fs.conf >./custom_mke2fs.conf && export MKE2FS_CONFIG=$PWD/custom_mke2fs.conf && ./convert-tests.sh unset MKE2FS_CONFIG && rm custom_mke2fs.conf ./misc-tests.sh ./fuzz-tests.sh popd If the above mentioned kernel options are not enabled, some tests fail, and prevent all the remaining tests from running because the test disk image is not cleanly unmounted. Install the package as the &root; user: make install If you have passed --disable-documentation to configure and you need the manual pages, install them by running, as the &root; user: for i in 5 8; do install Documentation/*.$i /usr/share/man/man$i done --disable-documentation: This switch disables rebuilding the manual pages, because it requires . sed 's/,orphan_file//" ...: In this version of btrfs-progs, the btrfs-convert program produces a btrfs filesystem containing errors if converting from an ext4 filesystem created with the orphan_file feature. This command creates a custom configuration file that prevents creating a filesystem with this feature. This version of btrfs-progs does not convert correctly ext4 filesystems to btrfs if the ext4 orphan_file feature is turned on. If you happen to convert such a filesystem, you need to first run: tune2fs -O ^orphan_file /dev/sdxx where /dev/sdxx is the partition of the filesystem you want to convert. Installed Programs Installed Libraries Installed Directories btrfs, btrfs-convert, btrfs-find-root, btrfs-image, btrfs-map-logical, btrfs-select-super, btrfsck (link to btrfs), btrfstune, fsck.btrfs, and mkfs.btrfs libbtrfs.so and libbtrfsutil.so /usr/include/btrfs Short Descriptions btrfs is the main interface into btrfs filesystem operations btrfs btrfs-convert converts from an ext2/3/4 or reiserfs filesystem to btrfs (see above) btrfs-convert btrfs-find-root is a filter to find btrfs root btrfs-find-root btrfs-map-logical maps btrfs logical extent to physical extent btrfs-map-logical btrfs-select-super overwrites the primary superblock with a backup copy btrfs-select-super btrfstune tunes various filesystem parameters btrfstune fsck.btrfs does nothing, but is present for consistency with fstab fsck.btrfs mkfs.btrfs creates a btrfs file system mkfs.btrfs