'\" t
.\"     Title: perf
.\"    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: English
.\"
.TH "PERF" "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 \- ابزارهای تحلیل کارایی برای لینوکس
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIperf\fR [\-\-version] [\-\-help] [OPTIONS] COMMAND [ARGS]
.fi
.SH "گزینه‌ها (OPTIONS)"
.PP
\-h, \-\-help
.RS 4
اجرای دستور perf help\&.
.RE
.PP
\-v, \-\-version
.RS 4
نمایش نسخه perf\&.
.RE
.PP
\-vv
.RS 4
چاپ وضعیت کتابخانه‌های کامپایل‌شده داخلی\&.
.RE
.PP
\-\-exec\-path
.RS 4
نمایش یا تنظیم مسیر اجرایی (exec path)\&.
.RE
.PP
\-\-html\-path
.RS 4
نمایش مسیر مستندات html\&.
.RE
.PP
\-p, \-\-paginate
.RS 4
راه‌اندازی صفحه‌بندی‌کننده (pager)\&.
.RE
.PP
\-\-no\-pager
.RS 4
عدم استفاده از صفحه‌بندی‌کننده (pager)\&.
.RE
.PP
\-\-buildid\-dir
.RS 4
تنظیم دایرکتوری حافظه موقت (cache) مربوط به buildid\&. این گزینه نسبت به گزینه پیکربندی buildid\&.dir اولویت بالاتری دارد\&.
.RE
.PP
\-\-list\-cmds
.RS 4
فهرست کردن پرکاربردترین دستورات perf\&.
.RE
.PP
\-\-list\-opts
.RS 4
فهرست کردن گزینه‌های دردسترس perf\&.
.RE
.PP
\-\-debugfs\-dir
.RS 4
تنظیم دایرکتوری debugfs یا تنظیم متغیر محیطی PERF_DEBUGFS_DIR\&.
.RE
.PP
\-\-debug
.RS 4
تنظیم متغیر دیباگ (فهرست زیر را ببینید) در بازه مقادیر (0, 10)\&. نحوه استفاده: \-\-debug verbose # مقدار verbose = 1 را تنظیم می‌کند \-\-debug verbose=2 # مقدار verbose = 2 را تنظیم می‌کند
.sp
.if n \{\
.RS 4
.\}
.nf
فهرست متغیرهای دیباگ مجاز برای مقداردهی:
  verbose          \- پیام‌های دیباگ عمومی
  ordered\-events   \- پیام‌های دیباگ شیء رویدادهای مرتب‌شده
  data\-convert     \- پیام‌های دیباگ دستور data convert
  stderr           \- نوشتن خروجی دیباگ (گزینه \-v) در stderr
                     در حالت مرورگر
  perf\-event\-open  \- چاپ آرگومان‌ها و مقدار بازگشتی perf_event_open()
  kmaps            \- چاپ نقشه‌های هسته و ماژول (perf script
                     و perf report بدون مرورگر)
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-\-debug\-file
.RS 4
نوشتن خروجی دیباگ در یک فایل مشخص‌شده\&.
.RE
.SH "توضیحات (DESCRIPTION)"
.sp
شمارنده‌های کارایی برای لینوکس (Performance counters for Linux) یک زیرسیستم جدید مبتنی بر هسته هستند که چارچوبی را برای تمام جنبه‌های تحلیل کارایی فراهم می‌کنند\&. این ابزار قابلیت‌های سطح سخت‌افزار (CPU/PMU یا Performance Monitoring Unit) و قابلیت‌های نرم‌افزاری (شمارنده‌های نرم‌افزاری، نقاط ردگیری یا tracepoints) را پوشش می‌دهد\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBperf-stat\fR(1), \fBperf-top\fR(1), \fBperf-record\fR(1), \fBperf-report\fR(1), \fBperf-list\fR(1)
.sp
\fBperf-amd-ibs\fR(1), \fBperf-annotate\fR(1), \fBperf-archive\fR(1), \fBperf-arm-spe\fR(1), \fBperf-bench\fR(1), \fBperf-buildid-cache\fR(1), \fBperf-buildid-list\fR(1), \fBperf-c2c\fR(1), \fBperf-config\fR(1), \fBperf-data\fR(1), \fBperf-diff\fR(1), \fBperf-evlist\fR(1), \fBperf-ftrace\fR(1), \fBperf-help\fR(1), \fBperf-inject\fR(1), \fBperf-intel-pt\fR(1), \fBperf-iostat\fR(1), \fBperf-kallsyms\fR(1), \fBperf-kmem\fR(1), \fBperf-kvm\fR(1), \fBperf-lock\fR(1), \fBperf-mem\fR(1), \fBperf-probe\fR(1), \fBperf-sched\fR(1), \fBperf-script\fR(1), \fBperf-test\fR(1), \fBperf-trace\fR(1), \fBperf-version\fR(1)