push-packet 0.1.0

Packet-inspection and routing library for Linux, built on eBPF XDP and AF_XDP with aya.
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

/// An action to take on matching rules.
#[non_exhaustive]
#[derive(Clone, Copy)]
pub enum Action {
    /// Instructs the kernel to do nothing, and should be used to override other rules.
    Pass,
    /// Drops the packet.
    Drop,
    /// Copies the packet to userspace, but it is processed as normal by the kernel. The `take`
    /// field optionally limits the copied data to a certain number of bytes.
    Copy {
        /// Maximum bytes to copy from each packet. `None` copies the entire packet.
        take: Option<u32>,
    },
    /// Routes the packet to userspace.
    Route,
}

impl Action {
    /// Convenience constant to copy the entire packet
    pub const COPY_ALL: Action = Action::Copy { take: None };

    pub(crate) fn into_common_action(self) -> (push_packet_common::Action, Option<u32>) {
        match self {
            Self::Pass => (push_packet_common::Action::Pass, None),
            Self::Drop => (push_packet_common::Action::Drop, None),
            Self::Copy { take } => (push_packet_common::Action::Copy, take),
            Self::Route => (push_packet_common::Action::Route, None),
        }
    }
}