.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "LLVM-LOCSTATS" "1" "2026-07-15" "22" "LLVM"
.SH "نام (NAME)"
llvm-locstats \- محاسبه آمار مربوط به مکان اشکال‌زدایی DWARF
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBllvm\-locstats\fP [\fIگزینه‌ها\fP] [\fIنام‌فایل\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
\fBllvm\-locstats\fP مانند یک پوشش (wrapper) بر روی \fBllvm\-dwarfdump\fP عمل می‌کند\&.
این ابزار آمار \fBllvm\-dwarfdump\fP مربوط به مکان اشکال‌زدایی را با چاپ آراسته (pretty printing) به شیوه‌ای خواناتر برای انسان تجزیه می‌کند.
.sp
خط 0% تعداد و درصد DIEهایی را نشان می‌دهد که فاقد اطلاعات مکانی هستند، اما خط 100% اطلاعات مربوط به DIEهایی را نمایش می‌دهد که در تمام بایت‌های بخش کد (جایی که متغیر یا پارامتر در حوزه/scope قرار دارد) دارای اطلاعات مکان هستند. خط [50%,60%) تعداد و درصد DIEهایی را نشان می‌دهد که اطلاعات مکان در آن‌ها بین ۵۰ تا ۶۰ درصد از حوزه آن متغیر را پوشش داده است.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-\-only\-variables
محاسبه آمار مکان تنها برای متغیرهای محلی
.UNINDENT
.INDENT 0.0
.TP
.B \-\-only\-formal\-parameters
محاسبه آمار مکان تنها برای پارامترهای صوری
.UNINDENT
.INDENT 0.0
.TP
.B \-\-ignore\-debug\-entry\-values
نادیده گرفتن آمار مکان در مکان‌هایی که حاوی عملگر DWARF مقادیر مدخل اشکال‌زدایی (debug entry values) هستند
.UNINDENT
.INDENT 0.0
.TP
.B \-\-draw\-plot
ایجاد هیستوگرام از دسته‌های مکانی (location buckets) تولیدشده (نیازمند matplotlib)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-compare
مقایسه پوشش مکان اشکال‌زدایی در دو فایل ارائه‌شده و رسم نموداری برای نمایش تفاوت (نیازمند matplotlib)
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
در صورت تجزیه موفقیت‌آمیز فایل ورودی، \fBllvm\-locstats\fP مقدار 0 را برمی‌گرداند. در غیر این صورت، مقدار 1 را برمی‌گرداند.
.SH "مثال ۱ (EXAMPLE 1)"
.sp
چاپ آراسته پوشش مکانی در خروجی استاندارد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
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%
  =================================================
.EE
.UNINDENT
.UNINDENT
.SH "مثال ۲ (EXAMPLE 2)"
.sp
تولید یک نمودار در قالب یک فایل تصویری.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
llvm\-locstats \-\-draw\-plot file1.out
.EE
.UNINDENT
.UNINDENT
[تصویر]
.SH "مثال ۳ (EXAMPLE 3)"
.sp
تولید یک نمودار در قالب یک فایل تصویری که تفاوت در پوشش مکان اشکال‌زدایی را نشان می‌دهد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
llvm\-locstats \-\-compare file1.out file1.withentryvals.out
.EE
.UNINDENT
.UNINDENT
[تصویر]
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBllvm\-dwarfdump(1) \%<llvm-dwarfdump\:.html>\fP
.SH "نویسندگان (AUTHORS)"
توسط تیم LLVM نگهداری می‌شود (https://llvm.org).
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2003-2026, LLVM Project
.\" End of generated man page.