.\" 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 "virtnetworkd" "8" "" "" "پشتیبانی از مجازی‌سازی"
.SH "نام (NAME)"
virtnetworkd \- دیمن مدیریت شبکه مجازی libvirt
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBvirtnetworkd\fP [\fIگزینه‌ها\fP]...
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBvirtnetworkd\fP یک مؤلفه دیمن سمت سرور از سیستم مدیریت مجازی‌سازی libvirt است.
.sp
این دیمن یکی از اعضای مجموعه‌ای از دیمن‌های ماژولار است که جایگزین عملکردهایی شده‌اند که قبلاً توسط دیمن یکپارچه \fBlibvirtd\fP ارائه می‌شد.
.sp
این دیمن روی میزبان‌های مجازی‌سازی اجرا می‌شود تا قابلیت مدیریت شبکه‌های مجازی را فراهم کند.
.sp
دیمن \fBvirtnetworkd\fP تنها به درخواست‌های ارسال‌شده روی سوکت محلی دامنه یونیکس (Unix domain socket) گوش می‌دهد. دسترسی از راه دور از طریق TLS/TCP و سازگاری رو‌به‌عقب با کلاینت‌های قدیمی‌تری که انتظار حضور \fBlibvirtd\fP را دارند، توسط دیمن \fBvirtproxyd\fP ارائه می‌شود.
.sp
راه‌اندازی مجدد \fBvirtnetworkd\fP عملکرد ماشین‌های میهمان در حال اجرا را مختل نمی‌کند. میهمان‌ها به کار خود ادامه می‌دهند و تغییرات در وضعیت آن‌ها معمولاً به طور خودکار در زمان راه‌اندازی شناسایی می‌شود. با این حال توصیه می‌شود تا جای ممکن از راه‌اندازی مجدد سرویس هنگام اجرای میهمان‌ها خودداری شود.
.SH "حالت‌های راه‌اندازی دیمن (DAEMON STARTUP MODES)"
.sp
دیمن \fBvirtnetworkd\fP قادر است در دو حالت راه‌اندازی شود.
.SS "حالت فعال‌سازی سوکت (Socket activation mode)"
.sp
روی میزبان‌های دارای systemd، این دیمن در حالت فعال‌سازی سوکت راه‌اندازی می‌شود و به systemd تکیه می‌کند تا سوکت‌های یونیکس را ایجاد کرده، به آن‌ها گوش دهد و آن‌ها را به عنوان توصیف‌کننده‌های فایل از پیش بازشده تحویل دهد. در این حالت، اغلب گزینه‌های پیکربندی مرتبط با سوکت در \fB/etc/libvirt/virtnetworkd.conf\fP دیگر هیچ اثری نخواهند داشت.
.SS "حالت سرویس سنتی (Traditional service mode)"
.sp
روی میزبان‌های فاقد systemd، این دیمن سوکت‌های یونیکس را مستقیماً خودش ایجاد کرده و به آن‌ها گوش فرا می‌دهد.
.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، دیمن \fBvirtnetworkd\fP پیکربندی خود را دوباره بارگذاری خواهد کرد.
.SH "فایل‌ها (FILES)"
.SS "هنگام اجرا به عنوان کاربر ریشه (root)"
.INDENT 0.0
.IP \(bu 2
\fB/etc/libvirt/virtnetworkd.conf\fP
.UNINDENT
.sp
فایل پیکربندی پیش‌فرضی که توسط \fBvirtnetworkd\fP استفاده می‌شود، مگر اینکه در خط فرمان با استفاده از گزینه \fB\-f\fP | \fB\-\-config\fP جایگزین شده باشد.
.INDENT 0.0
.IP \(bu 2
\fB/run/libvirt/virtnetworkd\-sock\fP
.IP \(bu 2
\fB/run/libvirt/virtnetworkd\-sock\-ro\fP
.IP \(bu 2
\fB/run/libvirt/virtnetworkd\-admin\-sock\fP
.UNINDENT
.sp
سوکت‌هایی که دیمن \fBvirtnetworkd\fP از آن‌ها استفاده خواهد کرد.
.sp
کلید خصوصی TLS سرور که \fBvirtnetworkd\fP استفاده خواهد کرد.
.INDENT 0.0
.IP \(bu 2
\fB/run/virtnetworkd.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/virtnetworkd.conf\fP
.UNINDENT
.sp
فایل پیکربندی پیش‌فرضی که توسط \fBvirtnetworkd\fP استفاده می‌شود، مگر اینکه در خط فرمان با استفاده از گزینه \fB\-f\fP | \fB\-\-config\fP تغییر داده شود.
.INDENT 0.0
.IP \(bu 2
\fB$XDG_RUNTIME_DIR/libvirt/virtnetworkd\-sock\fP
.IP \(bu 2
\fB$XDG_RUNTIME_DIR/libvirt/virtnetworkd\-admin\-sock\fP
.UNINDENT
.sp
سوکت‌هایی که دیمن \fBvirtnetworkd\fP استفاده خواهد کرد.
.INDENT 0.0
.IP \(bu 2
\fB$XDG_RUNTIME_DIR/libvirt/virtnetworkd.pid\fP
.UNINDENT
.sp
فایل PID مورد استفاده، مگر اینکه با گزینه \fB\-p\fP | \fB\-\-pid\-file\fP تغییر داده شود.
.sp
اگر متغیر \fB$XDG_CONFIG_HOME\fP در محیط کاربری شما مقداردهی نشده باشد، دیمن \fBvirtnetworkd\fP از مسیر \fB$HOME/.config\fP استفاده خواهد کرد.
.sp
اگر متغیر \fB$XDG_RUNTIME_DIR\fP در محیط شما تنظیم نشده باشد، دیمن \fBvirtnetworkd\fP از مسیر \fB$HOME/.cache\fP استفاده خواهد کرد.
.SH "مثال‌ها (EXAMPLES)"
.sp
برای دریافت نسخه دیمن \fBvirtnetworkd\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# virtnetworkd \-\-version
virtnetworkd (libvirt) 12.7.0
.EE
.UNINDENT
.UNINDENT
.sp
برای راه‌اندازی دیمن \fBvirtnetworkd\fP، با دستور به دیمن شدن و ایجاد فایل PID:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# virtnetworkd \-d
# ls \-la /run/virtnetworkd.pid
\-rw\-r\-\-r\-\- 1 root root 6 Jul  9 02:40 /run/virtnetworkd.pid
.EE
.UNINDENT
.UNINDENT
.SH "اشکالات (BUGS)"
.sp
لطفاً هرگونه اشکال یا خطای کشف‌شده را گزارش دهید. این کار را می‌توانید از یکی از روش‌های زیر انجام دهید:
.INDENT 0.0
.IP 1. 3
فهرست پستی
.sp
\%<https://libvirt.org/contact.html>
.IP 2. 3
سامانه ثبت اشکالات
.sp
\%<https://libvirt.org/bugs.html>
.UNINDENT
.sp
به عنوان راهکار جایگزین، می‌توانید اشکالات را به توزیع‌کننده یا فروشنده نرم‌افزار خود گزارش کنید.
.SH "نویسندگان (AUTHORS)"
.sp
لطفاً به پرونده AUTHORS که همراه با libvirt توزیع شده است مراجعه فرمایید.
.SH "حق نشر (COPYRIGHT)"
.sp
حق نشر (C) ۲۰۰۶\-۲۰۲۰ متعلق به Red Hat, Inc. و نویسندگان فهرست‌شده در فایل AUTHORS برنامه libvirt.
.SH "مجوز (LICENSE)"
.sp
برنامه \fBvirtnetworkd\fP تحت شرایط مجوز GNU LGPL نسخه ۲.۱ یا بالاتر توزیع می‌شود.
این یک نرم‌افزار آزاد است؛ برای شرایط رونوشت‌برداری به متن منبع مراجعه کنید. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای ضمانت تجاری بودن یا مناسب بودن برای یک منظور خاص.
.SH "همچنین ببینید (SEE ALSO)"
.sp
virsh(1), libvirtd(8),
\%<https://libvirt.org/daemons.html>
.\" End of generated man page.