'\" t .\" Title: trace-cmd-show .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 03/09/2026 .\" Manual: libtracefs Manual .\" Source: libtracefs .\" Language: English .\" .TH "TRACE\-CMD\-SHOW" "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-show \- نمایش محتویات بافر ردگیری هسته لینوکس Ftrace\&. .SH "خلاصه دستور (SYNOPSIS)" .sp \fBtrace\-cmd show\fR [\fIOPTIONS\fR] .SH "توضیحات (DESCRIPTION)" .sp دستور trace\-cmd(1) show محتویات یکی از فایل‌های ردگیری هسته لینوکس Ftrace یعنی trace، snapshot، یا trace_pipe را نمایش می‌دهد\&. این کار در اصل معادل اجرای دستور زیر است: .sp .if n \{\ .RS 4 .\} .nf cat /sys/kernel/debug/tracing/trace .fi .if n \{\ .RE .\} .SH "گزینه‌ها (OPTIONS)" .PP \fB\-p\fR .RS 4 به جای نمایش محتویات فایل "trace"، از فایل "trace_pipe" استفاده می‌کند\&. تفاوت میان این دو در این است که فایل "trace" ایستا است؛ بدین معنا که اگر ردگیری متوقف شود، فایل "trace" هر بار همان محتویات را نشان خواهد داد\&. .sp .if n \{\ .RS 4 .\} .nf فایل "trace_pipe" یک خواندنِ مصرف‌کننده است؛ بدین معنی که خواندن فایل، خروجی داده‌های خوانده‌شده را مصرف می‌کند و حتی در صورت توقف ردگیری، همان داده برای بار دوم خوانده نخواهد شد\&. همچنین این فایل مسدودکننده خواهد بود؛ اگر داده‌ای در دسترس نباشد، trace\-cmd show متوقف شده و منتظر ظاهر شدن داده‌ها می‌ماند\&. .fi .if n \{\ .RE .\} .RE .PP \fB\-s\fR .RS 4 به جای خواندن فایل "trace"، فایل snapshot را می‌خواند\&. اسنپ‌شات با نوشتن یک برنامه در آن ایجاد می‌شود و هسته یک جابه‌جایی (swap) میان بافر فعال فعلی و بافر اسنپ‌شات فعلی انجام می‌دهد\&. اگر جابه‌جایی دیگری صورت نگیرد، اسنپ‌شات ایستا باقی می‌ماند\&. این یک خواندن مصرف‌کننده نیست\&. .RE .PP \fB\-c\fR \fIcpu\fR .RS 4 تنها فایل ردگیری مربوط به یک CPU مشخص را می‌خواند\&. .RE .PP \fB\-f\fR .RS 4 مسیر کامل فایلی که در حال نمایش است را نشان می‌دهد\&. .RE .PP \fB\-B\fR \fIbuf\fR .RS 4 اگر یک نمونه بافر (buffer instance) ایجاد شده باشد، گزینه \fB\-B\fR به فایل‌های مرتبط با بافر داده‌شده دسترسی پیدا می‌کند\&. .RE .PP \fB\-\-tracing_on\fR .RS 4 نشان می‌دهد که آیا ردگیری برای نمونه داده‌شده فعال است یا خیر\&. .RE .PP \fB\-\-current_tracer\fR .RS 4 ردگیر (tracer) فعلی را نشان می‌دهد\&. .RE .PP \fB\-\-buffer_size\fR .RS 4 اندازه فعلی بافر را نشان می‌دهد (به ازای هر cpu)\&. .RE .PP \fB\-\-buffer_total_size\fR .RS 4 اندازه کل تمام بافرها را نشان می‌دهد\&. .RE .PP \fB\-\-buffer_subbuf_size\fR .RS 4 اندازه زیربافرهای بافر حلقه‌ای (ring buffer) را بر حسب کیلوبایت نشان می‌دهد\&. بافر حلقه‌ای به زیربافرهای هم‌اندازه‌ای تقسیم می‌شود که در آن یک رویداد تنها می‌تواند به اندازه بخش داده زیربافر (اندازه منهای فراداده آن) باشد\&. .RE .PP \fB\-\-buffer_percent\fR .RS 4 درصدی از پر بودن بافر را نشان می‌دهد که پس از آن، خواننده‌ای که روی فایل trace_pipe_raw مسدود شده است بیدار خواهد شد\&. .sp .if n \{\ .RS 4 .\} .nf 0 : بیدار شدن فوری با هر داده جدید 1 \- 99 : بیدار شدن پس از پر شدن این درصد از زیربافرها 100 : بیدار شدن پس از پر شدن کامل بافر و هنگامی که نویسنده در آخرین زیربافر است .fi .if n \{\ .RE .\} .RE .PP \fB\-\-ftrace_filter\fR .RS 4 فیلترهای توابع تنظیم‌شده را نشان می‌دهد\&. .RE .PP \fB\-\-ftrace_notrace\fR .RS 4 فیلترهای غیرفعال‌سازی توابع تنظیم‌شده را نشان می‌دهد\&. .RE .PP \fB\-\-ftrace_pid\fR .RS 4 شناسه‌های فرایندی (PID) که ردگیر توابع به آن‌ها محدود شده است را (در صورت وجود) نشان می‌دهد\&. .RE .PP \fB\-\-graph_function\fR .RS 4 توابعی که نمودار آن‌ها ترسیم خواهد شد را نشان می‌دهد\&. .RE .PP \fB\-\-graph_notrace\fR .RS 4 توابعی که نمودار آن‌ها ترسیم نخواهد شد را نشان می‌دهد\&. .RE .PP \fB\-\-hist\fR \fI[system:]event\fR .RS 4 محتوای فایل هیستوگرام "hist" را برای یک رویداد مشخص نشان می‌دهد\&. .RE .PP \fB\-\-trigger\fR \fI[system:]event\fR .RS 4 محتوای فایل راه‌انداز "trigger" را برای یک رویداد مشخص نشان می‌دهد\&. .RE .PP \fB\-\-cpumask\fR .RS 4 ماسک CPUهایی که ردگیری روی آن‌ها انجام خواهد شد را نشان می‌دهد\&. .RE .SH "همچنین ببینید (SEE ALSO)" .sp 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) .SH "نویسندگان (AUTHORS)" .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 "کپی‌رایت و تکثیر (COPYRIGHT)" .sp حق نشر (C) 2010 متعلق به Red Hat, Inc\&. استفاده رایگان از این نرم‌افزار تحت شرایط مجوز عمومی همگانی گنو (GPL) مجاز است\&. .SH "نکات (NOTES)" .IP " 1." 4 rostedt@goodmis.org .RS 4 \%mailto:rostedt@goodmis.org .RE