.\" 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-PROFDATA" "1" "2026-07-15" "22" "LLVM" .SH "نام (NAME)" llvm-profdata \- ابزار داده‌های پروفایل .SH "خلاصه دستور (SYNOPSIS)" .sp \fBllvm\-profdata\fP \fIcommand\fP [\fIargs...\fP] .SH "توضیحات (DESCRIPTION)" .sp ابزار \fBllvm\-profdata\fP یک ابزار کمکی کوچک برای کار با فایل‌های داده‌های پروفایل (profile data) است. .SH "دستورها (COMMANDS)" .INDENT 0.0 .IP \(bu 2 merge .IP \(bu 2 show .IP \(bu 2 overlap .IP \(bu 2 order .UNINDENT .SH "ادغام (MERGE)" .SS "خلاصه دستور (SYNOPSIS)" .sp \fBllvm\-profdata merge\fP [\fIoptions\fP] [\fIfilename...\fP] .SS "توضیحات (DESCRIPTION)" .sp دستور \fBllvm\-profdata merge\fP چندین فایل داده‌های پروفایل تولیدشده توسط ابزار دقیق PGO را دریافت کرده و آن‌ها را در یک فایل داده‌های پروفایل نمایه‌سازی‌شده (indexed) ادغام می‌کند. .sp به‌طور پیش‌فرض، داده‌های پروفایل بدون تغییر ادغام می‌شوند. این بدان معناست که اهمیت نسبی هر فایل ورودی متناسب با تعداد نمونه‌ها یا شمارش‌های موجود در آن است. به‌طور کلی، ورودی حاصل از یک اجرای آموزشی طولانی‌تر، نسبت به یک اجرای کوتاه‌تر با اهمیت بیشتری تفسیر خواهد شد. بسته به ماهیت اجراهای آموزشی، ممکن است تنظیم وزن اختصاص‌یافته به هر فایل ورودی با استفاده از گزینه \fB\-weighted\-input\fP مفید باشد. .sp پروفایل‌هایی که از طریق \fB\-weighted\-input\fP، \fB\-input\-files\fP یا از طریق آرگومان‌های مکانی ارسال می‌شوند، به ازای هر بار مشاهده شدن، پردازش می‌گردند. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-help چاپ خلاصه‌ای از گزینه‌های خط فرمان. .UNINDENT .INDENT 0.0 .TP .B \-\-output=, \-o مشخص کردن نام فایل خروجی. مقدار \fIOutput\fP نمی‌تواند \fB\-\fP باشد زیرا داده‌های پروفایل نمایه‌سازی‌شده حاصل نمی‌توانند در خروجی استاندارد نوشته شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-weighted\-input= مشخص کردن نام فایل ورودی به همراه یک وزن. شمارش‌های پروفایل مربوط به \fBfilename\fP ارائه‌شده در \fBweight\fP ضرب (مقیاس‌بندی) خواهد شد، که در آن \fBweight\fP یک عدد صحیح ده‌دهی بزرگ‌تر یا مساوی ۱ (>= 1) است. به فایل‌های ورودی که بدون استفاده از این گزینه مشخص شوند، وزن پیش‌فرض ۱ اختصاص داده می‌شود. مثال‌ها در ادامه آورده شده‌اند. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-files=, \-f مشخص کردن فایلی که حاوی فهرستی از فایل‌ها برای ادغام است. ورودی‌های این فایل با خط جدید از هم جدا می‌شوند. خطوطی که با \(aq#\(aq شروع می‌شوند نادیده گرفته می‌شوند. ورودی‌ها می‌توانند به قالب یا , باشند. .UNINDENT .INDENT 0.0 .TP .B \-\-remapping\-file=, \-r مشخص کردن فایلی که شامل نگاشت مجدد از نام‌های نماد در پروفایل ورودی به نام‌های نمادی است که باید در پروفایل خروجی استفاده شوند. این فایل باید شامل خطوطی با قالب \fB \fP باشد. خطوط خالی و خطوطی که با \fB#\fP شروع می‌شوند نادیده گرفته می‌شوند. .sp از ابزار llvm\-cxxmap \%<> می‌توان برای تولید فایل نگاشت مجدد نماد استفاده کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-instr (default) مشخص می‌کند که پروفایل ورودی، یک پروفایل مبتنی بر ابزار دقیق (instrumentation\-based) است. .UNINDENT .INDENT 0.0 .TP .B \-\-sample مشخص می‌کند که پروفایل ورودی، یک پروفایل مبتنی بر نمونه‌برداری (sample\-based) است. .sp قالب فایل تولیدشده را می‌توان به یکی از روش‌های زیر تعیین کرد: .INDENT 7.0 .TP .B \-\-binary (default) .UNINDENT .sp انتشار پروفایل با استفاده از کدگذاری دودویی (binary). برای پروفایل‌های مبتنی بر ابزار دقیق، قالب خروجی همان قالب دودویی نمایه‌سازی‌شده است. .INDENT 7.0 .TP .B \-\-extbinary .UNINDENT .sp انتشار پروفایل با استفاده از کدگذاری دودویی گسترش‌پذیر (extensible binary). این گزینه تنها با پروفایل‌های مبتنی بر نمونه‌برداری قابل استفاده است. کدگذاری دودویی گسترش‌پذیر در صورت فعال بودن فشرده‌سازی می‌تواند کم‌حجم‌تر باشد و سریع‌تر از کدگذاری دودویی پیش‌فرض بارگذاری شود. .INDENT 7.0 .TP .B \-\-text .UNINDENT .sp انتشار پروفایل در حالت متنی. این گزینه نیز می‌تواند هم با پروفایل‌های مبتنی بر نمونه‌برداری و هم با پروفایل‌های مبتنی بر ابزار دقیق استفاده شود. در صورت استفاده از این گزینه، پروفایل در قالبی متنی تخلیه می‌شود که توسط خواننده پروفایل قابل تجزیه است. .INDENT 7.0 .TP .B \-\-gcc .UNINDENT .sp انتشار پروفایل با استفاده از قالب gcov مربوط به GCC (هنوز پشتیبانی نمی‌شود). .UNINDENT .INDENT 0.0 .TP .B \-\-sparse[=true|false] رکوردهای توابع با تعداد دفعات اجرای ۰ منتشر نشوند. تنها در ترکیب با \-instr قابل استفاده است. مقدار پیش‌فرض آن false است، زیرا می‌تواند از بهینه‌سازی کامپایلر در حین PGO جلوگیری کند. .UNINDENT .INDENT 0.0 .TP .B \-\-num\-threads=, \-j استفاده از N رشته (thread) برای انجام ادغام پروفایل. هنگامی که N=0 باشد، llvm\-profdata تعداد مناسبی از رشته‌ها را برای استفاده به‌طور خودکار تشخیص می‌دهد. این حالت پیش‌فرض است. .UNINDENT .INDENT 0.0 .TP .B \-\-failure\-mode=[any|all] تنظیم حالت شکست. دو گزینه وجود دارد: مقدار \(aqany\(aq باعث می‌شود که در صورت نامعتبر بودن هر یک از پروفایل‌ها، دستور merge با شکست مواجه شود؛ و مقدار \(aqall\(aq تنها در صورتی باعث شکست دستور merge می‌شود که تمام پروفایل‌ها نامعتبر باشند. اگر روی \(aqall\(aq تنظیم شود، اطلاعات مربوط به پروفایل‌های نامعتبر از خروجی نهایی ادغام‌شده حذف می‌گردد. حالت شکست پیش‌فرض \(aqany\(aq است. .UNINDENT .INDENT 0.0 .TP .B \-\-prof\-sym\-list= مشخص کردن فایلی که حاوی فهرستی از نمادها برای تولید فهرست نمادهای پروفایل در پروفایل خروجی است. این گزینه فقط با پروفایل مبتنی بر نمونه‌برداری در قالب extbinary قابل استفاده است. ورودی‌های این فایل با خط جدید از یکدیگر جدا می‌شوند. .UNINDENT .INDENT 0.0.TP .B \-\-compress\-all\-sections=[true|false] فشرده‌سازی تمام بخش‌ها هنگام نوشتن نمایه. این گزینه فقط با نمایه مبتنی بر نمونه‌برداری (sample\-based) در قالب extbinary قابل استفاده است. .UNINDENT .INDENT 0.0 .TP .B \-\-use\-md5=[true|false] استفاده از MD5 برای نمایش رشته‌ها در جدول نام‌ها هنگام نوشتن نمایه. این گزینه فقط با نمایه مبتنی بر نمونه‌برداری در قالب extbinary قابل استفاده است. .UNINDENT .INDENT 0.0 .TP .B \-\-gen\-partial\-profile=[true|false] علامت‌گذاری نمایه به‌عنوان یک نمایه جزئی که تنها پوشش نمایه‌ایِ جزئی را برای هدف بهینه‌سازی‌شده فراهم می‌کند. این گزینه فقط با نمایه مبتنی بر نمونه‌برداری در قالب extbinary قابل استفاده است. .UNINDENT .INDENT 0.0 .TP .B \-\-split\-layout=[true|false] تقسیم بخش داده‌های نمایه به دو بخش؛ به‌طوری که یکی شامل نمایه‌های نمونه‌برداری با توابع درون‌خطی‌شده (inlined) باشد و دیگری نباشد. این گزینه فقط با نمایه مبتنی بر نمونه‌برداری در قالب extbinary قابل استفاده است. .UNINDENT .INDENT 0.0 .TP .B \-\-convert\-sample\-profile\-layout=[nest|flat] تبدیل نمایه ادغام‌شده به نمایه‌ای با ساختار جدید. ساختارهای پشتیبانی‌شده عبارتند از \fBnest\fP (نمایه تو‌در‌تو؛ ورودی باید یک نمایه مسطح CS باشد) و \fBflat\fP (نمایه‌ای که توابع درون‌خطی تو‌در‌توی آن مسطح شده‌اند). .UNINDENT .INDENT 0.0 .TP .B \-\-supplement\-instr\-with\-sample= تکمیل یک نمایه ابزاردقیق‌سازی (instrumentation profile) با نمایه نمونه‌برداری. نمایه نمونه‌برداری ورودیِ این پرچم است. خروجی در قالب ابزاردقیق‌سازی خواهد بود (تنها با \-instr کار می‌کند). .UNINDENT .INDENT 0.0 .TP .B \-\-zero\-counter\-threshold= برای تابعی که در نمایه instr سرد (cold) اما در نمایه نمونه‌برداری داغ (hot) است، اگر نسبت تعداد شمارنده‌های صفر تقسیم بر تعداد کل شمارنده‌ها از آستانه بیشتر باشد، نمایه آن تابع برای کارایی مضر تلقی شده و حذف خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-instr\-prof\-cold\-threshold= آستانه سرد مشخص‌شده توسط کاربر برای نمایه instr که بر آستانه سردِ به‌دست‌آمده از خلاصه نمایه اولویت خواهد داشت. .UNINDENT .INDENT 0.0 .TP .B \-\-suppl\-min\-size\-threshold= اگر اندازه یک تابع کوچک‌تر از این آستانه باشد، فرض می‌شود که می‌تواند توسط درون‌خط‌ساز اولیه PGO درون‌خطی شود و بر اساس نمایه نمونه‌برداری تنظیم نخواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-debug\-info= مشخص کردن فایل اجرایی یا \fB\&.dSYM\fP حاوی اطلاعات اشکال‌زدایی برای نمایه خام. هنگامی که از \fB\-\-debug\-info\-correlate\fP یا \fB\-\-profile\-correlate=debug\-info\fP برای ابزاردقیق‌سازی استفاده شده باشد، از این گزینه برای همبسته‌سازی نمایه خام استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-binary\-file= مشخص کردن فایل اجرایی شامل بخش‌های داده و نام نمایه برای نمایه خام. هنگامی که از \fB\-profile\-correlate=binary\fP برای ابزاردقیق‌سازی استفاده شده باشد، از این گزینه برای همبسته‌سازی نمایه خام استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-debuginfod استفاده از debuginfod برای یافتن فایل‌های اجرایی مرتبط که شامل بخش‌های داده و نام برای نمایه‌های خام هستند تا آن‌ها را همبسته کند. هنگامی که از \-profile\-correlate=binary برای ابزاردقیق‌سازی استفاده شده باشد، این گزینه می‌تواند برای همبسته‌سازی استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-debug\-file\-directory= استفاده از پوشه‌های محلی ارائه‌شده برای جستجوی فایل‌های اجرایی شامل بخش‌های داده و نام برای نمایه‌های خام به‌منظور همبسته‌سازی آن‌ها. هنگامی که از \-profile\-correlate=binary برای ابزاردقیق‌سازی استفاده شده باشد، این گزینه می‌تواند برای همبسته‌سازی استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-correlate= مشخص کردن نوع همبستگی (debug_info یا binary) برای استفاده هنگامی که گزینه \-debuginfod یا \-debug\-file\-directory= ارائه شده باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-temporal\-profile\-trace\-reservoir\-size حداکثر تعداد ردهای نمایه زمانی (temporal profile traces) جهت ذخیره در نمایه خروجی. اگر ردهای بیشتری اضافه شوند، از نمونه‌برداری مخزنی برای انتخاب ردهایی که باید نگه‌داری شوند استفاده خواهد شد. توجه داشته باشید که تغییر این مقدار میان فراخوانی‌های مختلف ادغام بر روی یک نمایه نمایه‌گذاری‌شده یکسان، می‌تواند منجر به سوگیری نمونه‌برداری شود. مقدار پیش‌فرض 100 است. .UNINDENT .INDENT 0.0 .TP .B \-\-temporal\-profile\-max\-trace\-length حداکثر تعداد توابع در یک رد نمایه زمانی منفرد. ردهای طولانی‌تر بریده (truncated) خواهند شد. مقدار پیش‌فرض 1000 است. .UNINDENT .INDENT 0.0 .TP .B \-\-function= تنها توابعی که با عبارت باقاعده (regex) مطابقت دارند در خروجی نگه داشته می‌شوند؛ بقیه توابع از نمایه حذف خواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-function= حذف توابعی که با عبارت باقاعده مطابقت دارند از نمایه. اگر هر دو گزینه \-\-function و \-\-no\-function مشخص شده باشند و تابعی با هر دو مطابقت داشته باشد، حذف خواهد شد. .UNINDENT.SS "مثال‌ها (EXAMPLES)" .SS کاربرد پایه .sp ادغام سه پروفایل: .INDENT 0.0 .INDENT 3.5 .sp .EX llvm\-profdata merge foo.profdata bar.profdata baz.profdata \-output merged.profdata .EE .UNINDENT .UNINDENT .SS ورودی وزن‌دار .sp فایل ورودی \fBfoo.profdata\fP اهمیت ویژه‌ای دارد، شمارنده‌های آن را در ۱۰ ضرب کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX llvm\-profdata merge \-\-weighted\-input=10,foo.profdata bar.profdata baz.profdata \-\-output merged.profdata .EE .UNINDENT .UNINDENT .sp دقیقاً معادل فراخوانی قبلی (فرم صریح؛ مناسب برای فراخوانی به‌صورت خودکار و برنامه‌نویسی‌شده): .INDENT 0.0 .INDENT 3.5 .sp .EX llvm\-profdata merge \-\-weighted\-input=10,foo.profdata \-\-weighted\-input=1,bar.profdata \-\-weighted\-input=1,baz.profdata \-\-output merged.profdata .EE .UNINDENT .UNINDENT .SH SHOW .SS "خلاصه دستور (SYNOPSIS)" .sp \fBllvm\-profdata show\fP [\fIoptions\fP] [\fIfilename\fP] .SS "توضیحات (DESCRIPTION)" .sp دستور \fBllvm\-profdata show\fP یک فایل داده‌های پروفایل را دریافت کرده و اطلاعات مربوط به شمارنده‌های پروفایل را برای این فایل و هر یک از توابع مشخص‌شده نمایش می‌دهد. .sp اگر \fIfilename\fP حذف شود یا \fB\-\fP باشد، آن‌گاه \fBllvm\-profdata show\fP ورودی خود را از ورودی استاندارد می‌خواند. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-all\-functions چاپ جزئیات برای تمام توابع. .UNINDENT .INDENT 0.0 .TP .B \-\-binary\-ids چاپ شناسه‌های باینری (binary ids) تعبیه‌شده در پروفایل. .UNINDENT .INDENT 0.0 .TP .B \-\-counts چاپ مقادیر شمارنده برای توابع نمایش‌داده‌شده. .UNINDENT .INDENT 0.0 .TP .B \-\-show\-format= تولید خروجی در قالب انتخاب‌شده، در صورتی که توسط نوع پروفایل ارائه‌شده پشتیبانی شود. .UNINDENT .INDENT 0.0 .TP .B \-\-function= چاپ جزئیات یک تابع در صورتی که نام تابع شامل رشته‌ی داده‌شده باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-help چاپ خلاصه‌ای از گزینه‌های خط فرمان. .UNINDENT .INDENT 0.0 .TP .B \-\-output=, \-o مشخص کردن نام فایل خروجی. اگر \fIoutput\fP برابر با \fB\-\fP باشد یا مشخص نشود، خروجی به خروجی استاندارد فرستاده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-instr (default) مشخص می‌کند که پروفایل ورودی مبتنی بر ابزارگذاری (instrumentation\-based) است. .UNINDENT .INDENT 0.0 .TP .B \-\-text به ابزار استخراج پروفایل دستور می‌دهد تا مقادیر شمارنده‌ها را در قالب متنیِ نمایش داده‌های پروفایل مبتنی بر instrumentation نمایش دهد. به‌طور پیش‌فرض، اطلاعات پروفایل در قالبی خواناتر برای انسان (نیز متنی) همراه با حاشیه‌نویسی‌ها استخراج می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-topn= به ابزار استخراج پروفایل دستور می‌دهد تا \fBn\fP تابع برتر با داغ‌ترین بلوک‌های پایه (basic blocks) را در بخش خلاصه نمایش دهد. به‌طور پیش‌فرض، توابع topn استخراج نمی‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-sample مشخص می‌کند که پروفایل ورودی مبتنی بر نمونه‌برداری (sample\-based) است. .UNINDENT .INDENT 0.0 .TP .B \-\-memop\-sizes نمایش اندازه‌های پروفایل‌شده برای فراخوانی‌های ذاتی حافظه (memory intrinsic calls) برای توابع نمایش‌داده‌شده. .UNINDENT .INDENT 0.0 .TP .B \-\-value\-cutoff= تنها توابعی را نشان می‌دهد که حداکثر مقادیر شمارش آن‌ها بزرگ‌تر یا مساوی \fBn\fP باشد\&. به‌طور پیش‌فرض، value\-cutoff بر روی ۰ تنظیم شده است. .UNINDENT .INDENT 0.0 .TP .B \-\-list\-below\-cutoff تنها نام توابعی را در خروجی می‌آورد که حداکثر مقدار شمارش آن‌ها زیر مقدار آستانه (cutoff) باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-profile\-version چاپ نسخه پروفایل. .UNINDENT .INDENT 0.0 .TP .B \-\-showcs تنها شمارش‌های پروفایل حساس به زمینه (context sensitive) را نمایش می‌دهد. حالت پیش‌فرض فیلتر کردن تمامی شمارش‌های پروفایل حساس به زمینه است. .UNINDENT .INDENT 0.0 .TP .B \-\-show\-prof\-sym\-list=[true|false] نمایش فهرست نمادهای پروفایل در صورت وجود در پروفایل. این گزینه تنها برای پروفایل مبتنی بر نمونه‌برداری در قالب extbinary معنادار است. .UNINDENT .INDENT 0.0 .TP .B \-\-show\-sec\-info\-only=[true|false] نمایش اطلاعات پایه‌ای درباره هر بخش (section) در پروفایل. این گزینه تنها برای پروفایل مبتنی بر نمونه‌برداری در قالب extbinary معنادار است. .UNINDENT .INDENT 0.0 .TP .B \-\-debug\-info= مشخص کردن فایل اجرایی یا \fB\&.dSYM\fP که حاوی اطلاعات اشکال‌زدایی برای پروفایل خام (raw profile) است. هنگامی که از \fB\-\-debug\-info\-correlate\fP یا \fB\-\-profile\-correlate=debug\-info\fP برای ابزارگذاری استفاده شده باشد، از این گزینه برای نمایش توابع همبسته‌شده از پروفایل خام استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-covered تنها توابعی را نشان می‌دهد که اجرا شده‌اند؛ یعنی توابعی با مقادیر شمارش غیرصفر. .UNINDENT.SH OVERLAP .SS "خلاصه دستور (SYNOPSIS)" .sp \fBllvm\-profdata overlap\fP [\fIگزینه‌ها\fP] [\fIbase profile file\fP] [\fItest profile file\fP] .SS "توضیحات (DESCRIPTION)" .sp دستور \fBllvm\-profdata overlap\fP دو فایل دادهٔ پروفایل را دریافت کرده و هم‌پوشانی (\fIoverlap\fP) توزیع شمارنده‌ها را بین کل فایل‌ها و بین هر یک از توابع مشخص‌شده نمایش می‌دهد. .sp در این دستور، \fIoverlap\fP به‌صورت زیر تعریف می‌شود: فرض کنید \fIbase profile file\fP دارای مقادیر شمارش زیر باشد: {c1_1, c1_2, ..., c1_n, c1_u_1, c2_u_2, ..., c2_u_s}، و \fItest profile file\fP دارای مقادیر زیر باشد: {c2_1, c2_2, ..., c2_n, c2_v_1, c2_v_2, ..., c2_v_t}. در اینجا c{1|2}_i (به‌ازای i = 1 .. n) شمارنده‌های منطبق، و c1_u_i (به‌ازای i = 1 .. s) و c2_v_i (به‌ازای i = 1 .. v) به‌ترتیب شمارنده‌های تطبیق‌نیافته (یا شمارنده‌هایی که منحصراً وجود دارند) در \fIbase profile file\fP و \fItest profile file\fP هستند. فرض کنید sum_1 = c1_1 + c1_2 + ... + c1_n + c1_u_1 + c2_u_2 + ... + c2_u_s و sum_2 = c2_1 + c2_2 + ... + c2_n + c2_v_1 + c2_v_2 + ... + c2_v_t باشد. \fIoverlap\fP = min(c1_1/sum_1, c2_1/sum_2) + min(c1_2/sum_1, c2_2/sum_2) + ... + min(c1_n/sum_1, c2_n/sum_2). .sp توزیع هم‌پوشانی حاصل یک مقدار درصدی بین 0.0% تا 100.0% است، که 0.0% به معنای نبود هیچ‌گونه هم‌پوشانی و 100.0% به معنای هم‌پوشانی کامل است. .sp به‌عنوان مثال، اگر \fIbase profile file\fP دارای مقادیر شمارش {400, 600} باشد و \fItest profile file\fP مقادیر شمارش منطبق {60000, 40000} داشته باشد، میزان \fIoverlap\fP برابر با 80% خواهد بود. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-function= چاپ جزئیات برای یک تابع در صورتی که نام تابع حاوی رشتهٔ مشخص‌شده باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-help چاپ خلاصه‌ای از گزینه‌های خط فرمان. .UNINDENT .INDENT 0.0 .TP .B \-\-output=, \-o مشخص کردن نام فایل خروجی. اگر \fIoutput\fP برابر با \fB\-\fP باشد یا مشخص نشده باشد، خروجی به خروجی استاندارد ارسال می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-value\-cutoff= نمایش تنها توابعی که بیشینهٔ مقادیر شمارش آن‌ها بزرگ‌تر یا مساوی با \fBn\fP است. به‌طور پیش‌فرض، value\-cutoff روی بیشینهٔ مقدار unsigned long long تنظیم شده است. .UNINDENT .INDENT 0.0 .TP .B \-\-cs تنها نمایش هم‌پوشانی برای شمارش‌های پروفایل حساس به زمینه (context\-sensitive). حالت پیش‌فرض نمایش شمارش‌های پروفایل غیرحساس به زمینه است. .UNINDENT .SH ORDER .SS "خلاصه دستور (SYNOPSIS)" .sp \fBllvm\-profdata order\fP [\fIگزینه‌ها\fP] [\fIfilename\fP] .SS "توضیحات (DESCRIPTION)" .sp دستور \fBllvm\-profdata order\fP از ردپاهای پروفایل‌سازی زمانی موجود در یک پروفایل استفاده کرده و ترتیب توابعی را می‌یابد که تعداد خطاهای صفحه (page faults) را برای آن ردپاها کاهش دهد. این خروجی می‌تواند مستقیماً از طریق \fB\-\-symbol\-ordering\-file=\fP برای ELF یا \fB\-order\-file\fP برای Mach\-O به \fBlld\fP ارسال شود. اگر ردپاهای یافت‌شده در پروفایل بازتاب‌دهندهٔ عملکرد در دنیای واقعی باشند، این ترتیب باید کارایی راه‌اندازی را بهبود بخشد. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-help چاپ خلاصه‌ای از گزینه‌های خط فرمان. .UNINDENT .INDENT 0.0 .TP .B \-\-output=, \-o مشخص کردن نام فایل خروجی. اگر \fIoutput\fP برابر با \fB\-\fP باشد یا مشخص نشده باشد، خروجی به خروجی استاندارد ارسال می‌شود. .UNINDENT.SH "وضعیت خروج (EXIT STATUS)" .sp در صورتی که دستور مشخص نشده یا نامعتبر باشد، نتواند فایل‌های ورودی را بخواند، یا عدم تطابقی میان داده‌های آن‌ها وجود داشته باشد، \fBllvm\-profdata\fP مقدار 1 را بازمی‌گرداند. .SH "نویسندگان (AUTHORS)" توسط تیم LLVM نگهداری می‌شود (https://llvm.org). .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2003-2026, LLVM Project .\" End of generated man page.