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

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

libguestfs-test-tool [--options]

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

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

libguestfs-test-tool

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

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

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

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

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

نمایش اطلاعات کوتاه درباره نحوه استفاده و خروج.
اگر یک باینری qemu دیگر را دانلود کرده‌اید، این گزینه را به مسیر کامل آن باینری هدایت کنید تا آزمایش شود.
اگر qemu را از کد منبع کامپایل کرده‌اید، این گزینه را به دایرکتوری منبع هدایت کنید تا آزمایش شود.
تنظیم مهلت زمانی راه‌اندازی بر حسب "N" ثانیه. مقدار پیش‌فرض ۶۰۰ ثانیه (۱۰ دقیقه) است که معمولاً نیازی به تنظیم آن نیست.
نمایش شماره نسخه libguestfs و خروج.

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

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

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

می‌توانید به supermin اعلام کنید که هسته متفاوتی را امتحان کند. این کار را با تنظیم متغیرهای محیطی "SUPERMIN_KERNEL"، "SUPERMIN_KERNEL_VERSION" و/یا "SUPERMIN_MODULES" انجام دهید.

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

برای آگاهی از اینکه کدام بک‌اند به‌طور پیش‌فرض در بسته 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 برای اجرای برنامه استفاده شود.

برای آگاهی از اینکه کدام بک‌اند در بسته 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

برای آگاهی از اینکه کدام بک‌اند در بسته 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

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

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

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

guestfs(3), http://libguestfs.org, http://qemu.org

Richard W.M. Jones ("rjones at redhat dot com")

Copyright (C) 2009-2025 Red Hat Inc.

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

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

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

برای دریافت فهرست اشکالات ثبت‌شده علیه 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) را اجرا کرده و خروجی کامل و ویرایش‌نشده را درون گزارش اشکال قرار دهید.
2026-07-14 libguestfs-1.60.1