'\" t
.\"     Title: trace-cmd-agent
.\"    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\-AGENT" "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\-agent \- اجرای یک عامل روی یک ماشین (برای کنترل شدن توسط ماشینی دیگر)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBtrace\-cmd agent\fR [\fIOPTIONS\fR]
.SH "توضیحات (DESCRIPTION)"
.sp
عامل \fBtrace\-cmd\fR(1) روی یک vsocket (برای ماشین‌های مجازی) یا یک درگاه TCP برای اتصالات جهت کنترل ردگیری ماشین گوش فرامی‌دهد\&. سپس این عامل ردگیری را روی ماشین محلی آغاز کرده و داده‌ها را به اتصال کنترل‌کننده منتقل می‌کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-N\fR \fIclient\fR
.RS 4
به‌جای vsocket روی TCP گوش می‌دهد\&. باید نام میزبان یا نشانی IP کلاینت برای مجاز کردن اتصال وارد شود\&. این عامل تنها به کلاینت مشخص‌شده متصل خواهد شد\&. توجه داشته باشید، هر فرایندی روی آن کلاینت می‌تواند عامل را کنترل کند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
*این یک تنظیم بسیار ناامن است\&. فقط در یک شبکه مورد اعتماد استفاده شود*
*تنها در صورتی استفاده شود که ماشین کلاینت کاملاً مورد اعتماد باشد*
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-p\fR \fIport\fR
.RS 4
این گزینه درگاهی را که باید روی آن گوش داده شود مشخص می‌کند\&.
.RE
.PP
\fB\-D\fR
.RS 4
این گزینه باعث می‌شود \fBtrace\-cmd agent\fR به حالت دیمن (daemon) درآمده و در پس‌زمینه اجرا شود\&.
.RE
.PP
\fB\-P\fR \fIcid\fR
.RS 4
به عامل اجازه می‌دهد تا به‌عنوان یک سرور پراکسی نیز عمل کند، به این صورت که می‌تواند روی یک میزبان (host) اجرا شده و با یک مهمان (guest) ارتباط برقرار کند\&.
\fIcid\fR
شناسه زمینه (context ID؛ ببینید
\fBvsock\fR(7))
کلاینتی (مانند VM مهمان) است که اجازه اتصال خواهد داشت\&.
.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 listen \-\-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\-extract(1), trace\-cmd\-reset(1), trace\-cmd\-split(1), trace\-cmd\-list(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