Struct MacAddress 

pub struct MacAddress(pub [u8; 6]);

Represents a Media Access Control (MAC) address.

A MAC address is a unique identifier assigned to a network interface for communications at the data link layer of a network segment.

Tuple Fields

0: [u8; 6]

Implementations

impl MacAddress

pub fn display_with_oui(&self) -> String

Returns a formatted string of the MAC address, including its OUI if recognized.

• If the OUI is recognized, the format is: {Manufacturer}:{Last three bytes}
• Otherwise, the MAC address is displayed in standard hexadecimal notation.

Example

use packet_parser::parse::data_link::mac_addres::MacAddress;

let mac = MacAddress([0x2C, 0xFD, 0xA1, 0x3C, 0x4D, 0x5E]);
assert_eq!(mac.display_with_oui(), "ASUSTek:3c:4d:5e");

let unknown_mac = MacAddress([0x00, 0x1A, 0x2B, 0x3C, 0x4D, 0x5E]);
assert_eq!(unknown_mac.display_with_oui(), "00:1a:2b:3c:4d:5e");

pub fn get_oui(&self) -> Oui

Returns the OUI (Organizationally Unique Identifier) associated with the MAC address.

Example

use packet_parser::parse::data_link::mac_addres::MacAddress;

let mac = MacAddress([0x2C, 0xFD, 0xA1, 0x3C, 0x4D, 0x5E]);
assert_eq!(mac.get_oui().to_string(), "ASUSTek");

Trait Implementations

impl Clone for MacAddress

fn clone(&self) -> MacAddress

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MacAddress

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MacAddress

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for MacAddress

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

Formats the value using the given formatter.

impl Hash for MacAddress

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for MacAddress

fn eq(&self, other: &MacAddress) -> 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 Serialize for MacAddress

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&[u8]> for MacAddress

fn try_from(bytes: &[u8]) -> Result<Self, Self::Error>

Converts a byte slice into a MacAddress, enforcing a length of 6 bytes.

Errors

Returns MacParseError::InvalidLength if the input slice is not exactly 6 bytes.

Example

use packet_parser::parse::data_link::mac_addres::MacAddress;
use std::convert::TryFrom;

let bytes = [0x00, 0x1A, 0x2B, 0x3C, 0x4D, 0x5E];
let mac = MacAddress::try_from(bytes.as_ref()).expect("Valid MAC address");

assert_eq!(mac, MacAddress([0x00, 0x1A, 0x2B, 0x3C, 0x4D, 0x5E]));

type Error = MacParseError

The type returned in the event of a conversion error.

impl Copy for MacAddress

impl Eq for MacAddress

impl StructuralPartialEq for MacAddress