.\" 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 "libvirtd" "8" "" "" "پشتیبانی از مجازی‌سازی" .SH "نام (NAME)" libvirtd \- دیمن مدیریت مجازی‌سازی libvirt .SH "خلاصه دستور (SYNOPSIS)" .sp \fBlibvirtd\fP [\fIگزینه‌ها\fP]... .SH "توضیحات (DESCRIPTION)" .sp برنامه \fBlibvirtd\fP مؤلفه دیمن سمت سرور از سیستم مدیریت مجازی‌سازی libvirt است. .sp این دیمن روی سرورهای میزبان اجرا می‌شود و وظایف مدیریتی لازم برای ماشین‌های میهمان مجازی‌سازی‌شده را انجام می‌دهد. این وظایف شامل مواردی چون راه‌اندازی، متوقف‌سازی و مهاجرت میهمانان بین سرورهای میزبان، پیکربندی و مدیریت شبکه، و مدیریت فضای ذخیره‌سازی برای استفاده توسط میهمانان است. .sp کتابخانه‌ها و ابزارهای کلاینت libvirt به این دیمن متصل می‌شوند تا دستورات را صادر کرده و اطلاعات مربوط به پیکربندی و منابع سیستم میزبان و میهمانان را گردآوری نمایند. .sp به طور پیش‌فرض، دیمن \fBlibvirtd\fP به درخواست‌های دریافتی روی یک سوکت محلی دامنه یونیکس (Unix domain socket) گوش می‌دهد. با استفاده از گزینه خط فرمان \fB\-l\fP | \fB\-\-listen\fP، می‌توان به دیمن \fBlibvirtd\fP دستور داد تا علاوه بر آن به یک سوکت TCP/IP نیز گوش فرا دهد. سوکت TCP/IP مورد استفاده در فایل پیکربندی \fBlibvirtd\fP تعریف می‌شود. .sp راه‌اندازی مجدد \fBlibvirtd\fP تاثیری بر عملکرد میهمانان در حال اجرا نخواهد داشت. میهمانان به فعالیت خود ادامه می‌دهند و در صورتی که پیکربندی XML آن‌ها از قبل تعریف شده باشد، به طور خودکار بازیابی می‌شوند. هر میهمانی که پیکربندی XML آن تعریف نشده باشد، از پیکربندی از دست خواهد رفت. .SH "فعال‌سازی سوکت سیستم (SYSTEM SOCKET ACTIVATION)" .sp دیمن \fBlibvirtd\fP قادر به راه‌اندازی در دو حالت است. .sp در حالت سنتی، این دیمن سوکت‌های یونیکس را خودش ایجاد کرده و به آن‌ها گوش می‌دهد. در صورتی که پارامتر \fB\-\-listen\fP مشخص شده باشد، بر اساس گزینه‌های \fBlisten_tcp\fP و \fBlisten_tls\fP در فایل \fB/etc/libvirt/libvirtd.conf\fP به سوکت(های) TCP/IP نیز گوش فرا خواهد داد. .sp در حالت فعال‌سازی سوکت، این دیمن به systemd متکی خواهد بود تا سوکت‌های یونیکس و در صورت تمایل TCP/IP را ایجاد کرده، به آن‌ها گوش دهد و آن‌ها را به عنوان توصیف‌کننده‌های فایل از پیش بازشده ارسال کند. در این حالت، مشخص کردن پارامتر \fB\-\-listen\fP مجاز نیست و بیشتر گزینه‌های پیکربندی مرتبط با سوکت در فایل \fB/etc/libvirt/libvirtd.conf\fP دیگر اثری نخواهند داشت. برای فعال‌سازی سوکت‌های TCP یا TLS از یکی از دستورات زیر استفاده کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ systemctl start libvirtd\-tls.socket .EE .UNINDENT .UNINDENT .sp یا .INDENT 0.0 .INDENT 3.5 .sp .EX $ systemctl start libvirtd\-tcp.socket .EE .UNINDENT .UNINDENT .sp هنگام اجرا روی یک سیستم‌عامل میزبان که از systemd استفاده می‌کند، حالت فعال‌سازی سوکت معمولاً پیش‌فرض است. برای بازگشت به حالت سنتی، تمام فایل‌های واحد سوکت باید ماسک (mask) شوند: .INDENT 0.0 .INDENT 3.5 .sp .EX $ systemctl mask libvirtd.socket libvirtd\-ro.socket \e libvirtd\-admin.socket libvirtd\-tls.socket libvirtd\-tcp.socket .EE .UNINDENT .UNINDENT .sp علاوه بر این اطمینان حاصل کنید که آرگومان .B \-\-timeout برای دیمن استفاده نشود، زیرا در اتصالات بعدی مجدداً راه‌اندازی نخواهد شد. .sp در صورت استفاده از سرویس libvirt\-guests، ترتیب اجرای آن سرویس باید طوری هماهنگ شود که به جای واحد سوکت، پس از واحد سرویس اجرا گردد. از آنجا که وابستگی‌ها و ترتیب اجرا را نمی‌توان با فایل‌های جایگزین drop\-in تغییر داد، کل فایل واحد libvirt\-guests باید دستخوش تغییر شود. برای حفظ چنین تغییری، فایل نصب‌شده \fB/usr/lib/systemd/system/libvirt\-guests.service\fP را به مسیر \fB/etc/systemd/system/libvirt\-guests.service\fP رونوشت کرده و تغییر را در آنجا اعمال کنید؛ به طور مشخص اطمینان حاصل فرمایید که در ترتیب \fBAfter=\fP عبارت \fBlibvirtd.service\fP درج شده باشد و نه \fBlibvirtd.socket\fP: .INDENT 0.0 .INDENT 3.5 .sp .EX [Unit] After=libvirtd.service .EE .UNINDENT .UNINDENT .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\-l\fP, \fB\-\-listen\fP .sp گوش دادن به اتصالات TCP/IP. در صورت استفاده از فعال‌سازی سوکت systemd نباید این گزینه تنظیم شود؛ در عوض فایل‌های واحد \fBlibvirtd\-tls.socket\fP یا \fBlibvirtd\-tcp.socket\fP را فعال کنید. .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 فعال‌سازی خروجی پیام‌های پرجزئیات (verbose). .sp \fB\-\-version\fP .sp نمایش اطلاعات نسخه و سپس خروج. .SH "سیگنال‌ها (SIGNALS)" .sp با دریافت سیگنال \fBSIGHUP\fP، دیمن \fBlibvirtd\fP پیکربندی خود را دوباره بارگذاری خواهد کرد. .SH "فایل‌ها (FILES)" .SS "هنگام اجرا به عنوان کاربر ریشه (root)" .INDENT 0.0 .IP \(bu 2 \fB/etc/libvirt/libvirtd.conf\fP .UNINDENT .sp فایل پیکربندی پیش‌فرضی که توسط \fBlibvirtd\fP استفاده می‌شود، مگر اینکه در خط فرمان با استفاده از گزینه \fB\-f\fP | \fB\-\-config\fP جایگزین شده باشد. .sp بسته به اینکه کدام درایور نصب شده باشد، فایل‌های زیر نیز خوانده خواهند شد: .INDENT 0.0 .IP \(bu 2 \fB/etc/libvirt/qemu.conf\fP برای درایور QEMU .IP \(bu 2 \fB/etc/libvirt/lxc.conf\fP برای درایور LXC .IP \(bu 2 \fB/etc/libvirt/libxl.conf\fP برای درایور libxl .UNINDENT .sp این فایل‌ها شامل مقادیر پیش‌فرض و پارامترهای تنظیمی گوناگونی برای ماشین‌های مجازی ایجادشده در درایورهای مربوطه‌شان هستند، و راهکاری برای بازنویسی مقادیر پیش‌فرض توکار ارائه می‌دهند؛ برای نمونه (اما نه محدود به): مسیر فایل‌های اجرایی مکمل مختلف، مکان گواهی‌های TLS، پیکربندی کنسول‌های گرافیکی و موارد دیگر. مکان هیچ‌کدام از این فایل‌ها را نمی‌توان با سوییچ‌های خط فرمان تغییر داد. .INDENT 0.0 .IP \(bu 2 \fB/run/libvirt/libvirt\-sock\fP .IP \(bu 2 \fB/run/libvirt/libvirt\-sock\-ro\fP .UNINDENT .sp سوکت‌هایی که دیمن \fBlibvirtd\fP از آن‌ها استفاده خواهد کرد. .INDENT 0.0 .IP \(bu 2 \fB/etc/pki/CA/cacert.pem\fP .UNINDENT .sp گواهی مرجع صدور گواهی (CA) تی‌ال‌اس که \fBlibvirtd\fP استفاده خواهد کرد. .INDENT 0.0 .IP \(bu 2 \fB/etc/pki/libvirt/servercert.pem\fP .UNINDENT .sp گواهی سرور TLS که توسط \fBlibvirtd\fP استفاده خواهد شد. .INDENT 0.0 .IP \(bu 2 \fB/etc/pki/libvirt/private/serverkey.pem\fP .UNINDENT .sp کلید خصوصی سرور TLS که توسط \fBlibvirtd\fP استفاده خواهد شد. .INDENT 0.0 .IP \(bu 2 \fB/run/libvirtd.pid\fP .UNINDENT .sp فایل PID برای استفاده، مگر اینکه توسط گزینه \fB\-p\fP | \fB\-\-pid\-file\fP جایگزین شده باشد. .SS "هنگام اجرا به عنوان کاربر غیر ریشه (non\-root)" .INDENT 0.0 .IP \(bu 2 \fB$XDG_CONFIG_HOME/libvirt/libvirtd.conf\fP .UNINDENT .sp فایل پیکربندی پیش‌فرضی که توسط \fBlibvirtd\fP استفاده می‌شود، مگر اینکه در خط فرمان با گزینه \fB\-f\fP | \fB\-\-config\fP جایگزین شود. .sp اگر درایور 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/libvirt\-sock\fP .UNINDENT .sp سوکت مورد استفاده توسط \fBlibvirtd\fP. .INDENT 0.0 .IP \(bu 2 \fB$HOME/.pki/libvirt/cacert.pem\fP .UNINDENT .sp گواهی مرجع صدور گواهی (CA) تی‌ال‌اس که توسط \fBlibvirtd\fP استفاده خواهد شد. .INDENT 0.0 .IP \(bu 2 \fB$HOME/.pki/libvirt/servercert.pem\fP .UNINDENT .sp گواهی سرور TLS که \fBlibvirtd\fP از آن استفاده خواهد کرد. .INDENT 0.0 .IP \(bu 2 \fB$HOME/.pki/libvirt/serverkey.pem\fP .UNINDENT .sp کلید خصوصی سرور TLS که توسط \fBlibvirtd\fP استفاده خواهد شد. .INDENT 0.0 .IP \(bu 2 \fB$XDG_RUNTIME_DIR/libvirt/libvirtd.pid\fP .UNINDENT .sp فایل PID برای استفاده، مگر اینکه توسط گزینه \fB\-p\fP | \fB\-\-pid\-file\fP جایگزین شده باشد. .sp اگر متغیر \fB$XDG_CONFIG_HOME\fP در محیط شما مقداردهی نشده باشد، دیمن \fBlibvirtd\fP از مسیر \fB$HOME/.config\fP استفاده خواهد کرد. .sp اگر متغیر \fB$XDG_RUNTIME_DIR\fP در محیط شما تنظیم نشده باشد، دیمن \fBlibvirtd\fP از مسیر \fB$HOME/.cache\fP استفاده خواهد کرد. .SH "مثال‌ها (EXAMPLES)" .sp برای دریافت نسخه دیمن \fBlibvirtd\fP: .INDENT 0.0 .INDENT 3.5 .sp .EX # libvirtd \-\-version libvirtd (libvirt) 12.7.0 .EE .UNINDENT .UNINDENT .sp برای راه‌اندازی دیمن \fBlibvirtd\fP، با دستور به دیمن شدن و ایجاد فایل PID: .INDENT 0.0 .INDENT 3.5 .sp .EX # libvirtd \-d # ls \-la /run/libvirtd.pid \-rw\-r\-\-r\-\- 1 root root 6 Jul 9 02:40 /run/libvirtd.pid .EE .UNINDENT .UNINDENT .SH "اشکالات (BUGS)" .sp لطفاً هرگونه اشکال یا خطای کشف‌شده را گزارش دهید. این کار را می‌توانید از یکی از روش‌های زیر انجام دهید: .INDENT 0.0 .IP 1. 3 فهرست پستی .sp \% .IP 2. 3 سامانه ثبت اشکالات .sp \% .UNINDENT .sp به عنوان راهکار جایگزین، می‌توانید اشکالات را به توزیع‌کننده یا فروشنده نرم‌افزار خود گزارش کنید. .SH "نویسندگان (AUTHORS)" .sp لطفاً به پرونده AUTHORS که همراه با libvirt توزیع شده است مراجعه فرمایید. .SH "حق نشر (COPYRIGHT)" .sp حق نشر (C) ۲۰۰۶\-۲۰۱۲ متعلق به Red Hat, Inc. و نویسندگان فهرست‌شده در فایل AUTHORS برنامه libvirt. .SH "مجوز (LICENSE)" .sp برنامه \fBlibvirtd\fP تحت شرایط مجوز GNU LGPL نسخه ۲.۱ یا بالاتر توزیع می‌شود. این یک نرم‌افزار آزاد است؛ برای شرایط رونوشت‌برداری به متن منبع مراجعه کنید. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای ضمانت تجاری بودن یا مناسب بودن برای یک منظور خاص. .SH "همچنین ببینید (SEE ALSO)" .sp virsh(1), virt\-install(1), virt\-xml\-validate(1), virt\-top(1), virt\-df(1), \% .\" End of generated man page.