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

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

trace-cmd reset [گزینه‌ها]

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

لطفاً توجه داشته باشید که ترتیب مشخص کردن گزینه‌ها در خط فرمان اهمیت دارد. به بخش «مثال‌ها (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 (برای نگه داشتن تمام رویدادهای پویا). این گزینه را می‌توان چندین بار برای مشخص کردن انواع مختلف رویدادهای پویا به کار برد.

بازنشانی ردیابی برای 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

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)

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

https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git

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

1.
rostedt@goodmis.org
mailto:rostedt@goodmis.org
03/09/2026 libtracefs