VirtualBox

source: vbox/trunk/doc/manual/en_US/man_VBoxManage-debugvm.xml@ 78425

Last change on this file since 78425 was 77353, checked in by vboxsync, 6 years ago

doc/manual: Replace xref in man and --help output with chapter/section numbers+names to avoid having to wrap these in hacky <remark role=help-manual> elements.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 26.8 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage debugvm
4
5 Copyright (C) 2006-2015 Oracle Corporation
6
7 This file is part of VirtualBox Open Source Edition (OSE), as
8 available from http://www.virtualbox.org. This file is free software;
9 you can redistribute it and/or modify it under the terms of the GNU
10 General Public License (GPL) as published by the Free Software
11 Foundation, in version 2 as it comes in the "COPYING" file of the
12 VirtualBox OSE distribution. VirtualBox OSE is distributed in the
13 hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
14 -->
15<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
16<refentry id="vboxmanage-debugvm" lang="en">
17
18 <refentryinfo>
19 <pubdate>$Date: 2019-02-18 21:15:47 +0000 (Mon, 18 Feb 2019) $</pubdate>
20 <title>VBoxManage debugvm</title>
21 </refentryinfo>
22
23 <refmeta>
24 <refentrytitle>VBoxManage-debugvm</refentrytitle>
25 <manvolnum>1</manvolnum>
26 </refmeta>
27
28 <refnamediv>
29 <refname>VBoxManage-debugvm</refname>
30 <refpurpose>introspection and guest debugging</refpurpose>
31 <refclass>Oracle VM VirtualBox</refclass>
32 </refnamediv>
33
34 <refsynopsisdiv>
35 <cmdsynopsis id="synopsis-vboxmanage-debugvm-dumpvmcore">
36 <command>VBoxManage debugvm</command>
37 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
38 <arg choice="plain">dumpvmcore</arg>
39 <arg>--filename=<replaceable>name</replaceable></arg>
40 </cmdsynopsis>
41 <cmdsynopsis id="synopsis-vboxmanage-debugvm-info">
42 <command>VBoxManage debugvm</command>
43 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
44 <arg choice="plain">info</arg>
45 <arg choice="req"><replaceable>item</replaceable></arg>
46 <arg rep="repeat"><replaceable>args</replaceable></arg>
47 </cmdsynopsis>
48 <cmdsynopsis id="synopsis-vboxmanage-debugvm-injectnmi">
49 <command>VBoxManage debugvm</command>
50 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
51 <arg choice="plain">injectnmi</arg>
52 </cmdsynopsis>
53 <cmdsynopsis id="synopsis-vboxmanage-debugvm-log">
54 <command>VBoxManage debugvm</command>
55 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
56 <arg choice="plain">log</arg>
57 <group><arg>--release</arg><arg>--debug</arg></group>
58 <arg rep="repeat"><replaceable>group-settings</replaceable></arg>
59 </cmdsynopsis>
60 <cmdsynopsis id="synopsis-vboxmanage-debugvm-logdest">
61 <command>VBoxManage debugvm</command>
62 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
63 <arg choice="plain">logdest</arg>
64 <group><arg>--release</arg><arg>--debug</arg></group>
65 <arg rep="repeat"><replaceable>destinations</replaceable></arg>
66 </cmdsynopsis>
67 <cmdsynopsis id="synopsis-vboxmanage-debugvm-logflags">
68 <command>VBoxManage debugvm</command>
69 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
70 <arg choice="plain">logflags</arg>
71 <group><arg>--release</arg><arg>--debug</arg></group>
72 <arg rep="repeat"><replaceable>flags</replaceable></arg>
73 </cmdsynopsis>
74 <cmdsynopsis id="synopsis-vboxmanage-debugvm-osdetect">
75 <command>VBoxManage debugvm</command>
76 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
77 <arg choice="plain">osdetect</arg>
78 </cmdsynopsis>
79 <cmdsynopsis id="synopsis-vboxmanage-debugvm-osinfo">
80 <command>VBoxManage debugvm</command>
81 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
82 <arg choice="plain">osinfo</arg>
83 </cmdsynopsis>
84 <cmdsynopsis id="synopsis-vboxmanage-debugvm-osdmesg">
85 <command>VBoxManage debugvm</command>
86 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
87 <arg choice="plain">osdmesg</arg>
88 <arg>--lines=<replaceable>lines</replaceable></arg>
89 </cmdsynopsis>
90 <cmdsynopsis id="synopsis-vboxmanage-debugvm-getregisters">
91 <command>VBoxManage debugvm</command>
92 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
93 <arg choice="plain">getregisters</arg>
94 <arg>--cpu=<replaceable>id</replaceable></arg>
95 <arg rep="repeat"><replaceable>reg-set.reg-name</replaceable></arg>
96 </cmdsynopsis>
97 <cmdsynopsis id="synopsis-vboxmanage-debugvm-setregisters">
98 <command>VBoxManage debugvm</command>
99 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
100 <arg choice="plain">setregisters</arg>
101 <arg>--cpu=<replaceable>id</replaceable></arg>
102 <arg rep="repeat"><replaceable>reg-set.reg-name=value</replaceable></arg>
103 </cmdsynopsis>
104 <cmdsynopsis id="synopsis-vboxmanage-debugvm-show">
105 <command>VBoxManage debugvm</command>
106 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
107 <arg choice="plain">show</arg>
108 <group><arg>--human-readable</arg><arg>--sh-export</arg><arg>--sh-eval</arg><arg>--cmd-set</arg></group>
109 <arg rep="repeat"><replaceable>settings-item</replaceable></arg>
110 </cmdsynopsis>
111 <cmdsynopsis id="synopsis-vboxmanage-debugvm-stack">
112 <command>VBoxManage debugvm</command>
113 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
114 <arg choice="plain">stack</arg>
115 <arg>--cpu=<replaceable>id</replaceable></arg>
116 </cmdsynopsis>
117 <cmdsynopsis id="synopsis-vboxmanage-debugvm-statistics">
118 <command>VBoxManage debugvm</command>
119 <arg choice="req"><replaceable>uuid|vmname</replaceable></arg>
120 <arg choice="plain">statistics</arg>
121 <arg>--reset</arg>
122 <arg>--descriptions</arg>
123 <arg>--pattern=<replaceable>pattern</replaceable></arg>
124 </cmdsynopsis>
125 </refsynopsisdiv>
126 <refsect1>
127 <title>Description</title>
128
129 <para>The "debugvm" commands are for experts who want to tinker with the
130 exact details of virtual machine execution. Like the VM debugger
131 described in <xref linkend="ts_debugger" />, these commands are only useful if you are
132 very familiar with the details of the PC architecture and how to debug
133 software.</para>
134
135 <refsect2 id="vboxmanage-debugvm-common-options">
136 <title>Common options</title>
137 <remark role="help-scope" condition="GLOBAL"/>
138 <para>The subcommands of <command>debugvm</command> all operate on a running virtual
139 machine:</para>
140 <variablelist>
141 <varlistentry>
142 <term><replaceable>uuid|vmname</replaceable></term>
143 <listitem><para>Either the UUID or the name (case sensitive) of a VM.</para></listitem>
144 </varlistentry>
145 </variablelist>
146 </refsect2>
147
148 <refsect2 id="vboxmanage-debugvm-dumpvmcore">
149 <title>debugvm dumpvmcore</title>
150 <remark role="help-copy-synopsis"/>
151 <para>
152 Creates a system dump file of the specified VM. This file will have
153 the standard ELF core format (with custom sections); see
154 <xref linkend="ts_guest-core-format" />.
155 </para>
156 <para>
157 This corresponds to the <command>writecore</command> command in the debugger.
158 </para>
159 <variablelist>
160 <varlistentry>
161 <term><option>--filename=<replaceable>filename</replaceable></option></term>
162 <listitem><para>The name of the output file.</para></listitem>
163 </varlistentry>
164 </variablelist>
165 </refsect2>
166
167 <refsect2 id="vboxmanage-debugvm-info">
168 <title>debugvm info</title>
169 <remark role="help-copy-synopsis"/>
170 <para>
171 Displays info items relating to the VMM, device emulations and
172 associated drivers.
173 </para>
174 <para>
175 This corresponds to the <command>info</command> command in the debugger.
176 </para>
177 <variablelist>
178 <varlistentry>
179 <term><replaceable>info</replaceable></term>
180 <listitem>
181 <para>Name of the info item to display. The special name
182 <option>help</option> will list all the available info items and
183 hints about optional arguments.</para>
184 </listitem>
185 </varlistentry>
186 <varlistentry>
187 <term><replaceable>args</replaceable></term>
188 <listitem>
189 <para>Optional argument string for the info item handler. Most info items
190 does not take any extra arguments. Arguments not recognized are generally
191 ignored.</para>
192 </listitem>
193 </varlistentry>
194 </variablelist>
195 </refsect2>
196
197 <refsect2 id="vboxmanage-debugvm-injectnmi">
198 <title>debugvm injectnmi</title>
199 <remark role="help-copy-synopsis"/>
200 <para>
201 Causes a non-maskable interrupt (NMI) to be injected into the guest. This
202 might be useful for certain debugging scenarios. What happens exactly is
203 dependent on the guest operating system, but an NMI can crash the whole
204 guest operating system. Do not use unless you know what you're doing.
205 </para>
206 </refsect2>
207
208 <refsect2 id="vboxmanage-debugvm-log">
209 <title>debugvm log</title>
210 <remark role="help-copy-synopsis"/>
211 <para>
212 Changes the group settings for either debug (<option>--debug</option>)
213 or release (<option>--release</option>) logger of the VM process.
214 </para>
215 <para>
216 The <replaceable>group-settings</replaceable> are typically strings on the form
217 <computeroutput>em.e.f.l</computeroutput>, <computeroutput>hm=~0</computeroutput>
218 and <computeroutput>-em.f</computeroutput>. Basic wildcards are supported for
219 group matching. The <computeroutput>all</computeroutput> group is an alias for
220 all the groups.
221 </para>
222 <para>
223 Please do keep in mind that the group settings are applied as modifications
224 to the current ones.
225 </para>
226 <para>
227 This corresponds to the <command>log</command> command in the debugger.
228 </para>
229 </refsect2>
230
231 <refsect2 id="vboxmanage-debugvm-logdest">
232 <title>debugvm logdest</title>
233 <remark role="help-copy-synopsis"/>
234 <para>
235 Changes the destination settings for either debug (<option>--debug</option>)
236 or release (<option>--release</option>) logger of the VM process. For details
237 on the destination format, the best source is src/VBox/Runtime/common/log/log.cpp.
238 </para>
239 <para>
240 The <replaceable>destinations</replaceable> is one or more mnemonics, optionally
241 prefixed by "no" to disable them. Some of them take values after a ":" or "="
242 separator. Multiple mnemonics can be separated by space or given as separate
243 arguments on the command line.
244 </para>
245 <para>
246 List of available destination:
247 </para>
248 <variablelist>
249 <varlistentry>
250 <term><option>file[=<replaceable>file</replaceable>], nofile</option></term>
251 <listitem><para>Specifies a log file. It no filname is given, one will be
252 generated based on the current UTC time and VM process name and placed in
253 the current directory of the VM process. Note that this will currently not
254 have any effect if the log file has already been opened.
255 </para></listitem>
256 </varlistentry>
257 <varlistentry>
258 <term><option>dir=<replaceable>directory</replaceable>, nodir</option></term>
259 <listitem><para>Specifies the output directory for log files. Note that this
260 will currently not have any effect if the log file has already been opened.
261 </para></listitem>
262 </varlistentry>
263 <varlistentry>
264 <term><option>history=<replaceable>count</replaceable>, nohistory</option></term>
265 <listitem><para>A non-zero value enables log historization, with the value
266 specifying how many old log files to keep.
267 </para></listitem>
268 </varlistentry>
269 <varlistentry>
270 <term><option>histsize=<replaceable>bytes</replaceable></option></term>
271 <listitem><para>The max size of a log file before it is historized. Default is infinite.</para></listitem>
272 </varlistentry>
273 <varlistentry>
274 <term><option>histtime=<replaceable>seconds</replaceable></option></term>
275 <listitem><para>The max age (in seconds) of a log file before it is historized. Default is infinite.</para></listitem>
276 </varlistentry>
277 <varlistentry>
278 <term><option>ringbuffer, noringbuffer</option></term>
279 <listitem><para>Only log to the log buffer until an explicit flush (e.g. via an assertion)
280 occurs. This is fast and saves diskspace.</para></listitem>
281 </varlistentry>
282 <varlistentry>
283 <term><option>stdout, nostdout</option></term>
284 <listitem><para>Write the log content to standard output.</para></listitem>
285 </varlistentry>
286 <varlistentry>
287 <term><option>stdout, nostdout</option></term>
288 <listitem><para>Write the log content to standard error.</para></listitem>
289 </varlistentry>
290 <varlistentry>
291 <term><option>debugger, nodebugger</option></term>
292 <listitem><para>Write the log content to the debugger, if supported by the host OS.</para></listitem>
293 </varlistentry>
294 <varlistentry>
295 <term><option>com, nocom</option></term>
296 <listitem><para>Writes logging to the COM port. This is only applicable for raw-mode and ring-0 logging.</para></listitem>
297 </varlistentry>
298 <varlistentry>
299 <term><option>user, nouser</option></term>
300 <listitem><para>Custom destination which has no meaning to VM processes..</para></listitem>
301 </varlistentry>
302 </variablelist>
303 <para>
304 This corresponds to the <command>logdest</command> command in the debugger.
305 </para>
306 </refsect2>
307
308 <refsect2 id="vboxmanage-debugvm-logflags">
309 <title>debugvm logflags</title>
310 <remark role="help-copy-synopsis"/>
311 <para>
312 Changes the flags on either debug (<option>--debug</option>) or release
313 (<option>--release</option>) logger of the VM process. Please note that the
314 modifications are applied onto the existing changes, they are not replacing them.
315 </para>
316 <para>
317 The <replaceable>flags</replaceable> are a list of flag mnemonics, optionally
318 prefixed by a "no", "!", "~" or "-" to negate their meaning. The "+" prefix
319 can be used to undo previous negation or use as a separator, though better use
320 whitespace or separate arguments for that.
321 </para>
322 <para>
323 List of log flag mnemonics, with their counter form where applicable
324 (asterisk indicates defaults):
325 </para>
326 <variablelist>
327 <varlistentry>
328 <term><option>enabled*, disabled</option></term>
329 <listitem><para>Enables or disables logging.</para></listitem>
330 </varlistentry>
331 <varlistentry>
332 <term><option>buffered, unbuffered*</option></term>
333 <listitem><para>Enabling buffering of log output before it hits the destinations.</para></listitem>
334 </varlistentry>
335 <varlistentry>
336 <term><option>writethrough(/writethru)</option></term>
337 <listitem><para>Whether to open the destination file with writethru buffering settings or not.</para></listitem>
338 </varlistentry>
339 <varlistentry>
340 <term><option>flush</option></term>
341 <listitem><para>Enables flushing of the output file (to disk) after each log statement.</para></listitem>
342 </varlistentry>
343 <!-- Prefixes -->
344 <varlistentry>
345 <term><option>lockcnts</option></term>
346 <listitem><para>Prefix each log line with lock counts for the current thread.</para></listitem>
347 </varlistentry>
348 <varlistentry>
349 <term><option>cpuid</option></term>
350 <listitem><para>Prefix each log line with the ID of the current CPU.</para></listitem>
351 </varlistentry>
352 <varlistentry>
353 <term><option>pid</option></term>
354 <listitem><para>Prefix each log line with the current process ID.</para></listitem>
355 </varlistentry>
356 <varlistentry>
357 <term><option>flagno</option></term>
358 <listitem><para>Prefix each log line with the numberic flags corresponding to the log statement.</para></listitem>
359 </varlistentry>
360 <varlistentry>
361 <term><option>flag</option></term>
362 <listitem><para>Prefix each log line with the flag mnemonics corresponding to the log statement.</para></listitem>
363 </varlistentry>
364 <varlistentry>
365 <term><option>groupno</option></term>
366 <listitem><para>Prefix each log line with the log group number for the log statement producing it.</para></listitem>
367 </varlistentry>
368 <varlistentry>
369 <term><option>group</option></term>
370 <listitem><para>Prefix each log line with the log group name for the log statement producing it.</para></listitem>
371 </varlistentry>
372 <varlistentry>
373 <term><option>tid</option></term>
374 <listitem><para>Prefix each log line with the current thread identifier.</para></listitem>
375 </varlistentry>
376 <varlistentry>
377 <term><option>thread</option></term>
378 <listitem><para>Prefix each log line with the current thread name.</para></listitem>
379 </varlistentry>
380 <varlistentry>
381 <term><option>time</option></term>
382 <listitem><para>Prefix each log line with the current UTC wall time.</para></listitem>
383 </varlistentry>
384 <varlistentry>
385 <term><option>timeprog</option></term>
386 <listitem><para>Prefix each log line with the current monotonic time since the start of the program.</para></listitem>
387 </varlistentry>
388 <varlistentry>
389 <term><option>msprog</option></term>
390 <listitem><para>Prefix each log line with the current monotonic timestamp value in milliseconds since the start of the program.</para></listitem>
391 </varlistentry>
392 <varlistentry>
393 <term><option>ts</option></term>
394 <listitem><para>Prefix each log line with the current monotonic timestamp value in nanoseconds.</para></listitem>
395 </varlistentry>
396 <varlistentry>
397 <term><option>tsc</option></term>
398 <listitem><para>Prefix each log line with the current CPU timestamp counter (TSC) value.</para></listitem>
399 </varlistentry>
400 <varlistentry>
401 <term><option>rel, abs*</option></term>
402 <listitem><para>Selects the whether <computeroutput>ts</computeroutput> and
403 <computeroutput>tsc</computeroutput> prefixes should be displayed as relative to the
404 previous log line or as absolute time.</para></listitem>
405 </varlistentry>
406 <varlistentry>
407 <term><option>hex*, dec</option></term>
408 <listitem><para>Selects the whether the <computeroutput>ts</computeroutput> and
409 <computeroutput>tsc</computeroutput> prefixes should be formatted as hexadecimal
410 or decimal.</para></listitem>
411 </varlistentry>
412
413 <!-- Suffixes and weird stuff. -->
414 <varlistentry>
415 <term><option>custom</option></term>
416 <listitem><para>Custom log prefix, has by default no meaning for VM processes.</para></listitem>
417 </varlistentry>
418
419 <varlistentry>
420 <term><option>usecrlf, uself*</option></term>
421 <listitem><para>Output with DOS style (CRLF) or just UNIX style (LF) line endings.</para></listitem>
422 </varlistentry>
423 <varlistentry>
424 <term><option>overwrite*, append</option></term>
425 <listitem><para>Overwrite the destination file or append to it.</para></listitem>
426 </varlistentry>
427 </variablelist>
428
429 <para>
430 This corresponds to the <command>logflags</command> command in the debugger.
431 </para>
432 </refsect2>
433
434 <refsect2 id="vboxmanage-debugvm-osdetect">
435 <title>debugvm osdetect</title>
436 <remark role="help-copy-synopsis"/>
437 <para>
438 Make the VMM's debugger facility (re)-detect the guest operating system (OS).
439 This will first load all debugger plug-ins.
440 </para>
441 <para>
442 This corresponds to the <command>detect</command> command in the debugger.
443 </para>
444 </refsect2>
445
446 <refsect2 id="vboxmanage-debugvm-osinfo">
447 <title>debugvm osinfo</title>
448 <remark role="help-copy-synopsis"/>
449 <para>
450 Displays information about the guest operating system (OS) previously
451 detected by the VMM's debugger facility.
452 </para>
453 </refsect2>
454
455 <refsect2 id="vboxmanage-debugvm-osdmesg">
456 <title>debugvm osdmesg</title>
457 <remark role="help-copy-synopsis"/>
458 <para>
459 Displays the guest OS kernel log, if detected and supported.
460 </para>
461 <variablelist>
462 <varlistentry>
463 <term><option>--lines=<replaceable>lines</replaceable></option></term>
464 <listitem><para>Number of lines of the log to display, counting from
465 the end. The default is infinite.</para></listitem>
466 </varlistentry>
467 </variablelist>
468 </refsect2>
469
470 <refsect2 id="vboxmanage-debugvm-getregisters">
471 <title>debugvm getregisters</title>
472 <remark role="help-copy-synopsis"/>
473 <para>
474 Retrieves register values for guest CPUs and emulated devices.
475 </para>
476 <variablelist>
477 <varlistentry>
478 <term><replaceable>reg-set.reg-name</replaceable></term>
479 <listitem>
480 <para>One of more registers, each having one of the following forms:</para>
481 <orderedlist>
482 <listitem><para>register-set.register-name.sub-field</para></listitem>
483 <listitem><para>register-set.register-name</para></listitem>
484 <listitem><para>cpu-register-name.sub-field</para></listitem>
485 <listitem><para>cpu-register-name</para></listitem>
486 <listitem><para>all</para></listitem>
487 </orderedlist>
488 <para>The <replaceable>all</replaceable> form will cause all registers
489 to be shown (no sub-fields). The registers names are case-insensitive.
490 </para>
491 </listitem>
492 </varlistentry>
493 <varlistentry>
494 <term><option>--cpu=<replaceable>id</replaceable></option></term>
495 <listitem><para>Selects the CPU register set when specifying just a
496 CPU register (3rd and 4th form). The default is 0.</para>
497 </listitem>
498 </varlistentry>
499 </variablelist>
500 </refsect2>
501
502 <refsect2 id="vboxmanage-debugvm-setregisters">
503 <title>debugvm setregisters</title>
504 <remark role="help-copy-synopsis"/>
505 <para>
506 Changes register values for guest CPUs and emulated devices.
507 </para>
508 <variablelist>
509 <varlistentry>
510 <term><replaceable>reg-set.reg-name=value</replaceable></term>
511 <listitem>
512 <para>One of more register assignment, each having one of the following forms:</para>
513 <orderedlist>
514 <listitem><para>register-set.register-name.sub-field=value</para></listitem>
515 <listitem><para>register-set.register-name=value</para></listitem>
516 <listitem><para>cpu-register-name.sub-field=value</para></listitem>
517 <listitem><para>cpu-register-name=value</para></listitem>
518 </orderedlist>
519 <para>The value format should be in the same style as what
520 <command>getregisters</command> displays, with the exception that
521 both octal and decimal can be used instead of hexadecimal.</para>
522 </listitem>
523 </varlistentry>
524 <varlistentry>
525 <term><option>--cpu=<replaceable>id</replaceable></option></term>
526 <listitem><para>Selects the CPU register set when specifying just a
527 CPU register (3rd and 4th form). The default is 0.</para>
528 </listitem>
529 </varlistentry>
530 </variablelist>
531 </refsect2>
532
533 <refsect2 id="vboxmanage-debugvm-show">
534 <title>debugvm show</title>
535 <remark role="help-copy-synopsis"/>
536 <para>
537 Shows logging settings for the VM.
538 </para>
539 <variablelist>
540 <varlistentry>
541 <term><option>--human-readable</option></term>
542 <listitem><para>Selects human readable output.</para></listitem>
543 </varlistentry>
544 <varlistentry>
545 <term><option>--sh-export</option></term>
546 <listitem><para>Selects output format as bourne shell style <command>export</command> commands.</para></listitem>
547 </varlistentry>
548 <varlistentry>
549 <term><option>--sh-eval</option></term>
550 <listitem><para>Selects output format as bourne shell style <command>eval</command> command input.</para></listitem>
551 </varlistentry>
552 <varlistentry>
553 <term><option>--cmd-set</option></term>
554 <listitem><para>Selects output format as DOS style <command>SET</command> commands.</para></listitem>
555 </varlistentry>
556 <varlistentry>
557 <term><replaceable>settings-item</replaceable></term>
558 <listitem>
559 <para>What to display. One or more of the following:</para>
560 <itemizedlist>
561 <listitem><para>logdbg-settings - debug log settings.</para></listitem>
562 <listitem><para>logrel-settings - release log settings.</para></listitem>
563 <listitem><para>log-settings - alias for both debug and release log settings.</para></listitem>
564 </itemizedlist>
565 </listitem>
566 </varlistentry>
567 </variablelist>
568
569 </refsect2>
570
571 <refsect2 id="vboxmanage-debugvm-stack">
572 <title>debugvm stack</title>
573 <remark role="help-copy-synopsis"/>
574 <para>
575 Unwinds the guest CPU stacks to the best of our ability. It is
576 recommended to first run the <command>osdetect</command> command, as this
577 gives both symbols and perhaps unwind information.
578 </para>
579 <variablelist>
580 <varlistentry>
581 <term><option>--cpu=<replaceable>id</replaceable></option></term>
582 <listitem><para>Selects a single guest CPU to display the stack for. The default is all CPUs.</para> </listitem>
583 </varlistentry>
584 </variablelist>
585
586 </refsect2>
587
588 <refsect2 id="vboxmanage-debugvm-statistics">
589 <title>debugvm statistics</title>
590 <remark role="help-copy-synopsis"/>
591 <para>
592 Displays or resets VMM statistics.
593 </para>
594 <para>
595 Retrieves register values for guest CPUs and emulated devices.
596 </para>
597 <variablelist>
598 <varlistentry>
599 <term><option>--pattern=<replaceable>pattern</replaceable></option></term>
600 <listitem><para>DOS/NT-style wildcards patterns for selecting statistics. Multiple
601 patterns can be specified by using the '|' (pipe) character as separator.</para>
602 </listitem>
603 </varlistentry>
604 <varlistentry>
605 <term><option>--reset</option></term>
606 <listitem><para>Select reset instead of display mode.</para></listitem>
607 </varlistentry>
608 </variablelist>
609
610 </refsect2>
611
612 </refsect1>
613
614</refentry>
615
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette