virtnetworkd(8)              پشتیبانی از مجازی‌سازی             virtnetworkd(8)

نام (NAME)
       virtnetworkd - دیمن مدیریت شبکه مجازی libvirt

خلاصه دستور (SYNOPSIS)
       virtnetworkd [گزینه‌ها]...

توضیحات (DESCRIPTION)
       برنامه virtnetworkd یک مؤلفه دیمن سمت سرور از سیستم مدیریت مجازی‌سازی
       libvirt است.

       این دیمن یکی از اعضای مجموعه‌ای از دیمن‌های ماژولار است که جایگزین
       عملکردهایی شده‌اند که قبلاً توسط دیمن یکپارچه libvirtd ارائه می‌شد.

       این دیمن روی میزبان‌های مجازی‌سازی اجرا می‌شود تا قابلیت مدیریت شبکه‌های
       مجازی را فراهم کند.

       دیمن virtnetworkd تنها به درخواست‌های ارسال‌شده روی سوکت محلی دامنه
       یونیکس (Unix domain socket) گوش می‌دهد. دسترسی از راه دور از طریق
       TLS/TCP و سازگاری رو‌به‌عقب با کلاینت‌های قدیمی‌تری که انتظار حضور libvirtd
       را دارند، توسط دیمن virtproxyd ارائه می‌شود.

       راه‌اندازی مجدد virtnetworkd عملکرد ماشین‌های میهمان در حال اجرا را مختل
       نمی‌کند. میهمان‌ها به کار خود ادامه می‌دهند و تغییرات در وضعیت آن‌ها معمولاً
       به طور خودکار در زمان راه‌اندازی شناسایی می‌شود. با این حال توصیه می‌شود
       تا جای ممکن از راه‌اندازی مجدد سرویس هنگام اجرای میهمان‌ها خودداری شود.

حالت‌های راه‌اندازی دیمن (DAEMON STARTUP MODES)
       دیمن virtnetworkd قادر است در دو حالت راه‌اندازی شود.

   حالت فعال‌سازی سوکت (Socket activation mode)
       روی میزبان‌های دارای systemd، این دیمن در حالت فعال‌سازی سوکت راه‌اندازی
       می‌شود و به systemd تکیه می‌کند تا سوکت‌های یونیکس را ایجاد کرده، به آن‌ها
       گوش دهد و آن‌ها را به عنوان توصیف‌کننده‌های فایل از پیش بازشده تحویل دهد.
       در این حالت، اغلب گزینه‌های پیکربندی مرتبط با سوکت در
       /etc/libvirt/virtnetworkd.conf دیگر هیچ اثری نخواهند داشت.

   حالت سرویس سنتی (Traditional service mode)
       روی میزبان‌های فاقد systemd، این دیمن سوکت‌های یونیکس را مستقیماً خودش
       ایجاد کرده و به آن‌ها گوش فرا می‌دهد.

گزینه‌ها (OPTIONS)
       -h, --help

       نمایش راهنمای استفاده در خط فرمان و سپس خروج.

       -d, --daemon

       اجرا به صورت یک دیمن و نوشتن فایل PID.

       -f, --config *FILE*

       استفاده از این فایل پیکربندی به جای مقدار پیش‌فرض.

       -p, --pid-file *FILE*

       استفاده از این نام برای فایل PID به جای مقدار پیش‌فرض.

       -t, --timeout *SECONDS*

       خروج پس از اتمام مدت زمان انتظار (به ثانیه)، به شرط آن‌که هیچ اتصال
       کلاینتی وجود نداشته باشد.

       -v, --verbose

       فعال‌سازی خروجی پیام‌های پرجزئیات.

       --version

       نمایش اطلاعات نسخه و سپس خروج.

سیگنال‌ها (SIGNALS)
       با دریافت سیگنال SIGHUP، دیمن virtnetworkd پیکربندی خود را دوباره
       بارگذاری خواهد کرد.

فایل‌ها (FILES)
   هنگام اجرا به عنوان کاربر ریشه (root)

       • /etc/libvirt/virtnetworkd.conf

       فایل پیکربندی پیش‌فرضی که توسط virtnetworkd استفاده می‌شود، مگر اینکه در
       خط فرمان با استفاده از گزینه -f | --config جایگزین شده باشد.

       • /run/libvirt/virtnetworkd-sock

       • /run/libvirt/virtnetworkd-sock-ro

       • /run/libvirt/virtnetworkd-admin-sock

       سوکت‌هایی که دیمن virtnetworkd از آن‌ها استفاده خواهد کرد.

       کلید خصوصی TLS سرور که virtnetworkd استفاده خواهد کرد.

       • /run/virtnetworkd.pid

       فایل PID مورد استفاده، مگر اینکه با گزینه -p | --pid-file تغییر داده
       شود.

   هنگام اجرا به عنوان کاربر غیر ریشه (non-root)

       • $XDG_CONFIG_HOME/libvirt/virtnetworkd.conf

       فایل پیکربندی پیش‌فرضی که توسط virtnetworkd استفاده می‌شود، مگر اینکه در
       خط فرمان با استفاده از گزینه -f | --config تغییر داده شود.

       • $XDG_RUNTIME_DIR/libvirt/virtnetworkd-sock

       • $XDG_RUNTIME_DIR/libvirt/virtnetworkd-admin-sock

       سوکت‌هایی که دیمن virtnetworkd استفاده خواهد کرد.

       • $XDG_RUNTIME_DIR/libvirt/virtnetworkd.pid

       فایل PID مورد استفاده، مگر اینکه با گزینه -p | --pid-file تغییر داده
       شود.

       اگر متغیر $XDG_CONFIG_HOME در محیط کاربری شما مقداردهی نشده باشد، دیمن
       virtnetworkd از مسیر $HOME/.config استفاده خواهد کرد.

       اگر متغیر $XDG_RUNTIME_DIR در محیط شما تنظیم نشده باشد، دیمن
       virtnetworkd از مسیر $HOME/.cache استفاده خواهد کرد.

مثال‌ها (EXAMPLES)
       برای دریافت نسخه دیمن virtnetworkd:

          # virtnetworkd --version
          virtnetworkd (libvirt) 12.7.0

       برای راه‌اندازی دیمن virtnetworkd، با دستور به دیمن شدن و ایجاد فایل
       PID:

          # virtnetworkd -d
          # ls -la /run/virtnetworkd.pid
          -rw-r--r-- 1 root root 6 Jul  9 02:40 /run/virtnetworkd.pid

اشکالات (BUGS)
       لطفاً هرگونه اشکال یا خطای کشف‌شده را گزارش دهید. این کار را می‌توانید از
       یکی از روش‌های زیر انجام دهید:

       1. فهرست پستی

          <https://libvirt.org/contact.html>

       2. سامانه ثبت اشکالات

          <https://libvirt.org/bugs.html>

       به عنوان راهکار جایگزین، می‌توانید اشکالات را به توزیع‌کننده یا فروشنده
       نرم‌افزار خود گزارش کنید.

نویسندگان (AUTHORS)
       لطفاً به پرونده AUTHORS که همراه با libvirt توزیع شده است مراجعه
       فرمایید.

حق نشر (COPYRIGHT)
       حق نشر (C) ۲۰۰۶-۲۰۲۰ متعلق به Red Hat, Inc. و نویسندگان فهرست‌شده در
       فایل AUTHORS برنامه libvirt.

مجوز (LICENSE)
       برنامه virtnetworkd تحت شرایط مجوز GNU LGPL نسخه ۲.۱ یا بالاتر توزیع
       می‌شود.  این یک نرم‌افزار آزاد است؛ برای شرایط رونوشت‌برداری به متن منبع
       مراجعه کنید. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای ضمانت تجاری بودن یا
       مناسب بودن برای یک منظور خاص.

همچنین ببینید (SEE ALSO)
       virsh(1), libvirtd(8), <https://libvirt.org/daemons.html>

                                                               virtnetworkd(8)