vfs-host 0.2.1

Host trait implementation for VFS adapter - enables multiple applications to share a single VFS instance
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

// WASI Filesystem Preopens Host Implementation
//
// Implements wasi:filesystem/preopens interface using fs-core directly

use super::{FsDescriptorWrapper, VfsHostState};
use wasmtime::component::Resource;

impl wasmtime_wasi::bindings::sync::filesystem::preopens::Host for VfsHostState {
    fn get_directories(
        &mut self,
    ) -> Result<
        Vec<(
            Resource<wasmtime_wasi::bindings::filesystem::types::Descriptor>,
            String,
        )>,
        anyhow::Error,
    > {
        log::debug!("[VFS-HOST] get_directories() called");

        // Open root directory using fs-core directly (no external lock needed)
        // O_RDONLY | O_DIRECTORY flags
        const O_RDONLY: u32 = 0;
        const O_DIRECTORY: u32 = 0x10000;

        let fd = self
            .shared_vfs
            .open_path_with_flags("/", O_RDONLY | O_DIRECTORY)
            .map_err(|e| anyhow::anyhow!("Failed to open root directory: {:?}", e))?;

        log::debug!("[VFS-HOST] Opened root directory with fd={}", fd);

        // Create wrapper with directory path for relative path resolution
        let wrapper = FsDescriptorWrapper {
            fd,
            path: Some("/".to_string()),
        };

        // Push to ResourceTable
        let wrapper_resource: Resource<FsDescriptorWrapper> = self.table.push(wrapper)?;

        // Transmute Resource<FsDescriptorWrapper> to Resource<Descriptor>
        // SAFETY: Resource<T> is a transparent u32 wrapper, so transmute is safe
        // Compile-time checks ensure size and alignment match
        const _: () = {
            use std::mem::{align_of, size_of};
            assert!(
                size_of::<Resource<FsDescriptorWrapper>>()
                    == size_of::<Resource<wasmtime_wasi::bindings::filesystem::types::Descriptor>>(
                    )
            );
            assert!(
                align_of::<Resource<FsDescriptorWrapper>>()
                    == align_of::<Resource<wasmtime_wasi::bindings::filesystem::types::Descriptor>>(
                    )
            );
        };
        let host_descriptor = unsafe {
            std::mem::transmute::<
                Resource<FsDescriptorWrapper>,
                Resource<wasmtime_wasi::bindings::filesystem::types::Descriptor>,
            >(wrapper_resource)
        };

        log::debug!("[VFS-HOST] Returning preopened root directory");
        Ok(vec![(host_descriptor, "/".to_string())])
    }
}