BCDEdit /debug
The /debug boot option enables or disables kernel debugging of the Windows operating system associated with the specified boot entry or the current boot entry.
Before setting BCDEdit options you might need to disable or suspend BitLocker and Secure Boot on the computer.
Parameters
The <ID> is the ID that is associated with the boot entry, such as
on
Enables kernel debugging of the specified boot entry. If a boot entry is not specified, kernel debugging is enabled for the current operating system.
off
Disables kernel debugger of the specified boot entry. If a boot entry is not specified, kernel debugging is disabled for the current operating system.
Comments
The /debug boot option enables kernel debugging for a specific boot entry. Use the /dbgsettings option to configure the type of debugging connection to use and the connection parameters. If no /dbgsettings are specified for the boot entry, the global debug settings are used. The default values for the global settings are shown in the following table.
| dbgsetting parameter | Default value |
|---|---|
| debugtype | Local |
| debugstart | Active |
| noumex | Yes |
The following example enables kernel debugging of the default boot entry.
Включение режима отладки вызывает Windows, если не подключен debugger
В этой статье предоставляется решение проблемы, из-за которой операционная система с включенным режимом отладки может висеть, если не подключен Debugger.
Применяется к: Windows 7 Пакет обновления 1, Windows Server 2012 R2
Исходный номер КБ: 2816225
Симптомы
На компьютере, который работает Windows 7 или Windows Server 2008 R2, после установки средств отладки для Windows операционная система с включенным режимом отладки может зависнуть, если приложение бросает исключение в режиме пользователя.
Причина
Когда включен режим отладки, а отладка не подключена из-за исключения режима пользователя, система будет висеть в ожидании вмешательства отладки из точки разрыва.
Решение
Чтобы устранить эту проблему, отключим режим отладки с помощью одного из следующих методов:
Использование параметров конфигурации системы
Использование интерфейса командной строки
Дополнительная информация
Windows не следует запускать в режиме отлаживания постоянно. Режим отладки включен для подключения к отладку ядра с помощью отладок, таких как средства отладки для Windows (WinDbg) и должен быть отключен после выполнения цели.
Некоторые Windows 7 систем могут быть отправлены с включенным переключателем DEBUG, чтобы отключить его.
Чтобы скачать средства отладки для Windows и дополнительных сведений, см. в Windows Набор драйверов (WDK).
bcdedit
Файлы данные конфигурации загрузки (BCD) предоставляют хранилище, которое используется для описания приложений загрузки и параметров приложения загрузки. Объекты и элементы в хранилище фактически заменяют Boot.ini.
BCDEdit — это программа командной строки для управления хранилищами BCD. Его можно использовать для различных целей, включая создание новых магазинов, изменение существующих магазинов, Добавление параметров меню загрузки и т. д. BCDEdit выступает в основном той же цели, что и Bootcfg.exe в более ранних версиях Windows, но с двумя значительными улучшениями:
Предоставляет более широкий диапазон параметров загрузки, чем Bootcfg.exe.
Улучшена поддержка сценариев.
Чтобы использовать BCDEdit для изменения BCD, требуются права администратора.
BCDEdit — это основное средство для изменения конфигурации загрузки Windows Vista и более поздних версий Windows. он входит в дистрибутив Windows Vista в папке%WINDIR%\System32
BCDEdit ограничена стандартными типами данных и разработана в основном для выполнения отдельных общих изменений в BCD. для более сложных операций или нестандартных типов данных рассмотрите возможность использования программного интерфейса инструментарий управления Windows (WMI) BCD (WMI) для создания более мощных и гибких пользовательских средств.
Синтаксис
Параметры
Общие параметры Command-Line BCDEdit
Параметры, которые работают с хранилищем
Параметры, которые работают с записями в магазине
Параметры, которые работают с параметрами записи
| Параметр | Описание |
|---|---|
| /делетевалуе | Удаляет указанный элемент из загрузочной записи. |
| команде | Задает значение параметра записи. |
Параметры, управляющие выходными данными
Параметры, управляющие диспетчером загрузки
Параметры, управляющие службами аварийного управления
| Параметр | Описание |
|---|---|
| /бутемс | Включает или отключает службы аварийного управления (EMS) для указанной записи. |
| #a1 | Включает или отключает EMS для указанной загрузочной записи операционной системы. |
| /емссеттингс | Задает глобальные параметры EMS для компьютера. /емссеттингс не включает и не отключает EMS для любой конкретной записи загрузки. |
Параметры, управляющие отладкой
Дополнительные ссылки
Сведения об нотации, используемой для указания синтаксиса командной строки, см. в разделе ключ синтаксиса командной строки.
Средство командной строки bcdedit.exe позволяет редактировать данные конфигурации загрузки и входит в состав стандартных программ Windows Vista и более поздних, а также может использоваться при загрузке с установочного диска системы или диска аварийного восстановления. Естественно, для изменения конфигурации загрузки Windows, программа должны быть запущена с правами администратора.
Данные конфигурации загрузки можно условно разделить на 3 основных элемента:
— хранилище BCD (Store)
— записи в хранилище (Entries)
— параметры записей (Entry Options)
Перечень псевдонимов (известных идентификаторов):
Настоятельно рекомендуется, прежде чем приступать к освоению редактирования данных BCD, позаботиться о том, чтобы в наличии были средства их восстановления, на тот случай, когда запорченная конфигурация приведет к невозможности выполнения загрузки основной системы.
Встроенная справочная система bcdedit.exe содержит довольно подробную информацию по использованию команды и примеры ее применения. Формат командной строки для запроса пордсказки:
Перечень разделов справки, получаемый по команде bcdedit /? Topics в среде Windows 7:
Для получения справочной информации по подразделу, можно использовать команду, с указанием его имени:
Типы данных хранилища конфигурации:
Если формат данных не задан, то описание является набором символьных значений, которые можно использовать для данного типа. Для получения информации о форматах данных используется команда :
bcdedit /? Formats или bcdedit formats /?
Для получения информации о дополнительных типах для устройств, введите команду
bcdedit /? TYPES DEVOBJECT
Для получения информации о дополнительных типах для конкретных приложений, введите команду
bcdedit /? TYPES где может принимать следующие значения:
Просмотреть текущие параметры для приложения загрузки Windows можно с помощью команды:
bcdedit /enum osloader
После выполнения команды bcdedit /set increaseuserva 3072 конфигурация будет выглядеть следующим образом:
Отсутствие в конфигурации загрузки increaseuserva означает, что этот параметр не задан и будет использоваться его значение по умолчанию (2Гб для 32-разрядных и 4Гб для 64-разрядных ОС).
На практике, увеличение размера виртуального адресного пространства обычно используется для того, чтобы устранить аварийное завершение задач, как например, модов игры S.T.A.L.K.E.R, которым не хватает адресного пространства при обработке данных в памяти с настройками максимального качества графики. На 32-разрядных ОС Windows, установленного по умолчанию виртуального адресного пространства размером 2 Гб может не хватать, что приводит к аварийному завершению программы ( «вылету» игры ). Установка размера в 3 Гб командой bcdedit /set increaseuserva 3072 позволяет устранить эту проблему. Использование же, данной команды в 64-разрядных ОС Windows, приводит к уменьшению размера виртуального адресного пространства, поскольку его значение по умолчанию равно 4096 ( 4Гб).
Проверить установленное значение increaseuserva можно с использованием команды find в цепочке с командой bcdedit
bcdedit | find «increaseuserva»
В результате выполнения команды получим :
Примеры использования BCDEDIT
bcdedit /export «C:\My Backup\BCD2012»
Для восстановления конфигурации из ранее сохраненной копии используется команда:
bcdedit /import C:\backup\bdc2012
Пример вывода конфигурации загрузки на компьютере с установленными операционными системами Windows 7 и Windows XP:
bcdedit /default
bcdedit [/store ] /enum [ | ] [/v]
bcdedit /enum
bcdedit /enum
Для просмотра и изменения некоторых параметров конфигурации загрузки с помощью графического интерфейса можно использовать стандартное системное приложение Msconfig.exe ( вкладка «Загрузка»).
bcdedit /create [< >] /d [/application |/inherit [ ] | /inherit DEVICE | /device]
Для изменения параметров созданной копированием записи, можно воспользоваться командой bcdedit /set
Для того, чтобы новая запись конфигурации загрузки появилась в меню диспетчера необходимо выполнить команду bcdedit /displayorder:
[boot loader]
timeout=10
default=multi(0)disk(0)rdisk(0)partition(1)\WINDOWS
[operating systems]
multi(0)disk(0)rdisk(0)partition(3)\WINDOWS=»MS Windows Server 2003″ /fastdetect
multi(0)disk(0)rdisk(0)partition(1)\WINDOWS=»MS Windows XP Professional RUS» /fastdetect
По шагам, простейший алгоритм действий можно представить следующим образом:
Например, если Windows XP находится в первом разделе 2-го физического диска :
multi(0)disk(0)rdisk(1)partition(1)\WINDOWS=»MS Windows XP Professional RUS» /fastdetect
Создание конфигурации для загрузки продуктов на базе Windows PE.
Пошаговое решение задачи можно выполнить следующим образом:
— копирование файлов с компакт диска ERD Commander 7.0 в каталог, например с именем ERDC на диске C:
— создание записи конфигурации загрузки для виртуального диска в оперативной памяти.
— создание записи конфигурации BCD для выполнения загрузки операционной системы Windows PE из файла образа
— создание параметров, обеспечивающих добавление в меню загрузки соответствующего пункта.
— Создадим в текущей конфигурации загрузки новое устройство:
— Создадим новое приложение загрузки ОС:
— Для записи с GUID устройства (из файла ramdevice.txt) зададим параметры, определяющие местонахождение файла boot.sdi :
— зададим параметры записи для выполнения загрузки (GUID Из файла ramapp.txt) :
Красным цветом выделен GUID устройства ( из файла ramdevice.txt ), используемый в качестве параметра для приложения загрузки ОС.
Остается добавить в конец существующего меню загрузки новый пункт:
Особенности создания конфигурации BCD для загрузки с использованием приложения загрузочных секторов.
bcdedit /set
bcdedit /set
bcdedit /set
BCDEdit /dbgsettings
The /dbgsettings option sets or displays the current global debugger settings for the computer. To enable or disable the kernel debugger, use the BCDEdit /debug option.
Before setting BCDEdit options you might need to disable or suspend BitLocker and Secure Boot on the computer.
Parameters
Specifies that the target machine and the host machine will use an Ethernet network connection for debugging. When this option is used, the HOSTIP and PORT parameters must be included as well. The target computer must have a network adapter that is supported by Debugging Tools for Windows.
HOSTIP:ip
For network debugging, specifies the IP address of the host debugger.
KEY:key
For network debugging, specifies the key with which to encrypt the connection. 6 and [a-z] allowed only. Do not specify this parameter if you have specified the newkey parameter.
PORT:port
For network debugging, specifies the port to communicate with on the host debugger. Should be 49152 or higher.
newkey
For network debugging specifies that a new encryption key should be generated for the connection. Do not specify this parameter if you have specified a KEY parameter.
nodhcp
Setting nodhcp prevents use of DHCP to obtain the target IP address. This option is rarely required as even small routers provide support for DHCP. The nodhcp option should only be used if you know that there are no DHCP servers on the network. In most situations, the KDNET transport works best when this option is not set, and DHCP is enabled.
busparams=Bus.Device.Function Specifies the target controller. Bus specifies the bus number, Device specifies the device number, and Function specifies the function number.
To specify the bus parameters, Open Device Manager, and locate the network adapter that you want to use for debugging. Open the property page for the network adapter, and make a note of the bus number, device number, and function number. These values are displayed in Device Manager under Location on the General tab. In an elevated Command Prompt Window, enter the following command, where b, d, and f are the bus, device and function numbers in decimal format:
If you are manually configuring a debugger connection, you must specify the bus parameters. For more information, see Setting Up KDNET Network Kernel Debugging Manually and Setting Up Kernel-Mode Debugging over a USB 3.0 Cable Manually.
Examples
The following command configures the target computer to use an Ethernet connection for debugging and specifies the IP address of the host computer. The command also specifies a port number that the host computer can use to connect to the target computer.
The following command sets the global debugger settings to network debugging using IPv6 with a debugger host at 2001:48:d8:2f:5e:c0:42:28:4f5b communicating on port 50000:
Setting up a network debugging manually is a complex and error prone process. To set up network debugging automatically, see Setting Up KDNET Network Kernel Debugging Automatically. Using the KDNET utility is strongly recommended for all debugger users.
LOCAL
The LOCAL option sets the global debugging option to local debugging. This is kernel-mode debugging on a single computer. In other words, the debugger runs on the same computer that is being debugged. With local debugging you can examine state, but not break into kernel mode processes that would cause the OS to stop running.
Example
The following command sets the global debugger settings to local debugging.
The LOCAL option is available in Windows 8.0 and Windows Server 2012 and later.
For information on setting up local kernel mode debugging manually, see Setting Up Local Kernel Debugging of a Single Computer Manually.
SERIAL
Specifies that the target machine and the host machine will use a serial connection for debugging. When this option is used, the DEBUGPORT and BAUDRATE parameters should be specified.
BAUDRATE:baud
Specifies the baud rate to use. This parameter is optional. Valid values for baud are 9600, 19200, 38400, 57600, and 115200. The default baud rate is 115200 bps.
DEBUGPORT:port
Specifies the serial port to use as the debugging port. This is an optional setting. The default port is 1 (COM 1).
Example
The following command configures the target computer to use a serial connection for debugging. The command also specifies that the debugging connection will use COM1 and a baud rate of 115,200.
Specifies that the target machine and the host machine will use a USB 2.0 or USB 3.0 connection for debugging. When this option is used, the TARGETNAME parameter must be included as well.
TARGETNAME: targetname
Specifies a string value to use for the target name. Note that TargetName does not have to be the official name of the target computer; it can be any string that you create as long as it meets these restrictions:
Example
The following command configures the target computer to use USB connection for debugging. The command also specifies a target name that the host computer can use to connect to the target computer.
For more information, see:
The 1394 transport is available for use in Windows 10, version 1607 and earlier. It is not available in later versions of Windows. You should transition your projects to other transports, such as KDNET using Ethernet. For more information about that transport, see Setting Up KDNET Network Kernel Debugging Automatically.
Specifies that the target machine and the host machine will use an IEEE 1394 (FireWire) connection for debugging. When this option is used, the CHANNEL parameter can be included as well.
CHANNEL:channel
(Only used when the connection type is 1394.) Specifies the 1394 channel to use. The value for channel must be a decimal integer between 0 and 62, inclusive, and must match the channel number used by the host computer. The channel specified in this parameter does not depend on the physical 1394 port chosen on the adapter. The default value for channel is 0.
General Debugger Settings
/start startpolicy
This option specifies the debugger start policy. The following table shows the options for the startpolicy.
| Option | Description |
|---|---|
| ACTIVE | Specifies that the kernel debugger is active. |
| AUTOENABLE | Specifies that the kernel debugger is enabled automatically when an exception or other critical event occurs. Until then, the debugger is active but is disabled. |
| DISABLE | Specifies that the kernel debugger is enabled when you type kdbgctrl to clear the enable block. Until then, the debugger is active but is disabled. |
If a start policy is not specified, ACTIVE is the default.
/noumex
Specifies that the kernel debugger ignores user-mode exceptions. By default, the kernel debugger breaks for certain user-mode exceptions, such as STATUS_BREAKPOINT and STATUS_SINGLE_STEP. The /noumex parameter is effective only when there is no user-mode debugger attached to the process.
Comments
The /dbgsettings option configures the debugging settings, but does not enable debugging. You must use the /debug option to enable debugging for a specific boot entry. If there are no debugging settings specified for a particular boot entry, the default debug settings are used.
The default values for the dbgsettings are shown in the following table.
| dbgsetting parameter | Default value |
|---|---|
| debugtype | Local |
| debugstart | Active |
| noumex | Yes |
See also
For information about Windows debugging tools, see Windows Debugging.
For information about setting up and configuring a kernel-mode debugging session, see Setting Up Kernel-Mode Debugging Manually and Setting Up KDNET Network Kernel Debugging Automatically.
