'\" t
.\"     Title: perf-data
.\"    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\-DATA" "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-data \- پردازش‌های مربوط به فایل داده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIperf data\fR [<common options>] <command> [<options>]",
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
پردازش‌های مربوط به فایل داده\&.
.SH "دستورها (COMMANDS)"
.PP
convert
.RS 4
فایل دادهٔ perf را به قالب دیگری تبدیل می‌کند\&. این امکان وجود دارد که متغیر اشکال‌زدایی data\-convert را برای دریافت پیام‌های اشکال‌زدایی مربوط به تبدیل مقداردهی کنید؛ مانند: perf \-\-debug data\-convert data convert \&...
.RE
.SH "گزینه‌های \FICONVERT\FR (OPTIONS FOR \FICONVERT\FR)"
.PP
\-\-to\-ctf
.RS 4
تبدیل CTF را فعال می‌کند؛ مسیر دایرکتوری داده‌های CTF را مشخص کنید\&.
.RE
.PP
\-\-to\-json
.RS 4
تبدیل JSON را فعال می‌کند\&. نام فایل خروجی JSON را مشخص کنید\&.
.RE
.PP
\-\-tod
.RS 4
تبدیل زمان به زمان واقعی سیستم (wall clock time)\&.
.RE
.PP
\-i
.RS 4
مسیر فایل دادهٔ perf ورودی را مشخص کنید\&.
.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
برای نمونه:
انتخاب دومین برش زمانی ۱۰ درصدی:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
perf data convert \-\-to\-json out\&.json \-\-time 10%/2
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
انتخاب برش زمانی از ۰٪ تا ۱۰٪:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
perf data convert \-\-to\-json out\&.json \-\-time 0%\-10%
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
انتخاب برش‌های زمانی ۱۰ درصدیِ اول و دوم:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
perf data convert \-\-to\-json out\&.json \-\-time 10%/1,10%/2
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
انتخاب برش‌های زمانی ۰٪ تا ۱۰٪ و ۳۰٪ تا ۴۰٪:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
perf data convert \-\-to\-json out\&.json \-\-time 0%\-10%,30%\-40%
.fi
.if n \{\
.RE
.\}
.RE
.PP
\-v, \-\-verbose
.RS 4
اطلاعات با جزئیات بیشتر نمایش داده شوند (نمایش خطاهای باز کردن شمارنده و غیره)\&.
.RE
.PP
\-\-all
.RS 4
همهٔ رویدادها، از جمله رویدادهای غیرنمونه‌ای (comm، fork و غیره) به خروجی تبدیل شوند\&. پیش‌فرض غیرفعال است؛ تنها نمونه‌ها تبدیل می‌شوند\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBperf\fR(1) [1] Common Trace Format \- \m[blue]\fBhttp://www\&.efficios\&.com/ctf\fR\m[]