/* -*-  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/wifi-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 WifiElementId ElementId () const;

  virtual void SerializeInformation (Buffer::Iterator i) const;

  virtual uint8_t DeserializeInformation (Buffer::Iterator i, uint8_t length);

  virtual uint8_t GetInformationSize () const;

  virtual void Print (std::ostream& os) const;

  ///\}

private:

  /**

   * how many destinations we support

   */

  /**

   * 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