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

trace-cmd-show - نمایش محتویات بافر ردگیری هسته لینوکس Ftrace.

trace-cmd show [OPTIONS]

دستور trace-cmd(1) show محتویات یکی از فایل‌های ردگیری هسته لینوکس Ftrace یعنی trace، snapshot، یا trace_pipe را نمایش می‌دهد. این کار در اصل معادل اجرای دستور زیر است:

cat /sys/kernel/debug/tracing/trace

-p

به جای نمایش محتویات فایل "trace"، از فایل "trace_pipe" استفاده می‌کند. تفاوت میان این دو در این است که فایل "trace" ایستا است؛ بدین معنا که اگر ردگیری متوقف شود، فایل "trace" هر بار همان محتویات را نشان خواهد داد.
فایل "trace_pipe" یک خواندنِ مصرف‌کننده است؛ بدین معنی که خواندن فایل،
خروجی داده‌های خوانده‌شده را مصرف می‌کند و حتی در صورت توقف ردگیری،
همان داده برای بار دوم خوانده نخواهد شد. همچنین این فایل مسدودکننده
خواهد بود؛ اگر داده‌ای در دسترس نباشد، trace-cmd show متوقف شده
و منتظر ظاهر شدن داده‌ها می‌ماند.

-s

به جای خواندن فایل "trace"، فایل snapshot را می‌خواند. اسنپ‌شات با نوشتن یک برنامه در آن ایجاد می‌شود و هسته یک جابه‌جایی (swap) میان بافر فعال فعلی و بافر اسنپ‌شات فعلی انجام می‌دهد. اگر جابه‌جایی دیگری صورت نگیرد، اسنپ‌شات ایستا باقی می‌ماند. این یک خواندن مصرف‌کننده نیست.

-c cpu

تنها فایل ردگیری مربوط به یک CPU مشخص را می‌خواند.

-f

مسیر کامل فایلی که در حال نمایش است را نشان می‌دهد.

-B buf

اگر یک نمونه بافر (buffer instance) ایجاد شده باشد، گزینه -B به فایل‌های مرتبط با بافر داده‌شده دسترسی پیدا می‌کند.

--tracing_on

نشان می‌دهد که آیا ردگیری برای نمونه داده‌شده فعال است یا خیر.

--current_tracer

ردگیر (tracer) فعلی را نشان می‌دهد.

--buffer_size

اندازه فعلی بافر را نشان می‌دهد (به ازای هر cpu).

--buffer_total_size

اندازه کل تمام بافرها را نشان می‌دهد.

--buffer_subbuf_size

اندازه زیربافرهای بافر حلقه‌ای (ring buffer) را بر حسب کیلوبایت نشان می‌دهد. بافر حلقه‌ای به زیربافرهای هم‌اندازه‌ای تقسیم می‌شود که در آن یک رویداد تنها می‌تواند به اندازه بخش داده زیربافر (اندازه منهای فراداده آن) باشد.

--buffer_percent

درصدی از پر بودن بافر را نشان می‌دهد که پس از آن، خواننده‌ای که روی فایل trace_pipe_raw مسدود شده است بیدار خواهد شد.
0       : بیدار شدن فوری با هر داده جدید
1 - 99  : بیدار شدن پس از پر شدن این درصد از زیربافرها
100     : بیدار شدن پس از پر شدن کامل بافر و هنگامی که نویسنده در آخرین زیربافر است

--ftrace_filter

فیلترهای توابع تنظیم‌شده را نشان می‌دهد.

--ftrace_notrace

فیلترهای غیرفعال‌سازی توابع تنظیم‌شده را نشان می‌دهد.

--ftrace_pid

شناسه‌های فرایندی (PID) که ردگیر توابع به آن‌ها محدود شده است را (در صورت وجود) نشان می‌دهد.

--graph_function

توابعی که نمودار آن‌ها ترسیم خواهد شد را نشان می‌دهد.

--graph_notrace

توابعی که نمودار آن‌ها ترسیم نخواهد شد را نشان می‌دهد.

--hist [system:]event

محتوای فایل هیستوگرام "hist" را برای یک رویداد مشخص نشان می‌دهد.

--trigger [system:]event

محتوای فایل راه‌انداز "trigger" را برای یک رویداد مشخص نشان می‌دهد.

--cpumask

ماسک CPUهایی که ردگیری روی آن‌ها انجام خواهد شد را نشان می‌دهد.

trace-cmd(1), trace-cmd-record(1), trace-cmd-report(1), trace-cmd-start(1), trace-cmd-extract(1), trace-cmd-reset(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