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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
|
/* $Id: MachineDebuggerImpl.h $ */
/** @file
* VirtualBox COM class implementation
*/
/*
* Copyright (C) 2006-2023 Oracle and/or its affiliates.
*
* This file is part of VirtualBox base platform packages, as
* available from https://www.virtualbox.org.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation, in version 3 of the
* License.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, see <https://www.gnu.org/licenses>.
*
* SPDX-License-Identifier: GPL-3.0-only
*/
#ifndef MAIN_INCLUDED_MachineDebuggerImpl_h
#define MAIN_INCLUDED_MachineDebuggerImpl_h
#ifndef RT_WITHOUT_PRAGMA_ONCE
# pragma once
#endif
#include "MachineDebuggerWrap.h"
#include <iprt/log.h>
#include <VBox/vmm/em.h>
class Console;
class Progress;
class ATL_NO_VTABLE MachineDebugger :
public MachineDebuggerWrap
{
public:
DECLARE_COMMON_CLASS_METHODS (MachineDebugger)
HRESULT FinalConstruct();
void FinalRelease();
// public initializer/uninitializer for internal purposes only
HRESULT init (Console *aParent);
void uninit();
// "public-private methods"
void i_flushQueuedSettings();
private:
// wrapped IMachineDeugger properties
HRESULT getSingleStep(BOOL *aSingleStep);
HRESULT setSingleStep(BOOL aSingleStep);
HRESULT getExecuteAllInIEM(BOOL *aExecuteAllInIEM);
HRESULT setExecuteAllInIEM(BOOL aExecuteAllInIEM);
HRESULT getLogEnabled(BOOL *aLogEnabled);
HRESULT setLogEnabled(BOOL aLogEnabled);
HRESULT getLogDbgFlags(com::Utf8Str &aLogDbgFlags);
HRESULT getLogDbgGroups(com::Utf8Str &aLogDbgGroups);
HRESULT getLogDbgDestinations(com::Utf8Str &aLogDbgDestinations);
HRESULT getLogRelFlags(com::Utf8Str &aLogRelFlags);
HRESULT getLogRelGroups(com::Utf8Str &aLogRelGroups);
HRESULT getLogRelDestinations(com::Utf8Str &aLogRelDestinations);
HRESULT getExecutionEngine(VMExecutionEngine_T *apenmEngine);
HRESULT getHWVirtExNestedPagingEnabled(BOOL *aHWVirtExNestedPagingEnabled);
HRESULT getHWVirtExVPIDEnabled(BOOL *aHWVirtExVPIDEnabled);
HRESULT getHWVirtExUXEnabled(BOOL *aHWVirtExUXEnabled);
HRESULT getOSName(com::Utf8Str &aOSName);
HRESULT getOSVersion(com::Utf8Str &aOSVersion);
HRESULT getPAEEnabled(BOOL *aPAEEnabled);
HRESULT getVirtualTimeRate(ULONG *aVirtualTimeRate);
HRESULT setVirtualTimeRate(ULONG aVirtualTimeRate);
HRESULT getUptime(LONG64 *aUptime);
// wrapped IMachineDeugger methods
HRESULT dumpGuestCore(const com::Utf8Str &aFilename,
const com::Utf8Str &aCompression);
HRESULT dumpHostProcessCore(const com::Utf8Str &aFilename,
const com::Utf8Str &aCompression);
HRESULT info(const com::Utf8Str &aName,
const com::Utf8Str &aArgs,
com::Utf8Str &aInfo);
HRESULT injectNMI();
HRESULT modifyLogGroups(const com::Utf8Str &aSettings);
HRESULT modifyLogFlags(const com::Utf8Str &aSettings);
HRESULT modifyLogDestinations(const com::Utf8Str &aSettings);
HRESULT readPhysicalMemory(LONG64 aAddress,
ULONG aSize,
std::vector<BYTE> &aBytes);
HRESULT writePhysicalMemory(LONG64 aAddress,
ULONG aSize,
const std::vector<BYTE> &aBytes);
HRESULT readVirtualMemory(ULONG aCpuId,
LONG64 aAddress,
ULONG aSize,
std::vector<BYTE> &aBytes);
HRESULT writeVirtualMemory(ULONG aCpuId,
LONG64 aAddress,
ULONG aSize,
const std::vector<BYTE> &aBytes);
HRESULT loadPlugIn(const com::Utf8Str &aName,
com::Utf8Str &aPlugInName);
HRESULT unloadPlugIn(const com::Utf8Str &aName);
HRESULT detectOS(com::Utf8Str &aOs);
HRESULT queryOSKernelLog(ULONG aMaxMessages,
com::Utf8Str &aDmesg);
HRESULT getRegister(ULONG aCpuId,
const com::Utf8Str &aName,
com::Utf8Str &aValue);
HRESULT getRegisters(ULONG aCpuId,
std::vector<com::Utf8Str> &aNames,
std::vector<com::Utf8Str> &aValues);
HRESULT setRegister(ULONG aCpuId,
const com::Utf8Str &aName,
const com::Utf8Str &aValue);
HRESULT setRegisters(ULONG aCpuId,
const std::vector<com::Utf8Str> &aNames,
const std::vector<com::Utf8Str> &aValues);
HRESULT dumpGuestStack(ULONG aCpuId,
com::Utf8Str &aStack);
HRESULT resetStats(const com::Utf8Str &aPattern);
HRESULT dumpStats(const com::Utf8Str &aPattern);
HRESULT getStats(const com::Utf8Str &aPattern,
BOOL aWithDescriptions,
com::Utf8Str &aStats);
HRESULT getCPULoad(ULONG aCpuId, ULONG *aPctExecuting, ULONG *aPctHalted, ULONG *aPctOther, LONG64 *aMsInterval) RT_OVERRIDE;
HRESULT takeGuestSample(const com::Utf8Str &aFilename, ULONG aUsInterval, LONG64 aUsSampleTime, ComPtr<IProgress> &pProgress);
HRESULT getUVMAndVMMFunctionTable(LONG64 aMagicVersion, LONG64 *aVMMFunctionTable, LONG64 *aUVM);
// private methods
bool i_queueSettings() const;
HRESULT i_getEmExecPolicyProperty(EMEXECPOLICY enmPolicy, BOOL *pfEnforced);
HRESULT i_setEmExecPolicyProperty(EMEXECPOLICY enmPolicy, BOOL fEnforce);
/** RTLogGetFlags, RTLogGetGroupSettings and RTLogGetDestinations function. */
typedef DECLCALLBACKTYPE(int, FNLOGGETSTR,(PRTLOGGER, char *, size_t));
/** Function pointer. */
typedef FNLOGGETSTR *PFNLOGGETSTR;
HRESULT i_logStringProps(PRTLOGGER pLogger, PFNLOGGETSTR pfnLogGetStr, const char *pszLogGetStr, Utf8Str *pstrSettings);
static DECLCALLBACK(int) i_dbgfProgressCallback(void *pvUser, unsigned uPercentage);
Console * const mParent;
/** @name Flags whether settings have been queued because they could not be sent
* to the VM (not up yet, etc.)
* @{ */
uint8_t maiQueuedEmExecPolicyParams[EMEXECPOLICY_END];
int mSingleStepQueued;
int mLogEnabledQueued;
uint32_t mVirtualTimeRateQueued;
bool mFlushMode;
/** @} */
/** @name Sample report related things.
* @{ */
/** Sample report handle. */
DBGFSAMPLEREPORT m_hSampleReport;
/** Progress object for the currently taken guest sample. */
ComObjPtr<Progress> m_Progress;
/** Filename to dump the report to. */
com::Utf8Str m_strFilename;
/** @} */
};
#endif /* !MAIN_INCLUDED_MachineDebuggerImpl_h */
/* vi: set tabstop=4 shiftwidth=4 expandtab: */
|
