vmgs_broker/
non_volatile_store.rs

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
// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.

//! Implementation of [`NonVolatileStore`] for VMGS files.

use crate::VmgsClient;
use crate::VmgsClientError;
use async_trait::async_trait;
use thiserror::Error;
use vmcore::non_volatile_store::NonVolatileStore;
use vmcore::non_volatile_store::NonVolatileStoreError;

/// A [`NonVolatileStore`] implementation for VMGS files.
pub struct VmgsNonVolatileStore {
    vmgs: VmgsClient,
    file_id: vmgs_format::FileId,
    encrypted: bool,
}

/// Error returned when a VMGS file is requested to be opened in encrypted mode,
/// but the VMGS broker was not compiled with encryption support.
#[derive(Debug, Error)]
#[error("the vmgs_broker crate was not compiled with encryption support")]
pub struct EncryptionNotSupported;

impl VmgsNonVolatileStore {
    /// Create a new [`NonVolatileStore`] object backed by a particular VMGS
    /// file-id.
    pub fn new(
        vmgs: VmgsClient,
        file_id: vmgs_format::FileId,
        encrypted: bool,
    ) -> Result<Self, EncryptionNotSupported> {
        if encrypted && !cfg!(with_encryption) {
            return Err(EncryptionNotSupported);
        }
        Ok(Self {
            vmgs,
            file_id,
            encrypted,
        })
    }
}

#[async_trait]
impl NonVolatileStore for VmgsNonVolatileStore {
    async fn persist(&mut self, data: Vec<u8>) -> Result<(), NonVolatileStoreError> {
        #[cfg(with_encryption)]
        if self.encrypted {
            self.vmgs
                .write_file_encrypted(self.file_id, data)
                .await
                .map_err(NonVolatileStoreError::new)?;
            return Ok(());
        }

        assert!(!self.encrypted);

        self.vmgs
            .write_file(self.file_id, data)
            .await
            .map_err(NonVolatileStoreError::new)?;

        Ok(())
    }

    async fn restore(&mut self) -> Result<Option<Vec<u8>>, NonVolatileStoreError> {
        match self.vmgs.read_file(self.file_id).await {
            Ok(buf) => Ok(Some(buf)),
            Err(VmgsClientError::Vmgs(vmgs::Error::FileInfoAllocated)) => Ok(None),
            Err(e) => Err(NonVolatileStoreError::new(e)),
        }
    }
}