From Fedora Project Wiki


This test case ensures the proper installation and basic functionality of the btrfs-progs utilities for managing and maintaining the Btrfs filesystem.


  1. Install a fresh version of Fedora.
  2. Install the btrfs-progs package: sudo dnf install btrfs-progs.
  3. Ensure you have an unallocated disk or partition for testing or are comfortable creating/destroying a Btrfs filesystem on an existing partition (WARNING: this will destroy data).

How to test

  1. Check the installed version of the Btrfs utilities: btrfs --version.
  2. Create a Btrfs filesystem on a partition (e.g., /dev/sdX): sudo mkfs.btrfs /dev/sdX (replace sdX with your specific partition/device).
  3. Create a mount point: mkdir ~/btrfs_mount.
  4. Mount the Btrfs filesystem: sudo mount /dev/sdX ~/btrfs_mount.
  5. Create a file in the mounted filesystem: echo "Btrfs test data" > ~/btrfs_mount/test.txt.
  6. Unmount the filesystem: sudo umount ~/btrfs_mount.
  7. Check the Btrfs filesystem for errors: sudo btrfs check /dev/sdX.

Expected Results

  1. The version of the Btrfs utilities should be displayed without errors.
  2. The Btrfs filesystem should be created successfully without any errors.
  3. The mount command should complete successfully, and the test.txt file should be written to the Btrfs filesystem.
  4. The btrfs check command should report no errors for the Btrfs filesystem.


For advanced testing:

  1. Test creating and managing Btrfs subvolumes using btrfs subvolume.
  2. Test the btrfs balance command to balance block groups on the Btrfs filesystem.
  3. Check disk usage statistics with the btrfs filesystem df command.
  4. Experiment with Btrfs RAID configurations using multiple devices.