%general-entities; ]> $LastChangedBy$ $Date$ btrfs-progs The btrfs-progs package contains administration and debugging tools for the B-tree file system (btrfs). &lfs84_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 Recommended and (both required to generate man pages) Optional (dmsetup is used in tests), (python bindings), (for tests), and zstd (for tests) User Notes: Enable the following option in the kernel configuration and recompile the kernel: File systems ---> <*/M> Btrfs filesystem support [CONFIG_BTRFS_FS] CONFIG_BTRFS_FS_POSIX_ACL and CONFIG_REISERFS_FS_XATTR are required for some tests. Other Btrfs options in the kernel are optional. BTRFS Programs Install btrfs-progs by running the following commands: ./configure --prefix=/usr \ --bindir=/bin \ --libdir=/lib \ --disable-zstd && make Some tests require grep built with perl regular expressions. To obtain this, rebuild grep with the LFS Chapter 6 instructions after installing . Before running tests, build a support program and disable several that fail: make fssum && sed -i '/found/s/^/: #/' tests/convert-tests.sh && mv tests/convert-tests/010-reiserfs-basic/test.sh{,.broken} && mv tests/convert-tests/011-reiserfs-delete-all-rollback/test.sh{,.broken} && mv tests/convert-tests/012-reiserfs-large-hole-extent/test.sh{,.broken} && mv tests/convert-tests/013-reiserfs-common-inode-flags/test.sh{,.broken} && mv tests/convert-tests/014-reiserfs-tail-handling/test.sh{,.broken} && mv tests/misc-tests/025-zstd-compression/test.sh{,.broken} To test the results, issue (as the root user): pushd tests ./fsck-tests.sh ./mkfs-tests.sh ./cli-tests.sh ./convert-tests.sh ./misc-tests.sh ./fuzz-tests.sh popd Install the package as the root user: make install && ln -sfv ../../lib/$(readlink /lib/libbtrfs.so) /usr/lib/libbtrfs.so && ln -sfv ../../lib/$(readlink /lib/libbtrfsutil.so) /usr/lib/libbtrfsutil.so && rm -fv /lib/libbtrfs.{a,so} /lib/libbtrfsutil.{a,so} && mv -v /bin/{mkfs,fsck}.btrfs /sbin --disable-documentation: This option is needed if the recommended dependencies are not installed. mv tests/{cli,convert,misc,fuzz}-tests/ ...: Disables tests that fail and prevent tests from completing. ln -s ... /usr/lib/libbtrfs.so: Creates a symbolic link in the directory where it is expected. rm /lib/libbtrfs.{a,so}: Removes unneeded library entries. 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 filesystem to btrfs. 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