etherswitch.cc revision 11800:54436a1784dc 
1/*
2 * Copyright (c) 2014 The Regents of The University of Michigan
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions are
7 * met: redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer;
9 * redistributions in binary form must reproduce the above copyright
10 * notice, this list of conditions and the following disclaimer in the
11 * documentation and/or other materials provided with the distribution;
12 * neither the name of the copyright holders nor the names of its
13 * contributors may be used to endorse or promote products derived from
14 * this software without specific prior written permission.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
17 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
18 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
19 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
20 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
26 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 *
28 * Authors: Anthony Gutierrez
29 *          Mohammad Alian
30 */
31
32/* @file
33 * Device model for an ethernet switch
34 */
35
36#include "dev/net/etherswitch.hh"
37
38#include "base/random.hh"
39#include "base/trace.hh"
40#include "debug/EthernetAll.hh"
41#include "sim/core.hh"
42
43using namespace std;
44
45EtherSwitch::EtherSwitch(const Params *p)
46    : EtherObject(p), ttl(p->time_to_live)
47{
48    for (int i = 0; i < p->port_interface_connection_count; ++i) {
49        std::string interfaceName = csprintf("%s.interface%d", name(), i);
50        Interface *interface = new Interface(interfaceName, this,
51                                        p->output_buffer_size, p->delay,
52                                        p->delay_var, p->fabric_speed, i);
53        interfaces.push_back(interface);
54    }
55}
56
57EtherSwitch::~EtherSwitch()
58{
59    for (auto it : interfaces)
60        delete it;
61
62    interfaces.clear();
63}
64
65EtherInt*
66EtherSwitch::getEthPort(const std::string &if_name, int idx)
67{
68    if (idx < 0 || idx >= interfaces.size())
69        return nullptr;
70
71    Interface *interface = interfaces.at(idx);
72    panic_if(interface->getPeer(), "interface already connected\n");
73
74    return interface;
75}
76
77bool
78EtherSwitch::Interface::PortFifo::push(EthPacketPtr ptr, unsigned senderId)
79{
80    assert(ptr->length);
81
82    _size += ptr->length;
83    fifo.emplace_hint(fifo.end(), ptr, curTick(), senderId);
84
85    // Drop the extra pushed packets from end of the fifo
86    while (avail() < 0) {
87        DPRINTF(Ethernet, "Fifo is full. Drop packet: len=%d\n",
88                std::prev(fifo.end())->packet->length);
89
90        _size -= std::prev(fifo.end())->packet->length;
91        fifo.erase(std::prev(fifo.end()));
92    }
93
94    if (empty()) {
95        warn("EtherSwitch: Packet length (%d) exceeds the maximum storage "
96             "capacity of port fifo (%d)", ptr->length, _maxsize);
97    }
98
99    // Return true if the newly pushed packet gets inserted
100    // at the head of the queue, otherwise return false
101    // We need this information to deschedule the event that has been
102    // scheduled for the old head of queue packet and schedule a new one
103    if (!empty() && fifo.begin()->packet == ptr) {
104        return true;
105    }
106    return false;
107}
108
109void
110EtherSwitch::Interface::PortFifo::pop()
111{
112    if (empty())
113        return;
114
115    assert(_size >= fifo.begin()->packet->length);
116    // Erase the packet at the head of the queue
117    _size -= fifo.begin()->packet->length;
118    fifo.erase(fifo.begin());
119}
120
121void
122EtherSwitch::Interface::PortFifo::clear()
123{
124    fifo.clear();
125    _size = 0;
126}
127
128EtherSwitch::Interface::Interface(const std::string &name,
129                                  EtherSwitch *etherSwitch,
130                                  uint64_t outputBufferSize, Tick delay,
131                                  Tick delay_var, double rate, unsigned id)
132    : EtherInt(name), ticksPerByte(rate), switchDelay(delay),
133      delayVar(delay_var), interfaceId(id), parent(etherSwitch),
134      outputFifo(name + ".outputFifo", outputBufferSize), txEvent(this)
135{
136}
137
138bool
139EtherSwitch::Interface::recvPacket(EthPacketPtr packet)
140{
141    Net::EthAddr destMacAddr(packet->data);
142    Net::EthAddr srcMacAddr(&packet->data[6]);
143
144    learnSenderAddr(srcMacAddr, this);
145    Interface *receiver = lookupDestPort(destMacAddr);
146
147    if (!receiver || destMacAddr.multicast() || destMacAddr.broadcast()) {
148        for (auto it : parent->interfaces)
149            if (it != this)
150                it->enqueue(packet, interfaceId);
151    } else {
152        DPRINTF(Ethernet, "sending packet from MAC %x on port "
153                "%s to MAC %x on port %s\n", uint64_t(srcMacAddr),
154                this->name(), uint64_t(destMacAddr), receiver->name());
155
156        receiver->enqueue(packet, interfaceId);
157    }
158    // At the output port, we either have buffer space (no drop) or
159    // don't (drop packet); in both cases packet is received on
160    // the interface successfully and there is no notion of busy
161    // interface here (as we don't have inputFifo)
162    return true;
163}
164
165void
166EtherSwitch::Interface::enqueue(EthPacketPtr packet, unsigned senderId)
167{
168    // assuming per-interface transmission events,
169    // if the newly push packet gets inserted at the head of the queue
170    // (either there was nothing in the queue or the priority of the new
171    // packet was higher than the packets already in the fifo)
172    // then we need to schedule an event at
173    // "curTick" + "switchingDelay of the packet at the head of the fifo"
174    // to send this packet out the external link
175    // otherwise, there is already a txEvent scheduled
176    if (outputFifo.push(packet, senderId)) {
177        parent->reschedule(txEvent, curTick() + switchingDelay(), true);
178    }
179}
180
181void
182EtherSwitch::Interface::transmit()
183{
184    // there should be something in the output queue
185    assert(!outputFifo.empty());
186
187    if (!sendPacket(outputFifo.front())) {
188        DPRINTF(Ethernet, "output port busy...retry later\n");
189        if (!txEvent.scheduled())
190            parent->schedule(txEvent, curTick() + retryTime);
191    } else {
192        DPRINTF(Ethernet, "packet sent: len=%d\n", outputFifo.front()->length);
193        outputFifo.pop();
194        // schedule an event to send the pkt at
195        // the head of queue, if there is any
196        if (!outputFifo.empty()) {
197            parent->schedule(txEvent, curTick() + switchingDelay());
198        }
199    }
200}
201
202Tick
203EtherSwitch::Interface::switchingDelay()
204{
205    Tick delay = (Tick)ceil(((double)outputFifo.front()->simLength
206                                     * ticksPerByte) + 1.0);
207    if (delayVar != 0)
208                delay += random_mt.random<Tick>(0, delayVar);
209    delay += switchDelay;
210    return delay;
211}
212
213EtherSwitch::Interface*
214EtherSwitch::Interface::lookupDestPort(Net::EthAddr destMacAddr)
215{
216    auto it = parent->forwardingTable.find(uint64_t(destMacAddr));
217
218    if (it == parent->forwardingTable.end()) {
219        DPRINTF(Ethernet, "no entry in forwaring table for MAC: "
220                "%x\n", uint64_t(destMacAddr));
221        return nullptr;
222    }
223
224    // check if this entry is valid based on TTL and lastUseTime
225    if ((curTick() - it->second.lastUseTime) > parent->ttl) {
226        // TTL for this mapping has been expired, so this item is not
227        // valide anymore, let's remove it from the map
228        parent->forwardingTable.erase(it);
229        return nullptr;
230    }
231
232    DPRINTF(Ethernet, "found entry for MAC address %x on port %s\n",
233            uint64_t(destMacAddr), it->second.interface->name());
234    return it->second.interface;
235}
236
237void
238EtherSwitch::Interface::learnSenderAddr(Net::EthAddr srcMacAddr,
239                                          Interface *sender)
240{
241    // learn the port for the sending MAC address
242    auto it = parent->forwardingTable.find(uint64_t(srcMacAddr));
243
244    // if the port for sender's MAC address is not cached,
245    // cache it now, otherwise just update lastUseTime time
246    if (it == parent->forwardingTable.end()) {
247        DPRINTF(Ethernet, "adding forwarding table entry for MAC "
248                " address %x on port %s\n", uint64_t(srcMacAddr),
249                sender->name());
250        EtherSwitch::SwitchTableEntry forwardingTableEntry;
251        forwardingTableEntry.interface = sender;
252        forwardingTableEntry.lastUseTime = curTick();
253        parent->forwardingTable.insert(std::make_pair(uint64_t(srcMacAddr),
254            forwardingTableEntry));
255    } else {
256        it->second.lastUseTime = curTick();
257    }
258}
259
260void
261EtherSwitch::serialize(CheckpointOut &cp) const
262{
263    for (auto it : interfaces)
264        it->serializeSection(cp, it->name());
265
266}
267
268void
269EtherSwitch::unserialize(CheckpointIn &cp)
270{
271    for (auto it : interfaces)
272        it->unserializeSection(cp, it->name());
273
274}
275
276void
277EtherSwitch::Interface::serialize(CheckpointOut &cp) const
278{
279    bool event_scheduled = txEvent.scheduled();
280    SERIALIZE_SCALAR(event_scheduled);
281
282    if (event_scheduled) {
283        Tick event_time = txEvent.when();
284        SERIALIZE_SCALAR(event_time);
285    }
286    outputFifo.serializeSection(cp, "outputFifo");
287}
288
289void
290EtherSwitch::Interface::unserialize(CheckpointIn &cp)
291{
292    bool event_scheduled;
293    UNSERIALIZE_SCALAR(event_scheduled);
294
295    if (event_scheduled) {
296        Tick event_time;
297        UNSERIALIZE_SCALAR(event_time);
298        parent->schedule(txEvent, event_time);
299    }
300    outputFifo.unserializeSection(cp, "outputFifo");
301}
302
303void
304EtherSwitch::Interface::PortFifoEntry::serialize(CheckpointOut &cp) const
305{
306    packet->serialize("packet", cp);
307    SERIALIZE_SCALAR(recvTick);
308    SERIALIZE_SCALAR(srcId);
309}
310
311void
312EtherSwitch::Interface::PortFifoEntry::unserialize(CheckpointIn &cp)
313{
314    packet = make_shared<EthPacketData>(16384);
315    packet->unserialize("packet", cp);
316    UNSERIALIZE_SCALAR(recvTick);
317    UNSERIALIZE_SCALAR(srcId);
318}
319
320void
321EtherSwitch::Interface::PortFifo::serialize(CheckpointOut &cp) const
322{
323    SERIALIZE_SCALAR(_size);
324    int fifosize = fifo.size();
325
326    SERIALIZE_SCALAR(fifosize);
327
328    int i = 0;
329    for (const auto &entry : fifo)
330        entry.serializeSection(cp, csprintf("entry%d", i++));
331}
332
333void
334EtherSwitch::Interface::PortFifo::unserialize(CheckpointIn &cp)
335{
336    UNSERIALIZE_SCALAR(_size);
337    int fifosize;
338
339    UNSERIALIZE_SCALAR(fifosize);
340    fifo.clear();
341
342    for (int i = 0; i < fifosize; ++i) {
343        PortFifoEntry entry(nullptr, 0, 0);
344
345        entry.unserializeSection(cp, csprintf("entry%d", i));
346
347        fifo.insert(entry);
348
349    }
350}
351
352EtherSwitch *
353EtherSwitchParams::create()
354{
355    return new EtherSwitch(this);
356}
357