pcpp::SipRequestLayer Class Reference

#include <SipLayer.h>

Inheritance diagram for pcpp::SipRequestLayer:

Public Types
enum	SipMethod {   SipINVITE, SipACK, SipBYE, SipCANCEL,   SipREGISTER, SipPRACK, SipOPTIONS, SipSUBSCRIBE,   SipNOTIFY, SipPUBLISH, SipINFO, SipREFER,   SipMESSAGE, SipUPDATE, SipMethodUnknown }

Public Member Functions
	SipRequestLayer (uint8_t *data, size_t dataLen, Layer *prevLayer, Packet *packet)
	SipRequestLayer (SipMethod method, std::string requestUri, std::string version="SIP/2.0")
	SipRequestLayer (const SipRequestLayer &other)
SipRequestLayer &	operator= (const SipRequestLayer &other)
SipRequestFirstLine *	getFirstLine ()
std::string	toString ()
Public Member Functions inherited from pcpp::SipLayer
int	getContentLength ()
HeaderField *	setContentLength (int contentLength, const std::string prevFieldName="")
OsiModelLayer	getOsiModelLayer ()
void	parseNextLayer ()
void	computeCalculateFields ()
Public Member Functions inherited from pcpp::TextBasedProtocolMessage
HeaderField *	getFieldByName (std::string fieldName, int index=0)
HeaderField *	getFirstField ()
HeaderField *	getNextField (HeaderField *prevField)
int	getFieldCount ()
virtual HeaderField *	addField (const std::string &fieldName, const std::string &fieldValue)
virtual HeaderField *	addField (const HeaderField &newField)
HeaderField *	addEndOfHeader ()
virtual HeaderField *	insertField (HeaderField *prevField, const std::string &fieldName, const std::string &fieldValue)
virtual HeaderField *	insertField (std::string prevFieldName, const std::string &fieldName, const std::string &fieldValue)
virtual HeaderField *	insertField (HeaderField *prevField, const HeaderField &newField)
bool	removeField (HeaderField *fieldToRemove)
bool	removeField (std::string fieldName, int index=0)
bool	isHeaderComplete ()
size_t	getHeaderLen ()
Public Member Functions inherited from pcpp::Layer
virtual	~Layer ()
Layer *	getNextLayer ()
Layer *	getPrevLayer ()
ProtocolType	getProtocol ()
uint8_t *	getData ()
size_t	getDataLen ()
uint8_t *	getLayerPayload ()
size_t	getLayerPayloadSize ()
bool	isAllocatedToPacket ()
void	copyData (uint8_t *toArr)
uint8_t *	getDataPtr (size_t offset=0)

Detailed Description

Represents a SIP request header and inherits all basic functionality of SipLayer and TextBasedProtocolMessage. The functionality that is added for this class is the SIP first line concept. A SIP request has the following first line: INVITE sip:bla@b.nosp@m.la.c.nosp@m.om:12345 SIP/2.0 Since it's not an "ordinary" header field, it requires a special treatment and gets a class of it's own: SipRequestFirstLine. In most cases a SIP request will be contained in a single packet but for cases it is not, only the first packet will be identified as SIP request layer. You can find out whether the header is complete by using SipLayer::isHeaderComplete()

Member Enumeration Documentation

SipMethod

enum pcpp::SipRequestLayer::SipMethod

SIP request methods

Enumerator
SipINVITE	INVITE
SipACK	ACK
SipBYE	BYE
SipCANCEL	CANCEL
SipREGISTER	REFISTER
SipPRACK	PRACK
SipOPTIONS	OPTIONS
SipSUBSCRIBE	SUBSCRIBE
SipNOTIFY	NOTIFY
SipPUBLISH	PUBLISH
SipINFO	INFO
SipREFER	REFER
SipMESSAGE	MESSAGE
SipUPDATE	UPDATE
SipMethodUnknown	Unknown SIP method

Constructor & Destructor Documentation

SipRequestLayer() [1/3]

pcpp::SipRequestLayer::SipRequestLayer	(	uint8_t *	data,
		size_t	dataLen,
		Layer *	prevLayer,
		Packet *	packet
	)

A constructor that creates the layer from an existing packet raw data

Parameters

[in]	data	A pointer to the raw data
[in]	dataLen	Size of the data in bytes
[in]	prevLayer	A pointer to the previous layer
[in]	packet	A pointer to the Packet instance where layer will be stored in

SipRequestLayer() [2/3]

pcpp::SipRequestLayer::SipRequestLayer	(	SipMethod	method,
		std::string	requestUri,
		std::string	version = "SIP/2.0"
	)

A constructor that allocates a new SIP request with only the first line filled. The request will be created without further fields. The user can then add fields using addField() or insertField() methods

Parameters

[in]	method	The SIP method to be used in this SIP request
[in]	requestUri	The URI of the request
[in]	version	SIP version to be used in this request. Default is "SIP/2.0"

SipRequestLayer() [3/3]

pcpp::SipRequestLayer::SipRequestLayer

(

const SipRequestLayer &

other

)

A copy constructor for this layer. Inherits base copy constructor SipLayer and adds the functionality of copying the first line

Parameters

[in]

other

The instance to copy from

Member Function Documentation

getFirstLine()

SipRequestFirstLine* pcpp::SipRequestLayer::getFirstLine ( )

inline

Returns

A pointer to the first line instance for this message

operator=()

SipRequestLayer& pcpp::SipRequestLayer::operator=

(

const SipRequestLayer &

other

)

An assignment operator overload for this layer. This method inherits base assignment operator SipLayer::operator=() and adds the functionality of copying the first line

Parameters

[in]

other

The instance to copy from

toString()

std::string pcpp::SipRequestLayer::toString ( )

virtual

Returns

A string representation of the layer most important data (should look like the layer description in Wireshark)

Implements pcpp::Layer.