virt-qemu-qmp-proxy(1)      Virtualization Support      virt-qemu-qmp-proxy(1)

نام (NAME)
       virt-qemu-qmp-proxy - پروکسی سوکت QMP ماشین مجازی libvirt QEMU

خلاصه دستور (SYNOPSIS)
       virt-qemu-qmp-proxy [OPTION]... DOMAIN QMP-SOCKET-PATH

توضیحات (DESCRIPTION)
       این ابزار راهکاری برای ارائه یک سرور پراکسی QMP فراهم می‌کند که با یک
       ماشین مهمان QEMU تحت مدیریت libvirt ارتباط برقرار می‌نماید. این قابلیت
       ابزارهای کلاینت استاندارد QMP را قادر می‌سازد تا با مهمان‌های تحت مدیریت
       libvirt تعامل داشته باشند.

       نکته: استفاده از این ابزار موجب خواهد شد که مهمان QEMU در حال اجرا با
       برچسب آلوده (tainted) نشانه‌گذاری شود. اکیداً توصیه می‌شود که از این ابزار
       تنها برای ارسال دستوراتی استفاده شود که اطلاعات مهمان در حال اجرا را
       جویا می‌شوند. اگر از این ابزار برای ایجاد تغییرات در وضعیت مهمان استفاده
       شود، ممکن است تداخل‌های نامطلوبی با درایور QEMU ایجاد کند و متعاقباً موجب
       عدم توانایی در مدیریت عملیات مهمان پس از آن گردد، و در بدترین حالت
       به‌طور بالقوه منجر به از دست رفتن یا خرابی داده‌ها شود.

       برنامهٔ virt-qemu-qmp-proxy روی یک سوکت UNIX برای اتصالات ورودی کلاینت
       به گوش می‌ایستد و پروتکل QMP را روی این اتصال اجرا می‌کند. هر دستوری که
       دریافت شود به مهمان در حال اجرای libvirt فرستاده شده و پاسخ‌ها
       بازگردانده می‌شوند.

       هنگامی که دیگر نیازی به برنامه نباشد، می‌توان virt-qemu-qmp-proxy را
       متوقف کرد (مثلاً با Ctrl-C). مهمان QEMU در libvirt همچنان به اجرای خود
       ادامه خواهد داد.

گزینه‌ها (OPTIONS)
       DOMAIN

       شناسه (ID)، شناسه یکتا (UUID) یا نام ماشین مهمان QEMU در libvirt.

       QMP-SOCKET-PATH

       مسیر فایل‌سیستم که سرور QMP باید در آن اجرا شده و به اتصالات ورودی گوش
       فرا دهد.

       -c CONNECTION-URI --connect=CONNECTION-URI

       شناسه منبع یکپارچه (URI) برای اتصال به درایور QEMU در libvirt. در صورت
       عدم تعیین، یک URI به‌طور خودکار شناسایی خواهد شد.

       -v, --verbose

       اجرا در حالت پرگو (verbose)، و چاپ تمامی دستورات QMP و پاسخ‌های
       پردازش‌شده.

       -h, --help

       نمایش راهنمای خط فرمان.

وضعیت خروج (EXIT STATUS)
       در صورت خاموش شدن یا پایان موفقیت‌آمیز، وضعیت خروج 0 تنظیم خواهد شد. در
       صورت بروز خطا، وضعیتی غیرصفر تنظیم می‌شود.

نویسندگان (AUTHORS)
       Daniel P. Berrangé

گزارش باگ‌ها (BUGS)
       لطفاً هرگونه باگی را که پیدا می‌کنید گزارش دهید. این کار را می‌توانید از
       یکی از دو طریق زیر انجام دهید:

       1. فهرست پستی

          <https://libvirt.org/contact.html>

       2. سامانه پیگیری باگ

          <https://libvirt.org/bugs.html>

       همچنین می‌توانید باگ‌ها را به توزیع‌کننده یا عرضه‌کننده نرم‌افزار خود گزارش
       کنید.

کپی‌رایت و تکثیر (COPYRIGHT)
       حق نشر (C) 2022 توسط Red Hat, Inc.

مجوز (LICENSE)
       نرم‌افزار virt-qemu-qmp-proxy تحت شرایط مجوز GNU LGPL v2+ توزیع می‌شود.
       این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر به کد منبع مراجعه کنید.
       هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.

همچنین ببینید (SEE ALSO)
       virsh(1), <https://libvirt.org>, مرجع QMP
       <https://www.qemu.org/docs/master/interop/qemu-qmp-ref.html>

                                                        virt-qemu-qmp-proxy(1)