Request
The payload of the channel request: the tag byte 7 and the request of the channel.
[7][size: u64, big-endian][path …]
- The form. The bytes after the tag are exactly the bytes after
the tag of the FUSE truncate ask on a
mount scope, and mean the same; that page states every field. The
path is UTF-8,
/-separated, with no leading/; empty is the root of the served subtree. - Malformed. A channel request whose payload does not decode as stated is answered by a channel response finish that no channel response precedes, and the server does nothing else for it.
The channel request is defined by diverge-sdk-rs/src/provider/endpoints/containers/fuse_serve/client/channel_request/frame.rs:
//! What a client's channel request frame carries on a container
//! FUSE serve scope.
/// One of the nine asks, the stop, or the tree: the
/// [`volumes::fuse_serve`](crate::provider::endpoints::volumes::fuse_serve) scope's
/// channel request, byte for byte — `0`–`8` the mount's asks, `9`
/// the stop, `10` the tree — answered here from a container rather
/// than a volume. See [`Frame`](crate::provider::endpoints::volumes::fuse_serve::client::channel_request::Frame)
/// for every tag.
///
/// An alias rather than a re-export because this module is real: the
/// path says this scope's channel request lives here, and it does,
/// rather than naming somewhere else and hoping a reader follows.
/// What the alias points at is right there in the signature. One
/// type rather than two because the whole point is that a bridge
/// forwards bytes: an ask a mount makes goes to a volume or to a
/// container in the same frame, and nothing is re-encoded on the way.
pub type Frame<'a> = crate::provider::endpoints::volumes::fuse_serve::client::channel_request::Frame<'a>;
/// A container FUSE serve channel request that could not be read: the
/// volume FUSE serve's own failures. See
/// [`FrameError`](crate::provider::endpoints::volumes::fuse_serve::client::channel_request::FrameError).
pub type FrameError = crate::provider::endpoints::volumes::fuse_serve::client::channel_request::FrameError;
and by diverge-sdk-rs/src/container_proxy/outside/endpoints/fuse/mount/server/channel_request/truncate.rs:
//! Truncate a mounted file.
use std::str;
use super::FrameError;
use crate::wire::encode::{Encode, Writer};
/// Set a file of the mount to `size` bytes, by its path. Answered
/// with one [`Ack`](crate::shared::containers::fuse::ack::Frame).
///
/// ```text
/// [size: u64 BE][path: utf8…]
/// ```
///
/// The size precedes the path, so the path runs to the end and needs
/// no prefix. On a file mount the path is empty.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default)]
pub struct Truncate<'a> {
/// The file's path inside the mount; empty for a file mount.
pub path: &'a str,
/// The length the file has after, in bytes.
pub size: u64,
}
impl Encode for Truncate<'_> {
/// [`Infallible`](std::convert::Infallible): eight bytes and a
/// path's own.
type Error = std::convert::Infallible;
fn encode(&self, out: &mut Writer<'_>) -> Result<(), Self::Error> {
out.extend_from_slice(&self.size.to_be_bytes());
out.extend_from_slice(self.path.as_bytes());
Ok(())
}
}
impl<'a> Truncate<'a> {
/// Decode from the bytes after the ask's tag. The path borrows
/// from `bytes`.
pub fn decode(bytes: &'a [u8]) -> Result<Self, FrameError> {
let size: [u8; 8] = bytes.get(..8).and_then(|head| head.try_into().ok()).ok_or(FrameError::Truncated)?;
Ok(Truncate {
path: str::from_utf8(&bytes[8..]).map_err(|_| FrameError::PathUtf8)?,
size: u64::from_be_bytes(size),
})
}
}