util: Add a "writefile" unit test to the m5 utility.
[gem5.git] / util / m5 / src / call_type / addr.cc
1 /*
2 * Copyright 2020 Google Inc.
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions are
6 * met: redistributions of source code must retain the above copyright
7 * notice, this list of conditions and the following disclaimer;
8 * redistributions in binary form must reproduce the above copyright
9 * notice, this list of conditions and the following disclaimer in the
10 * documentation and/or other materials provided with the distribution;
11 * neither the name of the copyright holders nor the names of its
12 * contributors may be used to endorse or promote products derived from
13 * this software without specific prior written permission.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
18 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
19 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
20 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
21 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
25 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 */
27
28 #include <cstring>
29
30 #include "args.hh"
31 #include "call_type.hh"
32 #include "dispatch_table.hh"
33 #include "m5_mmap.h"
34 #include "usage.hh"
35
36 extern "C"
37 {
38 #define M5OP(name, func) __typeof__(name) M5OP_MERGE_TOKENS(name, _addr);
39 M5OP_FOREACH
40 #undef M5OP
41 }
42
43 namespace
44 {
45
46 DispatchTable addr_dispatch = {
47 #define M5OP(name, func) .name = &::M5OP_MERGE_TOKENS(name, _addr),
48 M5OP_FOREACH
49 #undef M5OP
50 };
51
52 #if defined(M5OP_ADDR)
53 const bool DefaultAddrDefined = true;
54 constexpr uint64_t DefaultAddress = M5OP_ADDR;
55 #else
56 const bool DefaultAddrDefined = false;
57 constexpr uint64_t DefaultAddress = 0;
58 #endif
59
60 class AddrCallType : public CallType
61 {
62 private:
63 public:
64 bool isDefault() const override { return CALL_TYPE_IS_DEFAULT; }
65 const DispatchTable &getDispatch() const override { return addr_dispatch; }
66
67 void
68 printBrief(std::ostream &os) const override
69 {
70 os << "--addr " << (DefaultAddrDefined ? "[address override]" :
71 "<address override>");
72 }
73
74 void
75 printDesc(std::ostream &os) const override
76 {
77 os << "Use the address based invocation method.";
78 if (DefaultAddrDefined) {
79 os << " The default address is 0x" <<
80 std::hex << DefaultAddress << std::dec << ".";
81 }
82 }
83
84 bool
85 checkArgs(Args &args) override
86 {
87 static const std::string prefix = "--addr";
88 uint64_t addr_override;
89
90 // If the first argument doesn't start with --addr...
91 if (!args.size() || args[0].substr(0, prefix.size()) != prefix)
92 return false;
93
94 const std::string &arg = args.pop().substr(prefix.size());
95
96 // If there's more text in this argument...
97 if (arg.size()) {
98 // If it doesn't start with '=', it's malformed.
99 if (arg[0] != '=')
100 usage();
101 // Attempt to extract an address after the '='.
102 if (!args.stoi(arg.substr(1), addr_override))
103 usage();
104 // If we found an address, use it to override m5op_addr.
105 m5op_addr = addr_override;
106 return true;
107 }
108 // If an address override wasn't part of the first argument, check if
109 // it's the second argument. If not, then there's no override.
110 if (args.pop(addr_override)) {
111 m5op_addr = addr_override;
112 return true;
113 }
114 // If the default address was not defined, an override is required.
115 if (!DefaultAddrDefined)
116 usage();
117
118 return true;
119 }
120
121 void init() override { map_m5_mem(); }
122 } addr_call_type;
123
124 } // anonymous namespace