'\" t
.\"     Title: perf-check
.\"    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\-CHECK" "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-check \- بررسی وجود قابلیت‌ها در perf
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIperf check\fR [<options>]
\fIperf check\fR {feature <feature_list>} [<options>]
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
در صورت عدم ارائه هیچ زیرفرمانی، دستور \fIperf check\fR صرفاً نحوه استفاده از دستور را در خروجی استاندارد چاپ می‌کند\&.
.sp
اگر زیرفرمان \fIfeature\fR استفاده شود، وضعیت قابلیت در خروجی استاندارد چاپ می‌شود (مگر اینکه \fI\-q\fR نیز مشخص شده باشد)، یعنی اینکه آیا به صورت درون‌ساخت/کامپایل‌شده (compiled\-in/built\-in) وجود دارد یا خیر\&. همچنین، در صورتی که قابلیت به صورت درون‌ساخت موجود باشد، \fIperf check feature\fR با وضعیت خروج 0 بازمی‌گردد، در غیر این صورت با وضعیت خروج 1 خاتمه می‌یابد\&.
.SH "زیرفرمان‌ها (SUBCOMMANDS)"
.PP
feature
.RS 4
چاپ وضعیت کامپایل بودن یا نبودن قابلیت(ها)؛ همچنین در صورتی که قابلیت(های) داده شده کامپایل شده باشند، وضعیت خروج 0 و در غیر این صورت 1 را بازمی‌گرداند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
این دستور فهرستی از قابلیت‌ها را به عنوان آرگومان می‌پذیرد\&.
می‌توان یک نام/ماکروی قابلیت منفرد، یا چندین قابلیت را به صورت
فهرستی جدا شده با کاما ارسال کرد؛ در این حالت وضعیت خروج تنها زمانی 0
خواهد بود که تمام قابلیت‌های ارسال‌شده کامپایل شده باشند\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
نام‌ها/ماکروهای قابلیت‌ها به حروف کوچک و بزرگ حساس نیستند (case\-insensitive)\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
مثال‌های استفاده:
        perf check feature libtraceevent
        perf check feature HAVE_LIBTRACEEVENT
        perf check feature libtraceevent,bpf
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
نام‌ها/ماکروهای قابلیت‌های پشتیبانی‌شده:
        aio                     /  HAVE_AIO_SUPPORT
        bpf                     /  HAVE_LIBBPF_SUPPORT
        bpf_skeletons           /  HAVE_BPF_SKEL
        debuginfod              /  HAVE_DEBUGINFOD_SUPPORT
        dwarf                   /  HAVE_LIBDW_SUPPORT
        dwarf_getlocations      /  HAVE_LIBDW_SUPPORT
        dwarf\-unwind            /  HAVE_DWARF_UNWIND_SUPPORT
        libbfd                  /  HAVE_LIBBFD_SUPPORT
        libbpf\-strings          /  HAVE_LIBBPF_STRINGS_SUPPORT
        libcapstone             /  HAVE_LIBCAPSTONE_SUPPORT
        libdw\-dwarf\-unwind      /  HAVE_LIBDW_SUPPORT
        libelf                  /  HAVE_LIBELF_SUPPORT
        libLLVM                 /  HAVE_LIBLLVM_SUPPORT
        libnuma                 /  HAVE_LIBNUMA_SUPPORT
        libopencsd              /  HAVE_CSTRACE_SUPPORT
        libperl                 /  HAVE_LIBPERL_SUPPORT
        libpfm4                 /  HAVE_LIBPFM
        libpython               /  HAVE_LIBPYTHON_SUPPORT
        libslang                /  HAVE_SLANG_SUPPORT
        libtraceevent           /  HAVE_LIBTRACEEVENT
        libunwind               /  HAVE_LIBUNWIND_SUPPORT
        lzma                    /  HAVE_LZMA_SUPPORT
        numa_num_possible_cpus  /  HAVE_LIBNUMA_SUPPORT
        zlib                    /  HAVE_ZLIB_SUPPORT
        zstd                    /  HAVE_ZSTD_SUPPORT
.fi
.if n \{\
.RE
.\}
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\-q, \-\-quiet
.RS 4
عدم چاپ هرگونه پیام یا هشدار\&.
.sp
.if n \{\
.RS 4
.\}
.nf
از این گزینه می‌توان همراه با زیرفرمان‌هایی مانند \*(Aqperf check feature\*(Aq
جهت مخفی‌سازی خروجی‌های غیرضروری در اسکریپت‌های آزمایشی استفاده کرد، مانند:
\*(Aqperf check feature \-\-quiet libtraceevent\*(Aq
.fi
.if n \{\
.RE
.\}
.RE