confuse 0.1.0

A fuser-compatible filesystem API facade using Dokan on Windows and fuser elsewhere.
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

//! API surface tests — verify that confuse re-exports (non-windows) and
//! implements (windows) all expected public symbols with correct signatures.
//! Feature-gated items are exercised only under their corresponding feature.
//!
//! Baseline: upstream `fuser 0.17.0` as resolved in `Cargo.lock`.
//! This file is the parity checklist for the Windows facade. Platform-specific
//! behavior differences are recorded as runtime semantics, not missing APIs.

// ── fuser 0.17.0 parity checklist ──────────────────────────────────────────

struct Fuser017ParityChecklist;

impl Fuser017ParityChecklist {
    const CORE_EXPORTS: &'static [&'static str] = &[
        "Errno",
        "FileAttr",
        "FileType",
        "KernelConfig",
        "Request",
        "RequestId",
        "INodeNo",
        "FileHandle",
        "LockOwner",
        "Generation",
        "Version",
        "TimeOrNow",
        "INodeNo::ROOT",
    ];
    const FLAG_AND_NEWTYPE_EXPORTS: &'static [&'static str] = &[
        "AccessFlags",
        "BsdFileFlags",
        "CopyFileRangeFlags",
        "FopenFlags",
        "InitFlags",
        "IoctlFlags",
        "OpenAccMode",
        "OpenFlags",
        "PollEvents",
        "PollFlags",
        "RenameFlags",
    ];
    const FILESYSTEM_SURFACE: &'static [&'static str] = &[
        "Filesystem: Send + Sync + 'static",
        "init/destroy lifecycle methods",
        "operation callbacks use &self in fuser 0.17.0 except lifecycle methods",
        "poll uses PollNotifier, PollEvents, and PollFlags",
        "batch_forget uses ForgetOne accessors",
    ];
    const REPLY_SURFACE: &'static [&'static str] = &[
        "ReplyEmpty",
        "ReplyData",
        "ReplyEntry",
        "ReplyAttr",
        "ReplyOpen",
        "ReplyWrite",
        "ReplyStatfs",
        "ReplyCreate",
        "ReplyLock",
        "ReplyBmap",
        "ReplyIoctl",
        "ReplyLseek",
        "ReplyXattr",
        "ReplyDirectory",
        "ReplyDirectoryPlus",
        "ReplyPoll",
        "reply error methods take Errno in fuser 0.17.0",
    ];
    const MOUNT_SESSION_SURFACE: &'static [&'static str] = &[
        "Config",
        "MountOption",
        "Session",
        "SessionACL",
        "SessionUnmounter",
        "BackgroundSession",
        "mount2/spawn_mount2",
    ];
    const POLL_NOTIFIER_SURFACE: &'static [&'static str] = &[
        "Notifier",
        "PollHandle",
        "PollNotifier",
        "PollNotifier::handle",
        "PollNotifier::notify",
    ];
    const WINDOWS_PLATFORM_NOTES: &'static [&'static str] = &[
        "Errno and public flag/newtype surfaces are compile-enforced on Windows by Task 2.",
        "Filesystem operation callbacks are compile-enforced on Windows as immutable &self methods; init/destroy remain mutable lifecycle methods.",
        "PollHandle/PollNotifier and Filesystem::poll are compile-enforced on Windows; notifier delivery is a deterministic Dokan stub.",
        "MountOption excludes legacy ACL variants on Windows; fuser 0.17.0 access policy is Config.acl/SessionACL.",
        "Session::from_fd exists on Windows and returns Unsupported because Dokan has no /dev/fuse file descriptor surface; upstream fuser 0.17.0 uses std::os::fd::OwnedFd, while Windows facade names rustix::fd::OwnedFd directly.",
        "Session implements rustix::fd::AsFd on Windows with a simulated rustix fd so generic fd callers compile like upstream fuser 0.17.0.",
        "Kernel passthrough reply helpers exist on Windows with deterministic unsupported behavior because Dokan has no FUSE backing-id fd surface; upstream fuser 0.17.0 uses std::os::fd::AsFd, while Windows facade names rustix::fd::AsFd directly.",
        "macOS-only ReplyXTimes and BSD file flag semantics remain exposed behind the intentional Windows macos-api feature.",
    ];
}

#[test]
fn records_fuser_017_parity_categories() {
    assert!(Fuser017ParityChecklist::CORE_EXPORTS.contains(&"Errno"));
    assert!(Fuser017ParityChecklist::FLAG_AND_NEWTYPE_EXPORTS.contains(&"OpenFlags"));
    assert!(
        Fuser017ParityChecklist::FILESYSTEM_SURFACE
            .contains(&"batch_forget uses ForgetOne accessors")
    );
    assert!(Fuser017ParityChecklist::REPLY_SURFACE.contains(&"ReplyDirectoryPlus"));
    assert!(Fuser017ParityChecklist::MOUNT_SESSION_SURFACE.contains(&"SessionACL"));
    assert!(Fuser017ParityChecklist::POLL_NOTIFIER_SURFACE.contains(&"PollNotifier"));
    assert!(
        Fuser017ParityChecklist::WINDOWS_PLATFORM_NOTES
            .iter()
            .any(|note| note.contains("Dokan"))
    );
}