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 }
	SIP request methods. More...

Public Member Functions
	SipRequestLayer (uint8_t *data, size_t dataLen, Layer *prevLayer, Packet *packet)
	SipRequestLayer (SipMethod method, const std::string &requestUri, const std::string &version="SIP/2.0")
	SipRequestLayer (const SipRequestLayer &other)
SipRequestLayer &	operator= (const SipRequestLayer &other)
SipRequestFirstLine *	getFirstLine () const
std::string	toString () const override
Public Member Functions inherited from pcpp::SipLayer
int	getContentLength () const
HeaderField *	setContentLength (int contentLength, const std::string &prevFieldName="")
OsiModelLayer	getOsiModelLayer () const override
void	parseNextLayer () override
void	computeCalculateFields () override
Public Member Functions inherited from pcpp::TextBasedProtocolMessage
HeaderField *	getFieldByName (std::string fieldName, int index=0) const
HeaderField *	getFirstField () const
HeaderField *	getNextField (HeaderField *prevField) const
int	getFieldCount () const
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 () const
void	parseNextLayer () override
	Currently set only PayloadLayer for the rest of the data.
size_t	getHeaderLen () const override
void	computeCalculateFields () override
	Does nothing for this class.
Public Member Functions inherited from pcpp::Layer
	~Layer () override
Layer *	getNextLayer () const
Layer *	getPrevLayer () const
ProtocolType	getProtocol () const
bool	isMemberOfProtocolFamily (ProtocolTypeFamily protocolTypeFamily) const
uint8_t *	getData () const
size_t	getDataLen () const
uint8_t *	getLayerPayload () const
size_t	getLayerPayloadSize () const
bool	isAllocatedToPacket () const
void	copyData (uint8_t *toArr) const
uint8_t *	getDataPtr (size_t offset=0) const override

Additional Inherited Members
Static Public Member Functions inherited from pcpp::SipLayer
static bool	isSipPort (uint16_t port)

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,
		const std::string &	requestUri,
		const 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 ( ) const

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 ( ) const

overridevirtual

Returns

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

Implements pcpp::Layer.