'\" t
.\"     Title: trace-cmd-reset
.\"    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\-RESET" "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\-reset \- غیرفعال‌سازی تمام ردیابی‌های Ftrace برای بازگرداندن کارایی کامل سیستم
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBtrace\-cmd reset\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBtrace\-cmd(1) reset\fR تمام ردیابی‌های Ftrace را غیرفعال می‌کند\&. این کار کارایی سیستم را به وضعیت پیش از فعال شدن ردیابی بازمی‌گرداند\&. این اقدام ضروری است زیرا دستورات \fItrace\-cmd\-record(1)\fR، \fItrace\-cmd\-stop(1)\fR و \fItrace\-cmd\-extract(1)\fR حتی پس از واکشی داده‌ها از بافرها، ردیاب را غیرفعال نمی‌کنند\&. دلیل این امر آن است که شاید کاربر بخواهد ردیاب را به‌صورت دستی از طریق سیستم‌فایل مجازی Ftrace فعال کند، یا بخش‌های دیگر Ftrace را بررسی کند تا ببیند trace\-cmd چه کاری انجام داده است\&. پس از اجرای دستور reset، داده‌های درون بافر حلقه‌ای (ring buffer) و گزینه‌های استفاده‌شده همگی پاک خواهند شد\&.
.SH "گزینه‌ها (OPTIONS)"
.sp
لطفاً توجه داشته باشید که ترتیب مشخص کردن گزینه‌ها در خط فرمان اهمیت دارد\&. به بخش «مثال‌ها (EXAMPLES)» مراجعه کنید\&.
.PP
\fB\-b\fR \fIbuffer_size\fR
.RS 4
هنگام راه‌اندازی کرنل، بافر حلقه‌ای Ftrace دارای حداقل اندازه است (۳ صفحه به ازای هر CPU)\&. نخستین باری که ردیاب استفاده می‌شود، اندازه بافر حلقه‌ای به مقدار تنظیم‌شده گسترش می‌یابد (به‌طور پیش‌فرض ۱\&.۴ مگابایت به ازای هر CPU)\&.
.sp
.if n \{\
.RS 4
.\}
.nf
اگر دیگر نیازی به ردیابی نیست، این گزینه به شما امکان می‌دهد اندازه بافر حلقه‌ای را
کاهش دهید تا حافظه در دسترس آزاد شود\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd reset \-b 1
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
نمونه بافر (یا بافرهایی) که تحت تأثیر قرار می‌گیرند با نزدیک‌ترین گزینه قبلی
*\-B*، *\-t* یا *\-a* مشخص می‌شوند:
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
در صورت استفاده پس از *\-B*، اندازه نمونه بافری را تغییر می‌دهد که پیش از آن در
خط فرمان آمده است\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
در صورت استفاده پس از *\-a*، اندازه تمام نمونه‌های بافر به‌جز نمونه سطح بالا را تغییر می‌دهد\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
در صورت استفاده پس از *\-t* یا پیش از هر گزینه *\-B* یا *\-a*، اندازه نمونه سطح بالا
را تغییر می‌دهد\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-B\fR \fIbuffer\-name\fR
.RS 4
اگر کرنل از چندین بافر پشتیبانی کند، این گزینه ردیابی را فقط برای بافر داده‌شده بازنشانی می‌کند\&. این دستور بر هیچ بافر دیگری تأثیر نمی‌گذارد\&. این گزینه را می‌توان چندین بار برای مشخص کردن بافرهای مختلف استفاده کرد\&. در صورت تعیین این گزینه، بافر سطح بالا بازنشانی نخواهد شد (مگر اینکه گزینه
\fB\-t\fR
نیز ارائه شده باشد)\&.
.RE
.PP
\fB\-a\fR
.RS 4
ردیابی را برای تمام نمونه‌های موجود بافر بازنشانی می‌کند\&. هنگام استفاده از این گزینه، نمونه سطح بالا بازنشانی نخواهد شد مگر اینکه گزینه
\fB\-t\fR
مشخص شده باشد\&.
.RE
.PP
\fB\-d\fR
.RS 4
این گزینه بافر(های) نمونه مشخص‌شده توسط نزدیک‌ترین گزینه قبلی
\fB\-B\fR
یا
\fB\-a\fR
را حذف می‌کند\&. از آنجا که بافر نمونه سطح بالا قابل حذف نیست، استفاده از این گزینه بلافاصله پس از
\fB\-t\fR
یا پیش از هر گزینه
\fB\-B\fR
یا
\fB\-a\fR
در خط فرمان نامعتبر است\&.
.RE
.PP
\fB\-t\fR
.RS 4
بافر نمونه سطح بالا را بازنشانی می‌کند\&. بدون گزینه
\fB\-B\fR
یا
\fB\-a\fR
این رفتار همانند حالت پیش‌فرض است\&. اما اگر
\fB\-B\fR
یا
\fB\-a\fR
استفاده شده باشد، در صورتی که بافر نمونه سطح بالا نیز باید بازنشانی شود، درج این گزینه الزامی است\&.
.RE
.PP
\fB\-k\fR \fIdynevent\-name\fR
.RS 4
این گزینه امکان حفظ رویدادهای پویای مشخص‌شده را هنگام بازنشانی فراهم می‌کند\&. پارامترهای معتبر عبارتند از:
\fBkprobe\fR،
\fBkretprobe\fR،
\fBuprobe\fR،
\fBuretprobe\fR،
\fBeprobe\fR،
\fBsynth\fR
و
\fBall\fR
(برای نگه داشتن تمام رویدادهای پویا)\&. این گزینه را می‌توان چندین بار برای مشخص کردن انواع مختلف رویدادهای پویا به کار برد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
بازنشانی ردیابی برای instance\-one و تنظیم اندازه بافر به ازای هر پردازنده روی 4096kb\&. همچنین نمونه instance\-two را حذف می‌کند\&. نمونه سطح بالا و هر نمونه دیگر دست‌نخورده باقی می‌مانند:
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd reset \-B instance\-one \-b 4096 \-B instance\-two \-d
.fi
.if n \{\
.RE
.\}
.sp
حذف تمام بافرهای نمونه\&. نمونه سطح بالا بدون تغییر باقی می‌ماند:
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd reset \-a \-d
.fi
.if n \{\
.RE
.\}
.sp
حذف تمام بافرهای نمونه و همچنین بازنشانی نمونه سطح بالا:
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd reset \-t \-a \-d
.fi
.if n \{\
.RE
.\}
.sp
نامعتبر\&. این دستور نشان‌دهنده تلاشی برای حذف نمونه سطح بالا است:
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd reset \-a \-t \-d
.fi
.if n \{\
.RE
.\}
.sp
بازنشانی نمونه سطح بالا و تنظیم اندازه بافر به ازای هر پردازنده روی 1024kb\&. در صورت وجود هرگونه بافر نمونه، آنها دست‌نخورده باقی می‌مانند:
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd reset \-b 1024
.fi
.if n \{\
.RE
.\}
.sp
جلوگیری از نابودی \fBkprobes\fR و \fBkretprobes\fR در حین بازنشانی:
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd reset \-k kprobe \-k kretprobe
.fi
.if n \{\
.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\-split(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