X86: Add microops which panic, fatal, warn, and warn_once.
authorGabe Black <gblack@eecs.umich.edu>
Thu, 12 Jun 2008 04:49:25 +0000 (00:49 -0400)
committerGabe Black <gblack@eecs.umich.edu>
Thu, 12 Jun 2008 04:49:25 +0000 (00:49 -0400)
src/arch/x86/isa/includes.isa
src/arch/x86/isa/microops/debug.isa [new file with mode: 0644]
src/arch/x86/isa/microops/microops.isa

index 6724ea9b0730f6024f895d0ff802af7b2981429b..6d0fe6d860a57c4453d9bf981c26abf89700da97 100644 (file)
@@ -26,7 +26,7 @@
 //
 // Authors: Gabe Black
 
-// Copyright (c) 2007 The Hewlett-Packard Development Company
+// Copyright (c) 2007-2008 The Hewlett-Packard Development Company
 // All rights reserved.
 //
 // Redistribution and use of this software in source and binary forms,
@@ -117,6 +117,7 @@ output decoder {{
 #include "arch/x86/segmentregs.hh"
 #include "base/cprintf.hh"
 #include "base/loader/symtab.hh"
+#include "base/misc.hh"
 #include "cpu/thread_context.hh"  // for Jump::branchTarget()
 #include "mem/packet.hh"
 
diff --git a/src/arch/x86/isa/microops/debug.isa b/src/arch/x86/isa/microops/debug.isa
new file mode 100644 (file)
index 0000000..7456b0d
--- /dev/null
@@ -0,0 +1,229 @@
+// Copyright (c) 2008 The Hewlett-Packard Development Company
+// All rights reserved.
+//
+// Redistribution and use of this software in source and binary forms,
+// with or without modification, are permitted provided that the
+// following conditions are met:
+//
+// The software must be used only for Non-Commercial Use which means any
+// use which is NOT directed to receiving any direct monetary
+// compensation for, or commercial advantage from such use.  Illustrative
+// examples of non-commercial use are academic research, personal study,
+// teaching, education and corporate research & development.
+// Illustrative examples of commercial use are distributing products for
+// commercial advantage and providing services using the software for
+// commercial advantage.
+//
+// If you wish to use this software or functionality therein that may be
+// covered by patents for commercial use, please contact:
+//     Director of Intellectual Property Licensing
+//     Office of Strategy and Technology
+//     Hewlett-Packard Company
+//     1501 Page Mill Road
+//     Palo Alto, California  94304
+//
+// 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 HOLDER(s), HEWLETT-PACKARD COMPANY, nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.  No right of
+// sublicense is granted herewith.  Derivatives of the software and
+// output created using the software may be prepared, but only for
+// Non-Commercial Uses.  Derivatives of the software may be shared with
+// others provided: (i) the others agree to abide by the list of
+// conditions herein which includes the Non-Commercial Use restrictions;
+// and (ii) such Derivatives of the software include the above copyright
+// notice to acknowledge the contribution from this software where
+// applicable, this list of conditions and the disclaimer below.
+//
+// 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
+
+//////////////////////////////////////////////////////////////////////////
+//
+// Debug Microops
+//
+//////////////////////////////////////////////////////////////////////////
+
+output header {{
+    class MicroDebugBase : public X86ISA::X86MicroopBase
+    {
+      protected:
+        std::string message;
+        uint8_t cc;
+
+      public:
+        MicroDebugBase(ExtMachInst _machInst, const char * mnem,
+                const char * instMnem,
+                bool isMicro, bool isDelayed, bool isFirst, bool isLast,
+                std::string _message, uint8_t _cc);
+
+        MicroDebugBase(ExtMachInst _machInst, const char * mnem,
+                const char * instMnem, std::string _message, uint8_t _cc);
+
+        std::string generateDisassembly(Addr pc,
+                const SymbolTable *symtab) const;
+    };
+}};
+
+def template MicroDebugDeclare {{
+    class %(class_name)s : public %(base_class)s
+    {
+      private:
+        void buildMe();
+      public:
+        %(class_name)s(ExtMachInst _machInst, const char * instMnem,
+                bool isMicro, bool isDelayed, bool isFirst, bool isLast,
+                std::string _message, uint8_t _cc);
+
+        %(class_name)s(ExtMachInst _machInst, const char * instMnem,
+                std::string _message, uint8_t _cc);
+
+        %(BasicExecDeclare)s
+    };
+}};
+
+def template MicroDebugExecute {{
+        Fault %(class_name)s::execute(%(CPU_exec_context)s *xc,
+                Trace::InstRecord *traceData) const
+        {
+            %(op_decl)s
+            %(op_rd)s
+            if (%(cond_test)s) {
+                %(func)s(message + "\n");
+            }
+            return NoFault;
+        }
+}};
+
+output decoder {{
+    inline MicroDebugBase::MicroDebugBase(
+            ExtMachInst machInst, const char * mnem, const char * instMnem,
+            std::string _message, uint8_t _cc) :
+        X86MicroopBase(machInst, mnem, instMnem,
+                false, false, false, false, No_OpClass),
+        message(_message), cc(_cc)
+    {
+    }
+
+    inline MicroDebugBase::MicroDebugBase(
+            ExtMachInst machInst, const char * mnem, const char * instMnem,
+            bool isMicro, bool isDelayed, bool isFirst, bool isLast,
+            std::string _message, uint8_t _cc) :
+        X86MicroopBase(machInst, mnem, instMnem,
+                isMicro, isDelayed, isFirst, isLast, No_OpClass),
+                message(_message), cc(_cc)
+    {
+    }
+}};
+
+def template MicroDebugConstructor {{
+
+    inline void %(class_name)s::buildMe()
+    {
+        %(constructor)s;
+    }
+
+    inline %(class_name)s::%(class_name)s(
+            ExtMachInst machInst, const char * instMnem,
+            std::string _message, uint8_t _cc) :
+        %(base_class)s(machInst, "%(func)s", instMnem, _message, _cc)
+    {
+        buildMe();
+    }
+
+    inline %(class_name)s::%(class_name)s(
+            ExtMachInst machInst, const char * instMnem,
+            bool isMicro, bool isDelayed, bool isFirst, bool isLast,
+            std::string _message, uint8_t _cc) :
+        %(base_class)s(machInst, "%(func)s", instMnem,
+                isMicro, isDelayed, isFirst, isLast, _message, _cc)
+    {
+        buildMe();
+    }
+}};
+
+output decoder {{
+    std::string MicroDebugBase::generateDisassembly(Addr pc,
+            const SymbolTable *symtab) const
+    {
+        std::stringstream response;
+
+        printMnemonic(response, instMnem, mnemonic);
+        response << "\"" << message << "\"";
+
+        return response.str();
+    }
+}};
+
+let {{
+    class MicroDebug(X86Microop):
+        def __init__(self, message, flags=None):
+            self.message = message
+            if flags:
+                if not isinstance(flags, (list, tuple)):
+                    raise Exception, "flags must be a list or tuple of flags"
+                self.cond = " | ".join(flags)
+                self.className += "Flags"
+            else:
+                self.cond = "0"
+
+        def getAllocator(self, *microFlags):
+            allocator = '''new %(class_name)s(machInst, mnemonic
+                    %(flags)s, "%(message)s", %(cc)s)''' % {
+                "class_name" : self.className,
+                "flags" : self.microFlagsText(microFlags),
+                "message" : self.message,
+                "cc" : self.cond}
+            return allocator
+
+    exec_output = ""
+    header_output = ""
+    decoder_output = ""
+
+    def buildDebugMicro(func):
+        global exec_output, header_output, decoder_output
+
+        iop = InstObjParams(func, "Micro%sFlags" % func.capitalize(),
+                "MicroDebugBase",
+                {"code": "",
+                 "func": func,
+                 "cond_test": "checkCondition(ccFlagBits, cc)"})
+        exec_output += MicroDebugExecute.subst(iop)
+        header_output += MicroDebugDeclare.subst(iop)
+        decoder_output += MicroDebugConstructor.subst(iop)
+
+        iop = InstObjParams(func, "Micro%s" % func.capitalize(),
+                "MicroDebugBase",
+                {"code": "",
+                 "func": func,
+                 "cond_test": "true"})
+        exec_output += MicroDebugExecute.subst(iop)
+        header_output += MicroDebugDeclare.subst(iop)
+        decoder_output += MicroDebugConstructor.subst(iop)
+
+        class MicroDebugChild(MicroDebug):
+            className = "Micro%s" % func.capitalize()
+
+        global microopClasses
+        microopClasses[func] = MicroDebugChild
+
+    buildDebugMicro("panic")
+    buildDebugMicro("fatal")
+    buildDebugMicro("warn")
+    buildDebugMicro("warn_once")
+}};
index 53f34d3f22d1ab8caa6e4bfa43aaf76b6338d634..1c9e8358a62cafd2cfe5b7ddb661ae7c129e6c96 100644 (file)
@@ -1,4 +1,4 @@
-// Copyright (c) 2007 The Hewlett-Packard Development Company
+// Copyright (c) 2007-2008 The Hewlett-Packard Development Company
 // All rights reserved.
 //
 // Redistribution and use of this software in source and binary forms,
@@ -70,3 +70,6 @@
 
 //Miscellaneous microop definitions
 ##include "specop.isa"
+
+//Microops for printing out debug messages through M5
+##include "debug.isa"