winedbg-development - מקוון בענן

תָכְנִית:

שֵׁם

winedbg - מנפה באגים של יין

תַקצִיר

winedbg [ אפשרויות ] [ תוכנית_שם [ טיעוני_תוכנית ] | wpid ]

winedbg --gdb [ אפשרויות ] [ תוכנית_שם [ טיעוני_תוכנית ] | wpid ]

winedbg --אוטומטי wpid

winedbg --מינידמפ [ file.mdmp ] wpid

winedbg file.mdmp

תיאור

winedbg הוא מאתר באגים עבור Wine. זה מאפשר:
+ איתור באגים ביישומי Win32 מקוריים
+ איתור באגים ביישומי Winelib
+ להיות תחליף נפוץ של ד"ר ווטסון

מצבים

winedbg ניתן להשתמש בחמישה מצבים. הארגומנט הראשון לתוכנית קובע את המצב
winedbg ירוץ פנימה.

ברירת מחדל
ללא כל מצב מפורש, זה סטנדרטי winedbg מצב הפעלה. winedbg יצטרך
לשמש כחזית עבור המשתמש.

--gdb winedbg ישמש כפרוקסי עבור gdb. gdb יהיה הקצה הקדמי לפקודה
טיפול, ו winedbg ישיג את כל בקשות ניפוי הבאגים מאת gdb לממשקי ה-API של Win32.

--אוטומטי מצב זה משמש כאשר winedbg מוגדר ב AeDebug ערך הרישום כברירת מחדל
מנפה. winedbg לאחר מכן יציג מידע בסיסי על קריסה. זה שימושי
למשתמשים שאינם רוצים לנפות באגים בקריסה, אלא לאסוף מידע רלוונטי
על ההתרסקות שתישלח למפתחים.

--מינידמפ
מצב זה דומה ל --אוטומטי אחד, אלא שבמקום להדפיס את
מידע על המסך (כמו --אוטומטי עושה זאת), הוא נשמר בקובץ minidump. ה
שם הקובץ מועבר בשורת הפקודה, או נוצר על ידי WineDbg מתי
אף אחד לא ניתן. מאוחר יותר ניתן לטעון מחדש את הקובץ הזה winedbg עוד
בדיקה.

file.mdmp
במצב זה winedbg טוען מחדש את המצב של ניפוי באגים שנשמר ב-a
קובץ minidump. ראה או את Minidump הפקודה למטה, או את --מינידמפ מצב.

אפשרויות

כאשר ב ברירת מחדל במצב, האפשרויות הבאות זמינות:

--פקודה מחרוזת
winedbg יבצע את הפקודה מחרוזת כאילו הוא הוקל בשורת הפקודה של winedbg,
ואז ייצא. זה יכול להיות שימושי כדי לקבל את ה-pid של תהליכים רצים
(winedbg --פקודה "מידע פרוק").

--קוֹבֶץ שם הקובץ
winedbg יבצע את רשימת הפקודות הכלולות בשם הקובץ של הקובץ כאילו הן
הוקשו בשורת הפקודה של winedbg, ולאחר מכן ייצאו.

כאשר ב gdb במצב proxy, האפשרויות הבאות זמינות:

--אין התחלה
gdb לא יופעל אוטומטית. מידע רלוונטי להתחלה gdb is
מודפס על המסך. זה איכשהו שימושי כשלא משתמשים ישירות gdb אבל כמה
חזיתות גרפיות, כמו ddd or kgbd.

--with-xterm
זה יפעל gdb ב-xterm משלו במקום להשתמש במסוף ה-Unix הנוכחי עבור
תצוגה טקסטואלית.

בכל המצבים, שאר שורת הפקודה, כאשר היא עוברת, משמשת כדי לזהות איזה
תוכניות, אם ישנן, חייבות לנפות באגים:

תוכנית_שם
זהו השם של קובץ הפעלה להפעלה עבור הפעלת ניפוי באגים. winedbg יצטרך
למעשה ליצור תהליך עם קובץ ההפעלה הזה. אם תוכניות_טיעונים גם
בהינתן, הם ישמשו כטיעונים ליצירת התהליך לניפוי באגים.

wpid winedbg יצורף לתהליך שהוא Windows pid wpid. להשתמש ב מידע proc
פקודה בפנים winedbg לרשימת תהליכים פועלים וה-Pids של Windows שלהם.

ברירת מחדל
אם לא צוין שום דבר, תיכנס ל-debugger ללא כל הפעלה או חיבור
תהליך. אתה תצטרך לעשות את העבודה בעצמך.

פקודות

בְּרִירַת מֶחדָל מצב, ו בזמן טוען מחדש a Minidump קובץ:
רוב הפקודות בשימוש ב winedbg דומים לאלה מ gdb. אנא עיין ב gdb
תיעוד לפרטים נוספים. ראה את gdb ההבדלים סעיף מאוחר יותר כדי לקבל א
רשימת וריאציות מ gdb פקודות.

שונה. פקודות

ביטול מבטל את מאפר הבאגים.

להפסיק יוצא מאתר הבאגים.

לצרף N
צרף לתהליך יין (N הוא מזהה Windows שלו, מספרי או הקסדצימלי). תעודות זהות יכולות להיות
מתקבל באמצעות מידע תהליך פקודה. שימו לב ל מידע תהליך הפקודה חוזרת
ערכים הקסדצימליים

לנתק התנתק מתהליך יין.

עֶזרָה פקודות

לעזור מדפיס קצת עזרה על הפקודות.

לעזור מידע
מדפיס קצת עזרה על פקודות מידע

זרימה לִשְׁלוֹט פקודות

חשבון המשך בביצוע עד לנקודת השבירה או החריגה הבאה.

לעבור העבר את אירוע החריגה לשרשרת המסנן.

צעד המשך בביצוע עד שורת הקוד C הבאה (נכנס לקריאת פונקציה)

הבא המשך בביצוע עד שורת הקוד C הבאה (לא נכנסת לקריאה לפונקציה)

סטפי בצע את הוראת ההרכבה הבאה (נכנס לקריאת פונקציה)

nexti בצע את הוראת ההרכבה הבאה (לא נכנס לקריאת פונקציה)

גימור בצע עד שתגיע להחזרה של הפונקציה הנוכחית.

חשבון, צעד, הבא, סטפי, nexti ניתן לתקן אחרי מספר (N), כלומר הפקודה
יש לבצע N פעמים לפני החזרת השליטה למשתמש.

נקודות שבירה, נקודות תצפית

לאפשר N
מאפשר (break|watch)-point N

להשבית N
משבית (הפסקה|צפייה) נקודת N

להסיר N
מוחק (הפסקה|צפייה)-נקודה N

תנאי N מסיר כל תנאי קיים ל-(break|watch)-point N

תנאי N ביטוי
מוסיף מצב ביטוי to (break|watch)-point N. ביטוי יוערך בכל פעם
(break|watch)-נקודת נפגעת. אם התוצאה היא ערך אפס, נקודת השבירה אינה
מופעלת.

לשבור * N
מוסיף נקודת שבירה בכתובת N

לשבור id
מוסיף נקודת שבירה בכתובת הסמל id

לשבור id N
מוסיף נקודת שבירה בקו N סמל פנימי id.

לשבור N
מוסיף נקודת שבירה בקו N של קובץ המקור הנוכחי.

לשבור מוסיף נקודת שבירה בזרם $PC כתובת.

שעון * N
מוסיף פקודת שעון (בכתיבה) בכתובת N (על 4 בתים).

שעון id
מוסיף פקודת שעון (בכתיבה) בכתובת הסמל id. הגודל תלוי בגודל
of id.

שעון * N
מוסיף פקודת שעון (בקריאה) בכתובת N (על 4 בתים).

שעון id
מוסיף פקודת שעון (בקריאה) בכתובת הסמל id. גודל תלוי בגודל של
id.

מידע לשבור
מפרט את כל (הפסקה|צפייה)-נקודות (עם מצבן).

אתה יכול להשתמש בסמל נקודת כניסה לעמוד על נקודת הכניסה של ה-Dll.

בעת הגדרת נקודת (הפסקה|שעון) על ידי id, אם לא ניתן למצוא את הסמל (לדוגמה, ה
הסמל כלול במודול שטרם נטען), winedbg יזכור את השם של
סמל וינסה להגדיר את נקודת השבירה בכל פעם שמודול חדש נטען (עד שהוא
מצליח).

לערום מניפולציה

bt הדפס ערימת שיחות של השרשור הנוכחי.

bt N הדפס ערימת שיחות של חוט של מזהה N. הערה: זה לא משנה את המיקום של
המסגרת הנוכחית כפי שתופעל על ידי ה- up & dn פקודות).

up עולה מסגרת אחת בערימה של השרשור הנוכחי

up N עולה N מסגרות בערימה של השרשור הנוכחי

dn יורד מסגרת אחת בערימה של השרשור הנוכחי

dn N הולך למטה N מסגרות בערימה של השרשור הנוכחי

מסגרת N
סטים N כמסגרת הנוכחית עבור הערימה של השרשור הנוכחי.

מידע המקומיים
מדפיס מידע על משתנים מקומיים עבור מסגרת הפונקציה הנוכחית.

מַדרִיך & מָקוֹר פילה מניפולציה

לְהַצִיג dir
מדפיס את רשימת ה-dirs שבהם מחפשים קבצי מקור.

dir שם נתיב
מוסיף שם נתיב לרשימת ה-dirs היכן לחפש קבצי מקור

dir מוחק את רשימת ה-dirs היכן לחפש קבצי מקור

קובץ סמלים שם נתיב
טוען קובץ הגדרות סמל חיצוני שם נתיב

קובץ סמלים שם נתיב 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

פירוק

disas לפרק מהמיקום הנוכחי

disas ביטוי
לפרק מהכתובת ביטוי

disas ביטוי,ביטוי
מפרק קוד בין כתובות שצוינו על ידי שני הביטויים

זכרון (קריאה, כותב, הקלדה)

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.

בפעולת יציקה, בעת ציון מבנה או איחוד, עליך להשתמש במבנה
או מילת מפתח של איחוד (גם אם התוכנית שלך משתמשת ב-typedef).

בעת ציון מזהה, אם קיימים מספר סמלים בשם זה, מאתר הבאגים יעשה זאת
תבקש את הסמל שבו ברצונך להשתמש. קח את הרצוי מהמספר שלו.

שונה.

Minidump file.mdmp שומר את הקשר ניפוי הבאגים של מנפה בקובץ minidump שנקרא
file.mdmp.

מֵידָע on יַיִן פנימיות

מידע בכיתה
מפרט את כל מחלקות Windows הרשומות ב-Wine

מידע בכיתה id
מדפיס מידע על מחלקת Windows id

מידע נתח
מפרט את כל הספריות הדינמיות שנטענו בתוכנית שפותחה באגים (כולל .so
קבצים, קובצי DLL של NE ו-PE)

מידע נתח N
מדפיס מידע על מודול בכתובת N

מידע ובתקנות
מדפיס את הערך של אוגרי המעבד

מידע כל התקנות
מדפיס את הערך של אוגרי ה-CPU והנקודה הצפה

מידע קטע
מפרט את כל הפלחים שהוקצו (i386 בלבד)

מידע קטע N
מדפיס מידע על קטע N (i386 בלבד)

מידע לערום
מדפיס את הערכים על גבי הערימה

מידע מַפָּה
מפרט את כל המיפויים הווירטואליים המשמשים את התוכנית שפותחה באגים

מידע מַפָּה N
מפרט את כל המיפויים הווירטואליים המשמשים את התוכנית של Windows pid N

מידע wnd
מציג את היררכיית החלונות החל מחלון שולחן העבודה

מידע wnd N
מדפיס מידע של חלון הידית N

מידע תהליך
מפרט את כל תהליכי w בהפעלת Wine

מידע חוט
מפרט את כל ה-w-threads בהפעלה של Wine

מידע מסגרת
מפרט את המסגרות החריגות (החל ממסגרת המחסנית הנוכחית). אפשר גם לעבור,
כארגומנט אופציונלי, מזהה שרשור (במקום השרשור הנוכחי) כדי לבחון אותו
מסגרות חריגות.

ניתן להפעיל ולכבות הודעות ניפוי באגים תוך כדי ניפוי באגים באמצעות סט פקודה, אבל
רק עבור ערוצים שאותחל עם WINEDEBUG משתנה הסביבה.

סט להזהיר + לנצח
מופעל אזהרה לנצח ערוץ

סט + לנצח
מופעל אזהרה/תיקון/שגיאה/מעקב לנצח ערוץ

סט - לנצח
מכבה את התראה/תיקון/שגיאה/מעקב לנצח ערוץ

סט לתקן אותי - את כל
מכבה את ה-fixme class בכל הערוצים

Gdb מצב:
ראה gdb תיעוד לכל gdb פקודות.

עם זאת, כמה הרחבות Wine זמינות, דרך צג פקודה:

צג wnd
מפרט את כל החלונות בהפעלת Wine

צג proc
מפרט את כל התהליכים בסשן היין

צג מ
מציג מיפוי זיכרון של תהליך ניפוי באגים

אוטומטי ו Minidump מצבים:
מכיוון שלא ניתן להזין קלט משתמש, אין פקודות זמינות.

הסביבה

WINE_GDB
כאשר משתמשים בו ב gdb מצב פרוקסי, WINE_GDB מציין את השם (והנתיב) של ה-
קובץ הפעלה שישמש עבורו gdb. "gdb" משמש כברירת מחדל.

מחברים

הגרסה הראשונה נכתבה על ידי אריק יאנגדייל.

ראה רשימת מפתחי יין לשאר התורמים.

השתמש ב-winedbg-development באינטרנט באמצעות שירותי onworks.net