summaryrefslogtreecommitdiff
path: root/src/cpu
diff options
context:
space:
mode:
authorAli Saidi <Ali.Saidi@ARM.com>2015-02-16 03:32:38 -0500
committerAli Saidi <Ali.Saidi@ARM.com>2015-02-16 03:32:38 -0500
commit4eff4fa12eafbf6337fdf9a23668880ad55aad9c (patch)
tree7ea64da7b8684c00ba127ffbe8ccca5d0cbeebff /src/cpu
parent268d9e59c5e69a00456a40c837b0150a8f3f6bf8 (diff)
downloadgem5-4eff4fa12eafbf6337fdf9a23668880ad55aad9c.tar.xz
cpu: add support for outputing a protobuf formatted CPU trace
Doesn't support x86 due to static instruction representation. --HG-- rename : src/cpu/CPUTracers.py => src/cpu/InstPBTrace.py
Diffstat (limited to 'src/cpu')
-rw-r--r--src/cpu/InstPBTrace.py37
-rw-r--r--src/cpu/SConscript5
-rw-r--r--src/cpu/inst_pb_trace.cc178
-rw-r--r--src/cpu/inst_pb_trace.hh135
4 files changed, 355 insertions, 0 deletions
diff --git a/src/cpu/InstPBTrace.py b/src/cpu/InstPBTrace.py
new file mode 100644
index 000000000..2576fc944
--- /dev/null
+++ b/src/cpu/InstPBTrace.py
@@ -0,0 +1,37 @@
+# Copyright (c) 2007 The Regents of The University of Michigan
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met: redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer;
+# redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution;
+# neither the name of the copyright holders nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# Authors: Gabe Black
+
+from m5.SimObject import SimObject
+from m5.params import *
+from InstTracer import InstTracer
+
+class InstPBTrace(InstTracer):
+ type = 'InstPBTrace'
+ cxx_class = 'Trace::InstPBTrace'
+ cxx_header = 'cpu/inst_pb_trace.hh'
+ file_name = Param.String("Instruction trace output file")
diff --git a/src/cpu/SConscript b/src/cpu/SConscript
index 22388e6d9..f2c4f2c06 100644
--- a/src/cpu/SConscript
+++ b/src/cpu/SConscript
@@ -35,6 +35,11 @@ if env['TARGET_ISA'] == 'null':
Source('intr_control_noisa.cc')
Return()
+# Only build the protocol buffer instructions tracer if we have protobuf support
+if env['HAVE_PROTOBUF'] and env['TARGET_ISA'] != 'x86':
+ SimObject('InstPBTrace.py')
+ Source('inst_pb_trace.cc')
+
SimObject('CheckerCPU.py')
SimObject('BaseCPU.py')
diff --git a/src/cpu/inst_pb_trace.cc b/src/cpu/inst_pb_trace.cc
new file mode 100644
index 000000000..e6ed425ec
--- /dev/null
+++ b/src/cpu/inst_pb_trace.cc
@@ -0,0 +1,178 @@
+/*
+ * Copyright (c) 2014 ARM Limited
+ * All rights reserved
+ *
+ * The license below extends only to copyright in the software and shall
+ * not be construed as granting a license to any other intellectual
+ * property including but not limited to intellectual property relating
+ * to a hardware implementation of the functionality of the software
+ * licensed hereunder. You may use the software subject to the license
+ * terms below provided that you ensure that this notice is replicated
+ * unmodified and in its entirety in all distributions of the software,
+ * modified or unmodified, in source code or in binary form.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met: redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer;
+ * redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution;
+ * neither the name of the copyright holders nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * Authors: Ali Saidi
+ */
+
+#include "cpu/inst_pb_trace.hh"
+
+#include "base/callback.hh"
+#include "base/output.hh"
+#include "config/the_isa.hh"
+#include "cpu/static_inst.hh"
+#include "cpu/thread_context.hh"
+#include "debug/ExecEnable.hh"
+#include "params/InstPBTrace.hh"
+#include "proto/inst.pb.h"
+#include "sim/core.hh"
+
+namespace Trace {
+
+ProtoOutputStream *InstPBTrace::traceStream;
+
+void
+InstPBTraceRecord::dump()
+{
+ // We're trying to build an instruction trace so we just want macro-ops and
+ // instructions that aren't macro-oped
+ if ((macroStaticInst && staticInst->isFirstMicroop()) ||
+ !staticInst->isMicroop()) {
+ tracer.traceInst(thread, staticInst, pc);
+ }
+
+ // If this instruction accessed memory lets record it
+ if (getMemValid())
+ tracer.traceMem(staticInst, getAddr(), getSize(), getFlags());
+}
+
+InstPBTrace::InstPBTrace(const InstPBTraceParams *p)
+ : InstTracer(p), curMsg(nullptr)
+{
+ // Create our output file
+ createTraceFile(p->file_name);
+}
+
+void
+InstPBTrace::createTraceFile(std::string filename)
+{
+ // Since there is only one output file for all tracers check if it exists
+ if (traceStream)
+ return;
+
+ traceStream = new ProtoOutputStream(simout.resolve(filename));
+
+ // Output the header
+ ProtoMessage::InstHeader header_msg;
+ header_msg.set_obj_id("gem5 generated instruction trace");
+ header_msg.set_ver(0);
+ header_msg.set_tick_freq(SimClock::Frequency);
+ header_msg.set_has_mem(true);
+ traceStream->write(header_msg);
+
+ // get a callback when we exit so we can close the file
+ Callback *cb = new MakeCallback<InstPBTrace,
+ &InstPBTrace::closeStreams>(this);
+ registerExitCallback(cb);
+}
+
+void
+InstPBTrace::closeStreams()
+{
+ if (curMsg) {
+ traceStream->write(*curMsg);
+ delete curMsg;
+ curMsg = NULL;
+ }
+
+ if (!traceStream)
+ return;
+
+ delete traceStream;
+ traceStream = NULL;
+}
+
+InstPBTrace::~InstPBTrace()
+{
+ closeStreams();
+}
+
+InstPBTraceRecord*
+InstPBTrace::getInstRecord(Tick when, ThreadContext *tc, const StaticInstPtr si,
+ TheISA::PCState pc, const StaticInstPtr mi)
+{
+ // Only record the trace if Exec debugging in enabled
+ if (!Trace::enabled || !Debug::ExecEnable)
+ return NULL;
+
+ return new InstPBTraceRecord(*this, when, tc, si, pc, mi);
+
+}
+
+void
+InstPBTrace::traceInst(ThreadContext *tc, StaticInstPtr si, TheISA::PCState pc)
+{
+ if (curMsg) {
+ /// @todo if we are running multi-threaded I assume we'd need a lock here
+ traceStream->write(*curMsg);
+ delete curMsg;
+ curMsg = NULL;
+ }
+
+ // Create a new instruction message and fill out the fields
+ curMsg = new ProtoMessage::Inst;
+ curMsg->set_pc(pc.pc());
+ curMsg->set_inst(static_cast<uint32_t>(bits(si->machInst, 31, 0)));
+ curMsg->set_cpuid(tc->cpuId());
+ curMsg->set_tick(curTick());
+ curMsg->set_type(static_cast<ProtoMessage::Inst_InstType>(si->opClass()));
+ curMsg->set_inst_flags(bits(si->machInst, 7, 0));
+
+}
+
+void
+InstPBTrace::traceMem(StaticInstPtr si, Addr a, Addr s, unsigned f)
+{
+ panic_if(!curMsg, "Memory access w/o msg?!");
+
+ // We do a poor job identifying macro-ops that are load/stores
+ curMsg->set_type(static_cast<ProtoMessage::Inst_InstType>(si->opClass()));
+
+ ProtoMessage::Inst::MemAccess *mem_msg = curMsg->add_mem_access();
+ mem_msg->set_addr(a);
+ mem_msg->set_size(s);
+ mem_msg->set_mem_flags(f);
+
+}
+
+} // namespace Trace
+
+
+Trace::InstPBTrace*
+InstPBTraceParams::create()
+{
+ return new Trace::InstPBTrace(this);
+}
+
diff --git a/src/cpu/inst_pb_trace.hh b/src/cpu/inst_pb_trace.hh
new file mode 100644
index 000000000..326f8b93a
--- /dev/null
+++ b/src/cpu/inst_pb_trace.hh
@@ -0,0 +1,135 @@
+/*
+ * Copyright (c) 2014 ARM Limited
+ * All rights reserved
+ *
+ * The license below extends only to copyright in the software and shall
+ * not be construed as granting a license to any other intellectual
+ * property including but not limited to intellectual property relating
+ * to a hardware implementation of the functionality of the software
+ * licensed hereunder. You may use the software subject to the license
+ * terms below provided that you ensure that this notice is replicated
+ * unmodified and in its entirety in all distributions of the software,
+ * modified or unmodified, in source code or in binary form.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met: redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer;
+ * redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution;
+ * neither the name of the copyright holders nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * Authors: Ali Saidi
+ */
+
+#ifndef __CPU_INST_PB_TRACE_HH__
+#define __CPU_INST_PB_TRACE_HH__
+
+#include "arch/types.hh"
+#include "base/trace.hh"
+#include "base/types.hh"
+#include "cpu/static_inst_fwd.hh"
+#include "params/InstPBTrace.hh"
+#include "proto/protoio.hh"
+#include "sim/insttracer.hh"
+
+class ThreadContext;
+
+namespace ProtoMessage {
+class Inst;
+}
+
+namespace Trace {
+
+/**
+ * This in an instruction tracer that records the flow of instructions through
+ * multiple cpus and systems to a protobuf file specified by proto/inst.proto
+ * for further analysis.
+ */
+
+class InstPBTraceRecord : public InstRecord
+{
+ public:
+ InstPBTraceRecord(InstPBTrace& _tracer, Tick when, ThreadContext *tc,
+ const StaticInstPtr si, TheISA::PCState pc,
+ const StaticInstPtr mi = NULL)
+ : InstRecord(when, tc, si, pc, mi), tracer(_tracer)
+ {}
+
+ /** called by the cpu when the instruction commits.
+ * This implementation of dump calls InstPBTrace to output the contents to a
+ * protobuf file
+ */
+ void dump() M5_ATTR_OVERRIDE;
+
+ protected:
+ InstPBTrace& tracer;
+
+};
+
+class InstPBTrace : InstTracer
+{
+ public:
+ InstPBTrace(const InstPBTraceParams *p);
+ virtual ~InstPBTrace();
+
+ InstPBTraceRecord* getInstRecord(Tick when, ThreadContext *tc, const
+ StaticInstPtr si, TheISA::PCState pc, const
+ StaticInstPtr mi = NULL) M5_ATTR_OVERRIDE;
+
+ protected:
+ /** One output stream for the entire simulation.
+ * We encode the CPU & system ID so all we need is a single file
+ */
+ static ProtoOutputStream *traceStream;
+
+
+ /** This is the message were working on writing. The majority of the message
+ * exists however the memory accesses will be delayed.
+ */
+ ProtoMessage::Inst *curMsg;
+
+ /** Create the output file and write the header into it
+ * @param filename the file to create (if ends with .gz it will be
+ * compressed)
+ */
+ void createTraceFile(std::string filename);
+
+ /** If there is a pending message still write it out and then close the file
+ */
+ void closeStreams();
+
+ /** Write an instruction to the trace file
+ * @param tc thread context for the cpu ID
+ * @param si for the machInst and opClass
+ * @param pc for the PC Addr
+ */
+ void traceInst(ThreadContext *tc, StaticInstPtr si, TheISA::PCState pc);
+
+ /** Write a memory request to the trace file as part of the cur instruction
+ * @param si for the machInst and opClass
+ * @param a address of the request
+ * @param s size of the request
+ * @param f flags for the request
+ */
+ void traceMem(StaticInstPtr si, Addr a, Addr s, unsigned f);
+
+ friend class InstPBTraceRecord;
+};
+} // namespace Trace
+#endif // __CPU_INST_PB_TRACE_HH__