'\" t
.\"     Title: trace-cmd-extract
.\"    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\-EXTRACT" "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-extract \- استخراج داده‌ها از ردیاب Ftrace لینوکس\&.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBtrace\-cmd extract [\fR\fB\fIOPTIONS\fR\fR\fB]\fR
.SH "توضیحات (DESCRIPTION)"
.sp
دستور trace\-cmd(1) extract معمولاً پس از دستورهای \fItrace\-cmd\-start(1)\fR و \fItrace\-cmd\-stop(1)\fR استفاده می‌شود\&. همچنین می‌توان آن را پس از شروع دستی ردیاب Ftrace از طریق سیستم‌فایل کاذب Ftrace به کار برد\&.
.sp
دستور extract یک فایل trace\&.dat ایجاد می‌کند که توسط \fItrace\-cmd\-report(1)\fR قابل خواندن است\&. این دستور برای تولید فایل trace\&.dat، بافر حلقه‌ای داخلی هسته (kernel internal ring buffer) را می‌خواند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-p\fR \fIplugin\fR
.RS 4
اگرچه
\fBextract\fR
هیچ ردیابی را آغاز نمی‌کند، برخی از پلاگین‌ها تنها نیازمند خواندن خروجی در قالب ASCII هستند\&. این‌ها ردیاب‌های تاخیر (latency tracers) هستند، زیرا ردیاب‌های تاخیر یک بافر داخلی جداگانه دارند\&. بنابراین این گزینه تنها برای پلاگین‌های
\fIwakeup\fR،
\fIwakeup\-rt\fR،
\fIirqsoff\fR،
\fIpreemptoff\fR
و
\fIpreemptirqsoff\fR
لازم است\&.
.sp
.if n \{\
.RS 4
.\}
.nf
بدون این گزینه، دستور extract داده‌ها را از بافرهای
داخلی Ftrace استخراج خواهد کرد\&.
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-O\fR \fIoption\fR
.RS 4
اگر داده‌های یک ردیاب تاخیر در حال استخراج باشد و گزینهٔ
\fB\-p\fR
استفاده شود، گزینه‌هایی در Ftrace وجود دارند که می‌توانند قالب خروجی را تغییر دهند\&. این گزینه پیش از استخراج، آن تنظیمات را به‌روزرسانی می‌کند\&. برای دیدن فهرست گزینه‌ها به
\fItrace\-cmd\-list\fR
مراجعه کنید\&. برای فعال‌سازی یک گزینه نام آن را بنویسید و برای غیرفعال‌سازی، نویسه‌های
\fIno\fR
را به ابتدای آن اضافه کنید\&. برای مثال:
\fInoprint\-parent\fR
گزینهٔ
\fIprint\-parent\fR
را که هنگام چاپ یک رویدادِ تابع، تابع والد را چاپ می‌کند، غیرفعال خواهد کرد\&.
.RE
.PP
\fB\-o\fR \fIoutputfile\fR
.RS 4
به‌طور پیش‌فرض، دستور extract فایلی به نام
\fItrace\&.dat\fR
ایجاد می‌کند\&. این گزینه محل ذخیره شدن فایل را تغییر می‌دهد\&.
.RE
.PP
\fB\-s\fR
.RS 4
استخراج از بافر تصویر لحظه‌ای (snapshot buffer) (در صورتی که هسته از آن پشتیبانی کند)\&.
.RE
.PP
\fB\-\-date\fR
.RS 4
این گزینه همانند گزینهٔ \-\-date در trace\-cmd\-record(1) عمل می‌کند، اما باعث می‌شود که فرآیند extract تمام ردیابی‌ها را غیرفعال کند\&. به این معنی که پایان استخراج، عملیاتی مشابه با trace\-cmd\-reset(1) انجام خواهد داد\&.
.RE
.PP
\fB\-B\fR \fIbuffer\-name\fR
.RS 4
اگر هسته از چندین بافر پشتیبانی کند، این گزینه رد را تنها برای بافر داده‌شده استخراج می‌کند و بر بافرهای دیگر تاثیری نمی‌گذارد\&. می‌توان چندین بار از این گزینه برای مشخص کردن بافرهای گوناگون استفاده کرد\&. با به کار بردن این گزینه، نمونهٔ سطح بالا (top level instance) استخراج نخواهد شد مگر اینکه گزینهٔ
\fB\-t\fR
داده شده باشد\&.
.RE
.PP
\fB\-a\fR
.RS 4
استخراج تمام نمونه‌های بافر موجود\&. با استفاده از این گزینه، نمونهٔ سطح بالا استخراج نخواهد شد مگر اینکه گزینهٔ
\fB\-t\fR
داده شده باشد\&.
.RE
.PP
\fB\-t\fR
.RS 4
بافر نمونهٔ سطح بالا را استخراج می‌کند\&. بدون گزینه‌های
\fB\-B\fR
یا
\fB\-a\fR،
عملکرد این گزینه همانند حالت پیش‌فرض است\&. اما در صورت استفاده از
\fB\-B\fR
یا
\fB\-a\fR،
اگر استخراج بافر نمونهٔ سطح بالا نیز مد نظر باشد، به کار بردن این گزینه الزامی است\&.
.RE
.PP
\fB\-\-verbose\fR[=\fIlevel\fR]
.RS 4
تنظیم سطح ثبت وقایع (log level)\&. سطوح لاگ پشتیبانی‌شده عبارتند از "none"، "critical"، "error"، "warning"، "info"، "debug"، "all" یا شناسه‌های آن‌ها "0"، "1"، "2"، "3"، "4"، "5"، "6"\&. تنظیم سطح لاگ روی مقداری مشخص، تمام پیام‌های آن سطح و سطوح پیش از آن را فعال می‌کند\&. در صورتی که سطحی تعیین نشود، مقدار پیش‌فرض "info" خواهد بود\&.
.sp
.if n \{\
.RS 4
.\}
.nf
مثال: فعال‌سازی تمام لاگ‌های بحرانی (critical)، خطا (error) و هشدار (warning)
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
trace\-cmd extract \-\-verbose=warning
.fi
.if n \{\
.RE
.\}
.RE
.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\-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
Copyright (C) 2010 Red Hat, Inc\&. استفاده آزاد از این نرم‌افزار تحت شرایط پروانه عمومی همگانی گنو (GPL) مجاز است\&.
.SH "نکات (NOTES)"
.IP " 1." 4
rostedt@goodmis.org
.RS 4
\%mailto:rostedt@goodmis.org
.RE