INET Framework for OMNeT++/OMNEST
inet::PacketDestreamer Class Reference

#include <PacketDestreamer.h>

Inheritance diagram for inet::PacketDestreamer:
inet::queueing::PacketProcessorBase inet::queueing::IPacketFlow inet::queueing::IPacketProcessor inet::StringFormat::IDirectiveResolver inet::queueing::IPacketSink inet::queueing::IPacketSource inet::queueing::IPassivePacketSink inet::queueing::IActivePacketSink inet::queueing::IPassivePacketSource inet::queueing::IActivePacketSource inet::EthernetCutthroughSource

Public Member Functions

virtual ~PacketDestreamer ()
 
virtual IPassivePacketSinkgetConsumer (cGate *gate) override
 Returns the passive packet sink where packets are pushed or nullptr if the connected module doesn't implement the interface. More...
 
virtual IPassivePacketSourcegetProvider (cGate *gate) override
 Returns the passive packet source from where packets are pulled or nullptr if the connected module doesn't implement the interface. More...
 
virtual bool supportsPacketPushing (cGate *gate) const override
 Returns true if the processor supports pushing packets at the given gate. More...
 
virtual bool supportsPacketPulling (cGate *gate) const override
 Returns true if the processor supports pulling packets at the given gate. More...
 
virtual bool supportsPacketPassing (cGate *gate) const override
 Returns true if the processor supports passing packets as a whole at the given gate. More...
 
virtual bool supportsPacketStreaming (cGate *gate) const override
 Returns true if the processor supports streaming packets at the given gate. More...
 
virtual bool canPushSomePacket (cGate *gate) const override
 Returns false if the packet sink is full at the given gate and no more packets can be pushed into it without raising an error. More...
 
virtual bool canPushPacket (Packet *packet, cGate *gate) const override
 Returns true if the given packet can be pushed at the given gate into the packet sink without raising an error. More...
 
virtual void pushPacket (Packet *packet, cGate *gate) override
 Pushes the packet into the packet sink at the given gate. More...
 
virtual void pushPacketStart (Packet *packet, cGate *gate, bps datarate) override
 Starts pushing the packet into the packet sink at the given gate. More...
 
virtual void pushPacketEnd (Packet *packet, cGate *gate) override
 Ends pushing the packet into the packet sink at the given gate. More...
 
virtual void pushPacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength=b(0)) override
 Progresses pushing the packet into the packet sink at the given gate. More...
 
virtual void handleCanPushPacketChanged (cGate *gate) override
 Notifies about a change in the possibility of pushing some packet into the passive packet sink at the given gate. More...
 
virtual void handlePushPacketProcessed (Packet *packet, cGate *gate, bool successful) override
 Notifies about the completion of the packet processing for a packet that was pushed earlier independently whether the packet is passed or streamed. More...
 
virtual bool canPullSomePacket (cGate *gate) const override
 Returns false if the packet source is empty at the given gate and no more packets can be pulled from it without raising an error. More...
 
virtual PacketcanPullPacket (cGate *gate) const override
 Returns the packet that can be pulled at the given gate. More...
 
virtual PacketpullPacket (cGate *gate) override
 Pulls the packet from the packet source at the given gate. More...
 
virtual PacketpullPacketStart (cGate *gate, bps datarate) override
 Starts pulling the packet from the packet source at the given gate. More...
 
virtual PacketpullPacketEnd (cGate *gate) override
 Ends pulling the packet from the packet source at the given gate. More...
 
virtual PacketpullPacketProgress (cGate *gate, bps datarate, b position, b extraProcessableLength) override
 Progresses pulling the packet from the packet source at the given gate. More...
 
virtual void handlePullPacketProcessed (Packet *packet, cGate *gate, bool successful) override
 Notifies about the completion of the packet processing for a packet that was pulled earlier independently whether the packet is passed or streamed. More...
 
virtual void handleCanPullPacketChanged (cGate *gate) override
 Notifies about a change in the possibility of pulling some packet from the passive packet source at the given gate. More...
 
- Public Member Functions inherited from inet::queueing::PacketProcessorBase
virtual bool supportsPacketSending (cGate *gate) const override
 Returns true if the processor supports sending packets at the given gate. More...
 
virtual const char * resolveDirective (char directive) const override
 
- Public Member Functions inherited from inet::queueing::IPacketProcessor
virtual ~IPacketProcessor ()
 
- Public Member Functions inherited from inet::queueing::IPassivePacketSink
virtual ~IPassivePacketSink ()
 
- Public Member Functions inherited from inet::queueing::IActivePacketSink
virtual ~IActivePacketSink ()
 
- Public Member Functions inherited from inet::queueing::IPassivePacketSource
virtual ~IPassivePacketSource ()
 
- Public Member Functions inherited from inet::queueing::IActivePacketSource
virtual ~IActivePacketSource ()
 

Protected Member Functions

virtual void initialize (int stage) override
 
virtual void handleMessage (cMessage *message) override
 
virtual bool isStreaming () const
 
- Protected Member Functions inherited from inet::queueing::PacketProcessorBase
virtual int numInitStages () const override
 
virtual void refreshDisplay () const override
 
virtual void handlePacketProcessed (Packet *packet)
 
virtual void checkPacketOperationSupport (cGate *gate) const
 
virtual void checkPacketOperationSupport (cGate *startGate, cGate *endGate) const
 
virtual void animate (Packet *packet, cGate *gate, const SendOptions &sendOptions, Action action) const
 
virtual void animatePacket (Packet *packet, cGate *gate, Action action) const
 
virtual void animatePacketStart (Packet *packet, cGate *gate, bps datarate, long transmissionId, Action action) const
 
virtual void animatePacketStart (Packet *packet, cGate *gate, bps datarate, const SendOptions &sendOptions, Action action) const
 
virtual void animatePacketEnd (Packet *packet, cGate *gate, long transmissionId, Action action) const
 
virtual void animatePacketEnd (Packet *packet, cGate *gate, const SendOptions &sendOptions, Action action) const
 
virtual void animatePacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength, long transmissionId, Action action) const
 
virtual void animatePacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength, const SendOptions &sendOptions, Action action) const
 
virtual void pushOrSendPacket (Packet *packet, cGate *gate, IPassivePacketSink *consumer)
 
virtual void pushOrSendPacketStart (Packet *packet, cGate *gate, IPassivePacketSink *consumer, bps datarate, int transmissionId)
 
virtual void pushOrSendPacketEnd (Packet *packet, cGate *gate, IPassivePacketSink *consumer, int transmissionId)
 
virtual void pushOrSendPacketProgress (Packet *packet, cGate *gate, IPassivePacketSink *consumer, bps datarate, b position, b extraProcessableLength, int transmissionId)
 
virtual void animatePush (Packet *packet, cGate *gate, const SendOptions &sendOptions) const
 
virtual void animatePushPacket (Packet *packet, cGate *gate) const
 
virtual void animatePushPacketStart (Packet *packet, cGate *gate, bps datarate, long transmissionId) const
 
virtual void animatePushPacketStart (Packet *packet, cGate *gate, bps datarate, const SendOptions &sendOptions) const
 
virtual void animatePushPacketEnd (Packet *packet, cGate *gate, long transmissionId) const
 
virtual void animatePushPacketEnd (Packet *packet, cGate *gate, const SendOptions &sendOptions) const
 
virtual void animatePushPacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength, long transmissionId) const
 
virtual void animatePushPacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength, const SendOptions &sendOptions) const
 
virtual void animatePull (Packet *packet, cGate *gate, const SendOptions &sendOptions) const
 
virtual void animatePullPacket (Packet *packet, cGate *gate) const
 
virtual void animatePullPacketStart (Packet *packet, cGate *gate, bps datarate, long transmissionId) const
 
virtual void animatePullPacketStart (Packet *packet, cGate *gate, bps datarate, const SendOptions &sendOptions) const
 
virtual void animatePullPacketEnd (Packet *packet, cGate *gate, long transmissionId) const
 
virtual void animatePullPacketEnd (Packet *packet, cGate *gate, const SendOptions &sendOptions) const
 
virtual void animatePullPacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength, long transmissionId) const
 
virtual void animatePullPacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength, const SendOptions &sendOptions) const
 
virtual void dropPacket (Packet *packet, PacketDropReason reason, int limit=-1)
 
virtual void updateDisplayString () const
 

Protected Attributes

bps datarate
 
cGate * inputGate = nullptr
 
IActivePacketSourceproducer = nullptr
 
IPassivePacketSourceprovider = nullptr
 
cGate * outputGate = nullptr
 
IPassivePacketSinkconsumer = nullptr
 
IActivePacketSinkcollector = nullptr
 
bps streamDatarate = bps(NaN)
 
PacketstreamedPacket = nullptr
 
- Protected Attributes inherited from inet::queueing::PacketProcessorBase
const char * displayStringTextFormat = nullptr
 
int numProcessedPackets = -1
 
b processedTotalLength = b(-1)
 

Additional Inherited Members

- Protected Types inherited from inet::queueing::PacketProcessorBase
enum  Action { PUSH, PULL }
 

Constructor & Destructor Documentation

◆ ~PacketDestreamer()

inet::PacketDestreamer::~PacketDestreamer ( )
virtual
17 {
18  delete streamedPacket;
19  streamedPacket = nullptr;
20 }

Member Function Documentation

◆ canPullPacket()

Packet * inet::PacketDestreamer::canPullPacket ( cGate *  gate) const
overridevirtual

Returns the packet that can be pulled at the given gate.

The returned value is nullptr if there is no such packet.

The gate must be a valid gate of this module and it must support pushing packets.

Implements inet::queueing::IPassivePacketSource.

111 {
112  return isStreaming() ? nullptr : provider->canPullPacket(inputGate->getPathStartGate());
113 }

◆ canPullSomePacket()

bool inet::PacketDestreamer::canPullSomePacket ( cGate *  gate) const
overridevirtual

Returns false if the packet source is empty at the given gate and no more packets can be pulled from it without raising an error.

The gate must be a valid gate of this module and it must support pulling packets.

Implements inet::queueing::IPassivePacketSource.

106 {
107  return !isStreaming() && provider->canPullSomePacket(inputGate->getPathStartGate());
108 }

◆ canPushPacket()

bool inet::PacketDestreamer::canPushPacket ( Packet packet,
cGate *  gate 
) const
overridevirtual

Returns true if the given packet can be pushed at the given gate into the packet sink without raising an error.

The packet must not be nullptr. The gate must be a valid gate of this module and it must support pushing packets.

Implements inet::queueing::IPassivePacketSink.

52 {
53  return !isStreaming() && consumer->canPushPacket(packet, outputGate->getPathEndGate());
54 }

◆ canPushSomePacket()

bool inet::PacketDestreamer::canPushSomePacket ( cGate *  gate) const
overridevirtual

Returns false if the packet sink is full at the given gate and no more packets can be pushed into it without raising an error.

The gate must be a valid gate of this module and it must support pushing packets.

Implements inet::queueing::IPassivePacketSink.

47 {
48  return !isStreaming() && consumer->canPushSomePacket(outputGate->getPathEndGate());
49 }

◆ getConsumer()

virtual IPassivePacketSink* inet::PacketDestreamer::getConsumer ( cGate *  gate)
inlineoverridevirtual

Returns the passive packet sink where packets are pushed or nullptr if the connected module doesn't implement the interface.

The gate parameter must be a valid gate of this module.

Implements inet::queueing::IActivePacketSource.

43 { return this; }

◆ getProvider()

virtual IPassivePacketSource* inet::PacketDestreamer::getProvider ( cGate *  gate)
inlineoverridevirtual

Returns the passive packet source from where packets are pulled or nullptr if the connected module doesn't implement the interface.

The gate parameter must be a valid gate of this module.

Implements inet::queueing::IActivePacketSink.

44 { return this; }

◆ handleCanPullPacketChanged()

void inet::PacketDestreamer::handleCanPullPacketChanged ( cGate *  gate)
overridevirtual

Notifies about a change in the possibility of pulling some packet from the passive packet source at the given gate.

This method is called, for example, when a new packet is inserted into a queue. It allows the sink to pull a new packet from the queue.

The gate parameter must be a valid gate of this module.

Implements inet::queueing::IActivePacketSink.

144 {
145  Enter_Method("handleCanPullPacketChanged");
146  if (collector != nullptr)
147  collector->handleCanPullPacketChanged(outputGate->getPathEndGate());
148 }

◆ handleCanPushPacketChanged()

void inet::PacketDestreamer::handleCanPushPacketChanged ( cGate *  gate)
overridevirtual

Notifies about a change in the possibility of pushing some packet into the passive packet sink at the given gate.

This method is called, for example, when a new packet can be inserted into a queue. It allows the source to push a new packet into the queue.

The gate parameter must be a valid gate of this module.

Implements inet::queueing::IActivePacketSource.

92 {
93  Enter_Method("handleCanPushPacketChanged");
94  if (producer != nullptr)
95  producer->handleCanPushPacketChanged(inputGate->getPathStartGate());
96 }

◆ handleMessage()

void inet::PacketDestreamer::handleMessage ( cMessage *  message)
overrideprotectedvirtual

Reimplemented in inet::EthernetCutthroughSource.

41 {
42  auto packet = check_and_cast<Packet *>(message);
43  pushPacket(packet, packet->getArrivalGate());
44 }

Referenced by inet::EthernetCutthroughSource::handleMessage().

◆ handlePullPacketProcessed()

void inet::PacketDestreamer::handlePullPacketProcessed ( Packet packet,
cGate *  gate,
bool  successful 
)
overridevirtual

Notifies about the completion of the packet processing for a packet that was pulled earlier independently whether the packet is passed or streamed.

This method is called, for example, when a previously pulled packet is failed to be processed successfully. It allows the sink to retry the operation.

The gate parameter must be a valid gate of this module. The packet must not be nullptr.

Implements inet::queueing::IActivePacketSink.

137 {
138  Enter_Method("handlePullPacketConfirmation");
139  if (collector != nullptr)
140  collector->handlePullPacketProcessed(packet, gate, successful);
141 }

◆ handlePushPacketProcessed()

void inet::PacketDestreamer::handlePushPacketProcessed ( Packet packet,
cGate *  gate,
bool  successful 
)
overridevirtual

Notifies about the completion of the packet processing for a packet that was pushed earlier independently whether the packet is passed or streamed.

This method is called, for example, when a previously pushed packet is failed to be processed successfully. It allows the source to retry the operation.

The gate parameter must be a valid gate of this module. The packet must not be nullptr.

Implements inet::queueing::IActivePacketSource.

99 {
100  Enter_Method("handlePushPacketProcessed");
101  if (producer != nullptr)
102  producer->handlePushPacketProcessed(packet, inputGate->getPathStartGate(), successful);
103 }

◆ initialize()

void inet::PacketDestreamer::initialize ( int  stage)
overrideprotectedvirtual

Reimplemented from inet::queueing::PacketProcessorBase.

Reimplemented in inet::EthernetCutthroughSource.

23 {
25  if (stage == INITSTAGE_LOCAL) {
26  datarate = bps(par("datarate"));
27  inputGate = gate("in");
28  outputGate = gate("out");
29  producer = findConnectedModule<IActivePacketSource>(inputGate);
30  provider = findConnectedModule<IPassivePacketSource>(inputGate);
31  consumer = findConnectedModule<IPassivePacketSink>(outputGate);
32  collector = findConnectedModule<IActivePacketSink>(outputGate);
33  }
34  else if (stage == INITSTAGE_QUEUEING) {
37  }
38 }

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

◆ isStreaming()

virtual bool inet::PacketDestreamer::isStreaming ( ) const
inlineprotectedvirtual

◆ pullPacket()

Packet * inet::PacketDestreamer::pullPacket ( cGate *  gate)
overridevirtual

Pulls the packet from the packet source at the given gate.

This operation pulls the packet as a whole. The onwership of the packet is transferred to the sink.

The source must not be empty at the given gate. The returned packet must not be nullptr. The gate must be a valid gate of this module and it must support pulling and passing packets.

Implements inet::queueing::IPassivePacketSource.

116 {
117  Enter_Method("pullPacket");
118  ASSERT(!isStreaming());
120  auto packet = provider->pullPacketStart(inputGate->getPathStartGate(), streamDatarate);
121  EV_INFO << "Starting destreaming packet" << EV_FIELD(packet) << EV_ENDL;
122  take(packet);
123  streamedPacket = packet;
124  packet = provider->pullPacketEnd(inputGate->getPathStartGate());
125  EV_INFO << "Ending destreaming packet" << EV_FIELD(packet) << EV_ENDL;
126  take(packet);
127  delete streamedPacket;
128  streamedPacket = packet;
129  handlePacketProcessed(packet);
132  streamedPacket = nullptr;
133  return packet;
134 }

◆ pullPacketEnd()

virtual Packet* inet::PacketDestreamer::pullPacketEnd ( cGate *  gate)
inlineoverridevirtual

Ends pulling the packet from the packet source at the given gate.

This is a packet streaming operation. The onwership of the packet is transferred to the sink.

Packet streaming can be started with any of the streaming operations, and ends when the streaming position plus the extra processable packet length equals to the total packet length.

This method is called, for example, when a preemption supporting server module ends streaming a packet from the the source.

The source must not be empty at the gate and no other packet streaming can be in progress. The gate must be a valid gate of this module and it must support pulling and streaming packets. The returned packet must not be nullptr.

Implements inet::queueing::IPassivePacketSource.

67 { throw cRuntimeError("Invalid operation"); }

◆ pullPacketProgress()

virtual Packet* inet::PacketDestreamer::pullPacketProgress ( cGate *  gate,
bps  datarate,
b  position,
b  extraProcessableLength 
)
inlineoverridevirtual

Progresses pulling the packet from the packet source at the given gate.

This is a packet streaming operation. The position specifies where the packet streaming is at the moment. The extra length parameter partially fixes the future of the packet streaming operation. The onwership of the packet is transferred to the sink.

Packet streaming can be started with any of the streaming operations, and ends when the streaming position plus the extra processable packet length equals to the total packet length.

This method is called, for example, to notify the source about a change in the packet data when a preemption occurs.

The source must not be empty at the gate and no other packet streaming can be in progress. The gate must be a valid gate of this module and it must support pulling and streaming packets. The returned packet must not be nullptr.

Implements inet::queueing::IPassivePacketSource.

68 { throw cRuntimeError("Invalid operation"); }

◆ pullPacketStart()

virtual Packet* inet::PacketDestreamer::pullPacketStart ( cGate *  gate,
bps  datarate 
)
inlineoverridevirtual

Starts pulling the packet from the packet source at the given gate.

This is a packet streaming operation. The onwership of the packet is transferred to the sink.

Packet streaming can be started with any of the streaming operations, and ends when the streaming position plus the extra processable packet length equals to the total packet length.

This method is called, for example, when a preemption supporting server module starts streaming a packet from the source.

The source must not be empty at the gate and no other packet streaming can be in progress. The gate must be a valid gate of this module and it must support pulling and streaming packets. The returned packet must not be nullptr.

Implements inet::queueing::IPassivePacketSource.

66 { throw cRuntimeError("Invalid operation"); }

◆ pushPacket()

virtual void inet::PacketDestreamer::pushPacket ( Packet packet,
cGate *  gate 
)
inlineoverridevirtual

Pushes the packet into the packet sink at the given gate.

This operation pushes the packet as a whole. The onwership of the packet is transferred to the sink.

This method is called, for example, when a packet source module pushes a packet into a queue module.

The sink must not be full at the gate. The packet must not be nullptr. The gate must be a valid gate of this module and it must support pushing and passing packets.

Implements inet::queueing::IPassivePacketSink.

53 { throw cRuntimeError("Invalid operation"); }

Referenced by handleMessage().

◆ pushPacketEnd()

void inet::PacketDestreamer::pushPacketEnd ( Packet packet,
cGate *  gate 
)
overridevirtual

Ends pushing the packet into the packet sink at the given gate.

This is a packet streaming operation. The onwership of the packet is transferred to the sink.

Packet streaming can be started with any of the streaming operations, and ends when the streaming position plus the extra processable packet length equals to the total packet length.

This method is called, for example, when a preemption supporting server module ends streaming a packet to the sink.

The sink must not be full at the gate and no other packet streaming can be in progress. The packet must not be nullptr. The gate must be a valid gate of this module and it must support pushing and streaming packets.

Implements inet::queueing::IPassivePacketSink.

Reimplemented in inet::EthernetCutthroughSource.

66 {
67  Enter_Method("pushPacketEnd");
68  take(packet);
69  delete streamedPacket;
70  streamedPacket = packet;
72  auto packetLength = streamedPacket->getTotalLength();
73  EV_INFO << "Ending destreaming packet" << EV_FIELD(packet, *streamedPacket) << EV_ENDL;
75  streamedPacket = nullptr;
77  processedTotalLength += packetLength;
79 }

Referenced by inet::EthernetCutthroughSource::pushPacketEnd().

◆ pushPacketProgress()

void inet::PacketDestreamer::pushPacketProgress ( Packet packet,
cGate *  gate,
bps  datarate,
b  position,
b  extraProcessableLength = b(0) 
)
overridevirtual

Progresses pushing the packet into the packet sink at the given gate.

This is a packet streaming operation. The position specifies where the packet streaming is at the moment. The extra length parameter partially fixes the future of the packet streaming operation. The onwership of the packet is transferred to the sink.

Packet streaming can be started with any of the streaming operations, and ends when the streaming position plus the extra processable packet length equals to the total packet length.

This method is called, for example, to notify the sink about a change in the packet data when a preemption occurs.

The sink must not be full at the gate and no other packet streaming can be in progress. The packet must not be nullptr. The gate must be a valid gate of this module and it must support pushing and streaming packets.

Implements inet::queueing::IPassivePacketSink.

82 {
83  Enter_Method("pushPacketProgress");
84  take(packet);
85  delete streamedPacket;
86  streamedPacket = packet;
88  EV_INFO << "Progressing destreaming" << EV_FIELD(packet, *streamedPacket) << EV_ENDL;
89 }

◆ pushPacketStart()

void inet::PacketDestreamer::pushPacketStart ( Packet packet,
cGate *  gate,
bps  datarate 
)
overridevirtual

Starts pushing the packet into the packet sink at the given gate.

This is a packet streaming operation. The onwership of the packet is transferred to the sink.

Packet streaming can be started with any of the streaming operations, and ends when the streaming position plus the extra processable packet length equals to the total packet length.

This method is called, for example, when a preemption supporting server module starts streaming a packet to the sink.

The sink must not be full at the gate and no other packet streaming can be in progress. The packet must not be nullptr. The gate must be a valid gate of this module and it must support pushing and streaming packets.

Implements inet::queueing::IPassivePacketSink.

Reimplemented in inet::EthernetCutthroughSource.

57 {
58  Enter_Method("pushPacketStart");
59  take(packet);
60  streamedPacket = packet;
62  EV_INFO << "Starting destreaming packet" << EV_FIELD(packet, *streamedPacket) << EV_ENDL;
63 }

Referenced by inet::EthernetCutthroughSource::handleMessage().

◆ supportsPacketPassing()

virtual bool inet::PacketDestreamer::supportsPacketPassing ( cGate *  gate) const
inlineoverridevirtual

Returns true if the processor supports passing packets as a whole at the given gate.

A passed packet is handed over from one module to another by either the standard OMNeT++ handleMessage() mechanism, or by directly calling pushPacket() or pullPacket().

For example, packets are passed as a whole to and from a queue module.

Connecting incompatible gates raises an error during initialize. The gate parameter must be a valid gate of this module. The gate should be marked with @labels(pass) in the NED file.

Reimplemented from inet::queueing::PacketProcessorBase.

48 { return gate == outputGate; }

◆ supportsPacketPulling()

virtual bool inet::PacketDestreamer::supportsPacketPulling ( cGate *  gate) const
inlineoverridevirtual

Returns true if the processor supports pulling packets at the given gate.

Pulling a packet is a synchronous operation that is initiated by the sink module. A pulled packet can be passed as a whole using pullPacket(), or it can be streamed from the source to the sink using pullPacketStart(), pullPacketEnd(), and pullPacketProgress().

For output gates, true means that the connected module can pull packets from this module. For input gates, true means that this module can pull packets from the connected module. For example, a packet server module can pull packets from a queue module.

Connecting incompatible gates raises an error during initialize. The gate parameter must be a valid gate of this module. The gate should be marked with @labels(pull) in the NED file.

Implements inet::queueing::IPacketProcessor.

47 { return true; }

◆ supportsPacketPushing()

virtual bool inet::PacketDestreamer::supportsPacketPushing ( cGate *  gate) const
inlineoverridevirtual

Returns true if the processor supports pushing packets at the given gate.

Pushing a packet is a synchronous operation that is initiated by the source module. A pushed packet can be passed as a whole using pushPacket(), or it can be streamed from the source to the sink using pushPacketStart(), pushPacketEnd(), and pushPacketProgress().

For output gates, true means that this module can push packets into the connected module. For input gates, true means that the connected module can push packets into this module. For example, a packet generator module can push packets into a queue module.

Connecting incompatible gates raises an error during initialize. The gate parameter must be a valid gate of this module. The gate should be marked with @labels(push) in the NED file.

Implements inet::queueing::IPacketProcessor.

46 { return true; }

◆ supportsPacketStreaming()

virtual bool inet::PacketDestreamer::supportsPacketStreaming ( cGate *  gate) const
inlineoverridevirtual

Returns true if the processor supports streaming packets at the given gate.

A streamed packet is handed over from one module to another using several method calls and potentially exending to a non-zero simulation duration.

For example, packets are streamed to a preemptable signal transmitter module.

Connecting incompatible gates raises an error during initialize. The gate parameter must be a valid gate of this module. The gate should be marked with @labels(stream) in the NED file.

Reimplemented from inet::queueing::PacketProcessorBase.

49 { return gate == inputGate; }

Member Data Documentation

◆ collector

IActivePacketSink* inet::PacketDestreamer::collector = nullptr
protected

◆ consumer

IPassivePacketSink* inet::PacketDestreamer::consumer = nullptr
protected

◆ datarate

◆ inputGate

cGate* inet::PacketDestreamer::inputGate = nullptr
protected

◆ outputGate

◆ producer

IActivePacketSource* inet::PacketDestreamer::producer = nullptr
protected

◆ provider

IPassivePacketSource* inet::PacketDestreamer::provider = nullptr
protected

◆ streamDatarate

◆ streamedPacket


The documentation for this class was generated from the following files:
inet::queueing::PacketProcessorBase::initialize
virtual void initialize(int stage) override
Definition: PacketProcessorBase.cc:16
inet::PacketDestreamer::collector
IActivePacketSink * collector
Definition: PacketDestreamer.h:29
inet::queueing::PacketProcessorBase::pushOrSendPacket
virtual void pushOrSendPacket(Packet *packet, cGate *gate, IPassivePacketSink *consumer)
Definition: PacketProcessorBase.cc:126
inet::queueing::IPassivePacketSink::canPushPacket
virtual bool canPushPacket(Packet *packet, cGate *gate) const =0
Returns true if the given packet can be pushed at the given gate into the packet sink without raising...
inet::queueing::PacketProcessorBase::animatePullPacket
virtual void animatePullPacket(Packet *packet, cGate *gate) const
Definition: PacketProcessorBase.cc:355
inet::units::units::bps
compose< b, pow< s, -1 > > bps
Definition: Units.h:1169
inet::INITSTAGE_QUEUEING
INET_API InitStage INITSTAGE_QUEUEING
Initialization of queueing modules.
inet::queueing::IPassivePacketSource::canPullPacket
virtual Packet * canPullPacket(cGate *gate) const =0
Returns the packet that can be pulled at the given gate.
inet::queueing::IPassivePacketSink::canPushSomePacket
virtual bool canPushSomePacket(cGate *gate) const =0
Returns false if the packet sink is full at the given gate and no more packets can be pushed into it ...
inet::PacketDestreamer::streamDatarate
bps streamDatarate
Definition: PacketDestreamer.h:31
inet::queueing::PacketProcessorBase::handlePacketProcessed
virtual void handlePacketProcessed(Packet *packet)
Definition: PacketProcessorBase.cc:34
inet::queueing::PacketProcessorBase::processedTotalLength
b processedTotalLength
Definition: PacketProcessorBase.h:31
inet::PacketDestreamer::datarate
bps datarate
Definition: PacketDestreamer.h:21
inet::PacketDestreamer::pushPacket
virtual void pushPacket(Packet *packet, cGate *gate) override
Pushes the packet into the packet sink at the given gate.
Definition: PacketDestreamer.h:53
inet::PacketDestreamer::inputGate
cGate * inputGate
Definition: PacketDestreamer.h:23
EV_FIELD
#define EV_FIELD(...)
Definition: INETDefs.h:112
inet::PacketDestreamer::streamedPacket
Packet * streamedPacket
Definition: PacketDestreamer.h:32
inet::PacketDestreamer::isStreaming
virtual bool isStreaming() const
Definition: PacketDestreamer.h:38
inet::PacketDestreamer::provider
IPassivePacketSource * provider
Definition: PacketDestreamer.h:25
inet::PacketDestreamer::outputGate
cGate * outputGate
Definition: PacketDestreamer.h:27
inet::INITSTAGE_LOCAL
INET_API InitStage INITSTAGE_LOCAL
Initialization of local state that don't use or affect other modules includes:
inet::queueing::PacketProcessorBase::numProcessedPackets
int numProcessedPackets
Definition: PacketProcessorBase.h:30
inet::queueing::IActivePacketSource::handleCanPushPacketChanged
virtual void handleCanPushPacketChanged(cGate *gate)=0
Notifies about a change in the possibility of pushing some packet into the passive packet sink at the...
inet::Packet::getTotalLength
b getTotalLength() const
Returns the total packet length ignoring front and back offsets.
Definition: Packet.h:193
inet::queueing::IActivePacketSource::handlePushPacketProcessed
virtual void handlePushPacketProcessed(Packet *packet, cGate *gate, bool successful)=0
Notifies about the completion of the packet processing for a packet that was pushed earlier independe...
inet::queueing::PacketProcessorBase::updateDisplayString
virtual void updateDisplayString() const
Definition: PacketProcessorBase.cc:399
inet::queueing::PacketProcessorBase::checkPacketOperationSupport
virtual void checkPacketOperationSupport(cGate *gate) const
Definition: PacketProcessorBase.cc:40
Enter_Method
#define Enter_Method(...)
Definition: SelfDoc.h:71
inet::queueing::IPassivePacketSource::pullPacketEnd
virtual Packet * pullPacketEnd(cGate *gate)=0
Ends pulling the packet from the packet source at the given gate.
inet::queueing::IPassivePacketSource::pullPacketStart
virtual Packet * pullPacketStart(cGate *gate, bps datarate)=0
Starts pulling the packet from the packet source at the given gate.
inet::queueing::IActivePacketSink::handlePullPacketProcessed
virtual void handlePullPacketProcessed(Packet *packet, cGate *gate, bool successful)=0
Notifies about the completion of the packet processing for a packet that was pulled earlier independe...
inet::queueing::IPassivePacketSource::canPullSomePacket
virtual bool canPullSomePacket(cGate *gate) const =0
Returns false if the packet source is empty at the given gate and no more packets can be pulled from ...
EV_ENDL
#define EV_ENDL
Definition: INETDefs.h:114
inet::PacketDestreamer::producer
IActivePacketSource * producer
Definition: PacketDestreamer.h:24
inet::PacketDestreamer::consumer
IPassivePacketSink * consumer
Definition: PacketDestreamer.h:28
inet::queueing::IActivePacketSink::handleCanPullPacketChanged
virtual void handleCanPullPacketChanged(cGate *gate)=0
Notifies about a change in the possibility of pulling some packet from the passive packet source at t...