s2n-quic-dc 0.77.0

Internal crate used by s2n-quic
Documentation
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0

use super::tag::Common;
use core::fmt;
use zerocopy::{FromBytes, Unaligned};

pub mod decoder;
pub mod encoder;

#[derive(Clone, Copy, PartialEq, Eq, FromBytes, Unaligned)]
#[repr(C)]
pub struct Tag(Common);

impl_tag_codec!(Tag);

impl Default for Tag {
    #[inline]
    fn default() -> Self {
        Self(Common(0b0101_0000))
    }
}

impl fmt::Debug for Tag {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        f.debug_struct("control::Tag")
            .field("has_source_queue_id", &self.has_source_queue_id())
            .field("is_stream", &self.is_stream())
            .field("has_application_header", &self.has_application_header())
            .finish()
    }
}

impl Tag {
    pub const HAS_SOURCE_QUEUE_ID: u8 = 0b1000;
    pub const IS_STREAM_MASK: u8 = 0b0100;
    pub const HAS_APPLICATION_HEADER_MASK: u8 = 0b0010;

    pub const MIN: u8 = 0b0101_0000;
    pub const MAX: u8 = 0b0101_1111;

    #[inline]
    pub fn set_has_source_queue_id(&mut self, enabled: bool) {
        self.0.set(Self::HAS_SOURCE_QUEUE_ID, enabled)
    }

    #[inline]
    pub fn has_source_queue_id(&self) -> bool {
        self.0.get(Self::HAS_SOURCE_QUEUE_ID)
    }

    #[inline]
    pub fn set_is_stream(&mut self, enabled: bool) {
        self.0.set(Self::IS_STREAM_MASK, enabled)
    }

    #[inline]
    pub fn is_stream(&self) -> bool {
        self.0.get(Self::IS_STREAM_MASK)
    }

    #[inline]
    pub fn set_has_application_header(&mut self, enabled: bool) {
        self.0.set(Self::HAS_APPLICATION_HEADER_MASK, enabled)
    }

    #[inline]
    pub fn has_application_header(&self) -> bool {
        self.0.get(Self::HAS_APPLICATION_HEADER_MASK)
    }

    #[inline]
    fn validate(&self) -> Result<(), s2n_codec::DecoderError> {
        let range = Self::MIN..=Self::MAX;
        s2n_codec::decoder_invariant!(range.contains(&(self.0).0), "invalid control bit pattern");
        Ok(())
    }
}