EMANE  1.2.1
queue.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2015 - Adjacent Link LLC, Bridgewater, New Jersey
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * * Redistributions of source code must retain the above copyright
10  * notice, this list of conditions and the following disclaimer.
11  * * Redistributions in binary form must reproduce the above copyright
12  * notice, this list of conditions and the following disclaimer in
13  * the documentation and/or other materials provided with the
14  * distribution.
15  * * Neither the name of Adjacent Link LLC nor the names of its
16  * contributors may be used to endorse or promote products derived
17  * from this software without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
22  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
23  * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
24  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
25  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
26  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
27  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
29  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30  * POSSIBILITY OF SUCH DAMAGE.
31  */
32 
33 #ifndef EMANEMODELSTDMAQUEUE_HEADER_
34 #define EMANEMODELSTDMAQUEUE_HEADER_
35 
36 #include "emane/types.h"
37 #include "emane/downstreampacket.h"
39 
40 #include <cstdint>
41 #include <map>
42 
43 namespace EMANE
44 {
45  namespace Models
46  {
47  namespace TDMA
48  {
55  class Queue
56  {
57  public:
58  Queue();
59 
60  void initialize(std::uint16_t u16QueueDepth,
61  bool bFragment,
62  bool bAggregate,
63  bool bIsControl);
64 
65  std::pair<std::unique_ptr<DownstreamPacket>,bool>
66  enqueue(DownstreamPacket && pkt);
67 
68  std::tuple<MessageComponents,
69  size_t,
70  std::list<std::unique_ptr<DownstreamPacket>>>
71  dequeue(size_t requestedBytes,NEMId destination,bool bDrop);
72 
73  // packets, bytes
74  std::tuple<size_t,size_t> getStatus() const;
75 
76  private:
77  class MetaInfo
78  {
79  public:
80  size_t index_{};
81  size_t offset_{};
82  };
83  using PacketQueue = std::map<std::uint64_t,
84  std::pair<DownstreamPacket *,MetaInfo *>>;
85  PacketQueue queue_;
86  std::map<NEMId,PacketQueue> destQueue_;
87  std::uint16_t u16QueueDepth_;
88  bool bFragment_;
89  std::uint64_t u64Counter_;
90  size_t currentBytes_;
91  bool bIsControl_;
92  bool bAggregate_;
93 
94  std::pair<MessageComponent,size_t> fragmentPacket(DownstreamPacket * pPacket,
95  MetaInfo * pMetaInfo,
96  std::uint64_t u64Sequence,
97  size_t bytes);
98  };
99  }
100  }
101 }
102 
103 #endif // EMANEMODELSTDMAQUEUE_HEADER_
void initialize(std::uint16_t u16QueueDepth, bool bFragment, bool bAggregate, bool bIsControl)
Definition: queue.cc:43
std::pair< std::unique_ptr< DownstreamPacket >, bool > enqueue(DownstreamPacket &&pkt)
Definition: queue.cc:55
struct EtherAddrBytes bytes
Definition: netutils.h:390
std::tuple< size_t, size_t > getStatus() const
Definition: queue.cc:428
Specialized packet the allows downstream processing to add layer specific headers as the packet trave...
std::list< MessageComponent > MessageComponents
std::uint16_t NEMId
Definition: types.h:52
Downstream packet queue with both FIFO and By-Destination FIFO dequeue mechanisms.
Definition: queue.h:55
std::tuple< MessageComponents, size_t, std::list< std::unique_ptr< DownstreamPacket > > > dequeue(size_t requestedBytes, NEMId destination, bool bDrop)
Definition: queue.cc:127
Definition: agent.h:43