Enum net_types::ip::Ipv6SourceAddr

source ·
pub enum Ipv6SourceAddr {
    Unicast(NonMappedAddr<UnicastAddr<Ipv6Addr>>),
    Unspecified,
}
Expand description

The source address from an IPv6 packet.

An Ipv6SourceAddr represents the source address from an IPv6 packet, which may only be either:

  • unicast and non-mapped (e.g. not an ipv4-mapped-ipv6 address), or
  • unspecified.

Variants§

§

Unicast(NonMappedAddr<UnicastAddr<Ipv6Addr>>)

§

Unspecified

Implementations§

source§

impl Ipv6SourceAddr

source

pub fn new(addr: Ipv6Addr) -> Option<Ipv6SourceAddr>

Constructs a new Ipv6SourceAddr.

Returns None if addr does not satisfy the properties required of an Ipv6SourceAddr.

Methods from Deref<Target = Ipv6Addr>§

source

pub fn ipv6_bytes(&self) -> [u8; 16]

Gets the bytes of the IPv6 address.

source

pub fn segments(&self) -> [u16; 8]

Gets the 16-bit segments of the IPv6 address.

source

pub fn to_solicited_node_address(&self) -> MulticastAddr<Ipv6Addr>

Converts this Ipv6Addr to the IPv6 Solicited-Node Address, used in Neighbor Discovery, defined in RFC 4291 Section 2.7.1.

source

pub fn is_valid_unicast(&self) -> bool

Is this a valid unicast address?

A valid unicast address is any unicast address that can be bound to an interface (not the unspecified or loopback addresses). addr.is_valid_unicast() is equivalent to !(addr.is_loopback() || !addr.is_specified() || addr.is_multicast()).

source

pub fn is_site_local(&self) -> bool

Is this address in the (deprecated) site-local unicast subnet?

is_site_local returns true if self is in the (deprecated) Ipv6::SITE_LOCAL_UNICAST_SUBNET. See that constant’s documentation for more details on deprecation and how the subnet should be used in light of deprecation.

Is this a unicast link-local address?

addr.is_unicast_link_local() is equivalent to addr.is_unicast_in_subnet(&Ipv6::LINK_LOCAL_UNICAST_SUBNET).

source

pub fn to_ipv4_compatible(&self) -> Option<Ipv4Addr>

Tries to extract the IPv4 address from an IPv4-compatible IPv6 address.

IPv4-compatible IPv6 addresses were defined to assist in the IPv6 transition, and are now specified in RFC 4291 Section 2.5.5.1. The lowest-order 32 bits carry an IPv4 address, while the highest-order 96 bits are all set to 0 as in this diagram from the RFC:

|                80 bits               | 16 |      32 bits        |
+--------------------------------------+--------------------------+
|0000..............................0000|0000|    IPv4 address     |
+--------------------------------------+----+---------------------+

to_ipv4_compatible checks to see if self is an IPv4-compatible IPv6 address. If it is, the IPv4 address is extracted and returned.

Per RFC 4291:

The ‘IPv4-Compatible IPv6 address’ is now deprecated because the current IPv6 transition mechanisms no longer use these addresses. New or updated implementations are not required to support this address type.

The more modern embedding format is IPv4-mapped IPv6 addressing - see to_ipv4_mapped.

source

pub fn to_ipv4_mapped(&self) -> Option<Ipv4Addr>

Tries to extract the IPv4 address from an IPv4-mapped IPv6 address.

IPv4-mapped IPv6 addresses are used to represent the addresses of IPv4 nodes as IPv6 addresses, and are defined in RFC 4291 Section 2.5.5.2. The lowest-order 32 bits carry an IPv4 address, the middle order 16 bits carry the literal 0xFFFF, and the highest order 80 bits are set to 0 as in this diagram from the RFC:

|                80 bits               | 16 |      32 bits        |
+--------------------------------------+--------------------------+
|0000..............................0000|FFFF|    IPv4 address     |
+--------------------------------------+----+---------------------+

to_ipv4_mapped checks to see if self is an IPv4-mapped IPv6 address. If it is, the IPv4 address is extracted and returned.

Trait Implementations§

source§

impl AsRef<Ipv6Addr> for Ipv6SourceAddr

source§

fn as_ref(&self) -> &Ipv6Addr

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

impl Clone for Ipv6SourceAddr

source§

fn clone(&self) -> Ipv6SourceAddr

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for Ipv6SourceAddr

source§

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

Formats the value using the given formatter. Read more
source§

impl Deref for Ipv6SourceAddr

§

type Target = Ipv6Addr

The resulting type after dereferencing.
source§

fn deref(&self) -> &Ipv6Addr

Dereferences the value.
source§

impl Display for Ipv6SourceAddr

source§

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

Formats the value using the given formatter. Read more
source§

impl From<&Ipv6SourceAddr> for Ipv6Addr

source§

fn from(addr: &Ipv6SourceAddr) -> Ipv6Addr

Converts to this type from the input type.
source§

impl From<Ipv6SourceAddr> for Ipv6Addr

source§

fn from(addr: Ipv6SourceAddr) -> Ipv6Addr

Converts to this type from the input type.
source§

impl LinkLocalAddress for Ipv6SourceAddr

Is this a link-local address? Read more
source§

impl MappedAddress for Ipv6SourceAddr

source§

fn is_non_mapped(&self) -> bool

Is this a non-mapped address?
source§

impl PartialEq for Ipv6SourceAddr

source§

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

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

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.
source§

impl SpecifiedAddress for Ipv6SourceAddr

source§

fn is_specified(&self) -> bool

Is this a specified address? Read more
source§

impl TryFrom<Ipv6Addr> for Ipv6SourceAddr

§

type Error = ()

The type returned in the event of a conversion error.
source§

fn try_from(addr: Ipv6Addr) -> Result<Ipv6SourceAddr, ()>

Performs the conversion.
source§

impl UnicastAddress for Ipv6SourceAddr

source§

fn is_unicast(&self) -> bool

Is this a unicast address? Read more
source§

impl Witness<Ipv6Addr> for Ipv6SourceAddr

source§

fn new(addr: Ipv6Addr) -> Option<Ipv6SourceAddr>

Constructs a new witness type. Read more
source§

unsafe fn new_unchecked(addr: Ipv6Addr) -> Ipv6SourceAddr

Constructs a new witness type without checking to see if addr actually satisfies the required property. Read more
source§

fn into_addr(self) -> Ipv6Addr

Consumes this witness and returns the contained A. Read more
source§

fn from_witness<W: Witness<A>>(addr: W) -> Option<Self>

Constructs a new witness type from an existing witness type. Read more
source§

fn get(&self) -> A
where A: Copy,

Gets a copy of the address.
source§

impl Copy for Ipv6SourceAddr

source§

impl Eq for Ipv6SourceAddr

source§

impl StructuralPartialEq for Ipv6SourceAddr

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

default unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> CloneToUninit for T
where T: Copy,

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<A> LinkLocalUnicastAddress for A