/usr/include/ns3.27/ns3/ie-dot11s-beacon-timing.h is in libns3-dev 3.27+dfsg-1.
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 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 | /* -*- 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_TIMING_ELEMENT_H
#define WIFI_TIMING_ELEMENT_H
#include <vector>
#include "ns3/nstime.h"
#include "ns3/mesh-information-element-vector.h"
namespace ns3 {
namespace dot11s {
/**
* \ingroup dot11s
* \brief Information element describing one unit of beacon timing element
*/
class IeBeaconTimingUnit : public SimpleRefCount<IeBeaconTimingUnit>
{
public:
IeBeaconTimingUnit ();
/**
* Set AID value
* \param aid the AID
*/
void SetAid (uint8_t aid);
/**
* Set last beacon value
* \param lastBeacon the last beacon
*/
void SetLastBeacon (uint16_t lastBeacon);
/**
* Set beacon interval value
* \param beaconInterval the beacon interval
*/
void SetBeaconInterval (uint16_t beaconInterval);
/**
* Get AID value
* \returns the AID
*/
uint8_t GetAid () const;
/**
* Get last beacon value
* \returns the last beacon
*/
uint16_t GetLastBeacon () const;
/**
* Get beacon interval
* \returns the beacon interval
*/
uint16_t GetBeaconInterval () const;
private:
/// Least significant octet of AID:
uint8_t m_aid;
/// Last time we received a beacon in accordance with a local TSF measured in 256 microseconds unit
uint16_t m_lastBeacon;
/// Beacon interval of remote mesh point
uint16_t m_beaconInterval;
/**
* equality operator
*
* \param a lhs
* \param b rhs
* \returns true if equal
*/
friend bool operator== (const IeBeaconTimingUnit & a, const IeBeaconTimingUnit & b);
};
/**
* \ingroup dot11s
* \brief See 7.3.2.89 of 802.11s draft 2.07
*/
class IeBeaconTiming : public WifiInformationElement
{
public:
/**
* \ingroup dot11s
* This type is a list of timing elements obtained from neighbours with their beacons:
*/
typedef std::vector< Ptr<IeBeaconTimingUnit> > NeighboursTimingUnitsList;
IeBeaconTiming ();
/**
* This methods are needed for beacon collision
* avoidance module:
* \returns the neighbor timing elements list
*/
NeighboursTimingUnitsList GetNeighboursTimingElementsList ();
/**
* Add neighbors timing element unit
* \param aid the AID
* \param last_beacon the last beacon time
* \param beacon_interval the beacon interval
*/
void AddNeighboursTimingElementUnit (
uint16_t aid,
Time last_beacon,
Time beacon_interval
);
/**
* Delete neighbors timing element unit
* \param aid the AID
* \param last_beacon the last beacon time
* \param beacon_interval the beacon interval
*/
void DelNeighboursTimingElementUnit (
uint16_t aid,
Time last_beacon,
Time beacon_interval
);
/// Clear timing element
void ClearTimingElement ();
// Inherited from WifiInformationElement
virtual WifiInformationElementId ElementId () const;
virtual uint8_t GetInformationFieldSize () const;
virtual void SerializeInformationField (Buffer::Iterator i) const;
virtual uint8_t DeserializeInformationField (Buffer::Iterator i, uint8_t length);
virtual void Print (std::ostream& os) const;
/**
* equality operator
*
* \param a lhs
* \returns true if equal
*/
bool operator== (WifiInformationElement const & a) const;
private:
// Converters:
/**
* Timestamp to U16 function
* \param x the timestamp
* \returns the U16
*/
static uint16_t TimestampToU16 (Time x);
/**
* Beacon interval to U16 function
* \param x the beacon interval
* \returns the U16
*/
static uint16_t BeaconIntervalToU16 (Time x);
/**
* Aid to U8 function
* \param x the U16
* \returns the AID
*/
static uint8_t AidToU8 (uint16_t x);
NeighboursTimingUnitsList m_neighbours; ///< the neighbors
/**
* Timing element parameters:
*/
uint16_t m_numOfUnits;
};
bool operator== (const IeBeaconTimingUnit & a, const IeBeaconTimingUnit & b);
std::ostream &operator << (std::ostream &os, const IeBeaconTiming &beaconTiming);
} // namespace dot11s
} // namespace ns3
#endif
|