'\" t
.\"     Title: trace-cmd-restore
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 03/09/2026
.\"    Manual: libtracefs Manual
.\"    Source: libtracefs
.\"  Language: English
.\"
.TH "TRACE\-CMD\-RESTORE" "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-restore \- بازیابی یک ضبط ردگیری ناموفق
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBtrace\-cmd restore\fR [\fIOPTIONS\fR] [\fIcommand\fR] cpu\-file [cpu\-file \&...]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور trace\-cmd(1) restore یک فایل حاصل از اجرای کرش‌کردهٔ trace\-cmd\-record(1) را بازیابی می‌کند\&. اگر به هر دلیلی یک trace\-cmd record با شکست مواجه شود، فایل‌های دادهٔ per\-cpu را بر جای گذاشته و فایل نهایی trace\&.dat را ایجاد نمی‌کند\&. دستور trace\-cmd restore این فایل‌ها را به یکدیگر پیوست می‌کند تا یک فایل trace\&.dat سالم ایجاد کند که با trace\-cmd\-report(1) قابل خواندن باشد\&.
.sp
هنگامی که trace\-cmd record اجرا می‌شود، به ازای هر CPU یک فرآیند ایجاد کرده و در فایلی مختص هر پردازنده که معمولاً \fItrace\&.dat\&.cpuX\fR نامیده می‌شود (که X نشان‌دهندهٔ شمارهٔ پردازنده‌ای است که ردگیری می‌کند) داده‌ها را می‌نویسد\&. اگر در trace\-cmd record از گزینهٔ \-o استفاده شده باشد، فایل‌های دادهٔ پردازنده به جای نام \fItrace\&.dat\fR آن نام را خواهند داشت\&. چنانچه پیش از پایان ردگیری یک خرابی و کرش غیرمنتظره رخ دهد، فایل‌های مجزای پردازنده همچنان باقی خواهند ماند اما هیچ فایل trace\&.dat برای خواندن وجود نخواهد داشت\&. دستور trace\-cmd restore به شما امکان می‌دهد تا با فایل‌های دادهٔ موجود، یک فایل trace\&.dat بسازید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-c\fR
.RS 4
یک فایل ناقص trace\&.dat از سیستم جاری ایجاد می‌کند تا در زمانی دیگر برای بازیابی کامل با trace\-cmd restore به کار رود\&. این گزینه برای دستگاه‌های تعبیه‌شده (embedded) سودمند است\&. اگر یک سرور شامل فایل‌های cpu حاصل از یک trace\-cmd record (یا trace\-cmd listen) کرش‌کرده باشد، می‌توان trace\-cmd restore را با گزینهٔ \-c روی دستگاه تعبیه‌شده اجرا کرد تا تمامی اطلاعات ذخیره‌شدهٔ آن دستگاه تعبیه‌شده به دست آید\&. سپس فایل ایجادشده را می‌توان به سرور منتقل کرد تا trace\-cmd restore در آنجا به همراه فایل‌های cpu اجرا شود\&.
.sp
.if n \{\
.RS 4
.\}
.nf
اگر *\-o* مشخص نشده باشد، فایل ایجادشده \*(Aqtrace\-partial\&.dat\*(Aq
نامیده خواهد شد\&. دلیل آن این است که این فایل نسخه‌ای کامل
از چیزی که trace\-cmd\-report(1) بتواند استفاده کند نیست\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-t\fR tracing_dir
.RS 4
به همراه
\fB\-c\fR
استفاده می‌شود و مکانی را که رویدادها از آن خوانده می‌شوند بازنویسی می‌کند\&. به طور پیش‌فرض، اطلاعات ردگیری از دایرکتوری debugfs/tracing خوانده می‌شود\&.
\fB\-t\fR
به جای آن از آن مکان استفاده خواهد کرد\&. این مورد زمانی می‌تواند مفید باشد که فایل trace\&.dat مورد نظر برای ایجاد، متعلق به ماشین دیگری باشد\&. کافی است دستور tar \-cvf events\&.tar debugfs/tracing را اجرا کرده، فایل را به صورت محلی کپی و استخراج (untar) نمایید و به جای آن از آن دایرکتوری استفاده کنید\&.
.RE
.PP
\fB\-k\fR kallsyms
.RS 4
به همراه
\fB\-c\fR
استفاده می‌شود و مکانی را که فایل kallsyms از آن خوانده می‌شود بازنویسی می‌کند\&. به طور پیش‌فرض، از /proc/kallsyms استفاده می‌شود\&.
\fB\-k\fR
فایلی را که kallsyms از آن خوانده می‌شود بازنویسی خواهد کرد\&. این مورد زمانی می‌تواند مفید باشد که فایل trace\&.dat مورد نظر برای ایجاد، متعلق به ماشین دیگری باشد\&. کافی است فایل /proc/kallsyms را به صورت محلی کپی کرده و از
\fB\-k\fR
برای اشاره به آن فایل استفاده نمایید\&.
.RE
.PP
\fB\-o\fR output\*(Aq
.RS 4
به طور پیش‌فرض، trace\-cmd restore یک فایل
\fItrace\&.dat\fR
(یا در صورتی که
\fB\-c\fR
مشخص شده باشد،
\fItrace\-partial\&.dat\fR)
ایجاد خواهد کرد\&. می‌توانید با گزینهٔ
\fB\-o\fR
فایل دیگری را برای نوشتن تعیین کنید\&.
.RE
.PP
\fB\-i\fR input
.RS 4
به طور پیش‌فرض، trace\-cmd restore اطلاعات سیستم جاری را می‌خواند تا داده‌های اولیه‌ای را که در فایل
\fItrace\&.dat\fR
ذخیره می‌شوند ایجاد کند\&. اگر کرش روی ماشین دیگری رخ داده باشد، آنگاه روی آن ماشین باید trace\-cmd restore با گزینهٔ
\fB\-c\fR
اجرا شود تا فایل ناقص trace\&.dat تولید گردد\&. سپس آن فایل می‌تواند به ماشین فعلی منتقل شود؛ جایی که trace\-cmd restore با استفاده از
\fB\-i\fR
آن فایل را به جای خواندن از سیستم جاری بارگذاری خواهد کرد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
اگر کرش روی سیستم دیگری رخ داده باشد، می‌توانید دستور زیر را اجرا کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
$ trace\-cmd restore \-c \-o box\-partial\&.dat
.fi
.if n \{\
.RE
.\}
.sp
سپس روی سروری که فایل‌های cpu را در اختیار دارد:
.sp
.if n \{\
.RS 4
.\}
.nf
$ trace\-cmd restore \-i box\-partial\&.dat trace\&.dat\&.cpu0 trace\&.dat\&.cpu1
.fi
.if n \{\
.RE
.\}
.sp
این کار یک فایل trace\&.dat برای سیستم تعبیه‌شده ایجاد خواهد کرد\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
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\-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