winedbg-development - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

winedbg - Wine налагоджувач

СИНТАКСИС

winedbg [ опції ] [ назва_програми [ аргументи_програми ] | wpid ]

winedbg --gdb [ опції ] [ назва_програми [ аргументи_програми ] | wpid ]

winedbg --авто wpid

winedbg --мінідамп [ файл.mdmp ] wpid

winedbg файл.mdmp

ОПИС

winedbg є налагоджувачем для Wine. Це дозволяє:
+ налагодження рідних додатків Win32
+ налагодження додатків Winelib
+ бути заміною доктора Ватсона

РЕЖИМИ

winedbg можна використовувати в п'яти режимах. Перший аргумент програми визначає режим
winedbg запуститься.

дефолт
Без будь-якого явного режиму це стандарт winedbg робочий режим. winedbg волі
діяти як передня частина для користувача.

--gdb winedbg буде використовуватися як проксі для gdb. gdb буде інтерфейсом для команди
обробка, і winedbg буде проксувати всі запити на налагодження від gdb до API Win32.

--авто Цей режим використовується, коли winedbg встановлюється в AeDebug запис реєстру за замовчуванням
налагоджувач. winedbg потім відобразиться основна інформація про збій. Це корисно
для користувачів, які не хочуть налагоджувати збій, а збирають відповідну інформацію
про збій буде надіслано розробникам.

--мінідамп
Цей режим подібний до --авто один, за винятком того, що замість друку
інформація на екрані (як --авто робить), він зберігається у файлі міні-дампу. The
Ім'я файлу або передається в командному рядку, або створюється WineDbg коли
жодного не дається. Пізніше цей файл може бути перезавантажений winedbg для подальшого
обстеження.

файл.mdmp
У цьому режимі winedbg перезавантажує стан налагоджувача, який було збережено в a
файл мінідамп. Дивіться або мінідампа команду нижче, або --мінідамп режим.

ВАРІАНТИ

Коли в дефолт режимі доступні наступні параметри:

-- команда рядок
winedbg виконає команду рядок ніби він був наведений у командному рядку winedbg,
а потім вийде. Це може бути зручно для отримання pid запущених процесів
(winedbg --команда "info proc").

--файл ім'я файлу
winedbg виконає список команд, що містяться в імені файлу, так, ніби вони
були наведені в командному рядку winedbg, а потім вийде.

Коли в gdb в режимі проксі доступні такі параметри:

--не старт
gdb не буде запущено автоматично. Відповідна інформація для початку gdb is
надруковані на екрані. Це якось корисно, коли не використовується безпосередньо gdb але деякі
графічні інтерфейси, як ддд or кгбд.

--with-xterm
Це буде працювати gdb у власному xterm замість використання поточної консолі Unix для
текстовий дисплей.

У всіх режимах решта командного рядка, коли його передано, використовується для визначення якого
програми, якщо такі є, повинні бути налагоджені:

назва_програми
Це ім’я виконуваного файлу для запуску сеансу налагодження. winedbg волі
фактично створити процес з цим виконуваним файлом. Якщо програми_аргументи Також
враховуючи, вони будуть використовуватися як аргументи для створення процесу, який буде налагоджено.

wpid winedbg приєднається до процесу, яким є Windows pid wpid. Використовувати інформація процес
команда всередині winedbg для переліку запущених процесів та їхніх елементів Windows.

дефолт
Якщо нічого не вказано, ви увійдете в налагоджувач без жодного запуску та приєднання
процес. Вам доведеться виконати роботу самостійно.

КОМАНДИ

дефолт режим, та в той час як перезавантаження a мінідампа Файл:
Більшість команд, які використовуються в winedbg схожі на ті з gdb. Будь ласка, зверніться до gdb
документації для більш детальної інформації. Див gdb Відмінності розділ пізніше, щоб отримати a
список варіацій від gdb команди.

Різний Команди

перервати Припиняє роботу налагоджувача.

вихід Виходить з налагоджувача.

приєднувати N
Приєднати до процесу Wine (N це його ідентифікатор Windows, числовий або шістнадцятковий). Ідентифікатори можуть бути
отримані за допомогою інформація процес команда. Зверніть увагу на інформація процес команда повертається
шістнадцяткові значення

від'єднати Відокремлення від Wine-процесу.

Документи Команди

допомога Друкує довідку щодо команд.

допомога інформація
Друкує довідку щодо команд info

Потік контроль Команди

рахунок Продовжуйте виконання до наступної точки зупину або винятку.

проходити Передайте подію винятку в ланцюжок фільтрів.

крок Продовжуйте виконання до наступного рядка C коду (входить у виклик функції)

наступний Продовжуйте виконання до наступного рядка C коду (не входить до виклику функції)

stepi Виконати наступну інструкцію збірки (входить у виклик функції)

nexti Виконати наступну інструкцію складання (не входить у виклик функції)

закінчення Виконувати, доки не буде досягнуто повернення поточної функції.

рахунок, крок, наступний, stepi, nexti може бути постфіксовано числом (N), що означає, що команда
має бути виконано N разів, перш ніж керування буде повернено користувачеві.

точки зупинки, точки спостереження

включіть N
Вмикає точку (переривання|спостереження). N

забороняти N
Відключає (break|watch)-point N

видаляти N
Видаляє (break|watch)-точку N

кондиц N Видаляє будь-яку існуючу умову до точки (перерва|спостереження). N

кондиц N експр
Додає умову експр до (перерви|догляд)-пункт N. експр буде оцінюватися кожного разу
(break|watch)-точка досягнута. Якщо результат дорівнює нулю, точкою зупину немає
спрацьовує.

перерву * N
Додає точку зупину за адресою N

перерву id
Додає точку зупинки за адресою символу id

перерву id N
Додає точку зупину в рядку N внутрішній символ id.

перерву N
Додає точку зупину в рядку N поточного вихідного файлу.

перерву Додає точку зупинки на поточний момент $ПК адреса

дивитися * N
Додає команду перегляду (під час запису) за адресою N (на 4 байти).

дивитися id
Додає команду перегляду (під час запису) за адресою символу id. Розмір залежить від розміру
of id.

rwatch * N
Додає команду перегляду (під час читання) за адресою N (на 4 байти).

rwatch id
Додає команду дивитися (під час читання) за адресою символу id. Розмір залежить від розміру
id.

інформація перерву
Перелічує всі (перерви|догляд)-точки (з їхнім станом).

Ви можете використовувати символ Точка входу для точки входу Dll.

При встановленні (перерви|догляд) точки за id, якщо символ не знайдено (наприклад,
символ міститься у ще не завантаженому модулі), winedbg згадає назву
символ і намагатиметься встановити точку зупину кожного разу, коли завантажується новий модуль (доки він
вдається).

Стек маніпуляція

bt Надрукувати стек викликів поточного потоку.

bt N Надрукувати стек виклику потоку ідентифікатора N. Примітка: це не змінює положення
поточний кадр, яким керує up & dn команди).

up Піднімається на один кадр вгору в стеку поточного потоку

up N Йде вгору N кадрів у стеку поточного потоку

dn Спускається на один кадр вниз у стеку поточного потоку

dn N Рухається вниз N кадрів у стеку поточного потоку

кадр N
набори N як поточний кадр для стека поточного потоку.

інформація місцеві жителі
Друкує інформацію про локальні змінні для поточного кадру функції.

Каталог & джерело файл маніпуляція

Показувати реж
Друкує список каталогів, де шукаються вихідні файли.

реж ім'я шляху
Додає ім'я шляху до списку каталогів, де шукати вихідні файли

реж Видаляє список каталогів, де шукати вихідні файли

символьний файл ім'я шляху
Завантажує зовнішній файл визначення символів ім'я шляху

символьний файл ім'я шляху N
Завантажує зовнішній файл визначення символів ім'я шляху (застосування зміщення N до
адреси)

список Перелічує 10 вихідних рядків вперед з поточної позиції.

список - Перелічує 10 вихідних рядків назад від поточної позиції

список N Перелічує 10 вихідних рядків із рядка N у поточному файлі

список ім'я шляху:N
Перелічує 10 вихідних рядків із рядка N у файлі ім'я шляху

список id
Перелічує 10 вихідних рядків функцій id

список * N
Перелічує 10 вихідних рядків з адреси N

Ви можете вказати кінцеву ціль (щоб змінити значення 10 рядків) за допомогою роздільника ','. Для
приклад:

список 123, 234
перераховує вихідні рядки від рядка 123 до рядка 234 у поточному файлі

список foo.c:1,56
перераховує вихідні рядки від рядка 1 до 56 у файлі foo.c

відображення

Відображення – це вираз, який оцінюється та друкується після виконання будь-якого winedbg
команда

дисплей

інформація дисплей
Перелічує активні дисплеї

дисплей експр
Додає відображення для вираження експр

дисплей /fmt експр
Додає відображення для вираження експр. Друк оцінено експр виконується за допомогою наведеного
формат (див друк команда більше про формати)

Дель дисплей N

не відображати N
Видаляє дисплей N

Розбирання

дис Розібрати з поточного положення

дис експр
Розбираємо з адреси експр

дис експр,експр
Розбирає код між адресами, заданими двома виразами

пам'ять (читання, написання, друкую)

x експр Перевіряє пам'ять за адресою експр

x /fmt експр
Перевіряє пам'ять за адресою експр використовуючи формат fmt

друк експр
Друкує значення експр (можливо, використовуючи його тип)

друк /fmt експр
Друкує значення експр (можливо, використовуючи його тип)

комплект було = експр
Записує значення експр in було змінна

що експр
Друкує вираз типу C експр

fmt є також лист or вважати лист, Де лист може бути:

рядок ASCII

ua рядок UTF16 Unicode

i інструкція (розбирати)

x 32-розрядне шістнадцяткове число без знака

d 32-розрядне десяткове число зі знаком

w 16-розрядне шістнадцяткове число без знака

символ c (фактично друкуються лише друковані 0x20-0x7f)

b 8-розрядне шістнадцяткове число без знака

g Win32 GUID

Вирази

Вирази в Wine Debugger в основному записуються у формі C. Однак є кілька
розбіжності:

Ідентифікатори можуть приймати '!' на їх імена. Це дозволяє в основному вказати модуль
де шукати ідентифікатор, напр USER32!CreateWindowExA.

В операції приведення, вказуючи структуру або об’єднання, ви повинні використовувати структуру
або ключове слово union (навіть якщо ваша програма використовує typedef).

Під час вказівки ідентифікатора, якщо існує кілька символів з цим ім’ям, налагоджувач буде
запитати символ, який ви хочете використати. Виберіть потрібний з його номера.

Різний

мінідампа файл.mdmp зберігає контекст налагодження налагоджуваного у файлі міні-дампу
файл.mdmp.

Інформація on вино внутрішні органи

інформація клас
Перелічує всі класи Windows, зареєстровані в Wine

інформація клас id
Друкує інформацію про клас Windows id

інформація частка
Перелічує всі динамічні бібліотеки, завантажені в налагоджену програму (включаючи .so
файли, NE та PE DLL)

інформація частка N
Друкує інформацію про модуль за адресою N

інформація рег
Друкує значення регістрів ЦП

інформація всі рег
Друкує значення регістрів ЦП і з плаваючою точкою

інформація сегмент
Перелічує всі виділені сегменти (лише i386)

інформація сегмент N
Друкує інформацію про сегмент N (лише i386)

інформація стек
Друкує значення поверх стеку

інформація карта
Перелічує всі віртуальні відображення, які використовуються налагодженою програмою

інформація карта N
Перелічує всі віртуальні відображення, які використовуються програмою Windows pid N

інформація вітер
Відображає ієрархію вікон, починаючи з вікна робочого столу

інформація вітер N
Друкує інформацію про вікно ручки N

інформація процес
Перелічує всі w-процеси в сесії Wine

інформація нитка
Перелічує всі w-потоки в сеансі Wine

інформація кадр
Перелічує кадри винятків (починаючи з поточного кадру стека). Ви також можете пройти,
як необов'язковий аргумент, ідентифікатор потоку (замість поточного потоку), щоб перевірити його
кадри винятків.

Повідомлення про налагодження можна вмикати та вимикати під час налагодження за допомогою комплект команда, але
лише для каналів, ініціалізованих за допомогою WINEDEBUG змінна оточення

комплект попереджати + виграти
Вмикає попередження виграти канал

комплект + виграти
Вмикає warn/fixme/err/trace виграти канал

комплект - виграти
Вимикає warn/fixme/err/trace виграти канал

комплект виправити мене - всі
Вимикає клас fixme на всіх каналах

Gdb режим:
Див gdb документація на всі gdb команди.

Однак доступні кілька розширень Wine через контролювати команда:

контролювати вітер
Перелічує всі вікна в сеансі Wine

контролювати процес
Перелічує всі процеси в сеансі Wine

контролювати Член
Відображає відображення пам’яті налагодженого процесу

Авто та мінідампа режими:
Оскільки введення користувача неможливе, команди недоступні.

НАВКОЛИШНЄ СЕРЕДОВИЩЕ

WINE_GDB
При використанні в gdb режим проксі, WINE_GDB вказує ім'я (і шлях) до
виконуваний файл для використання gdb. "gdb" використовується за замовчуванням.

AUTHORS

Першу версію написав Ерік Янгдейл.

Перегляньте список розробників Wine для решти учасників.

Використовуйте winedbg-development онлайн за допомогою служб onworks.net