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

نام (NAME)
       virtinterfaced - دیمن مدیریت رابط‌های شبکه میزبان در libvirt

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

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

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

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

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

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

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

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

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

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

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

       -d, --daemon

       اجرا به عنوان یک دیمن و نوشتن فایل شناسه فرآیند (PID).

       -f, --config *FILE*

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

       -p, --pid-file *FILE*

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

       -t, --timeout *SECONDS*

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

       -v, --verbose

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

       --version

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

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

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

       • /etc/libvirt/virtinterfaced.conf

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

       • /run/libvirt/virtinterfaced-sock

       • /run/libvirt/virtinterfaced-sock-ro

       • /run/libvirt/virtinterfaced-admin-sock

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

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

       • /run/virtinterfaced.pid

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

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

       • $XDG_CONFIG_HOME/libvirt/virtinterfaced.conf

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

       • $XDG_RUNTIME_DIR/libvirt/virtinterfaced-sock

       • $XDG_RUNTIME_DIR/libvirt/virtinterfaced-admin-sock

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

       • $XDG_RUNTIME_DIR/libvirt/virtinterfaced.pid

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

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

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

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

          # virtinterfaced --version
          virtinterfaced (libvirt) 12.7.0

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

          # virtinterfaced -d
          # ls -la /run/virtinterfaced.pid
          -rw-r--r-- 1 root root 6 Jul  9 02:40 /run/virtinterfaced.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)
       برنامه virtinterfaced تحت شرایط مجوز GNU LGPL نسخه ۲.۱ یا بالاتر توزیع
       می‌شود.  این یک نرم‌افزار آزاد است؛ برای شرایط رونوشت‌برداری به متن منبع
       مراجعه کنید. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای ضمانت تجاری بودن یا
       مناسب بودن برای یک منظور خاص.

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

                                                             virtinterfaced(8)