%general-entities; ]> $LastChangedBy$ $Date$ btrfs-progs-&btrfs-progs-version; btrfs-progs Introduction to btrfs-progs The btrfs-progs package contains administration and debugging tools for the B-tree file system (btrfs). &lfs81_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) User Notes: Kernel Configuration 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 Installation of btrfs-progs Install btrfs-progs by running the following commands: sed -i '1,100 s/\.gz//g' Documentation/Makefile.in && ./configure --prefix=/usr \ --bindir=/bin \ --libdir=/lib && make Before running tests, build a support program and disable several that fail: make fssum && sed -i '/found/s/^/: #/' tests/convert-tests.sh && mv tests/misc-tests/025-zstd-compression/test.sh{,.broken} && mv tests/convert-tests/010-reiserfs-basic/test.sh{,.broken} && mv tests/convert-tests/011-reiserfs-delete-all-rollback/test.sh{,.broken} && mv tests/fuzz-tests/003-multi-check-unmounted/test.sh{,.broken} && mv tests/fuzz-tests/009-simple-zero-log/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 && rm -v /lib/libbtrfs.{a,so} && mv -v /bin/{mkfs,fsck}.btrfs /sbin Command Explanations sed ... Documentation/Makefile.in: Disables compressing man pages to be consistent with the rest of BLFS. : 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. Contents Installed Programs Installed Libraries Installed Directories btrfs, btrfs-convert, btrfs-debug-tree, btrfs-find-root, btrfs-image, btrfs-map-logical, btrfs-select-super, btrfs-show-super, btrfs-zero-log, btrfsck (link to btrfs), btrfstune, fsck.btrfs, and mkfs.btrfs libbtrfs.so /usr/include/btrfs Short Descriptions btrfs is the main interface into btrfs filesystem operations. btrfs btrfs-convert converts from ext2/3/4 filesystem to btrfs. btrfs-convert btrfs-debug-tree queries various internal information. btrfs-debug-tree 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 primary superblock with a backup copy. btrfs-select-super btrfs-show-super queries various internal information. btrfs-show-super btrfs-zero-log recovers a damaged btrfs filesystem. btrfs-zero-log 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