نام (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)

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

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

کپی‌رایت و تکثیر (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