ethertap.hh revision 12130:5e0dd4d7b730
14484Sbinkertn@umich.edu/* 24484Sbinkertn@umich.edu * Copyright (c) 2003-2005 The Regents of The University of Michigan 34484Sbinkertn@umich.edu * All rights reserved. 44484Sbinkertn@umich.edu * 54484Sbinkertn@umich.edu * Redistribution and use in source and binary forms, with or without 64484Sbinkertn@umich.edu * modification, are permitted provided that the following conditions are 74484Sbinkertn@umich.edu * met: redistributions of source code must retain the above copyright 84484Sbinkertn@umich.edu * notice, this list of conditions and the following disclaimer; 94484Sbinkertn@umich.edu * redistributions in binary form must reproduce the above copyright 104484Sbinkertn@umich.edu * notice, this list of conditions and the following disclaimer in the 114484Sbinkertn@umich.edu * documentation and/or other materials provided with the distribution; 124484Sbinkertn@umich.edu * neither the name of the copyright holders nor the names of its 134484Sbinkertn@umich.edu * contributors may be used to endorse or promote products derived from 144484Sbinkertn@umich.edu * this software without specific prior written permission. 154484Sbinkertn@umich.edu * 164484Sbinkertn@umich.edu * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 174484Sbinkertn@umich.edu * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 184484Sbinkertn@umich.edu * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 194484Sbinkertn@umich.edu * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 204484Sbinkertn@umich.edu * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 214484Sbinkertn@umich.edu * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 224484Sbinkertn@umich.edu * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 234484Sbinkertn@umich.edu * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 244484Sbinkertn@umich.edu * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 254484Sbinkertn@umich.edu * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 264484Sbinkertn@umich.edu * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 274484Sbinkertn@umich.edu * 284484Sbinkertn@umich.edu * Authors: Nathan Binkert 294484Sbinkertn@umich.edu */ 304484Sbinkertn@umich.edu 314484Sbinkertn@umich.edu/* @file 324484Sbinkertn@umich.edu * Interface to connect a simulated ethernet device to the real world 334484Sbinkertn@umich.edu */ 344484Sbinkertn@umich.edu 354484Sbinkertn@umich.edu#ifndef __DEV_NET_ETHERTAP_HH__ 364484Sbinkertn@umich.edu#define __DEV_NET_ETHERTAP_HH__ 374484Sbinkertn@umich.edu 384484Sbinkertn@umich.edu#include <queue> 394484Sbinkertn@umich.edu#include <string> 404484Sbinkertn@umich.edu 414484Sbinkertn@umich.edu#include "base/pollevent.hh" 424484Sbinkertn@umich.edu#include "config/use_tuntap.hh" 434484Sbinkertn@umich.edu#include "dev/net/etherint.hh" 444484Sbinkertn@umich.edu#include "dev/net/etherobject.hh" 454484Sbinkertn@umich.edu#include "dev/net/etherpkt.hh" 464484Sbinkertn@umich.edu 474484Sbinkertn@umich.edu#if USE_TUNTAP 484484Sbinkertn@umich.edu#include "params/EtherTap.hh" 494484Sbinkertn@umich.edu 504484Sbinkertn@umich.edu#endif 514484Sbinkertn@umich.edu 524484Sbinkertn@umich.edu#include "params/EtherTapStub.hh" 534484Sbinkertn@umich.edu#include "sim/eventq.hh" 544484Sbinkertn@umich.edu#include "sim/sim_object.hh" 554484Sbinkertn@umich.edu 564484Sbinkertn@umich.educlass TapEvent; 574484Sbinkertn@umich.educlass EtherTapInt; 584484Sbinkertn@umich.edu 594484Sbinkertn@umich.educlass EtherTapBase : public EtherObject 604484Sbinkertn@umich.edu{ 614484Sbinkertn@umich.edu public: 624484Sbinkertn@umich.edu typedef EtherTapBaseParams Params; 634484Sbinkertn@umich.edu EtherTapBase(const Params *p); 644484Sbinkertn@umich.edu virtual ~EtherTapBase(); 654484Sbinkertn@umich.edu 664484Sbinkertn@umich.edu const Params * 674484Sbinkertn@umich.edu params() const 684484Sbinkertn@umich.edu { 694484Sbinkertn@umich.edu return dynamic_cast<const Params *>(_params); 704484Sbinkertn@umich.edu } 714484Sbinkertn@umich.edu 724484Sbinkertn@umich.edu void serialize(CheckpointOut &cp) const override; 734484Sbinkertn@umich.edu void unserialize(CheckpointIn &cp) override; 744484Sbinkertn@umich.edu 754484Sbinkertn@umich.edu protected: 764484Sbinkertn@umich.edu uint8_t *buffer; 774484Sbinkertn@umich.edu int buflen; 784484Sbinkertn@umich.edu 794484Sbinkertn@umich.edu EtherDump *dump; 804484Sbinkertn@umich.edu 814484Sbinkertn@umich.edu 824484Sbinkertn@umich.edu /* 834484Sbinkertn@umich.edu * Interface to the real network. 844484Sbinkertn@umich.edu */ 854484Sbinkertn@umich.edu protected: 864484Sbinkertn@umich.edu friend class TapEvent; 874484Sbinkertn@umich.edu TapEvent *event; 884484Sbinkertn@umich.edu void pollFd(int fd); 894484Sbinkertn@umich.edu void stopPolling(); 904484Sbinkertn@umich.edu 914484Sbinkertn@umich.edu // Receive data from the real network. 924484Sbinkertn@umich.edu virtual void recvReal(int revent) = 0; 934484Sbinkertn@umich.edu // Prepare and send data out to the real network. 944484Sbinkertn@umich.edu virtual bool sendReal(const void *data, size_t len) = 0; 954484Sbinkertn@umich.edu 964484Sbinkertn@umich.edu 974484Sbinkertn@umich.edu /* 984484Sbinkertn@umich.edu * Interface to the simulated network. 994484Sbinkertn@umich.edu */ 1004484Sbinkertn@umich.edu protected: 1014484Sbinkertn@umich.edu EtherTapInt *interface; 1024484Sbinkertn@umich.edu 1034484Sbinkertn@umich.edu public: 1044484Sbinkertn@umich.edu EtherInt *getEthPort(const std::string &if_name, int idx) override; 1054484Sbinkertn@umich.edu 1064484Sbinkertn@umich.edu bool recvSimulated(EthPacketPtr packet); 1074484Sbinkertn@umich.edu void sendSimulated(void *data, size_t len); 1084484Sbinkertn@umich.edu 1094484Sbinkertn@umich.edu protected: 1104484Sbinkertn@umich.edu std::queue<EthPacketPtr> packetBuffer; 1114484Sbinkertn@umich.edu void retransmit(); 1124484Sbinkertn@umich.edu EventFunctionWrapper txEvent; 1134484Sbinkertn@umich.edu}; 1144484Sbinkertn@umich.edu 1154484Sbinkertn@umich.educlass EtherTapInt : public EtherInt 1164484Sbinkertn@umich.edu{ 1174484Sbinkertn@umich.edu private: 1184484Sbinkertn@umich.edu EtherTapBase *tap; 1194484Sbinkertn@umich.edu public: 1204484Sbinkertn@umich.edu EtherTapInt(const std::string &name, EtherTapBase *t) : 1214484Sbinkertn@umich.edu EtherInt(name), tap(t) 1224484Sbinkertn@umich.edu { } 1234484Sbinkertn@umich.edu 1244484Sbinkertn@umich.edu bool recvPacket(EthPacketPtr pkt) override 1254484Sbinkertn@umich.edu { return tap->recvSimulated(pkt); } 1264484Sbinkertn@umich.edu void sendDone() override {} 1274484Sbinkertn@umich.edu}; 1284484Sbinkertn@umich.edu 1294484Sbinkertn@umich.edu 1304484Sbinkertn@umich.educlass TapListener; 1314484Sbinkertn@umich.edu 1324484Sbinkertn@umich.edu/* 1334484Sbinkertn@umich.edu * Interface to connect a simulated ethernet device to the real world. An 134 * external helper program bridges between this object's TCP port and a 135 * source/sink for Ethernet frames. Each frame going in either direction is 136 * prepended with the frame's length in a 32 bit integer in network byte order. 137 */ 138class EtherTapStub : public EtherTapBase 139{ 140 public: 141 typedef EtherTapStubParams Params; 142 EtherTapStub(const Params *p); 143 ~EtherTapStub(); 144 145 const Params * 146 params() const 147 { 148 return dynamic_cast<const Params *>(_params); 149 } 150 151 void serialize(CheckpointOut &cp) const override; 152 void unserialize(CheckpointIn &cp) override; 153 154 155 protected: 156 friend class TapListener; 157 TapListener *listener; 158 159 int socket; 160 161 void attach(int fd); 162 void detach(); 163 164 uint32_t buffer_used; 165 uint32_t frame_len; 166 167 void recvReal(int revent) override; 168 bool sendReal(const void *data, size_t len) override; 169}; 170 171 172#if USE_TUNTAP 173class EtherTap : public EtherTapBase 174{ 175 public: 176 typedef EtherTapParams Params; 177 EtherTap(const Params *p); 178 ~EtherTap(); 179 180 const Params * 181 params() const 182 { 183 return dynamic_cast<const Params *>(_params); 184 } 185 186 187 protected: 188 int tap; 189 190 void recvReal(int revent) override; 191 bool sendReal(const void *data, size_t len) override; 192}; 193#endif 194 195 196#endif // __DEV_NET_ETHERTAP_HH__ 197