summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSteve Reinhardt <stever@eecs.umich.edu>2005-05-25 16:06:12 -0400
committerSteve Reinhardt <stever@eecs.umich.edu>2005-05-25 16:06:12 -0400
commit8f0e0bd2647988c1a4e785ba3cafb1037fbfb4d6 (patch)
treefdeca7490c829635881b99f68bc148bf892eb57b
parent432e779fb04470ae62ca47fe3ed9e00defd3e678 (diff)
parente8b62d05ddf101a03ab82106bd870a981b8b34ad (diff)
downloadgem5-8f0e0bd2647988c1a4e785ba3cafb1037fbfb4d6.tar.xz
Merge zizzer.eecs.umich.edu:/z/m5/Bitkeeper/m5
into zizzer.eecs.umich.edu:/z/stever/bk/m5 --HG-- extra : convert_revision : 13696a8e526f7ded7555d009d03bdc7551557571
-rw-r--r--base/misc.hh13
1 files changed, 11 insertions, 2 deletions
diff --git a/base/misc.hh b/base/misc.hh
index a4f9a99c5..ac5eab1cb 100644
--- a/base/misc.hh
+++ b/base/misc.hh
@@ -33,7 +33,11 @@
#include "base/cprintf.hh"
//
-// This implements a cprintf based panic
+// This implements a cprintf based panic() function. panic() should
+// be called when something happens that should never ever happen
+// regardless of what the user does (i.e., an acutal m5 bug). panic()
+// calls abort which can dump core or enter the debugger.
+//
//
void __panic(const std::string&, cp::ArgList &, const char*, const char*, int)
__attribute__((noreturn));
@@ -44,7 +48,12 @@ void __panic(const std::string&, cp::ArgList &, const char*, const char*, int)
__panic__(args, cp::ArgListNull())
//
-// This implements a cprintf based fatal
+// This implements a cprintf based fatal() function. fatal() should
+// be called when the simulation cannot continue due to some condition
+// that is the user's fault (bad configuration, invalid arguments,
+// etc.) and not a simulator bug. fatal() calls exit(1), i.e., a
+// "normal" exit with an error code, as opposed to abort() like
+// panic() does.
//
void __fatal(const std::string&, cp::ArgList &, const char*, const char*, int)
__attribute__((noreturn));