uefi: SNP transmit: document parameters

Author: phip1611

uefi/src/proto/network/snp.rs

@@ -213,13 +213,36 @@ impl SimpleNetwork {
         status.to_result_with_val(|| NonNull::new(tx_buf.cast()))
     }
 
-    /// Place a packet in the transmit queue of a network interface.
+    /// Place a packet in the transmit queue of the network interface.
+    ///
+    /// The packet structure depends on the type of network interface, 
+    /// effectively this is always a (wired) ethernet interface. In these cases,
+    /// this functino transmits ethernet frames.
+    ///
+    /// The header of the packet can be filled by the function with the given
+    /// parameters , but the buffer must already contain the space for the
+    /// header.
+    ///
+    /// # Arguments
+    /// - `header_size`: The size in bytes of the media header to be filled by
+    ///   the `transmit()` function. If this is `0`, the (ethernet frame) header
+    ///   will not be filled by the function and taken as-is from the buffer.
+    ///   If it is nonzero, then it must be equal to `media_header_size` of
+    ///   the corresponding [`NetworkMode`] and the `dst_addr` and `protocol`
+    ///   parameters must not be `None`.
+    /// - `buffer`: The buffer containing the whole network packet with all
+    ///   its payload including the header for the medium.
+    /// - `src_addr`: The optional source address.
+    /// - `dst_addr`: The optional destination address.
+    /// - `protocol`: Ether Type as of RFC 3232. See
+    ///   https://www.iana.org/assignments/ieee-802-numbers/ieee-802-numbers.xhtml#ieee-802-numbers-1
+    ///   for examples. Typically, this is `0x0800` (IPv4) or `0x0806` (ARP).
     pub fn transmit(
         &self,
         header_size: usize,
         buffer: &[u8],
         src_addr: Option<MacAddress>,
-        dest_addr: Option<MacAddress>,
+        dst_addr: Option<MacAddress>,
         protocol: Option<u16>,
     ) -> Result {
         (self.transmit)(
@@ -228,7 +251,7 @@ impl SimpleNetwork {
             buffer.len(),
             buffer.as_ptr().cast(),
             src_addr.as_ref(),
-            dest_addr.as_ref(),
+            dst_addr.as_ref(),
             protocol.as_ref(),
         )
         .to_result()