init.cc (13620:e0d9b09788f6) init.cc (13662:3e072654ca86)
1/*
2 * Copyright (c) 2012, 2017 ARM Limited
3 * All rights reserved
4 *
5 * The license below extends only to copyright in the software and shall
6 * not be construed as granting a license to any other intellectual
7 * property including but not limited to intellectual property relating
8 * to a hardware implementation of the functionality of the software
9 * licensed hereunder. You may use the software subject to the license
10 * terms below provided that you ensure that this notice is replicated
11 * unmodified and in its entirety in all distributions of the software,
12 * modified or unmodified, in source code or in binary form.
13 *
14 * Copyright (c) 2000-2005 The Regents of The University of Michigan
15 * Copyright (c) 2008 The Hewlett-Packard Development Company
16 * All rights reserved.
17 *
18 * Redistribution and use in source and binary forms, with or without
19 * modification, are permitted provided that the following conditions are
20 * met: redistributions of source code must retain the above copyright
21 * notice, this list of conditions and the following disclaimer;
22 * redistributions in binary form must reproduce the above copyright
23 * notice, this list of conditions and the following disclaimer in the
24 * documentation and/or other materials provided with the distribution;
25 * neither the name of the copyright holders nor the names of its
26 * contributors may be used to endorse or promote products derived from
27 * this software without specific prior written permission.
28 *
29 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
30 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
31 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
32 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
33 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
34 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
35 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
36 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
37 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
38 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
39 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
40 *
41 * Authors: Nathan Binkert
42 */
43
44#include <Python.h>
45
46#include "sim/init.hh"
47
48#include <marshal.h>
49#include <zlib.h>
50
51#include <iostream>
52#include <list>
53#include <string>
54#include <vector>
55
56#include "base/cprintf.hh"
57#include "base/logging.hh"
58#include "base/types.hh"
59#include "config/have_protobuf.hh"
60#include "python/pybind11/pybind.hh"
61#include "sim/async.hh"
62#include "sim/core.hh"
63
64#if HAVE_PROTOBUF
65#include <google/protobuf/stubs/common.h>
66
67#endif
68
69using namespace std;
70namespace py = pybind11;
71
72// The python library is totally messed up with respect to constness,
73// so make a simple macro to make life a little easier
74#define PyCC(x) (const_cast<char *>(x))
75
76EmbeddedPython *EmbeddedPython::importer = NULL;
77PyObject *EmbeddedPython::importerModule = NULL;
78EmbeddedPython::EmbeddedPython(const char *filename, const char *abspath,
79 const char *modpath, const unsigned char *code, int zlen, int len)
80 : filename(filename), abspath(abspath), modpath(modpath), code(code),
81 zlen(zlen), len(len)
82{
83 // if we've added the importer keep track of it because we need it
84 // to bootstrap.
85 if (string(modpath) == string("importer"))
86 importer = this;
87 else
88 getList().push_back(this);
89}
90
91list<EmbeddedPython *> &
92EmbeddedPython::getList()
93{
94 static list<EmbeddedPython *> the_list;
95 return the_list;
96}
97
98/*
99 * Uncompress and unmarshal the code object stored in the
100 * EmbeddedPython
101 */
102PyObject *
103EmbeddedPython::getCode() const
104{
105 Bytef marshalled[len];
106 uLongf unzlen = len;
107 int ret = uncompress(marshalled, &unzlen, (const Bytef *)code, zlen);
108 if (ret != Z_OK)
109 panic("Could not uncompress code: %s\n", zError(ret));
110 assert(unzlen == (uLongf)len);
111
112 return PyMarshal_ReadObjectFromString((char *)marshalled, len);
113}
114
115bool
116EmbeddedPython::addModule() const
117{
118 PyObject *code = getCode();
119 PyObject *result = PyObject_CallMethod(importerModule, PyCC("add_module"),
120 PyCC("sssO"), filename, abspath, modpath, code);
121 if (!result) {
122 PyErr_Print();
123 return false;
124 }
125
126 Py_DECREF(result);
127 return true;
128}
129
130/*
131 * Load and initialize all of the python parts of M5.
132 */
133int
134EmbeddedPython::initAll()
135{
136 // Load the importer module
137 PyObject *code = importer->getCode();
138 importerModule = PyImport_ExecCodeModule(PyCC("importer"), code);
139 if (!importerModule) {
140 PyErr_Print();
141 return 1;
142 }
143
144 // Load the rest of the embedded python files into the embedded
145 // python importer
146 list<EmbeddedPython *>::iterator i = getList().begin();
147 list<EmbeddedPython *>::iterator end = getList().end();
148 for (; i != end; ++i)
149 if (!(*i)->addModule())
150 return 1;
151
152 return 0;
153}
154
155EmbeddedPyBind::EmbeddedPyBind(const char *_name,
156 void (*init_func)(py::module &),
157 const char *_base)
158 : initFunc(init_func), registered(false), name(_name), base(_base)
159{
160 getMap()[_name] = this;
161}
162
163EmbeddedPyBind::EmbeddedPyBind(const char *_name,
164 void (*init_func)(py::module &))
165 : initFunc(init_func), registered(false), name(_name), base("")
166{
167 getMap()[_name] = this;
168}
169
170void
171EmbeddedPyBind::init(py::module &m)
172{
173 if (!registered) {
174 initFunc(m);
175 registered = true;
176 } else {
177 cprintf("Warning: %s already registered.\n", name);
178 }
179}
180
181bool
182EmbeddedPyBind::depsReady() const
183{
184 return base.empty() || getMap()[base]->registered;
185}
186
187std::map<std::string, EmbeddedPyBind *> &
188EmbeddedPyBind::getMap()
189{
190 static std::map<std::string, EmbeddedPyBind *> objs;
191 return objs;
192}
193
1/*
2 * Copyright (c) 2012, 2017 ARM Limited
3 * All rights reserved
4 *
5 * The license below extends only to copyright in the software and shall
6 * not be construed as granting a license to any other intellectual
7 * property including but not limited to intellectual property relating
8 * to a hardware implementation of the functionality of the software
9 * licensed hereunder. You may use the software subject to the license
10 * terms below provided that you ensure that this notice is replicated
11 * unmodified and in its entirety in all distributions of the software,
12 * modified or unmodified, in source code or in binary form.
13 *
14 * Copyright (c) 2000-2005 The Regents of The University of Michigan
15 * Copyright (c) 2008 The Hewlett-Packard Development Company
16 * All rights reserved.
17 *
18 * Redistribution and use in source and binary forms, with or without
19 * modification, are permitted provided that the following conditions are
20 * met: redistributions of source code must retain the above copyright
21 * notice, this list of conditions and the following disclaimer;
22 * redistributions in binary form must reproduce the above copyright
23 * notice, this list of conditions and the following disclaimer in the
24 * documentation and/or other materials provided with the distribution;
25 * neither the name of the copyright holders nor the names of its
26 * contributors may be used to endorse or promote products derived from
27 * this software without specific prior written permission.
28 *
29 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
30 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
31 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
32 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
33 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
34 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
35 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
36 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
37 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
38 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
39 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
40 *
41 * Authors: Nathan Binkert
42 */
43
44#include <Python.h>
45
46#include "sim/init.hh"
47
48#include <marshal.h>
49#include <zlib.h>
50
51#include <iostream>
52#include <list>
53#include <string>
54#include <vector>
55
56#include "base/cprintf.hh"
57#include "base/logging.hh"
58#include "base/types.hh"
59#include "config/have_protobuf.hh"
60#include "python/pybind11/pybind.hh"
61#include "sim/async.hh"
62#include "sim/core.hh"
63
64#if HAVE_PROTOBUF
65#include <google/protobuf/stubs/common.h>
66
67#endif
68
69using namespace std;
70namespace py = pybind11;
71
72// The python library is totally messed up with respect to constness,
73// so make a simple macro to make life a little easier
74#define PyCC(x) (const_cast<char *>(x))
75
76EmbeddedPython *EmbeddedPython::importer = NULL;
77PyObject *EmbeddedPython::importerModule = NULL;
78EmbeddedPython::EmbeddedPython(const char *filename, const char *abspath,
79 const char *modpath, const unsigned char *code, int zlen, int len)
80 : filename(filename), abspath(abspath), modpath(modpath), code(code),
81 zlen(zlen), len(len)
82{
83 // if we've added the importer keep track of it because we need it
84 // to bootstrap.
85 if (string(modpath) == string("importer"))
86 importer = this;
87 else
88 getList().push_back(this);
89}
90
91list<EmbeddedPython *> &
92EmbeddedPython::getList()
93{
94 static list<EmbeddedPython *> the_list;
95 return the_list;
96}
97
98/*
99 * Uncompress and unmarshal the code object stored in the
100 * EmbeddedPython
101 */
102PyObject *
103EmbeddedPython::getCode() const
104{
105 Bytef marshalled[len];
106 uLongf unzlen = len;
107 int ret = uncompress(marshalled, &unzlen, (const Bytef *)code, zlen);
108 if (ret != Z_OK)
109 panic("Could not uncompress code: %s\n", zError(ret));
110 assert(unzlen == (uLongf)len);
111
112 return PyMarshal_ReadObjectFromString((char *)marshalled, len);
113}
114
115bool
116EmbeddedPython::addModule() const
117{
118 PyObject *code = getCode();
119 PyObject *result = PyObject_CallMethod(importerModule, PyCC("add_module"),
120 PyCC("sssO"), filename, abspath, modpath, code);
121 if (!result) {
122 PyErr_Print();
123 return false;
124 }
125
126 Py_DECREF(result);
127 return true;
128}
129
130/*
131 * Load and initialize all of the python parts of M5.
132 */
133int
134EmbeddedPython::initAll()
135{
136 // Load the importer module
137 PyObject *code = importer->getCode();
138 importerModule = PyImport_ExecCodeModule(PyCC("importer"), code);
139 if (!importerModule) {
140 PyErr_Print();
141 return 1;
142 }
143
144 // Load the rest of the embedded python files into the embedded
145 // python importer
146 list<EmbeddedPython *>::iterator i = getList().begin();
147 list<EmbeddedPython *>::iterator end = getList().end();
148 for (; i != end; ++i)
149 if (!(*i)->addModule())
150 return 1;
151
152 return 0;
153}
154
155EmbeddedPyBind::EmbeddedPyBind(const char *_name,
156 void (*init_func)(py::module &),
157 const char *_base)
158 : initFunc(init_func), registered(false), name(_name), base(_base)
159{
160 getMap()[_name] = this;
161}
162
163EmbeddedPyBind::EmbeddedPyBind(const char *_name,
164 void (*init_func)(py::module &))
165 : initFunc(init_func), registered(false), name(_name), base("")
166{
167 getMap()[_name] = this;
168}
169
170void
171EmbeddedPyBind::init(py::module &m)
172{
173 if (!registered) {
174 initFunc(m);
175 registered = true;
176 } else {
177 cprintf("Warning: %s already registered.\n", name);
178 }
179}
180
181bool
182EmbeddedPyBind::depsReady() const
183{
184 return base.empty() || getMap()[base]->registered;
185}
186
187std::map<std::string, EmbeddedPyBind *> &
188EmbeddedPyBind::getMap()
189{
190 static std::map<std::string, EmbeddedPyBind *> objs;
191 return objs;
192}
193
194#if PY_MAJOR_VERSION >= 3
195PyObject *
196#else
194void
197void
198#endif
195EmbeddedPyBind::initAll()
196{
197 std::list<EmbeddedPyBind *> pending;
198
199 py::module m_m5 = py::module("_m5");
200 m_m5.attr("__package__") = py::cast("_m5");
201
202 pybind_init_core(m_m5);
203 pybind_init_debug(m_m5);
204
205 pybind_init_event(m_m5);
206 pybind_init_pyobject(m_m5);
207 pybind_init_stats(m_m5);
208
209 for (auto &kv : getMap()) {
210 auto &obj = kv.second;
211 if (obj->base.empty()) {
212 obj->init(m_m5);
213 } else {
214 pending.push_back(obj);
215 }
216 }
217
218 while (!pending.empty()) {
219 for (auto it = pending.begin(); it != pending.end(); ) {
220 EmbeddedPyBind &obj = **it;
221 if (obj.depsReady()) {
222 obj.init(m_m5);
223 it = pending.erase(it);
224 } else {
225 ++it;
226 }
227 }
228 }
199EmbeddedPyBind::initAll()
200{
201 std::list<EmbeddedPyBind *> pending;
202
203 py::module m_m5 = py::module("_m5");
204 m_m5.attr("__package__") = py::cast("_m5");
205
206 pybind_init_core(m_m5);
207 pybind_init_debug(m_m5);
208
209 pybind_init_event(m_m5);
210 pybind_init_pyobject(m_m5);
211 pybind_init_stats(m_m5);
212
213 for (auto &kv : getMap()) {
214 auto &obj = kv.second;
215 if (obj->base.empty()) {
216 obj->init(m_m5);
217 } else {
218 pending.push_back(obj);
219 }
220 }
221
222 while (!pending.empty()) {
223 for (auto it = pending.begin(); it != pending.end(); ) {
224 EmbeddedPyBind &obj = **it;
225 if (obj.depsReady()) {
226 obj.init(m_m5);
227 it = pending.erase(it);
228 } else {
229 ++it;
230 }
231 }
232 }
233
234#if PY_MAJOR_VERSION >= 3
235 return m_m5.ptr();
236#endif
229}
230
237}
238
231int
232initM5Python()
239void
240registerNativeModules()
233{
241{
234 EmbeddedPyBind::initAll();
235 return EmbeddedPython::initAll();
242 auto result = PyImport_AppendInittab("_m5", EmbeddedPyBind::initAll);
243 if (result == -1)
244 panic("Failed to add _m5 to Python's inittab\n");
236}
237
238/*
239 * Make the commands array weak so that they can be overridden (used
240 * by unit tests to specify a different python main function.
241 */
242const char * __attribute__((weak)) m5MainCommands[] = {
243 "import m5",
244 "m5.main()",
245 0 // sentinel is required
246};
247
248/*
249 * Start up the M5 simulator. This mostly vectors into the python
250 * main function.
251 */
252int
253m5Main(int argc, char **_argv)
254{
255#if HAVE_PROTOBUF
256 // Verify that the version of the protobuf library that we linked
257 // against is compatible with the version of the headers we
258 // compiled against.
259 GOOGLE_PROTOBUF_VERIFY_VERSION;
260#endif
261
262
263#if PY_MAJOR_VERSION >= 3
264 typedef std::unique_ptr<wchar_t[], decltype(&PyMem_RawFree)> WArgUPtr;
265 std::vector<WArgUPtr> v_argv;
266 std::vector<wchar_t *> vp_argv;
267 v_argv.reserve(argc);
268 vp_argv.reserve(argc);
269 for (int i = 0; i < argc; i++) {
270 v_argv.emplace_back(Py_DecodeLocale(_argv[i], NULL), &PyMem_RawFree);
271 vp_argv.emplace_back(v_argv.back().get());
272 }
273
274 wchar_t **argv = vp_argv.data();
275#else
276 char **argv = _argv;
277#endif
278
279 PySys_SetArgv(argc, argv);
280
281 // We have to set things up in the special __main__ module
282 PyObject *module = PyImport_AddModule(PyCC("__main__"));
283 if (module == NULL)
284 panic("Could not import __main__");
285 PyObject *dict = PyModule_GetDict(module);
286
287 // import the main m5 module
288 PyObject *result;
289 const char **command = m5MainCommands;
290
291 // evaluate each command in the m5MainCommands array (basically a
292 // bunch of python statements.
293 while (*command) {
294 result = PyRun_String(*command, Py_file_input, dict, dict);
295 if (!result) {
296 PyErr_Print();
297 return 1;
298 }
299 Py_DECREF(result);
300
301 command++;
302 }
303
304#if HAVE_PROTOBUF
305 google::protobuf::ShutdownProtobufLibrary();
306#endif
307
308 return 0;
309}
245}
246
247/*
248 * Make the commands array weak so that they can be overridden (used
249 * by unit tests to specify a different python main function.
250 */
251const char * __attribute__((weak)) m5MainCommands[] = {
252 "import m5",
253 "m5.main()",
254 0 // sentinel is required
255};
256
257/*
258 * Start up the M5 simulator. This mostly vectors into the python
259 * main function.
260 */
261int
262m5Main(int argc, char **_argv)
263{
264#if HAVE_PROTOBUF
265 // Verify that the version of the protobuf library that we linked
266 // against is compatible with the version of the headers we
267 // compiled against.
268 GOOGLE_PROTOBUF_VERIFY_VERSION;
269#endif
270
271
272#if PY_MAJOR_VERSION >= 3
273 typedef std::unique_ptr<wchar_t[], decltype(&PyMem_RawFree)> WArgUPtr;
274 std::vector<WArgUPtr> v_argv;
275 std::vector<wchar_t *> vp_argv;
276 v_argv.reserve(argc);
277 vp_argv.reserve(argc);
278 for (int i = 0; i < argc; i++) {
279 v_argv.emplace_back(Py_DecodeLocale(_argv[i], NULL), &PyMem_RawFree);
280 vp_argv.emplace_back(v_argv.back().get());
281 }
282
283 wchar_t **argv = vp_argv.data();
284#else
285 char **argv = _argv;
286#endif
287
288 PySys_SetArgv(argc, argv);
289
290 // We have to set things up in the special __main__ module
291 PyObject *module = PyImport_AddModule(PyCC("__main__"));
292 if (module == NULL)
293 panic("Could not import __main__");
294 PyObject *dict = PyModule_GetDict(module);
295
296 // import the main m5 module
297 PyObject *result;
298 const char **command = m5MainCommands;
299
300 // evaluate each command in the m5MainCommands array (basically a
301 // bunch of python statements.
302 while (*command) {
303 result = PyRun_String(*command, Py_file_input, dict, dict);
304 if (!result) {
305 PyErr_Print();
306 return 1;
307 }
308 Py_DECREF(result);
309
310 command++;
311 }
312
313#if HAVE_PROTOBUF
314 google::protobuf::ShutdownProtobufLibrary();
315#endif
316
317 return 0;
318}
310
311PyMODINIT_FUNC
312initm5(void)
313{
314 initM5Python();
315 PyImport_ImportModule(PyCC("m5"));
316}