نام (NAME)

llvm-locstats - محاسبه آمار مربوط به مکان اشکال‌زدایی DWARF

خلاصه دستور (SYNOPSIS)

llvm-locstats [گزینه‌ها] [نام‌فایل]

توضیحات (DESCRIPTION)

llvm-locstats مانند یک پوشش (wrapper) بر روی llvm-dwarfdump عمل می‌کند. این ابزار آمار llvm-dwarfdump مربوط به مکان اشکال‌زدایی را با چاپ آراسته (pretty printing) به شیوه‌ای خواناتر برای انسان تجزیه می‌کند.

خط 0% تعداد و درصد DIEهایی را نشان می‌دهد که فاقد اطلاعات مکانی هستند، اما خط 100% اطلاعات مربوط به DIEهایی را نمایش می‌دهد که در تمام بایت‌های بخش کد (جایی که متغیر یا پارامتر در حوزه/scope قرار دارد) دارای اطلاعات مکان هستند. خط [50%,60%) تعداد و درصد DIEهایی را نشان می‌دهد که اطلاعات مکان در آن‌ها بین ۵۰ تا ۶۰ درصد از حوزه آن متغیر را پوشش داده است.

گزینه‌ها (OPTIONS)

--only-variables: محاسبه آمار مکان تنها برای متغیرهای محلی

--only-formal-parameters: محاسبه آمار مکان تنها برای پارامترهای صوری

--ignore-debug-entry-values: نادیده گرفتن آمار مکان در مکان‌هایی که حاوی عملگر DWARF مقادیر مدخل اشکال‌زدایی (debug entry values) هستند

--draw-plot: ایجاد هیستوگرام از دسته‌های مکانی (location buckets) تولیدشده (نیازمند matplotlib)

--compare: مقایسه پوشش مکان اشکال‌زدایی در دو فایل ارائه‌شده و رسم نموداری برای نمایش تفاوت (نیازمند matplotlib)

وضعیت خروج (EXIT STATUS)

در صورت تجزیه موفقیت‌آمیز فایل ورودی، llvm-locstats مقدار 0 را برمی‌گرداند. در غیر این صورت، مقدار 1 را برمی‌گرداند.

مثال ۱ (EXAMPLE 1)

چاپ آراسته پوشش مکانی در خروجی استاندارد.

llvm-locstats a.out
  =================================================
            Debug Location Statistics
  =================================================
        cov%          samples       percentage(~)
  -------------------------------------------------
     0%                    1              16%
     (0%,10%)              0               0%
     [10%,20%)             0               0%
     [20%,30%)             0               0%
     [30%,40%)             0               0%
     [40%,50%)             0               0%
     [50%,60%)             1              16%
     [60%,70%)             0               0%
     [70%,80%)             0               0%
     [80%,90%)             1              16%
     [90%,100%)            0               0%
     100%                  3              50%
  =================================================
  -the number of debug variables processed: 6
  -PC ranges covered: 81%
  -------------------------------------------------
  -total availability: 83%
  =================================================

مثال ۲ (EXAMPLE 2)

تولید یک نمودار در قالب یک فایل تصویری.

llvm-locstats --draw-plot file1.out

[تصویر]

مثال ۳ (EXAMPLE 3)

تولید یک نمودار در قالب یک فایل تصویری که تفاوت در پوشش مکان اشکال‌زدایی را نشان می‌دهد.

llvm-locstats --compare file1.out file1.withentryvals.out

[تصویر]

همچنین ببینید (SEE ALSO)

llvm-dwarfdump(1) <llvm-dwarfdump.html>

نویسندگان (AUTHORS)

توسط تیم LLVM نگهداری می‌شود (https://llvm.org).

کپی‌رایت و تکثیر (COPYRIGHT)

2003-2026, LLVM Project