.\" 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 "virtqemud" "8" "" "" "Virtualization Support" .SH "نام (NAME)" virtqemud \- دیمن مدیریت QEMU در libvirt .SH "خلاصه دستور (SYNOPSIS)" .sp \fBvirtqemud\fP [\fIOPTION\fP]... .SH "توضیحات (DESCRIPTION)" .sp برنامه \fBvirtqemud\fP یک مؤلفه دیمن سمت سرور از سیستم مدیریت مجازی‌سازی libvirt است. .sp این برنامه یکی از مجموعه‌دیمن‌های ماژولار است که جایگزین عملکردهایی شده‌اند که پیش‌تر توسط دیمن یکپارچه \fBlibvirtd\fP ارائه می‌شد. .sp این دیمن روی میزبان‌های مجازی‌سازی اجرا می‌شود تا مدیریت ماشین‌های مجازی QEMU را فراهم کند. .sp دیمن \fBvirtqemud\fP تنها به درخواست‌ها روی یک سوکت محلی دامنه یونیکس (Unix domain socket) گوش فرا می‌دهد. دسترسی از راه دور از طریق TLS/TCP و سازگاری با نسخه‌های پیشین برای کلاینت‌های قدیمی که انتظار \fBlibvirtd\fP را دارند، توسط دیمن \fBvirtproxyd\fP ارائه می‌شود. .sp راه‌اندازی مجدد \fBvirtqemud\fP باعث وقفه در کار ماشین‌های مهمانِ در حال اجرا نمی‌شود. مهمان‌ها به کار خود ادامه می‌دهند و تغییرات در وضعیت آن‌ها معمولاً در طول راه‌اندازی به طور خودکار شناسایی می‌شود. با این حال توصیه می‌شود تا جای ممکن از راه‌اندازی مجدد در زمان اجرای مهمان‌ها خودداری شود. .SH "حالت‌های راه‌اندازی دیمن (DAEMON STARTUP MODES)" .sp دیمن \fBvirtqemud\fP قادر است در دو حالت راه‌اندازی شود. .SS "حالت فعال‌سازی با سوکت (Socket activation mode)" .sp در میزبان‌های مجهز به systemd، این دیمن در حالت فعال‌سازی با سوکت راه‌اندازی می‌شود و برای ایجاد و گوش دادن به سوکت‌های UNIX و ارسال آن‌ها به عنوان توصیف‌کننده‌های فایلِ از پیش باز شده (pre\-opened file descriptors) به systemd متکی خواهد بود. در این حالت، بیشتر گزینه‌های پیکربندی مربوط به سوکت در \fB/etc/libvirt/virtqemud.conf\fP دیگر تأثیری نخواهند داشت. .SS "حالت سرویس سنتی (Traditional service mode)" .sp در میزبان‌های بدون systemd، خود دیمن اقدام به ایجاد و گوش دادن به سوکت‌های UNIX می‌کند. .SH "گزینه‌ها (OPTIONS)" .sp \fB\-h\fP, \fB\-\-help\fP .sp نمایش راهنمای استفاده در خط فرمان و سپس خروج. .sp \fB\-d\fP, \fB\-\-daemon\fP .sp اجرا به صورت یک دیمن و نوشتن فایل PID. .sp \fB\-f\fP, \fB\-\-config *FILE*\fP .sp استفاده از این فایل پیکربندی به جای مقدار پیش‌فرض. .sp \fB\-p\fP, \fB\-\-pid\-file *FILE*\fP .sp استفاده از این نام برای فایل PID به جای مقدار پیش‌فرض. .sp \fB\-t\fP, \fB\-\-timeout *SECONDS*\fP .sp خروج پس از اتمام مدت زمان انتظار (به ثانیه)، به شرط آن‌که نه هیچ اتصال کلاینتی و نه هیچ دامنه در حال اجرایی وجود داشته باشد. .sp \fB\-v\fP, \fB\-\-verbose\fP .sp فعال‌سازی خروجی پیام‌های پرجزئیات. .sp \fB\-\-version\fP .sp نمایش اطلاعات نسخه و سپس خروج. .SH "سیگنال‌ها (SIGNALS)" .sp با دریافت سیگنال \fBSIGHUP\fP، دیمن \fBvirtqemud\fP پیکربندی خود را مجدداً بارگذاری خواهد کرد. .SH "فایل‌ها (FILES)" .SS "هنگام اجرا به عنوان \fIroot\fP" .INDENT 0.0 .IP \(bu 2 \fB/etc/libvirt/virtqemud.conf\fP .UNINDENT .sp فایل پیکربندی پیش‌فرض مورد استفاده توسط \fBvirtqemud\fP، مگر اینکه در خط فرمان با استفاده از گزینه \fB\-f\fP | \fB\-\-config\fP نادیده گرفته شود. .sp علاوه بر فایل پیکربندی پیش‌فرض، \fBvirtqemud\fP پیکربندی مربوط به درایور QEMU را از مسیر زیر می‌خواند: .INDENT 0.0 .IP \(bu 2 \fB/etc/libvirt/qemu.conf\fP .UNINDENT .sp این فایل حاوی تنظیمات مختلف و مقادیر پیش‌فرض برای ماشین‌های مجازی ایجاد شده درون درایور QEMU است و راهکاری برای تغییر مقادیر پیش‌فرض توکار ارائه می‌دهد؛ به عنوان مثال (اما نه محدود به): مسیرهای باینری‌های جانبی، مکان گواهی‌های TLS، پیکربندی کنسول‌های گرافیکی و موارد دیگر. مکان این فایل توسط هیچ سوییچ خط فرمانی قابل تغییر نیست. .INDENT 0.0 .IP \(bu 2 \fB/run/libvirt/virtqemud\-sock\fP .IP \(bu 2 \fB/run/libvirt/virtqemud\-sock\-ro\fP .IP \(bu 2 \fB/run/libvirt/virtqemud\-admin\-sock\fP .UNINDENT .sp سوکت‌هایی که \fBvirtqemud\fP استفاده خواهد کرد. .sp کلید خصوصی TLS سرور که \fBvirtqemud\fP استفاده خواهد کرد. .INDENT 0.0 .IP \(bu 2 \fB/run/virtqemud.pid\fP .UNINDENT .sp فایل PID مورد استفاده، مگر اینکه با گزینه \fB\-p\fP | \fB\-\-pid\-file\fP تغییر داده شود. .SS "هنگام اجرا به عنوان کاربر غیرریشه (\fInon\-root\fP)" .INDENT 0.0 .IP \(bu 2 \fB$XDG_CONFIG_HOME/libvirt/virtqemud.conf\fP .UNINDENT .sp فایل پیکربندی پیش‌فرض مورد استفاده توسط \fBvirtqemud\fP، مگر اینکه در خط فرمان با استفاده از گزینه \fB\-f\(ga\(ga|\fP\-\-config\(ga\(ga تغییر داده شود. .sp علاوه بر فایل پیکربندی پیش‌فرض، \fBvirtqemud\fP پیکربندی مربوط به درایور QEMU را از مسیر زیر می‌خواند: .INDENT 0.0 .IP \(bu 2 \fB$XDG_CONFIG_HOME/libvirt/qemu.conf\fP .UNINDENT .sp اگر این فایل وجود داشته باشد، می‌تواند حاوی تنظیمات مختلف و مقادیر پیش‌فرض برای ماشین‌های مجازی ایجاد شده درون درایور QEMU باشد و راهکاری برای تغییر مقادیر پیش‌فرض توکار ارائه دهد؛ به عنوان مثال (اما نه محدود به): مسیرهای باینری‌های جانبی، مکان گواهی‌های TLS، پیکربندی کنسول‌های گرافیکی و موارد دیگر. مکان این فایل توسط هیچ سوییچ خط فرمانی قابل تغییر نیست. .INDENT 0.0 .IP \(bu 2 \fB$XDG_RUNTIME_DIR/libvirt/virtqemud\-sock\fP .IP \(bu 2 \fB$XDG_RUNTIME_DIR/libvirt/virtqemud\-admin\-sock\fP .UNINDENT .sp سوکت‌هایی که \fBvirtqemud\fP استفاده خواهد کرد. .INDENT 0.0 .IP \(bu 2 \fB$XDG_RUNTIME_DIR/libvirt/virtqemud.pid\fP .UNINDENT .sp فایل PID مورد استفاده، مگر اینکه با گزینه \fB\-p\(ga\(ga|\fP\-\-pid\-file\(ga\(ga تغییر داده شود. .sp اگر \fB$XDG_CONFIG_HOME\fP در محیط شما تنظیم نشده باشد، \fBvirtqemud\fP از \fB$HOME/.config\fP استفاده خواهد کرد. .sp اگر \fB$XDG_RUNTIME_DIR\fP در محیط شما تنظیم نشده باشد، \fBvirtqemud\fP از \fB$HOME/.cache\fP استفاده خواهد کرد. .SH "مثال‌ها (EXAMPLES)" .sp برای دریافت نسخه \fBvirtqemud\fP: .INDENT 0.0 .INDENT 3.5 .sp .EX # virtqemud \-\-version virtqemud (libvirt) 12.7.0 .EE .UNINDENT .UNINDENT .sp برای شروع \fBvirtqemud\fP و دستور به اجرای آن به صورت دیمن و ایجاد فایل PID: .INDENT 0.0 .INDENT 3.5 .sp .EX # virtqemud \-d # ls \-la /run/virtqemud.pid \-rw\-r\-\-r\-\- 1 root root 6 Jul 9 02:40 /run/virtqemud.pid .EE .UNINDENT .UNINDENT .SH "گزارش باگ‌ها (BUGS)" .sp لطفاً هرگونه باگی را که کشف می‌کنید گزارش دهید. این کار می‌تواند از طریق یکی از راه‌های زیر انجام شود: .INDENT 0.0 .IP 1. 3 فهرست پستی (mailing list) .sp \% .IP 2. 3 سامانه پیگیری باگ (bug tracker) .sp \% .UNINDENT .sp همچنین می‌توانید باگ‌ها را به توزیع‌کننده یا ارائه‌دهنده نرم‌افزار خود گزارش دهید. .SH "نویسندگان (AUTHORS)" .sp لطفاً به فایل AUTHORS توزیع‌شده همراه با libvirt مراجعه فرمایید. .SH "حق نشر (COPYRIGHT)" .sp Copyright (C) 2006\-2020 Red Hat, Inc., and the authors listed in the libvirt AUTHORS file. .SH "مجوز (LICENSE)" .sp \fBvirtqemud\fP تحت شرایط GNU LGPL نسخه ۲.۱ یا بالاتر توزیع شده است. این یک نرم‌افزار آزاد است؛ برای شرایط کپی‌برداری به کد منبع مراجعه فرمایید. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا مناسب بودن برای یک هدف خاص. .SH "همچنین ببینید (SEE ALSO)" .sp virsh(1), libvirtd(8), \%, \% .\" End of generated man page.