.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 1.60.1 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "libguestfs-make-fixed-appliance 1"
.TH libguestfs-make-fixed-appliance 1 2026-07-14 libguestfs-1.60.1 "Virtualization Support"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
libguestfs\-make\-fixed\-appliance \- ساخت یک appliance ثابت برای libguestfs
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& libguestfs\-make\-fixed\-appliance [\-\-options] OUTPUTDIR
\&
\& libguestfs\-make\-fixed\-appliance [\-\-options] \-\-xz
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور libguestfs\-make\-fixed\-appliance به شما امکان می‌دهد یک appliance دودویی از پیش‌ساخته برای libguestfs بسازید.
.PP
\&\fBتوجه داشته باشید که کاربران عادی نیازی به اجرای این ابزار ندارند\fR.
.PP
برخی از دلایلی که \fIممکن است\fR بخواهید از این ابزار استفاده کنید عبارتند از:
.IP \(bu 4
می‌خواهید یک appliance مستقل برای libguestfs بسازید که بتوان آن را به ماشین یا پلتفرم دیگری که از \fBsupermin\fR\|(1) پشتیبانی نمی‌کند، منتقل کرد.
.IP \(bu 4
چندین کاربر روی یک ماشین دارید و می‌خواهید از تکرار ذخیره‌سازی و بار اضافی راه‌اندازی ناشی از وجود چندین نسخه کَش‌شده از appliance جلوگیری کنید.
.IP \(bu 4
می‌خواهید کارایی کاملاً قابل‌پیش‌بینی از libguestfs داشته باشید (به \fBguestfs\-performance\fR\|(1) مراجعه کنید).
.PP
برای درک عمیق‌تر اینکه چرا ممکن است به این ابزار نیاز داشته باشید، بخش «FIXED APPLIANCE» را در \fBguestfs\-internals\fR\|(1) مطالعه کنید.
.PP
به جای اجرای این ابزار، می‌توانید applianceهای ثابت را از
http://libguestfs.org/download/binaries/appliance
بارگیری کنید. این applianceها با استفاده از همین ابزار ساخته شده‌اند.
.PP
دو روش برای استفاده از این ابزار وجود دارد:
.IP \(bu 4
یک دایرکتوری خروجی مشخص کنید، به عنوان مثال:
.Sp
.Vb 1
\& libguestfs\-make\-fixed\-appliance /usr/local/lib/guestfs/appliance
.Ve
.Sp
دایرکتوری خروجی در صورت عدم وجود ایجاد می‌شود. چهار فایل در این دایرکتوری ایجاد می‌گردند:
.Sp
.Vb 4
\& <OUTPUTDIR>/kernel
\& <OUTPUTDIR>/initrd
\& <OUTPUTDIR>/root
\& <OUTPUTDIR>/README.fixed
.Ve
.Sp
توجه داشته باشید که \f(CW\*(C`\fR\f(CIOUTPUTDIR\fR\f(CW/root\*(C'\fR یک فایل پراکنده (sparse file) است، بنابراین هنگام کپی کردن آن دقت کنید.
.Sp
سپس می‌توانید با تنظیم متغیر محیطی LIBGUESTFS_PATH روی \f(CW\*(C`OUTPUTDIR\*(C'\fR (احتمالاً پس از کپی کردن این دایرکتوری به ماشینی دیگر)، libguestfs را اجرا کنید.
.IP \(bu 4
روش جایگزین استفاده از گزینهٔ \fI\-\-xz\fR برای ساخت یک فایل تاربال فشرده است:
.Sp
.Vb 1
\& libguestfs\-make\-fixed\-appliance \-\-xz
.Ve
.Sp
این کار یک فایل تاربال در دایرکتوری \fIفعلی\fR ایجاد می‌کند به نام:
.Sp
.Vb 1
\& appliance\-<VERSION>.tar.xz
.Ve
.Sp
(که در آن \f(CW\*(C`VERSION\*(C'\fR نسخهٔ libguestfs است). تاربال شامل این چهار فایل است:
.Sp
.Vb 4
\& appliance/kernel
\& appliance/initrd
\& appliance/root
\& appliance/README.fixed
.Ve
.Sp
توجه داشته باشید که \f(CW\*(C`appliance/root\*(C'\fR یک فایل پراکنده (sparse file) است، بنابراین هنگام کپی کردن آن دقت کنید.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش اطلاعات کوتاه درباره نحوه استفاده و خروج.
.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
نمایش شماره نسخه و خروج.
.IP \fB\-\-xz\fR 4
.IX Item "--xz"
به جای ایجاد appliance در یک دایرکتوری خروجی، یک تاربال فشرده از appliance را در دایرکتوری جاری با نام \&\fIappliance\-VERSION.tar.xz\fR می‌سازد که در آن \f(CW\*(C`VERSION\*(C'\fR نسخهٔ libguestfs است.
.Sp
استفاده از \fI\-\-xz\fR ممکن است زمان‌بر باشد. در صورت عملکرد عادی، این ابزار در حین اجرا کاملاً بی‌صدا است.
.SH "مجوزها (LICENSING)"
.IX Header "LICENSING"
این appliance ثابت یک توزیع دودویی لینوکس کامل است. در صورتی که آن را بازتوزیع کنید، ممکن است برای انطباق قانونی با مجوزهای نرم‌افزارهای موجود در appliance (مانند پروانه عمومی همگانی گنو یا GNU General Public License) نیاز به توزیع کدهای منبع متناظر داشته باشید.
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
اگر appliance بدون خطا ساخته شود، libguestfs\-make\-fixed\-appliance مقدار \fI0\fR را برمی‌گرداند.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.IX Header "ENVIRONMENT VARIABLES"
برای فهرست کامل متغیرهای محیطی که ممکن است بر libguestfs تأثیر بگذارند، لطفاً صفحه راهنمای \fBguestfs\fR\|(3) را ببینید.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBguestfs\fR\|(3),
\&\fBsupermin\fR\|(1),
\&\fBxz\fR\|(1),
http://libguestfs.org,
http://qemu.org.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Richard W.M. Jones (\f(CW\*(C`rjones at redhat dot com\*(C'\fR)
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2025 Red Hat Inc.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation) منتشر شده است، چه نسخهٔ ۲ پروانه و چه (به انتخاب خودتان) هر نسخهٔ بعدی دیگری، بازتوزیع کرده و/یا تغییر دهید.
.PP
این برنامه با این امید توزیع شده است که سودمند باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به GNU General Public License مراجعه کنید.
.PP
شما باید به همراه این برنامه یک نسخه از GNU General Public License را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر مکاتبه کنید:
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
.SH "گزارش باگ‌ها (BUGS)"
.IX Header "BUGS"
برای دریافت فهرستی از باگ‌های libguestfs، از این پیوند استفاده کنید:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
.PP
برای گزارش یک باگ جدید علیه libguestfs، از این پیوند استفاده کنید:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
هنگام گزارش یک باگ، لطفاً موارد زیر را ارائه دهید:
.IP \(bu 4
نسخهٔ libguestfs.
.IP \(bu 4
مکانی که libguestfs را از آن دریافت کرده‌اید (مثلاً کدام توزیع لینوکس، کامپایل‌شده از سورس و غیره).
.IP \(bu 4
باگ را به طور دقیق توصیف کرده و روشی برای بازتولید آن ارائه دهید.
.IP \(bu 4
دستور \fBlibguestfs\-test\-tool\fR\|(1) را اجرا کرده و خروجی \fBکامل و ویرایش‌نشدهٔ\fR آن را در گزارش باگ قرار دهید.