libguestfs-test-tool(1)     Virtualization Support     libguestfs-test-tool(1)


نام (NAME)
       libguestfs-test-tool - عیب‌یابی و آزمایش اولیه عملکرد libguestfs

خلاصه دستور (SYNOPSIS)
        libguestfs-test-tool [--options]

توضیحات (DESCRIPTION)
       برنامه libguestfs-test-tool یک ابزار آزمایشی ارائه‌شده همراه با
       libguestfs است تا به شما امکان دهد از عملکرد صحیح قابلیت‌های پایه‌ای
       libguestfs اطمینان حاصل کنید. این ابزار به این دلیل مورد نیاز است که
       گاهی اوقات libguestfs به دلایلی خارج از کنترل ما دچار اختلال می‌شود؛ این
       امر معمولاً به دلیل تغییرات در بسته‌های زیربنایی qemu یا هسته، یا تغییرات
       در محیط میزبان رخ می‌دهد.

       اگر مشکوک به وجود مشکلی در libguestfs هستید، کافی است دستور زیر را اجرا
       کنید:

        libguestfs-test-tool

       این دستور پیام‌های عیب‌یابی فراوانی را چاپ خواهد کرد.

       اگر اجرا با موفقیت به پایان برسد، این خط را در نزدیکی انتهای خروجی
       مشاهده خواهید کرد:

        ===== TEST FINISHED OK =====

       و ابزار آزمایش با کد وضعیت 0 خارج خواهد شد.

       اگر با شکست مواجه شد (و/یا با کد خطای غیرصفر خارج شد)، لطفاً خروجی کامل
       و ویرایش‌نشده ابزار آزمایش را در یک گزارش اشکال قرار دهید. اطلاعات بیشتر
       درباره گزارش اشکالات را می‌توانید در وب‌سایت http://libguestfs.org
       بیابید.

گزینه‌ها (OPTIONS)
       --help
           نمایش اطلاعات کوتاه درباره نحوه استفاده و خروج.

       --qemu qemu_binary
           اگر یک باینری qemu دیگر را دانلود کرده‌اید، این گزینه را به مسیر
           کامل آن باینری هدایت کنید تا آزمایش شود.

       --qemudir qemu_source_dir
           اگر qemu را از کد منبع کامپایل کرده‌اید، این گزینه را به دایرکتوری
           منبع هدایت کنید تا آزمایش شود.

       -t N
       --timeout N
           تنظیم مهلت زمانی راه‌اندازی بر حسب "N" ثانیه. مقدار پیش‌فرض ۶۰۰ ثانیه
           (۱۰ دقیقه) است که معمولاً نیازی به تنظیم آن نیست.

       -V
       --version
           نمایش شماره نسخه libguestfs و خروج.

آزمایش نسخه دیگری از QEMU (TRYING OUT A DIFFERENT VERSION OF QEMU)
       اگر نسخه دیگری از qemu را از کد منبع کامپایل کرده‌اید و مایلید آن را
       آزمایش کنید، می‌توانید از گزینه --qemudir برای اشاره به دایرکتوری منبع
       qemu استفاده کنید.

       اگر یک فایل باینری qemu را دانلود کرده‌اید، از گزینه --qemu برای اشاره
       به آن باینری استفاده کنید.

       توجه داشته باشید که هنگام استفاده از این گزینه‌ها، می‌توانید ماجرای
       اسکریپت‌های لفاف qemu («QEMU WRAPPERS» در guestfs(3)) را نادیده بگیرید،
       زیرا libguestfs-test-tool در صورت نیاز، خودش یک اسکریپت لفاف برای شما
       ایجاد می‌کند.

آزمایش هسته متفاوت (TRYING OUT A DIFFERENT KERNEL)
       می‌توانید به supermin اعلام کنید که هسته متفاوتی را امتحان کند. این کار
       را با تنظیم متغیرهای محیطی "SUPERMIN_KERNEL"، "SUPERMIN_KERNEL_VERSION"
       و/یا "SUPERMIN_MODULES" انجام دهید.

       برای اطلاعات بیشتر به «ENVIRONMENT VARIABLES» در supermin(1) مراجعه
       کنید.

آزمایش نسخه متفاوتی از LIBVIRT (TRYING OUT A DIFFERENT VERSION OF LIBVIRT)
       برای آگاهی از اینکه کدام بک‌اند به‌طور پیش‌فرض در بسته libguestfs شما
       استفاده می‌شود، دستور زیر را اجرا کنید:

        unset LIBGUESTFS_BACKEND
        guestfish get-backend

       اگر از بک‌اند libvirt استفاده می‌کنید، می‌توانید با اجرای این دستورات (نه
       به‌عنوان کاربر ریشه):

        killall libvirtd lt-libvirtd
        ~/path/to/libvirt/run libguestfs-test-tool

       یک نسخه متفاوت (مثلاً بالادستی یا upstream) از libvirt را آزمایش کنید.
       دستور اول هر پردازه نشست "libvirtd" را که ممکن است روی سیستم در حال
       اجرا باشد متوقف می‌کند. دستور دوم از اسکریپت "run" مربوط به libvirt (در
       دایرکتوری سطح بالای ساخت libvirt) برای تنظیم برخی متغیرهای محیطی
       استفاده می‌کند تا از نسخه جایگزین libvirt برای اجرای برنامه استفاده شود.

آزمایش با یا بدون LIBVIRT (TRYING OUT WITH / WITHOUT LIBVIRT)
       برای آگاهی از اینکه کدام بک‌اند در بسته libguestfs شما پیش‌فرض است، دستور
       زیر را اجرا کنید:

        unset LIBGUESTFS_BACKEND
        guestfish get-backend

       اگر از بک‌اند libvirt استفاده می‌کنید، می‌توانید آن را بدون libvirt (یعنی
       اجرای مستقیم qemu توسط libguestfs) با انجام دستور زیر آزمایش کنید:

        export LIBGUESTFS_BACKEND=direct

       یا اگر از بک‌اند پیش‌فرض (direct) استفاده می‌کنید، می‌توانید libvirt را
       امتحان کنید:

        export LIBGUESTFS_BACKEND=libvirt

       یا با libvirt و یک شناسه منبع یکپارچه (URI) خاص:

        export LIBGUESTFS_BACKEND=libvirt:qemu:///session

آزمایش تنظیمات مختلف SELINUX (TRYING OUT DIFFERENT SELINUX SETTINGS)
       برای آگاهی از اینکه کدام بک‌اند در بسته libguestfs شما پیش‌فرض است، دستور
       زیر را اجرا کنید:

        unset LIBGUESTFS_BACKEND
        guestfish get-backend

       برای اینکه بفهمید آیا SELinux در حال استفاده است یا خیر، اجرا کنید:

        getenforce

       اگر از libvirt، SELinux و sVirt استفاده می‌کنید، می‌توانید بررسی کنید که
       آیا تغییر حالت SELinux به «permissive» (مداراگرا) تفاوتی ایجاد می‌کند یا
       خیر. این دستور را به‌عنوان کاربر ریشه اجرا کنید:

        setenforce Permissive

       اگر این کار تفاوتی ایجاد کرد، در گزارش‌های بازرسی (audit logs) به دنبال
       خطاهای اخیر («AVCs») بگردید:

        ausearch -m avc -ts recent

       می‌توانید با استفاده از ابزارهایی مانند audit2allow(1) پیام‌های AVC را به
       قوانین پیشنهادی خط‌مشی SELinux تبدیل کنید. برای اطلاعات بیشتر، «Security
       Enhanced Linux User Guide» را ببینید.

       برای فعال‌سازی دوباره SELinux و sVirt، دستور زیر را اجرا کنید:

        setenforce Enforcing

خودعیب‌یابی (SELF-DIAGNOSIS)
       برای درک پیام‌های تولیدشده توسط libguestfs-test-tool و/یا خطاهای
       احتمالی، به بخش «APPLIANCE BOOT PROCESS» در guestfs(3) مراجعه کنید.

وضعیت خروج (EXIT STATUS)
       دستور libguestfs-test-tool اگر آزمایش‌ها بدون خطا تکمیل شوند مقدار 0 و
       در صورت بروز خطا مقدار 1 را برمی‌گرداند.

متغیرهای محیطی (ENVIRONMENT VARIABLES)
       برای فهرست کامل متغیرهای محیطی که ممکن است بر libguestfs تأثیر بگذارند،
       لطفاً صفحه راهنمای guestfs(3) را مشاهده فرمایید.

همچنین ببینید (SEE ALSO)
       guestfs(3), http://libguestfs.org, http://qemu.org

نویسندگان (AUTHORS)
       Richard W.M. Jones ("rjones at redhat dot com")

حق نشر (COPYRIGHT)
       Copyright (C) 2009-2025 Red Hat Inc.

مجوز (LICENSE)
       این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی
       همگانی گنو (GNU General Public License) منتشرشده توسط بنیاد نرم‌افزارهای
       آزاد؛ طبق نسخه ۲ مجوز یا (به دلخواه خود) هر نسخه بالاتر، بازتوزیع کرده
       و/یا تغییر دهید.

       این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه
       ضمانت؛ حتی ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف مشخص. برای
       اطلاعات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

       شما باید همراه با این برنامه نسخه‌ای از مجوز عمومی همگانی گنو را دریافت
       کرده باشید؛ در غیر این صورت به آدرس زیر مکاتبه فرمایید: Free Software
       Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
       02110-1301 USA.

اشکالات (BUGS)
       برای دریافت فهرست اشکالات ثبت‌شده علیه libguestfs، از این پیوند استفاده
       کنید:
       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

       برای گزارش یک اشکال جدید در libguestfs، از این پیوند استفاده کنید:
       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

       هنگام گزارش اشکال، لطفاً موارد زیر را ارائه دهید:

       •   نسخه libguestfs.

       •   محل دریافت libguestfs (برای مثال کدام توزیع لینوکس، کامپایل از کد
           منبع و غیره)

       •   توصیف دقیق اشکال و ارائه روشی برای بازتولید آن.

       •   دستور libguestfs-test-tool(1) را اجرا کرده و خروجی کامل و
           ویرایش‌نشده را درون گزارش اشکال قرار دهید.

libguestfs-1.60.1                 2026-07-14           libguestfs-test-tool(1)