TRACE-CMD-RESET(1)             libtracefs Manual            TRACE-CMD-RESET(1)

نام (NAME)
       trace-cmd-reset - غیرفعال‌سازی تمام ردیابی‌های Ftrace برای بازگرداندن
       کارایی کامل سیستم

خلاصه دستور (SYNOPSIS)
       trace-cmd reset [گزینه‌ها]

توضیحات (DESCRIPTION)
       دستور trace-cmd(1) reset تمام ردیابی‌های Ftrace را غیرفعال می‌کند. این
       کار کارایی سیستم را به وضعیت پیش از فعال شدن ردیابی بازمی‌گرداند. این
       اقدام ضروری است زیرا دستورات trace-cmd-record(1)، trace-cmd-stop(1) و
       trace-cmd-extract(1) حتی پس از واکشی داده‌ها از بافرها، ردیاب را غیرفعال
       نمی‌کنند. دلیل این امر آن است که شاید کاربر بخواهد ردیاب را به‌صورت دستی
       از طریق سیستم‌فایل مجازی Ftrace فعال کند، یا بخش‌های دیگر Ftrace را بررسی
       کند تا ببیند trace-cmd چه کاری انجام داده است. پس از اجرای دستور reset،
       داده‌های درون بافر حلقه‌ای (ring buffer) و گزینه‌های استفاده‌شده همگی پاک
       خواهند شد.

گزینه‌ها (OPTIONS)
       لطفاً توجه داشته باشید که ترتیب مشخص کردن گزینه‌ها در خط فرمان اهمیت
       دارد. به بخش «مثال‌ها (EXAMPLES)» مراجعه کنید.

       -b buffer_size
           هنگام راه‌اندازی کرنل، بافر حلقه‌ای Ftrace دارای حداقل اندازه است (۳
           صفحه به ازای هر CPU). نخستین باری که ردیاب استفاده می‌شود، اندازه
           بافر حلقه‌ای به مقدار تنظیم‌شده گسترش می‌یابد (به‌طور پیش‌فرض ۱.۴
           مگابایت به ازای هر CPU).

               اگر دیگر نیازی به ردیابی نیست، این گزینه به شما امکان می‌دهد اندازه بافر حلقه‌ای را
               کاهش دهید تا حافظه در دسترس آزاد شود.

               trace-cmd reset -b 1

               نمونه بافر (یا بافرهایی) که تحت تأثیر قرار می‌گیرند با نزدیک‌ترین گزینه قبلی
               *-B*، *-t* یا *-a* مشخص می‌شوند:

               در صورت استفاده پس از *-B*، اندازه نمونه بافری را تغییر می‌دهد که پیش از آن در
               خط فرمان آمده است.

               در صورت استفاده پس از *-a*، اندازه تمام نمونه‌های بافر به‌جز نمونه سطح بالا را تغییر می‌دهد.

               در صورت استفاده پس از *-t* یا پیش از هر گزینه *-B* یا *-a*، اندازه نمونه سطح بالا
               را تغییر می‌دهد.

       -B buffer-name
           اگر کرنل از چندین بافر پشتیبانی کند، این گزینه ردیابی را فقط برای
           بافر داده‌شده بازنشانی می‌کند. این دستور بر هیچ بافر دیگری تأثیر
           نمی‌گذارد. این گزینه را می‌توان چندین بار برای مشخص کردن بافرهای
           مختلف استفاده کرد. در صورت تعیین این گزینه، بافر سطح بالا بازنشانی
           نخواهد شد (مگر اینکه گزینه -t نیز ارائه شده باشد).

       -a
           ردیابی را برای تمام نمونه‌های موجود بافر بازنشانی می‌کند. هنگام
           استفاده از این گزینه، نمونه سطح بالا بازنشانی نخواهد شد مگر اینکه
           گزینه -t مشخص شده باشد.

       -d
           این گزینه بافر(های) نمونه مشخص‌شده توسط نزدیک‌ترین گزینه قبلی -B یا
           -a را حذف می‌کند. از آنجا که بافر نمونه سطح بالا قابل حذف نیست،
           استفاده از این گزینه بلافاصله پس از -t یا پیش از هر گزینه -B یا -a
           در خط فرمان نامعتبر است.

       -t
           بافر نمونه سطح بالا را بازنشانی می‌کند. بدون گزینه -B یا -a این
           رفتار همانند حالت پیش‌فرض است. اما اگر -B یا -a استفاده شده باشد، در
           صورتی که بافر نمونه سطح بالا نیز باید بازنشانی شود، درج این گزینه
           الزامی است.

       -k dynevent-name
           این گزینه امکان حفظ رویدادهای پویای مشخص‌شده را هنگام بازنشانی فراهم
           می‌کند. پارامترهای معتبر عبارتند از: kprobe، kretprobe، uprobe،
           uretprobe، eprobe، synth و all (برای نگه داشتن تمام رویدادهای
           پویا). این گزینه را می‌توان چندین بار برای مشخص کردن انواع مختلف
           رویدادهای پویا به کار برد.

مثال‌ها (EXAMPLES)
       بازنشانی ردیابی برای instance-one و تنظیم اندازه بافر به ازای هر
       پردازنده روی 4096kb. همچنین نمونه instance-two را حذف می‌کند. نمونه سطح
       بالا و هر نمونه دیگر دست‌نخورده باقی می‌مانند:

           trace-cmd reset -B instance-one -b 4096 -B instance-two -d

       حذف تمام بافرهای نمونه. نمونه سطح بالا بدون تغییر باقی می‌ماند:

           trace-cmd reset -a -d

       حذف تمام بافرهای نمونه و همچنین بازنشانی نمونه سطح بالا:

           trace-cmd reset -t -a -d

       نامعتبر. این دستور نشان‌دهنده تلاشی برای حذف نمونه سطح بالا است:

           trace-cmd reset -a -t -d

       بازنشانی نمونه سطح بالا و تنظیم اندازه بافر به ازای هر پردازنده روی
       1024kb. در صورت وجود هرگونه بافر نمونه، آنها دست‌نخورده باقی می‌مانند:

           trace-cmd reset -b 1024

       جلوگیری از نابودی kprobes و kretprobes در حین بازنشانی:

           trace-cmd reset -k kprobe -k kretprobe

همچنین ببینید (SEE ALSO)
       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)

نویسنده (AUTHOR)
       نوشته‌شده توسط Steven Rostedt، <rostedt@goodmis.org[1]>

منابع (RESOURCES)
       https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git

کپی‌رایت و تکثیر (COPYING)
       کپی‌رایت (C) 2010 Red Hat, Inc. استفاده آزاد از این نرم‌افزار تحت شرایط
       مجوز عمومی همگانی گنو (GPL) مجاز است.

نکات (NOTES)
        1. rostedt@goodmis.org
           mailto:rostedt@goodmis.org

libtracefs                        03/09/2026                TRACE-CMD-RESET(1)