Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 1 | /* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil -*- */ |
| 2 | /* |
| 3 | * Copyright (c) 2011 University of California, Los Angeles |
| 4 | * |
| 5 | * This program is free software; you can redistribute it and/or modify |
| 6 | * it under the terms of the GNU General Public License version 2 as |
| 7 | * published by the Free Software Foundation; |
| 8 | * |
| 9 | * This program is distributed in the hope that it will be useful, |
| 10 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 11 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 12 | * GNU General Public License for more details. |
| 13 | * |
| 14 | * You should have received a copy of the GNU General Public License |
| 15 | * along with this program; if not, write to the Free Software |
| 16 | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| 17 | * |
| 18 | * Author: Alexander Afanasyev <alexander.afanasyev@ucla.edu> |
| 19 | */ |
| 20 | |
| 21 | #ifndef _CCNX_PIT_ENTRY_H_ |
| 22 | #define _CCNX_PIT_ENTRY_H_ |
| 23 | |
| 24 | #include "ns3/ptr.h" |
Alexander Afanasyev | 11f7bb4 | 2012-07-09 17:06:30 -0700 | [diff] [blame] | 25 | #include "ns3/simple-ref-count.h" |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 26 | |
| 27 | #include "ccnx-pit-entry-incoming-face.h" |
| 28 | #include "ccnx-pit-entry-outgoing-face.h" |
| 29 | #include "ccnx-fib.h" |
| 30 | |
| 31 | #include <boost/multi_index_container.hpp> |
| 32 | #include <boost/multi_index/tag.hpp> |
| 33 | #include <boost/multi_index/ordered_index.hpp> |
Alexander Afanasyev | 9a98970 | 2012-06-29 17:44:00 -0700 | [diff] [blame] | 34 | // #include <boost/multi_index/composite_key.hpp> |
| 35 | // #include <boost/multi_index/hashed_index.hpp> |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 36 | #include <boost/multi_index/member.hpp> |
Alexander Afanasyev | 9a98970 | 2012-06-29 17:44:00 -0700 | [diff] [blame] | 37 | // #include <boost/multi_index/mem_fun.hpp> |
Alexander Afanasyev | a46844b | 2011-11-21 19:13:26 -0800 | [diff] [blame] | 38 | #include <set> |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 39 | |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 40 | namespace ns3 { |
| 41 | |
| 42 | class CcnxFace; |
| 43 | class CcnxNameComponents; |
| 44 | |
Alexander Afanasyev | 6315ef7 | 2012-06-01 20:56:31 -0700 | [diff] [blame] | 45 | /// @cond include_hidden |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 46 | namespace __ccnx_private |
| 47 | { |
Alexander Afanasyev | 0a61c34 | 2011-12-06 12:48:55 -0800 | [diff] [blame] | 48 | class i_retx {}; |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 49 | } |
Alexander Afanasyev | 6315ef7 | 2012-06-01 20:56:31 -0700 | [diff] [blame] | 50 | /// @endcond |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 51 | |
| 52 | /** |
| 53 | * \ingroup ccnx |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 54 | * \brief Typedef for indexed face container of CcnxPitEntryOutgoingFace |
| 55 | * |
| 56 | * Indexes: |
| 57 | * - by face (may be it will be possible to replace with just the std::map) |
| 58 | */ |
| 59 | struct CcnxPitEntryOutgoingFaceContainer |
| 60 | { |
Alexander Afanasyev | b4fee8b | 2012-06-06 12:54:26 -0700 | [diff] [blame] | 61 | /// @cond include_hidden |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 62 | typedef boost::multi_index::multi_index_container< |
| 63 | CcnxPitEntryOutgoingFace, |
| 64 | boost::multi_index::indexed_by< |
| 65 | // For fast access to elements using CcnxFace |
| 66 | boost::multi_index::ordered_unique< |
| 67 | boost::multi_index::tag<__ccnx_private::i_face>, |
Alexander Afanasyev | 78cf0c9 | 2011-09-01 19:57:14 -0700 | [diff] [blame] | 68 | boost::multi_index::member<CcnxPitEntryOutgoingFace, Ptr<CcnxFace>, &CcnxPitEntryOutgoingFace::m_face> |
Alexander Afanasyev | 0a61c34 | 2011-12-06 12:48:55 -0800 | [diff] [blame] | 69 | >, |
| 70 | boost::multi_index::ordered_non_unique< |
| 71 | boost::multi_index::tag<__ccnx_private::i_retx>, |
| 72 | boost::multi_index::member<CcnxPitEntryOutgoingFace, uint32_t, &CcnxPitEntryOutgoingFace::m_retxCount> |
| 73 | > |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 74 | > |
| 75 | > type; |
Alexander Afanasyev | b4fee8b | 2012-06-06 12:54:26 -0700 | [diff] [blame] | 76 | /// @endcond |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 77 | }; |
| 78 | |
| 79 | |
| 80 | /** |
| 81 | * \ingroup ccnx |
| 82 | * \brief structure for PIT entry |
| 83 | */ |
Alexander Afanasyev | 11f7bb4 | 2012-07-09 17:06:30 -0700 | [diff] [blame] | 84 | struct CcnxPitEntry : SimpleRefCount<CcnxPitEntry> |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 85 | { |
| 86 | public: |
Alexander Afanasyev | f034cbd | 2012-06-29 14:28:31 -0700 | [diff] [blame] | 87 | typedef std::set< CcnxPitEntryIncomingFace > in_container; ///< @brief incoming faces container type |
| 88 | typedef in_container::iterator in_iterator; ///< @brief iterator to incoming faces |
| 89 | |
| 90 | typedef CcnxPitEntryOutgoingFaceContainer::type out_container; ///< @brief outgoing faces container type |
| 91 | typedef out_container::iterator out_iterator; ///< @brief iterator to outgoing faces |
| 92 | |
| 93 | typedef std::set< uint32_t > nonce_container; ///< @brief nonce container type |
| 94 | |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 95 | /** |
| 96 | * \brief PIT entry constructor |
| 97 | * \param prefix Prefix of the PIT entry |
Alexander Afanasyev | 0a61c34 | 2011-12-06 12:48:55 -0800 | [diff] [blame] | 98 | * \param offsetTime Relative time to the current moment, representing PIT entry lifetime |
Alexander Afanasyev | c5a23e2 | 2011-09-07 00:37:36 -0700 | [diff] [blame] | 99 | * \param fibEntry A FIB entry associated with the PIT entry |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 100 | */ |
Alexander Afanasyev | 30f60e3 | 2012-07-10 14:21:16 -0700 | [diff] [blame^] | 101 | CcnxPitEntry (Ptr<const CcnxInterestHeader> header, Ptr<CcnxFibEntry> fibEntry); |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 102 | |
Alexander Afanasyev | 0a61c34 | 2011-12-06 12:48:55 -0800 | [diff] [blame] | 103 | /** |
| 104 | * @brief Update lifetime of PIT entry |
| 105 | * |
| 106 | * This function will update PIT entry lifetime to the maximum of the current lifetime and |
| 107 | * the lifetime Simulator::Now () + offsetTime |
| 108 | * |
| 109 | * @param offsetTime Relative time to the current moment, representing PIT entry lifetime |
| 110 | */ |
| 111 | void |
| 112 | UpdateLifetime (const Time &offsetTime); |
Alexander Afanasyev | b4fee8b | 2012-06-06 12:54:26 -0700 | [diff] [blame] | 113 | |
| 114 | /** |
| 115 | * @brief Get prefix of the PIT entry |
| 116 | */ |
Alexander Afanasyev | 19426ef | 2011-11-23 20:55:28 -0800 | [diff] [blame] | 117 | const CcnxNameComponents & |
| 118 | GetPrefix () const |
Alexander Afanasyev | 0a61c34 | 2011-12-06 12:48:55 -0800 | [diff] [blame] | 119 | { return *m_prefix; } |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 120 | |
Alexander Afanasyev | 09c7deb | 2011-11-23 14:50:10 -0800 | [diff] [blame] | 121 | /** |
| 122 | * @brief Get current expiration time of the record |
| 123 | * |
| 124 | * @returns current expiration time of the record |
| 125 | */ |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 126 | const Time & |
Alexander Afanasyev | a46844b | 2011-11-21 19:13:26 -0800 | [diff] [blame] | 127 | GetExpireTime () const |
| 128 | { return m_expireTime; } |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 129 | |
Alexander Afanasyev | 09c7deb | 2011-11-23 14:50:10 -0800 | [diff] [blame] | 130 | /** |
| 131 | * @brief Set expiration time on record as `expireTime` (absolute time) |
| 132 | * |
| 133 | * @param expireTime absolute simulation time of when the record should expire |
| 134 | */ |
Alexander Afanasyev | a46844b | 2011-11-21 19:13:26 -0800 | [diff] [blame] | 135 | void |
Alexander Afanasyev | 1aeaf92 | 2012-04-23 13:48:09 -0700 | [diff] [blame] | 136 | SetExpireTime (const Time &expireTime); |
Alexander Afanasyev | a46844b | 2011-11-21 19:13:26 -0800 | [diff] [blame] | 137 | |
Alexander Afanasyev | 09c7deb | 2011-11-23 14:50:10 -0800 | [diff] [blame] | 138 | /** |
| 139 | * @brief Check if nonce `nonce` for the same prefix has already been seen |
| 140 | * |
| 141 | * @param nonce Nonce to check |
| 142 | */ |
Alexander Afanasyev | a46844b | 2011-11-21 19:13:26 -0800 | [diff] [blame] | 143 | bool |
| 144 | IsNonceSeen (uint32_t nonce) const |
| 145 | { return m_seenNonces.find (nonce) != m_seenNonces.end (); } |
| 146 | |
Alexander Afanasyev | 09c7deb | 2011-11-23 14:50:10 -0800 | [diff] [blame] | 147 | /** |
| 148 | * @brief Add `nonce` to the list of seen nonces |
| 149 | * |
| 150 | * @param nonce nonce to add to the list of seen nonces |
| 151 | * |
| 152 | * All nonces are stored for the lifetime of the PIT entry |
| 153 | */ |
Alexander Afanasyev | a46844b | 2011-11-21 19:13:26 -0800 | [diff] [blame] | 154 | void |
| 155 | AddSeenNonce (uint32_t nonce) |
| 156 | { m_seenNonces.insert (nonce); } |
| 157 | |
Alexander Afanasyev | 09c7deb | 2011-11-23 14:50:10 -0800 | [diff] [blame] | 158 | /** |
| 159 | * @brief Add `face` to the list of incoming faces |
| 160 | * |
| 161 | * @param face Face to add to the list of incoming faces |
| 162 | * @returns iterator to the added entry |
| 163 | */ |
Alexander Afanasyev | f034cbd | 2012-06-29 14:28:31 -0700 | [diff] [blame] | 164 | in_iterator |
Alexander Afanasyev | a5bbe0e | 2011-11-22 17:28:39 -0800 | [diff] [blame] | 165 | AddIncoming (Ptr<CcnxFace> face); |
| 166 | |
Alexander Afanasyev | 09c7deb | 2011-11-23 14:50:10 -0800 | [diff] [blame] | 167 | /** |
Alexander Afanasyev | 9d313d4 | 2011-11-25 13:36:15 -0800 | [diff] [blame] | 168 | * @brief Remove incoming entry for face `face` |
| 169 | */ |
| 170 | void |
| 171 | RemoveIncoming (Ptr<CcnxFace> face); |
| 172 | |
| 173 | /** |
Alexander Afanasyev | 09c7deb | 2011-11-23 14:50:10 -0800 | [diff] [blame] | 174 | * @brief Clear all incoming faces either after all of them were satisfied or NACKed |
| 175 | */ |
Alexander Afanasyev | a46844b | 2011-11-21 19:13:26 -0800 | [diff] [blame] | 176 | void |
Alexander Afanasyev | a5bbe0e | 2011-11-22 17:28:39 -0800 | [diff] [blame] | 177 | ClearIncoming () |
| 178 | { m_incoming.clear (); } |
| 179 | |
Alexander Afanasyev | 09c7deb | 2011-11-23 14:50:10 -0800 | [diff] [blame] | 180 | /** |
| 181 | * @brief Add `face` to the list of outgoing faces |
| 182 | * |
| 183 | * @param face Face to add to the list of outgoing faces |
| 184 | * @returns iterator to the added entry |
| 185 | */ |
Alexander Afanasyev | f034cbd | 2012-06-29 14:28:31 -0700 | [diff] [blame] | 186 | out_iterator |
Alexander Afanasyev | a5bbe0e | 2011-11-22 17:28:39 -0800 | [diff] [blame] | 187 | AddOutgoing (Ptr<CcnxFace> face); |
Alexander Afanasyev | 09c7deb | 2011-11-23 14:50:10 -0800 | [diff] [blame] | 188 | |
| 189 | /** |
Alexander Afanasyev | 120bf31 | 2011-12-19 01:24:47 -0800 | [diff] [blame] | 190 | * @brief Clear all incoming faces either after all of them were satisfied or NACKed |
| 191 | */ |
| 192 | void |
| 193 | ClearOutgoing () |
| 194 | { m_outgoing.clear (); } |
| 195 | |
| 196 | /** |
Alexander Afanasyev | 09c7deb | 2011-11-23 14:50:10 -0800 | [diff] [blame] | 197 | * @brief Remove all references to face. |
| 198 | * |
| 199 | * This method should be called before face is completely removed from the stack. |
| 200 | * Face is removed from the lists of incoming and outgoing faces |
| 201 | */ |
| 202 | void |
| 203 | RemoveAllReferencesToFace (Ptr<CcnxFace> face); |
| 204 | |
Alexander Afanasyev | 5a59507 | 2011-11-25 14:49:07 -0800 | [diff] [blame] | 205 | /** |
| 206 | * @brief Flag outgoing face as hopeless |
| 207 | */ |
| 208 | void |
Alexander Afanasyev | f034cbd | 2012-06-29 14:28:31 -0700 | [diff] [blame] | 209 | SetWaitingInVain (out_iterator face); |
Alexander Afanasyev | 5a59507 | 2011-11-25 14:49:07 -0800 | [diff] [blame] | 210 | |
| 211 | /** |
| 212 | * @brief Check if all outgoing faces are NACKed |
| 213 | */ |
| 214 | bool |
| 215 | AreAllOutgoingInVain () const; |
Alexander Afanasyev | a7a2b8b | 2011-11-28 18:19:09 -0800 | [diff] [blame] | 216 | |
Alexander Afanasyev | b4fee8b | 2012-06-06 12:54:26 -0700 | [diff] [blame] | 217 | /** |
Alexander Afanasyev | a7a2b8b | 2011-11-28 18:19:09 -0800 | [diff] [blame] | 218 | * @brief Similar to AreAllOutgoingInVain, but ignores `face` |
| 219 | * \see AreAllOutgoingInVain |
| 220 | **/ |
| 221 | bool |
| 222 | AreTherePromisingOutgoingFacesExcept (Ptr<CcnxFace> face) const; |
Alexander Afanasyev | 0a61c34 | 2011-12-06 12:48:55 -0800 | [diff] [blame] | 223 | |
| 224 | /** |
| 225 | * @brief Increase maximum limit of allowed retransmission per outgoing face |
| 226 | */ |
| 227 | void |
| 228 | IncreaseAllowedRetxCount (); |
Alexander Afanasyev | 5a59507 | 2011-11-25 14:49:07 -0800 | [diff] [blame] | 229 | |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 230 | private: |
| 231 | friend std::ostream& operator<< (std::ostream& os, const CcnxPitEntry &entry); |
Alexander Afanasyev | 0782718 | 2011-12-13 01:07:32 -0800 | [diff] [blame] | 232 | /** |
| 233 | * \brief Default constructor |
| 234 | */ |
Alexander Afanasyev | f034cbd | 2012-06-29 14:28:31 -0700 | [diff] [blame] | 235 | CcnxPitEntry () {}; |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 236 | |
Alexander Afanasyev | 78cf0c9 | 2011-09-01 19:57:14 -0700 | [diff] [blame] | 237 | public: |
Alexander Afanasyev | 11f7bb4 | 2012-07-09 17:06:30 -0700 | [diff] [blame] | 238 | Ptr<const CcnxNameComponents> m_prefix; ///< \brief Prefix of the PIT entry |
| 239 | Ptr<CcnxFibEntry> m_fibEntry; ///< \brief FIB entry related to this prefix |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 240 | |
Alexander Afanasyev | f034cbd | 2012-06-29 14:28:31 -0700 | [diff] [blame] | 241 | nonce_container m_seenNonces; ///< \brief map of nonces that were seen for this prefix |
| 242 | in_container m_incoming; ///< \brief container for incoming interests |
| 243 | out_container m_outgoing; ///< \brief container for outgoing interests |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 244 | |
| 245 | Time m_expireTime; ///< \brief Time when PIT entry will be removed |
Alexander Afanasyev | 0a61c34 | 2011-12-06 12:48:55 -0800 | [diff] [blame] | 246 | |
Alexander Afanasyev | 7f3e49e | 2012-04-30 00:17:07 -0700 | [diff] [blame] | 247 | Time m_lastRetransmission; ///< @brief Last time when number of retransmissions were increased |
Alexander Afanasyev | 0a61c34 | 2011-12-06 12:48:55 -0800 | [diff] [blame] | 248 | uint32_t m_maxRetxCount; ///< @brief Maximum allowed number of retransmissions via outgoing faces |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 249 | }; |
| 250 | |
Alexander Afanasyev | a95b739 | 2012-03-09 10:54:10 -0800 | [diff] [blame] | 251 | std::ostream& operator<< (std::ostream& os, const CcnxPitEntry &entry); |
| 252 | |
Alexander Afanasyev | a98cdd2 | 2011-08-29 17:32:37 -0700 | [diff] [blame] | 253 | } // namespace ns3 |
| 254 | |
| 255 | #endif // _CCNX_PIT_ENTRY_H_ |