gem5  v22.1.0.0
emul_driver.hh
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2014 Advanced Micro Devices, Inc.
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  * Author: Steve Reinhardt
29  */
30 
31 #ifndef __SIM_EMUL_DRIVER_HH
32 #define __SIM_EMUL_DRIVER_HH
33 
34 #include <string>
35 
36 #include "params/EmulatedDriver.hh"
37 #include "sim/sim_object.hh"
38 
39 namespace gem5
40 {
41 
42 class Process;
43 class ThreadContext;
44 
55 class EmulatedDriver : public SimObject
56 {
57  protected:
61  const std::string &filename;
62 
63  public:
64  EmulatedDriver(const EmulatedDriverParams &p)
66  {
67  }
68 
72  bool match(const std::string &s) const { return (s == filename); }
73 
80  virtual int open(ThreadContext *tc, int mode, int flags) = 0;
81 
89  virtual int ioctl(ThreadContext *tc, unsigned req, Addr buf) = 0;
90 
98  virtual Addr mmap(ThreadContext *tc, Addr start, uint64_t length,
99  int prot, int tgtFlags, int tgtFd, off_t offset)
100  { return -EBADF; }
101 };
102 
103 } // namespace gem5
104 
105 #endif // __SIM_EMUL_DRIVER_HH
EmulatedDriver is an abstract base class for fake SE-mode device drivers.
Definition: emul_driver.hh:56
const std::string & filename
filename for opening this driver (under /dev)
Definition: emul_driver.hh:61
virtual int ioctl(ThreadContext *tc, unsigned req, Addr buf)=0
Abstract method, invoked when the user program calls ioctl() on the file descriptor returned by a pre...
virtual int open(ThreadContext *tc, int mode, int flags)=0
Abstract method, invoked when the user program calls open() on the device driver.
EmulatedDriver(const EmulatedDriverParams &p)
Definition: emul_driver.hh:64
bool match(const std::string &s) const
Check for a match with this driver's filename.
Definition: emul_driver.hh:72
virtual Addr mmap(ThreadContext *tc, Addr start, uint64_t length, int prot, int tgtFlags, int tgtFd, off_t offset)
Virtual method, invoked when the user program calls mmap() on the file descriptor returned by a previ...
Definition: emul_driver.hh:98
Abstract superclass for simulation objects.
Definition: sim_object.hh:148
ThreadContext is the external interface to all thread state for anything outside of the CPU.
uint8_t flags
Definition: helpers.cc:66
Bitfield< 4, 0 > mode
Definition: misc_types.hh:74
Bitfield< 23, 0 > offset
Definition: types.hh:144
Bitfield< 1 > s
Definition: pagetable.hh:64
Bitfield< 54 > p
Definition: pagetable.hh:70
Bitfield< 7 > prot
Definition: misc.hh:587
Reference material can be found at the JEDEC website: UFS standard http://www.jedec....
uint64_t Addr
Address type This will probably be moved somewhere else in the near future.
Definition: types.hh:147

Generated on Wed Dec 21 2022 10:22:39 for gem5 by doxygen 1.9.1