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

תָכְנִית:

שֵׁם

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

תַקצִיר

llvm-cov [אפשרויות] SOURCEFILE

תיאור

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

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

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

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

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

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

אפשרויות

-א, -- כל הבלוקים
הצג את כל הבלוקים הבסיסיים. אם יש מספר בלוקים עבור שורה אחת של מקור
קוד, אפשרות זו גורמת ל-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 מחזיר 1 אם הוא לא יכול לקרוא קבצי קלט. אחרת, הוא יוצא עם אפס.

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