btrfs-uapi 0.12.0

Wrappers around the btrfs userspace interface (ioctls and sysfs)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

use crate::common::{single_mount, write_test_data};
use btrfs_uapi::{
    filesystem::{filesystem_info, sync},
    quota::{quota_disable, quota_enable, quota_rescan_wait},
    sysfs::SysfsBtrfs,
};

/// SysfsBtrfs should read filesystem properties that match filesystem_info.
#[test]
#[ignore = "requires elevated privileges"]
fn sysfs_read_info() {
    let (_td, mnt) = single_mount();

    let info = filesystem_info(mnt.fd()).expect("filesystem_info failed");
    let sysfs = SysfsBtrfs::new(&info.uuid);

    let nodesize = sysfs.nodesize().expect("sysfs nodesize failed");
    assert_eq!(
        nodesize, info.nodesize as u64,
        "sysfs nodesize should match filesystem_info",
    );

    let sectorsize = sysfs.sectorsize().expect("sysfs sectorsize failed");
    assert_eq!(
        sectorsize, info.sectorsize as u64,
        "sysfs sectorsize should match filesystem_info",
    );

    let metadata_uuid =
        sysfs.metadata_uuid().expect("sysfs metadata_uuid failed");
    // metadata_uuid equals fsid when no separate metadata UUID is set.
    assert_eq!(
        metadata_uuid, info.uuid,
        "sysfs metadata_uuid should match filesystem_info uuid (no separate metadata uuid set)",
    );
}

/// SysfsBtrfs commit_stats should show commits after writes + sync.
#[test]
#[ignore = "requires elevated privileges"]
fn sysfs_commit_stats() {
    let (_td, mnt) = single_mount();

    write_test_data(mnt.path(), "data.bin", 1_000_000);
    sync(mnt.fd()).unwrap();

    let info = filesystem_info(mnt.fd()).expect("filesystem_info failed");
    let sysfs = SysfsBtrfs::new(&info.uuid);

    let stats = sysfs.commit_stats().expect("commit_stats failed");
    assert!(
        stats.commits > 0,
        "should have at least one commit after write+sync: {stats:?}",
    );
}

/// Quota status should be visible via sysfs after enabling/disabling quotas.
#[test]
#[ignore = "requires elevated privileges"]
fn sysfs_quota_status() {
    let (_td, mnt) = single_mount();

    let info = filesystem_info(mnt.fd()).expect("filesystem_info failed");
    let sysfs = SysfsBtrfs::new(&info.uuid);

    // Quotas should be disabled initially.
    let status = sysfs.quota_status().expect("quota_status failed");
    assert!(!status.enabled, "quotas should be disabled initially");

    // Enable quotas.
    quota_enable(mnt.fd(), false).expect("quota_enable failed");
    quota_rescan_wait(mnt.fd()).expect("quota_rescan_wait failed");

    let status = sysfs
        .quota_status()
        .expect("quota_status after enable failed");
    assert!(
        status.enabled,
        "quotas should be enabled after quota_enable"
    );

    // Disable quotas.
    quota_disable(mnt.fd()).expect("quota_disable failed");

    let status = sysfs
        .quota_status()
        .expect("quota_status after disable failed");
    assert!(
        !status.enabled,
        "quotas should be disabled after quota_disable"
    );
}