'\" t
.\"     Title: trace-cmd-split
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 03/09/2026
.\"    Manual: libtracefs Manual
.\"    Source: libtracefs
.\"  Language: English
.\"
.TH "TRACE\-CMD\-SPLIT" "1" "03/09/2026" "libtracefs" "libtracefs 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)"
trace-cmd-split \- تقسیم یک فایل trace\&.dat به فایل‌های کوچک‌تر
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBtrace\-cmd split\fR [\fIOPTIONS\fR] [\fIstart\-time\fR [\fIend\-time\fR]]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور trace\-cmd(1) split برای تقسیم یک فایل trace\&.dat به فایل‌های کوچک‌تر استفاده می‌شود\&. مقدار \fIstart\-time\fR نقطه‌ای را که فایل جدید از آنجا آغاز خواهد شد، مشخص می‌کند\&. با استفاده از \fItrace\-cmd\-report(1)\fR و کپی کردن برچسب زمانی ارائه‌شده در یک رویداد خاص، می‌توان از آن به عنوان ورودی برای \fIstart\-time\fR یا \fIend\-time\fR استفاده کرد\&. عملیات تقسیم به محض رسیدن به رویدادی پس از \fIend\-time\fR متوقف خواهد شد\&. اگر تنها به end\-time نیاز باشد، از 0\&.0 به عنوان start\-time استفاده کنید\&.
.sp
اگر start\-time مشخص نشود، عملیات تقسیم از ابتدای فایل شروع خواهد شد\&. اگر end\-time مشخص نشود، تقسیم تا انتهای فایل ادامه خواهد یافت مگر اینکه یکی از شرایط تعیین‌شده توسط گزینه‌ها برآورده شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-i\fR \fIfile\fR
.RS 4
اگر این گزینه مشخص نشود، دستور split به دنبال فایلی به نام
\fItrace\&.dat\fR می‌گردد\&. این گزینه امکان خواندن فایلی غیر از
\fItrace\&.dat\fR را فراهم می‌کند\&.
.RE
.PP
\fB\-o\fR \fIfile\fR
.RS 4
به‌طور پیش‌فرض، دستور split از نام فایل ورودی به عنوان مبنایی برای نام‌گذاری فایل‌های تقسیم‌شده استفاده می‌کند\&. نام فایل خروجی همان نام فایل ورودی خواهد بود که عبارت \*(Aq\&.#\e\*(Aq به انتهای آن اضافه شده است: trace\&.dat\&.1، trace\&.dat\&.2 و غیره\&.
.sp
.if n \{\
.RS 4
.\}
.nf
این گزینه نام فایل پایه مورد استفاده را تغییر می‌دهد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\-o file  فایل‌های file\&.1، file\&.2 و غیره را ایجاد خواهد کرد\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-s\fR \fIseconds\fR
.RS 4
مشخص می‌کند پیش از توقف فایل جدید، چند ثانیه باید ضبط شود\&.
.RE
.PP
\fB\-m\fR \fImilliseconds\fR
.RS 4
مشخص می‌کند پیش از توقف فایل جدید، چند میلی‌ثانیه باید ضبط شود\&.
.RE
.PP
\fB\-u\fR \fImicroseconds\fR
.RS 4
مشخص می‌کند پیش از توقف فایل جدید، چند میکروثانیه باید ضبط شود\&.
.RE
.PP
\fB\-e\fR \fIevents\fR
.RS 4
مشخص می‌کند پیش از توقف فایل جدید، چند رویداد باید ضبط شود\&.
.RE
.PP
\fB\-p\fR \fIpages\fR
.RS 4
تعداد صفحاتی را که باید پیش از توقف فایل جدید ضبط شوند مشخص می‌کند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
نکته: در یک زمان تنها یکی از گزینه‌های *\-p*، *\-e*، *\-u*، *\-m* یا *\-s* می‌تواند مشخص شود\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
اگر *\-p* مشخص شود، *\-c* به‌طور خودکار تنظیم می‌شود\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-r\fR
.RS 4
این گزینه باعث می‌شود تقسیم تکرار شود تا زمانی که به end\-time برسد (یا در صورت عدم تعیین end\-time، به انتهای ورودی برسد)\&.
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd split \-r \-e 10000
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
این دستور trace\&.dat را به چندین فایل کوچک‌تر تقسیم می‌کند که هرکدام
حداکثر شامل 10,000 رویداد خواهند بود\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-c\fR
.RS 4
این گزینه باعث می‌شود تقسیمِ فوق به ازای هر CPU انجام شود\&.
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd split \-c \-p 10
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
این دستور فایلی ایجاد می‌کند که به ازای هر CPU از ورودی، ۱۰ صفحه دارد\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-C\fR \fIcpu\fR
.RS 4
این گزینه تقسیم را برای یک CPU منفرد انجام می‌دهد\&. تنها پردازنده‌ی مشخص‌شده از فایل استخراج خواهد شد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd split \-C 1
.fi
.if n \{\
.RE
.\}
.RE.sp
.if n \{\
.RS 4
.\}
.nf
این دستور تمام رویدادهای مربوط به cpu 1 را در فایل تفکیک می‌کند\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-\-top\fR
.RS 4
این گزینه امکان نگه‌داشتن بافر بالا را فراهم می‌کند\&. بافر بالا را می‌توان با استفاده از گزینهٔ
\fI\-b\fR
تغییر نام داد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd split \-\-top
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
این دستور تنها بافر بالا را نگه می‌دارد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd split \-\-top \-b old_top
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
این دستور تنها بافر بالا را نگه می‌دارد و نام آن را به \*(Aqold_top\*(Aq تغییر می‌دهد\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-B\fR \fIbuffer\fR
.RS 4
این گزینه امکان نگه‌داشتن بافر انتخاب‌شده را فراهم می‌کند\&. یک بافر را می‌توان با استفاده از گزینهٔ
\fI\-t\fR
به بافر بالا ارتقا داد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd split \-B timer \-B sched
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
این دستور بافرهای \*(Aqtimer\*(Aq و \*(Aqsched\*(Aq را نگه می‌دارد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd split \-B timer \-t \-B sched
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
این دستور بافرهای \*(Aqtimer\*(Aq و \*(Aqsched\*(Aq را نگه می‌دارد، به‌طوری که رویدادهای
بافر \*(Aqtimer\*(Aq به نمونهٔ بالا ارتقا می‌یابند\&.
.fi
.if n \{\
.RE
.\}
.RE.SH "همچنین ببینید (SEE ALSO)"
.sp
trace\-cmd(1), trace\-cmd\-record(1), trace\-cmd\-report(1), trace\-cmd\-start(1), trace\-cmd\-stop(1), trace\-cmd\-extract(1), trace\-cmd\-reset(1), trace\-cmd\-list(1), trace\-cmd\-listen(1)
.SH "نویسنده (AUTHOR)"
.sp
نوشته‌شده توسط Steven Rostedt، <\m[blue]\fBrostedt@goodmis\&.org\fR\m[]\&\s-2\u[1]\d\s+2>
.SH "منابع (RESOURCES)"
.sp
\m[blue]\fBhttps://git\&.kernel\&.org/pub/scm/utils/trace\-cmd/trace\-cmd\&.git\fR\m[]
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
کپی‌رایت (C) 2010 متعلق به Red Hat, Inc\&. استفاده آزاد از این نرم‌افزار تحت شرایط «مجوز عمومی همگانی گنو» (GPL) مجاز است\&.
.SH "نکات (NOTES)"
.IP " 1." 4
rostedt@goodmis.org
.RS 4
\%mailto:rostedt@goodmis.org
.RE