dure 0.2.4

Detachable Windows console sessions that outlive the terminal
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

//! Opaque PAL handles used by logic.
//!
//! A handle names something a PAL implementation created and still owns. The
//! integer inside is that implementation's bookkeeping, so it is visible only
//! within the PAL: code above it holds handles, and cannot invent one that no
//! implementation ever issued.

/// Listener for incoming client connections.
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
pub(crate) struct ListenerId(pub(in crate::pal) u64);

/// One connected client or startup channel.
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
pub(crate) struct ConnId(pub(in crate::pal) u64);

/// App-lifetime job object.
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
pub(crate) struct JobId(pub(in crate::pal) u64);

/// Supervisor-owned pseudoconsole.
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
pub(crate) struct PtyId(pub(in crate::pal) u64);

/// Spawned app process waitable.
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
pub(crate) struct AppId(pub(in crate::pal) u64);

/// One outstanding takeover of the local console for a relay.
///
/// Names the console state that takeover replaced, so handing the console back
/// undoes exactly what was taken and nothing a later takeover owns.
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
pub(crate) struct RelayLeaseId(pub(in crate::pal) u64);

// A stand-in PAL written inside a test module issues handles the same way a real
// implementation does, so it needs the same minting operation. Nothing else may
// invent a handle: a value that no implementation issued names nothing.
#[cfg(test)]
macro_rules! test_minted {
    ($($t:ty),+ $(,)?) => {
        $(
            impl $t {
                /// Mints a handle for a PAL stand-in written in a test module.
                pub(crate) const fn for_test(value: u64) -> Self {
                    Self(value)
                }
            }
        )+
    };
}

#[cfg(test)]
test_minted!(ConnId, JobId, AppId, RelayLeaseId);