Struct etherparse::Ipv6Header
source · pub struct Ipv6Header {
pub traffic_class: u8,
pub flow_label: Ipv6FlowLabel,
pub payload_length: u16,
pub next_header: IpNumber,
pub hop_limit: u8,
pub source: [u8; 16],
pub destination: [u8; 16],
}
Expand description
IPv6 header according to rfc8200.
Fields§
§traffic_class: u8
§flow_label: Ipv6FlowLabel
If non 0 serves as a hint to router and switches with multiple outbound paths that these packets should stay on the same path, so that they will not be reordered.
payload_length: u16
The length of the payload and extension headers in bytes (0 in case of jumbo payloads).
next_header: IpNumber
IP protocol number specifying the next header or transport layer protocol.
hop_limit: u8
The number of hops the packet can take before it is discarded.
source: [u8; 16]
IPv6 source address
destination: [u8; 16]
IPv6 destination address
Implementations§
source§impl Ipv6Header
impl Ipv6Header
pub const SERIALIZED_SIZE: usize = 40usize
Ipv6Header::LEN
insteadsourcepub fn read_from_slice(
slice: &[u8]
) -> Result<(Ipv6Header, &[u8]), HeaderSliceError>
👎Deprecated since 0.10.1: Renamed to Ipv6Header::from_slice
pub fn read_from_slice( slice: &[u8] ) -> Result<(Ipv6Header, &[u8]), HeaderSliceError>
Ipv6Header::from_slice
Renamed to Ipv6Header::from_slice
sourcepub fn from_slice(slice: &[u8]) -> Result<(Ipv6Header, &[u8]), HeaderSliceError>
pub fn from_slice(slice: &[u8]) -> Result<(Ipv6Header, &[u8]), HeaderSliceError>
Read an Ipv6Header from a slice and return the header & unused parts of the slice.
Note that this function DOES NOT seperate the payload based on the length payload_length present in the IPv6 header. It just returns the left over slice after the header.
If you want to have correctly seperated payload including the IP extension headers use
crate::IpHeaders::from_ipv6_slice
(decodes all the fields of the IP headers)crate::Ipv6Slice::from_slice
(just identifies the ranges in the slice where the headers and payload are present)
or
for a laxer version which falls back to slice length when the payload_length
contains an inconsistent value.
sourcepub fn read<T: Read + Seek + Sized>(
reader: &mut T
) -> Result<Ipv6Header, HeaderReadError>
Available on crate feature std
only.
pub fn read<T: Read + Seek + Sized>( reader: &mut T ) -> Result<Ipv6Header, HeaderReadError>
std
only.Reads an IPv6 header from the current position.
sourcepub fn read_without_version<T: Read + Seek + Sized>(
reader: &mut T,
version_rest: u8
) -> Result<Ipv6Header, Error>
Available on crate feature std
only.
pub fn read_without_version<T: Read + Seek + Sized>( reader: &mut T, version_rest: u8 ) -> Result<Ipv6Header, Error>
std
only.Reads an IPv6 header assuming the version & flow_label field have already been read.
sourcepub fn skip_header_extension_in_slice(
slice: &[u8],
next_header: IpNumber
) -> Result<(IpNumber, &[u8]), LenError>
pub fn skip_header_extension_in_slice( slice: &[u8], next_header: IpNumber ) -> Result<(IpNumber, &[u8]), LenError>
Takes a slice and skips an ipv6 header extensions and returns the next_header ip number & the slice past the header.
sourcepub fn is_skippable_header_extension(ip_protocol_number: IpNumber) -> bool
pub fn is_skippable_header_extension(ip_protocol_number: IpNumber) -> bool
Returns true if the given ip protocol number is a skippable header extension.
A skippable header extension is an extension header for which it is known how to determine the protocol number of the following header as well as how many octets have to be skipped to reach the start of the following header.
sourcepub fn skip_all_header_extensions_in_slice(
slice: &[u8],
next_header: IpNumber
) -> Result<(IpNumber, &[u8]), LenError>
pub fn skip_all_header_extensions_in_slice( slice: &[u8], next_header: IpNumber ) -> Result<(IpNumber, &[u8]), LenError>
Takes a slice & ip protocol number (identifying the first header type) and returns next_header id & the slice past after all ipv6 header extensions.
sourcepub fn skip_header_extension<T: Read + Seek + Sized>(
reader: &mut T,
next_header: IpNumber
) -> Result<IpNumber, Error>
Available on crate feature std
only.
pub fn skip_header_extension<T: Read + Seek + Sized>( reader: &mut T, next_header: IpNumber ) -> Result<IpNumber, Error>
std
only.Skips the ipv6 header extension and returns the next ip protocol number
sourcepub fn skip_all_header_extensions<T: Read + Seek + Sized>(
reader: &mut T,
next_header: IpNumber
) -> Result<IpNumber, Error>
Available on crate feature std
only.
pub fn skip_all_header_extensions<T: Read + Seek + Sized>( reader: &mut T, next_header: IpNumber ) -> Result<IpNumber, Error>
std
only.Skips all ipv6 header extensions and returns the next ip protocol number
sourcepub fn write<T: Write + Sized>(&self, writer: &mut T) -> Result<(), Error>
Available on crate feature std
only.
pub fn write<T: Write + Sized>(&self, writer: &mut T) -> Result<(), Error>
std
only.Writes a given IPv6 header to the current position.
sourcepub fn source_addr(&self) -> Ipv6Addr
Available on crate feature std
only.
pub fn source_addr(&self) -> Ipv6Addr
std
only.Return the ipv6 source address as an std::net::Ipv6Addr
sourcepub fn destination_addr(&self) -> Ipv6Addr
Available on crate feature std
only.
pub fn destination_addr(&self) -> Ipv6Addr
std
only.Return the ipv6 destination address as an std::net::Ipv6Addr
sourcepub fn header_len(&self) -> usize
pub fn header_len(&self) -> usize
Length of the serialized header in bytes.
The function always returns the constant Ipv6Header::LEN and exists to keep the methods consistent with other headers.
sourcepub fn set_payload_length(
&mut self,
size: usize
) -> Result<(), ValueTooBigError<usize>>
pub fn set_payload_length( &mut self, size: usize ) -> Result<(), ValueTooBigError<usize>>
Sets the field total_length based on the size of the payload and the options. Returns an error if the payload is too big to fit.
Trait Implementations§
source§impl Clone for Ipv6Header
impl Clone for Ipv6Header
source§fn clone(&self) -> Ipv6Header
fn clone(&self) -> Ipv6Header
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for Ipv6Header
impl Debug for Ipv6Header
source§impl Default for Ipv6Header
impl Default for Ipv6Header
source§fn default() -> Ipv6Header
fn default() -> Ipv6Header
source§impl PartialEq for Ipv6Header
impl PartialEq for Ipv6Header
source§fn eq(&self, other: &Ipv6Header) -> bool
fn eq(&self, other: &Ipv6Header) -> bool
self
and other
values to be equal, and is used
by ==
.