nfs3_server 0.11.0

A Rust NFSv3 Server implementation
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

use std::fs::{File, Permissions};
#[cfg(unix)]
use std::os::unix::fs::{FileTypeExt, MetadataExt, PermissionsExt};
#[cfg(windows)]
use std::os::windows::fs::MetadataExt;
use std::path::Path;

use nfs3_types::nfs3::ftype3;

pub struct NfsMetadataExt<'a>(pub &'a std::fs::Metadata);

#[cfg(unix)]
impl NfsMetadataExt<'_> {
    pub fn mode(&self) -> u32 {
        self.0.mode()
    }
    pub fn nlink(&self) -> u32 {
        self.0.nlink().try_into().unwrap_or(u32::MAX)
    }

    pub fn uid(&self) -> u32 {
        self.0.uid()
    }

    pub fn gid(&self) -> u32 {
        self.0.gid()
    }

    pub fn file_type(&self) -> ftype3 {
        let file_type = self.0.file_type();
        if file_type.is_file() {
            ftype3::NF3REG
        } else if file_type.is_dir() {
            ftype3::NF3DIR
        } else if file_type.is_symlink() {
            ftype3::NF3LNK
        } else if file_type.is_block_device() {
            ftype3::NF3BLK
        } else if file_type.is_char_device() {
            ftype3::NF3CHR
        } else if file_type.is_fifo() {
            ftype3::NF3FIFO
        } else if file_type.is_socket() {
            ftype3::NF3SOCK
        } else {
            ftype3::NF3REG // Default case (though ideally unreachable)
        }
    }

    pub fn set_mode_on_path(path: impl AsRef<Path>, mode: u32) -> std::io::Result<()> {
        std::fs::set_permissions(path, Permissions::from_mode(mode))
    }

    pub fn set_mode_on_file(file: &File, mode: u32) -> std::io::Result<()> {
        file.set_permissions(Permissions::from_mode(mode))
    }
}

#[cfg(windows)]
#[allow(clippy::unnecessary_wraps, clippy::unused_self)]
impl NfsMetadataExt<'_> {
    pub fn mode(&self) -> u32 {
        // Assume full `rwxrwxrwx` permissions if not read-only
        if self.0.permissions().readonly() {
            0o444 // Readable by all, not writable
        } else {
            0o666 // Readable and writable by all
        }
    }

    /// `number_of_links` is nightly only, issue: 63010
    pub fn nlink(&self) -> u32 {
        if self.0.is_dir() { 2 } else { 1 }
    }

    pub const fn uid(&self) -> u32 {
        1000
    }

    pub const fn gid(&self) -> u32 {
        1000
    }

    pub fn file_type(&self) -> ftype3 {
        if self.0.is_file() {
            ftype3::NF3REG
        } else if self.0.is_symlink() {
            ftype3::NF3LNK
        } else if self.0.is_dir() {
            ftype3::NF3DIR
        } else {
            ftype3::NF3REG // Default case (though ideally unreachable)
        }
    }

    pub fn set_mode_on_path(_path: impl AsRef<Path>, _mode: u32) -> std::io::Result<()> {
        tracing::debug!("setting permissions is not supported");
        Ok(())
    }

    pub fn set_mode_on_file(_file: &File, _mode: u32) -> std::io::Result<()> {
        tracing::debug!("setting permissions is not supported");
        Ok(())
    }
}