/usr/include/ns3.17/ns3/ie-dot11s-preq.h is in libns3-dev 3.17+dfsg-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 | /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
* Copyright (c) 2008,2009 IITP RAS
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 as
* published by the Free Software Foundation;
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
* Author: Kirill Andreev <andreev@iitp.ru>
*/
#ifndef WIFI_PREQ_INFORMATION_ELEMENT_H
#define WIFI_PREQ_INFORMATION_ELEMENT_H
#include <vector>
#include "ns3/mac48-address.h"
#include "ns3/mesh-information-element-vector.h"
namespace ns3 {
namespace dot11s {
/**
* \ingroup dot11s
* \brief Describes an address unit in PREQ information element
* See 7.3.2.96 for more details
*/
class DestinationAddressUnit : public SimpleRefCount<DestinationAddressUnit>
{
public:
DestinationAddressUnit ();
void SetFlags (bool doFlag, bool rfFlag, bool usnFlag);
void SetDestinationAddress (Mac48Address dest_address);
void SetDestSeqNumber (uint32_t dest_seq_number);
bool IsDo ();
bool IsRf ();
bool IsUsn ();
Mac48Address GetDestinationAddress () const;
uint32_t GetDestSeqNumber () const;
private:
bool m_do;
bool m_rf;
bool m_usn;
Mac48Address m_destinationAddress;
uint32_t m_destSeqNumber;
friend bool operator== (const DestinationAddressUnit & a, const DestinationAddressUnit & b);
};
/**
* \ingroup dot11s
* \brief See 7.3.2.96 of 802.11s draft 2.07
*/
class IePreq : public WifiInformationElement
{
public:
IePreq ();
~IePreq ();
/**
* Add a destination address unit: flags, destination and sequence
* number
*/
void AddDestinationAddressElement (
bool doFlag,
bool rfFlag,
Mac48Address dest_address,
uint32_t dest_seq_number
);
/// Delete a destination address unit by destination
void DelDestinationAddressElement (Mac48Address dest_address);
/// Clear PREQ: remove all destinations
void ClearDestinationAddressElements ();
/// Get all destinations, which are stored in PREQ:
std::vector<Ptr<DestinationAddressUnit> > GetDestinationList ();
/// SetProper flags which indicate that PREQ is unicast
void SetUnicastPreq ();
/*
* \brief In proactive case: need we send PREP
*/
void SetNeedNotPrep ();
///\name Setters for fields:
///\{
void SetHopcount (uint8_t hopcount);
void SetTTL (uint8_t ttl);
void SetPreqID (uint32_t id);
void SetOriginatorAddress (Mac48Address originator_address);
void SetOriginatorSeqNumber (uint32_t originator_seq_number);
void SetLifetime (uint32_t lifetime);
void SetMetric (uint32_t metric);
void SetDestCount (uint8_t dest_count);
///\}
///\name Getters for fields:
///\{
bool IsUnicastPreq () const;
bool IsNeedNotPrep () const;
uint8_t GetHopCount () const;
uint8_t GetTtl () const;
uint32_t GetPreqID () const;
Mac48Address GetOriginatorAddress () const;
uint32_t GetOriginatorSeqNumber () const;
uint32_t GetLifetime () const;
uint32_t GetMetric () const;
uint8_t GetDestCount () const;
///\}
/// Handle TTL and Metric:
void DecrementTtl ();
void IncrementMetric (uint32_t metric);
/*
* \brief Checks that preq's originator address equals to originator, and
* this preq is not proactive
*/
bool MayAddAddress (Mac48Address originator);
bool IsFull () const;
/**
* \name Inherited from WifiInformationElement
* \{
*/
virtual WifiInformationElementId ElementId () const;
virtual void SerializeInformationField (Buffer::Iterator i) const;
virtual uint8_t DeserializeInformationField (Buffer::Iterator i, uint8_t length);
virtual uint8_t GetInformationFieldSize () const;
virtual void Print (std::ostream& os) const;
///\}
private:
/**
* how many destinations we support
*/
uint8_t m_maxSize; //TODO: make as an attribute
/**
* Fields of information element:
*/
uint8_t m_flags;
uint8_t m_hopCount;
uint8_t m_ttl;
uint32_t m_preqId;
Mac48Address m_originatorAddress;
uint32_t m_originatorSeqNumber;
uint32_t m_lifetime;
uint32_t m_metric;
uint8_t m_destCount;
std::vector<Ptr<DestinationAddressUnit> > m_destinations;
friend bool operator== (const IePreq & a, const IePreq & b);
};
bool operator== (const DestinationAddressUnit & a, const DestinationAddressUnit & b);
bool operator== (const IePreq & a, const IePreq & b);
std::ostream &operator << (std::ostream &os, const IePreq &preq);
} // namespace dot11s
} // namespace ns3
#endif
|