'\" t
.\"     Title: perf-test
.\"    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\-TEST" "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-test \- اجرای آزمون‌های سنجش سلامت\&.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIperf test [<options>] [{list <test\-name\-fragment>|[<test\-name\-fragments>|<test\-numbers>]}]\fR
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور آزمون‌های گوناگون سنجش سلامت را اجرا می‌کند؛ ابتدا از طریق روتین‌های پیوندخورده (linked routines) و سپس با جستجوی پوشه‌ای شامل آزمون‌های بیشتر در قالب اسکریپت‌ها\&.
.sp
برای دریافت فهرستی از آزمون‌های موجود از \fIperf test list\fR استفاده کنید؛ مشخص کردن بخشی از نام آزمون، تمام آزمون‌های شامل آن عبارت را نشان خواهد داد\&.
.sp
برای اجرای آزمون‌های مشخص، بخش‌هایی از نام آزمون یا شماره‌های به‌دست‌آمده از \fIperf test list\fR را وارد کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-s, \-\-skip
.RS 4
آزمون‌هایی که باید نادیده گرفته شوند (فهرست عددی جداشده با ویرگول)\&.
.RE
.PP
\-v, \-vv, \-vvv, \-\-verbose
.RS 4
با یک
\fI\-v\fR
تنها (سطح پرگویی ۱)، فقط خروجی آزمون‌های ناموفق نمایش داده می‌شود\&. با
\fI\-vv\fR
و بالاتر، تمام خروجی‌های آزمون نشان داده خواهد شد\&.
.RE
.PP
\-S, \-\-sequential
.RS 4
اجرای همه آزمون‌ها یکی پس از دیگری\&. به‌طور پیش‌فرض آزمون‌های «انحصاری» (exclusive) به‌صورت ترتیبی اجرا می‌شوند، اما سایر آزمون‌ها برای افزایش سرعت اجرا، به‌صورت موازی اجرا می‌گردند\&.
.RE
.PP
\-r, \-\-runs\-per\-test
.RS 4
اجرای هر آزمون به تعداد دفعات مشخص‌شده، به‌طور پیش‌فرض یک‌بار\&. این گزینه می‌تواند برای تعیین اینکه آیا یک آزمون ناپایدار (flaky) است یا خیر، مفید باشد\&.
.RE
.PP
\-F, \-\-dont\-fork
.RS 4
عدم ایجاد فرایند فرزند (fork) برای هر آزمون و اجرای تمام آزمون‌ها در یک فرایند واحد؛ این کار حالت ترتیبی (sequential) را فعال می‌کند\&.
.RE
.PP
\-\-dso
.RS 4
مشخص کردن یک DSO برای آزمون «Symbols»\&.
.RE
.PP
\-w, \-\-workload=
.RS 4
اجرای یک بار کاری (workload) توکار؛ برای مشاهده فهرست آن‌ها از
\fI\-\-list\-workloads\fR
استفاده کنید، موارد فعلی عبارتند از: noploop، thloop، leafloop، sqrtloop، brstack، datasym، context_switch_loop، deterministic، named_threads و landlock\&.
.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
seconds: leafloop, noploop, sqrtloop, thloop
nrloops: brstack, context_switch_loop
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
بار کاری \*(Aqnamed_threads\*(Aq تعداد رشته‌ها و تعداد حلقه‌هایی که باید
در هر رشته انجام شود را می‌پذیرد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
بارهای کاری datasym، landlock و deterministic هیچ پارامتری نمی‌پذیرند\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-\-list\-workloads
.RS 4
فهرست کردن بارهای کاری موجود برای استفاده با \-w/\-\-workload\&.
.RE
.PP
\-\-record\-ctl=fifo:ctl\-fifo[,ack\-fifo]
.RS 4
این گزینه برای برقراری ارتباط با یک نشست perf record جهت محدود کردن دامنه ضبط تنها به بار کاری و جلوگیری از ضبط کدهای برپاسازی (setup) و پاک‌سازی (teardown) به کار می‌رود\&. هنگام مشخص کردن این گزینه، همان مسیر FIFO باید در نشست ضبط از طریق دستور زیر مشخص شود:
.sp
.if n \{\
.RS 4
.\}
.nf
perf record \-D \-1 \-\-control=fifo:ctl\-fifo[,ack\-fifo] \&.\&.\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
دستور perf test برای کنترل ضبط رویدادها، دستورهای \*(Aqenable\*(Aq و \*(Aqdisable\*(Aq را
از طریق ctl\-fifo ارسال می‌کند\&. اگر \*(Aqack\-fifo\*(Aq ارائه شده باشد، اجراکننده بار کاری
پس از هر دستور منتظر یک پاسخ \*(Aqack\*(Aq می‌ماند\&.
.fi
.if n \{\
.RE
.\}
.RE