#include <wipal/phy/phy.hh>
All PHY headers shall subclass this class. It provides a common interface so WiPal's internals work whatever the PHY header.
To subclass, you must define the time_type
virtual type, implement len_impl()
, time_get_impl()
, time_set_impl()
, and eq_time()
.
time_type
is the type of the PHY header's timing information. Use phy::empty_time if your PHY header has no timing information.
time_get_impl()
and time_set_impl()
retrieve and set this PHY header's timing information.
eq_time()
indicates whether two frames are equals with respect to timestamps. If no timestamps are available, implement it by comparing PCAP timestamps.
len_impl()
returns the size of the PHY header.
Public Types | |
Static hierarchies related types | |
typedef HIDDEN | exact_type |
typedef HIDDEN | time_type |
Public Member Functions | |
size_t | len (size_t caplen, bool swapped) const |
const void * | decapsulate (size_t caplen, bool swapped) const |
time_type | time_get (bool swapped) const |
void | time_set (const time_type &time, bool swapped) |
Downcast methods | |
const exact_type & | exact () const |
exact_type & | exact () |
const exact_type * | exact_ptr () const |
exact_type * | exact_ptr () |
Static Public Member Functions | |
template<class D1, class D2> | |
static bool | eq_80211 (const pcapxx::frame_descriptor< D1 > &lhs, const pcapxx::frame_descriptor< D2 > &rhs, tool::endian::endianness phy_end=tool::endian::guess) |
template<class D1, class D2> | |
static bool | eq_time_and_80211 (const pcapxx::frame_descriptor< D1 > &lhs, const pcapxx::frame_descriptor< D2 > &rhs, tool::endian::endianness phy_end=tool::endian::guess, unsigned precision=phy::eq_time_default_precision) |
typedef HIDDEN phy::header< Bottom >::exact_type |
Exact type for this template instanciation.
Reimplemented from tool::static_base< Bottom >.
Reimplemented in avs::header, phy::empty_header< Bottom >, prism::header, and rtap::header.
size_t phy::header< B >::len | ( | size_t | caplen, | |
bool | swapped | |||
) | const [inline] |
Get the PHY header length.
Never override this method. Define len_impl()
in subclasses instead.
const void * phy::header< B >::decapsulate | ( | size_t | caplen, | |
bool | swapped | |||
) | const [inline] |
header< B >::time_type phy::header< B >::time_get | ( | bool | swapped | ) | const [inline] |
Extract timing information from the PHY header.
Never override this method. Define time_get_impl()
in subclasses instead.
void phy::header< B >::time_set | ( | const time_type & | time, | |
bool | swapped | |||
) | [inline] |
Set the PHY header's timing information.
Never override this method. Define time_set_impl()
in subclasses instead.
bool phy::header< B >::eq_80211 | ( | const pcapxx::frame_descriptor< D1 > & | lhs, | |
const pcapxx::frame_descriptor< D2 > & | rhs, | |||
tool::endian::endianness | phy_end = tool::endian::guess | |||
) | [inline, static] |
Compare the IEEE 802.11 bytes beyond the PHY header.
Return whether the two IEEE 802.11 frames embedded inside the PHY headers are equals. This function does not compare the PHY headers.
In case there is not enough bytes to decide whether frames are equal (caplen < sizeof prism::header), consider they are not. This is a conservative approach: when merging two traces, this will lead to both frames having their entry in the merged trace.
This method relies on decapsulate()
. You should not need to override it if your subclasses define a proper decapsulate_impl()
.
bool phy::header< B >::eq_time_and_80211 | ( | const pcapxx::frame_descriptor< D1 > & | lhs, | |
const pcapxx::frame_descriptor< D2 > & | rhs, | |||
tool::endian::endianness | phy_end = tool::endian::guess , |
|||
unsigned | precision = phy::eq_time_default_precision | |||
) | [inline, static] |
Compare the IEEE 802.11 bytes beyond PHY headers, but also check timestamps.
Return whether the two IEEE 802.11 frames embedded inside the PHY headers are equals. Also compare the timestamps of PHY headers if available (or the PCAP timestamps else). When the time difference between each header's field is less than precision
, then consider the field equals.
In case there is not enough bytes to decide whether frames are equal (caplen < sizeof prism::header), consider they are not. This is a conservative approach: when merging two traces, this will lead to both frames having their entry in the merged trace.
This method relies on eq_time()
. You should not need to override it if your subclasses define a proper eq_time()
.
const static_base< Bottom >::exact_type & tool::static_base< Bottom >::exact | ( | ) | const [inline, inherited] |
Safely downcast to the exact type as a const reference.
static_base< Bottom >::exact_type & tool::static_base< Bottom >::exact | ( | ) | [inline, inherited] |
Safely downcast to the exact type as a non-const reference.
const static_base< Bottom >::exact_type * tool::static_base< Bottom >::exact_ptr | ( | ) | const [inline, inherited] |
Safely downcast to the exact type as a const pointer.
static_base< Bottom >::exact_type * tool::static_base< Bottom >::exact_ptr | ( | ) | [inline, inherited] |
Safely downcast to the exact type as a non-const pointer.