Enum uds::ConnCredentials
source · pub enum ConnCredentials {
LinuxLike {
pid: NonZeroU32,
euid: u32,
egid: u32,
},
MacOsLike {
euid: u32,
number_of_groups: u8,
groups: [u32; 16],
},
}
Expand description
Credentials of the peer process when it called connect()
, accept()
or pair()
.
User and group IDs can be misleading if the peer side of the socket
has been transfered to another process or the peer has changed privileges.
PID is almost impossible to use correctly, as the peer might have
terminated and the pid reused, or as for euid, the socket has been sent
to another process (via fd-passing or forking).
What information is received varies from OS to OS:
- Linux, OpenBSD and NetBSD provides process ID, effective user ID and effective group id.
- macOS, FreeBSD and DragonFly BSD provides effective user ID and group memberships. (The first group is also the effective group ID.) FreeBSD 13+ will also provide process ID.
- Illumos and Solaris provide more than one could possibly want
(the
LinuxLike
variant is most likely returned).
Current limitations of this crate:
- Illumos and Solaris provides enough information to fill out both variants, but obviously only one can be returned.
- FreeBSD 13 will also provide pid, but this crate doesn’t detect that.
Variants§
Implementations§
source§impl ConnCredentials
impl ConnCredentials
sourcepub fn pid(&self) -> Option<NonZeroU32>
pub fn pid(&self) -> Option<NonZeroU32>
Get the process ID of the initial peer of a connection.
This is currently only available on Linux & Android, but will in the future also be available on OpenBSD and NetBSD, and possibly also FreeBSD and Solaris.
sourcepub fn euid(&self) -> u32
pub fn euid(&self) -> u32
Get the effective user ID of the initial peer of a connection.
This is provided by any supported OS.
sourcepub fn egid(&self) -> Option<u32>
pub fn egid(&self) -> Option<u32>
Get the effective group ID of the initial peer of a connection.
- On Linux, Android, OpenBSD and NetBSD,
egid
from theLinuxLike
variant is returned. - On FreeBSD, DragonFly BSD, macOS & other Apple platforms,
groups[0]
from theMacOsLike
variant is returned (except in the unlikely case thatnumber_of_groups
is zero).
Trait Implementations§
source§impl Clone for ConnCredentials
impl Clone for ConnCredentials
source§fn clone(&self) -> ConnCredentials
fn clone(&self) -> ConnCredentials
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for ConnCredentials
impl Debug for ConnCredentials
source§impl PartialEq for ConnCredentials
impl PartialEq for ConnCredentials
source§fn eq(&self, other: &ConnCredentials) -> bool
fn eq(&self, other: &ConnCredentials) -> bool
self
and other
values to be equal, and is used
by ==
.