libtins
4.0
|
Represents an Ethernet II PDU. More...
#include <ethernetII.h>
Public Types | |
typedef HWAddress< 6 > | address_type |
The hardware address type. | |
Public Types inherited from Tins::PDU | |
enum | endian_type { BE, LE } |
enum | PDUType { RAW, ETHERNET_II, IEEE802_3, DOT3 = IEEE802_3, RADIOTAP, DOT11, DOT11_ACK, DOT11_ASSOC_REQ, DOT11_ASSOC_RESP, DOT11_AUTH, DOT11_BEACON, DOT11_BLOCK_ACK, DOT11_BLOCK_ACK_REQ, DOT11_CF_END, DOT11_DATA, DOT11_CONTROL, DOT11_DEAUTH, DOT11_DIASSOC, DOT11_END_CF_ACK, DOT11_MANAGEMENT, DOT11_PROBE_REQ, DOT11_PROBE_RESP, DOT11_PS_POLL, DOT11_REASSOC_REQ, DOT11_REASSOC_RESP, DOT11_RTS, DOT11_QOS_DATA, LLC, SNAP, IP, ARP, TCP, UDP, ICMP, BOOTP, DHCP, EAPOL, RC4EAPOL, RSNEAPOL, DNS, LOOPBACK, IPv6, ICMPv6, SLL, DHCPv6, DOT1Q, PPPOE, STP, PPI, IPSEC_AH, IPSEC_ESP, PKTAP, MPLS, UNKNOWN = 999, USER_DEFINED_PDU = 1000 } |
Enum which identifies each type of PDU. More... | |
typedef byte_array | serialization_type |
Public Member Functions | |
EthernetII (const address_type &dst_hw_addr=address_type(), const address_type &src_hw_addr=address_type()) | |
Constructs an ethernet II PDU. More... | |
EthernetII (const uint8_t *buffer, uint32_t total_sz) | |
Constructs a EthernetII object from a buffer and adds all identifiable PDUs found in the buffer as children of this one. More... | |
address_type | dst_addr () const |
Getter for the destination's hardware address. More... | |
address_type | src_addr () const |
Getter for the source's hardware address. More... | |
uint16_t | payload_type () const |
Getter for the payload_type. More... | |
void | dst_addr (const address_type &new_dst_addr) |
Setter for the destination hardware address. More... | |
void | src_addr (const address_type &new_src_addr) |
Setter for the source hardware address. More... | |
void | payload_type (uint16_t new_payload_type) |
Setter for the payload type. More... | |
uint32_t | header_size () const |
Returns the ethernet frame's header length. More... | |
uint32_t | trailer_size () const |
Returns the ethernet II frame's padding. More... | |
void | send (PacketSender &sender, const NetworkInterface &iface) |
bool | matches_response (const uint8_t *ptr, uint32_t total_sz) const |
Check whether ptr points to a valid response for this PDU. More... | |
PDU * | recv_response (PacketSender &sender, const NetworkInterface &iface) |
Receives a matching response for this packet. More... | |
PDUType | pdu_type () const |
Getter for the PDU's type. More... | |
EthernetII * | clone () const |
Public Member Functions inherited from Tins::PDU | |
PDU () | |
Default constructor. | |
PDU (PDU &&rhs) TINS_NOEXCEPT | |
Move constructor. More... | |
PDU & | operator= (PDU &&rhs) TINS_NOEXCEPT |
Move assignment operator. More... | |
virtual | ~PDU () |
PDU destructor. More... | |
uint32_t | size () const |
The whole chain of PDU's size, including this one. More... | |
PDU * | inner_pdu () const |
Getter for the inner PDU. More... | |
PDU * | parent_pdu () const |
PDU * | release_inner_pdu () |
Releases the inner PDU. More... | |
void | inner_pdu (PDU *next_pdu) |
Sets the child PDU. More... | |
void | inner_pdu (const PDU &next_pdu) |
Sets the child PDU. More... | |
serialization_type | serialize () |
Serializes the whole chain of PDU's, including this one. More... | |
template<typename T > | |
T * | find_pdu (PDUType type=T::pdu_flag) |
Finds and returns the first PDU that matches the given flag. More... | |
template<typename T > | |
const T * | find_pdu (PDUType type=T::pdu_flag) const |
Finds and returns the first PDU that matches the given flag. More... | |
template<typename T > | |
T & | rfind_pdu (PDUType type=T::pdu_flag) |
Finds and returns the first PDU that matches the given flag. More... | |
template<typename T > | |
const T & | rfind_pdu (PDUType type=T::pdu_flag) const |
Finds and returns the first PDU that matches the given flag. More... | |
virtual bool | matches_flag (PDUType flag) const |
Check whether this PDU matches the specified flag. More... | |
Static Public Member Functions | |
static metadata | extract_metadata (const uint8_t *buffer, uint32_t total_sz) |
Extracts metadata for this protocol based on the buffer provided. More... | |
Static Public Attributes | |
static const PDU::PDUType | pdu_flag = PDU::ETHERNET_II |
This PDU's flag. | |
static const address_type | BROADCAST |
Represents the ethernetII broadcast address. | |
Static Public Attributes inherited from Tins::PDU | |
static const endian_type | endianness = BE |
Additional Inherited Members | |
Protected Member Functions inherited from Tins::PDU | |
PDU (const PDU &other) | |
Copy constructor. | |
PDU & | operator= (const PDU &other) |
Copy assignment operator. | |
void | copy_inner_pdu (const PDU &pdu) |
Copy other PDU's inner PDU(if any). More... | |
virtual void | prepare_for_serialize () |
Prepares this PDU for serialization. More... | |
void | serialize (uint8_t *buffer, uint32_t total_sz) |
Serializes this PDU and propagates this action to child PDUs. More... | |
Represents an Ethernet II PDU.
Tins::EthernetII::EthernetII | ( | const address_type & | dst_hw_addr = address_type() , |
const address_type & | src_hw_addr = address_type() |
||
) |
Constructs an ethernet II PDU.
dst_hw_addr | address_type containing the destination's MAC. |
src_hw_addr | address_type containing the source's MAC. |
Tins::EthernetII::EthernetII | ( | const uint8_t * | buffer, |
uint32_t | total_sz | ||
) |
Constructs a EthernetII object from a buffer and adds all identifiable PDUs found in the buffer as children of this one.
If the next PDU is not recognized, then a RawPDU is used.
If there is not enough size for a EthernetII header in the buffer, a malformed_packet exception is thrown.
buffer | The buffer from which this PDU will be constructed. |
total_sz | The total size of the buffer. |
|
inlinevirtual |
Implements Tins::PDU.
|
inline |
Getter for the destination's hardware address.
void Tins::EthernetII::dst_addr | ( | const address_type & | new_dst_addr | ) |
Setter for the destination hardware address.
new_dst_addr | the destination hardware address to be set. |
|
static |
Extracts metadata for this protocol based on the buffer provided.
buffer | Pointer to a buffer |
total_sz | Size of the buffer pointed by buffer |
|
virtual |
Returns the ethernet frame's header length.
Implements Tins::PDU.
|
virtual |
Check whether ptr points to a valid response for this PDU.
ptr | The pointer to the buffer. |
total_sz | The size of the buffer. |
Reimplemented from Tins::PDU.
|
inline |
Getter for the payload_type.
void Tins::EthernetII::payload_type | ( | uint16_t | new_payload_type | ) |
Setter for the payload type.
new_payload_type | the new value of the payload type field. |
|
inlinevirtual |
|
virtual |
Receives a matching response for this packet.
Reimplemented from Tins::PDU.
|
virtual |
Reimplemented from Tins::PDU.
|
inline |
Getter for the source's hardware address.
void Tins::EthernetII::src_addr | ( | const address_type & | new_src_addr | ) |
Setter for the source hardware address.
new_src_addr | the source hardware address to be set. |
|
virtual |
Returns the ethernet II frame's padding.
Reimplemented from Tins::PDU.