inet::Ipv4Socket Class Reference

This class implements a raw IPv4 socket. More...

#include <Ipv4Socket.h>

Inheritance diagram for inet::Ipv4Socket:

Classes
class	ICallback

Public Member Functions
	Ipv4Socket (cGate *outputGate=nullptr)
virtual	~Ipv4Socket ()
void	setOutputGate (cGate *outputGate)
	Sets the gate on which to send raw packets. More...
virtual void	setCallback (INetworkSocket::ICallback *callback) override
	Sets a callback object, to be used with processMessage(). More...
void *	getUserData () const
void	setUserData (void *userData)
virtual int	getSocketId () const override
	Returns the socket Id which is unique within the network node. More...
virtual const Protocol *	getNetworkProtocol () const override
	Returns the associated network protocol used to deliver datagrams by this socket. More...
virtual bool	belongsToSocket (cMessage *msg) const override
	Returns true if the message belongs to this socket. More...
virtual void	processMessage (cMessage *msg) override
	Examines the message, takes ownership, and updates socket state. More...
virtual void	bind (const Protocol *protocol, Ipv4Address localAddress)
virtual void	connect (Ipv4Address remoteAddress)
virtual void	send (Packet *packet) override
virtual void	sendTo (Packet *packet, Ipv4Address destAddress)
virtual void	close () override
	Closes this socket releasing all resources. More...
virtual void	destroy () override
	Notify the protocol that the owner of ISocket has destroyed the socket. More...
virtual bool	isOpen () const override
Public Member Functions inherited from inet::ISocket
virtual	~ISocket ()

Protected Member Functions
void	sendToOutput (cMessage *message)
virtual void	bind (const Protocol *protocol, L3Address localAddress) override
	Binds this socket to the given protocol and local address. More...
virtual void	connect (L3Address remoteAddress) override
	Connects to a remote socket. More...
virtual void	sendTo (Packet *packet, L3Address destAddress) override
	Sends a packet to the given remote address using the associated network protocol. More...

Protected Attributes
bool	bound = false
bool	isOpen_ = false
int	socketId = -1
INetworkSocket::ICallback *	callback = nullptr
void *	userData = nullptr
cGate *	outputGate = nullptr

Detailed Description

This class implements a raw IPv4 socket.

Constructor & Destructor Documentation

Ipv4Socket()

inet::Ipv4Socket::Ipv4Socket

(

cGate *

outputGate = nullptr

)

                                        :
    socketId(getEnvir()->getUniqueNumber()),
    outputGate(outputGate)
{
}

~Ipv4Socket()

virtual inet::Ipv4Socket::~Ipv4Socket ( )

inlinevirtual

{}

Member Function Documentation

belongsToSocket()

bool inet::Ipv4Socket::belongsToSocket ( cMessage *  msg ) const

overridevirtual

Returns true if the message belongs to this socket.

Implements inet::ISocket.

{
    auto& tags = check_and_cast<ITaggedObject *>(msg)->getTags();
    int msgSocketId = tags.getTag<SocketInd>()->getSocketId();
    return socketId == msgSocketId;
}

Referenced by processMessage().

bind() [1/2]

void inet::Ipv4Socket::bind ( const Protocol *  protocol, Ipv4Address  localAddress  )

virtual

{
    ASSERT(!bound);
    Ipv4SocketBindCommand *command = new Ipv4SocketBindCommand();
    command->setProtocol(protocol);
    command->setLocalAddress(localAddress);
    auto request = new Request("bind", IPv4_C_BIND);
    request->setControlInfo(command);
    sendToOutput(request);
    bound = true;
    isOpen_ = true;
}

Referenced by inet::TunnelApp::initialize().

bind() [2/2]

virtual void inet::Ipv4Socket::bind ( const Protocol *  protocol, L3Address  localAddress  )

inlineoverrideprotectedvirtual

Binds this socket to the given protocol and local address.

All incoming packets matching the given parameters will be delivered via the callback interface.

Implements inet::INetworkSocket.

{ bind(protocol, localAddress.toIpv4()); }

Referenced by bind().

close()

void inet::Ipv4Socket::close ( )

overridevirtual

Closes this socket releasing all resources.

Once closed, a closed socket may be bound to another (or the same) protocol, and reused.

Implements inet::INetworkSocket.

{
    ASSERT(bound);
    Ipv4SocketCloseCommand *command = new Ipv4SocketCloseCommand();
    auto request = new Request("close", IPv4_C_CLOSE);
    request->setControlInfo(command);
    sendToOutput(request);
}

Referenced by inet::TunnelApp::handleStopOperation().

connect() [1/2]

void inet::Ipv4Socket::connect ( Ipv4Address  remoteAddress )

virtual

{
    Ipv4SocketConnectCommand *command = new Ipv4SocketConnectCommand();
    command->setRemoteAddress(remoteAddress);
    auto request = new Request("connect", IPv4_C_CONNECT);
    request->setControlInfo(command);
    sendToOutput(request);
    isOpen_ = true;
}

connect() [2/2]

virtual void inet::Ipv4Socket::connect ( L3Address  remoteAddress )

inlineoverrideprotectedvirtual

Connects to a remote socket.

The socket will only receive packets from the specified address, and you can use send() as opposed to sendTo() to send packets.

Implements inet::INetworkSocket.

{ connect(remoteAddress.toIpv4()); }

Referenced by connect().

destroy()

void inet::Ipv4Socket::destroy ( )

overridevirtual

Notify the protocol that the owner of ISocket has destroyed the socket.

Typically used when the owner of ISocket has crashed.

Implements inet::ISocket.

{
    ASSERT(bound);
    auto command = new Ipv4SocketDestroyCommand();
    auto request = new Request("destroy", IPv4_C_DESTROY);
    request->setControlInfo(command);
    sendToOutput(request);
}

Referenced by inet::TunnelApp::handleCrashOperation().

getNetworkProtocol()

virtual const Protocol* inet::Ipv4Socket::getNetworkProtocol ( ) const

inlineoverridevirtual

Returns the associated network protocol used to deliver datagrams by this socket.

Implements inet::INetworkSocket.

{ return &Protocol::ipv4; }

getSocketId()

virtual int inet::Ipv4Socket::getSocketId ( ) const

inlineoverridevirtual

Returns the socket Id which is unique within the network node.

Implements inet::ISocket.

{ return socketId; }

Referenced by belongsToSocket().

getUserData()

void* inet::Ipv4Socket::getUserData ( ) const

inline

{ return userData; }

isOpen()

virtual bool inet::Ipv4Socket::isOpen ( ) const

inlineoverridevirtual

Implements inet::ISocket.

{ return isOpen_; }

Referenced by inet::TunnelApp::handleMessageWhenUp().

processMessage()

void inet::Ipv4Socket::processMessage ( cMessage *  msg )

overridevirtual

Examines the message, takes ownership, and updates socket state.

Implements inet::ISocket.

{
    ASSERT(belongsToSocket(msg));
    switch (msg->getKind()) {
        case IPv4_I_DATA:
            if (callback)
                callback->socketDataArrived(this, check_and_cast<Packet *>(msg));
            else
                delete msg;
            break;
        case IPv4_I_SOCKET_CLOSED:
            check_and_cast<Indication *>(msg);
            isOpen_ = false;
            bound = false;
            if (callback)
                callback->socketClosed(this);
            delete msg;
            break;
        default:
            throw cRuntimeError("Ipv4Socket: invalid msg kind %d, one of the IPv4_I_xxx constants expected", msg->getKind());
            break;
    }
}

send()

void inet::Ipv4Socket::send ( Packet *  packet )

overridevirtual

Implements inet::ISocket.

{
    sendToOutput(packet);
}

Referenced by sendTo(), and inet::TunnelApp::socketDataArrived().

sendTo() [1/2]

void inet::Ipv4Socket::sendTo ( Packet *  packet, Ipv4Address  destAddress  )

virtual

{
    auto addressReq = packet->addTagIfAbsent<L3AddressReq>();
    addressReq->setDestAddress(destAddress);
    send(packet);
}

sendTo() [2/2]

virtual void inet::Ipv4Socket::sendTo ( Packet *  packet, L3Address  remoteAddress  )

inlineoverrideprotectedvirtual

Sends a packet to the given remote address using the associated network protocol.

Implements inet::INetworkSocket.

{ sendTo(packet, destAddress.toIpv4()); }

Referenced by sendTo().

sendToOutput()

void inet::Ipv4Socket::sendToOutput ( cMessage *  message )

protected

{
    if (!outputGate)
        throw cRuntimeError("Ipv4Socket: setOutputGate() must be invoked before the socket can be used");
    auto& tags = check_and_cast<ITaggedObject *>(message)->getTags();
    tags.addTagIfAbsent<DispatchProtocolReq>()->setProtocol(&Protocol::ipv4);
    tags.addTagIfAbsent<SocketReq>()->setSocketId(socketId);
    check_and_cast<cSimpleModule *>(outputGate->getOwnerModule())->send(message, outputGate);
}

Referenced by bind(), close(), connect(), destroy(), and send().

setCallback()

void inet::Ipv4Socket::setCallback ( INetworkSocket::ICallback *  callback )

overridevirtual

Sets a callback object, to be used with processMessage().

This callback object may be your simple module itself (if it multiply inherits from ICallback too, that is you declared it as

class MyAppModule : public cSimpleModule, public ICallback

and redefined the necessary virtual functions; or you may use dedicated class (and objects) for this purpose.

Sockets don't delete the callback object in the destructor or on any other occasion.

Implements inet::INetworkSocket.

{
    this->callback = callback;
}

Referenced by inet::TunnelApp::initialize().

setOutputGate()

void inet::Ipv4Socket::setOutputGate ( cGate *  outputGate )

inline

Sets the gate on which to send raw packets.

Must be invoked before socket can be used. Example: socket.setOutputGate(gate("ipOut"));

{ this->outputGate = outputGate; }

Referenced by inet::TunnelApp::initialize().

setUserData()

void inet::Ipv4Socket::setUserData ( void *  userData )

inline

{ this->userData = userData; }

Member Data Documentation

bound

bool inet::Ipv4Socket::bound = false

protected

Referenced by bind(), close(), destroy(), and processMessage().

callback

INetworkSocket::ICallback* inet::Ipv4Socket::callback = nullptr

protected

Referenced by processMessage(), and setCallback().

isOpen_

bool inet::Ipv4Socket::isOpen_ = false

protected

Referenced by bind(), connect(), and processMessage().

outputGate

cGate* inet::Ipv4Socket::outputGate = nullptr

protected

Referenced by sendToOutput().

socketId

int inet::Ipv4Socket::socketId = -1

protected

Referenced by belongsToSocket(), and sendToOutput().

userData

void* inet::Ipv4Socket::userData = nullptr

protected

---

The documentation for this class was generated from the following files:

• Ipv4Socket.h
• Ipv4Socket.cc