Struct PacketFlags 

pub struct PacketFlags(pub u16);

Available on crate feature std only.

Packet flags bitfield (16-bit).

Tuple Fields

0: u16

Implementations

impl PacketFlags

pub const RELIABLE: u16 = 0x0001

Requires acknowledgment

pub const ACK: u16 = 0x0002

This is an ACK packet

pub const FIN: u16 = 0x0004

Stream finished

pub const UNRELIABLE: u16 = 0x0008

Fire-and-forget (no retransmission)

pub const PRIORITY: u16 = 0x0010

High priority (voice, video frames)

pub const ENCRYPTED: u16 = 0x0020

Payload is encrypted

pub const COMPRESSED: u16 = 0x0040

Payload is compressed

pub const CONTROL: u16 = 0x0080

Control message (handshake, migration)

pub const REKEY: u16 = 0x0100

Sender is rekeying — receiver must derive the next AEAD key from the traffic-secret rekey chain (HKDF-Expand(current, "phantom-rekey-v1", 32), Invariant 5) before decrypting this packet (Phase 1.5).

pub const PATH_VALIDATION: u16 = 0x0200

Path-validation challenge / response packet for multi-path migration (Phase 4.2). Payload carries the 32-byte challenge or response.

pub const COALESCED: u16 = 0x0400

Payload is a coalesced bundle of inner packets in [count: u16][len1: u16][payload1]... format (Phase 2.5).

pub const WINDOW_UPDATE: u16 = 0x0800

Per-stream flow control update (Phase 4.3). Payload is a big-endian u32 carrying the receiver’s newly-available window in bytes (absolute window size, NOT a delta — simpler and self-correcting under packet loss).

pub const KEEPALIVE: u16 = 0x1000

Idle keep-alive PING (Direction #3 — download-only liveness). A small ENCRYPTED | KEEPALIVE packet with an empty payload that an idle sender emits to (a) refresh the peer’s inbound-activity timer and (b) anchor its own liveness timer (the in-flight keep-alive lets a download-only path — which otherwise sends only ACKs and has nothing in flight — detect a silently-dead downstream). A bare KEEPALIVE is a PING; KEEPALIVE | ACK is the peer’s PONG echo. Neither carries application bytes, so neither reaches recv(). (Spare flag bit — no header layout / WIRE_VERSION change.)

pub const PADDED: u16 = 0x2000

Anti-fingerprint size padding present (WIRE v6, deliverable (c)). When set, the AEAD plaintext ends with a trailer ‹pad_n zero bytes› ‖ pad_n:u16be that the receiver strips after decrypt (see crate::transport::shaping). The flag rides inside the HP-masked header, so it is invisible on the wire; the padding itself is encrypted + authenticated, so only the bucketed datagram size is observable. (Spare flag bit — no header layout change.)

pub const COVER: u16 = 0x4000

Anti-fingerprint cover (dummy) traffic (WIRE v6, deliverable (e)). An ENCRYPTED | COVER packet carries no application data (empty inner plaintext, typically PADDED to a bucket); its sole purpose is to normalize the outbound traffic pattern (idle-fill + a floor packet rate) so silence and volume no longer leak. It AEAD-authenticates like any packet (so it refreshes the peer’s liveness and cannot be off-path injected); the receiver drops it before the data path, so it never reaches recv(). (Spare flag bit — no header layout / WIRE_VERSION change.)

pub const fn empty() -> Self

Create new flags with no bits set

pub const fn new(bits: u16) -> Self

Create flags with specific bits

pub const fn contains(&self, flag: u16) -> bool

Check if flag is set

pub fn set(&mut self, flag: u16)

Set a flag

pub fn clear(&mut self, flag: u16)

Clear a flag

pub const fn is_reliable(&self) -> bool

Check if reliable delivery is required

pub const fn is_ack(&self) -> bool

Check if this is an ACK packet

pub const fn is_fin(&self) -> bool

Check if stream is finished

pub const fn is_control(&self) -> bool

Check if this is a control packet

pub const fn is_rekey(&self) -> bool

Check if this is a rekey packet

Trait Implementations

impl Clone for PacketFlags

fn clone(&self) -> PacketFlags

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for PacketFlags

impl Debug for PacketFlags

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PacketFlags

fn default() -> PacketFlags

Returns the “default value” for a type.

impl Eq for PacketFlags

impl PartialEq for PacketFlags

fn eq(&self, other: &PacketFlags) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PacketFlags