Merge pull request #1301 from GyulyVGC/igmp

Add support for IGMP

Author: GyulyVGC

CHANGELOG.md

@@ -4,6 +4,7 @@ All Sniffnet releases with the relative changes are documented in this file.
 
 ## [UNRELEASED]
 - IPFIX collector capabilities: receive and analyze network traffic from remote devices ([#1270](https://github.com/GyulyVGC/sniffnet/pull/1270) — fixes [#303](https://github.com/GyulyVGC/sniffnet/issues/303))
+- Added support for IGMP connections and messages ([#1301](https://github.com/GyulyVGC/sniffnet/pull/1301) — fixes [#1269](https://github.com/GyulyVGC/sniffnet/issues/1269))
 - Show output file path in Overview page when exporting a PCAP file ([`3f2c42c`](https://github.com/GyulyVGC/sniffnet/pull/1290/commits/3f2c42c70f06d5d29ddad80dde956281c6705511))
 - Fix the app freezing and exhausting memory when importing a PCAP file containing a large time gap between consecutive packets ([`4605ec7`](https://github.com/GyulyVGC/sniffnet/pull/1290/commits/4605ec717bbaf8fa34268805814d5585f084201e))
 - Restrict the PCAP export file to have a valid PCAP extension, so that files of other types can't be overwritten ([`5b4801b`](https://github.com/GyulyVGC/sniffnet/pull/1290/commits/5b4801b438ff1c7968cfac423a8e8585778309a8))

CONTRIBUTING.md

@@ -8,10 +8,11 @@ For this reason, you're encouraged to read the following points before submittin
 4. reuse existing code and libraries where possible, and keep your PR small and focused, prioritizing quality over quantity
 5. if you end up adding a UI-facing sentence, make sure to internationalize it by adding a method to the `src/translations` module with the corresponding English translation (only add other languages if you natively speak them)
 6. if you end up modifying the `Sniffer` struct, include the new field in the `Conf` struct if it has to be persisted across runs of the app, or else consider cleaning it up in `Sniffer::reset()` if it has to be reset at every capture session
-7. include unit tests to assert the implementation is sound (if applicable), and make sure that `cargo test`, `cargo clippy -- -D warnings`, and `cargo fmt --all -- --check` all pass
-8. be sure to update the `CHANGELOG.md` file `[UNRELEASED]` section with a one-line description of the change, including a link to the corresponding PR and issue if applicable (following the format of the existing entries)
-9. be mindful that reviewing the PR may take a while, especially if it introduces substantial changes
-10. be mindful that the contribution can still be rejected at our discretion (even if it satisfies all the points above) if it doesn't align with the project's vision or if it introduces unnecessary complexity
+7. if you end up modifying or creating a library in the `lib` folder, make sure to bump its version, update its own `CHANGELOG.md`, and update `Cargo.toml`'s dependencies and workspace members accordingly
+8. include unit tests to assert the implementation is sound (if applicable), and make sure that `cargo test`, `cargo clippy -- -D warnings`, and `cargo fmt --all -- --check` all pass
+9. be sure to update the `CHANGELOG.md` file `[UNRELEASED]` section with a one-line description of the change, including a link to the corresponding PR and issue if applicable (following the format of the existing entries)
+10. be mindful that reviewing the PR may take a while, especially if it introduces substantial changes
+11. be mindful that the contribution can still be rejected at our discretion (even if it satisfies all the points above) if it doesn't align with the project's vision or if it introduces unnecessary complexity
 
 You can read the [_Build from source_](https://github.com/GyulyVGC/sniffnet/wiki/Build-from-source) Wiki page to learn how to set up the development environment, and the [_Code of Conduct_](https://github.com/GyulyVGC/sniffnet/blob/main/CODE_OF_CONDUCT.md) for the expected behavior in the community.
 

Cargo.lock

@@ -44,7 +44,7 @@ workspace = true
 
 [dependencies]
 
-sniffnet-packet-parser = { path = "lib/sniffnet-packet-parser", version = "0.1.0" }
+sniffnet-packet-parser = { path = "lib/sniffnet-packet-parser", version = "0.2.0" }
 
 pcap.workspace = true
 
@@ -90,7 +90,7 @@ serial_test = { version = "4.0.1", default-features = false }
 
 [build-dependencies]
 
-sniffnet-packet-parser = { path = "lib/sniffnet-packet-parser", version = "0.1.0", default-features = false }
+sniffnet-packet-parser = { path = "lib/sniffnet-packet-parser", version = "0.2.0", default-features = false }
 
 phf_codegen = "0.14.0"
 phf_shared = "0.14.0"

Cargo.toml

@@ -2,5 +2,9 @@
 
 All `sniffnet-packet-parser` releases with the relative changes are documented in this file.
 
+## [UNRELEASED]
+### Added
+- IGMP support ([#1301](https://github.com/GyulyVGC/sniffnet/pull/1301))
+
 ## [0.1.0] - 2026-09-02
 - Initial release of `sniffnet-packet-parser`, the network packet parser for Sniffnet

lib/sniffnet-packet-parser/CHANGELOG.md

@@ -1,6 +1,6 @@
 [package]
 name = "sniffnet-packet-parser"
-version = "0.1.0"
+version = "0.2.0"
 description = "Network packet parser for Sniffnet"
 readme = "README.md"
 keywords = ["network", "packet", "sniffer", "parser", "pcap"]

lib/sniffnet-packet-parser/Cargo.toml

@@ -10,6 +10,7 @@ Powered by [`etherparse`](https://github.com/JulianSchmid/etherparse).
 - `UDP`
 - `ICMPv4`
 - `ICMPv6`
+- `IGMP`
 - `ARP`
 
 ## Supported link types

lib/sniffnet-packet-parser/README.md

@@ -1,3 +1,4 @@
+use crate::igmp_type::IgmpType;
 use crate::link_type::LinkType;
 use crate::{ArpType, IcmpType, Protocol};
 use etherparse::{EtherType, LaxPacketHeaders};
@@ -36,6 +37,8 @@ pub struct TransportInfo {
     pub protocol: Protocol,
     /// ICMP message type, if the packet is an ICMP packet.
     pub icmp_type: Option<IcmpType>,
+    /// IGMP message type, if the packet is an IGMP packet.
+    pub igmp_type: Option<IgmpType>,
 }
 
 #[must_use]

lib/sniffnet-packet-parser/src/headers.rs

@@ -0,0 +1,70 @@
+use std::fmt::{Display, Formatter};
+
+#[derive(Copy, Clone, PartialEq, Eq, Hash, Debug)]
+/// The IGMP message type.
+pub enum IgmpType {
+    MembershipQuery,
+    MembershipReportV1,
+    MembershipReportV2,
+    MembershipReportV3,
+    LeaveGroup,
+    Dvmrp,
+    Pim,
+    CiscoTrace,
+    MulticastTracerouteResponse,
+    MulticastTraceroute,
+    MulticastRouterAdvertisement,
+    MulticastRouterSolicitation,
+    MulticastRouterTermination,
+    Unknown,
+}
+
+impl IgmpType {
+    #[must_use]
+    pub(crate) fn from_etherparse(igmp_type: &etherparse::IgmpType) -> IgmpType {
+        match igmp_type {
+            etherparse::IgmpType::MembershipQuery(_)
+            | etherparse::IgmpType::MembershipQueryWithSources(_) => IgmpType::MembershipQuery,
+            etherparse::IgmpType::MembershipReportV1(_) => IgmpType::MembershipReportV1,
+            etherparse::IgmpType::MembershipReportV2(_) => IgmpType::MembershipReportV2,
+            etherparse::IgmpType::MembershipReportV3(_) => IgmpType::MembershipReportV3,
+            etherparse::IgmpType::LeaveGroup(_) => IgmpType::LeaveGroup,
+            etherparse::IgmpType::Unknown(h) => match h.igmp_type {
+                0x13 => IgmpType::Dvmrp,
+                0x14 => IgmpType::Pim,
+                0x15 => IgmpType::CiscoTrace,
+                0x1e => IgmpType::MulticastTracerouteResponse,
+                0x1f => IgmpType::MulticastTraceroute,
+                0x30 => IgmpType::MulticastRouterAdvertisement,
+                0x31 => IgmpType::MulticastRouterSolicitation,
+                0x32 => IgmpType::MulticastRouterTermination,
+                _ => IgmpType::Unknown,
+            },
+        }
+    }
+}
+
+impl Display for IgmpType {
+    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
+        write!(
+            f,
+            "{}",
+            match self {
+                IgmpType::MembershipQuery => "Membership Query",
+                IgmpType::MembershipReportV1 => "Membership Report v1",
+                IgmpType::MembershipReportV2 => "Membership Report v2",
+                IgmpType::MembershipReportV3 => "Membership Report v3",
+                IgmpType::LeaveGroup => "Leave Group",
+                IgmpType::Dvmrp => "DVMRP",
+                IgmpType::Pim => "PIM v1",
+                IgmpType::CiscoTrace => "Cisco Trace",
+                IgmpType::MulticastTracerouteResponse => "Multicast Traceroute Response",
+                IgmpType::MulticastTraceroute => "Multicast Traceroute",
+                IgmpType::MulticastRouterAdvertisement => "Multicast Router Advertisement",
+                IgmpType::MulticastRouterSolicitation => "Multicast Router Solicitation",
+                IgmpType::MulticastRouterTermination => "Multicast Router Termination",
+                IgmpType::Unknown => "?",
+            }
+        )
+    }
+}

lib/sniffnet-packet-parser/src/igmp_type.rs

@@ -7,6 +7,8 @@ mod headers;
 #[cfg(feature = "full")]
 mod icmp_type;
 #[cfg(feature = "full")]
+mod igmp_type;
+#[cfg(feature = "full")]
 mod link_type;
 #[cfg(feature = "full")]
 mod packet;
@@ -19,6 +21,8 @@ pub use headers::{LinkInfo, NetInfo, TransportInfo};
 #[cfg(feature = "full")]
 pub use icmp_type::{IcmpType, IcmpTypeV4, IcmpTypeV6};
 #[cfg(feature = "full")]
+pub use igmp_type::IgmpType;
+#[cfg(feature = "full")]
 pub use link_type::LinkType;
 #[cfg(feature = "full")]
 pub use packet::ParsedPacket;