'\" t
.\"     Title: trace-cmd
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 03/09/2026
.\"    Manual: libtracefs Manual
.\"    Source: libtracefs
.\"  Language: Persian
.\"
.TH "TRACE\-CMD" "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 \- با ردیاب داخلی Ftrace در هستهٔ لینوکس تعامل برقرار می‌کند
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBtrace\-cmd\fR \fICOMMAND\fR [\fIOPTIONS\fR]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBtrace\-cmd\fR(1) با ردیاب Ftrace که درون هستهٔ لینوکس تعبیه شده است تعامل برقرار می‌کند\&. این دستور با فایل‌های ویژهٔ Ftrace که در سیستم‌فایل debugfs زیر دایرکتوری tracing قرار دارند ارتباط برقرار می‌کند\&. برای مشخص کردن کاری که trace\-cmd باید انجام دهد، تعیین یک \fICOMMAND\fR الزامی است\&.
.SH "فرمان‌ها (COMMANDS)"
.sp
.if n \{\
.RS 4
.\}
.nf
record  \- ضبط یک ردگیری زنده و نوشتن یک فایل trace\&.dat بر روی
          دیسک محلی یا شبکه\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
set     \- تنظیم یک پارامتر پیکربندی ftrace\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
report  \- خواندن یک فایل trace\&.dat و تبدیل داده‌های باینری به یک
          قالب متنیِ خوانای ASCII\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
stream  \- آغاز ردگیری و خواندن مستقیم خروجی
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
profile \- آغاز پروفایل‌گیری و خواندن مستقیم خروجی
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
hist    \- نمایش بافت‌نگار (هیستوگرام) رویدادها\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
stat    \- نمایش وضعیت ردگیری (ftrace) سیستم در حال اجرا
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
options \- فهرست کردن گزینه‌های افزونه که برای *report* در دسترس هستند
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
start   \- آغاز ردگیری بدون ضبط در یک فایل trace\&.dat\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
stop    \- متوقف کردن ردگیری (تنها ضبط را غیرفعال می‌کند، سربار ردیاب
          همچنان برقرار است)
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
restart \- راه‌اندازی مجدد ردگیری از توقف قبلی (تنها بر ضبط اثر می‌گذارد)
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
extract \- استخراج داده‌ها از بافر هسته و ایجاد یک فایل trace\&.dat\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
show    \- نمایش محتوای یکی از فایل‌های ردگیری Ftrace هستهٔ لینوکس
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
reset   \- تمام ردگیری‌ها را غیرفعال کرده و کارایی سیستم را برمی‌گرداند\&.
          (همهٔ داده‌ها را از بافرهای هسته پاک می‌کند)
.fi
.if n \{\
.RE
.\}.sp
.if n \{\
.RS 4
.\}
.nf
clear   \- پاک‌سازی محتوای بافرهای حلقه‌ای Ftrace\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
split   \- تقسیم یک فایل trace\&.dat به فایل‌های کوچک‌تر\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
list    \- فهرست کردن پلاگین‌ها یا رویدادهای موجود که می‌توانند ضبط شوند\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
listen  \- باز کردن یک درگاه جهت شنود اتصالات ردیابی از راه دور\&.
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
agent   \- شنود روی یک vsocket برای کلاینت‌های ردیابی
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
setup\-guest \- ایجاد FIFOها برای ردیابی VMهای مهمان
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
restore \- بازیابی فایل‌های داده حاصل از اجرای کرش‌کرده trace\-cmd record
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
snapshot\- ثبت تصویر لحظه‌ای از ردیابی در حال اجرا
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
stack   \- اجرا و نمایش ردیاب پشته
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
check\-events \- تجزیه رشته‌های قالب برای تمام رویدادهای ردیابی و بازگرداندن
               اینکه آیا تمام قالب‌ها قابل تجزیه هستند یا خیر
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
convert   \- تبدیل فایل‌های ردیابی
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
attach   \- پیوست کردن یک فایل trace\&.dat میزبان به فایل trace\&.dat مهمان
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
dump    \- خواندن فراداده‌ها (متادیتا) از یک فایل ردیابی
.fi
.if n \{\
.RE
.\}.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-h\fR, \-\-help
.RS 4
نمایش متن راهنما\&.
.RE
.sp
برای گزینه‌های دیگر، صفحهٔ راهنمای دستور متناظر را ببینید\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
trace\-cmd\-record(1), trace\-cmd\-report(1), trace\-cmd\-hist(1), trace\-cmd\-start(1), trace\-cmd\-stop(1), trace\-cmd\-extract(1), trace\-cmd\-reset(1), trace\-cmd\-restore(1), trace\-cmd\-stack(1), trace\-cmd\-convert(1), trace\-cmd\-split(1), trace\-cmd\-list(1), trace\-cmd\-listen(1), trace\-cmd\&.dat(5), trace\-cmd\-check\-events(1), trace\-cmd\-stat(1), trace\-cmd\-attach(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