arm-linux-androideabi-gprof - מקוון בענן

תָכְנִית:

שֵׁם

gprof - הצג נתוני פרופיל של גרף שיחות

תַקצִיר

gprof [ -[abcDhilLrsTvwxyz] ] [ -[ACEEfFJnNOpPqQZ][שם]]
[ -אני דירס ] [ -ד[NUM] ] [ -ק מ ל ]
[ -M ספירת דקות ] [ -ר map_file ] [ -ת באורך השולחן ]
[ --[no-]מקור מובא[=שם]]
[ --[לא-]ספירות מנהלים[=שם]]
[ --[לא-]פרופיל שטוח[=שם] ] [ --[לא-]גרף[=שם]]
[ --[no-]זמן=שם] [ -- כל השורות ] [ -- קצר ]
[ --debug[=רָמָה] ] [ -- סדר פונקציות ]
[ --סדרת קבצים map_file ] [ --directory-path=דירס ]
[ --display-unused-functions ] [ --file-format=שם ]
[ --file-info ] [ --help ] [ --line ] [ --inline-file-names ]
[ --min-count=n ] [ --לא-סטטי ] [ --הדפס-נתיב ]
[ --קבצים נפרדים ] [ ---static-call-graph ] [ --sum ]
[ ---table-length=לן ] [ --מסורתי ] [ --גרסה ]
[ --width=n ] [ --התעלם-לא-פונקציות ]
[ --demangle[=סגנון] ] [ --ללא-דמנגל ]
[--external-symbol-table=name]
[ קובץ תמונה ] [ קובץ פרופיל ... ]

תיאור

"gprof" מייצר פרופיל ביצוע של תוכניות C, Pascal או Fortran77. האפקט של
שגרות שנקראות משולבות בפרופיל של כל מתקשר. נתוני הפרופיל נלקחים
מקובץ פרופיל גרף השיחות (gmon.out ברירת מחדל) שנוצרת על ידי תוכניות שכן
הידור עם ה -עמוד אפשרות של "cc", "pc" ו-"f77". ה -עמוד אפשרות גם מקשרת
גרסאות של שגרות הספרייה המורכבות ליצירת פרופילים. "Gprof" קורא את הנתון
קובץ אובייקט (ברירת המחדל היא "a.out") וקובע את היחס בין טבלת הסמלים שלו
ופרופיל גרף השיחות מ gmon.out. אם צוין יותר מקובץ פרופיל אחד, ה
פלט "gprof" מציג את הסכום של מידע הפרופיל בקובצי הפרופיל הנתונים.

אם אתה משתמש ב-gcc 2.95.x או 3.0 כדי להרכיב את הקבצים הבינאריים שלך, ייתכן שיהיה עליך להוסיף את
-fprofile-arcs לשורת הפקודה קומפיל על מנת שגרפי השיחה יהיו תקינים
מאוחסן ב-gmon.out.

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

מספר צורות של פלט זמינות מהניתוח.

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

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

אל האני הערה מָקוֹר הרישום הוא עותק של קוד המקור של התוכנית, המסומן ב-
מספר הפעמים שכל שורה של התוכנית בוצעה.

אפשרויות

אפשרויות אלה מציינות איזה מכמה פורמטי פלט "gprof" צריך לייצר.

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

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

"-א[symspec]"
"--annotated-source[=symspec]"
אל האני -A אפשרות גורמת ל"gprof" להדפיס קוד מקור מוער. אם symspec מצוין,
הדפס פלט רק עבור סמלים תואמים.

"-ב"
"--קָצָר"
אם -b האפשרות ניתנת, "gprof" לא מדפיס את הבלבולים המילוליים שמנסים לעשות זאת
להסביר את המשמעות של כל השדות בטבלאות. זה שימושי אם אתה מתכוון
כדי להדפיס את הפלט, או שנמאס לי לראות את הבלבול.

"-ג[symspec]"
"--exec-counts[=symspec]"
אל האני -C option גורמת ל-"gprof" להדפיס אוסף של פונקציות ומספר הפעמים
כל אחד נקרא. אם symspec מצוין, הדפס סיכום רק עבור סמלים תואמים.

אם קובץ נתוני הפרופיל מכיל רשומות ספירת בלוקים בסיסיים, ציון ה -l אוֹפְּצִיָה,
יחד עם -C, יגרום לספירת הביצוע של בלוקים בסיסיים להיערך ולהצגה.

"-אני"
"--קובץ-מידע"
אל האני -i האפשרות גורמת ל-"gprof" להציג מידע סיכום על נתוני הפרופיל
קבצים ואז צא. מספר ההיסטוגרמה, גרף השיחות וספירת הבלוקים הבסיסיים
הרשומות מוצגות.

"-אני מנהלים"
"--directory-path=מנהלים"
אל האני -I אפשרות מציינת רשימה של ספריות חיפוש בהן ניתן למצוא קבצי מקור.
משתנה הסביבה GPROF_PATH יכול לשמש גם להעברת מידע זה. בשימוש
בעיקר עבור פלט מקור מוער.

"-ג'[symspec]"
"--no-annotated-source[=symspec]"
אל האני -J אפשרות גורמת ל-"gprof" לא להדפיס קוד מקור מוער. אם symspec is
שצוין, "gprof" מדפיס מקור מוער, אך אינו כולל סמלים תואמים.

"-ל"
"--הדפס-נתיב"
בדרך כלל, שמות קבצי מקור מודפסים כאשר רכיב הנתיב מודחק. ה -L
option גורמת ל-"gprof" להדפיס את שם הנתיב המלא של שמות קבצי המקור, כלומר
נקבע ממידע איתור באגים סמלי בקובץ התמונה והוא יחסית ל
הספרייה שבה הופעל המהדר.

"-p[symspec]"
"--פרופיל שטוח[=symspec]"
אל האני -p האפשרות גורמת ל"gprof" להדפיס פרופיל שטוח. אם symspec מצוין, הדפס
פרופיל שטוח רק לסמלים תואמים.

"-פ[symspec]"
"--no-flat-profile[=symspec]"
אל האני -P אפשרות גורמת ל"gprof" לדכא הדפסת פרופיל שטוח. אם symspec is
שצוין, "gprof" מדפיס פרופיל שטוח, אך אינו כולל סמלים תואמים.

"-ש[symspec]"
"--גרף[=symspec]"
אל האני -q אפשרות גורמת ל"gprof" להדפיס את ניתוח גרף השיחות. אם symspec is
שצוין, הדפס גרף שיחות רק עבור סמלים תואמים וילדיהם.

"-ש[symspec]"
"--אין-גרף[=symspec]"
אל האני -Q אפשרות גורמת ל"gprof" לדכא את הדפסת גרף השיחות. אם symspec is
שצוין, "gprof" מדפיס גרף שיחה, אך אינו כולל סמלים תואמים.

"-t"
"--אורך השולחן=מספר"
אל האני -t אפשרות גורמת ל NUM שורות המקור הפעילות ביותר בכל קובץ מקור שיוצגו
כאשר הערת מקור מופעלת. ברירת המחדל היא 10.

"-י"
"--קבצים נפרדים"
אפשרות זו משפיעה על פלט מקור מובא בלבד. בדרך כלל, "gprof" מדפיס עם הערות
קבצי מקור לפלט סטנדרטי. אם אפשרות זו צוינה, מקור מובא עבור א
קובץ בשם נתיב/שם קובץ נוצר בקובץ שם קובץ-אן. אם הבסיס
מערכת הקבצים תקטע שם קובץ-אן כך שהוא יחליף את המקור שם הקובץ,
"gprof" יוצר מקור מוער בקובץ filename.ann במקום זאת (אם המקור
לשם הקובץ יש סיומת, סיומת זו היא החליף עם .ann).

"-ז[symspec]"
"--ללא ספירת מנהלים[=symspec]"
אל האני -Z option גורמת ל-"gprof" לא להדפיס אוסף של פונקציות ומספר הפעמים
כל אחד נקרא. אם symspec מצוין, הדפס סיכום, אך אל תכלול סמלים תואמים.

"-ר"
"--סידור פונקציות"
אל האני --סידור פונקציות אפשרות גורמת ל"gprof" להדפיס סדר פונקציה מוצע
עבור התוכנית המבוססת על נתוני פרופיל. אפשרות זו מציעה הזמנה אשר עשויה
שפר את התנהגות ההחלפה, tlb והמטמון עבור התוכנית במערכות התומכות
סדר שרירותי של פונקציות בקובץ הפעלה.

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

"-ר map_file"
"--סידור קבצים map_file"
אל האני --סדר קבצים אפשרות גורמת ל-"gprof" להדפיס סדר מוצע של שורת קישור .o
עבור התוכנית המבוססת על נתוני פרופיל. אפשרות זו מציעה הזמנה אשר עשויה
שפר את התנהגות ההחלפה, tlb והמטמון עבור התוכנית במערכות שאינן תומכות
סדר שרירותי של פונקציות בקובץ הפעלה.

שימוש ב- -a טיעון מומלץ מאוד עם אפשרות זו.

אל האני map_file ארגומנט הוא שם נתיב לקובץ המספק שם פונקציה לאובייקט
מיפוי קבצים. פורמט הקובץ דומה לפלט של התוכנית "nm".

c-parse.o:00000000 T yyparse
c-parse.o:00000004 C yyerrflag
c-lang.o:00000000 T maybe_objc_method_name
c-lang.o:00000000 T print_lang_statistics
c-lang.o:00000000 T identifi_objc_keyword
c-decl.o:00000000 T print_lang_identifier
c-decl.o:00000000 T print_lang_type
...

ליצור map_file עם GNU "nm", הקלד פקודה כמו "nm --extern-only
--defined-only -v --print-file-name program-name".

"-T"
"--מָסוֹרתִי"
אל האני -T option גורמת ל-"gprof" להדפיס את הפלט שלו בסגנון BSD "מסורתי".

"-וו רוֹחַב"
"--רוחב=רוֹחַב"
מגדיר את רוחב קווי הפלט ל רוחב. כרגע משמש רק בעת הדפסת הפונקציה
אינדקס בתחתית גרף השיחות.

"-איקס"
"--כל הקווים"
אפשרות זו משפיעה על פלט מקור מובא בלבד. כברירת מחדל, רק הקווים ב-
תחילתו של בלוק בסיסי מסומנים. אם אפשרות זו צוינה, כל שורה נכנסת
בלוק בסיסי מסומן על ידי חזרה על ההערה עבור השורה הראשונה. זֶה
התנהגות דומה להתנהגות של "tcov". -a.

"--demangle[=סִגְנוֹן]"
"--ללא התפלה"
אפשרויות אלה קובעות אם יש לבטל שמות של סמל C++ בעת ההדפסה
תְפוּקָה. ברירת המחדל היא פירוק סמלים. ניתן להשתמש באפשרות "--no-demangle".
כדי לכבות את ה-demanting. למהדרים שונים יש סגנונות מננגל שונים. ה
ניתן להשתמש בטיעון אופציונלי של סגנון דה-mangeling כדי לבחור דה-mangelling מתאים
סגנון עבור המהדר שלך.

אָנָלִיזָה אפשרויות
"-א"
"--לא-סטטי"
אל האני -a אפשרות גורמת ל"gprof" לדכא את ההדפסה של מוצהר סטטי (פרטי)
פונקציות. (אלה פונקציות ששמותיהן לא מופיעים כגלובליים, ואלו כן
לא נראה מחוץ לקובץ/פונקציה/בלוק שבו הם הוגדרו.) זמן שהייה בו
פונקציות אלו, קריאות אליהן/מהן וכו', כולן יוחסו לפונקציה that
נטען ישירות לפניו בקובץ ההפעלה. אפשרות זו משפיעה הן על
פרופיל שטוח וגרף השיחות.

"-ג"
"--static-call-graph"
אל האני -c אפשרות גורמת להגדלת גרף השיחות של התוכנית בהיוריסטיקה
אשר בוחן את מרחב הטקסט של קובץ האובייקט ומזהה קריאות לפונקציות ב-
קוד מכונה בינארי. מכיוון שרשומות גרף שיחות רגילות נוצרות רק כאשר
פונקציות מוזנות, אפשרות זו מזהה ילדים שניתן היה לקרוא להם,
אבל מעולם לא היו. קריאות לפונקציות שלא בוצעו כשהפרופיל מופעל הן
מזוהים גם, אבל רק אם קיימים ערכי טבלת סמלים עבורם. שיחות ל
שגרות ספרייה דינמיות הן בדרך כלל לֹא נמצא על ידי אפשרות זו. הורים או ילדים
המזוהים באמצעות היוריסטיקה זו מסומנים בגרף השיחות עם ספירת שיחות של 0.

"-D"
"--התעלם-לא-פונקציות"
אל האני -D option גורמת ל-"gprof" להתעלם מסמלים שאינם ידועים כפונקציות.
אפשרות זו תיתן נתוני פרופיל מדויקים יותר במערכות שבהן היא נתמכת
(סולריס ו-HPUX למשל).

"-ק מ ל"
אל האני -k האפשרות מאפשרת לך למחוק מגרף השיחה כל קשת מסמלים תואמים
symspec החל מ- לאלו התואמים סימספקים ל.

"-ל"
"--קַו"
אל האני -l האפשרות מאפשרת פרופיל שורה אחר שורה, מה שגורם להיטות היסטוגרמה להיות
מחויב לשורות קוד מקור בודדות, במקום פונקציות. תכונה זו בלבד
עובד עם תוכניות שהורכבו על ידי גרסאות ישנות יותר של המהדר "gcc". גרסאות חדשות יותר
של "gcc" מיועדים לעבוד עם הכלי "gcov" במקום זאת.

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

"--inline-file-names"
אפשרות זו גורמת ל"gprof" להדפיס את קובץ המקור אחרי כל סמל בשני הדירה
פרופיל ותרשים השיחות. הנתיב המלא לקובץ מודפס אם נעשה בו שימוש עם -L
אוֹפְּצִיָה.

"-M מספר"
"--ספירה דקות=מספר"
אפשרות זו משפיעה על פלט ספירת הביצוע בלבד. סמלים שמבוצעים פחות מ
NUM הזמנים מדוכאים.

"-נסימספק"
"--זמן=סימספק"
אל האני -n אפשרות גורמת ל-"gprof", בניתוח גרף השיחות שלו, להפיץ רק זמנים עבור
סמלים תואמים symspec.

"-נסימספק"
"--אין-זמן=סימספק"
אל האני -n אפשרות גורמת ל"gprof", בניתוח גרף השיחות שלו, לא להפיץ זמנים עבור
סמלים תואמים symspec.

"-סשם קובץ"
"--external-symbol-table=שם קובץ"
אל האני -S option גורמת ל-"gprof" לקרוא קובץ טבלת סמלים חיצוני, כגון
/proc/kallsyms, במקום לקרוא את טבלת הסמלים מקובץ האובייקט הנתון (ה
ברירת המחדל היא "a.out"). זה שימושי ליצירת פרופילים של מודולי ליבה.

"-ז"
"--display-unused-functions"
אם אתה נותן את -z אפשרות, "gprof" יזכיר את כל הפונקציות בפרופיל השטוח,
אפילו אלה שמעולם לא נקראו, ושלא היה להם זמן בילה בהם. זה שימושי
בשיתוף עם -c אפשרות לגלות אילו שגרות מעולם לא נקראו.

שונות אפשרויות
"-ד[מספר]"
"--debug[=מספר]"
אל האני -d NUM option מציינת אפשרויות ניפוי באגים. אם NUM לא צוין, אפשר הכל
ניפוי באגים.

"-ח"
"--עֶזרָה"
אל האני -h אפשרות מדפיסה שימוש בשורת הפקודה.

"-אושֵׁם"
"--file-format=שֵׁם"
בוחר את הפורמט של קבצי נתוני הפרופיל. פורמטים מוכרים הם המכונית (
ברירת המחדל), bsd, 4.4bsd, קסם, ו פרופ ' (עדיין לא נתמך).

"-s"
"--סְכוּם"
אל האני -s אפשרות גורמת ל"gprof" לסכם את המידע בקבצי נתוני הפרופיל שלו
לקרוא ולכתוב קובץ נתוני פרופיל בשם gmon.sum, שמכיל את כל ה
מידע מקבצי נתוני הפרופיל ש"gprof" קראו. הקובץ gmon.sum אולי
להיות אחד מקבצי הקלט שצוינו; ההשפעה של זה היא מיזוג הנתונים ב-
קבצי קלט אחרים לתוך gmon.sum.

בסופו של דבר אתה יכול להפעיל "gprof" שוב בלי -s לנתח את הנתונים המצטברים ב-
פילה gmon.sum.

"-v"
"--גִרְסָה"
אל האני -v דגל גורם ל-"gprof" להדפיס את מספר הגרסה הנוכחית ולאחר מכן לצאת.

לא מומלץ לשימוש אפשרויות
אפשרויות אלה הוחלפו בגרסאות חדשות יותר המשתמשות ב-Symspecs.

"-ה שם_פונקציה"
אל האני -e פונקציה option אומר ל-gprof לא להדפיס מידע על הפונקציה
function_name (וילדיו...) בגרף השיחות. הפונקציה עדיין תהיה
רשום בתור צאצא של כל פונקציה שקוראת לזה, אבל מספר האינדקס שלו יוצג בתור
[לֹא מודפס]. יותר מאחד -e ניתן לתת אפשרות; רק אחד function_name יכול להיות
מצוין עם כל אחד -e אוֹפְּצִיָה.

"-ה שם_פונקציה"
ה-"-E פוּנקצִיָה" אפשרות פועלת כמו האפשרות "-e", אבל הזמן המושקע בפונקציה
(וילדים שלא התקשרו ממקום אחר), לא ישמשו לחישוב
אחוזי זמן עבור גרף השיחות. יותר מאחד -E ניתן לתת אפשרות; רק
אחד function_name ניתן לציין עם כל אחד -E אוֹפְּצִיָה.

"-ו שם_פונקציה"
אל האני -f פונקציה option גורמת ל-"gprof" להגביל את גרף השיחות לפונקציה
function_name וילדיה (וילדיהם...). יותר מאחד -f אפשרות עשויה
להינתן; רק אחד function_name ניתן לציין עם כל אחד -f אוֹפְּצִיָה.

"-פ שם_פונקציה"
אל האני -F פונקציה האופציה פועלת כמו האפשרות "-f", אבל רק הזמן המושקע בפונקציה
וילדיה (וילדיהם...) ישמשו לקביעת זמן כולל ו
אחוזי זמן עבור גרף השיחות. יותר מאחד -F ניתן לתת אפשרות; רק
אחד function_name ניתן לציין עם כל אחד -F אוֹפְּצִיָה. ה -F אפשרות עוקפת את
-E אוֹפְּצִיָה.

השתמש ב-arm-linux-androideabi-gprof באינטרנט באמצעות שירותי onworks.net