endpoint-sec 0.5.0

High-level Rust wrappers around the Endpoint Security Framework
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

//! Actions associated with a [`Message`][crate::Message].

use endpoint_sec_sys::{es_auth_result_t, es_event_id_t, es_result_t, es_result_type_t};

/// When a [`Message`][crate::Message] is received, it is associated with an `Action`
#[doc(alias = "es_event_id_t")]
#[derive(Debug, Copy, Clone, PartialEq, Eq, Hash)]
pub enum Action {
    /// For `AUTH` events, it is the opaque ID that must be supplied when responding
    Auth(es_event_id_t),
    /// For `NOTIFY` events, describes the result of the action
    Notify(ActionResult),
}

#[cfg(feature = "static_assertions")]
static_assertions::assert_impl_all!(Action: Send);

/// Result of the ES subsystem authorization process.
///
/// See also [`Action`].
#[doc(alias = "es_result_t")]
#[doc(alias = "es_result_type_t")]
#[doc(alias = "es_auth_result_t")]
#[derive(Debug, Copy, Clone, PartialEq, Eq, Hash)]
pub enum ActionResult {
    /// Result of an `AUTH` action
    Auth(es_auth_result_t),
    /// Flags resulting of an action
    Flags(u32),
}

impl ActionResult {
    /// Build [`Self`] from the raw result
    pub(crate) fn from_raw(r: es_result_t) -> Option<Self> {
        match r.result_type {
            // Safety: we just checked the `result_type` member
            es_result_type_t::ES_RESULT_TYPE_AUTH => Some(Self::Auth(unsafe { r.result.auth })),
            // Safety: we just checked the `result_type` member
            es_result_type_t::ES_RESULT_TYPE_FLAGS => Some(Self::Flags(unsafe { r.result.flags })),
            _ => None,
        }
    }
}

#[cfg(feature = "static_assertions")]
static_assertions::assert_impl_all!(ActionResult: Send);