'\" t
.\"     Title: perf-script
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 09/04/2026
.\"    Manual: perf Manual
.\"    Source: perf
.\"  Language: Persian
.\"
.TH "PERF\-SCRIPT" "1" "09/04/2026" "perf" "perf Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
perf-script \- خواندن perf\&.data (ایجادشده توسط perf record) و نمایش خروجی ردگیری (trace)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIperf script\fR [<options>]
\fIperf script\fR [<options>] record <script> [<record\-options>] <command>
\fIperf script\fR [<options>] report <script> [script\-args]
\fIperf script\fR [<options>] <script> <required\-script\-args> [<record\-options>] <command>
\fIperf script\fR [<options>] <top\-script> [script\-args]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور فایل ورودی را می‌خواند و ردگیری (trace) ضبط‌شده را نمایش می‌دهد\&.
.sp
چندین حالت مختلف برای perf script وجود دارد:
.sp
.if n \{\
.RS 4
.\}
.nf
دستور \*(Aqperf script\*(Aq برای مشاهدهٔ ردگیری تفصیلی بار کاری ضبط‌شده
به‌کار می‌رود\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
همچنین می‌توانید مجموعه‌ای از اسکریپت‌های از پیش آماده را اجرا کنید که داده‌های
خام ردگیری را به روش‌های گوناگون تجمیع و خلاصه می‌کنند (فهرست اسکریپت‌ها از طریق
\*(Aqperf script \-l\*(Aq در دسترس است)\&. حالت‌های زیر به شما امکان ضبط و اجرای
این اسکریپت‌ها را می‌دهند:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
دستور \*(Aqperf script record <script> <command>\*(Aq برای ضبط رویدادهای مورد نیاز
برای \*(Aqperf script report\*(Aq به‌کار می‌رود\&. آرگومان <script> نام نمایش‌داده‌شده
در خروجی \*(Aqperf script \-\-list\*(Aq است؛ یعنی نام واقعی اسکریپت منهای هرگونه پسوند
زبان برنامه‌نویسی\&. اگر <command> مشخص نشود، رویدادها با استفاده از گزینهٔ \-a
(سراسری در سیستم) در \*(Aqperf record\*(Aq ضبط می‌شوند\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
دستور \*(Aqperf script report <script> [args]\*(Aq برای اجرا و نمایش نتایج
<script> به‌کار می‌رود\&. آرگومان <script> نام نمایش‌داده‌شده در خروجی \*(Aqperf
script \-\-list\*(Aq است؛ یعنی نام واقعی اسکریپت منهای هرگونه پسوند زبان برنامه‌نویسی\&.
خروجی perf\&.data حاصل از اجرای قبلی \*(Aqperf script record <script>\*(Aq استفاده
می‌شود و برای موفقیت‌آمیز بودن این دستور باید وجود داشته باشد\&. آرگومان [args] به
آرگومان‌های (عمدتاً اختیاری) مورد انتظار اسکریپت اشاره دارد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
دستور \*(Aqperf script <script> <required\-script\-args> <command>\*(Aq هم برای
ضبط رویدادهای مورد نیاز <script> و هم برای اجرای <script> با استفاده از
حالت زنده (\*(Aqlive\-mode\*(Aq)، یعنی بدون نوشتن داده روی دیسک، به‌کار می‌رود\&.
آرگومان <script> نام نمایش‌داده‌شده در خروجی \*(Aqperf script \-\-list\*(Aq است؛
یعنی نام واقعی اسکریپت منهای هرگونه پسوند زبان برنامه‌نویسی\&. اگر <command> مشخص
نشود، رویدادها با استفاده از گزینهٔ \-a (سراسری در سیستم) در \*(Aqperf record\*(Aq
ضبط می‌شوند\&. اگر <script> آرگومان‌های اجباری داشته باشد، باید پیش از <command>
مشخص شوند\&. این حالت اجازهٔ تعیین آرگومان‌های اختیاری اسکریپت را نمی‌دهد؛ اگر
آرگومان‌های اختیاری اسکریپت مورد نیاز باشند، می‌توان آنها را با استفاده از دستورهای
جداگانهٔ \*(Aqperf script record\*(Aq و \*(Aqperf script report\*(Aq تعیین کرد،
به‌طوری که خروجی استاندارد (stdout) مرحلهٔ record با استفاده از گزینه‌های \*(Aq\-o \-\*(Aq
و \*(Aq\-i \-\*(Aq در دستورهای متناظر، به ورودی استاندارد (stdin) اسکریپت report
هدایت (pipe) شود\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
دستور \*(Aqperf script <top\-script>\*(Aq هم برای ضبط رویدادهای مورد نیاز برای
<top\-script> و هم برای اجرای <top\-script> با استفاده از حالت زنده (\*(Aqlive\-mode\*(Aq)،
یعنی بدون نوشتن چیزی روی دیسک، استفاده می‌شود\&. آرگومان <top\-script> نام
نمایش‌داده‌شده در خروجی \*(Aqperf script \-\-list\*(Aq است؛ یعنی نام واقعی اسکریپت
منهای هرگونه پسوند زبان برنامه‌نویسی؛ یک <top\-script> به‌صورت هر اسکریپتی که نام آن
به رشتهٔ \*(Aqtop\*(Aq ختم شود تعریف می‌گردد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
می‌توان [<record\-options>] را به مراحل ضبط دستور \*(Aqperf script record\*(Aq و
حالت‌های \*(Aqlive\-mode\*(Aq ارسال کرد؛ با این حال، این کار برای حالت زندهٔ
<top\-script> (\*(Aqlive\-mode\*(Aq) یا حالت‌های \*(Aqperf script report\*(Aq
امکان‌پذیر نیست\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
برای پیوندهایی به اطلاعات مختص هر زبان دربارهٔ نحوهٔ نوشتن و اجرای اسکریپت‌های
ردگیری خود، بخش «همچنین ببینید (SEE ALSO)» را مشاهده کنید\&.
.fi
.if n \{\
.RE
.\}.SH "گزینه‌ها (OPTIONS)"
.PP
<command>\&...
.RS 4
هر دستوری که می‌توانید در یک پوسته مشخص کنید\&.
.RE
.PP
\-D, \-\-dump\-raw\-trace=
.RS 4
نمایش خروجی پرجزئیات داده‌های ردگیری خام (raw trace)\&.
.RE
.PP
\-\-dump\-unsorted\-raw\-trace=
.RS 4
مشابه \-\-dump\-raw\-trace، اما بدون مرتب‌سازی بر اساس زمان\&.
.RE
.PP
\-L, \-\-Latency=
.RS 4
نمایش مشخصه‌های تأخیر (غیرفعال بودن irqs/preemption و غیره)\&.
.RE
.PP
\-l, \-\-list=
.RS 4
نمایش فهرستی از اسکریپت‌های ردگیری دردسترس\&.
.RE
.PP
\-s [\fIlang\fR], \-\-script=
.RS 4
پردازش داده‌های ردگیری با اسکریپت داده‌شده ([lang]:script[\&.ext])\&. اگر رشته
\fIlang\fR
به جای نام اسکریپت مشخص شود، در عوض فهرستی از زبان‌های پشتیبانی‌شده نمایش داده خواهد شد\&.
.RE
.PP
\-g, \-\-gen\-script=
.RS 4
تولید یک اسکریپت آغازین (starter script)\&. اگر زبانی مشخص شود، اسکریپت متناسب با آن زبان perf\-script\&.[ext] نام‌گذاری می‌شود\&. اگر یک مسیر فایل داده شود، python برای فایل‌های منتهی به
\fI\&.py\fR
و perl برای فایل‌های منتهی به
\fI\&.pl\fR
استفاده می‌شود\&.
.RE
.PP
\-\-dlfilter=<file>
.RS 4
فیلتر کردن رویدادهای نمونه با استفاده از فایل شیء اشتراکی (shared object) مشخص‌شده\&. رجوع کنید به
\fBperf-dlfilter\fR(1)
.RE
.PP
\-\-dlarg=<arg>
.RS 4
ارسال
\fIarg\fR
به عنوان یک آرگومان به dlfilter\&. گزینه \-\-dlarg می‌تواند برای افزودن آرگومان‌های بیشتر تکرار شود\&.
.RE
.PP
\-\-list\-dlfilters
.RS 4
نمایش فهرستی از dlfilterهای دردسترس\&. برای نمایش توضیحات کامل، به همراه گزینه \-v (باید پیش از گزینه \-\-list\-dlfilters بیاید) استفاده شود\&.
.RE
.PP
\-a
.RS 4
اجبار به جمع‌آوری در سراسر سیستم (system\-wide)\&. اسکریپت‌هایی که بدون یک <command> اجرا می‌شوند به‌طور پیش‌فرض از \-a استفاده می‌کنند، در حالی که اسکریپت‌های اجراشده با یک <command> معمولاً چنین نیستند \- این گزینه به حالت دوم اجازه می‌دهد در حالت سراسر سیستم اجرا شود\&.
.RE
.PP
\-i, \-\-input=
.RS 4
نام فایل ورودی\&. (پیش‌فرض: perf\&.data مگر اینکه stdin یک fifo باشد)
.RE
.PP
\-d, \-\-debug\-mode
.RS 4
انجام بررسی‌های گوناگون مانند ترتیب نمونه‌ها و رویدادهای ازدست‌رفته\&.
.RE
.PP
\-F, \-\-fields
.RS 4
فهرستی از فیلدهای جداشده با کاما برای چاپ\&. گزینه‌ها عبارتند از: comm, tid, pid, time, cpu, event, trace, ip, sym, dso, dsoff, addr, symoff, srcline, period, iregs, uregs, brstack, brstacksym, flags, bpf\-output, brstackinsn, brstackinsnlen, brstackdisasm, brstackoff, callindent, insn, disasm, insnlen, synth, phys_addr, metric, misc, srccode, ipc, data_page_size, code_page_size, ins_lat, machine_pid, vcpu, cgroup, retire_lat, brcntr,
.sp
.if n \{\
.RS 4
.\}
.nf
فهرست فیلدها می‌تواند با نوع، trace، sw یا hw پیشوندگذاری شود
تا مشخص کند فهرست فیلدها به کدام نوع رویداد اعمال می‌شود\&.
برای نمونه، \-F sw:comm,tid,time,ip,sym و \-F trace:time,cpu,trace
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
perf script \-F <fields>
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
معادل است با:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
perf script \-F trace:<fields> \-F sw:<fields> \-F hw:<fields>
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
یعنی در صورتی که رشته نوع مشخص نشود، فیلدهای تعیین‌شده
به همه انواع رویداد اعمال می‌شوند\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
علاوه بر بازنویسی فیلدها، افزودن یا حذف فیلدها از مقادیر
پیش‌فرض نیز امکان‌پذیر است\&. برای نمونه:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\-F \-cpu,+insn
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
فیلد cpu را حذف و فیلد insn را اضافه می‌کند\&. افزودن/حذف فیلدها
نمی‌تواند با بازنویسی عادی ترکیب شود\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
آرگومان‌ها به ترتیبی که دریافت می‌شوند پردازش می‌گردند\&. استفاده بعدی می‌تواند
درخواست پیشین را بازنشانی کند؛ مانند:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\-F trace: \-F comm,tid,time,ip,sym
.fi
.if n \{\
.RE
.\}.sp
.if n \{\
.RS 4
.\}
.nf
نخستین \-F رویدادهای trace را متوقف می‌کند (فهرست فیلدها "" است)، اما سپس
دومین فراخوانی فیلدها را به comm,tid,time,ip,sym تنظیم می‌کند\&. در این حالت
هشداری به کاربر داده می‌شود:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
"Overriding previous field request for all events\&."
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
به‌عنوان روشی دیگر، این ترتیب را در نظر بگیرید:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\-F comm,tid,time,ip,sym \-F trace:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
اولین \-F فیلدها را برای تمام رویدادها تنظیم کرده و دومین \-F
رویدادهای trace را متوقف می‌سازد\&. پیامی مبنی بر هشدار بازنویسی به
کاربر نمایش داده می‌شود، و نتیجهٔ موارد فوق این است که تنها رویدادهای
S/W و H/W با فیلدهای داده‌شده نمایش داده می‌شوند\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
امکان افزودن/حذف فیلدها تنها برای یک نوع رویداد خاص وجود دارد:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\-Fsw:\-cpu,\-period
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
فیلدهای cpu و period را از رویدادهای نرم‌افزاری حذف می‌کند\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
برای گزینهٔ \*(Aqwildcard\*(Aq اگر فیلد انتخاب‌شده توسط کاربر برای یک نوع رویداد
نامعتبر باشد، پیامی به کاربر نمایش داده می‌شود مبنی بر اینکه آن گزینه
برای آن نوع نادیده گرفته شده است\&. برای نمونه:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ perf script \-F comm,tid,trace
\*(Aqtrace\*(Aq not valid for hardware events\&. Ignoring\&.
\*(Aqtrace\*(Aq not valid for software events\&. Ignoring\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
در مقابل، اگر نوع رویداد داده شود و یک فیلد نامعتبر مشخص گردد،
یک خطا خواهد بود\&. برای نمونه:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
perf script \-v \-F sw:comm,tid,trace
\*(Aqtrace\*(Aq not valid for software events\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
در این مرحله نحوهٔ استفاده (راهنما) نمایش داده شده و perf\-script خارج می‌شود\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
فیلد flags ساختگی (synthesized) است و ممکن است هنگام رمزگشایی Instruction
Trace دارای مقدار باشد\&. پرچم‌ها "bcrosyiABExghDt" هستند که به‌ترتیب نمایانگر branch (انشعاب)،
call (فراخوانی)، return (بازگشت)، conditional (شرطی)، system (سیستم)، asynchronous (ناهمگام)، interrupt (وقفه)،
transaction abort (ابطال تراکنش)، trace begin (شروع ردگیری)، trace end (پایان ردگیری)، in transaction (درون تراکنش)، VM\-Entry،
VM\-Exit، interrupt disabled (وقفه غیرفعال) و interrupt disable toggle (تغییر وضعیت غیرفعال‌سازی وقفه) هستند\&.
ترکیب‌های شناخته‌شدهٔ پرچم‌ها به شکل خواناتری چاپ می‌شوند؛ مانند:
"call" برای "bc"، "return" برای "br"، "jcc" برای "bo"، "jmp" برای "b"،
"int" برای "bci"، "iret" برای "bri"، "syscall" برای "bcs"، "sysret" برای "brs"،
"async" برای "by"، "hw int" برای "bcyi"، "tx abrt" برای "bA"، "tr strt" برای "bB"،
"tr end" برای "bE"، "vmentry" برای "bcg" و "vmexit" برای "bch"\&.
با این حال پرچم‌های "x" ،"D" و "t" در این موارد به‌صورت جداگانه نمایش داده خواهند شد؛
مانند "jcc     (xD)" برای یک انشعاب شرطی درون یک تراکنش
با وقفه‌های غیرفعال\&. توجه داشته باشید که غیرفعال شدن وقفه‌ها با "t"
و فعال شدن وقفه‌ها با "Dt" نشان داده می‌شود\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
فیلد callindent ساختگی (synthesized) است و ممکن است هنگام
رمزگشایی Instruction Trace دارای مقدار باشد\&. برای فراخوانی‌ها و بازگشت‌ها، این فیلد
نام نماد را با دندانه‌گذاری با فاصله جهت نمایش عمق پشته (stack depth) نشان می‌دهد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}.nf
هنگام انجام رمزگشایی رد دستورالعمل‌ها، insn ،disasm و insnlen به‌ترتیب
بایت‌های دستورالعمل، دستورالعمل‌های دیس‌اسمبل‌شده (نیازمند پشتیبانی libcapstone)
و طول دستورالعمل جاری را ارائه می‌دهند\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
فیلد synth توسط رویدادهای سنتز‌شده (synthesized events) استفاده می‌شود که ممکن است هنگام
رمزگشایی رد دستورالعمل‌ها (Instruction Trace decoding) ایجاد شوند\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
فیلد ipc (دستورالعمل بر چرخه / instructions per cycle) سنتز‌شده است و ممکن است هنگام
رمزگشایی رد دستورالعمل‌ها (Instruction Trace decoding) دارای مقدار باشد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
فیلدهای machine_pid و vcpu از داده‌های حاصل از به‌کارگیری perf inject
برای درج یک فایل perf\&.data ضبط‌شده در داخل ماشین مجازی در یک فایل perf\&.data
ضبط‌شده روی میزبان به‌طور هم‌زمان، مشتق می‌شوند\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
فیلدهای cgroup نیازمند نمونه‌ای هستند که شناسه cgroup را داشته باشد؛ شناسه‌ای که هنگام
ارسال گزینه "\-\-all\-cgroups" به \*(Aqperf record\*(Aq ذخیره می‌شود\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
در نهایت، کاربر نمی‌تواند فیلدها را برای همه انواع رویدادها روی none تنظیم کند؛
به این معنی که \-F "" مجاز نیست\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
خروجی brstack شامل اطلاعات مرتبط با انشعاب همراه با آدرس‌های خام با استفاده از نحو
FROM/TO/EVENT/INTX/ABORT/CYCLES/TYPE/SPEC به ترتیب زیر است:
FROM  : دستورالعمل مبدأ انشعاب
TO    : دستورالعمل مقصد انشعاب
EVENT : M=مقصد یا جهت انشعاب به نادرستی پیش‌بینی شده بود (mispredicted)
        P=مقصد یا جهت انشعاب پیش‌بینی شده بود (predicted)
        N=انشعاب محقق نشد (not\-taken)
        \-=بدون رویداد یا پشتیبانی‌نشده
INTX  : X=انشعاب در داخل یک ناحیه تراکنشی
        \-=انشعاب در ناحیه تراکنش نیست یا پشتیبانی‌نشده
ABORT : A=ورودی سقط TSX
        \-=ناحیه سقط‌شده نیست یا پشتیبانی‌نشده
CYCLES: تعداد چرخه‌هایی که از زمان ضبط آخرین انشعاب سپری شده است
TYPE  : نوع انشعاب: COND/UNCOND/IND/CALL/IND_CALL/RET و غیره\&.
        \-=پشتیبانی‌نشده
SPEC  : اطلاعات حدس و گمانه‌زنی انشعاب: SPEC_WRONG_PATH/NON_SPEC_CORRECT_PATH/SPEC_CORRECT_PATH
        \-=پشتیبانی‌نشده
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
فیلد brstacksym همانند brstack است، به‌جز اینکه آدرس‌های FROM و TO در صورت امکان به شکل نمادین چاپ می‌شوند\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
هنگامی که brstackinsn مشخص شود، توالی‌های کامل اسمبلیِ توالی‌های انشعاب برای هر نمونه
چاپ می‌شود\&. این مسیر اجرای کاملی است که به نمونه منتهی می‌شود\&. این قابلیت تنها زمانی
پشتیبانی می‌شود که نمونه با perf record \-b یا \-j any ضبط شده باشد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
از brstackinsnlen برای چاپ طول brstackinsn استفاده کنید\&. برای مثال، شما
نمی‌توانید از دستورالعمل متوالی بعدی پس از یک انشعاب غیرشرطی مطلع شوید، مگر آنکه
آن را بر اساس طول آن محاسبه نمایید\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
فیلد brstackdisasm مانند brstackinsn عمل می‌کند، اما اگر perf با کتابخانه
capstone ساخته شده باشد، دستورالعمل‌های دیس‌اسمبل‌شده را چاپ خواهد کرد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
فیلد brstackoff آفست را درون یک dso/باینری خاص چاپ خواهد کرد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
با گزینه metric، دستور perf script می‌تواند معیارهایی را برای دوره‌های نمونه‌برداری،
مشابه perf stat محاسبه کند\&. این امر مستلزم تعیین یک گروه با چندین رویداد است
که معیارها را با گزینه :S برای perf record تعریف می‌کنند\&. دستور perf بر روی رویداد
اول نمونه‌برداری انجام می‌دهد و معیارهای محاسبه‌شده را برای همه رویدادهای درون گروه چاپ می‌کند\&.
لطفاً توجه داشته باشید که معیار محاسبه‌شده در کل دوره نمونه‌برداری (از زمان آخرین نمونه)
میانگین‌گیری می‌شود، نه فقط برای نقطه نمونه‌برداری\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
برای رویدادهای نمونه، نمایش فیلد misc با گزینه \-F +misc امکان‌پذیر است؛
حروف زیر برای هر بیت نمایش داده می‌شوند:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
PERF_RECORD_MISC_KERNEL               K
PERF_RECORD_MISC_USER                 U
PERF_RECORD_MISC_HYPERVISOR           H
PERF_RECORD_MISC_GUEST_KERNEL         G
PERF_RECORD_MISC_GUEST_USER           g
PERF_RECORD_MISC_MMAP_DATA*           M
PERF_RECORD_MISC_COMM_EXEC            E
PERF_RECORD_MISC_SWITCH_OUT           S
PERF_RECORD_MISC_SWITCH_OUT_PREEMPT   Sp
.fi
.if n \{\
.RE
.\}.sp
.if n \{\
.RS 4
.\}
.nf
$ perf script \-F +misc \&.\&.\&.
 sched\-messaging  1414 K     28690\&.636582:       4590 cycles \&.\&.\&.
 sched\-messaging  1407 U     28690\&.636600:     325620 cycles \&.\&.\&.
 sched\-messaging  1414 K     28690\&.636608:      19473 cycles \&.\&.\&.
misc field ___________/
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-k, \-\-vmlinux=<file>
.RS 4
مسیر فایل vmlinux
.RE
.PP
\-\-kallsyms=<file>
.RS 4
مسیر فایل kallsyms
.RE
.PP
\-\-symfs=<directory[,layout]>
.RS 4
جستجوی فایل‌های دارای نماد نسبت به این دایرکتوری\&. چیدمان اختیاری (layout) می‌تواند
\fIhierarchy\fR
(پیش‌فرض، منطبق بر مسیر کامل) یا
\fIflat\fR
(تنها منطبق بر نام پایه) باشد\&. این گزینه زمانی مفید است که فایل‌های اشکال‌زدایی (debug) در یک ساختار دایرکتوری مسطح ذخیره شده باشند\&.
.RE
.PP
\-G, \-\-hide\-call\-graph
.RS 4
عدم نمایش زنجیره فراخوانی (call chain) هنگام چاپ نمادها\&.
.RE
.PP
\-\-stop\-bt
.RS 4
توقف نمایش گراف فراخوانی (callgraph) در این نمادها\&.
.RE
.PP
\-C, \-\-cpu
.RS 4
تنها گزارش نمونه‌ها برای فهرست پردازنده‌های (CPUهای) ارائه‌شده\&. چندین پردازنده را می‌توان به صورت یک فهرست جداشده با کاما و بدون فاصله مشخص کرد: 0,1\&. محدوده‌های پردازنده با \- مشخص می‌شوند: 0\-2\&. حالت پیش‌فرض، گزارش نمونه‌ها روی تمام پردازنده‌ها است\&.
.RE
.PP
\-c, \-\-comms=
.RS 4
تنها نمایش رویدادها برای این commها\&. قالبی از CSV که ورودی‌های
\m[blue]\fBfile://filename\fR\m[]
را پشتیبانی می‌کند\&.
.RE
.PP
\-\-pid=
.RS 4
تنها نمایش رویدادها برای شناسه فرآیند (PID) داده‌شده (فهرست جداشده با کاما)\&.
.RE
.PP
\-\-tid=
.RS 4
تنها نمایش رویدادها برای شناسه رشته (TID) داده‌شده (فهرست جداشده با کاما)\&.
.RE
.PP
\-I, \-\-show\-info
.RS 4
نمایش اطلاعات تفصیلی درباره فایل perf\&.data\&. این گزینه اطلاعاتی را اضافه می‌کند که ممکن است بسیار حجیم باشند و در نتیجه نمایش را شلوغ کنند\&. این اطلاعات در حال حاضر شامل توپولوژی cpu و numa سیستم میزبان است\&. این گزینه تنها در حالت گزارش perf script قابل استفاده است\&.
.RE
.PP
\-\-show\-kernel\-path
.RS 4
تلاش برای یافتن و وضوح مسیر [kernel\&.kallsyms]
.RE
.sp
\-\-show\-task\-events نمایش رویدادهای مرتبط با وظیفه (task) (مانند FORK، COMM، EXIT)\&.
.sp
\-\-show\-mmap\-events نمایش رویدادهای مرتبط با mmap (مانند MMAP، MMAP2)\&.
.sp
\-\-show\-namespace\-events نمایش رویدادهای namespace یعنی رویدادهایی از نوع PERF_RECORD_NAMESPACES\&.
.sp
\-\-show\-switch\-events نمایش رویدادهای تعویض زمینه (context switch) یعنی رویدادهایی از نوع PERF_RECORD_SWITCH یا PERF_RECORD_SWITCH_CPU_WIDE\&.
.sp
\-\-show\-lost\-events نمایش رویدادهای ازدست‌رفته (lost) یعنی رویدادهایی از نوع PERF_RECORD_LOST\&.
.sp
\-\-show\-round\-events نمایش رویدادهای دورِ پایان‌یافته یعنی رویدادهایی از نوع PERF_RECORD_FINISHED_ROUND\&.
.sp
\-\-show\-bpf\-events نمایش رویدادهای bpf یعنی رویدادهایی از نوع PERF_RECORD_KSYMBOL و PERF_RECORD_BPF_EVENT\&.
.sp
\-\-show\-cgroup\-events نمایش رویدادهای cgroup یعنی رویدادهایی از نوع PERF_RECORD_CGROUP\&.
.sp
\-\-show\-text\-poke\-events نمایش رویدادهای text poke یعنی رویدادهایی از نوع PERF_RECORD_TEXT_POKE و PERF_RECORD_KSYMBOL\&.
.PP
\-\-demangle
.RS 4
رمزگشایی نام نمادها (demangle) به شکلی خوانا برای انسان\&. این گزینه به‌طور پیش‌فرض فعال است؛ غیرفعال‌سازی با \-\-no\-demangle انجام می‌شود\&.
.RE
.PP
\-\-demangle\-kernel
.RS 4
رمزگشایی نام نمادهای هسته (demangle) به شکلی خوانا برای انسان (برای هسته‌های ++C)\&.
.RE
.PP
\-\-addr2line=<path>
.RS 4
مسیر به باینری addr2line\&.
.RE
.sp
\-\-header نمایش سربرگ perf\&.data\&.
.sp
\-\-header\-only تنها نمایش سربرگ perf\&.data\&.
.PP
\-\-itrace
.RS 4
گزینه‌هایی برای رمزگشایی داده‌های ردگیری دستورالعمل (instruction tracing)\&. گزینه‌ها عبارتند از:
.sp
.if n \{\
.RS 4
.\}
.nf
i       تولید رویدادهای instructions
y       تولید رویدادهای cycles
b       تولید رویدادهای branches
c       تولید رویدادهای branches (فقط calls)
r       تولید رویدادهای branches (فقط returns)
x       تولید رویدادهای transactions
w       تولید رویدادهای ptwrite
p       تولید رویدادهای power (شامل رویدادهای PSB برای Intel PT)
o       تولید سایر رویدادهای ثبت‌شده به دلیل استفاده
        از aux\-output (به perf record مراجعه کنید)
I       تولید رویدادهای وقفه (interrupt) یا مشابه (ناهمگام)
        (مانند Intel PT Event Trace)
e       تولید رویدادهای خطا (error)
d       ایجاد لاگ اشکال‌زدایی (debug)
f       تولید رویدادهای حافظه پنهان سطح اول (first level cache)
m       تولید رویدادهای حافظه پنهان سطح آخر (last level cache)
M       تولید رویدادهای حافظه (memory)
t       تولید رویدادهای TLB
a       تولید رویدادهای دسترسی از راه دور (remote access)
g       تولید یک زنجیره فراخوانی (call chain) (استفاده همراه با i یا x)
G       تولید یک زنجیره فراخوانی روی رکوردهای رویداد موجود
l       تولید ورودی‌های آخرین شاخه (last branch) (استفاده همراه با i یا x)
L       تولید ورودی‌های آخرین شاخه روی رکوردهای رویداد موجود
s       نادیده‌گرفتن تعداد اولیه‌ای از رویدادها
q       رمزگشایی سریع‌تر (با جزئیات کمتر)
A       محاسبه تقریبی IPC
Z       ترجیح بر نادیده‌گرفتن برچسب‌های زمانی (رمزگشایی اصطلاحاً «بی‌زمان» یا timeless)
T       استفاده از رد برچسب زمانی به عنوان زمان هسته (kernel time)
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
پیش‌فرض همه رویدادها است، یعنی همانند \-\-itrace=iybxwpe،
به‌جز برای perf script که مقدار آن \-\-itrace=ce است
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
علاوه بر این، دوره زمانی (پیش‌فرض 100000، به‌جز برای perf script که 1 است)
برای رویدادهای instructions می‌تواند در واحدهایی از موارد زیر مشخص شود:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}.nf
i       دستورالعمل‌ها (instructions)
t       تیک‌ها (ticks)
ms      میلی‌ثانیه (milliseconds)
us      میکروثانیه (microseconds)
ns      نانوثانیه (پیش‌فرض)
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
همچنین اندازهٔ زنجیرهٔ فراخوانی (پیش‌فرض 16، حداکثر 1024) را می‌توان برای رویدادهای
دستورالعمل‌ها یا تراکنش‌ها مشخص کرد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
همچنین تعداد مدخل‌های آخرین شاخه (پیش‌فرض 64، حداکثر 1024) را می‌توان برای
رویدادهای دستورالعمل‌ها یا تراکنش‌ها مشخص کرد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
مشابه گزینه‌های g و l، اندازه را می‌توان برای گزینه‌های G و L نیز مشخص کرد\&.
در x86، توجه داشته باشید که وقتی داده‌ها با PEBS بزرگ ثبت شده باشند، G و L
عملکرد ضعیفی دارند\&. برای جزئیات به صفحهٔ راهنمای linkperf:perf\-intel\-pt[1] مراجعه کنید\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
همچنین می‌توان رویدادهای تولیدشده در ابتدا (دستورالعمل‌ها، شاخه‌ها، تراکنش‌ها،
ptwrite و power) را نادیده گرفت\&. این کار برای نادیده گرفتن کد راه‌اندازی مفید است\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-itrace=i0nss1000000
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
یک میلیون دستورالعمل نخست را نادیده می‌گیرد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
گزینهٔ \*(Aqe\*(Aq می‌تواند با پرچم‌هایی دنبال شود که مشخص می‌کنند چه خطاهایی گزارش
خواهند شد یا نخواهند شد\&. پیش از هر پرچم باید \*(Aq+\*(Aq یا \*(Aq\-\*(Aq قرار گیرد\&.
این پرچم‌ها عبارت‌اند از:
        o       سرریز (overflow)
        l       از دست رفتن داده‌های ردگیری (trace data lost)
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
در صورت پشتیبانی، گزینهٔ \*(Aqd\*(Aq می‌تواند با پرچم‌هایی دنبال شود که مشخص می‌کنند چه
پیام‌های اشکال‌زدایی‌ای ثبت خواهند شد یا نخواهند شد\&. پیش از هر پرچم باید
\*(Aq+\*(Aq یا \*(Aq\-\*(Aq قرار گیرد\&. این پرچم‌ها عبارت‌اند از:
        a       همهٔ رویدادهای perf
        e       خروجی فقط هنگام خطاها (اندازه قابل پیکربندی است \- linkperf:perf\-config[1] را ببینید)
        o       خروجی به stdout
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
در صورت پشتیبانی، گزینهٔ \*(Aqq\*(Aq را می‌توان برای افزایش اثر تکرار کرد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
برای غیرفعال کردن کامل رمزگشایی، از \-\-no\-itrace استفاده کنید\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-\-full\-source\-path
.RS 4
نمایش مسیر کامل فایل‌های منبع برای خروجی srcline\&.
.RE
.PP
\-\-max\-stack
.RS 4
تنظیم محدودیت عمق پشته هنگام تجزیهٔ زنجیرهٔ فراخوانی؛ هر چیزی فراتر از عمق مشخص‌شده نادیده گرفته خواهد شد\&. این یک مصالحه میان از دست رفتن اطلاعات و پردازش سریع‌تر است، به‌ویژه برای بار‌های کاری که می‌توانند پشتهٔ زنجیرهٔ فراخوانی بسیار طولانی داشته باشند\&. توجه داشته باشید که هنگام استفاده از گزینهٔ \-\-itrace، در صورتی که اندازهٔ زنجیرهٔ فراخوانی ساخته‌شده (synthesized) بزرگ‌تر باشد، جایگزین این مقدار خواهد شد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
پیش‌فرض: 127
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-\-ns
.RS 4
استفاده از ۹ رقم اعشار هنگام نمایش زمان (یعنی نمایش نانوثانیه‌ها)
.RE
.PP
\-f, \-\-force
.RS 4
عدم انجام اعتبارسنجی مالکیت\&.
.RE
.PP
\-\-time
.RS 4
تنها نمونه‌های درون بازهٔ زمانی ارائه‌شده تحلیل شوند: <start>,<stop>\&. زمان‌ها دارای قالب seconds\&.nanoseconds هستند\&. اگر زمان آغاز مشخص نشده باشد (یعنی رشتهٔ زمانی
\fI,x\&.y\fR باشد)، تحلیل از ابتدای فایل آغاز می‌شود\&. اگر زمان پایان مشخص نشده باشد (یعنی رشتهٔ زمانی
\fIx\&.y,\fR باشد)، تحلیل تا انتهای فایل ادامه می‌یابد\&. چندین بازه را می‌توان با فاصله از هم جدا کرد، که در این حالت آرگومان باید در علامت نقل‌قول قرار گیرد؛ مانند: \-\-time "1234\&.567,1234\&.789 1235,"
.sp
.if n \{\
.RS 4
.\}
.nf
همچنین از درصد زمانی با چندین بازهٔ زمانی پشتیبانی می‌کند\&. رشتهٔ زمانی به‌صورت
\*(Aqa%/n,b%/m,\&.\&.\&.\*(Aq یا \*(Aqa%\-b%,c%\-%d,\&.\&.\&.\*(Aq است\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
برای نمونه:
انتخاب دومین برش زمانی 10٪:
perf script \-\-time 10%/2
.fi
.if n \{\
.RE
.\}.sp
.if n \{\
.RS 4
.\}
.nf
انتخاب برش زمانی از 0% تا 10%:
perf script \-\-time 0%\-10%
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
انتخاب اولین و دومین برش زمانی 10%:
perf script \-\-time 10%/1,10%/2
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
انتخاب برش‌های 0% تا 10% و 30% تا 40%:
perf script \-\-time 0%\-10%,30%\-40%
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-\-max\-blocks
.RS 4
تنظیم حداکثر تعداد بلوک‌های برنامه برای چاپ با brstackinsn به ازای هر نمونه\&.
.RE
.PP
\-\-reltime
.RS 4
چاپ برچسب‌های زمانی نسبت به شروع ردگیری\&.
.RE
.PP
\-\-deltatime
.RS 4
چاپ برچسب‌های زمانی نسبت به رویداد قبلی\&.
.RE
.PP
\-\-per\-event\-dump
.RS 4
ایجاد فایل‌های جداگانه به ازای هر رویداد با نام "perf\&.data\&.EVENT\&.dump" به جای چاپ در خروجی استاندارد (stdout)؛ برای مثال جهت ایجاد flamegraphها مفید است\&.
.RE
.PP
\-\-inline
.RS 4
اگر نشانی callgraph متعلق به یک تابع درون‌خطی (inlined) باشد، پشته درون‌خطی چاپ خواهد شد\&. هر مدخل دارای نام تابع و فایل/خط است\&. به‌طور پیش‌فرض فعال است، با \-\-no\-inline غیرفعال می‌شود\&.
.RE
.PP
\-\-insn\-trace[=<raw|disasm>]
.RS 4
نمایش جریان دستورالعمل‌ها به صورت بایت‌ها (raw) یا دیس‌اسمبل‌شده (disasm) برای ردگیری‌های intel_pt\&. مقدار پیش‌فرض
\fIraw\fR\&
است\&. برای استفاده از xed، مقدار
\fIraw\fR
را با \-\-xed ترکیب کنید تا دیس‌اسمبل انجام‌شده توسط xed نمایش داده شود\&.
.RE
.PP
\-\-xed
.RS 4
اجرای دیس‌اسمبلر xed روی خروجی\&. نیازمند نصب بودن دیس‌اسمبلر xed است\&.
.RE
.PP
\-S, \-\-symbols=symbol[,symbol\&...]
.RS 4
فقط نمادهای ذکرشده را در نظر می‌گیرد\&. نمادها معمولاً نام هستند اما می‌توانند نشانی هگزادسیمال نیز باشند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
نشانی هگزادسیمال می‌تواند نشانی شروع یک نماد یا
هر نشانی دیگری برای فیلتر کردن رکوردهای ردگیری باشد
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
برای مثال، برای انتخاب نماد noploop یا نشانی 0x4007a0:
perf script \-\-symbols=noploop,0x4007a0
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
از فیلتر کردن رکوردهای ردگیری بر اساس نام نماد، نشانی شروع
نماد، هر نشانی هگزادسیمال و بازه نشانی پشتیبانی می‌کند\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
ترتیب مقایسه به این صورت است:
.fi
.if n \{\
.RE
.\}
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
مقایسه بر اساس نام نماد
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
مقایسه بر اساس نشانی شروع نماد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
مقایسه بر اساس هر نشانی هگزادسیمال\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
مقایسه بر اساس بازه نشانی (به \-\-addr\-range مراجعه کنید)\&.
.RE
.RE
.PP
\-\-addr\-range
.RS 4
همراه با \-S یا \-\-symbols برای فهرست کردن رکوردهای ردگیری‌شده در یک بازه نشانی استفاده می‌شود\&.
.sp
.if n \{\
.RS 4
.\}
.nf
برای مثال، برای فهرست کردن رکوردهای ردگیری‌شده در بازه نشانی
[0x4007a0, 0x0x4007a9]:
perf script \-S 0x4007a0 \-\-addr\-range 10
.fi
.if n \{\
.RE
.\}
.RE.PP
\-\-dsos=
.RS 4
فقط نمادها را در این DSOها در نظر می‌گیرد\&.
.RE
.PP
\-\-call\-trace
.RS 4
جریان فراخوانی را برای ردگیری‌های intel_pt نمایش می‌دهد\&. پردازنده‌ها درهم‌تنیده‌اند، اما می‌توان با \-C آن‌ها را پالایش کرد\&.
.RE
.PP
\-\-call\-ret\-trace
.RS 4
جریان فراخوانی و بازگشت را برای ردگیری‌های intel_pt نمایش می‌دهد\&.
.RE
.PP
\-\-graph\-function
.RS 4
برای itrace، تنها توابع مشخص‌شده و فراخوانده‌شده‌های آن‌ها را نمایش می‌دهد\&. توابع متعدد را می‌توان با ویرگول از یکدیگر جدا کرد\&.
.RE
.PP
\-\-switch\-on EVENT_NAME
.RS 4
تنها پس از پیدا شدن این رویداد، رویدادها را در نظر می‌گیرد\&.
.RE
.PP
\-\-switch\-off EVENT_NAME
.RS 4
پس از پیدا شدن این رویداد، بررسی رویدادها را متوقف می‌کند\&.
.RE
.PP
\-\-show\-on\-off\-events
.RS 4
رویدادهای مربوط به \-\-switch\-on/off را نیز نمایش می‌دهد\&.
.RE
.PP
\-\-stitch\-lbr
.RS 4
نمودار فراخوانی را با LBRهای پیوندخورده (stitched) نشان می‌دهد که ممکن است نمودار فراخوانی کامل‌تری ارائه دهد\&. فایل perf\&.data باید با استفاده از perf record \-\-call\-graph lbr به‌دست آمده باشد\&. به‌طور پیش‌فرض غیرفعال است\&. در موارد معمول سرریز پشتهٔ فراخوانی، می‌تواند پشته‌های فراخوانی بهتری را نسبت به خروجی پشتهٔ فراخوانی پیش‌فرض lbr بازسازی کند\&. اما این روش بی‌نقص نیست\&. ممکن است مواردی رخ دهد که در آن بر اثر تطابق‌های نادرست، پشته‌های فراخوانی نادرستی ایجاد شود\&. محدودیت‌های شناخته‌شده شامل مدیریت استثناها نظیر setjmp/longjmp است که در آن‌ها فراخوانی‌ها/بازگشت‌ها تطابق نخواهند داشت\&.
.RE
.PP
\-\-merge\-callchains
.RS 4
ادغام زنجیره‌های فراخوانی به‌تعویق‌افتادهٔ کاربر را در صورت وجود فعال می‌کند\&. این رفتار پیش‌فرض است\&. اگر به هر دلیلی می‌خواهید رکوردهای مجزای CALLCHAIN_DEFERRED را مشاهده کنید، صریحاً از \-\-no\-merge\-callchains استفاده کنید\&.
.RE
.PP
\-\-guestmount=<path>
.RS 4
دایرکتوری سوار کردن (mount) سیستم‌فایل ریشهٔ سیستم‌عامل مهمان\&. کاربران دایرکتوری‌های ریشهٔ سیستم‌عامل مهمان را از طریق یک روش دسترسی به سیستم‌فایل، معمولاً sshfs، زیر <path> سوار می‌کنند\&. به عنوان مثال، اجرای ۲ سیستم‌عامل مهمان، که pid یکی ۸۸۸۸ و دیگری ۹۹۹۹ است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkdir ~/guestmount
$ cd ~/guestmount
$ sshfs \-o allow_other,direct_io \-p 5551 localhost:/ 8888/
$ sshfs \-o allow_other,direct_io \-p 5552 localhost:/ 9999/
$ perf script \-\-guestmount=~/guestmount 
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-\-guestkallsyms=<path>
.RS 4
رونوشت فایل /proc/kallsyms سیستم‌عامل مهمان\&. برنامهٔ perf برای دریافت نمادهای کرنل مهمان آن را می‌خواند\&. کاربران باید آن را از سیستم‌عامل مهمان کپی کنند\&.
.RE
.PP
\-\-guestmodules=<path>
.RS 4
رونوشت فایل /proc/modules سیستم‌عامل مهمان\&. برنامهٔ perf برای دریافت اطلاعات ماژول‌های کرنل مهمان آن را می‌خواند\&. کاربران باید آن را از سیستم‌عامل مهمان کپی کنند\&.
.RE
.PP
\-\-guestvmlinux=<path>
.RS 4
فایل vmlinux کرنل سیستم‌عامل مهمان\&.
.RE
.PP
\-\-guest\-code
.RS 4
مشخص می‌کند که کد مهمان در فرایند ناظر مجازی (hypervisor) قابل یافتن است، که حالتی معمول برای برنامه‌های آزمایشی KVM محسوب می‌شود\&.
.RE.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBperf-record\fR(1), \fBperf-script-perl\fR(1), \fBperf-script-python\fR(1), \fBperf-intel-pt\fR(1), \fBperf-dlfilter\fR(1)