pub struct SyntheticTree { /* private fields */ }Expand description
A synthetic 9P file tree backed by closures.
Services construct a tree at startup, then delegate 9P walk/open/read/write operations to it. All state is in the fid table; the tree itself is immutable after construction.
Implementations§
Source§impl SyntheticTree
impl SyntheticTree
pub fn new(root: SyntheticNode) -> Self
Sourcepub fn walk(
&self,
wnames: &[String],
owner: &str,
newfid: Option<u32>,
) -> Result<(u32, SyntheticQid), String>
pub fn walk( &self, wnames: &[String], owner: &str, newfid: Option<u32>, ) -> Result<(u32, SyntheticQid), String>
Walk path components from root.
If newfid is Some and > 0, uses the client-chosen fid (9P protocol).
If newfid is None or 0, auto-allocates a server-side fid.
Sourcepub fn open(
&self,
fid: u32,
mode: u8,
owner: &str,
) -> Result<(SyntheticQid, u32), String>
pub fn open( &self, fid: u32, mode: u8, owner: &str, ) -> Result<(SyntheticQid, u32), String>
Open a walked fid for I/O.
Sourcepub fn read(
&self,
fid: u32,
offset: u64,
count: u32,
owner: &str,
) -> Result<Vec<u8>, String>
pub fn read( &self, fid: u32, offset: u64, count: u32, owner: &str, ) -> Result<Vec<u8>, String>
Read from an opened fid.
For Static resolved nodes, the DashMap guard is dropped before calling the content-generation closure to avoid holding shard locks during I/O. For Dynamic nodes (captured closures), the guard is held — closures MUST be non-blocking (in-memory operations only).
Sourcepub fn readdir_entries(
&self,
fid: u32,
owner: &str,
) -> Result<Vec<DirEntry>, String>
pub fn readdir_entries( &self, fid: u32, owner: &str, ) -> Result<Vec<DirEntry>, String>
Read directory entries as structured data (for Mount bridge).
Sourcepub fn write(
&self,
fid: u32,
_offset: u64,
data: &[u8],
owner: &str,
subject: &Subject,
) -> Result<u32, String>
pub fn write( &self, fid: u32, _offset: u64, data: &[u8], owner: &str, subject: &Subject, ) -> Result<u32, String>
Write to an opened fid.
For ctl files, the handler closure is invoked and the response is buffered for subsequent reads. Response buffer is capped at MAX_RESPONSE_BUF.
Trait Implementations§
Source§impl Mount for SyntheticTree
impl Mount for SyntheticTree
Source§fn walk<'life0, 'life1, 'life2, 'life3, 'async_trait>(
&'life0 self,
components: &'life1 [&'life2 str],
caller: &'life3 Subject,
) -> Pin<Box<dyn Future<Output = Result<Fid, MountError>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
fn walk<'life0, 'life1, 'life2, 'life3, 'async_trait>(
&'life0 self,
components: &'life1 [&'life2 str],
caller: &'life3 Subject,
) -> Pin<Box<dyn Future<Output = Result<Fid, MountError>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
Source§fn open<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
fid: &'life1 mut Fid,
mode: u8,
caller: &'life2 Subject,
) -> Pin<Box<dyn Future<Output = Result<(), MountError>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn open<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
fid: &'life1 mut Fid,
mode: u8,
caller: &'life2 Subject,
) -> Pin<Box<dyn Future<Output = Result<(), MountError>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
mode: OREAD=0, OWRITE=1, ORDWR=2.Source§fn read<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
fid: &'life1 Fid,
offset: u64,
count: u32,
caller: &'life2 Subject,
) -> Pin<Box<dyn Future<Output = Result<Vec<u8>, MountError>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn read<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
fid: &'life1 Fid,
offset: u64,
count: u32,
caller: &'life2 Subject,
) -> Pin<Box<dyn Future<Output = Result<Vec<u8>, MountError>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Source§fn write<'life0, 'life1, 'life2, 'life3, 'async_trait>(
&'life0 self,
fid: &'life1 Fid,
offset: u64,
data: &'life2 [u8],
caller: &'life3 Subject,
) -> Pin<Box<dyn Future<Output = Result<u32, MountError>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
fn write<'life0, 'life1, 'life2, 'life3, 'async_trait>(
&'life0 self,
fid: &'life1 Fid,
offset: u64,
data: &'life2 [u8],
caller: &'life3 Subject,
) -> Pin<Box<dyn Future<Output = Result<u32, MountError>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
Source§fn readdir<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
fid: &'life1 Fid,
caller: &'life2 Subject,
) -> Pin<Box<dyn Future<Output = Result<Vec<DirEntry>, MountError>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn readdir<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
fid: &'life1 Fid,
caller: &'life2 Subject,
) -> Pin<Box<dyn Future<Output = Result<Vec<DirEntry>, MountError>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Source§fn stat<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
fid: &'life1 Fid,
caller: &'life2 Subject,
) -> Pin<Box<dyn Future<Output = Result<Stat, MountError>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
fn stat<'life0, 'life1, 'life2, 'async_trait>(
&'life0 self,
fid: &'life1 Fid,
caller: &'life2 Subject,
) -> Pin<Box<dyn Future<Output = Result<Stat, MountError>> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
Source§fn clunk<'life0, 'life1, 'async_trait>(
&'life0 self,
fid: Fid,
caller: &'life1 Subject,
) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
fn clunk<'life0, 'life1, 'async_trait>(
&'life0 self,
fid: Fid,
caller: &'life1 Subject,
) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>where
Self: 'async_trait,
'life0: 'async_trait,
'life1: 'async_trait,
Source§fn create<'life0, 'life1, 'life2, 'life3, 'async_trait>(
&'life0 self,
_fid: &'life1 mut Fid,
_name: &'life2 str,
_perm: u32,
_mode: u8,
_caller: &'life3 Subject,
) -> Pin<Box<dyn Future<Output = Result<Stat, MountError>> + Send + 'async_trait>>where
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
Self: 'async_trait,
fn create<'life0, 'life1, 'life2, 'life3, 'async_trait>(
&'life0 self,
_fid: &'life1 mut Fid,
_name: &'life2 str,
_perm: u32,
_mode: u8,
_caller: &'life3 Subject,
) -> Pin<Box<dyn Future<Output = Result<Stat, MountError>> + Send + 'async_trait>>where
'life0: 'async_trait,
'life1: 'async_trait,
'life2: 'async_trait,
'life3: 'async_trait,
Self: 'async_trait,
Tcreate). Read moreAuto Trait Implementations§
impl !Freeze for SyntheticTree
impl !RefUnwindSafe for SyntheticTree
impl Send for SyntheticTree
impl Sync for SyntheticTree
impl Unpin for SyntheticTree
impl UnsafeUnpin for SyntheticTree
impl !UnwindSafe for SyntheticTree
Blanket Implementations§
§impl<T> AnySync for T
impl<T> AnySync for T
§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> FutureExt for T
impl<T> FutureExt for T
§fn with_context(self, otel_cx: Context) -> WithContext<Self>
fn with_context(self, otel_cx: Context) -> WithContext<Self>
§fn with_current_context(self) -> WithContext<Self>
fn with_current_context(self) -> WithContext<Self>
§impl<T> Identity for Twhere
T: ?Sized,
impl<T> Identity for Twhere
T: ?Sized,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> IntoRequest<T> for T
impl<T> IntoRequest<T> for T
Source§fn into_request(self) -> Request<T>
fn into_request(self) -> Request<T>
T in a tonic::Request