VirtualBox

source: vbox/trunk/include/VBox/cpumdis.h@ 8006

Last change on this file since 8006 was 5999, checked in by vboxsync, 16 years ago

The Giant CDDL Dual-License Header Change.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 2.8 KB
Line 
1/** @file
2 * CPUM - CPU Monitor(/Manager)
3 */
4
5/*
6 * Copyright (C) 2006-2007 innotek GmbH
7 *
8 * This file is part of VirtualBox Open Source Edition (OSE), as
9 * available from http://www.virtualbox.org. This file is free software;
10 * you can redistribute it and/or modify it under the terms of the GNU
11 * General Public License (GPL) as published by the Free Software
12 * Foundation, in version 2 as it comes in the "COPYING" file of the
13 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
14 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
15 *
16 * The contents of this file may alternatively be used under the terms
17 * of the Common Development and Distribution License Version 1.0
18 * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
19 * VirtualBox OSE distribution, in which case the provisions of the
20 * CDDL are applicable instead of those of the GPL.
21 *
22 * You may elect to license modified versions of this file under the
23 * terms and conditions of either the GPL or the CDDL or both.
24 */
25
26#ifndef ___VBox_cpumdis_h
27#define ___VBox_cpumdis_h
28
29#include <VBox/cpum.h>
30#include <VBox/cdefs.h>
31#include <VBox/types.h>
32#include <VBox/x86.h>
33#include <VBox/dis.h>
34
35
36__BEGIN_DECLS
37/** @addtogroup grp_cpum
38 * @{
39 */
40
41#ifdef IN_RING3
42
43/**
44 * Disassemble an instruction and return the information in the provided structure.
45 *
46 * @returns VBox status code.
47 * @param pVM VM Handle
48 * @param pCtx CPU context
49 * @param GCPtrPC Program counter (relative to CS) to disassemble from.
50 * @param pCpu Disassembly state
51 * @param pszPrefix String prefix for logging (debug only)
52 *
53 */
54CPUMR3DECL(int) CPUMR3DisasmInstrCPU(PVM pVM, PCPUMCTX pCtx, RTGCPTR GCPtrPC, PDISCPUSTATE pCpu, const char *pszPrefix);
55
56# ifdef DEBUG
57/**
58 * Disassemble an instruction and dump it to the log
59 *
60 * @returns VBox status code.
61 * @param pVM VM Handle
62 * @param pCtx CPU context
63 * @param pc GC instruction pointer
64 * @param prefix String prefix for logging
65 *
66 * @deprecated Use DBGFR3DisasInstrCurrentLog().
67 */
68CPUMR3DECL(void) CPUMR3DisasmInstr(PVM pVM, PCPUMCTX pCtx, RTGCPTR pc, char *prefix);
69
70/**
71 * Disassemble an instruction and dump it to the log
72 *
73 * @returns VBox status code.
74 * @param pVM VM Handle
75 * @param pCtx CPU context
76 * @param pc GC instruction pointer
77 * @param prefix String prefix for logging
78 * @param nrInstructions
79 *
80 * @deprecated Create new DBGFR3Disas function to do this.
81 */
82CPUMR3DECL(void) CPUMR3DisasmBlock(PVM pVM, PCPUMCTX pCtx, RTGCPTR pc, char *prefix, int nrInstructions);
83
84# else
85# define CPUMR3DisasmInstr(pVM, pCtx, pc, prefix)
86# define CPUMR3DisasmBlock(pVM, pCtx, pc, prefix, nrInstructions)
87# endif
88
89#endif /* IN_RING3 */
90
91/** @} */
92__END_DECLS
93
94
95#endif
96
97
98
99
100
Note: See TracBrowser for help on using the repository browser.

© 2023 Oracle
ContactPrivacy policyTerms of Use