ts_derp 0.4.0

tailscale derp client
Documentation 
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

use ts_keys::DerpServerPublicKey;
use zerocopy::{FromBytes, Immutable, IntoBytes, KnownLayout, Unaligned};

use crate::{
    frame,
    frame::{Body, FrameType},
};

/// Sent from the server to the client as part of the initial handshake to provide the derp
/// server's public key.
#[derive(
    Debug, Copy, Clone, PartialEq, KnownLayout, Immutable, IntoBytes, FromBytes, Unaligned,
)]
#[repr(C, packed)]
pub struct ServerKey {
    /// Magic byte sequence to validate that this is a DERP server behaving as expected.
    ///
    /// Users should call [`ServerKey::validate`] to check that these magic bytes are valid.
    pub magic: frame::Magic,

    /// The server's public key.
    pub key: DerpServerPublicKey,
}

impl ServerKey {
    /// Ensure the magic number for this serverkey is valid.
    pub fn validate(&self) -> Result<(), frame::Error> {
        if !self.magic.is_valid() {
            return Err(frame::Error::InvalidMagic);
        }

        Ok(())
    }
}

impl Body for ServerKey {
    const FRAME_TYPE: FrameType = FrameType::ServerKey;
}