Union IpAddress 

#[repr(C)]
pub union IpAddress {
    pub addr: [u32; 4],
    pub v4: Ipv4Address,
    pub v6: Ipv6Address,
}

An IPv4 or IPv6 internet protocol address that is ABI compatible with EFI.

Corresponds to the EFI_IP_ADDRESS type in the UEFI specification. This type is defined in the same way as edk2 for compatibility with C code. Note that this is an untagged union, so there’s no way to tell which type of address an IpAddress value contains without additional context.

Conversions and Relation to [core::net]

The following [From] implementations exist:

• [u8; 4] -> IpAddress
• [u8; 16] -> IpAddress
• [core::net::Ipv4Addr] -> IpAddress
• [core::net::Ipv6Addr] -> IpAddress
• [core::net::IpAddr] -> IpAddress

Fields

addr: [u32; 4]

This member serves to align the whole type to a 4 bytes as required by the spec. Note that this is slightly different from repr(align(4)), which would prevent placing this type in a packed structure.

v4: Ipv4Address

An IPv4 internet protocol address.

v6: Ipv6Address

An IPv6 internet protocol address.

Implementations

impl IpAddress

pub const ZERO: Self

Zeroed variant where all bytes are guaranteed to be initialized to zero.

pub const fn new_v4(octets: [u8; 4]) -> Self

Construct a new IPv4 address.

The type won’t know that it is an IPv6 address and additional context is needed.

Safety

The constructor only initializes the bytes needed for IPv4 addresses.

pub const fn new_v6(octets: [u8; 16]) -> Self

Construct a new IPv6 address.

The type won’t know that it is an IPv6 address and additional context is needed.

pub unsafe fn into_core_addr(self, is_ipv6: bool) -> IpAddr

Transforms this EFI type to the Rust standard library’s type [core::net::IpAddr].

Arguments

• is_ipv6: Whether the internal data should be interpreted as IPv6 or IPv4 address.

Safety

Callers must ensure that the v4 field is valid if is_ipv6 is false, and that the v6 field is valid if is_ipv6 is true

Trait Implementations

impl Clone for IpAddress

fn clone(&self) -> IpAddress

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for IpAddress

impl Debug for IpAddress

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

Formats the value using the given formatter.

impl Default for IpAddress

fn default() -> Self

Returns the “default value” for a type.

impl From<IpAddr> for IpAddress

fn from(t: IpAddr) -> Self

Converts to this type from the input type.

impl From<Ipv4Addr> for IpAddress

fn from(value: Ipv4Addr) -> Self

Converts to this type from the input type.

impl From<Ipv6Addr> for IpAddress

fn from(value: Ipv6Addr) -> Self

Converts to this type from the input type.

impl From<[u8; 4]> for IpAddress

fn from(octets: [u8; 4]) -> Self

Converts to this type from the input type.

impl From<[u8; 16]> for IpAddress

fn from(octets: [u8; 16]) -> Self

Converts to this type from the input type.