llvm-cov-3.8 - מקוון בענן

תָכְנִית:

שֵׁם

llvm-cov - פלט מידע כיסוי

תַקצִיר

llvm-cov הפקודה [ארגונים...]

תיאור

אל האני llvm-cov הכלי מציג מידע על כיסוי קוד עבור תוכניות שמיועדות לכך
לפלוט נתוני פרופיל. אפשר לעבוד איתו gcovכיסוי בסגנון או עם מקשקש's
פרופיל מבוסס מכשור.

אם התוכנית מופעלת עם שם בסיס של gcov, זה יתנהג כאילו ה llvm-cov gcov
הפקודה נקראו. אחרת, יש לספק פקודה.

פקודות

· gcov

· לְהַצִיג

· לדווח

GCOV פקודה

תַקצִיר
llvm-cov gcov [אפשרויות] קובץ מקור

תיאור
אל האני llvm-cov gcov הכלי קורא קובצי נתוני כיסוי קוד ומציג את הכיסוי
מידע עבור קובץ מקור שצוין. זה תואם את gcov כלי מהגרסה
4.2 של GCC ועשויים להיות גם תואמים לכמה גרסאות מאוחרות יותר של gcov.

להשתמש llvm-cov gcov, תחילה עליך לבנות גרסה מכוננת של היישום שלך
שאוסף נתוני כיסוי תוך כדי ריצה. הידור עם ה -fprofile-arcs ו
-הכיסוי הגבוה ביותר אפשרויות להוספת המכשור. (לחלופין, אתה יכול להשתמש ב-
-- כיסוי אופציה, הכוללת את שתי האפשרויות האחרות הללו.) עליך לבצע קומפילציה עם
מידע באגים (-g) וללא אופטימיזציה (-O0); אחרת, נתוני הכיסוי
לא ניתן למפות במדויק בחזרה לקוד המקור.

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

כברירת מחדל, .gcda קבצים נכתבים באותה ספרייה כמו קבצי האובייקט, אבל
אתה יכול לעקוף את זה על ידי הגדרת ה GCOV_PREFIX ו GCOV_PREFIX_STRIP סביבה
משתנים. ה GCOV_PREFIX_STRIP משתנה מציין מספר רכיבי ספרייה להיות
הוסר מתחילת הנתיב המוחלט לספריית קובץ האובייקט. לאחר הפשטה
המדריכים האלה, הקידומת מה- GCOV_PREFIX משתנה נוסף. הסביבה האלה
משתנים מאפשרים לך להפעיל את התוכנית המכשורת במכונה שבה האובייקט המקורי
ספריות הקבצים אינן נגישות, אך לאחר מכן תצטרך להעתיק את .gcda קבצים בחזרה
לספריות קבצי האובייקט שבו llvm-cov gcov מצפה למצוא אותם.

לאחר שיצרת את קבצי נתוני הכיסוי, הפעל llvm-cov gcov לכל מקור עיקרי
הקובץ שבו ברצונך לבחון את תוצאות הכיסוי. זה צריך להיות מופעל מאותו הדבר
ספרייה שבה הרצת בעבר את המהדר. התוצאות עבור קובץ המקור שצוין
נכתבים לקובץ בשם על ידי הוספת א .gcov סִיוֹמֶת. קובץ פלט נפרד הוא גם
נוצר עבור כל קובץ הכלול בקובץ המקור הראשי, גם עם א .gcov נוספה סיומת.

התוכן הבסיסי של א .gcov קובץ הפלט הוא עותק של קובץ המקור עם ביצוע
ספירה ומספר שורה לפני כל שורה. ספירת הביצוע מוצגת כ - אם קו
אינו מכיל קוד הפעלה כלשהו. אם שורה מכילה קוד אבל הקוד הזה מעולם לא היה
מבוצע, הספירה מוצגת כ #####.

אפשרויות
-א, -- כל הבלוקים
הצג את כל הבלוקים הבסיסיים. אם יש מספר בלוקים עבור שורה אחת של מקור
קוד, אפשרות זו גורמת ל-llvm-cov להציג את הספירה עבור כל בלוק במקום רק
ספירה אחת עבור כל השורה.

-ב, --סניף-הסתברויות
הצג הסתברויות ענפים מותנים וסיכום מידע ענף.

-ג, --סניפי-ספירות
הצג ספירות ענפים במקום הסתברויות (דורש -ב).

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

- עזרה הצג אפשרויות זמינות (--help-hidden למידע נוסף).

-ל, -- שמות קבצים ארוכים
עבור פלט כיסוי של קבצים הכלולים מקובץ המקור הראשי, הוסף את הקובץ הראשי
שם ואחריו ## בתור קידומת לשמות קבצי הפלט. ניתן לשלב זאת עם
האפשרות --preserve-paths להשתמש בנתיבים שלמים הן עבור הקובץ הראשי והן עבור
קובץ כלול.

-נ, --אין פלט
אל תוציא אף אחד .gcov קבצים. מידע סיכום עדיין מוצג.

-o= , --object-directory= , --object-file=
מצא אובייקטים ב-DIR או על סמך הנתיב של FILE. אם אתה מציין אובייקט מסוים
קובץ, קובצי נתוני הכיסוי צפויים להיות בעלי אותו שם בסיס .gcno
ו .gcda הרחבות. אם אתה מציין ספרייה, הקבצים צפויים בה
ספרייה עם שם בסיס זהה לקובץ המקור.

-פ, --שימור-נתיבים
שמור על רכיבי נתיב בעת מתן שם לקובצי הפלט של הכיסוי. בנוסף ל
שם קובץ המקור, כלול את הספריות מהנתיב לקובץ זה. ה
ספריות מופרדות על ידי # דמויות, עם . ספריות הוסרו ו ..
ספריות מוחלפות ב ^ דמויות. בשימוש עם האפשרות --long-file-names,
זה חל הן על שם הקובץ הראשי והן על שם הקובץ הכלול.

-את, --ענפים ללא תנאי
כלול ענפים ללא תנאי בפלט עבור אפשרות --branch-probabilities.

-הפך
הצג את הגרסה של llvm-cov.

יְצִיאָה סטָטוּס
llvm-cov gcov מחזיר 1 אם הוא לא יכול לקרוא קבצי קלט. אחרת, הוא יוצא עם אפס.

לְהַצִיג פקודה

תַקצִיר
llvm-cov לְהַצִיג [אפשרויות] -instr-profile פּרוֹפִיל BIN [מקורות]

תיאור
אל האני llvm-cov לְהַצִיג הפקודה מציגה שורה אחר שורה של כיסוי בינארי BIN באמצעות הפרופיל
נתונים פּרוֹפִיל. ניתן לסנן אותו באופן אופציונלי כדי להציג רק את הכיסוי עבור הקבצים הרשומים
in מקורות.

להשתמש llvm-cov לְהַצִיג, אתה צריך תוכנית שמורכבת עם מכשור כדי לפלוט
נתוני פרופיל וכיסוי. לבנות תוכנית כזו איתה מקשקש להשתמש
-fprofile-instr-generate ו -מיפוי כיסוי דגלים. אם מקשרים עם מקשקש נהג,
לעבור -fprofile-instr-generate לשלב הקישור כדי לוודא את זמן הריצה הדרוש
ספריות מקושרות.

מידע הכיסוי מאוחסן בקובץ ההפעלה הבנוי או בספרייה עצמה, וזהו
למה אתה צריך לעבור llvm-cov לְהַצִיג כמו BIN טַעֲנָה. נתוני הפרופיל נוצרים
על ידי הפעלת תוכנית מכשירים זו כרגיל. כשהתוכנית תצא היא תכתוב את א
קובץ פרופיל גולמי, הנקרא בדרך כלל default.profraw, שניתן להמיר לפורמט
שמתאים ל פּרוֹפִיל טיעון באמצעות ה llvm-profdata למזג כלי.

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

-הצג-הרחבות
הרחבת תכלילים, כגון פקודות מאקרו קדם-מעבד או הכללות טקסטואליות, מוטבעות ב-
הצגת קובץ המקור.

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

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

-show-line-counts-or-regions
הצג את ספירות הביצוע עבור כל שורה אם יש רק אזור אחד בקו,
אבל הצג את האזורים הבודדים אם יש מרובים על הקו.

-שימוש בצבע[=VALUE]
הפעל או השבת פלט צבע. כברירת מחדל זה מזוהה אוטומטית.

-arch=
אם הבינארי המכוסה הוא בינארי אוניברסלי, בחר את הארכיטקטורה שבה תשתמש. זה
שגיאה לציון ארכיטקטורה שאינה כלולה בבינארי האוניברסלי או
להשתמש בארכיטקטורה שאינה תואמת לבינארי לא אוניברסלי.

-שם=
הצג כיסוי קוד רק עבור פונקציות עם השם הנתון.

-name-regex=
הצג כיסוי קוד רק עבור פונקציות התואמות את הביטוי הרגולרי הנתון.

-line-coverage-gt=
הצג כיסוי קוד רק עבור פונקציות עם כיסוי קו גדול מהנתון
סף.

-line-coverage-lt=
הצג כיסוי קוד רק עבור פונקציות עם כיסוי קו נמוך מהנתון
סף.

-region-coverage-gt=
הצג כיסוי קוד רק עבור פונקציות עם כיסוי אזור גדול מהנתון
סף.

-region-coverage-lt=
הצג כיסוי קוד רק עבור פונקציות עם כיסוי אזור נמוך מהנתון
סף.

דווח פקודה

תַקצִיר
llvm-cov לדווח [אפשרויות] -instr-profile פּרוֹפִיל BIN [מקורות]

תיאור
אל האני llvm-cov לדווח הפקודה מציגה סיכום של הכיסוי של קובץ בינארי BIN באמצעות
נתוני פרופיל פּרוֹפִיל. ניתן לסנן אותו באופן אופציונלי כדי להציג רק את הכיסוי עבור
קבצים הרשומים ב מקורות.

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

למידע על הידור תוכניות לכיסוי ויצירת נתוני פרופיל, ראה לְהַצִיג
פקודה.

אפשרויות
-שימוש בצבע[=VALUE]
הפעל או השבת פלט צבע. כברירת מחדל זה מזוהה אוטומטית.

-arch=
אם הבינארי המכוסה הוא בינארי אוניברסלי, בחר את הארכיטקטורה שבה תשתמש. זה
שגיאה לציון ארכיטקטורה שאינה כלולה בבינארי האוניברסלי או
להשתמש בארכיטקטורה שאינה תואמת לבינארי לא אוניברסלי.

השתמש ב-llvm-cov-3.8 באינטרנט באמצעות שירותי onworks.net