VirtualBox

source: vbox/trunk/doc/manual/ru_RU/man_VBoxManage-debugvm.xml@ 103131

Last change on this file since 103131 was 98103, checked in by vboxsync, 21 months ago

Copyright year updates by scm.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 36.2 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 manpage, user manual, usage: VBoxManage debugvm
4-->
5<!--
6 Copyright (C) 2006-2023 Oracle and/or its affiliates.
7
8 This file is part of VirtualBox base platform packages, as
9 available from https://www.virtualbox.org.
10
11 This program is free software; you can redistribute it and/or
12 modify it under the terms of the GNU General Public License
13 as published by the Free Software Foundation, in version 3 of the
14 License.
15
16 This program is distributed in the hope that it will be useful, but
17 WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 General Public License for more details.
20
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, see <https://www.gnu.org/licenses>.
23
24 SPDX-License-Identifier: GPL-3.0-only
25-->
26<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
27 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
28<!ENTITY % all.entities SYSTEM "all-entities.ent">
29%all.entities;
30]>
31<refentry id="vboxmanage-debugvm" lang="en">
32
33 <refentryinfo>
34 <pubdate>$Date: 2023-01-17 14:15:46 +0000 (Tue, 17 Jan 2023) $</pubdate>
35 <title>VBoxManage debugvm</title>
36 </refentryinfo>
37
38 <refmeta>
39 <refentrytitle>VBoxManage-debugvm</refentrytitle>
40 <manvolnum>1</manvolnum>
41 </refmeta>
42
43 <refnamediv>
44 <refname>VBoxManage-debugvm</refname>
45 <refpurpose>интроспекция и гостевая отладка</refpurpose>
46 <refclass>&product-name;</refclass>
47 </refnamediv>
48
49 <refsynopsisdiv>
50 <cmdsynopsis id="synopsis-vboxmanage-debugvm-dumpvmcore">
51 <command>VBoxManage debugvm</command>
52 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
53 <arg choice="plain">dumpvmcore</arg>
54 <arg>--filename=<replaceable>name</replaceable></arg>
55 </cmdsynopsis>
56 <cmdsynopsis id="synopsis-vboxmanage-debugvm-info">
57 <command>VBoxManage debugvm</command>
58 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
59 <arg choice="plain">info</arg>
60 <arg choice="req"><replaceable>элемент</replaceable></arg>
61 <arg rep="repeat"><replaceable>аргументы</replaceable></arg>
62 </cmdsynopsis>
63 <cmdsynopsis id="synopsis-vboxmanage-debugvm-injectnmi">
64 <command>VBoxManage debugvm</command>
65 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
66 <arg choice="plain">injectnmi</arg>
67 </cmdsynopsis>
68 <cmdsynopsis id="synopsis-vboxmanage-debugvm-log">
69 <command>VBoxManage debugvm</command>
70 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
71 <arg choice="plain">log</arg>
72 <group><arg>--release</arg><arg>--debug</arg></group>
73 <arg rep="repeat"><replaceable>настройки-группы</replaceable></arg>
74 </cmdsynopsis>
75 <cmdsynopsis id="synopsis-vboxmanage-debugvm-logdest">
76 <command>VBoxManage debugvm</command>
77 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
78 <arg choice="plain">logdest</arg>
79 <group><arg>--release</arg><arg>--debug</arg></group>
80 <arg rep="repeat"><replaceable>назначения</replaceable></arg>
81 </cmdsynopsis>
82 <cmdsynopsis id="synopsis-vboxmanage-debugvm-logflags">
83 <command>VBoxManage debugvm</command>
84 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
85 <arg choice="plain">logflags</arg>
86 <group><arg>--release</arg><arg>--debug</arg></group>
87 <arg rep="repeat"><replaceable>флаги</replaceable></arg>
88 </cmdsynopsis>
89 <cmdsynopsis id="synopsis-vboxmanage-debugvm-osdetect">
90 <command>VBoxManage debugvm</command>
91 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
92 <arg choice="plain">osdetect</arg>
93 </cmdsynopsis>
94 <cmdsynopsis id="synopsis-vboxmanage-debugvm-osinfo">
95 <command>VBoxManage debugvm</command>
96 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
97 <arg choice="plain">osinfo</arg>
98 </cmdsynopsis>
99 <cmdsynopsis id="synopsis-vboxmanage-debugvm-osdmesg">
100 <command>VBoxManage debugvm</command>
101 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
102 <arg choice="plain">osdmesg</arg>
103 <arg>--lines=<replaceable>строки</replaceable></arg>
104 </cmdsynopsis>
105 <cmdsynopsis id="synopsis-vboxmanage-debugvm-getregisters">
106 <command>VBoxManage debugvm</command>
107 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
108 <arg choice="plain">getregisters</arg>
109 <arg>--cpu=<replaceable>id</replaceable></arg>
110 <arg rep="repeat"><replaceable>набор-регистров.имя-регистра</replaceable></arg>
111 </cmdsynopsis>
112 <cmdsynopsis id="synopsis-vboxmanage-debugvm-setregisters">
113 <command>VBoxManage debugvm</command>
114 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
115 <arg choice="plain">setregisters</arg>
116 <arg>--cpu=<replaceable>id</replaceable></arg>
117 <arg rep="repeat"><replaceable>набор-регистров.имя-регистра</replaceable>=<replaceable>значение</replaceable></arg>
118 </cmdsynopsis>
119 <cmdsynopsis id="synopsis-vboxmanage-debugvm-show">
120 <command>VBoxManage debugvm</command>
121 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
122 <arg choice="plain">show</arg>
123 <group><arg>--human-readable</arg><arg>--sh-export</arg><arg>--sh-eval</arg><arg>--cmd-set</arg></group>
124 <arg rep="repeat"><replaceable>элемент-настроек</replaceable></arg>
125 </cmdsynopsis>
126 <cmdsynopsis id="synopsis-vboxmanage-debugvm-stack">
127 <command>VBoxManage debugvm</command>
128 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
129 <arg choice="plain">stack</arg>
130 <arg>--cpu=<replaceable>id</replaceable></arg>
131 </cmdsynopsis>
132 <cmdsynopsis id="synopsis-vboxmanage-debugvm-statistics">
133 <command>VBoxManage debugvm</command>
134 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
135 <arg choice="plain">statistics</arg>
136 <arg>--reset</arg>
137 <arg>--descriptions</arg>
138 <arg>--pattern=<replaceable>шаблон</replaceable></arg>
139 </cmdsynopsis>
140 <cmdsynopsis id="synopsis-vboxmanage-debugvm-guestsample">
141 <command>VBoxManage debugvm</command>
142 <arg choice="req"><replaceable>uuid|имя-ВМ</replaceable></arg>
143 <arg choice="plain">guestsample</arg>
144 <arg>--filename=<replaceable>имя-файла</replaceable></arg>
145 <arg>--sample-interval-us=<replaceable>интервал</replaceable></arg>
146 <arg>--sample-time-us=<replaceable>время</replaceable></arg>
147 </cmdsynopsis>
148 </refsynopsisdiv>
149 <refsect1>
150 <title>Описание</title>
151
152 <para>
153 Команды "debugvm" предназначены для экспертов, которые хотят разобраться в деталях
154 исполнения виртуальной машины. Как и отладчик VM описанный в
155 <xref linkend="ts_debugger" />, эти команды полезны только если хорошо разбираетесь
156 в архитектуре PC и знаете как отлаживать программное обеспечение.
157 </para>
158
159 <refsect2 id="vboxmanage-debugvm-common-options">
160 <title>Общие параметры</title>
161 <remark role="help-scope" condition="GLOBAL"/>
162 <para>Все подкоманды <command>debugvm</command> выполняются в работающей виртуальной
163 машине:</para>
164 <variablelist>
165 <varlistentry>
166 <term><replaceable>uuid|имя-ВМ</replaceable></term>
167 <listitem><para>Или UUID или имя (чувствительно к регистру) ВМ.</para></listitem>
168 </varlistentry>
169 </variablelist>
170 </refsect2>
171
172 <refsect2 id="vboxmanage-debugvm-dumpvmcore">
173 <title>debugvm dumpvmcore</title>
174 <remark role="help-copy-synopsis"/>
175 <para>
176 Создает файл системного дампа указанной ВМ. Этот файл будет иметь
177 стандартный формат ELF ядра (с пользовательскими секциями); Смотрите
178 <xref linkend="ts_guest-core-format" />.
179 </para>
180 <para>
181 Команда соответствует команде <command>writecore</command> отладчика.
182 </para>
183 <variablelist>
184 <varlistentry>
185 <term><option>--filename=<replaceable>имя-файла</replaceable></option></term>
186 <listitem><para>Имя выходного файла.</para></listitem>
187 </varlistentry>
188 </variablelist>
189 </refsect2>
190
191 <refsect2 id="vboxmanage-debugvm-info">
192 <title>debugvm info</title>
193 <remark role="help-copy-synopsis"/>
194 <para>
195 Отображает информацию относительно VMM, эмуляции устройств и
196 назначенных драйверов.
197 </para>
198 <para>
199 Команда соответствует команде <command>info</command> отладчика.
200 </para>
201 <variablelist>
202 <varlistentry>
203 <term><replaceable>элемент</replaceable></term>
204 <listitem>
205 <para>Имя элемента для отображения. Специальное имя
206 <option>help</option> показывает список всех доступных
207 элементов и подсказок по необязательным аргументам.</para>
208 </listitem>
209 </varlistentry>
210 <varlistentry>
211 <term><replaceable>аргументы</replaceable></term>
212 <listitem>
213 <para>Необязательная строка аргументов для обработчика элемента.
214 Большинство элементов не требуют дополнительных аргументов. Нераспознанные
215 аргументы в основном игнорируются.
216 </para>
217 </listitem>
218 </varlistentry>
219 </variablelist>
220 </refsect2>
221
222 <refsect2 id="vboxmanage-debugvm-injectnmi">
223 <title>debugvm injectnmi</title>
224 <remark role="help-copy-synopsis"/>
225 <para>
226 Внедряет немаскируемое прерывание (NMI) в гостевую систему. Это может быть
227 полезно для определенных сценариев отладки. Что точно произойдет, зависит
228 от гостевой операционной системы, однако NMI может вызвать крах всей
229 гостевой ОС. Не используйте если не знаете что вы делаете.
230 </para>
231 </refsect2>
232
233 <refsect2 id="vboxmanage-debugvm-log">
234 <title>debugvm log</title>
235 <remark role="help-copy-synopsis"/>
236 <para>
237 Изменяет настройки группы для журналирования ВМ процесса в режимах отладки
238 (<option>--debug</option>) или выпуска (<option>--release</option>).
239 </para>
240 <para>
241 <replaceable>настройки-группы</replaceable> в основном строки в форме
242 <computeroutput>em.e.f.l</computeroutput>, <computeroutput>hm=~0</computeroutput>
243 и <computeroutput>-em.f</computeroutput>. Поддерживаются базовые подстановочные
244 знаки для сопоставления групп. Группа
245 <computeroutput>all</computeroutput> - это псевдоним для всех групп.
246 </para>
247 <para>
248 Пожалуйста, имейте ввиду, что настройки группы применяются как модификация
249 текущих настроек.
250 </para>
251 <para>
252 Эта команда соответствует команде <command>log</command> отладчика.
253 </para>
254 </refsect2>
255
256 <refsect2 id="vboxmanage-debugvm-logdest">
257 <title>debugvm logdest</title>
258 <remark role="help-copy-synopsis"/>
259 <para>
260 Изменяет настройки назначения для журналирования ВМ процесса в режимах
261 отладки (<option>--debug</option>) или выпуска (<option>--release</option>).
262 Более подробную информацию по формату назначения лучше посмотреть в
263 src/VBox/Runtime/common/log/log.cpp.
264 </para>
265 <para>
266 <replaceable>назначения</replaceable> - это одна или несколько мнемоник,
267 которые могут предваряться "no" для их отключения. Некоторые из них берут
268 значения после разделителей ":" или "=". Множественные мнемоники могут
269 разделяться через пробел или задаваться как отдельные аргументы в командной
270 строке.
271 </para>
272 <para>
273 Список доступных назначений:
274 </para>
275 <variablelist>
276 <varlistentry>
277 <term><option>file[=<replaceable>файл</replaceable>], nofile</option></term>
278 <listitem><para>Указывает файл журнала. Если файл журнала не указан, он
279 будет сгенерирован на основе текущего времени UTC и имени процесса ВМ и
280 помещен в текущую директорию процесса ВМ. Заметим, что данная команда
281 не имеет силы если файл журнала уже открыт.
282 </para></listitem>
283 </varlistentry>
284 <varlistentry>
285 <term><option>dir=<replaceable>директория</replaceable>, nodir</option></term>
286 <listitem><para>Указывает директорию для файлов журналов. Заметим, что данная
287 команда не имеет силы если файл журнала уже открыт.
288 </para></listitem>
289 </varlistentry>
290 <varlistentry>
291 <term><option>history=<replaceable>количество</replaceable>, nohistory</option></term>
292 <listitem><para>Ненулевые значения включают историю журналов. Значение показывает
293 сколько хранить старых файлов журналов.
294 </para></listitem>
295 </varlistentry>
296 <varlistentry>
297 <term><option>histsize=<replaceable>байт</replaceable></option></term>
298 <listitem><para>Максимальный размер файла журнала перед сменой файла. По умолчанию бесконечно.</para></listitem>
299 </varlistentry>
300 <varlistentry>
301 <term><option>histtime=<replaceable>секунды</replaceable></option></term>
302 <listitem><para>Максимальный возраст (в секундах) файла журнала перед сменой файла. По умолчанию бесконечно.</para></listitem>
303 </varlistentry>
304 <varlistentry>
305 <term><option>ringbuffer, noringbuffer</option></term>
306 <listitem><para>Записывать журнал только в буфер журнала до явного сброса на диск
307 (например через assertion). Это быстро и сохраняет дисковое пространство.</para></listitem>
308 </varlistentry>
309 <varlistentry>
310 <term><option>stdout, nostdout</option></term>
311 <listitem><para>Записывать содержимое журнала в стандартный поток вывода.</para></listitem>
312 </varlistentry>
313 <varlistentry>
314 <term><option>stdout, nostdout</option></term>
315 <listitem><para>Записывать содержимое журнала в стандартный поток ошибок.</para></listitem>
316 </varlistentry>
317 <varlistentry>
318 <term><option>debugger, nodebugger</option></term>
319 <listitem><para>Записывать содержимое журнала в отладчик, если поддерживается ОС хоста.</para></listitem>
320 </varlistentry>
321 <varlistentry>
322 <term><option>com, nocom</option></term>
323 <listitem><para>Записывать содержимое журнала в COM порт. Применимо только для raw-режима и ring-0 журналирования.</para></listitem>
324 </varlistentry>
325 <varlistentry>
326 <term><option>user, nouser</option></term>
327 <listitem><para>Пользовательское назначение, не имеющее значения для процессов ВМ.</para></listitem>
328 </varlistentry>
329 </variablelist>
330 <para>
331 Эта команда соответствует команде <command>logdest</command> отладчика.
332 </para>
333 </refsect2>
334
335 <refsect2 id="vboxmanage-debugvm-logflags">
336 <title>debugvm logflags</title>
337 <remark role="help-copy-synopsis"/>
338 <para>
339 Изменяет флаги журналирования ВМ процесса в режимах отладки
340 (<option>--debug</option>) или выпуска (<option>--release</option>). Пожалуйста,
341 имейте ввиду, что изменения применяются к существующим и не подменяют их.
342 </para>
343 <para>
344 <replaceable>флаги</replaceable> - это список мнемоник, опционально предваряемые
345 "no", "!", "~" или "-" для смены значения на противоположное. Префикс "+" может
346 использоваться для отмены предыдущего противоположного значения или как разделитель,
347 хотя лучше использовать пробел или отдельные аргументы.
348 </para>
349 <para>
350 Список мнемоник флагов с их противоположной формой, где применимо
351 (звездочка показывает значение по умолчанию):
352 </para>
353 <variablelist>
354 <varlistentry>
355 <term><option>enabled*, disabled</option></term>
356 <listitem><para>Включает или выключает журналирование.</para></listitem>
357 </varlistentry>
358 <varlistentry>
359 <term><option>buffered, unbuffered*</option></term>
360 <listitem><para>Включает буферизацию вывода журнала перед записью в назначение.</para></listitem>
361 </varlistentry>
362 <varlistentry>
363 <term><option>writethrough(/writethru)</option></term>
364 <listitem><para>Открывать ли файл назначения со сквозной буферизацией или нет.</para></listitem>
365 </varlistentry>
366 <varlistentry>
367 <term><option>flush</option></term>
368 <listitem><para>Включает сброс выходного файла на диск после каждой записи в журнал.</para></listitem>
369 </varlistentry>
370 <!-- Prefixes -->
371 <varlistentry>
372 <term><option>lockcnts</option></term>
373 <listitem><para>Предварять каждую строку журнала количеством блокировок текущего потока.</para></listitem>
374 </varlistentry>
375 <varlistentry>
376 <term><option>cpuid</option></term>
377 <listitem><para>Предварять каждую строку журнала ID текущего ЦПУ.</para></listitem>
378 </varlistentry>
379 <varlistentry>
380 <term><option>pid</option></term>
381 <listitem><para>Предварять каждую строку журнала ID текущего процесса.</para></listitem>
382 </varlistentry>
383 <varlistentry>
384 <term><option>flagno</option></term>
385 <listitem><para>Предварять каждую строку журнала числовыми значениями флагов соответствующих записи в журанал.</para></listitem>
386 </varlistentry>
387 <varlistentry>
388 <term><option>flag</option></term>
389 <listitem><para>Предварять каждую строку журнала мнемониками флагов соответствующих записи в журанал.</para></listitem>
390 </varlistentry>
391 <varlistentry>
392 <term><option>groupno</option></term>
393 <listitem><para>Предварять каждую строку журнала номером группы соответствующей записи в журанал.</para></listitem>
394 </varlistentry>
395 <varlistentry>
396 <term><option>group</option></term>
397 <listitem><para>Предварять каждую строку журнала именем группы соответствующей записи в журанал.</para></listitem>
398 </varlistentry>
399 <varlistentry>
400 <term><option>tid</option></term>
401 <listitem><para>Предварять каждую строку журнала ID текущего потока.</para></listitem>
402 </varlistentry>
403 <varlistentry>
404 <term><option>thread</option></term>
405 <listitem><para>Предварять каждую строку журнала именем текущего потока.</para></listitem>
406 </varlistentry>
407 <varlistentry>
408 <term><option>time</option></term>
409 <listitem><para>Предварять каждую строку журнала текущим временем UTC.</para></listitem>
410 </varlistentry>
411 <varlistentry>
412 <term><option>timeprog</option></term>
413 <listitem><para>Предварять каждую строку журнала текущим монотонным временем, прошедшим с момента старта программы.</para></listitem>
414 </varlistentry>
415 <varlistentry>
416 <term><option>msprog</option></term>
417 <listitem><para>Предварять каждую строку журнала текущим монотонным временем в милисекундах, прошедшим с момента старта программы.</para></listitem>
418 </varlistentry>
419 <varlistentry>
420 <term><option>ts</option></term>
421 <listitem><para>Предварять каждую строку журнала текущим монотонным временем в наносекундах.</para></listitem>
422 </varlistentry>
423 <varlistentry>
424 <term><option>tsc</option></term>
425 <listitem><para>Предварять каждую строку журнала текущим временем ЦПУ (TSC).</para></listitem>
426 </varlistentry>
427 <varlistentry>
428 <term><option>rel, abs*</option></term>
429 <listitem><para>Выбирает как отображать префиксы <computeroutput>ts</computeroutput> и
430 <computeroutput>tsc</computeroutput>: как время относительно предыдущей строки журнала
431 или как абсолютное время.</para></listitem>
432 </varlistentry>
433 <varlistentry>
434 <term><option>hex*, dec</option></term>
435 <listitem><para>Выбирает как форматировать префиксы <computeroutput>ts</computeroutput> и
436 <computeroutput>tsc</computeroutput>: как шестнадцатиричные значения или как десятичные.
437 </para></listitem>
438 </varlistentry>
439
440 <!-- Suffixes and weird stuff. -->
441 <varlistentry>
442 <term><option>custom</option></term>
443 <listitem><para>Пользовательский префикс записи журнала. По умолчанию не имеет значения для ВМ процессов.</para></listitem>
444 </varlistentry>
445
446 <varlistentry>
447 <term><option>usecrlf, uself*</option></term>
448 <listitem><para>Выводить используя окончания строк в стиле DOS (CRLF) или UNIX (LF).</para></listitem>
449 </varlistentry>
450 <varlistentry>
451 <term><option>overwrite*, append</option></term>
452 <listitem><para>Перезаписывать файл назначения или добавлять строки в конец файла.</para></listitem>
453 </varlistentry>
454 </variablelist>
455
456 <para>
457 Эта команда соответствует команде <command>logflags</command> отладчика.
458 </para>
459 </refsect2>
460
461 <refsect2 id="vboxmanage-debugvm-osdetect">
462 <title>debugvm osdetect</title>
463 <remark role="help-copy-synopsis"/>
464 <para>
465 Заставляет отладчик VMM (заново) определить гостевую операционную систему (ОС).
466 Команда сначала загружает все плагины отладчика.
467 </para>
468 <para>
469 Эта команда соответствует команде <command>detect</command> отладчика.
470 </para>
471 </refsect2>
472
473 <refsect2 id="vboxmanage-debugvm-osinfo">
474 <title>debugvm osinfo</title>
475 <remark role="help-copy-synopsis"/>
476 <para>
477 Отображает информацию о гостевой операционной системе (ОС), ранее
478 определенной отладчиком VMM.
479 </para>
480 </refsect2>
481
482 <refsect2 id="vboxmanage-debugvm-osdmesg">
483 <title>debugvm osdmesg</title>
484 <remark role="help-copy-synopsis"/>
485 <para>
486 Отображает журнал ядра гостевой ОС, если она определена и поддерживается.
487 </para>
488 <variablelist>
489 <varlistentry>
490 <term><option>--lines=<replaceable>строки</replaceable></option></term>
491 <listitem><para>Количество отображаемых строк. Счет ведется с конца журнала.
492 По умолчанию бесконечно.</para></listitem>
493 </varlistentry>
494 </variablelist>
495 </refsect2>
496
497 <refsect2 id="vboxmanage-debugvm-getregisters">
498 <title>debugvm getregisters</title>
499 <remark role="help-copy-synopsis"/>
500 <para>
501 Получает значения регистров гостевых ЦПУ и эмулируемых устройств.
502 </para>
503 <variablelist>
504 <varlistentry>
505 <term><replaceable>набор-регистров.имя-регистра</replaceable></term>
506 <listitem>
507 <para>Один или несколько регистров, где каждый указывается в следующих формах:</para>
508 <orderedlist>
509 <listitem><para>набор-регистров.имя-регистра.под-поле</para></listitem>
510 <listitem><para>набор-регистров.имя-регистра</para></listitem>
511 <listitem><para>имя-регистра-цпу.под-поле</para></listitem>
512 <listitem><para>имя-регистра-цпу</para></listitem>
513 <listitem><para>all</para></listitem>
514 </orderedlist>
515 <para>Форма <replaceable>all</replaceable> показывает все регистры (без под-полей).
516 Имена регистров не чувствительно к регистру.
517 </para>
518 </listitem>
519 </varlistentry>
520 <varlistentry>
521 <term><option>--cpu=<replaceable>id</replaceable></option></term>
522 <listitem><para>Выбирает набор регистров ЦПУ при указании только
523 регистра ЦПУ (3-я и 4-я формы). По умолчанию 0.</para>
524 </listitem>
525 </varlistentry>
526 </variablelist>
527 </refsect2>
528
529 <refsect2 id="vboxmanage-debugvm-setregisters">
530 <title>debugvm setregisters</title>
531 <remark role="help-copy-synopsis"/>
532 <para>
533 Изменяет значения регистров гостевой ОС и эмулируемых устройств.
534 </para>
535 <variablelist>
536 <varlistentry>
537 <term><replaceable>набор-регистров.имя-регистра=значение</replaceable></term>
538 <listitem>
539 <para>Присвоение значений одному или нескольким регистрами, где каждый
540 указывается в следующих формах:</para>
541 <orderedlist>
542 <listitem><para>набор-регистров.имя-регистра.под-поле=значение</para></listitem>
543 <listitem><para>набор-регистров.имя-регистра=значение</para></listitem>
544 <listitem><para>имя-регистра-цпу.под-поле=значение</para></listitem>
545 <listitem><para>имя-регистра-цпу=значение</para></listitem>
546 </orderedlist>
547 <para>Форматр значений должен быть в том же стиле, в каком отображаются
548 по команде <command>getregisters</command>, за исключением того, что
549 могут быть указаны восмеричные и десятичные значения вместо
550 шестнадцатиричных.</para>
551 </listitem>
552 </varlistentry>
553 <varlistentry>
554 <term><option>--cpu=<replaceable>id</replaceable></option></term>
555 <listitem><para>Выбирает набор регистров ЦПУ при указании только
556 регистра ЦПУ (3-я и 4-я формы). По умолчанию 0.</para>
557 </listitem>
558 </varlistentry>
559 </variablelist>
560 </refsect2>
561
562 <refsect2 id="vboxmanage-debugvm-show">
563 <title>debugvm show</title>
564 <remark role="help-copy-synopsis"/>
565 <para>
566 Отображает настройки журнала для ВМ.
567 </para>
568 <variablelist>
569 <varlistentry>
570 <term><option>--human-readable</option></term>
571 <listitem><para>Выбирает человеко-читаемый вывод.</para></listitem>
572 </varlistentry>
573 <varlistentry>
574 <term><option>--sh-export</option></term>
575 <listitem><para>Выбирает формат вывода в стиле bourne shell команды <command>export</command>.</para></listitem>
576 </varlistentry>
577 <varlistentry>
578 <term><option>--sh-eval</option></term>
579 <listitem><para>Выбирает формат вывода в стиле аргументов bourne shell команды <command>eval</command>.</para></listitem>
580 </varlistentry>
581 <varlistentry>
582 <term><option>--cmd-set</option></term>
583 <listitem><para>Выбирает формат вывода в стиле команды DOS <command>SET</command>.</para></listitem>
584 </varlistentry>
585 <varlistentry>
586 <term><replaceable>settings-item</replaceable></term>
587 <listitem>
588 <para>Указывает что отображать. Один или несколько из следующих:</para>
589 <itemizedlist>
590 <listitem><para>logdbg-settings - настройки журнала в режиме отладки.</para></listitem>
591 <listitem><para>logrel-settings - настройки журнала в режиме выпуска.</para></listitem>
592 <listitem><para>log-settings - псевдоним для настроек журнала в режимах и отладки и выпуска.</para></listitem>
593 </itemizedlist>
594 </listitem>
595 </varlistentry>
596 </variablelist>
597
598 </refsect2>
599
600 <refsect2 id="vboxmanage-debugvm-stack">
601 <title>debugvm stack</title>
602 <remark role="help-copy-synopsis"/>
603 <para>
604 Разматывает стеки гостевого ЦПУ в меру наших возможностей. Рекомендуется
605 сначала запустить команду <command>osdetect</command> чтобы получить
606 символы и возможно информацию для раскрутки стека.
607 </para>
608 <variablelist>
609 <varlistentry>
610 <term><option>--cpu=<replaceable>id</replaceable></option></term>
611 <listitem><para>Выбирает один гостевой ЦПУ, у которого надо отобразить стек. По умолчанию все ЦПУ.</para> </listitem>
612 </varlistentry>
613 </variablelist>
614
615 </refsect2>
616
617 <refsect2 id="vboxmanage-debugvm-statistics">
618 <title>debugvm statistics</title>
619 <remark role="help-copy-synopsis"/>
620 <para>
621 Отображает или сбрасывает статистики VMM.
622 </para>
623 <para>
624 Получает значения регистров для гостевых ЦПУ и эмулируемых устройств.
625 </para>
626 <variablelist>
627 <varlistentry>
628 <term><option>--pattern=<replaceable>шаблон</replaceable></option></term>
629 <listitem><para>Шаблоны с подстановочными знаками в стиле DOS/NT для выбранных статистик.
630 Множественные шаблоны указываются через символ '|' (канал) в качестве разделителя.</para>
631 </listitem>
632 </varlistentry>
633 <varlistentry>
634 <term><option>--reset</option></term>
635 <listitem><para>Выбрать сброс вместо режима отображения.</para></listitem>
636 </varlistentry>
637 </variablelist>
638
639 </refsect2>
640
641 <refsect2 id="vboxmanage-debugvm-guestsample">
642 <title>debugvm guestsample</title>
643 <remark role="help-copy-synopsis"/>
644 <para>
645 Создает отчет с выборками о гостевой активности.
646 </para>
647 <para>
648 Получает имя файла куда сбрасывать отчет.
649 </para>
650 <variablelist>
651 <varlistentry>
652 <term><option>--filename=<replaceable>имя-файла</replaceable></option></term>
653 <listitem><para>Имя файла куда сбрасывать отчет с выборками.</para>
654 </listitem>
655 </varlistentry>
656 <varlistentry>
657 <term><option>--sample-interval-us=<replaceable>интервал</replaceable></option></term>
658 <listitem><para>Интервал в микросекундах между гостевыми выборками.</para>
659 </listitem>
660 </varlistentry>
661 <varlistentry>
662 <term><option>--sample-time-us=<replaceable>time</replaceable></option></term>
663 <listitem><para>Количество микросекунд, в течение которых берется выборка.</para>
664 </listitem>
665 </varlistentry>
666 </variablelist>
667
668 </refsect2>
669
670 </refsect1>
671
672</refentry>
673
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