inet::NodeStatus Class Reference

Keeps track of the status of network node (up, down, etc.) for other modules, and also displays it as a small overlay icon on this module and on the module of the network node. More...

#include <NodeStatus.h>

Inheritance diagram for inet::NodeStatus:

Public Types
enum	State { UP, DOWN, GOING_UP, GOING_DOWN }

Public Member Functions
virtual State	getState () const
Public Member Functions inherited from inet::ILifecycle
virtual	~ILifecycle ()

Static Public Attributes
static simsignal_t	nodeStatusChangedSignal = registerSignal("nodeStatusChanged")

Protected Member Functions
virtual int	numInitStages () const override
virtual void	initialize (int stage) override
virtual void	handleMessage (cMessage *msg) override
virtual bool	handleOperationStage (LifecycleOperation *operation, int stage, IDoneCallback *doneCallback) override
	Perform one stage of a lifecycle operation. More...
virtual void	setState (State state)
virtual void	refreshDisplay () const override

Static Protected Member Functions
static State	getStateByName (const char *name)

Private Attributes
State	state
std::string	origIcon

Detailed Description

Keeps track of the status of network node (up, down, etc.) for other modules, and also displays it as a small overlay icon on this module and on the module of the network node.

Other modules can obtain the network node's status by calling the getState() method.

See NED file for more information.

Member Enumeration Documentation

enum inet::NodeStatus::State

Enumerator
UP
DOWN
GOING_UP
GOING_DOWN

{ UP, DOWN, GOING_UP, GOING_DOWN };

Member Function Documentation

virtual State inet::NodeStatus::getState ( ) const

inlinevirtual

Referenced by inet::Define_Module(), inet::power::SimpleEpEnergyManagement::executeNodeOperation(), inet::power::SimpleCcBattery::executeNodeOperation(), inet::power::SimpleEpEnergyStorage::executeNodeOperation(), handleOperationStage(), inet::OperationalBase::initialize(), inet::TelnetApp::initialize(), inet::MACRelayUnit::initialize(), inet::TCPSinkApp::initialize(), inet::TCPSrvHostApp::initialize(), inet::IPvXTrafSink::initialize(), inet::rtp::RTP::initialize(), inet::bgp::BGPRouting::initialize(), inet::ieee80211::Ieee80211MgmtBase::initialize(), inet::TCPGenericSrvApp::initialize(), inet::IPv4NodeConfigurator::initialize(), inet::rtp::RTCP::initialize(), inet::VoIPStreamReceiver::initialize(), inet::Ieee8021dRelay::initialize(), inet::STPBase::initialize(), inet::EtherLLC::initialize(), inet::tcp::TCP_lwIP::initialize(), inet::SimpleVoIPSender::initialize(), inet::VoIPStreamSender::initialize(), inet::DHCPServer::initialize(), inet::tcp::TCP_NSC::initialize(), inet::TED::initialize(), inet::IPvXTrafGen::initialize(), inet::PacketDrillApp::initialize(), inet::DHCPClient::initialize(), inet::ICMPv6::initialize(), inet::httptools::HttpServerBase::initialize(), inet::SCTPServer::initialize(), inet::SCTPClient::initialize(), inet::SCTPPeer::initialize(), inet::SimpleVoIPReceiver::initialize(), inet::httptools::HttpBrowserBase::initialize(), inet::AODVRouting::initialize(), inet::IPv6Tunneling::initialize(), inet::IPv4RoutingTable::initialize(), inet::tcp::TCP::initialize(), inet::IPv6NeighbourDiscovery::initialize(), inet::UDP::initialize(), inet::RIPRouting::initialize(), inet::IPv6::initialize(), inet::RSVP::initialize(), inet::TCPEchoApp::isNodeUp(), inet::MACBase::isNodeUp(), inet::TCPBasicClientApp::isNodeUp(), inet::EtherAppSrv::isNodeUp(), inet::TCPSessionApp::isNodeUp(), inet::EtherTrafGen::isNodeUp(), inet::IPvXTrafGen::isNodeUp(), inet::EtherAppCli::isNodeUp(), inet::ospf::OSPFRouting::isNodeUp(), inet::PingApp::isNodeUp(), inet::GlobalARP::isNodeUp(), inet::ARP::isNodeUp(), inet::GPSR::isNodeUp(), inet::LDP::isNodeUp(), inet::dymo::DYMO::isNodeUp(), inet::IPv4::isNodeUp(), inet::L2NodeConfigurator::receiveSignal(), and inet::power::SimpleEpEnergyManagement::scheduleLifecycleOperationTimer().

{ return state; }

NodeStatus::State inet::NodeStatus::getStateByName ( const char *  name )

staticprotected

Referenced by initialize().

{
    std::string temp = name;
    std::transform(temp.begin(), temp.end(), temp.begin(), ::toupper);
    cEnum *e = cEnum::get("inet::NodeStatus");
    int state = e->lookup(temp.c_str(), -1);
    if (state == -1)
        throw cRuntimeError("Invalid state name '%s'", name);
    return (State)state;
}

virtual void inet::NodeStatus::handleMessage ( cMessage *  msg )

inlineoverrideprotectedvirtual

{ throw cRuntimeError("This module doesn't handle messages"); }

bool inet::NodeStatus::handleOperationStage ( LifecycleOperation *  operation, int  stage, IDoneCallback *  doneCallback  )

overrideprotectedvirtual

Perform one stage of a lifecycle operation.

Processing may be done entirely within this method, or may be a longer process that involves nonzero simulation time or several events, and is triggered by this method call.

Return value: true = "done"; false = "not yet done, will invoke doneCallback when done"

Implements inet::ILifecycle.

{
    Enter_Method_Silent();
    cModule *node = getContainingNode(this);
    if (dynamic_cast<NodeStartOperation *>(operation)) {
        if (opStage == 0) {
            EV << node->getFullPath() << " starting up" << endl;
            if (getState() != DOWN)
                throw cRuntimeError("Current node status is not 'down' at NodeStartOperation");
            setState(GOING_UP);
        }
        // NOTE: this is not an 'else if' so that it works if there's only 1 stage
        if (opStage == operation->getNumStages() - 1) {
            ASSERT(getState() == GOING_UP);
            setState(UP);
            EV << node->getFullPath() << " started" << endl;
            node->bubble("Node started");
        }
    }
    else if (dynamic_cast<NodeShutdownOperation *>(operation)) {
        if (opStage == 0) {
            EV << node->getFullPath() << " shutting down" << endl;
            if (getState() != UP)
                throw cRuntimeError("Current node status is not 'up' at NodeShutdownOperation");
            setState(GOING_DOWN);
        }
        // NOTE: this is not an 'else if' so that it works if there's only 1 stage
        if (opStage == operation->getNumStages() - 1) {
            ASSERT(getState() == GOING_DOWN);
            setState(DOWN);
            EV << node->getFullPath() << " shut down" << endl;
            node->bubble("Node shut down");
        }
    }
    else if (dynamic_cast<NodeCrashOperation *>(operation)) {
        if (opStage == 0) {
            EV << node->getFullPath() << " crashing" << endl;
            if (getState() != UP)
                throw cRuntimeError("Current node status is not 'up' at NodeCrashOperation");
            setState(GOING_DOWN);
        }
        // NOTE: this is not an 'else if' so that it works if there's only 1 stage
        if (opStage == operation->getNumStages() - 1) {
            ASSERT(getState() == GOING_DOWN);
            setState(DOWN);
            EV << node->getFullPath() << " crashed" << endl;
            node->bubble("Node crashed");
        }
    }
    return true;
}

void inet::NodeStatus::initialize ( int  stage )

overrideprotectedvirtual

{
    cSimpleModule::initialize(stage);

    if (stage == INITSTAGE_LOCAL) {
        state = getStateByName(par("initialStatus"));
        origIcon = getDisplayString().getTagArg("i", 0);
    }
}

virtual int inet::NodeStatus::numInitStages ( ) const

inlineoverrideprotectedvirtual

{ return NUM_INIT_STAGES; }

void inet::NodeStatus::refreshDisplay ( ) const

overrideprotectedvirtual

{
    const char *icon;
    switch (state) {
        case UP:
            icon = "";
            break;

        case DOWN:
            icon = "status/cross";
            break;

        case GOING_UP:
            icon = "status/execute";
            break;

        case GOING_DOWN:
            icon = "status/execute";
            break;

        default:
            throw cRuntimeError("Unknown status");
    }
    cModule *node = getContainingNode(this);
    const char *myicon = state == UP ? origIcon.c_str() : icon;
    getDisplayString().setTagArg("i", 0, myicon);
    if (*icon)
        node->getDisplayString().setTagArg("i2", 0, icon);
    else
        node->getDisplayString().removeTag("i2");
}

void inet::NodeStatus::setState ( State  state )

protectedvirtual

Referenced by handleOperationStage().

{
    state = s;
    emit(nodeStatusChangedSignal, this);
}

Member Data Documentation

simsignal_t inet::NodeStatus::nodeStatusChangedSignal = registerSignal("nodeStatusChanged")

static

Referenced by setState().

std::string inet::NodeStatus::origIcon

private

Referenced by initialize(), and refreshDisplay().

State inet::NodeStatus::state

private

Referenced by getStateByName(), initialize(), refreshDisplay(), and setState().

---

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

• NodeStatus.h
• NodeStatus.cc