Enum TrustedUser

#[non_exhaustive]
pub enum TrustedUser {
    None,
    Current,
    Id(u32),
    Name(OsString),
}

Available on target_family="unix" and non-iOS and non-Android and non-tvOS only.

A user that we can be configured to trust.

Serde support

If this crate is build with the serde1 feature enabled, you can serialize and deserialize this type from any of the following:

• false and the string ":none" correspond to TrustedUser::None.
• The string ":current" and the map { special = ":current" } correspond to TrustedUser::Current.
• A numeric value (e.g., 413) and the map { id = 413 } correspond to TrustedUser::Id(413).
• A string not starting with : (e.g., “jane”) and the map { name = "jane" } correspond to TrustedUser::Name("jane".into()).

Limitations

Non-UTF8 usernames cannot currently be represented in all serde formats. Notably, toml doesn’t support them.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

None

We won’t treat any user as trusted.

Current

Treat the current user as trusted.

Id(u32)

Treat the user with a particular UID as trusted.

Name(OsString)

Treat a user with a particular name as trusted.

If there is no such user, we’ll report an error.

Implementations

impl TrustedUser

fn from_special_str(s: &str) -> Result<Self, Error>

Available on crate feature serde only.

Try to decode a “special-user” string from s, for serde.

fn from_boolean(b: bool) -> Result<Self, Error>

Available on crate feature serde only.

impl TrustedUser

pub(crate) fn get_uid(&self) -> Result<Option<u32>, Error>

Try to convert this User into an optional UID.

fn get_uid_impl<U: PwdGrpProvider>( &self, userdb: &U, ) -> Result<Option<u32>, Error>

As get_uid, but take a userdb.

Trait Implementations

impl Clone for TrustedUser

fn clone(&self) -> TrustedUser

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TrustedUser

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

Formats the value using the given formatter.

impl Default for TrustedUser

fn default() -> TrustedUser

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TrustedUser

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&OsStr> for TrustedUser

fn from(val: &OsStr) -> Self

Converts to this type from the input type.

impl From<&str> for TrustedUser

fn from(val: &str) -> Self

Converts to this type from the input type.

impl From<OsString> for TrustedUser

fn from(val: OsString) -> Self

Converts to this type from the input type.

impl From<String> for TrustedUser

fn from(val: String) -> Self

Converts to this type from the input type.

impl From<TrustedUser> for Serde

Available on crate feature serde only.

fn from(value: TrustedUser) -> Self

Converts to this type from the input type.

impl From<u32> for TrustedUser

fn from(val: u32) -> Self

Converts to this type from the input type.

impl Hash for TrustedUser

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TrustedUser

fn eq(&self, other: &TrustedUser) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for TrustedUser

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<Serde> for TrustedUser

Available on crate feature serde only.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(ent: Serde) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for TrustedUser

impl StructuralPartialEq for TrustedUser