vfat-rs 0.1.1

A no_std-compatible FAT32/VFAT filesystem implementation in Rust for custom kernels
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

use crate::ClusterId;
use crate::PathBuf;
use crate::api::raw_directory_entry::Attributes;
use crate::api::timestamp::VfatTimestamp;
use alloc::string::String;

/// Metadatas are common to every entry type.
#[derive(Debug, Clone)]
pub struct Metadata {
    creation: VfatTimestamp,
    last_update: VfatTimestamp,
    //last_access: VfatTimestamp,
    pub(crate) name: String,
    /// Size of this file in bytes. For directories, it should be the sum of the sizes
    /// occupied by the metadatas of the contained files.
    pub(crate) size: u32,
    /// The path to this file - it does include the file name.
    path: PathBuf,
    /// empty files with size 0 should have first Cluster == 0.
    pub(crate) cluster: ClusterId,
    /// The path to this file - it doesn't include the file name.
    parent: PathBuf,
    pub(crate) attributes: Attributes,
}

impl Metadata {
    pub(crate) fn new<S: AsRef<str>>(
        creation: VfatTimestamp,
        last_update: VfatTimestamp,
        //last_access: VfatTimestamp,
        name: S,
        size: u32,
        path: PathBuf,
        cluster: ClusterId,
        parent: PathBuf,
        attributes: Attributes,
    ) -> Self {
        Self {
            creation,
            last_update,
            //last_access,
            name: String::from(name.as_ref()),
            size,
            path,
            cluster,
            parent,
            attributes,
        }
    }
}
impl Metadata {
    /// Returns the file size in bytes.
    pub fn size(&self) -> usize {
        self.size as usize
    }

    /*
    fn last_access(&self) -> Option<VfatTimestamp> {
        //Some(self.last_access)
        None
    }
    */

    pub(crate) fn last_update(&self) -> Option<VfatTimestamp> {
        Some(self.last_update)
    }
    // TODO: why are these optional?
    pub(crate) fn creation(&self) -> Option<VfatTimestamp> {
        Some(self.creation)
    }

    /// Returns the full path to this entry (including the entry name).
    pub fn full_path(&self) -> &PathBuf {
        &self.path
    }
    pub(crate) fn parent(&self) -> &PathBuf {
        &self.parent
    }
    /// Returns the entry's name (file or directory name, without path).
    pub fn name(&self) -> &str {
        &self.name
    }
    pub(crate) fn has_no_cluster_allocated(&self) -> bool {
        self.cluster == ClusterId::new(0)
    }
}