A Discrete-Event Network Simulator
API
virtual-net-device.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2008,2009 INESC Porto
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: Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
19  */
20 
21 #ifndef VIRTUAL_NET_DEVICE_H
22 #define VIRTUAL_NET_DEVICE_H
23 
24 #include "ns3/address.h"
25 #include "ns3/node.h"
26 #include "ns3/net-device.h"
27 #include "ns3/callback.h"
28 #include "ns3/packet.h"
29 #include "ns3/ptr.h"
30 #include "ns3/traced-callback.h"
31 
32 namespace ns3 {
33 
34 
59 {
60 public:
65  typedef Callback<bool, Ptr<Packet>, const Address&, const Address&, uint16_t> SendCallback;
66 
67  static TypeId GetTypeId (void);
69 
70  virtual ~VirtualNetDevice ();
71 
76  void SetSendCallback (SendCallback transmitCb);
77 
85  void SetNeedsArp (bool needsArp);
86 
93  void SetIsPointToPoint (bool isPointToPoint);
94 
98  void SetSupportsSendFrom (bool supportsSendFrom);
99 
105  bool SetMtu (const uint16_t mtu);
106 
107 
119  bool Receive (Ptr<Packet> packet, uint16_t protocol,
120  const Address &source, const Address &destination,
121  PacketType packetType);
122 
123 
124  // inherited from NetDevice base class.
125  virtual void SetIfIndex (const uint32_t index);
126  virtual uint32_t GetIfIndex (void) const;
127  virtual Ptr<Channel> GetChannel (void) const;
128  virtual void SetAddress (Address address);
129  virtual Address GetAddress (void) const;
130  virtual uint16_t GetMtu (void) const;
131  virtual bool IsLinkUp (void) const;
132  virtual void AddLinkChangeCallback (Callback<void> callback);
133  virtual bool IsBroadcast (void) const;
134  virtual Address GetBroadcast (void) const;
135  virtual bool IsMulticast (void) const;
136  virtual Address GetMulticast (Ipv4Address multicastGroup) const;
137  virtual Address GetMulticast (Ipv6Address addr) const;
138  virtual bool IsPointToPoint (void) const;
139  virtual bool Send (Ptr<Packet> packet, const Address& dest, uint16_t protocolNumber);
140  virtual bool SendFrom (Ptr<Packet> packet, const Address& source, const Address& dest, uint16_t protocolNumber);
141  virtual Ptr<Node> GetNode (void) const;
142  virtual void SetNode (Ptr<Node> node);
143  virtual bool NeedsArp (void) const;
146  virtual bool SupportsSendFrom () const;
147  virtual bool IsBridge (void) const;
148 
149 protected:
150 
151  virtual void DoDispose (void);
152 
153 private:
154 
165  std::string m_name;
166  uint32_t m_index;
167  uint16_t m_mtu;
171 };
172 
173 } // namespace ns3
174 
175 #endif
176 
ns3::VirtualNetDevice::SetSupportsSendFrom
void SetSupportsSendFrom(bool supportsSendFrom)
Configure whether the virtual device supports SendFrom.
Definition: virtual-net-device.cc:107
ns3::VirtualNetDevice::GetMulticast
virtual Address GetMulticast(Ipv4Address multicastGroup) const
Make and return a MAC multicast address using the provided multicast group.
Definition: virtual-net-device.cc:236
ns3::TypeId
a unique identifier for an interface.
Definition: type-id.h:59
ns3::VirtualNetDevice::SetReceiveCallback
virtual void SetReceiveCallback(NetDevice::ReceiveCallback cb)
Definition: virtual-net-device.cc:295
ns3::Callback
Callback template class.
Definition: callback.h:1279
ns3::VirtualNetDevice::VirtualNetDevice
VirtualNetDevice()
Definition: virtual-net-device.cc:86
ns3
Every class exported by the ns3 library is enclosed in the ns3 namespace.
ns3::VirtualNetDevice::SetIfIndex
virtual void SetIfIndex(const uint32_t index)
Definition: virtual-net-device.cc:172
ns3::VirtualNetDevice::m_sendCb
SendCallback m_sendCb
Definition: virtual-net-device.h:156
ns3::VirtualNetDevice::SetAddress
virtual void SetAddress(Address address)
Set the address of this interface.
Definition: virtual-net-device.cc:196
ns3::VirtualNetDevice::GetNode
virtual Ptr< Node > GetNode(void) const
Definition: virtual-net-device.cc:277
ns3::VirtualNetDevice::GetTypeId
static TypeId GetTypeId(void)
Definition: virtual-net-device.cc:39
ns3::VirtualNetDevice::GetBroadcast
virtual Address GetBroadcast(void) const
Definition: virtual-net-device.cc:225
ns3::VirtualNetDevice::SetSendCallback
void SetSendCallback(SendCallback transmitCb)
Set the user callback to be called when a L2 packet is to be transmitted.
Definition: virtual-net-device.cc:95
ns3::VirtualNetDevice::m_isPointToPoint
bool m_isPointToPoint
Definition: virtual-net-device.h:170
ns3::VirtualNetDevice::SupportsSendFrom
virtual bool SupportsSendFrom() const
Definition: virtual-net-device.cc:307
ns3::VirtualNetDevice::m_promiscSnifferTrace
TracedCallback< Ptr< const Packet > > m_promiscSnifferTrace
Definition: virtual-net-device.h:161
ns3::Ipv4Address
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:41
ns3::Ipv6Address
Describes an IPv6 address.
Definition: ipv6-address.h:50
ns3::VirtualNetDevice::m_snifferTrace
TracedCallback< Ptr< const Packet > > m_snifferTrace
Definition: virtual-net-device.h:160
ns3::VirtualNetDevice::m_promiscRxCallback
PromiscReceiveCallback m_promiscRxCallback
Definition: virtual-net-device.h:164
ns3::VirtualNetDevice::IsBroadcast
virtual bool IsBroadcast(void) const
Definition: virtual-net-device.cc:219
ns3::VirtualNetDevice::IsMulticast
virtual bool IsMulticast(void) const
Definition: virtual-net-device.cc:231
ns3::VirtualNetDevice::m_node
Ptr< Node > m_node
Definition: virtual-net-device.h:162
ns3::VirtualNetDevice::SetNeedsArp
void SetNeedsArp(bool needsArp)
Configure whether the virtual device needs ARP.
Definition: virtual-net-device.cc:101
ns3::VirtualNetDevice::GetAddress
virtual Address GetAddress(void) const
Definition: virtual-net-device.cc:190
ns3::VirtualNetDevice::m_name
std::string m_name
Definition: virtual-net-device.h:165
ns3::VirtualNetDevice::SetIsPointToPoint
void SetIsPointToPoint(bool isPointToPoint)
Configure whether the virtual device is point-to-point.
Definition: virtual-net-device.cc:113
ns3::Ptr< Packet >
ns3::VirtualNetDevice::AddLinkChangeCallback
virtual void AddLinkChangeCallback(Callback< void > callback)
Definition: virtual-net-device.cc:214
ns3::Address
a polymophic address class
Definition: address.h:91
ns3::NetDevice::ReceiveCallback
Callback< bool, Ptr< NetDevice >, Ptr< const Packet >, uint16_t, const Address & > ReceiveCallback
Definition: net-device.h:318
ns3::VirtualNetDevice::DoDispose
virtual void DoDispose(void)
Destructor implementation.
Definition: virtual-net-device.cc:132
ns3::VirtualNetDevice::m_rxCallback
ReceiveCallback m_rxCallback
Definition: virtual-net-device.h:163
ns3::NetDevice::PromiscReceiveCallback
Callback< bool, Ptr< NetDevice >, Ptr< const Packet >, uint16_t, const Address &, const Address &, enum PacketType > PromiscReceiveCallback
Definition: net-device.h:343
ns3::VirtualNetDevice::SendCallback
Callback< bool, Ptr< Packet >, const Address &, const Address &, uint16_t > SendCallback
Callback the be invoked when the VirtualNetDevice is asked to queue/transmit a packet.
Definition: virtual-net-device.h:65
ns3::VirtualNetDevice::m_supportsSendFrom
bool m_supportsSendFrom
Definition: virtual-net-device.h:169
first.address
address
Definition: first.py:44
ns3::VirtualNetDevice::GetIfIndex
virtual uint32_t GetIfIndex(void) const
Definition: virtual-net-device.cc:178
ns3::VirtualNetDevice::GetMtu
virtual uint16_t GetMtu(void) const
Definition: virtual-net-device.cc:202
ns3::VirtualNetDevice::NeedsArp
virtual bool NeedsArp(void) const
Definition: virtual-net-device.cc:289
ns3::VirtualNetDevice::m_myAddress
Address m_myAddress
Definition: virtual-net-device.h:155
ns3::VirtualNetDevice::m_mtu
uint16_t m_mtu
Definition: virtual-net-device.h:167
ns3::VirtualNetDevice::m_needsArp
bool m_needsArp
Definition: virtual-net-device.h:168
ns3::VirtualNetDevice::IsLinkUp
virtual bool IsLinkUp(void) const
Definition: virtual-net-device.cc:208
ns3::VirtualNetDevice::m_macRxTrace
TracedCallback< Ptr< const Packet > > m_macRxTrace
Definition: virtual-net-device.h:157
ns3::VirtualNetDevice::GetChannel
virtual Ptr< Channel > GetChannel(void) const
Definition: virtual-net-device.cc:184
ns3::VirtualNetDevice
A virtual device, similar to Linux TUN/TAP interfaces.
Definition: virtual-net-device.h:59
ns3::VirtualNetDevice::~VirtualNetDevice
virtual ~VirtualNetDevice()
Definition: virtual-net-device.cc:126
ns3::VirtualNetDevice::Receive
bool Receive(Ptr< Packet > packet, uint16_t protocol, const Address &source, const Address &destination, PacketType packetType)
Definition: virtual-net-device.cc:140
ns3::VirtualNetDevice::SendFrom
virtual bool SendFrom(Ptr< Packet > packet, const Address &source, const Address &dest, uint16_t protocolNumber)
Definition: virtual-net-device.cc:265
ns3::VirtualNetDevice::SetNode
virtual void SetNode(Ptr< Node > node)
Definition: virtual-net-device.cc:283
ns3::VirtualNetDevice::IsBridge
virtual bool IsBridge(void) const
Return true if the net device is acting as a bridge.
Definition: virtual-net-device.cc:312
ns3::NetDevice::PacketType
PacketType
Packet types are used as they are in Linux.
Definition: net-device.h:297
ns3::TracedCallback
Forward calls to a chain of Callback.
Definition: traced-callback.h:53
ns3::VirtualNetDevice::IsPointToPoint
virtual bool IsPointToPoint(void) const
Return true if the net device is on a point-to-point link.
Definition: virtual-net-device.cc:248
ns3::VirtualNetDevice::SetMtu
bool SetMtu(const uint16_t mtu)
Configure the reported MTU for the virtual device.
Definition: virtual-net-device.cc:119
ns3::VirtualNetDevice::SetPromiscReceiveCallback
virtual void SetPromiscReceiveCallback(NetDevice::PromiscReceiveCallback cb)
Definition: virtual-net-device.cc:301
ns3::VirtualNetDevice::m_macTxTrace
TracedCallback< Ptr< const Packet > > m_macTxTrace
Definition: virtual-net-device.h:158
ns3::VirtualNetDevice::m_macPromiscRxTrace
TracedCallback< Ptr< const Packet > > m_macPromiscRxTrace
Definition: virtual-net-device.h:159
ns3::VirtualNetDevice::m_index
uint32_t m_index
Definition: virtual-net-device.h:166
ns3::NetDevice
Network layer to device interface.
Definition: net-device.h:96
ns3::VirtualNetDevice::Send
virtual bool Send(Ptr< Packet > packet, const Address &dest, uint16_t protocolNumber)
Definition: virtual-net-device.cc:254