'\" t
.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "QEMU-GA" "8" "Aug 28, 2026" "11.1.1" "QEMU"
.SH "نام (NAME)"
qemu-ga \- عامل مهمان QEMU
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBqemu\-ga\fP [\fIOPTIONS\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
عامل مهمان QEMU یک دیمن است که برای اجرا در داخل ماشین‌های مجازی در نظر گرفته شده است. این عامل به میزبان هایپروایزر اجازه می‌دهد تا عملیات مختلفی را در سیستم مهمان انجام دهد، از قبیل:
.INDENT 0.0
.IP \(bu 2
دریافت اطلاعات از سیستم مهمان
.IP \(bu 2
تنظیم زمان سیستم مهمان
.IP \(bu 2
خواندن/نوشتن فایل
.IP \(bu 2
همگام‌سازی و انجماد سیستم‌های فایل
.IP \(bu 2
تعلیق سیستم مهمان
.IP \(bu 2
پیکربندی مجدد پردازنده‌های محلی مهمان
.IP \(bu 2
تنظیم گذرواژه کاربر
.IP \(bu 2
\&...
.UNINDENT
.sp
دستور qemu\-ga در هنگام راه‌اندازی یک فایل پیکربندی سیستم (به‌طور پیش‌فرض در مسیر \fB/etc/qemu\fP\fB/qemu\-ga.conf\fP) را می‌خواند، سپس باقی گزینه‌های پیکربندی موجود در خط فرمان را پردازش می‌کند. برای کلیدهای یکسان، آخرین گزینه اولویت دارد، اما فهرست‌ها با یکدیگر تجمیع می‌شوند (برای قالب فایل پیکربندی به بخش زیر مراجعه کنید).
.sp
اگر فهرستی از RPCهای مجاز در پیکربندی تعریف شده باشد، آنگاه تمام RPCها به‌طور پیش‌فرض مسدود خواهند شد، به‌جز مواردی که در فهرست مجاز قرار دارند.
.sp
اگر فهرستی از RPCهای مسدودشده در پیکربندی تعریف شده باشد، آنگاه تمام RPCها به‌طور پیش‌فرض مجاز خواهند بود، به‌جز مواردی که در فهرست مسدودشده قرار دارند.
.sp
اگر هر دو فهرست RPCهای مجاز و مسدودشده در پیکربندی تعریف شده باشند، ابتدا تمام RPCها به‌طور پیش‌فرض مسدود می‌شوند، سپس فهرست مجاز اعمال می‌گردد و پس از آن فهرست مسدودشده اعمال خواهد شد.
.sp
در زمانی که سیستم‌های فایل منجمد هستند، بدون در نظر گرفتن آنچه در پیکربندی عمومی اعلام شده است، تمامی RPCها به‌جز یک مجموعه امن تعیین‌شده مسدود خواهند شد.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-c, \-\-config=PATH
مسیر فایل پیکربندی (پیش‌فرض \fB/etc/qemu\fP\fB/qemu\-ga.conf\fP است، مگر اینکه توسط متغیر محیطی QGA_CONF بازنویسی شود).
.UNINDENT
.INDENT 0.0
.TP
.B \-m, \-\-method=METHOD
روش انتقال: یکی از مقادیر \fBunix\-listen\fP، \fBvirtio\-serial\fP، یا \fBisa\-serial\fP، یا \fBvsock\-listen\fP (\fBvirtio\-serial\fP مقدار پیش‌فرض است).
.UNINDENT
.INDENT 0.0
.TP
.B \-p, \-\-path=PATH
مسیر دستگاه/سوکت (پیش‌فرض برای virtio\-serial برابر با \fB/dev/virtio\-ports/org.qemu.guest_agent.0\fP و پیش‌فرض برای isa\-serial برابر با \fB/dev/ttyS0\fP است). آدرس‌های سوکت برای vsock\-listen به صورت \fB<cid>:<port>\fP\& نوشته می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-l, \-\-logfile=PATH
تنظیم مسیر فایل ثبت لاگ (پیش‌فرض stderr است).
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-pidfile=PATH
مشخص کردن فایل pid (پیش‌فرض \fB/var/run/qemu\-ga.pid\fP است).
.UNINDENT
.INDENT 0.0
.TP
.B \-F, \-\-fsfreeze\-hook=PATH
فعال‌سازی هوک fsfreeze. یک آرگومان اختیاری می‌پذیرد که اسکریپت مورد نظر برای اجرا هنگام انجماد/ذوب (freeze/thaw) را مشخص می‌کند. اسکریپت بر این اساس با آرگومان‌های \(aqfreeze\(aq/\(aqthaw\(aq فراخوانی خواهد شد (پیش‌فرض \fB/etc/qemu\fP\fB/fsfreeze\-hook\fP است). در صورت استفاده از \-F با یک آرگومان، پس از \-F فاصله قرار ندهید (برای مثال: \fB\-F/var/run/fsfreezehook.sh\fP).
.UNINDENT
.INDENT 0.0
.TP
.B \-t, \-\-statedir=PATH
مشخص کردن دایرکتوری ذخیره اطلاعات وضعیت (تنها مسیرهای مطلق، پیش‌فرض \fB/var/run\fP است).
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-verbose
ثبت اطلاعات اشکال‌زدایی بیشتر در لاگ.
.UNINDENT
.INDENT 0.0
.TP
.B \-V, \-\-version
چاپ اطلاعات نسخه و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-d, \-\-daemon
تبدیل به دیمن پس از راه‌اندازی (جدا شدن از ترمینال).
.UNINDENT
.INDENT 0.0
.TP
.B \-b, \-\-block\-rpcs=LIST
فهرستی از RPCها برای غیرفعال‌سازی که با کاما از هم جدا شده‌اند (بدون فاصله، از \fB\-\-block\-rpcs=help\fP برای فهرست کردن RPCهای موجود استفاده کنید).
.UNINDENT
.INDENT 0.0
.TP
.B \-a, \-\-allow\-rpcs=LIST
فهرستی از RPCها برای فعال‌سازی که با کاما از هم جدا شده‌اند (بدون فاصله، از \fB\-\-allow\-rpcs=help\fP برای فهرست کردن RPCهای موجود استفاده کنید).
.UNINDENT
.INDENT 0.0
.TP
.B \-D, \-\-dump\-conf
تخلیه پیکربندی در قالبی سازگار با \fBqemu\-ga.conf\fP و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-h, \-\-help
نمایش این راهنما و خروج.
.UNINDENT
.SH "فایل‌ها (FILES)"
.sp
ساختار نحوی فایل پیکربندی \fBqemu\-ga.conf\fP از مشخصات دسکتاپ اینتری (Desktop Entry Specification) پیروی می‌کند؛ در اینجا خلاصه‌ای گذرا آمده است: این فایل از گروه‌هایی از جفت‌های کلید\-مقدار تشکیل شده است که با کامنت‌ها درآمیخته‌اند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# qemu\-ga configuration sample
[general]
daemonize = 0
pidfile = /var/run/qemu\-ga.pid
verbose = 0
method = virtio\-serial
path = /dev/virtio\-ports/org.qemu.guest_agent.0
statedir = /var/run
.EE
.UNINDENT
.UNINDENT
.sp
فهرست کلیدها از گزینه‌های خط فرمان پیروی می‌کند:
.TS
box center;
l|l.
T{
کلید (Key)
T}	T{
نوع کلید (Key type)
T}
_
T{
daemon
T}	T{
بولی (boolean)
T}
_
T{
method
T}	T{
رشته (string)
T}
_
T{
path
T}	T{
رشته (string)
T}
_
T{
logfile
T}	T{
رشته (string)
T}
_
T{
pidfile
T}	T{
رشته (string)
T}
_
T{
fsfreeze\-hook
T}	T{
رشته (string)
T}
_
T{
statedir
T}	T{
رشته (string)
T}
_
T{
verbose
T}	T{
بولی (boolean)
T}
_
T{
block\-rpcs
T}	T{
فهرست رشته (string list)
T}
_
T{
allow\-rpcs
T}	T{
فهرست رشته (string list)
T}
.TE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBqemu(1)\fP
.SH "نویسنده (AUTHOR)"
Michael Roth <mdroth@linux.vnet.ibm.com>
.SH "حق نشر (COPYRIGHT)"
2026, The QEMU Project Developers
.\" End of generated man page.