uefi-raw: add .octets() for most types

This aligns the API with the core::net API.

We don't do it for IpAddress as
`unsafe { addr.v4 }.octets()` or
`unsafe { addr.v6 }.octets()` are
sufficient.

Author: phip1611

uefi-raw/CHANGELOG.md

@@ -5,6 +5,8 @@
 - Added `PciRootBridgeIoProtocol`.
 - Added `ConfigKeywordHandlerProtocol`.
 - Added `HiiConfigAccessProtocol`.
+- Added `::octets()` for `Ipv4Address`, `Ipv6Address`, and
+  `MacAddress` to streamline the API with `core::net`.
 
 ## Changed
 - The documentation for UEFI protocols has been streamlined and improved.

uefi-raw/src/net.rs

@@ -16,6 +16,14 @@ use core::fmt::{Debug, Formatter};
 #[repr(transparent)]
 pub struct Ipv4Address(pub [u8; 4]);
 
+impl Ipv4Address {
+    /// Returns the octets of the IP address.
+    #[must_use]
+    pub const fn octets(self) -> [u8; 4] {
+        self.0
+    }
+}
+
 impl From<core::net::Ipv4Addr> for Ipv4Address {
     fn from(ip: core::net::Ipv4Addr) -> Self {
         Self(ip.octets())
@@ -33,6 +41,14 @@ impl From<Ipv4Address> for core::net::Ipv4Addr {
 #[repr(transparent)]
 pub struct Ipv6Address(pub [u8; 16]);
 
+impl Ipv6Address {
+    /// Returns the octets of the IP address.
+    #[must_use]
+    pub const fn octets(self) -> [u8; 16] {
+        self.0
+    }
+}
+
 impl From<core::net::Ipv6Addr> for Ipv6Address {
     fn from(ip: core::net::Ipv6Addr) -> Self {
         Self(ip.octets())
@@ -125,6 +141,15 @@ impl From<core::net::IpAddr> for IpAddress {
 #[repr(transparent)]
 pub struct MacAddress(pub [u8; 32]);
 
+impl MacAddress {
+    /// Returns the octets of the MAC address.
+    #[must_use]
+    pub const fn octets(self) -> [u8; 32] {
+        self.0
+    }
+}
+
+// Normal/typical MAC addresses, such as in Ethernet.
 impl From<[u8; 6]> for MacAddress {
     fn from(octets: [u8; 6]) -> Self {
         let mut buffer = [0; 32];