microsandbox-filesystem 0.3.13

Filesystem backends and guest filesystem support for microsandbox.
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

//! Shared helpers for serving snapshot-backed directory entries.

use crate::DirEntry;

//--------------------------------------------------------------------------------------------------
// Types
//--------------------------------------------------------------------------------------------------

/// View over a backend-owned directory snapshot entry.
pub(crate) trait SnapshotEntry {
    /// Guest-visible inode number.
    fn inode(&self) -> u64;

    /// Stable offset cookie.
    fn offset(&self) -> u64;

    /// Guest-visible directory entry type.
    fn file_type(&self) -> u32;

    /// Entry name bytes.
    fn name(&self) -> &[u8];
}

//--------------------------------------------------------------------------------------------------
// Functions
//--------------------------------------------------------------------------------------------------

/// Serve directory entries from a snapshot starting strictly after `offset`.
pub(crate) fn serve_snapshot_entries<T: SnapshotEntry>(
    entries: &[T],
    offset: u64,
) -> Vec<DirEntry<'static>> {
    let start = entries
        .iter()
        .position(|entry| entry.offset() > offset)
        .unwrap_or(entries.len());

    let slice = &entries[start..];
    if slice.is_empty() {
        return Vec::new();
    }

    let mut names_buf = Vec::new();
    let mut raw_entries = Vec::with_capacity(slice.len());

    for entry in slice {
        let name_offset = names_buf.len();
        names_buf.extend_from_slice(entry.name());
        raw_entries.push((
            entry.inode(),
            entry.offset(),
            entry.file_type(),
            name_offset,
            entry.name().len(),
        ));
    }

    let leaked: &'static [u8] = Box::leak(names_buf.into_boxed_slice());

    raw_entries
        .into_iter()
        .map(|(ino, off, typ, start, len)| DirEntry {
            ino,
            offset: off,
            type_: typ,
            name: &leaked[start..start + len],
        })
        .collect()
}