نام (NAME)

libguestfs-make-fixed-appliance - ساخت یک appliance ثابت برای libguestfs

خلاصه دستور (SYNOPSIS)

libguestfs-make-fixed-appliance [--options] OUTPUTDIR
libguestfs-make-fixed-appliance [--options] --xz

توضیحات (DESCRIPTION)

دستور libguestfs-make-fixed-appliance به شما امکان می‌دهد یک appliance دودویی از پیش‌ساخته برای libguestfs بسازید.

توجه داشته باشید که کاربران عادی نیازی به اجرای این ابزار ندارند.

برخی از دلایلی که ممکن است بخواهید از این ابزار استفاده کنید عبارتند از:

• می‌خواهید یک appliance مستقل برای libguestfs بسازید که بتوان آن را به ماشین یا پلتفرم دیگری که از supermin(1) پشتیبانی نمی‌کند، منتقل کرد.
• چندین کاربر روی یک ماشین دارید و می‌خواهید از تکرار ذخیره‌سازی و بار اضافی راه‌اندازی ناشی از وجود چندین نسخه کَش‌شده از appliance جلوگیری کنید.
• می‌خواهید کارایی کاملاً قابل‌پیش‌بینی از libguestfs داشته باشید (به guestfs-performance(1) مراجعه کنید).

برای درک عمیق‌تر اینکه چرا ممکن است به این ابزار نیاز داشته باشید، بخش «FIXED APPLIANCE» را در guestfs-internals(1) مطالعه کنید.

به جای اجرای این ابزار، می‌توانید applianceهای ثابت را از http://libguestfs.org/download/binaries/appliance بارگیری کنید. این applianceها با استفاده از همین ابزار ساخته شده‌اند.

دو روش برای استفاده از این ابزار وجود دارد:

• یک دایرکتوری خروجی مشخص کنید، به عنوان مثال:

  libguestfs-make-fixed-appliance /usr/local/lib/guestfs/appliance

  دایرکتوری خروجی در صورت عدم وجود ایجاد می‌شود. چهار فایل در این دایرکتوری ایجاد می‌گردند:

  <OUTPUTDIR>/kernel
  <OUTPUTDIR>/initrd
  <OUTPUTDIR>/root
  <OUTPUTDIR>/README.fixed

  توجه داشته باشید که "OUTPUTDIR/root" یک فایل پراکنده (sparse file) است، بنابراین هنگام کپی کردن آن دقت کنید.

  سپس می‌توانید با تنظیم متغیر محیطی LIBGUESTFS_PATH روی "OUTPUTDIR" (احتمالاً پس از کپی کردن این دایرکتوری به ماشینی دیگر)، libguestfs را اجرا کنید.

• روش جایگزین استفاده از گزینهٔ --xz برای ساخت یک فایل تاربال فشرده است:

  libguestfs-make-fixed-appliance --xz

  این کار یک فایل تاربال در دایرکتوری فعلی ایجاد می‌کند به نام:

  appliance-<VERSION>.tar.xz

  (که در آن "VERSION" نسخهٔ libguestfs است). تاربال شامل این چهار فایل است:

  appliance/kernel
  appliance/initrd
  appliance/root
  appliance/README.fixed

  توجه داشته باشید که "appliance/root" یک فایل پراکنده (sparse file) است، بنابراین هنگام کپی کردن آن دقت کنید.

گزینه‌ها (OPTIONS)

--help

نمایش اطلاعات کوتاه درباره نحوه استفاده و خروج.

-V

--version

نمایش شماره نسخه و خروج.

--xz

به جای ایجاد appliance در یک دایرکتوری خروجی، یک تاربال فشرده از appliance را در دایرکتوری جاری با نام appliance-VERSION.tar.xz می‌سازد که در آن "VERSION" نسخهٔ libguestfs است.

استفاده از --xz ممکن است زمان‌بر باشد. در صورت عملکرد عادی، این ابزار در حین اجرا کاملاً بی‌صدا است.

مجوزها (LICENSING)

این appliance ثابت یک توزیع دودویی لینوکس کامل است. در صورتی که آن را بازتوزیع کنید، ممکن است برای انطباق قانونی با مجوزهای نرم‌افزارهای موجود در appliance (مانند پروانه عمومی همگانی گنو یا GNU General Public License) نیاز به توزیع کدهای منبع متناظر داشته باشید.

وضعیت خروج (EXIT STATUS)

اگر appliance بدون خطا ساخته شود، libguestfs-make-fixed-appliance مقدار 0 را برمی‌گرداند.

متغیرهای محیطی (ENVIRONMENT VARIABLES)

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

همچنین ببینید (SEE ALSO)

guestfs(3), supermin(1), xz(1), 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) منتشر شده است، چه نسخهٔ ۲ پروانه و چه (به انتخاب خودتان) هر نسخهٔ بعدی دیگری، بازتوزیع کرده و/یا تغییر دهید.

این برنامه با این امید توزیع شده است که سودمند باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به GNU General Public 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) را اجرا کرده و خروجی کامل و ویرایش‌نشدهٔ آن را در گزارش باگ قرار دهید.