Struct Dict 

pub struct Dict { /* private fields */ }

A capability that represents a dictionary of capabilities.

Implementations

impl Dict

pub fn new() -> Self

Creates an empty dictionary.

pub fn new_with_not_found( not_found: impl Fn(&str) + 'static + Send + Sync, ) -> Self

Creates an empty dictionary. When an external request tries to access a non-existent entry, the name of the entry will be sent using not_found.

pub fn register_update_notifier(&self, notifier_fn: UpdateNotifierFn)

Registers a new update notifier function with this dictionary. The function will be called whenever an entry is added to or removed from this dictionary. The function will be immediately called with an EntryUpdate::Add value for any entries already in this dictionary.

Note that this function will be called while the internal dictionary structure is locked, so it must not interact with the dictionary on which it is registered. It shouldn’t even hold a strong reference to the dictionary it’s registered on, as that’ll create a cycle and make LSAN sad.

pub fn insert( &self, key: Key, capability: Capability, ) -> Result<(), CapabilityStoreError>

Inserts an entry, mapping key to capability. If an entry already exists at key, a fsandbox::DictionaryError::AlreadyExists will be returned.

pub fn append(&self, other: &Dict) -> Result<(), ()>

pub fn get<Q>(&self, key: &Q) -> Result<Option<Capability>, ()>

where Key: Borrow<Q> + Ord, Q: Ord + ?Sized,

Returns a clone of the capability associated with key. If there is no entry for key, None is returned.

If the value could not be cloned, returns an error.

pub fn get_or_insert( &self, key: &Key, default: impl FnOnce() -> Capability, ) -> Result<Capability, ()>

Returns a clone of the capability associated with key, or populates it with default if it is not present.

If the value could not be cloned, returns an error.

pub fn remove(&self, key: &BorrowedName) -> Option<Capability>

Removes key from the entries, returning the capability at key if the key was already in the entries.

pub fn enumerate( &self, ) -> impl Iterator<Item = (Key, Result<Capability, ()>)> + use<>

Returns an iterator over a clone of the entries, sorted by key.

If a capability is not cloneable, an error returned for the value.

pub fn keys(&self) -> impl Iterator<Item = Key> + use<>

Returns an iterator over the keys, in sorted order.

pub fn drain(&self) -> impl Iterator<Item = (Key, Capability)> + use<>

Removes all entries from the Dict and returns them as an iterator.

pub fn shallow_copy(&self) -> Result<Self, ()>

Creates a new Dict with entries cloned from this Dict.

This is a shallow copy. Values are cloned, not copied, so are new references to the same underlying data.

If any value in the dictionary could not be cloned, returns an error.

impl Dict

pub fn try_into_directory_entry_oneshot( self, scope: ExecutionScope, ) -> Result<Arc<dyn DirectoryEntry>, ConversionError>

Like RemotableCapability::try_into_directory_entry, but this version actually consumes the contents of the Dict. In other words, if this function returns Ok, self will be empty. If any items are added to self later, they will not appear in the directory. This method is useful when the caller has no need to keep the original Dict. Note that even if there is only one reference to the Dict, calling RemotableCapability::try_into_directory_entry does not have the same effect because the vfs keeps alive reference to the Dict – see the comment in the implementation.

This is transitive: any Dicts nested in this one will be consumed as well.

Trait Implementations

impl CapabilityBound for Dict

fn debug_typename() -> &'static str

impl Clone for Dict

fn clone(&self) -> Dict

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Dict

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Dict

fn default() -> Self

Returns the “default value” for a type.

impl From<Dict> for Capability

fn from(f: Dict) -> Self

Converts to this type from the input type.

impl From<Dict> for Capability

fn from(dict: Dict) -> Self

Converts to this type from the input type.

impl From<Dict> for DictionaryRef

fn from(dict: Dict) -> Self

Converts to this type from the input type.

impl FromEnum<Capability> for Dict

fn from_enum(e: &Capability) -> Option<&Self>

impl RemotableCapability for Dict

fn try_into_directory_entry( self, scope: ExecutionScope, ) -> Result<Arc<dyn DirectoryEntry>, ConversionError>

Attempt to convert self to a DirectoryEntry which can be served in a VFS.

impl TryFrom<Capability> for Dict

type Error = ()

The type returned in the event of a conversion error.

fn try_from(c: Capability) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Channel> for Dict

type Error = RemoteError

The type returned in the event of a conversion error.

fn try_from(dict: Channel) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<DictionaryRef> for Dict

type Error = RemoteError

The type returned in the event of a conversion error.

fn try_from(dict: DictionaryRef) -> Result<Self, Self::Error>

Performs the conversion.