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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
//! Capability guards for the native host.
//!
//! Absorbed from `surfaces/native-host/Sources/CanvasProtocol/
//! CapabilityGuard.swift` (kernel#850 row 15). Mirrors the kernel's
//! capability sets over the absorbed [`crate::canvas_protocol::Capability`].
use Error;
use crateCapability;
/// True for capabilities only the ML layer may hold.
///
/// # Examples
///
/// ```
/// use drishti::canvas_protocol::Capability;
/// use drishti::native_host::capability::is_ml_only;
///
/// assert!(is_ml_only(&Capability::TapeRead));
/// // The command bar may hold intent.emit, so it is not ML-only.
/// assert!(!is_ml_only(&Capability::IntentEmit));
/// ```
pub const
/// True for capabilities requiring elevated trust (command bar or ML only).
///
/// # Examples
///
/// ```
/// use drishti::canvas_protocol::Capability;
/// use drishti::native_host::capability::is_privileged;
///
/// assert!(is_privileged(&Capability::IntentEmit));
/// assert!(!is_privileged(&Capability::SignalEmit));
/// ```
pub const
/// Capability assertion failure.
///
/// # Examples
///
/// ```
/// use drishti::canvas_protocol::Capability;
/// use drishti::native_host::capability::{CapabilityError, assert_capability};
///
/// assert_eq!(
/// assert_capability(&[], Capability::TapeRead),
/// Err(CapabilityError::NotGranted(Capability::TapeRead))
/// );
/// ```
/// Succeeds when `need` is in `have`; fails with the missing capability
/// otherwise.
///
/// # Examples
///
/// ```
/// use drishti::canvas_protocol::Capability;
/// use drishti::native_host::capability::assert_capability;
///
/// let granted = [Capability::SignalEmit];
/// assert!(assert_capability(&granted, Capability::SignalEmit).is_ok());
/// assert!(assert_capability(&granted, Capability::SignalSubscribe).is_err());
/// ```