.\" 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 "virt-xml" "1" "" "" "Virtualization Support" .SH "نام (NAME)" virt-xml \- ویرایش و مدیریت آسان تنظیمات XML ماشین‌های مجازی libvirt .SH "خلاصه دستور (SYNOPSIS)" .sp \fBvirt\-xml\fP DOMAIN XML\-ACTION XML\-OPTION [OUTPUT\-OPTION] [MISC\-OPTIONS] ... .SH "توضیحات (DESCRIPTION)" .sp دستور \fBvirt\-xml\fP یک ابزار خط فرمان برای ویرایش XML در libvirt با استفاده از گزینه‌های صریح خط فرمان است. برای شروع سریع، بخش «مثال‌ها (EXAMPLES)» را در انتهای این سند ببینید. .sp هر بار اجرای \fBvirt\-xml\fP به ۳ چیز نیاز دارد: نام دامنه (ماشین مجازی) موجود برای تغییر (یا XML ارائه‌شده از طریق stdin)، یک عملیات بر روی XML، و تغییری که باید روی XML اعمال شود. عملیات‌ها یکی از موارد زیر هستند: .INDENT 0.0 .IP \(bu 2 \fB\-\-add\-device\fP: افزودن تعریف یک دستگاه جدید به XML .IP \(bu 2 \fB\-\-remove\-device\fP: حذف تعریف یک دستگاه موجود .IP \(bu 2 \fB\-\-edit\fP: ویرایش یک بلوک XML موجود .IP \(bu 2 \fB\-\-build\-xml\fP: صرفاً ساختن بلوک XML درخواستی و چاپ آن. در اینجا نیازی به دامنه یا ورودی نیست، اما ارائه آن‌ها توصیه می‌شود تا virt\-xml بتواند پیش‌فرض‌های بهینه را اعمال کند. .UNINDENT .sp تغییر XML یک نمونه از هر یک از گزینه‌های XML ارائه‌شده توسط virt\-xml است، مانند \fB\-\-disk\fP یا \fB\-\-boot\fP. .sp ابزار \fBvirt\-xml\fP در هر بار اجرا فقط اجازه یک جفت «عملیات و گزینه XML» را می‌دهد. اگر نیاز به اعمال چند ویرایش دارید، دستور را چند بار اجرا کنید. .SH "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \fB\-c\fP \fB\-\-connect\fP URI اتصال به یک هایپروایزر غیرپیش‌فرض. برای جزئیات به virt\-install(1) مراجعه کنید. .TP .B \fBdomain\fP شناسه \fBdomain\fP نام، UUID یا شناسه (ID) ماشین مجازی موجود است. در صورت استفاده از \fB\-\-build\-xml\fP یا ارسال XML از طریق ورودی استاندارد (stdin)، می‌توان این مورد را حذف کرد. .sp هنگامی که دامنه مشخص شده باشد، عملیات خروجی پیش‌فرض \fB\-\-define\fP است، حتی اگر ماشین مجازی در حال اجرا باشد. برای به‌روزرسانی پیکربندی ماشین مجازی در حال اجرا، گزینه \fB\-\-update\fP را اضافه کنید (البته همه گزینه‌ها/دستگاه‌ها از به‌روزرسانی پیکربندی ماشین مجازی در حال اجرا پشتیبانی نمی‌کنند). .sp اگر XML از طریق ورودی استاندارد (stdin) ارسال شود، خروجی پیش‌فرض \fB\-\-print\-xml\fP خواهد بود. .UNINDENT .SH "عملیات‌های XML (XML ACTIONS)" .INDENT 0.0 .TP .B \fB\-\-edit\fP [EDIT\-OPTIONS] ویرایش بلوک XML مشخص‌شده. مقادیر EDIT\-OPTIONS به \fBvirt\-xml\fP می‌گویند کدام بلوک را ویرایش کند. نوع XML مورد ویرایش بر اساس گزینه XML ارسال‌شده به \fBvirt\-xml\fP تعیین می‌شود. بنابراین اگر \fB\-\-disk\fP ارسال شود، EDIT\-OPTIONS مشخص می‌کند که کدام بلوک ویرایش گردد. .sp برخی گزینه‌های XML همیشه فقط به یک بلوک XML واحد نگاشت می‌شوند، مانند \fB\-\-cpu\fP، \fB\-\-security\fP، \fB\-\-boot\fP، \fB\-\-clock\fP و چند مورد دیگر. در این موارد، اگر بلوک XML مربوطه از قبل وجود نداشته باشد، \fBvirt\-xml\fP خطایی نمی‌گیرد و آن را برای شما ایجاد می‌کند. .sp بیشتر گزینه‌های XML از مقدار ویژه \(aqclearxml=yes\(aq پشتیبانی می‌کنند. هنگامی که با \fB\-\-edit\fP ترکیب شود، پیش از اعمال تغییرات درخواستی، بلوک XML مورد ویرایش را کاملاً خالی می‌کند. این ویژگی امکان بازسازی کامل یک بلوک XML را فراهم می‌سازد. برای نمونه‌های استفاده به بخش مثال‌ها مراجعه کنید. .sp نمونه‌های EDIT\-OPTIONS: .INDENT 7.0 .IP \(bu 2 .INDENT 2.0 .TP .B \fB\-\-edit\fP استفاده از \fB\-\-edit\fP بدون هیچ گزینه‌ای به معنای «ویرایش اولین بلوک» است. بنابراین \(aq\-\-edit \-\-disk DISK\-OPTIONS\(aq به معنای «ویرایش اولین » است. .sp برای گزینه‌های تک‌بلوکی XML که در بالا ذکر شدند، حالت ساده \(aq\-\-edit\(aq بدون هیچ گزینه‌ای دقیقاً همان چیزی است که همیشه می‌خواهید استفاده کنید. .UNINDENT .IP \(bu 2 .INDENT 2.0 .TP .B \fB\-\-edit\fP # انتخاب شماره بلوک XML مشخص‌شده. بنابراین \(aq\-\-edit 2 \-\-disk DISK\-OPTS\(aq به معنای «ویرایش دومین » است. این گزینه عملاً فقط برای XML دستگاه‌ها کاربرد دارد. .UNINDENT .IP \(bu 2 .INDENT 2.0 .TP .B \fB\-\-edit\fP all اصلاح تمام بلوک‌های XML از نوع گزینه XML مشخص‌شده. بنابراین \(aq\-\-edit all \-\-disk DISK\-OPTS\(aq به معنای «ویرایش تمام بلوک‌های » است. این گزینه عملاً فقط برای XML دستگاه‌ها کاربرد دارد. .UNINDENT .IP \(bu 2 .INDENT 2.0 .TP .B \fB\-\-edit\fP DEVICE\-OPTIONS اصلاح تمام بلوک‌های XML که با گزینه‌های دستگاه ارائه‌شده مطابقت دارند. گزینه‌های دستگاه با همان قالبی هستند که به گزینه XML ارسال می‌شوند. .UNINDENT .UNINDENT .sp بنابراین \fI\-\-edit path=/tmp/foo \-\-disk DISK\-OPTS\fP به معنای «ویرایش هر با مسیر /tmp/foo» است. این گزینه عملاً فقط برای XML دستگاه‌ها کاربرد دارد. .TP .B \fB\-\-add\-device\fP افزودن گزینه‌های XML مشخص‌شده به فهرست در XML. مثال: \(aq\-\-add\-device \-\-disk DISK\-OPTIONS\(aq یک بلوک جدید ایجاد کرده و آن را به XML اضافه می‌کند. .sp در صورت تعیین این گزینه همراه با یک گزینه XML غیردستگاهی، خطا صادر می‌شود (برای فهرست ناقص به بخش \fB\-\-edit\fP مراجعه کنید). .TP .B \fB\-\-remove\-device\fP حذف دستگاه مشخص‌شده از XML. دستگاه مورد حذف بر اساس گزینه XML تعیین می‌شود که آرگومان‌هایی با همان قالب \fB\-\-edit\fP می‌پذیرد. مثال‌ها: .INDENT 7.0 .IP \(bu 2 .INDENT 2.0 .TP .B \fB\-\-remove\-device \-\-disk 2\fP حذف دومین دستگاه دیسک .UNINDENT .IP \(bu 2 .INDENT 2.0 .TP .B \fB\-\-remove\-device \-\-network all\fP حذف تمام دستگاه‌های شبکه .UNINDENT .IP \(bu 2 .INDENT 2.0 .TP .B \fB\-\-remove\-device \-\-sound pcspk\fP حذف تمام دستگاه‌های صوتی با مدل model=\(aqpcspk\(aq .UNINDENT .UNINDENT .sp در صورت تعیین این گزینه همراه با یک گزینه XML غیردستگاهی، خطا صادر می‌شود (برای فهرست ناقص به بخش \fB\-\-edit\fP مراجعه کنید). .TP .B \fB\-\-build\-xml\fP صرفاً ساخت XML مشخص‌شده و چاپ آن در خروجی استاندارد (stdout). هیچ دامنه یا XML ورودی لازم نیست. مثال: \(aq\-\-build\-xml \-\-disk DISK\-OPTIONS\(aq صرفاً دستگاه جدید را چاپ می‌کند. .sp با این حال، اگر XML تولیدشده برای دامنه خاصی در نظر گرفته شده باشد، توصیه می‌شود آن را به virt\-xml ارسال کنید تا این ابزار بتواند پیش‌فرض‌های بهینه را تنظیم کند. .sp در صورت تعیین این گزینه همراه با یک گزینه XML که به وضوح به یک بلوک مشخص XML نگاشت نمی‌شود (مانند \fB\-\-vcpus\fP یا \fB\-\-memory\fP)، خطا صادر می‌شود. .UNINDENT .SH "گزینه‌های خروجی (OUTPUT OPTIONS)" .sp این گزینه‌ها تعیین می‌کنند که پس از تغییر XML چه عملیاتی انجام شود. در حالت معمول نیازی به مشخص کردن این گزینه‌ها نیست، زیرا «عملیات‌های XML» یک عملیات خروجی پیش‌فرض را در بر دارند که در بالا با جزئیات توضیح داده شد. این گزینه‌ها فقط زمانی لازم هستند که بخواهید خروجی پیش‌فرض را تغییر دهید. .INDENT 0.0 .TP .B \fB\-\-update\fP اگر دامنه مشخص‌شده در حال اجرا باشد، تلاش می‌کند پیکربندی ماشین مجازی در حال اجرا را تغییر دهد. اگر با \fB\-\-edit\fP ترکیب شود، یک عملیات به‌روزرسانی خواهد بود. اگر با \fB\-\-add\-device\fP ترکیب شود، یک اتصال گرم (hotplug) دستگاه خواهد بود. اگر با \fB\-\-remove\-device\fP ترکیب شود، یک جداسازی گرم (hotunplug) دستگاه خواهد بود. .sp به خاطر داشته باشید که بیشتر ویژگی‌ها و دستگاه‌های XML از عملیات به‌روزرسانی زنده پشتیبانی نمی‌کنند، بنابراین انتظار نداشته باشید در همه موارد موفقیت‌آمیز باشد. .sp به‌طور پیش‌فرض، این گزینه \fB\-\-define\fP را نیز در بر دارد. .TP .B \fB\-\-define\fP ثبت و تعریف تغییرات XML درخواستی. این مورد معمولاً در صورت مشخص نشدن گزینه خروجی حالت پیش‌فرض است، اما اگر یکی از گزینه‌های \fB\-\-print\fP مشخص شده باشد، برای اعمال اجباری تغییرات به \fB\-\-define\fP نیاز است. .TP .B \fB\-\-no\-define\fP صریحاً XML را ثبت و تعریف نمی‌کند. برای مثال اگر فقط می‌خواهید وضعیت زمان اجرای یک ماشین مجازی را تغییر دهید، این گزینه را با \fB\-\-update\fP ترکیب کنید. .TP .B \fB\-\-start\fP روشن کردن ماشین مجازی پس از اعمال تغییرات درخواستی. اگر با \fB\-\-no\-define\fP ترکیب شود، یک بوت موقت ماشین مجازی با تغییرات درخواستی ایجاد خواهد کرد. .TP .B \fB\-\-print\-diff\fP چاپ تغییرات XML تولیدشده در قالب unified diff. اگر فقط این گزینه خروجی مشخص شود، تمام گزینه‌های خروجی دیگر غیرفعال شده و هیچ تغییر پایداری اعمال نمی‌شود. .TP .B \fB\-\-print\-xml\fP چاپ کامل XML تولیدشده. اگر فقط این گزینه خروجی مشخص شود، تمام گزینه‌های خروجی دیگر غیرفعال شده و هیچ تغییر پایداری اعمال نمی‌شود. .TP .B \fB\-\-confirm\fP پیش از تعریف یا به‌روزرسانی دامنه، تفاوت (diff) تولیدشده XML را نمایش داده و به‌صورت تعاملی تاییدیه درخواست می‌کند. .UNINDENT .SH "گزینه‌های سیستم‌عامل مهمان (GUEST OS OPTIONS)" .INDENT 0.0 .TP .B \fB\-\-osinfo\fP, \fB\-\-os\-variant\fP OS_VARIANT بهینه‌سازی پیکربندی مهمان برای یک سیستم‌عامل خاص (مانند \(aqfedora29\(aq، \(aqrhel7\(aq، \(aqwin10\(aq). اگرچه اجباری نیست، اما تعیین این گزینه شدیداً توصیه می‌شود، زیرا می‌تواند با مشخص کردن virtio در میان سایر بهینه‌سازی‌های مهمان، عملکرد را به میزان قابل توجهی افزایش دهد. .sp اگر سیستم‌عامل مهمان با استفاده از virt\-manager نسخه 2.0.0 یا جدیدتر نصب شده باشد، ارائه این اطلاعات نباید ضروری باشد، زیرا نوع سیستم‌عامل در طول نصب در پیکربندی مهمان ذخیره شده و virt\-xml آن را به‌طور خودکار از آنجا بازیابی خواهد کرد. .sp از دستور \fBvirt\-xml \-\-osinfo list\fP برای دریافت فهرست گونه‌های پذیرفته‌شده سیستم‌عامل استفاده کنید. برای خروجی‌های بیشتر دستور \fBosinfo\-query os\fP را ببینید. .sp برای جزئیات بیشتر درباره \fB\-\-osinfo/\-\-os\-variant\fP به مستندات virt\-install(1) مراجعه کنید. .UNINDENT .SH "گزینه‌های تبدیل (CONVERSION OPTIONS)" .SS \fB\-\-convert\-to\-q35\fP .sp \fBقالب دستوری:\fP \fB\-\-convert\-to\-q35\fP [OPTIONS] .sp تبدیل پیکربندی یک ماشین مجازی موجود از نوع ماشین PC/i440FX به Q35. این کار عمدتاً شامل موارد زیر است: .INDENT 0.0 .IP \(bu 2 تبدیل توپولوژی دستگاه‌ها از PCI به PCIe .IP \(bu 2 تبدیل تمام فضاهای ذخیره‌سازی IDE به SATA .UNINDENT .sp ممکن است برای مدیریت این مورد نیاز باشد تغییراتی در پیکربندی داخل ماشین مجازی نیز ایجاد کنید. برای مثال، Windows 10 ممکن است پس از تبدیل IDE به SATA نتواند دستگاه بوت را پیدا کند. اما یک‌بار بوت شدن در حالت safe mode ممکن است مشکل را برطرف کند. .sp زیرگزینه‌ها عبارتند از: .INDENT 0.0 .TP .B \fBnum_pcie_root_ports=NUM\fP کنترل تعداد دستگاه‌های کنترلر پیش‌فرض \fBpcie\-root\-port\fP که به‌صورت پیش‌فرض به ماشین مجازی اضافه می‌کنیم. .UNINDENT .SS \fB\-\-convert\-to\-vnc\fP .sp \fBقالب دستوری:\fP \fB\-\-convert\-to\-vnc\fP [OPTIONS] .sp تبدیل یک ماشین مجازی موجود برای استفاده انحصاری از یک دستگاه گرافیکی VNC واحد. .sp این گزینه تلاش می‌کند تمام ارجاعات به هرگونه پیکربندی گرافیکی غیر VNC مانند Spice را حذف کند. برای مثال: .INDENT 0.0 .IP \(bu 2 دستگاه‌های \fBqxl\fP جایگزین خواهند شد .IP \(bu 2 تمام دستگاه‌های \fBspicevmc\fP و \fBspiceport\fP حذف خواهند شد .IP \(bu 2 گرافیک spice GL به \fBegl\-headless\fP تبدیل خواهد شد .UNINDENT .sp زیرگزینه‌ها عبارتند از: .INDENT 0.0 .TP .B \fBqemu\-vdagent=on|off\fP افزودن یک دستگاه \fBqemu\-vdagent\fP در صورتی که از قبل پیکربندی نشده باشد. این کار برخی از قابلیت‌های spice vdagent را جایگزین می‌کند. مقدار پیش‌فرض \fBoff\fP است، اما ممکن است در آینده تغییر کند. .UNINDENT .SH "گزینه‌های XML (XML OPTIONS)" .INDENT 0.0 .IP \(bu 2 \fB\-\-disk\fP .IP \(bu 2 \fB\-\-network\fP .IP \(bu 2 \fB\-\-graphics\fP .IP \(bu 2 \fB\-\-metadata\fP .IP \(bu 2 \fB\-\-memory\fP .IP \(bu 2 \fB\-\-vcpus\fP .IP \(bu 2 \fB\-\-cpu\fP .IP \(bu 2 \fB\-\-iothreads\fP .IP \(bu 2 \fB\-\-seclabel\fP .IP \(bu 2 \fB\-\-keywrap\fP .IP \(bu 2 \fB\-\-cputune\fP .IP \(bu 2 \fB\-\-numatune\fP .IP \(bu 2 \fB\-\-memtune\fP .IP \(bu 2 \fB\-\-blkiotune\fP .IP \(bu 2 \fB\-\-memorybacking\fP .IP \(bu 2 \fB\-\-features\fP .IP \(bu 2 \fB\-\-clock\fP .IP \(bu 2 \fB\-\-pm\fP .IP \(bu 2 \fB\-\-events\fP .IP \(bu 2 \fB\-\-resources\fP .IP \(bu 2 \fB\-\-sysinfo\fP .IP \(bu 2 \fB\-\-xml\fP .IP \(bu 2 \fB\-\-qemu\-commandline\fP .IP \(bu 2 \fB\-\-launchSecurity\fP .IP \(bu 2 \fB\-\-boot\fP .IP \(bu 2 \fB\-\-idmap\fP .IP \(bu 2 \fB\-\-controller\fP .IP \(bu 2 \fB\-\-input\fP .IP \(bu 2 \fB\-\-serial\fP .IP \(bu 2 \fB\-\-parallel\fP .IP \(bu 2 \fB\-\-channel\fP .IP \(bu 2 \fB\-\-console\fP .IP \(bu 2 \fB\-\-hostdev\fP .IP \(bu 2 \fB\-\-filesystem\fP .IP \(bu 2 \fB\-\-sound\fP .IP \(bu 2 \fB\-\-audio\fP .IP \(bu 2 \fB\-\-watchdog\fP .IP \(bu 2 \fB\-\-video\fP .IP \(bu 2 \fB\-\-smartcard\fP .IP \(bu 2 \fB\-\-redirdev\fP .IP \(bu 2 \fB\-\-memballoon\fP .IP \(bu 2 \fB\-\-tpm\fP .IP \(bu 2 \fB\-\-rng\fP .IP \(bu 2 \fB\-\-panic\fP .IP \(bu 2 \fB\-\-shmem\fP .IP \(bu 2 \fB\-\-memdev\fP .UNINDENT .sp این گزینه‌ها XML را برای یک دسته واحد از عناصر XML تغییر می‌دهند. مستندات کامل‌تر در virt\-install(1) یافت می‌شود. .sp به‌طور کلی این گزینه‌ها کاملاً سرراست به XML هایپروایزر libvirt نگاشت می‌شوند که در نشانی \% مستند شده است. .sp رشته‌های گزینه در قالب زیر هستند: \-\-option opt=val,opt2=val2,... به عنوان مثال: \-\-disk path=/tmp/foo,shareable=on. ویژگی‌ها را می‌توان به‌صورت \(aq\-\-option opt=,\(aq نیز استفاده کرد، بنابراین برای پاک کردن تنظیمات cache یک دیسک می‌توانید از \(aq\-\-disk cache=,\(aq استفاده کنید. .sp برای هر گزینه، از \-\-option=? برای دیدن فهرستی از تمام زیرگزینه‌های موجود استفاده کنید، به عنوان مثال: \-\-disk=? یا \-\-boot=? .sp خروجی \fB\-\-help\fP نیز چند مثال عمومی را فهرست می‌کند. برای مشاهده مثال‌های متداول به بخش «مثال‌ها (EXAMPLES)» در زیر مراجعه کنید. .sp ابزار virt\-xml به‌طور خاص دارای برخی عملیات است که واقعاً برای virt\-install کاربرد ندارند. مثال‌ها: .INDENT 0.0 .TP .B \fB\-\-boot refresh\-machine\-type=yes\fP بازنشانی مقدار \fB\fP در XML به آخرین مقداری که qemu ارائه می‌دهد. به عنوان مثال، اگر ماشین مجازی شما مقدار نوع ماشین \fBpc\-q35\-4.0\fP را دارد، این گزینه مقدار را به \fBq35\fP بازنشانی می‌کند، و به همین ترتیب با سایر انواع ماشین‌های دارای نسخه نیز کار می‌کند. گاهی این کار برای فعال‌سازی رفع اشکال‌های qemu، یا زمانی که qemu مقادیر قدیمی نوع ماشین را منسوخ و حذف می‌کند، ضروری است. .UNINDENT .SH "گزینه‌های متفرقه (MISCELLANEOUS OPTIONS)" .INDENT 0.0 .TP .B \fB\-h\fP, \fB\-\-help\fP نمایش پیام راهنما و خروج .TP .B \fB\-\-version\fP نمایش شماره نسخه برنامه و خروج .TP .B \fB\-q\fP, \fB\-\-quiet\fP جلوگیری از خروجی‌های پرحجم .TP .B \fB\-d\fP, \fB\-\-debug\fP چاپ اطلاعات اشکال‌زدایی (دیباگ) .UNINDENT .SH "مثال‌ها (EXAMPLES)" .sp مشاهده فهرستی از تمام زیرگزینه‌هایی که \fB\-\-disk\fP و \fB\-\-network\fP می‌پذیرند: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml \-\-disk=? \-\-network=? .EE .UNINDENT .UNINDENT .sp تغییر دامنه \(aqEXAMPLE\(aq: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml EXAMPLE \-\-edit \-\-metadata description=\(dqmy new description\(dq .EE .UNINDENT .UNINDENT .sp فعال کردن منوی دستگاه بوت برای دامنه \(aqEXAMPLE\(aq: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml EXAMPLE \-\-edit \-\-boot menu=on .EE .UNINDENT .UNINDENT .sp پاک کردن تعریف قبلی دامنه \(aqwinxp\(aq، تغییر آن به \(aqhost\-model\(aq، همراه با تایید تعاملی diff پیش از ذخیره: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml winxp \-\-edit \-\-cpu host\-model,clearxml=yes \-\-confirm .EE .UNINDENT .UNINDENT .sp تغییر دومین کارت صدا به model=ich6 در \(aqfedora19\(aq، اما فقط چاپ تفاوت‌ها (diff): .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml fedora19 \-\-edit 2 \-\-sound model=ich6 \-\-print\-diff .EE .UNINDENT .UNINDENT .sp به‌روزرسانی گذرواژه تمام دستگاه‌های گرافیکی به \(aqfoo\(aq در ماشین مجازی در حال اجرای \(aqrhel6\(aq: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml rhel6 \-\-edit all \-\-graphics password=foo \-\-update .EE .UNINDENT .UNINDENT .sp حذف مسیر دیسک از دستگاه دیسک hdc: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml rhel6 \-\-edit target=hdc \-\-disk path= .EE .UNINDENT .UNINDENT .sp تغییر تمام دستگاه‌های دیسک از نوع \(aqdisk\(aq به cache=none، با استفاده از XML ورودی stdin، و چاپ XML جدید در stdout: .INDENT 0.0 .INDENT 3.5 .sp .EX # cat | virt\-xml \-\-edit device=disk \-\-disk cache=none .EE .UNINDENT .UNINDENT .sp تغییر ورودی/خروجی (IO) دیسک \(aqhda\(aq به native و استفاده از سیاست راه‌اندازی \(aqoptional\(aq: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml fedora20 \-\-edit target=hda \e \-\-disk io=native,startup_policy=optional .EE .UNINDENT .UNINDENT .sp تغییر تمام دستگاه‌های میزبان به driver_name=vfio برای ماشین مجازی \(aqfedora20\(aq در اتصال از راه دور: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml \-\-connect qemu+ssh://remotehost/system \e fedora20 \-\-edit all \-\-hostdev driver_name=vfio .EE .UNINDENT .UNINDENT .sp اتصال گرم (Hotplug) دستگاه USB میزبان 001.003 به دامنه در حال اجرای \(aqfedora19\(aq: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml fedora19 \-\-update \-\-add\-device \-\-hostdev 001.003 .EE .UNINDENT .UNINDENT .sp افزودن یک کانال spicevmc به دامنه \(aqwinxp\(aq، که پس از خاموش شدن بعدی ماشین مجازی در دسترس خواهد بود: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml winxp \-\-add\-device \-\-channel spicevmc .EE .UNINDENT .UNINDENT .sp ایجاد یک ایمیج دیسک qcow2 به حجم 10 گیگابایت و اتصال آن به \(aqfedora18\(aq برای راه‌اندازی بعدی ماشین مجازی: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml fedora18 \-\-add\-device \e \-\-disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,size=10 .EE .UNINDENT .UNINDENT .sp مشابه بالا، اما با اطمینان از اتصال دیسک به مناسب‌ترین گذرگاه برای سیستم‌عامل مهمان با ارائه اطلاعات آن در خط فرمان: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml fedora18 \-\-osinfo fedora18 \-\-add\-device \e \-\-disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,size=10 .EE .UNINDENT .UNINDENT .sp جداسازی گرم (Hotunplug) دیسک vdb از دامنه در حال اجرای \(aqrhel7\(aq: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml rhel7 \-\-update \-\-remove\-device \-\-disk target=vdb .EE .UNINDENT .UNINDENT .sp حذف تمام دستگاه‌های گرافیکی از ماشین مجازی \(aqrhel7\(aq پس از خاموش شدن بعدی: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml rhel7 \-\-remove\-device \-\-graphics all .EE .UNINDENT .UNINDENT .sp تولید XML برای یک دستگاه کنسول virtio و چاپ آن در stdout: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml \-\-build\-xml \-\-console pty,target_type=virtio .EE .UNINDENT .UNINDENT .sp افزودن دستور مستقیم پاس‌ترو در خط فرمان qemu: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml f25 \-\-edit \-\-confirm \-\-qemu\-commandline=\(dq\-device FOO\(dq .EE .UNINDENT .UNINDENT .sp استفاده از دستگاه بوت \(aqnetwork\(aq برای یک‌بار بوت موقت: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-xml myvm \-\-no\-define \-\-start \-\-edit \-\-boot network .EE .UNINDENT .UNINDENT .SH "هشدارها (CAVEATS)" .sp میزبان‌های مجازی‌سازی پشتیبانی‌شده توسط libvirt ممکن است اجازه تمام تغییراتی که ممکن به نظر می‌رسد را ندهند. برخی ویرایش‌های انجام‌شده روی تعریف یک ماشین مجازی ممکن است نادیده گرفته شوند. به عنوان مثال، QEMU پس از تعریف برخی دستگاه‌ها، اجازه حذف آن‌ها را نمی‌دهد. .SH "اشکالات (BUGS)" .sp لطفاً به نشانی \% مراجعه کنید. .SH "حق نشر (COPYRIGHT)" .sp حق نشر (C) شرکت Red Hat و مشارکت‌کنندگان مختلف. این یک نرم‌افزار آزاد است. شما می‌توانید نسخه‌های آن را تحت شرایط «مجوز عمومی همگانی گنو» \% بازتوزیع کنید. تا جایی که قانون اجازه می‌دهد، هیچ ضمانتی وجود ندارد. .SH "همچنین ببینید (SEE ALSO)" .sp virt\-install(1)، وب‌سایت پروژه \% .\" End of generated man page.