Files
unison/src/internet-stack/ipv6-option-header.h
2009-11-15 11:30:20 +01:00

426 lines
9.3 KiB
C++

/* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
/*
* Copyright (c) 2008-2009 Strasbourg University
*
* 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: David Gross <gdavid.devel@gmail.com>
*/
#ifndef IPV6_OPTION_HEADER_H
#define IPV6_OPTION_HEADER_H
#include <ostream>
#include "ns3/header.h"
namespace ns3
{
/**
* \class Ipv6OptionHeader
* \brief Header for IPv6 Option.
*/
class Ipv6OptionHeader : public Header
{
public:
/**
* \struct Alignment
* \brief represents the alignment requirements of an option header
*
* Represented as factor*n+offset (eg. 8n+2) See RFC 2460.
* No alignemt is represented as 1n+0.
*/
struct Alignment
{
uint8_t factor; /**< Factor */
uint8_t offset; /**< Offset */
};
/**
* \brief Get the type identificator.
* \return type identificator
*/
static TypeId GetTypeId ();
/**
* \brief Get the instance type ID.
* \return instance type ID
*/
virtual TypeId GetInstanceTypeId () const;
/**
* \brief Constructor.
*/
Ipv6OptionHeader ();
/**
* \brief Destructor.
*/
virtual ~Ipv6OptionHeader ();
/**
* \brief Set the type of the option.
* \param type the type of the option
*/
void SetType (uint8_t type);
/**
* \brief Get the type of the optionr.
* \return the type of the option
*/
uint8_t GetType () const;
/**
* \brief Set the option length.
* \param length the option length
*/
void SetLength (uint8_t length);
/**
* \brief Get the option length.
* \return the option length
*/
uint8_t GetLength () const;
/**
* \brief Print some informations about the packet.
* \param os output stream
* \return info about this packet
*/
virtual void Print (std::ostream &os) const;
/**
* \brief Get the serialized size of the packet.
* \return size
*/
virtual uint32_t GetSerializedSize () const;
/**
* \brief Serialize the packet.
* \param start Buffer iterator
*/
virtual void Serialize (Buffer::Iterator start) const;
/**
* \brief Deserialize the packet.
* \param start Buffer iterator
* \return size of the packet
*/
virtual uint32_t Deserialize (Buffer::Iterator start);
/**
* \brief Get the Alignment requirement of this option header
* \return The required alignment
*
* Subclasses should only implement this method, if special alignemt is
* required. Default is no alignment (1n+0).
*/
virtual Alignment GetAlignment () const;
private:
/**
* \brief The type of the option.
*/
uint8_t m_type;
/**
* \brief The option length.
*/
uint8_t m_length;
/**
* \brief The anonymous data of this option
*/
Buffer m_data;
};
/**
* \class Ipv6OptionPad1Header
* \brief Header of IPv6 Option Pad1
*/
class Ipv6OptionPad1Header : public Ipv6OptionHeader
{
public:
/**
* \brief Get the type identificator.
* \return type identificator
*/
static TypeId GetTypeId ();
/**
* \brief Get the instance type ID.
* \return instance type ID
*/
virtual TypeId GetInstanceTypeId () const;
/**
* \brief Constructor.
*/
Ipv6OptionPad1Header ();
/**
* \brief Destructor.
*/
virtual ~Ipv6OptionPad1Header ();
/**
* \brief Print some informations about the packet.
* \param os output stream
* \return info about this packet
*/
virtual void Print (std::ostream &os) const;
/**
* \brief Get the serialized size of the packet.
* \return size
*/
virtual uint32_t GetSerializedSize () const;
/**
* \brief Serialize the packet.
* \param start Buffer iterator
*/
virtual void Serialize (Buffer::Iterator start) const;
/**
* \brief Deserialize the packet.
* \param start Buffer iterator
* \return size of the packet
*/
virtual uint32_t Deserialize (Buffer::Iterator start);
};
/**
* \class Ipv6OptionPadnHeader
* \brief Header of IPv6 Option Padn
*/
class Ipv6OptionPadnHeader : public Ipv6OptionHeader
{
public:
/**
* \brief Get the type identificator.
* \return type identificator
*/
static TypeId GetTypeId ();
/**
* \brief Get the instance type ID.
* \return instance type ID
*/
virtual TypeId GetInstanceTypeId () const;
/**
* \brief Constructor.
* \param pad Number of bytes to pad (>=2)
*/
Ipv6OptionPadnHeader (uint32_t pad = 2);
/**
* \brief Destructor.
*/
virtual ~Ipv6OptionPadnHeader ();
/**
* \brief Print some informations about the packet.
* \param os output stream
* \return info about this packet
*/
virtual void Print (std::ostream &os) const;
/**
* \brief Get the serialized size of the packet.
* \return size
*/
virtual uint32_t GetSerializedSize () const;
/**
* \brief Serialize the packet.
* \param start Buffer iterator
*/
virtual void Serialize (Buffer::Iterator start) const;
/**
* \brief Deserialize the packet.
* \param start Buffer iterator
* \return size of the packet
*/
virtual uint32_t Deserialize (Buffer::Iterator start);
};
/**
* \class Ipv6OptionJumbogramHeader
* \brief Header of IPv6 Option Jumbogram
*/
class Ipv6OptionJumbogramHeader : public Ipv6OptionHeader
{
public:
/**
* \brief Get the type identificator.
* \return type identificator
*/
static TypeId GetTypeId ();
/**
* \brief Get the instance type ID.
* \return instance type ID
*/
virtual TypeId GetInstanceTypeId () const;
/**
* \brief Constructor.
*/
Ipv6OptionJumbogramHeader ();
/**
* \brief Destructor.
*/
virtual ~Ipv6OptionJumbogramHeader ();
/**
* \brief Set the data length.
* \param dataLength the data length
*/
void SetDataLength (uint32_t dataLength);
/**
* \brief Get the data length.
* \return the data length
*/
uint32_t GetDataLength () const;
/**
* \brief Print some informations about the packet.
* \param os output stream
* \return info about this packet
*/
virtual void Print (std::ostream &os) const;
/**
* \brief Get the serialized size of the packet.
* \return size
*/
virtual uint32_t GetSerializedSize () const;
/**
* \brief Serialize the packet.
* \param start Buffer iterator
*/
virtual void Serialize (Buffer::Iterator start) const;
/**
* \brief Deserialize the packet.
* \param start Buffer iterator
* \return size of the packet
*/
virtual uint32_t Deserialize (Buffer::Iterator start);
/**
* \brief Get the Alignment requirement of this option header
* \return The required alignment
*/
virtual Alignment GetAlignment () const;
private:
/**
* \brief The data length.
*/
uint32_t m_dataLength;
};
/**
* \class Ipv6OptionRouterAlertHeader
* \brief Header of IPv6 Option Router Alert
*/
class Ipv6OptionRouterAlertHeader : public Ipv6OptionHeader
{
public:
/**
* \brief Get the type identificator.
* \return type identificator
*/
static TypeId GetTypeId ();
/**
* \brief Get the instance type ID.
* \return instance type ID
*/
virtual TypeId GetInstanceTypeId () const;
/**
* \brief Constructor.
*/
Ipv6OptionRouterAlertHeader ();
/**
* \brief Destructor.
*/
virtual ~Ipv6OptionRouterAlertHeader ();
/**
* \brief Set the field "value".
*/
void SetValue (uint16_t value);
/**
* \brief Get the field "value".
* \return the field "value"
*/
uint16_t GetValue () const;
/**
* \brief Print some informations about the packet.
* \param os output stream
* \return info about this packet
*/
virtual void Print (std::ostream &os) const;
/**
* \brief Get the serialized size of the packet.
* \return size
*/
virtual uint32_t GetSerializedSize () const;
/**
* \brief Serialize the packet.
* \param start Buffer iterator
*/
virtual void Serialize (Buffer::Iterator start) const;
/**
* \brief Deserialize the packet.
* \param start Buffer iterator
* \return size of the packet
*/
virtual uint32_t Deserialize (Buffer::Iterator start);
/**
* \brief Get the Alignment requirement of this option header
* \return The required alignment
*/
virtual Alignment GetAlignment () const;
private:
/**
* \brief The value.
*/
uint16_t m_value;
};
} // namespace ns3
#endif /* IPV6_OPTION_HEADER_H */