yubihsm 0.20.0

Pure Rust client for YubiHSM2 devices with support for HTTP and USB-based access to the device. Supports most HSM functionality including ECDSA, Ed25519, HMAC, and RSA.
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

use super::{SessionError, SessionErrorKind::ProtocolError};

/// Maximum session identifier
pub const MAX_SESSION_ID: SessionId = SessionId(16);

/// Session/Channel IDs
#[derive(Copy, Clone, Debug, Eq, Hash, PartialEq, PartialOrd, Ord)]
pub struct SessionId(u8);

impl SessionId {
    /// Create a new session ID from a byte value
    pub fn from_u8(id: u8) -> Result<Self, SessionError> {
        if id > MAX_SESSION_ID.0 {
            fail!(
                ProtocolError,
                "session ID exceeds the maximum allowed: {} (max {})",
                id,
                MAX_SESSION_ID.0
            );
        }

        Ok(SessionId(id))
    }

    /// Obtain the next session ID
    pub fn succ(self) -> Result<Self, SessionError> {
        Self::from_u8(self.0 + 1)
    }

    /// Obtain session ID as a u8
    pub fn to_u8(self) -> u8 {
        self.0
    }
}