Struct fs_mistrust::MistrustBuilder

pub struct MistrustBuilder { /* private fields */ }

Builder for Mistrust.

Implementations

impl MistrustBuilder

pub fn ignore_prefix<VALUE: Into<PathBuf>>(&mut self, value: VALUE) -> &mut Self

If the user called MistrustBuilder::ignore_prefix, what did they give us?

(This is stored in canonical form.)

pub fn trust_user<VALUE: Into<TrustedUser>>(
    &mut self,
    value: VALUE
) -> &mut Self

What user ID do we trust by default (if any?)

pub fn trust_group<VALUE: Into<TrustedGroup>>(
    &mut self,
    value: VALUE
) -> &mut Self

What group ID do we trust by default (if any?)

pub fn build(&self) -> Result<Mistrust, Error>

Builds a new Mistrust.

Errors

If a required field has not been initialized.

impl MistrustBuilder

pub fn trust_admin_only(&mut self) -> &mut Self

Configure this Mistrust to trust only the admin (root) user.

By default, both the currently running user and the root user will be trusted.

This option disables the default group-trust behavior as well.

pub fn trust_no_group_id(&mut self) -> &mut Self

Configure this Mistrust to trust no groups at all.

By default, we trust the group (if any) with the same name as the current user if we are currently running as a member of that group.

With this option set, no group is trusted, and and any group-readable or group-writable objects are treated the same as world-readable and world-writable objects respectively.

pub fn dangerously_trust_everyone(&mut self) -> &mut Self

Configure this Mistrust to trust every user and every group.

With this option set, every file and directory is treated as having valid permissions: even world-writeable files are allowed. File-type checks are still performed.

This option is mainly useful to handle cases where you want to make these checks optional, and still use CheckedDir without having to implement separate code paths for the “checking on” and “checking off” cases.

pub fn remove_ignored_prefix(&mut self) -> &mut Self

Remove any ignored prefix, restoring this MistrustBuilder to a state as if MistrustBuilder::ignore_prefix had not been called.

Trait Implementations

impl Clone for MistrustBuilder

fn clone(&self) -> MistrustBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MistrustBuilder

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

Formats the value using the given formatter.

impl Default for MistrustBuilder

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MistrustBuilder where
    MistrustBuilder: Default, 

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Serialize for MistrustBuilder

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.