.\" 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-COV" "1" "2026-07-15" "22" "LLVM" .SH "نام (NAME)" llvm-cov \- انتشار اطلاعات پوشش کد .SH "خلاصه دستور (SYNOPSIS)" .sp \fBllvm\-cov\fP \fIcommand\fP [\fIargs...\fP] .SH "توضیحات (DESCRIPTION)" .sp ابزار \fBllvm\-cov\fP اطلاعات پوشش کد (coverage) را برای برنامه‌هایی که جهت ثبت داده‌های پروفایل تجهیز (instrument) شده‌اند نمایش می‌دهد. از این ابزار می‌توان برای کار با پوشش به سبک \fBgcov\fP یا با پروفایل‌سازی مبتنی بر تجهیز \fBclang\fP استفاده کرد. .sp اگر برنامه با نام پایهٔ \fBgcov\fP فراخوانی شود، به گونه‌ای رفتار می‌کند که گویی دستور \fBllvm\-cov gcov\fP فراخوانی شده است. در غیر این صورت، باید یک زیردستور مشخص شود. .SH "دستورها (COMMANDS)" .INDENT 0.0 .IP \(bu 2 gcov .IP \(bu 2 show .IP \(bu 2 report .IP \(bu 2 export .UNINDENT .SH "دستور GCOV (GCOV COMMAND)" .SS "خلاصه دستور (SYNOPSIS)" .sp \fBllvm\-cov gcov\fP [\fIoptions\fP] \fISOURCEFILE\fP .SS "توضیحات (DESCRIPTION)" .sp ابزار \fBllvm\-cov gcov\fP فایل‌های داده‌های پوشش کد را خوانده و اطلاعات پوشش را برای یک فایل منبع مشخص نمایش می‌دهد. این ابزار با ابزار \fBgcov\fP از نسخهٔ 4.2 کامپایلر \fBGCC\fP سازگار است و ممکن است با برخی از نسخه‌های جدیدتر \fBgcov\fP نیز سازگار باشد\&. .sp برای استفاده از \fBllvm\-cov gcov\fP، ابتدا باید یک نسخهٔ تجهیزشده از برنامهٔ خود بسازید که داده‌های پوشش کد را هنگام اجرا جمع‌آوری کند. برای افزودن این قابلیت، کد را با گزینه‌های \fB\-fprofile\-arcs\fP و \fB\-ftest\-coverage\fP کامپایل کنید. (همچنین می‌توانید از گزینهٔ \fB\-\-coverage\fP استفاده کنید که شامل هر دوی این گزینه‌ها می‌شود.) .sp هنگام کامپایل کردن کد تجهیزشده، برای هر فایل شیء (object file) یک فایل دادهٔ \fB\&.gcno\fP تولید خواهد شد. این فایل‌های \fB\&.gcno\fP حاوی نیمی از داده‌های پوشش هستند. نیمهٔ دیگر داده‌ها از فایل‌های \fB\&.gcda\fP به دست می‌آید که هنگام اجرای برنامهٔ تجهیزشده ایجاد می‌شوند؛ به طوری که برای هر فایل شیء، یک فایل \fB\&.gcda\fP جداگانه وجود دارد. با هر بار اجرای برنامه، تعداد دفعات اجرا به فایل‌های \fB\&.gcda\fP موجود اضافه می‌شود، بنابراین اگر نمی‌خواهید محتوای فایل‌های قبلی لحاظ شود، حتماً فایل‌های قدیمی را حذف کنید. .sp به‌طور پیش‌فرض، فایل‌های \fB\&.gcda\fP در همان دایرکتوری فایل‌های شیء نوشته می‌شوند، اما می‌توانید با تنظیم متغیرهای محیطی \fBGCOV_PREFIX\fP و \fBGCOV_PREFIX_STRIP\fP این رفتار را تغییر دهید. متغیر \fBGCOV_PREFIX_STRIP\fP تعداد بخش‌های دایرکتوری که باید از ابتدای مسیر مطلق دایرکتوری فایل شیء حذف شوند را مشخص می‌کند. پس از حذف آن دایرکتوری‌ها، پیشوند موجود در متغیر \fBGCOV_PREFIX\fP اضافه می‌شود. این متغیرهای محیطی به شما امکان می‌دهند برنامهٔ تجهیزشده را روی سیستمی اجرا کنید که دایرکتوری‌های اصلی فایل‌های شیء در آن در دسترس نیستند، اما پس از اجرا باید فایل‌های \fB\&.gcda\fP را به دایرکتوری‌های فایل‌های شیء، جایی که \fBllvm\-cov gcov\fP انتظار دارد، کپی کنید. .sp پس از تولید فایل‌های داده‌های پوشش، دستور \fBllvm\-cov gcov\fP را برای هر فایل منبع اصلی که می‌خواهید نتایج پوشش آن را بررسی کنید اجرا نمایید. این دستور باید از همان دایرکتوری اجرا شود که قبلاً کامپایلر را اجرا کرده‌اید. نتایج مربوط به فایل منبع مشخص‌شده در فایلی نوشته می‌شوند که نام آن با افزودن پسوند \fB\&.gcov\fP تشکیل می‌شود. همچنین برای هر فایلی که توسط فایل منبع اصلی ضمیمه (include) شده است نیز یک فایل خروجی جداگانه با پسوند \fB\&.gcov\fP ایجاد می‌شود. .sp محتوای اصلی یک فایل خروجی \fB\&.gcov\fP رونوشتی از فایل منبع است که تعداد دفعات اجرا و شمارهٔ خط به ابتدای هر خط آن اضافه شده است. اگر خطی حاوی هیچ کد قابل‌اجرایی نباشد، تعداد دفعات اجرا به‌صورت \fB\-\fP نمایش داده می‌شود. اگر خطی شامل کد باشد اما آن کد هرگز اجرا نشده باشد، شمارنده به‌صورت \fB#####\fP نمایش داده خواهد شد\&..SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-a, \-\-all\-blocks نمایش تمام بلوک‌های پایه (basic blocks). اگر برای یک خط از کد منبع چندین بلوک وجود داشته باشد، این گزینه باعث می‌شود llvm\-cov به جای فقط یک شمارش برای کل خط، شمارش مربوط به هر بلوک را نمایش دهد. .UNINDENT .INDENT 0.0 .TP .B \-b, \-\-branch\-probabilities نمایش احتمال انشعاب‌های شرطی و خلاصه‌ای از اطلاعات انشعاب‌ها. .UNINDENT .INDENT 0.0 .TP .B \-c, \-\-branch\-counts نمایش شمارش انشعاب‌ها به جای احتمالات (نیاز به \-b دارد). .UNINDENT .INDENT 0.0 .TP .B \-m, \-\-demangled\-names رمزگشایی نام توابع (demangle). .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-function\-summaries نمایش خلاصه‌ای از پوشش کد برای هر تابع به جای تنها یک خلاصه برای کل فایل منبع. .UNINDENT .INDENT 0.0 .TP .B \-\-help نمایش گزینه‌های موجود (\-\-help\-hidden برای موارد بیشتر). .UNINDENT .INDENT 0.0 .TP .B \-l, \-\-long\-file\-names برای خروجی پوشش فایل‌های گنجانده‌شده (included) از فایل منبع اصلی، نام فایل اصلی به همراه \fB##\fP به عنوان پیشوند به نام فایل‌های خروجی افزوده می‌شود. این گزینه می‌تواند با گزینه \-\-preserve\-paths ترکیب شود تا مسیرهای کامل هم برای فایل اصلی و هم برای فایل گنجانده‌شده استفاده شوند. .UNINDENT .INDENT 0.0 .TP .B \-n, \-\-no\-output هیچ فایل \fB\&.gcov\fP در خروجی تولید نشود. اطلاعات خلاصه همچنان نمایش داده می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-o , \-\-object\-directory=, \-\-object\-file= یافتن اشیاء در DIR یا بر اساس مسیر FILE. اگر فایل شیء خاصی را مشخص کنید، انتظار می‌رود فایل‌های داده پوشش با همان نام پایه و با پسوندهای \fB\&.gcno\fP و \fB\&.gcda\fP وجود داشته باشند. اگر یک دایرکتوری را مشخص کنید، انتظار می‌رود فایل‌ها در آن دایرکتوری با همان نام پایه فایل منبع قرار داشته باشند. .UNINDENT .INDENT 0.0 .TP .B \-p, \-\-preserve\-paths حفظ مؤلفه‌های مسیر هنگام نام‌گذاری فایل‌های خروجی پوشش. علاوه بر نام فایل منبع، دایرکتوری‌های مسیر منتهی به آن فایل نیز گنجانده می‌شوند. دایرکتوری‌ها با نویسه \fB#\fP از یکدیگر جدا می‌شوند، دایرکتوری‌های \fB\&.\fP حذف شده و دایرکتوری‌های \fB\&..\fP با نویسه \fB^\fP جایگزین می‌شوند. هنگامی که با گزینه \-\-long\-file\-names استفاده شود، این مورد برای هر دو نام فایل اصلی و فایل گنجانده‌شده اعمال می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-r تنها فایل‌هایی با مسیرهای نسبی، یا مسیرهای مطلقی که دارای پیشوند مشخص‌شده توسط \fB\-s\fP هستند، خارج (dump) شوند. .UNINDENT .INDENT 0.0 .TP .B \-s پیشوند منبع برای نادیده گرفتن و حذف شدن. .UNINDENT .INDENT 0.0 .TP .B \-t, \-\-stdout چاپ در stdout به جای ایجاد فایل‌های \fB\&.gcov\fP. .UNINDENT .INDENT 0.0 .TP .B \-u, \-\-unconditional\-branches گنجاندن انشعاب‌های بدون شرط در خروجی برای گزینه \-\-branch\-probabilities. .UNINDENT .INDENT 0.0 .TP .B \-version نمایش نسخه llvm\-cov. .UNINDENT .INDENT 0.0 .TP .B \-x, \-\-hash\-filenames استفاده از هش md5 نام فایل هنگام نام‌گذاری فایل‌های خروجی پوشش کد. نام فایل منبع به پسوند \fB##\fP و به دنبال آن هش MD5 محاسبه‌شده برای آن مجهز خواهد شد. .UNINDENT.SS "وضعیت خروج (EXIT STATUS)" .sp در صورتی که \fBllvm\-cov gcov\fP نتواند فایل‌های ورودی را بخواند، مقدار ۱ را برمی‌گرداند. در غیر این صورت، با صفر خارج می‌شود. .SH "دستور SHOW (SHOW COMMAND)" .SS "خلاصه دستور (SYNOPSIS)" .sp \fBllvm\-cov show\fP [\fIoptions\fP] \-instr\-profile \fIPROFILE\fP [\fIBIN\fP] [\fI\-object BIN\fP]... [\fI\-sources\fP] [\fISOURCE\fP]... .SS "توضیحات (DESCRIPTION)" .sp دستور \fBllvm\-cov show\fP پوشش خط‌به‌خط باینری‌های \fIBIN\fP\&... را با استفاده از داده‌های پروفایل \fIPROFILE\fP نشان می‌دهد. همچنین می‌تواند به صورت اختیاری فیلتر شود تا فقط پوشش فایل‌های فهرست‌شده در \fISOURCE\fP\&... را نمایش دهد. .sp \fIBIN\fP می‌تواند یک فایل اجرایی، فایل شیء (object file)، کتابخانهٔ پویا، یا یک بایگانی (thin یا معمولی) باشد. .sp برای استفاده از \fBllvm\-cov show\fP، به برنامه‌ای نیاز دارید که با کدهای سنجش (instrumentation) کامپایل شده باشد تا داده‌های پروفایل و پوشش را تولید کند. برای ساخت چنین برنامه‌ای با \fBclang\fP، از پرچم‌های \fB\-fprofile\-instr\-generate\fP و \fB\-fcoverage\-mapping\fP استفاده کنید. در صورت پیوند (linking) با درایور \fBclang\fP، گزینهٔ \fB\-fprofile\-instr\-generate\fP را به مرحلهٔ پیوند ارسال کنید تا مطمئن شوید کتابخانه‌های زمان اجرای ضروری پیوند خورده‌اند. .sp اطلاعات پوشش در خودِ فایل اجرایی ساخته‌شده یا کتابخانه ذخیره می‌شود، و این همان چیزی است که باید به عنوان آرگومان \fIBIN\fP به \fBllvm\-cov show\fP بدهید. داده‌های پروفایل با اجرای معمول این برنامهٔ سنجش‌شده (instrumented) تولید می‌شوند. هنگام خروج برنامه، یک فایل پروفایل خام، که معمولاً \fBdefault.profraw\fP نامیده می‌شود، نوشته خواهد شد که می‌توان آن را با ابزار \fBllvm\-profdata merge\fP به قالبی مناسب برای آرگومان \fIPROFILE\fP تبدیل کرد. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-show\-branches= نمایش پوشش برای شرایط انشعاب بر حسب تعداد یا درصد. نماهای پشتیبانی‌شده عبارتند از: \(dqcount\(dq، \(dqpercent\(dq. .UNINDENT .INDENT 0.0 .TP .B \-show\-mcdc نمایش پوشش شرایط/تصمیم اصلاح‌شده (MC/DC) برای هر عبارت بولی مربوطه. .UNINDENT .INDENT 0.0 .TP .B \-show\-line\-counts نمایش تعداد دفعات اجرای هر خط. مقدار پیش‌فرض true است، مگر اینکه از گزینهٔ دیگری از \fB\-show\fP استفاده شده باشد. .UNINDENT .INDENT 0.0 .TP .B \-show\-expansions بسط‌دادن موارد گنجانده‌شده، مانند ماکروهای پیش‌پردازنده یا درج‌های متنی، به‌صورت درون‌خطی در نمایش فایل منبع. مقدار پیش‌فرض false است. .UNINDENT .INDENT 0.0 .TP .B \-show\-instantiations برای نواحی منبعی که چندین بار نمونه‌سازی شده‌اند، مانند الگوها در \fBC++\fP، هر نمونه‌سازی را به‌طور جداگانه و همچنین خلاصهٔ ترکیبی نمایش می‌دهد. مقدار پیش‌فرض true است. .UNINDENT .INDENT 0.0 .TP .B \-show\-regions نمایش تعداد دفعات اجرای هر ناحیه با نشان دادن یک علامت هشتک (caret) که به نویسه‌ای که ناحیه از آنجا شروع می‌شود اشاره می‌کند. مقدار پیش‌فرض false است. .UNINDENT .INDENT 0.0 .TP .B \-show\-line\-counts\-or\-regions اگر تنها یک ناحیه در خط وجود داشته باشد، تعداد دفعات اجرای هر خط را نمایش می‌دهد، اما اگر چندین ناحیه در خط باشد، هر ناحیه را به‌صورت جداگانه نشان می‌دهد. مقدار پیش‌فرض false است. .UNINDENT .INDENT 0.0 .TP .B \-show\-directory\-coverage تولید یک فایل فهرست (نمایه) در هر دایرکتوری که حداقل شامل یک فایل منبع باشد، همراه با یک نمایهٔ سطح بالا که مقادیر تجمیعی را نشان می‌دهد. مقدار پیش‌فرض false است. .UNINDENT .INDENT 0.0 .TP .B \-use\-color فعال یا غیرفعال کردن خروجی رنگی. به‌طور پیش‌فرض به صورت خودکار شناسایی می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-arch=[*NAMES*] مشخص‌کردن فهرستی از معماری‌ها به طوری که N-اُمین ورودی در فهرست مربوط به N-اُمین باینری مشخص‌شده باشد. اگر شیء پوشش‌داده‌شده یک باینری چندمعماری (universal binary) باشد، این گزینه معماریِ مورد استفاده را تعیین می‌کند. مشخص‌کردن معماری‌ای که در باینری چندمعماری گنجانده نشده است، یا استفاده از معماری‌ای که با باینری غیرچندمعماری مطابقت ندارد، خطاست. .UNINDENT .INDENT 0.0 .TP .B \-name= نمایش پوشش کد فقط برای توابعی با نام مشخص‌شده. .UNINDENT .INDENT 0.0 .TP .B \-name\-allowlist= نمایش پوشش کد فقط برای توابع فهرست‌شده در فایل مشخص‌شده. هر خط در فایل باید با \fIallowlist_fun:\fP آغاز شود و بلافاصله نام تابعی که باید پذیرفته شود پس از آن بیاید. این نام می‌تواند یک عبارت با نویسه‌های عمومی (wildcard) باشد. .UNINDENT .INDENT 0.0 .TP .B \-name\-regex= نمایش پوشش کد فقط برای توابعی که با عبارت باقاعدهٔ (regular expression) داده‌شده مطابقت دارند. .UNINDENT .INDENT 0.0 .TP .B \-ignore\-filename\-regex= نادیده‌گرفتن فایل‌های کد منبع با مسیرهایی که با عبارت باقاعدهٔ داده‌شده مطابقت دارند. .UNINDENT .INDENT 0.0 .TP .B \-format= استفاده از قالب خروجی مشخص‌شده. قالب‌های پشتیبانی‌شده عبارتند از: \(dqtext\(dq، \(dqhtml\(dq. .UNINDENT .INDENT 0.0 .TP .B \-tab\-size= جایگزینی تب‌ها با فاصله هنگام آماده‌سازی گزارش‌ها. در حال حاضر، این گزینه فقط برای قالب html پشتیبانی می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-output\-dir=PATH مشخص‌کردن دایرکتوری برای نوشتن گزارش‌های پوشش در آن. اگر دایرکتوری وجود نداشته باشد، ایجاد می‌شود. هنگام استفاده در حالت نمای تابع (یعنی زمانی که از \-name یا \-name\-regex برای انتخاب توابع خاصی استفاده می‌شود)، گزارش در PATH/functions.EXTENSION نوشته می‌شود. هنگام استفاده در حالت نمای فایل، گزارشی برای هر فایل در PATH/REL_PATH_TO_FILE.EXTENSION نوشته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-Xdemangler=| مشخص‌کردن یک رمزگشای نام نمادها (symbol demangler). از این گزینه می‌توان برای خواناتر کردن گزارش‌ها برای انسان استفاده کرد. این گزینه را می‌توان چندین بار مشخص کرد تا آرگومان‌هایی به demangler ارسال شود (مثلاً \fI\-Xdemangler c++filt \-Xdemangler \-n\fP برای C++). انتظار می‌رود که demangler فهرستی از نمادها را که با خط جدید جدا شده‌اند از ورودی استاندارد (stdin) بخواند و فهرستی با همان طول را که با خط جدید جدا شده است در خروجی استاندارد (stdout) بنویسد. .UNINDENT .INDENT 0.0 .TP .B \-num\-threads=N, \-j=N استفاده از N رشته (thread) برای نوشتن گزارش‌های فایل (فقط زمانی کاربرد دارد که \-output\-dir مشخص شده باشد). زمانی که N=0 باشد، llvm\-cov تعداد مناسب رشته‌ها را به‌طور خودکار تشخیص می‌دهد. این مقدار پیش‌فرض است. .UNINDENT .INDENT 0.0 .TP .B \-compilation\-dir= دایرکتوری مورد استفاده به عنوان پایه برای مسیرهای نگاشت پوشش نسبی. فقط زمانی کاربرد دارد که باینری‌ها با یکی از گزینه‌های \fI\-fcoverage\-prefix\-map\fP، \fI\-fcoverage\-compilation\-dir\fP، یا \fI\-ffile\-compilation\-dir\fP کامپایل شده باشند. .UNINDENT .INDENT 0.0 .TP .B \-line\-coverage\-gt= نمایش پوشش کد فقط برای توابعی با پوشش خطی بیشتر از آستانهٔ مشخص‌شده. .UNINDENT .INDENT 0.0 .TP .B \-line\-coverage\-lt= نمایش پوشش کد فقط برای توابعی با پوشش خطی کمتر از آستانهٔ مشخص‌شده. .UNINDENT .INDENT 0.0 .TP .B \-region\-coverage\-gt= نمایش پوشش کد فقط برای توابعی با پوشش ناحیه‌ای بیشتر از آستانهٔ مشخص‌شده. .UNINDENT .INDENT 0.0 .TP .B \-region\-coverage\-lt= نمایش پوشش کد فقط برای توابعی با پوشش ناحیه‌ای کمتر از آستانهٔ مشخص‌شده. .UNINDENT .INDENT 0.0.TP .B \-path\-equivalence=, مسیرهای موجود در داده‌های پوشش را به مسیرهای محلی فایل منبع نگاشت می‌کند. این ویژگی به شما امکان می‌دهد داده‌های پوشش را روی یک ماشین تولید کنید و سپس از llvm\-cov روی ماشین دیگری که همان فایل‌ها را در مسیری متفاوت دارد استفاده نمایید. برای مشخص کردن نگاشت‌های مختلف، می‌توان چندین آرگومان \fI\-path\-equivalence\fP ارسال کرد. هر آرگومان از یک مسیر مبدأ \fI\fP و مسیر محلی متناظر با آن \fI\fP تشکیل می‌شود\&. نگاشت‌ها به همان ترتیبی که مشخص شده‌اند اعمال می‌شوند. اگر چندین نگاشت بر روی یک مسیر قابل اعمال باشند، نخستین نگاشت یافت‌شده اعمال خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-coverage\-watermark=, حد بالا و پایین (watermark) را برای پوشش در خروجی قالب html تنظیم می‌کند. این امکان را به شما می‌دهد تا حدود بالا و پایین پوشش را مطابق نیاز تعیین کنید: سبز در صورتی که پوشش >= high باشد، قرمز هنگامی که پوشش < low باشد، و در غیر این صورت زرد. هر دو مقدار high و low باید بین 0\-100 بوده و high > low باشد. .UNINDENT .INDENT 0.0 .TP .B \-debuginfod استفاده از debuginfod برای جستجوی نگاشت پوشش جهت شناسه‌های باینری (binary IDs) موجود در نمایه (profile) که در هیچ شیء مشخص‌شده‌ای در خط فرمان وجود ندارند. در صورتی که debuginfod درون برنامه کامپایل شده و از طریق متغیر محیطی DEBUGINFOD_URLS پیکربندی شده باشد، مقدار پیش‌فرض true است. .UNINDENT .INDENT 0.0 .TP .B \-debug\-file\-directory= دایرکتوری‌های محلی را برای جستجوی اشیاء متناظر با شناسه‌های باینری موجود در نمایه (مشابه debuginfod) فراهم می‌کند. مقدار پیش‌فرض، دایرکتوری‌های build ID سیستم است. .UNINDENT .INDENT 0.0 .TP .B \-check\-binary\-ids اگر فایل شیء برای یک شناسه باینری موجود در نمایه، چه در خط فرمان و چه از طریق جستجوی شناسه باینری یافت نشود، عملیات با خطا متوقف می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-empty\-profile نمایش پوشش خط مبنای (baseline) باینری‌ها با تمام شمارنده‌های اجرای صفر. با \-instr\-profile مانعة‌الجمع است. .UNINDENT .SH "دستور REPORT (REPORT COMMAND)" .SS "خلاصه دستور (SYNOPSIS)" .sp \fBllvm\-cov report\fP [\fIگزینه‌ها\fP] \-instr\-profile \fIPROFILE\fP [\fIBIN\fP] [\fI\-object BIN\fP]... [\fI\-sources\fP] [\fISOURCE\fP]... .SS "توضیحات (DESCRIPTION)" .sp دستور \fBllvm\-cov report\fP خلاصه‌ای از پوشش باینری‌های \fIBIN\fP\&... را با استفاده از داده‌های نمایه \fIPROFILE\fP\& نمایش می‌دهد. همچنین می‌توان آن را به صورت اختیاری فیلتر کرد تا تنها پوشش فایل‌های فهرست‌شده در \fISOURCE\fP\&... را نشان دهد. .sp \fIBIN\fP می‌تواند یک فایل اجرایی، فایل شیء (object file)، کتابخانه پویا، یا آرشیو (thin یا موارد دیگر) باشد. .sp اگر هیچ فایل منبعی مشخص نشود، یک سطر خلاصه برای هر فایل موجود در داده‌های پوشش چاپ می‌شود. در صورت ارائه هرگونه فایل، اگر گزینه \fB\-show\-functions\fP فعال باشد، خلاصه‌ها برای هر تابع موجود در فایل‌های فهرست‌شده نمایش داده می‌شوند. .sp برای کسب اطلاعات درباره کامپایل برنامه‌ها جهت سنجش پوشش و تولید داده‌های نمایه، بخش SHOW COMMAND را ببینید\&. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-use\-color[=VALUE] فعال یا غیرفعال کردن خروجی رنگی. این ویژگی به طور پیش‌فرض به صورت خودکار تشخیص داده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-arch= اگر باینری تحت پوشش یک باینری سراسری (universal binary) باشد، معماری مورد استفاده را انتخاب می‌کند. تعیین معماری‌ای که در باینری سراسری گنجانده نشده است، یا استفاده از معماری‌ای که با یک باینری غیرسراسری مطابقت ندارد، خطا محسوب می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-show\-region\-summary نمایش آمار برای همه ناحیه‌ها (regions). پیش‌فرض true است. .UNINDENT .INDENT 0.0 .TP .B \-show\-branch\-summary نمایش آمار برای تمام شرایط انشعاب (branch conditions). پیش‌فرض true است. .UNINDENT .INDENT 0.0 .TP .B \-show\-mcdc\-summary نمایش آمارهای MC/DC. پیش‌فرض false است. .UNINDENT .INDENT 0.0 .TP .B \-show\-functions نمایش خلاصه پوشش برای هر تابع. پیش‌فرض false است. .UNINDENT .INDENT 0.0 .TP .B \-show\-instantiation\-summary نمایش آمار برای تمام نمونه‌سازی‌های توابع (function instantiations). پیش‌فرض false است. .UNINDENT .INDENT 0.0 .TP .B \-ignore\-filename\-regex= صرف‌نظر کردن از فایل‌های کد منبع با مسیرهایی که با عبارت باقاعده (regular expression) داده‌شده مطابقت دارند. .UNINDENT .INDENT 0.0 .TP .B \-compilation\-dir= دایرکتوری مورد استفاده به عنوان پایه برای مسیرهای نسبی نگاشت پوشش. تنها زمانی کاربرد دارد که باینری‌ها با یکی از گزینه‌های \fI\-fcoverage\-prefix\-map\fP، \fI\-fcoverage\-compilation\-dir\fP، یا \fI\-ffile\-compilation\-dir\fP کامپایل شده باشند\&. .UNINDENT .INDENT 0.0 .TP .B \-debuginfod تلاش برای جستجوی نگاشت پوشش از اشیاء با استفاده از debuginfod. این کار به صورت پیش‌فرض برای شناسه‌های باینری موجود در نمایه که در خط فرمان ارائه نشده‌اند انجام می‌شود، به شرطی که debuginfod درون برنامه کامپایل شده و از طریق متغیر DEBUGINFOD_URLS پیکربندی شده باشد. .UNINDENT .INDENT 0.0 .TP .B \-debug\-file\-directory= یک دایرکتوری را برای جستجوی اشیاء متناظر با شناسه‌های باینری موجود در نمایه ارائه می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-check\-binary\-ids در صورتی که فایل شیء برای یک شناسه باینری موجود در نمایه، نه در خط فرمان و نه از طریق جستجوی شناسه باینری یافت نشود، عملیات با شکست مواجه می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-empty\-profile نمایش پوشش خط مبنای باینری‌ها با تمام شمارنده‌های اجرای صفر. با \-instr\-profile مانعة‌الجمع است. .UNINDENT.SH "دستور EXPORT (EXPORT COMMAND)" .SS "خلاصه دستور (SYNOPSIS)" .sp \fBllvm\-cov export\fP [\fIگزینه‌ها\fP] \-instr\-profile \fIPROFILE\fP [\fIBIN\fP] [\fI\-object BIN\fP]... [\fI\-sources\fP] [\fISOURCE\fP]... .SS "توضیحات (DESCRIPTION)" .sp دستور \fBllvm\-cov export\fP داده‌های پوشش باینری‌های \fIBIN\fP\&... را با استفاده از داده‌های نمایه \fIPROFILE\fP در قالب JSON یا پروندهٔ ردگیری lcov صادر می‌کند. .sp هنگام صدور به‌صورت JSON، ناحیه‌ها، توابع، شاخه‌ها، بسط‌ها و خلاصه‌های داده‌های پوشش صادر خواهند شد. هنگام صدور به‌صورت پروندهٔ ردگیری lcov، پوشش مبتنی بر خط، پوشش شاخه و خلاصه‌ها صادر خواهند شد. .sp داده‌های صادرشده را می‌توان به صورت اختیاری فیلتر کرد تا تنها پوشش فایل‌های فهرست‌شده در \fISOURCE\fP\&... صادر شود. .sp برای اطلاعات بیشتر دربارهٔ کامپایل کردن برنامه‌ها برای تحلیل پوشش و تولید داده‌های نمایه، «دستور SHOW (SHOW COMMAND)» را ببینید. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-arch= اگر باینری پوشش‌داده‌شده یک باینری یونیورسال (universal binary) باشد، معماری مورد استفاده را انتخاب می‌کند. مشخص کردن معماری‌ای که در باینری یونیورسال گنجانده نشده است، یا استفاده از معماری‌ای که با یک باینری غیر‌یونیورسال مطابقت ندارد، خطا محسوب می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-format= استفاده از قالب خروجی مشخص‌شده. قالب‌های پشتیبانی‌شده عبارتند از: \(dqtext\(dq (JSON) و \(dqlcov\(dq. .UNINDENT .INDENT 0.0 .TP .B \-summary\-only فقط اطلاعات خلاصه را برای هر فایل در داده‌های پوشش صادر می‌کند. این حالت اطلاعات پوشش را برای واحدهای کوچک‌تر مانند توابع یا ناحیه‌های منفرد صادر نمی‌کند. خروجی حاوی همان اطلاعات تولیدشده توسط دستور \fBllvm\-cov report\fP خواهد بود، اما به جای متن ساده در قالب JSON یا lcov ارائه می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-ignore\-filename\-regex= نادیده گرفتن فایل‌های کد منبعی که مسیر آن‌ها با عبارت باقاعدهٔ داده‌شده مطابقت دارد. .UNINDENT .INDENT 0.0 .TP .B \-skip\-expansions صرف‌نظر کردن از صدور داده‌های پوشش مربوط به بسط ماکروها. .UNINDENT .INDENT 0.0 .TP .B \-skip\-functions صرف‌نظر کردن از صدور داده‌های پوشش به تفکیک توابع. .UNINDENT .INDENT 0.0 .TP .B \-num\-threads=N, \-j=N استفاده از N ریسه (thread) برای صدور داده‌های پوشش. هنگامی که N=0 باشد، llvm\-cov تعداد مناسب ریسه‌ها را به طور خودکار شناسایی می‌کند. این مقدار پیش‌فرض است. .UNINDENT .INDENT 0.0 .TP .B \-compilation\-dir= دایرکتوری مبنا برای مسیرهای نگاشت نسبی پوشش. تنها زمانی کاربرد دارد که باینری‌ها با یکی از گزینه‌های \fI\-fcoverage\-prefix\-map\fP، \fI\-fcoverage\-compilation\-dir\fP یا \fI\-ffile\-compilation\-dir\fP کامپایل شده باشند. .UNINDENT .INDENT 0.0 .TP .B \-debuginfod تلاش برای جستجوی نگاشت پوشش از اشیاء با استفاده از debuginfod. این کار به طور پیش‌فرض برای شناسه‌های باینری (binary IDs) موجود در نمایه که در خط فرمان مشخص نشده‌اند انجام می‌شود، به شرطی که debuginfod درون برنامه کامپایل شده و از طریق DEBUGINFOD_URLS پیکربندی شده باشد. .UNINDENT .INDENT 0.0 .TP .B \-debug\-file\-directory= مشخص کردن دایرکتوری برای جستجوی اشیاء منطبق با شناسه‌های باینری موجود در نمایه. .UNINDENT .INDENT 0.0 .TP .B \-check\-binary\-ids اگر فایل شیء برای یک شناسهٔ باینری موجود در نمایه پیدا نشود (چه از طریق خط فرمان و چه از طریق جستجوی شناسهٔ باینری)، با خطا متوقف می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-empty\-profile صدور پوشش مبنای باینری‌ها با مقادیر شمارش اجرای کاملاً صفر. با گزینهٔ \-instr\-profile مانعة‌الجمع است. .UNINDENT.SH "دستور CONVERT\-FOR\-TESTING (CONVERT\-FOR\-TESTING COMMAND)" .sp \fBهشدار:\fP .INDENT 0.0 .INDENT 3.5 این دستور صرفاً برای توسعه‌دهندگان LLVM است که روی \fBllvm\-cov\fP کار می‌کنند. .UNINDENT .UNINDENT .SS "خلاصه دستور (SYNOPSIS)" .sp \fBllvm\-cov convert\-for\-testing\fP \fIBIN\fP \-o \fIOUT\fP .SS "توضیحات (DESCRIPTION)" .sp دستور \fBllvm\-cov convert\-for\-testing\fP با هدف آزمایش خودِ \fIllvm\-cov\fP به کار می‌رود. این دستور می‌تواند تمام داده‌های پوشش کد را از فایل باینری \fIBIN\fP استخراج کرده و در فایل \fIOUT\fP قرار دهد و از این طریق اندازهٔ فایل‌های آزمایشی را کاهش دهد. فایل خروجی معمولاً دارای پسوند \fB\&.covmapping\fP است. .sp فایل‌های \fB\&.covmapping\fP می‌توانند دقیقاً مانند فایل‌های باینری معمولی مجدداً توسط \fBllvm\-cov\fP خوانده شوند. .SH "نویسندگان (AUTHORS)" توسط تیم LLVM نگهداری می‌شود (https://llvm.org). .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2003-2026, LLVM Project .\" End of generated man page.