Struct ConnectionCredentials

pub struct ConnectionCredentials {
    pub unix_user_id: Option<u32>,
    pub unix_group_ids: Option<Vec<u32>>,
    pub process_id: Option<u32>,
    pub windows_sid: Option<String>,
    pub linux_security_label: Option<Vec<u8>>,
}

Credentials of a process connected to a bus server.

If unable to determine certain credentials (for instance, because the process is not on the same machine as the bus daemon, or because this version of the bus daemon does not support a particular security framework), or if the values of those credentials cannot be represented as documented here, then those credentials are omitted.

Note: unknown keys, in particular those with “.” that are not from the specification, will be ignored. Use your own implementation or contribute your keys here, or in the specification.

Fields

unix_user_id: Option<u32>

👎Deprecated since 3.13.0: Use unix_user_id method

unix_group_ids: Option<Vec<u32>>

👎Deprecated since 3.13.0: Use unix_group_ids method

process_id: Option<u32>

👎Deprecated since 3.13.0: Use process_id method

windows_sid: Option<String>

👎Deprecated since 3.13.0: Use windows_sid method

linux_security_label: Option<Vec<u8>>

👎Deprecated since 3.13.0: Use linux_security_label method

Implementations

impl ConnectionCredentials

pub fn unix_user_id(&self) -> Option<u32>

The numeric Unix user ID, as defined by POSIX.

pub fn unix_group_ids(&self) -> Option<&Vec<u32>>

The numeric Unix group IDs (including both the primary group and the supplementary groups), as defined by POSIX, in numerically sorted order. This array is either complete or absent: if the message bus is able to determine some but not all of the caller’s groups, or if one of the groups is not representable in a UINT32, it must not add this credential to the dictionary.

pub fn into_unix_group_ids(self) -> Option<Vec<u32>>

Same as ConnectionCredentials::unix_group_ids, but consumes self and returns the group IDs Vec.

pub fn process_id(&self) -> Option<u32>

The numeric process ID, on platforms that have this concept. On Unix, this is the process ID defined by POSIX.

pub fn windows_sid(&self) -> Option<&String>

The Windows security identifier in its string form, e.g. S-1-5-21-3623811015-3361044348-30300820-1013 for a domain or local computer user or “S-1-5-18` for the LOCAL_SYSTEM user.

pub fn into_windows_sid(self) -> Option<String>

Same as ConnectionCredentials::windows_sid, but consumes self and returns the SID string.

pub fn linux_security_label(&self) -> Option<&Vec<u8>>

On Linux systems, the security label that would result from the SO_PEERSEC getsockopt call. The array contains the non-zero bytes of the security label in an unspecified ASCII-compatible encoding, followed by a single zero byte.

For example, the SELinux context system_u:system_r:init_t:s0 (a string of length 27) would be encoded as 28 bytes ending with ':', 's', '0', '\x00'

On SELinux systems this is the SELinux context, as output by ps -Z or ls -Z. Typical values might include system_u:system_r:init_t:s0, unconfined_u:unconfined_r:unconfined_t:s0-s0:c0.c1023, or unconfined_u:unconfined_r:chrome_sandbox_t:s0-s0:c0.c1023.

On Smack systems, this is the Smack label. Typical values might include _, *, User, System or System::Shared.

On AppArmor systems, this is the AppArmor context, a composite string encoding the AppArmor label (one or more profiles) and the enforcement mode. Typical values might include unconfined, /usr/bin/firefox (enforce) or user1 (complain).

pub fn into_linux_security_label(self) -> Option<Vec<u8>>

Same as ConnectionCredentials::linux_security_label, but consumes self and returns the security label bytes.

pub fn set_unix_user_id(self, unix_user_id: u32) -> Self

Set the numeric Unix user ID, as defined by POSIX.

pub fn add_unix_group_id(self, unix_group_id: u32) -> Self

Add a numeric Unix group ID.

See ConnectionCredentials::unix_group_ids for more information.

pub fn set_process_id(self, process_id: u32) -> Self

Set the numeric process ID, on platforms that have this concept.

See ConnectionCredentials::process_id for more information.

pub fn set_windows_sid(self, windows_sid: String) -> Self

Set the Windows security identifier in its string form.

pub fn set_linux_security_label(self, linux_security_label: Vec<u8>) -> Self

Set the Linux security label.

See ConnectionCredentials::linux_security_label for more information.

Trait Implementations

impl Debug for ConnectionCredentials

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

Formats the value using the given formatter.

impl Default for ConnectionCredentials

fn default() -> ConnectionCredentials

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ConnectionCredentials

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ConnectionCredentials

fn eq(&self, other: &ConnectionCredentials) -> 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 ConnectionCredentials

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Type for ConnectionCredentials

fn signature() -> Signature<'static>

Get the signature for the implementing type.

impl Eq for ConnectionCredentials

impl StructuralPartialEq for ConnectionCredentials