aboutsummaryrefslogtreecommitdiff
path: root/tools/lldb-mi/MIUtilDebug.h
blob: b163b05f5de5b22c1dfa04075566dfef1c6fe49f (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
//===-- MIUtilDebug.h -------------------------------------------*- C++ -*-===//
//
//                     The LLVM Compiler Infrastructure
//
// This file is distributed under the University of Illinois Open Source
// License. See LICENSE.TXT for details.
//
//===----------------------------------------------------------------------===//

//++
// File:		MIUtilDebug.h
//
// Overview:	CMIUtilDebug interface.
//
// Environment:	Compilers:	Visual C++ 12.
//							gcc (Ubuntu/Linaro 4.8.1-10ubuntu9) 4.8.1
//				Libraries:	See MIReadmetxt. 
//
// Copyright:	None.
//--

#pragma once

#define MI_USE_DEBUG_TRACE_FN // Undefine to compile out fn trace code

// In-house headers:
#include "MIUtilString.h"

// Declarations:
class CMICmnLog;

//++ ============================================================================
// Details:	MI debugging aid utility class.
// Gotchas:	None.
// Authors:	
// Changes:	None.
//--
class CMIUtilDebug 
{
// Statics:
public:
	static void	ShowDlgWaitForDbgAttach( void );
	static void	WaitForDbgAttachInfinteLoop( void );
	
// Methods:
public:
	/* ctor */	CMIUtilDebug( void );

// Overrideable:
public:
	// From CMICmnBase
	/* dtor */ virtual ~CMIUtilDebug( void );
};

//++ ============================================================================
// Details:	MI debug utility class. Used to indicate the current function
//			depth in the call stack. It uses the CMIlCmnLog logger to output
//			the current fn trace information.
//			Use macro MI_TRACEFN( "Some fn name" ) and implement the scope of
//			the functions you wish to build up a trace off.
//			Use preprocessor definition MI_USE_DEBUG_TRACE_FN to turn off or on
//			tracing code.
// Gotchas:	None.
// Authors:	Illya Rudkin 07/03/2014.
// Changes:	None.
//--
class CMIUtilDebugFnTrace
{
// Methods:
public:
	/* ctor */	CMIUtilDebugFnTrace( const CMIUtilString & vFnName );

// Overrideable:
public:
	// From CMICmnBase
	/* dtor */ virtual ~CMIUtilDebugFnTrace( void );

// Attributes:
private:
	const CMIUtilString m_strFnName;
	
	static CMICmnLog &	ms_rLog;
	static MIuint		ms_fnDepthCnt;	// Increment count as fn depth increases, decrement count as fn stack pops off
};

//++ ============================================================================
// Details:	Take the given text and send it to the server's Logger to output to the
//			trace file.
// Type:	Compile preprocess.
// Args:	x	- (R) Message (may be seen by user).
//--
#ifdef MI_USE_DEBUG_TRACE_FN
#define MI_TRACEFN( x ) CMIUtilDebugFnTrace __MITrace( x )
#else
#define	MI_TRACEFN( x )
#endif // MI_USE_DEBUG_TRACE_FN