Struct net_types::ethernet::Mac

#[repr(transparent)]
pub struct Mac(/* private fields */);

A media access control (MAC) address.

MAC addresses are used to identify devices in the Ethernet protocol.

MAC addresses can be derived from multicast IP addresses; see the From implementation for more details.

Layout

Mac has the same layout as [u8; 6], which is the layout that most protocols use to represent a MAC address in their packet formats. This can be useful when parsing a MAC address from a packet. For example:

/// The header of an Ethernet frame.
///
/// `EthernetHeader` has the same layout as the header of an Ethernet frame.
#[repr(C)]
struct EthernetHeader {
    dst: Mac,
    src: Mac,
    ethertype: [u8; 2],
}

Implementations

impl Mac

pub const BYTES: usize = 6usize

The number of bytes in a Mac address.

pub const BROADCAST: Mac = _

The broadcast MAC address.

The broadcast MAC address, FF:FF:FF:FF:FF:FF, indicates that a frame should be received by all receivers regardless of their local MAC address.

pub const DEFAULT_EUI_MAGIC: [u8; 2] = _

The default RFC 4291 EUI-64 magic value used by the to_eui64 method.

pub const UNSPECIFIED: Mac = _

The all-zeroes MAC address.

pub const fn new(bytes: [u8; 6]) -> Mac

Constructs a new MAC address.

pub const fn bytes(self) -> [u8; 6]

Gets the bytes of the MAC address.

pub fn to_eui64(self) -> [u8; 8]

Returns the RFC 4291 EUI-64 interface identifier for this MAC address with the default EUI magic value.

mac.to_eui64() is equivalent to mac.to_eui64_with_magic(Mac::DEFAULT_EUI_MAGIC).

pub fn to_eui64_with_magic(self, eui_magic: [u8; 2]) -> [u8; 8]

Returns the RFC 4291 EUI-64 interface identifier for this MAC address with a custom EUI magic value.

eui_magic is the two bytes that are inserted between the bytes of the MAC address to form the identifier. Also see the to_eui64 method, which uses the default magic value of 0xFFFE.

pub fn to_ipv6_link_local( self ) -> AddrSubnet<Ipv6Addr, LinkLocalUnicastAddr<Ipv6Addr>>

Returns the link-local unicast IPv6 address and subnet for this MAC address, as per [RFC 4862], with the default EUI magic value.

mac.to_ipv6_link_local() is equivalent to mac.to_ipv6_link_local_with_magic(Mac::DEFAULT_EUI_MAGIC).

pub fn to_ipv6_link_local_with_magic( self, eui_magic: [u8; 2] ) -> AddrSubnet<Ipv6Addr, LinkLocalUnicastAddr<Ipv6Addr>>

Returns the link-local unicast IPv6 address and subnet for this MAC address, as per RFC 4862.

eui_magic is the two bytes that are inserted between the bytes of the MAC address to form the identifier. Also see the to_ipv6_link_local method, which uses the default magic value of 0xFFFE.

The subnet prefix length is 128 - Ipv6::UNICAST_INTERFACE_IDENTIFIER_BITS.

Trait Implementations

impl AsBytes for Macwhere [u8; 6]: AsBytes,

fn as_bytes(&self) -> &[u8]

Gets the bytes of this value.

fn as_bytes_mut(&mut self) -> &mut [u8] where Self: FromBytes,

Gets the bytes of this value mutably.

fn write_to(&self, bytes: &mut [u8]) -> Option<()>

Writes a copy of self to bytes.

fn write_to_prefix(&self, bytes: &mut [u8]) -> Option<()>

Writes a copy of self to the prefix of bytes.

fn write_to_suffix(&self, bytes: &mut [u8]) -> Option<()>

Writes a copy of self to the suffix of bytes.

impl AsMut<[u8]> for Mac

fn as_mut(&mut self) -> &mut [u8]

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<[u8]> for Mac

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl BroadcastAddress for Mac

fn is_broadcast(&self) -> bool

Is this the broadcast MAC address?

Returns true if this is the broadcast MAC address, FF:FF:FF:FF:FF:FF. Note that the broadcast address is also considered a multicast address, so addr.is_broadcast() implies addr.is_multicast().

impl Clone for Mac

fn clone(&self) -> Mac

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Mac

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

Formats the value using the given formatter.

impl Display for Mac

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

Formats the value using the given formatter.

impl<'a, A: IpAddress> From<&'a MulticastAddr<A>> for Mac

fn from(addr: &'a MulticastAddr<A>) -> Mac

Converts a multicast IP address to a MAC address.

This method is equivalent to MulticastAddr::<Mac>::from(addr).get().

impl From<BroadcastAddr<Mac>> for Mac

fn from(addr: BroadcastAddr<Mac>) -> Mac

Converts to this type from the input type.

impl<A: IpAddress> From<MulticastAddr<A>> for Mac

fn from(addr: MulticastAddr<A>) -> Mac

Converts a multicast IP address to a MAC address.

This method is equivalent to (&addr).into().

impl From<MulticastAddr<Mac>> for Mac

fn from(addr: MulticastAddr<Mac>) -> Mac

Converts to this type from the input type.

impl From<UnicastAddr<Mac>> for Mac

fn from(addr: UnicastAddr<Mac>) -> Mac

Converts to this type from the input type.

impl FromBytes for Macwhere [u8; 6]: FromBytes,

fn read_from(bytes: &[u8]) -> Option<Self>where Self: Sized,

Reads a copy of Self from bytes.

fn read_from_prefix(bytes: &[u8]) -> Option<Self>where Self: Sized,

Reads a copy of Self from the prefix of bytes.

fn read_from_suffix(bytes: &[u8]) -> Option<Self>where Self: Sized,

Reads a copy of Self from the suffix of bytes.

impl FromZeroes for Macwhere [u8; 6]: FromZeroes,

fn zero(&mut self)

Overwrites self with zeroes.

fn new_zeroed() -> Selfwhere Self: Sized,

Creates an instance of Self from zeroed bytes.

impl Hash for Mac

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 MulticastAddress for Mac

fn is_multicast(&self) -> bool

Is this a multicast MAC address?

Returns true if the least significant bit of the first byte of the address is 1.

impl PartialEq<Mac> for Mac

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl UnicastAddress for Mac

fn is_unicast(&self) -> bool

Is this a unicast MAC address?

Returns true if the least significant bit of the first byte of the address is 0.

impl Copy for Mac

impl Eq for Mac

impl StructuralEq for Mac

impl StructuralPartialEq for Mac

impl Unaligned for Macwhere [u8; 6]: Unaligned,