Public Member Functions | |
bool | Fail (void) const |
bool | Eof (void) const |
void | Clear (void) |
void | Open (std::string const &filename, std::ios::openmode mode) |
void | Close (void) |
void | Init (uint32_t dataLinkType, uint32_t snapLen=std::numeric_limits< uint32_t >::max(), int32_t tzCorrection=PcapFile::ZONE_DEFAULT) |
void | Write (Time t, Ptr< const Packet > p) |
Write the next packet to file. | |
void | Write (Time t, Header &header, Ptr< const Packet > p) |
Write the provided header along with the packet to the pcap file. | |
void | Write (Time t, uint8_t const *buffer, uint32_t length) |
Write the provided data buffer to the pcap file. | |
uint32_t | GetMagic (void) |
uint16_t | GetVersionMajor (void) |
uint16_t | GetVersionMinor (void) |
int32_t | GetTimeZoneOffset (void) |
uint32_t | GetSigFigs (void) |
uint32_t | GetSnapLen (void) |
uint32_t | GetDataLinkType (void) |
Static Public Member Functions | |
static TypeId | GetTypeId (void) |
This method returns the TypeId associated to ns3::PcapFileWrapper. |
void ns3::PcapFileWrapper::Clear | ( | void | ) |
Clear all state bits of the underlying iostream.
void ns3::PcapFileWrapper::Close | ( | void | ) |
Close the underlying pcap file.
bool ns3::PcapFileWrapper::Eof | ( | void | ) | const |
bool ns3::PcapFileWrapper::Fail | ( | void | ) | const |
static TypeId ns3::PcapFileWrapper::GetTypeId | ( | void | ) | [static] |
This method returns the TypeId associated to ns3::PcapFileWrapper.
This object is accessible through the following paths with Config::Set and Config::Connect:
Attributes defined for this type:
No TraceSources defined for this type.
Reimplemented from ns3::Object.
void ns3::PcapFileWrapper::Init | ( | uint32_t | dataLinkType, | |
uint32_t | snapLen = std::numeric_limits< uint32_t >::max() , |
|||
int32_t | tzCorrection = PcapFile::ZONE_DEFAULT | |||
) |
Initialize the pcap file associated with this wrapper. This file must have been previously opened with write permissions.
dataLinkType | A data link type as defined in the pcap library. If you want to make resulting pcap files visible in existing tools, the data link type must match existing definitions, such as PCAP_ETHERNET, PCAP_PPP, PCAP_80211, etc. If you are storing different kinds of packet data, such as naked TCP headers, you are at liberty to locally define your own data link types. According to the pcap-linktype man page, "well-known" pcap linktypes range from 0 to 177. If you use a large random number for your type, chances are small for a collision. | |
snapLen | An optional maximum size for packets written to the file. Defaults to 65535. If packets exceed this length they are truncated. | |
tzCorrection | An integer describing the offset of your local time zone from UTC/GMT. For example, Pacific Standard Time in the US is GMT-8, so one would enter -8 for that correction. Defaults to 0 (UTC). |
void ns3::PcapFileWrapper::Open | ( | std::string const & | filename, | |
std::ios::openmode | mode | |||
) |
Create a new pcap file or open an existing pcap file. Semantics are similar to the stdc++ io stream classes.
Since a pcap file is always a binary file, the file type is automatically selected as a binary file (fstream::binary is automatically ored with the mode field).
filename | String containing the name of the file. | |
mode | String containing the access mode for the file. |
void ns3::PcapFileWrapper::Write | ( | Time | t, | |
uint8_t const * | buffer, | |||
uint32_t | length | |||
) |
Write the provided header along with the packet to the pcap file.
It is the case that adding a header to a packet prior to writing it to a file must trigger a deep copy in the Packet. By providing the header separately, we can avoid that copy.