2 * Copyright (c) 2001-2004 The Regents of The University of Michigan
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions are
7 * met: redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer;
9 * redistributions in binary form must reproduce the above copyright
10 * notice, this list of conditions and the following disclaimer in the
11 * documentation and/or other materials provided with the distribution;
12 * neither the name of the copyright holders nor the names of its
13 * contributors may be used to endorse or promote products derived from
14 * this software without specific prior written permission.
16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
17 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
18 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
19 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
20 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
26 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36 #include "base/misc.hh"
37 #include "base/trace.hh"
38 #include "base/str.hh"
43 const string
DefaultName("global");
44 FlagVec
flags(NumFlags
, false);
47 // This variable holds the output stream for debug information. Other
48 // than setting up/redirecting this stream, do *NOT* reference this
49 // directly; use DebugOut() (see below) to access this stream for
52 ostream
*dprintf_stream
= &cerr
;
69 fatal("Trace::Log::init called twice!");
74 buffer
= new (Record
*)[size
];
76 for (int i
= 0; i
< size
; ++i
) {
80 nextRecPtr
= &buffer
[0];
81 wrapRecPtr
= &buffer
[size
];
87 for (int i
= 0; i
< size
; ++i
) {
96 Log::append(Record
*rec
)
98 // dump record to output stream if there's one open
99 if (dprintf_stream
!= NULL
) {
100 rec
->dump(*dprintf_stream
);
103 // no buffering: justget rid of it now
104 if (buffer
== NULL
) {
109 Record
*oldRec
= *nextRecPtr
;
111 if (oldRec
!= NULL
) {
112 // log has wrapped: overwrite
118 if (++nextRecPtr
== wrapRecPtr
) {
119 nextRecPtr
= &buffer
[0];
125 Log::dump(ostream
&os
)
127 if (buffer
== NULL
) {
131 Record
**bufPtr
= nextRecPtr
;
133 if (*bufPtr
== NULL
) {
134 // next record slot is empty: log must not be full yet.
135 // start dumping from beginning of buffer
140 Record
*rec
= *bufPtr
;
144 if (++bufPtr
== wrapRecPtr
) {
147 } while (bufPtr
!= nextRecPtr
);
150 PrintfRecord::~PrintfRecord()
156 PrintfRecord::dump(ostream
&os
)
165 if (cycle
!= (Tick
)-1) {
176 DataRecord::DataRecord(Tick _cycle
, const string
&_name
,
177 const void *_data
, int _len
)
178 : Record(_cycle
), name(_name
), len(_len
)
180 data
= new uint8_t[len
];
181 memcpy(data
, _data
, len
);
184 DataRecord::~DataRecord()
190 DataRecord::dump(ostream
&os
)
194 for (i
= 0; i
< len
; i
+= 16) {
195 ccprintf(os
, "%d: %s: %08x ", cycle
, name
, i
);
199 for (j
= 0; j
< c
; j
++) {
200 ccprintf(os
, "%02x ", data
[i
+ j
] & 0xff);
201 if ((j
& 0xf) == 7 && j
> 0)
209 for (j
= 0; j
< c
; j
++) {
210 int ch
= data
[i
+ j
] & 0x7f;
212 "%c", (char)(isprint(ch
) ? ch
: ' '));
224 // Returns the current output stream for debug information. As a
225 // wrapper around Trace::dprintf_stream, this handles cases where debug
226 // information is generated in the process of parsing .ini options,
227 // before we process the option that sets up the debug output stream
233 return *Trace::dprintf_stream
;
236 /////////////////////////////////////////////
238 // C-linkage functions for invoking from gdb
240 /////////////////////////////////////////////
243 // Dump trace buffer to specified file (cout if NULL)
247 dumpTrace(const char *filename
)
249 if (filename
!= NULL
) {
250 ofstream
out(filename
);
251 Trace::theLog
.dump(out
);
255 Trace::theLog
.dump(cout
);
261 // Turn on/off trace output to cerr. Typically used when trace output
262 // is only going to circular buffer, but you want to see what's being
263 // sent there as you step through some code in gdb. This uses the
264 // same facility as the "trace to file" feature, and will print error
265 // messages rather than clobbering an existing ostream pointer.
272 if (Trace::dprintf_stream
!= NULL
) {
273 cerr
<< "Already echoing trace to a file... go do a 'tail -f'"
274 << " on that file instead." << endl
;
276 Trace::dprintf_stream
= &cerr
;
279 if (Trace::dprintf_stream
!= &cerr
) {
280 cerr
<< "Not echoing trace to cerr." << endl
;
282 Trace::dprintf_stream
= NULL
;
291 using namespace Trace
;
292 for (int i
= 0; i
< numFlagStrings
; ++i
)
294 cprintf("%s\n", flagStrings
[i
]);
298 tweakTraceFlag(const char *string
, bool value
)
300 using namespace Trace
;
301 std::string
str(string
);
303 for (int i
= 0; i
< numFlagStrings
; ++i
) {
304 if (str
!= flagStrings
[i
])
309 if (idx
< NumFlags
) {
313 if (idx
>= NumCompoundFlags
) {
314 ccprintf(cerr
, "Invalid compound flag");
318 const Flags
*flagVec
= compoundFlags
[idx
];
320 for (int j
= 0; flagVec
[j
] != -1; ++j
) {
321 if (flagVec
[j
] >= NumFlags
) {
322 ccprintf(cerr
, "Invalid compound flag");
325 flags
[flagVec
[j
]] = value
;
329 cprintf("flag %s was %s\n", string
, value
? "set" : "cleared");
333 cprintf("could not find flag %s\n", string
);
338 setTraceFlag(const char *string
)
340 tweakTraceFlag(string
, true);
345 clearTraceFlag(const char *string
)
347 tweakTraceFlag(string
, false);