nfs-rs 0.6.1

An asynchronous pure Rust client library for NFSv3, experimental NFSv4.0, and NFSv4.1
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

//! Mount41 implementation of ACL operations (getacl, setacl, aclsupport).

use bytes::Bytes;

use super::mount::Mount41;
use crate::error::{NfsError, Result};
use crate::mount;
use crate::nfs4::acl;

impl Mount41 {
    pub(crate) async fn getacl(&self, fh: Bytes) -> Result<mount::Acl> {
        let bitmap: [u32; 1] = [1 << 12]; // FATTR4_ACL
        let resp = self
            .compound("getacl", |b| b.putfh(&fh).getattr(&bitmap))
            .await;
        let resp = acl::attrnotsupp_as_unsupported("GETACL", resp)?;
        resp.op_ok(1)?; // PUTFH
        let getattr = resp.op_ok(2)?;
        let mut data = getattr.data.clone();
        acl::decode_getattr_acl(&mut data)
    }

    pub(crate) async fn setacl(&self, fh: Bytes, acl: &mount::Acl) -> Result<()> {
        let (attrmask, attr_vals) = acl::encode_setattr_acl(acl);
        // Anonymous stateid is acceptable for SETATTR when no conflicting share reservations
        // exist (RFC 5661 ยง8.2.3). Consistent with how setattr.rs handles the same case.
        let stateid = [0u8; 16];
        let resp = self
            .compound("setacl", |b| {
                b.putfh(&fh).setattr(&stateid, &attrmask, &attr_vals)
            })
            .await;
        let resp = acl::attrnotsupp_as_unsupported("SETACL", resp)?;
        resp.op_ok(1)?; // PUTFH
        let setattr_op = resp
            .results
            .get(2)
            .ok_or_else(|| NfsError::Xdr("SETATTR response missing op at index 2".to_string()))?;
        if !matches!(setattr_op.status, crate::nfs4::fastxdr::nfsstat4::NFS4_OK) {
            return Err(NfsError::Nfs4(setattr_op.status));
        }
        Ok(())
    }

    pub(crate) async fn aclsupport(&self, fh: Bytes) -> Result<mount::AclSupport> {
        let bitmap: [u32; 1] = [1 << 13]; // FATTR4_ACLSUPPORT
        let resp = self
            .compound("aclsupport", |b| b.putfh(&fh).getattr(&bitmap))
            .await?;
        resp.op_ok(1)?; // PUTFH
        let getattr = resp.op_ok(2)?;
        let mut data = getattr.data.clone();
        acl::decode_getattr_aclsupport(&mut data)
    }

    async fn get_acl41(
        &self,
        fh: Bytes,
        attribute: u32,
        operation: &str,
    ) -> Result<mount::NfsAcl41> {
        let bitmap = [0, 1 << (attribute - 32)];
        let resp = self
            .compound(operation, |b| b.putfh(&fh).getattr(&bitmap))
            .await;
        let resp = acl::attrnotsupp_as_unsupported(operation, resp)?;
        resp.op_ok(1)?;
        let getattr = resp.op_ok(2)?;
        let mut data = getattr.data.clone();
        acl::decode_getattr_acl41(&mut data, attribute)
    }

    async fn set_acl41(
        &self,
        fh: Bytes,
        value: &mount::NfsAcl41,
        attribute: u32,
        operation: &str,
    ) -> Result<()> {
        let (attrmask, attr_vals) = acl::encode_setattr_acl41(value, attribute);
        let stateid = [0u8; 16];
        let resp = self
            .compound(operation, |b| {
                b.putfh(&fh).setattr(&stateid, &attrmask, &attr_vals)
            })
            .await;
        let resp = acl::attrnotsupp_as_unsupported(operation, resp)?;
        resp.op_ok(1)?;
        resp.op_ok(2)?;
        Ok(())
    }

    pub(crate) async fn getdacl(&self, fh: Bytes) -> Result<mount::NfsAcl41> {
        self.get_acl41(fh, crate::nfs4::attrnum::DACL, "GETDACL")
            .await
    }

    pub(crate) async fn setdacl(&self, fh: Bytes, value: &mount::NfsAcl41) -> Result<()> {
        self.set_acl41(fh, value, crate::nfs4::attrnum::DACL, "SETDACL")
            .await
    }

    pub(crate) async fn getsacl(&self, fh: Bytes) -> Result<mount::NfsAcl41> {
        self.get_acl41(fh, crate::nfs4::attrnum::SACL, "GETSACL")
            .await
    }

    pub(crate) async fn setsacl(&self, fh: Bytes, value: &mount::NfsAcl41) -> Result<()> {
        self.set_acl41(fh, value, crate::nfs4::attrnum::SACL, "SETSACL")
            .await
    }
}