A Discrete-Event Network Simulator
API
point-to-point-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) 2007, 2008 University of Washington
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
19#ifndef POINT_TO_POINT_NET_DEVICE_H
20#define POINT_TO_POINT_NET_DEVICE_H
21
22#include <cstring>
23#include "ns3/address.h"
24#include "ns3/node.h"
25#include "ns3/net-device.h"
26#include "ns3/callback.h"
27#include "ns3/packet.h"
28#include "ns3/traced-callback.h"
29#include "ns3/nstime.h"
30#include "ns3/data-rate.h"
31#include "ns3/ptr.h"
32#include "ns3/mac48-address.h"
33
34namespace ns3 {
35
36template <typename Item> class Queue;
37class PointToPointChannel;
38class ErrorModel;
39
63{
64public:
70 static TypeId GetTypeId (void);
71
80
86 virtual ~PointToPointNetDevice ();
87
95 void SetDataRate (DataRate bps);
96
103 void SetInterframeGap (Time t);
104
112
121 void SetQueue (Ptr<Queue<Packet> > queue);
122
128 Ptr<Queue<Packet> > GetQueue (void) const;
129
139
150 void Receive (Ptr<Packet> p);
151
152 // The remaining methods are documented in ns3::NetDevice*
153
154 virtual void SetIfIndex (const uint32_t index);
155 virtual uint32_t GetIfIndex (void) const;
156
157 virtual Ptr<Channel> GetChannel (void) const;
158
159 virtual void SetAddress (Address address);
160 virtual Address GetAddress (void) const;
161
162 virtual bool SetMtu (const uint16_t mtu);
163 virtual uint16_t GetMtu (void) const;
164
165 virtual bool IsLinkUp (void) const;
166
167 virtual void AddLinkChangeCallback (Callback<void> callback);
168
169 virtual bool IsBroadcast (void) const;
170 virtual Address GetBroadcast (void) const;
171
172 virtual bool IsMulticast (void) const;
173 virtual Address GetMulticast (Ipv4Address multicastGroup) const;
174
175 virtual bool IsPointToPoint (void) const;
176 virtual bool IsBridge (void) const;
177
178 virtual bool Send (Ptr<Packet> packet, const Address &dest, uint16_t protocolNumber);
179 virtual bool SendFrom (Ptr<Packet> packet, const Address& source, const Address& dest, uint16_t protocolNumber);
180
181 virtual Ptr<Node> GetNode (void) const;
182 virtual void SetNode (Ptr<Node> node);
183
184 virtual bool NeedsArp (void) const;
185
187
188 virtual Address GetMulticast (Ipv6Address addr) const;
189
191 virtual bool SupportsSendFrom (void) const;
192
193protected:
199 void DoMpiReceive (Ptr<Packet> p);
200
201private:
202
212
221
225 virtual void DoDispose (void);
226
227private:
228
233 Address GetRemote (void) const;
234
241 void AddHeader (Ptr<Packet> p, uint16_t protocolNumber);
242
251 bool ProcessHeader (Ptr<Packet> p, uint16_t& param);
252
268 bool TransmitStart (Ptr<Packet> p);
269
276 void TransmitComplete (void);
277
283 void NotifyLinkUp (void);
284
289 {
291 BUSY
292 };
297
303
309
315
323
328
334
340
348
356
363
369
375
381
387
393
400
418
436
441 // (promisc data)
443 bool m_linkUp;
445
446 static const uint16_t DEFAULT_MTU = 1500;
447
457
459
465 static uint16_t PppToEther (uint16_t protocol);
466
472 static uint16_t EtherToPpp (uint16_t protocol);
473};
474
475} // namespace ns3
476
477#endif /* POINT_TO_POINT_NET_DEVICE_H */
a polymophic address class
Definition: address.h:91
Class for representing data rates.
Definition: data-rate.h:89
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:41
Describes an IPv6 address.
Definition: ipv6-address.h:50
an EUI-48 address
Definition: mac48-address.h:44
Network layer to device interface.
Definition: net-device.h:96
A Device for a Point to Point Network Link.
void AddHeader(Ptr< Packet > p, uint16_t protocolNumber)
Adds the necessary headers and trailers to a packet of data in order to respect the protocol implemen...
virtual bool SendFrom(Ptr< Packet > packet, const Address &source, const Address &dest, uint16_t protocolNumber)
static TypeId GetTypeId(void)
Get the TypeId.
static const uint16_t DEFAULT_MTU
Default MTU.
TracedCallback< Ptr< const Packet > > m_phyRxEndTrace
The trace source fired when a packet ends the reception process from the medium.
virtual Address GetMulticast(Ipv4Address multicastGroup) const
Make and return a MAC multicast address using the provided multicast group.
TracedCallback< Ptr< const Packet > > m_macPromiscRxTrace
The trace source fired for packets successfully received by the device immediately before being forwa...
PointToPointNetDevice()
Construct a PointToPointNetDevice.
Ptr< PointToPointChannel > m_channel
The PointToPointChannel to which this PointToPointNetDevice has been attached.
virtual bool IsBroadcast(void) const
DataRate m_bps
The data rate that the Net Device uses to simulate packet transmission timing.
bool TransmitStart(Ptr< Packet > p)
Start Sending a Packet Down the Wire.
TracedCallback< Ptr< const Packet > > m_macRxTrace
The trace source fired for packets successfully received by the device immediately before being forwa...
TracedCallback< Ptr< const Packet > > m_macRxDropTrace
The trace source fired for packets successfully received by the device but are dropped before being f...
TracedCallback m_linkChangeCallbacks
Callback for the link change event.
TracedCallback< Ptr< const Packet > > m_macTxTrace
The trace source fired when packets come into the "top" of the device at the L3/L2 transition,...
void SetQueue(Ptr< Queue< Packet > > queue)
Attach a queue to the PointToPointNetDevice.
virtual bool SupportsSendFrom(void) const
virtual bool SetMtu(const uint16_t mtu)
void NotifyLinkUp(void)
Make the link up and running.
bool Attach(Ptr< PointToPointChannel > ch)
Attach the device to a channel.
virtual void DoDispose(void)
Dispose of the object.
virtual uint32_t GetIfIndex(void) const
static uint16_t EtherToPpp(uint16_t protocol)
Ethernet to PPP protocol number mapping.
void SetReceiveErrorModel(Ptr< ErrorModel > em)
Attach a receive ErrorModel to the PointToPointNetDevice.
virtual Ptr< Channel > GetChannel(void) const
TracedCallback< Ptr< const Packet > > m_phyTxDropTrace
The trace source fired when the phy layer drops a packet before it tries to transmit it.
Ptr< ErrorModel > m_receiveErrorModel
Error model for receive packet events.
PointToPointNetDevice(const PointToPointNetDevice &o)
Copy constructor.
PointToPointNetDevice & operator=(const PointToPointNetDevice &o)
Assign operator.
void SetInterframeGap(Time t)
Set the interframe gap used to separate packets.
virtual void SetIfIndex(const uint32_t index)
void TransmitComplete(void)
Stop Sending a Packet Down the Wire and Begin the Interframe Gap.
bool m_linkUp
Identify if the link is up or not.
TracedCallback< Ptr< const Packet > > m_phyRxDropTrace
The trace source fired when the phy layer drops a packet it has received.
Ptr< Queue< Packet > > GetQueue(void) const
Get a copy of the attached Queue.
virtual void SetPromiscReceiveCallback(PromiscReceiveCallback cb)
TxMachineState
Enumeration of the states of the transmit machine of the net device.
@ READY
The transmitter is ready to begin transmission of a packet.
@ BUSY
The transmitter is busy transmitting a packet.
static uint16_t PppToEther(uint16_t protocol)
PPP to Ethernet protocol number mapping.
virtual uint16_t GetMtu(void) const
virtual bool IsBridge(void) const
Return true if the net device is acting as a bridge.
virtual Ptr< Node > GetNode(void) const
virtual void SetReceiveCallback(NetDevice::ReceiveCallback cb)
TracedCallback< Ptr< const Packet > > m_phyTxBeginTrace
The trace source fired when a packet begins the transmission process on the medium.
virtual Address GetBroadcast(void) const
Mac48Address m_address
Mac48Address of this NetDevice.
Time m_tInterframeGap
The interframe gap that the Net Device uses to throttle packet transmission.
Ptr< Packet > m_currentPkt
Current packet processed.
bool ProcessHeader(Ptr< Packet > p, uint16_t &param)
Removes, from a packet of data, all headers and trailers that relate to the protocol implemented by t...
virtual void AddLinkChangeCallback(Callback< void > callback)
void Receive(Ptr< Packet > p)
Receive a packet from a connected PointToPointChannel.
TracedCallback< Ptr< const Packet > > m_phyRxBeginTrace
The trace source fired when a packet begins the reception process from the medium – when the simulate...
Ptr< Queue< Packet > > m_queue
The Queue which this PointToPointNetDevice uses as a packet source.
virtual void SetAddress(Address address)
Set the address of this interface.
virtual bool Send(Ptr< Packet > packet, const Address &dest, uint16_t protocolNumber)
TracedCallback< Ptr< const Packet > > m_promiscSnifferTrace
A trace source that emulates a promiscuous mode protocol sniffer connected to the device.
TracedCallback< Ptr< const Packet > > m_phyTxEndTrace
The trace source fired when a packet ends the transmission process on the medium.
virtual ~PointToPointNetDevice()
Destroy a PointToPointNetDevice.
TxMachineState m_txMachineState
The state of the Net Device transmit state machine.
virtual void SetNode(Ptr< Node > node)
void DoMpiReceive(Ptr< Packet > p)
Handler for MPI receive event.
void SetDataRate(DataRate bps)
Set the Data Rate used for transmission of packets.
virtual bool IsMulticast(void) const
virtual Address GetAddress(void) const
uint32_t m_mtu
The Maximum Transmission Unit.
Ptr< Node > m_node
Node owning this NetDevice.
TracedCallback< Ptr< const Packet > > m_snifferTrace
A trace source that emulates a non-promiscuous protocol sniffer connected to the device.
TracedCallback< Ptr< const Packet > > m_macTxDropTrace
The trace source fired when packets coming into the "top" of the device at the L3/L2 transition are d...
NetDevice::PromiscReceiveCallback m_promiscCallback
Receive callback.
NetDevice::ReceiveCallback m_rxCallback
Receive callback.
uint32_t m_ifIndex
Index of the interface.
virtual bool IsPointToPoint(void) const
Return true if the net device is on a point-to-point link.
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:74
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:103
Forward calls to a chain of Callback.
a unique identifier for an interface.
Definition: type-id.h:59
address
Definition: first.py:44
Every class exported by the ns3 library is enclosed in the ns3 namespace.