.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (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
.\" ========================================================================
.\"
.IX Title "SUPERMIN 1"
.TH SUPERMIN 1 2023-11-16 supermin-5.3.3 "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)"
supermin \- ابزاری برای ایجاد و ساخت اپلاینس‌های supermin
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& supermin \-\-prepare \-o OUTPUTDIR PACKAGE [PACKAGE ...]
\&
\& supermin \-\-build \-o OUTPUTDIR \-f chroot|ext2 INPUT [INPUT ...]
.Ve
.SH "مثال (EXAMPLE)"
.IX Header "EXAMPLE"
.Vb 1
\& supermin \-\-prepare bash util\-linux \-o /tmp/supermin.d
\& 
\& cat > init <<EOF
\& #!/bin/sh
\& mount \-t proc /proc /proc
\& mount \-t sysfs /sys /sys
\& echo Welcome to supermin
\& bash \-i
\& EOF
\& 
\& chmod +x init
\& tar zcf /tmp/supermin.d/init.tar.gz ./init
\& 
\& supermin \-\-build /tmp/supermin.d \-f ext2 \-o /tmp/appliance.d
\& 
\& qemu\-kvm \-nodefaults \-nographic \e
\&          \-kernel /tmp/appliance.d/kernel \e
\&          \-initrd /tmp/appliance.d/initrd \e
\&          \-hda /tmp/appliance.d/root \e
\&          \-serial stdio \-append "console=ttyS0 root=/dev/sda"
\& ...
\& Welcome to supermin
\& bash\-4.3#
.Ve.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
ابزار supermin برای ساخت اپلاینس‌های supermin است. این‌ها اپلاینس‌هایی بسیار کوچک (مشابه ماشین‌های مجازی) هستند که معمولاً حجمی حدود ۱۰۰ کیلوبایت دارند و در کسری از ثانیه به‌صورت در لحظه (on-the-fly) هنگامی که نیاز به بوت کردن یکی از آن‌ها داشته باشید، کاملاً نمونه‌سازی و راه‌اندازی می‌شوند.
.PP
این برنامه پیش‌تر febootstrap نامیده می‌شد. این صفحهٔ راهنما مستندات supermin 5.x را ارائه می‌دهد که یک بازنویسی کامل بوده و تفاوت زیادی با febootstrap 2.x دارد. اگر به دنبال ابزارهای febootstrap 2.x هستید، این مستند جای مناسبی برای آن نیست.
.SS "عملیات پایه (BASIC OPERATION)"
.IX Subsection "BASIC OPERATION"
ابزار supermin می‌تواند در دو حالت استفاده شود: \fBآماده‌سازی (preparing)\fR یک اپلاینس کوچک supermin، که بر روی سیستم ساخت (build system) انجام می‌شود؛ و \fBساخت (building)\fR، که اپلاینس supermin را گرفته و یک اپلاینس کامل و قابل بوت می‌سازد، که بر روی سیستم کاربر نهایی انجام می‌پذیرد.
.PP
نیازی نیست supermin با دسترسی ریشه (root) اجرا شود، و به‌طور کلی \fIنباید\fR با دسترسی ریشه اجرا گردد. این برنامه هیچ تأثیری بر سیستم میزبان یا بسته‌های نصب‌شده بر روی سیستم میزبان نمی‌گذارد.
.PP
\fIحالت آماده‌سازی (PREPARE MODE)\fR
.IX Subsection "PREPARE MODE"
.PP
گزینهٔ \&\fI\-\-prepare\fR اپلاینس کوچک supermin را در دایرکتوری خروجی داده‌شده ایجاد می‌کند. شما فهرستی از بسته‌هایی را که می‌خواهید نصب شوند مشخص می‌کنید و supermin به‌طور خودکار وابستگی‌های آن‌ها را پیدا خواهد کرد. فهرست بسته‌ها باید بر روی ماشین میزبان نصب شده باشد.
.PP
برای مثال:
.PP
.Vb 1
\& supermin \-\-prepare bash coreutils \-o supermin.d
.Ve
.PP
یک اپلاینس supermin حاوی بسته‌های \f(CW\*(C`bash\*(C'\fR و \&\f(CW\*(C`coreutils\*(C'\fR می‌سازد. به‌طور دقیق‌تر، این دستور فایل‌هایی در دایرکتوری \&\fIsupermin.d\fR ایجاد می‌کند. این دایرکتوری \fIهمان\fR اپلاینس supermin است. (بخش «SUPERMIN APPLIANCES» در زیر را ببینید).
.PP
هدف این است که مرحلهٔ \fI\-\-prepare\fR روی یک سیستم ساخت مرکزی انجام گیرد و اپلاینس supermin بین کاربران نهایی توزیع شود (که به دلیل اندازهٔ بسیار کوچک اپلاینس‌های supermin، کاری بسیار آسان است).
.PP
\fIحالت ساخت (BUILD MODE)\fR
.IX Subsection "BUILD MODE"
.PP
گزینهٔ \&\fI\-\-build\fR (که قبلاً برنامه‌ای جداگانه به نام \f(CW\*(C`supermin\-helper\*(C'\fR بود) اپلاینس کامل را از روی اپلاینس supermin می‌سازد:
.PP
.Vb 1
\& supermin \-\-build \-\-format ext2 supermin.d \-o appliance.d
.Ve
.PP
این دستور فایل‌هایی با نام‌های \fIappliance.d/kernel\fR، \&\fIappliance.d/root\fR و غیره ایجاد می‌کند که همان اپلاینس کامل و قابل بوت است.
.PP
هدف این است که مرحلهٔ \fI\-\-build\fR روی ماشین کاربر نهایی در آخرین لحظه پیش از نیاز به اپلاینس انجام شود. بسته‌های موجود در اپلاینس supermin (آن‌هایی که هنگام آماده‌سازی اپلاینس مشخص شده‌اند) باید بر روی ماشین کاربر نهایی نصب باشند.
.PP
ساخت و حافظهٔ موقت (Build and cache)
.IX Subsection "Build and cache"
.PP
معمولاً می‌خواهید بازسازی اپلاینس روی ماشین کاربر نهایی تنها در صورت نیاز انجام شود. Supermin گزینه‌های اضافی برای آسان‌تر کردن این روند فراهم کرده است:
.PP
.Vb 3
\& supermin \-\-build \e
\&   \-\-if\-newer \-\-lock /run/user/\`id \-u\`/supermin.lock \e
\&   \-\-format ext2 supermin.d \-o appliance.d
.Ve
.PP
اگر چندین برنامه این دستور را به‌طور موازی اجرا کنند، نمونه‌ها روی فایل قفل (lock file) منتظر خواهند ماند. اپلاینس کامل تنها در صورتی بازسازی می‌شود که وجود نداشته باشد یا قدیمی‌تر از فایل‌های ورودی و پایگاه‌دادهٔ بسته‌های میزبان باشد.
.PP
توجه داشته باشید که فایل قفل \fBنباید\fR درون دایرکتوری خروجی \fI\-o\fR ذخیره شود.
.PP
\fIبسته‌ها (PACKAGES)\fR
.IX Subsection "PACKAGES"
.PP
منظور از «بسته» همان بستهٔ RPM، دبیان (و غیره) است، مانند \f(CW\*(C`coreutils\*(C'\fR، \f(CW\*(C`perl\*(C'\fR.
.PP
در تمامی موارد، supermin تنها می‌تواند یک اپلاینس supermin بسازد که از نظر توزیع، نسخه و معماری دقیقاً با میزبان یکسان باشد. این ابزار ساخت میان‌سکویی (cross-build) انجام \fIنمی‌دهد\fR..SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش راهنمای مختصر نحوه استفاده در خط فرمان، و خروج.
.IP \fB\-\-build\fR 4
.IX Item "--build"
ساخت اپلاینس کامل از اپلاینس supermin. این کار در گذشته برنامه‌ای مجزا با نام \f(CW\*(C`supermin\-helper\*(C'\fR بود.
.IP \fB\-\-copy\-kernel\fR 4
.IX Item "--copy-kernel"
(تنها در حالت \fI\-\-build\fR)
.Sp
رونوشت‌برداری از هسته (و درخت دستگاه یا device tree در صورت ایجاد) به جای پیوند نمادین به هسته در \fI/boot\fR.
.Sp
این کار کمی کُندتر است، اما در صورتی که بخواهید مجوزها یا برچسب SELinux را روی هسته یا درخت دستگاه تغییر دهید، ضروری است.
.IP "\fB\-f\fR FORMAT" 4
.IX Item "-f FORMAT"
.PD 0
.IP "\fB\-\-format\fR FORMAT" 4
.IX Item "--format FORMAT"
.PD
(تنها در حالت \fI\-\-build\fR)
.Sp
قالب خروجی را برای اپلاینس کامل انتخاب می‌کند.
.Sp
هیچ پیش‌فرضی وجود ندارد. هنگام استفاده از \fI\-\-build\fR باید گزینهٔ \&\fI\-\-format\fR را مشخص کنید.
.Sp
قالب‌های ممکن عبارتند از:
.RS 4
.IP chroot 4
.IX Item "chroot"
یک درخت دایرکتوری در سیستم‌فایل میزبان.
.Sp
درخت سیستم‌فایل در \fIOUTPUTDIR\fR (یعنی گزینهٔ \fI\-o\fR) نوشته می‌شود.
.Sp
این حالت \f(CW\*(C`chroot\*(C'\fR نامیده می‌شود زیرا بعداً می‌توانید دقیقاً با دستور \fBchroot\fR\|(1) وارد این دایرکتوری شوید، هرچند استفاده از یک فناوری کانتینر (مانند LXC و غیره) ایدهٔ بهتری است.
.Sp
در این حالت هیچ هسته یا initrd تولید نمی‌شود، چرا که فرض بر این است که اپلاینس را با هستهٔ میزبان اجرا خواهید کرد.
.IP ext2 4
.IX Item "ext2"
یک تصویر دیسک با سیستم‌فایل ext2.
.Sp
هستهٔ خروجی در \fIOUTPUTDIR/kernel\fR، یک initramfs کوچک که می‌تواند اپلاینس را سوار (mount) کند در \fIOUTPUTDIR/initrd\fR، و تصویر سیستم‌فایل ext2 در \&\fIOUTPUTDIR/root\fR نوشته می‌شود (که در آن \fIOUTPUTDIR\fR توسط گزینهٔ \fI\-o\fR مشخص می‌گردد).
.Sp
سیستم‌فایل (\fIOUTPUTDIR/root\fR) دارای اندازهٔ پیش‌فرض ۴ گیگابایت است (همچنین گزینهٔ \fI\-\-size\fR را ببینید).
.RE
.RS 4
.RE
.IP "\fB\-\-host\-cpu\fR CPU" 4
.IX Item "--host-cpu CPU"
(تنها در حالت \fI\-\-build\fR)
.Sp
پردازندهٔ میزبان را مشخص می‌کند (مانند \f(CW\*(C`i686\*(C'\fR، \f(CW\*(C`x86_64\*(C'\fR). این مقدار به عنوان تطبیق زیررشته هنگام جستجو برای هسته‌های سازگار استفاده می‌شود. اگر مشخص نشود، پیش‌فرض آن پردازندهٔ میزبانی است که supermin روی آن کامپایل شده است.
.IP \fB\-\-if\-newer\fR 4
.IX Item "--if-newer"
(تنها در حالت \fI\-\-build\fR)
.Sp
دایرکتوری خروجی بررسی شده و بازسازی \fIنمی‌شود\fR مگر این که واقعاً نیاز باشد.
.Sp
این کار با بررسی تاریخ‌های پایگاه‌دادهٔ بسته‌های میزبان (\fI/var/lib/rpm\fR و غیره)، فایل‌های ورودی supermin، و دایرکتوری خروجی انجام می‌شود. این عملیات تنها زمانی صورت می‌گیرد که پایگاه‌دادهٔ بسته‌های میزبان یا فایل‌های ورودی supermin از دایرکتوری خروجی جدیدتر باشند.
.Sp
همچنین گزینهٔ \fI\-\-lock\fR را در زیر ببینید.
.IP \fB\-\-include\-packagelist\fR 4
.IX Item "--include-packagelist"
(تنها در حالت \fI\-\-build\fR)
.Sp
فایلی به نام \fI/packagelist\fR درون chroot یا سیستم‌فایل ext2 تولیدشده می‌افزاید که شامل فهرست مرتب‌شده‌ای از تمام بسته‌های استفاده‌شده برای ساخت اپلاینس است.
.Sp
عمدتاً برای اشکال‌زدایی مفید است، چرا که یافتن این موضوع را آسان‌تر می‌کند که برای مثال کدام نسخه از یک بسته درون اپلاینس کپی شده است.
.IP \fB\-\-list\-drivers\fR 4
.IX Item "--list-drivers"
فهرست کردن درایورهای مدیر بسته که درون supermin کامپایل شده‌اند، و این که آیا مدیر بستهٔ مربوطه روی سیستم کنونی شناسایی شده است یا خیر.
.IP "\fB\-\-lock\fR LOCKFILE" 4
.IX Item "--lock LOCKFILE"
(تنها در حالت \fI\-\-build\fR)
.Sp
اگر چندین اجرای موازی از supermin نیاز به ساخت یک اپلاینس کامل داشته باشند، می‌توانید از گزینهٔ \fI\-\-lock\fR استفاده کنید تا مطمئن شوید با یکدیگر تداخل پیدا نکرده و کار هم را خراب نمی‌کنند.
.Sp
فایل قفل برای ایجاد انحصار متقابل (mutual exclusion) به کار می‌رود تا در هر زمان تنها یک نمونه از supermin اجرا شود.
.Sp
توجه داشته باشید که فایل قفل \fBنباید\fR درون دایرکتوری خروجی ذخیره شود.
.IP "\fB\-o\fR OUTPUTDIR" 4
.IX Item "-o OUTPUTDIR"
انتخاب دایرکتوری خروجی.
.Sp
هنگام استفاده از \fI\-\-prepare\fR، این دایرکتوری همان جایی است که اپلاینس supermin در آن نوشته خواهد شد. هنگام استفاده از \fI\-\-build\fR، این دایرکتوری جایی است که اپلاینس کامل، هسته و غیره در آن نوشته خواهند شد.
.Sp
\&\fBهرگونه محتویات قبلی در دایرکتوری خروجی حذف خواهد شد\fR و یک دایرکتوری خروجی جدید ایجاد می‌شود.
.Sp
دایرکتوری خروجی با ساخت یک دایرکتوری موقت با نامی مانند \fIOUTPUTDIR.abc543\fR، تغییر نام دایرکتوری خروجی قدیمی (در صورت وجود) و حذف آن، و سپس تغییر نام دایرکتوری موقت به \fIOUTPUTDIR\fR، به صورت (تقریباً) اتمیک ایجاد می‌شود. با ترکیب این گزینه با \fI\-\-lock\fR می‌توانید اطمینان حاصل کنید که چندین اجرای موازی از supermin با یکدیگر تعارض پیدا نمی‌کنند.
.IP "\fB\-\-packager\-config\fR CONFIGFILE" 4
.IX Item "--packager-config CONFIGFILE"
(تنها در حالت \fI\-\-prepare\fR)
.Sp
تنظیم فایل پیکربندی برای مدیر بسته. این گزینه به شما امکان می‌دهد مخازن نرم‌افزاری جایگزین را مشخص کنید.
.Sp
برای ArchLinux، این گزینه فایل پیکربندی pacman (پیش‌فرض \&\fI/etc/pacman.conf\fR) را تنظیم می‌کند. به \fBpacman.conf\fR\|(5) رجوع کنید.
.Sp
برای توزیع‌های مبتنی بر Yum/RPM، این گزینه فایل پیکربندی yum (پیش‌فرض \fI/etc/yum.conf\fR) را تنظیم می‌کند. به \fByum.conf\fR\|(5) رجوع کنید.
.IP \fB\-\-prepare\fR 4
.IX Item "--prepare"
آماده‌سازی اپلاینس supermin.
.IP \fB\-\-use\-installed\fR 4
.IX Item "--use-installed"
(تنها در حالت \fI\-\-prepare\fR)
.Sp
اگر بسته‌ها از قبل نصب شده باشند، به جای بارگیری از محتویات آنها (از سیستم‌فایل محلی) استفاده می‌کند.
.Sp
توجه داشته باشید که اگر فایل‌های محلی نسبت به نسخهٔ اولیه درون بسته تغییر کرده باشند، این کار می‌تواند باعث ایجاد اپلاینس‌های معیوب شود. این موضوع به‌ویژه برای فایل‌های پیکربندی یک مشکل به شمار می‌رود.
.Sp
با این حال، این گزینه در برخی شرایط کنترل‌شده مفید است؛ برای نمونه هنگام استفاده از supermin درون یک chroot تازه نصب‌شده، یا زمانی که در طول فرآیند ساخت به شبکه دسترسی ندارید.
.IP "\fB\-\-size\fR SIZE" 4
.IX Item "--size SIZE"
(تنها در حالت \fI\-\-build\fR)
.Sp
تعیین اندازهٔ سیستم‌فایل ext2 خروجی؛ اندازه را می‌توان با پسوندهای رایج مانند \f(CW\*(C`32G\*(C'\fR (۳۲ گیگابایت) و غیره مشخص کرد.
.Sp
اگر اندازه مشخص نشود، اندازهٔ پیش‌فرض ۴ گیگابایت استفاده می‌شود.
.Sp
برای تعیین اندازه بر حسب بایت، عدد باید بلافاصله با حرف کوچک \fIb\fR همراه باشد، مانند: \f(CW\*(C`\-\-size\ 10737418240b\*(C'\fR.
.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
فعال‌سازی پیام‌های مشروح.
.Sp
می‌توانید این گزینه را چندین بار مشخص کنید تا پیام‌های بیشتری فعال شوند:
.RS 4
.IP \fI\-v\fR 4
.IX Item "-v"
اشکال‌زدایی مراحل کلی.
.IP "\fI\-v \-v\fR" 4
.IX Item "-v -v"
اطلاعات تفصیلی درون هر مرحله..IP "\fI\-v \-v \-v\fR" 4
.IX Item "-v -v -v"
حجم بسیار زیادی از اطلاعات اشکال‌زدایی (بسیار فراتر از حد نیاز برای استفادهٔ عادی، اما مناسب برای زمانی که در تلاش برای عیب‌یابی یک باگ در supermin هستید).
.RE
.RS 4
.RE
.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
نام بسته و شمارهٔ نسخه را چاپ کرده و خارج می‌شود.
.SH "اپلاینس‌های SUPERMIN (SUPERMIN APPLIANCES)"
.IX Header "SUPERMIN APPLIANCES"
اپلاینس‌های supermin تنها شامل اطلاعات کافی برای ساخت اپلاینسی هستند که حاوی همان سیستم‌عامل (نسخهٔ لینوکس، توزیع، انتشار و غیره) سیستم‌عامل میزبان باشد. از آنجا که میزبان و اپلاینس فایل‌های مشترک بسیاری نظیر \fI/bin/bash\fR و \&\fI/lib/libc.so\fR دارند، دلیلی برای قرار دادن این فایل‌ها در خود اپلاینس وجود ندارد. این فایل‌ها می‌توانند به سادگی و بر حسب تقاضا هنگام راه‌اندازی اپلاینس از میزبان خوانده شوند. بنابراین برای صرفه‌جویی در فضا، تنها نام بسته‌های مورد نظر از میزبان را ذخیره کرده و آن‌ها را (به همراه وابستگی‌ها) در زمان ساخت کپی می‌کنیم.
.PP
برخی از فایل‌ها را نمی‌توان صرفاً به این روش از میزبان کپی کرد. این موارد شامل فایل‌های پیکربندی هستند که ممکن است مدیر سیستم میزبان آن‌ها را ویرایش کرده باشد. بنابراین در کنار فهرست فایل‌های میزبان، یک تصویر پایهٔ اسکلتی (skeleton base image) را نیز ذخیره می‌کنیم که شامل این فایل‌ها و ساختار کلی دایرکتوری‌ها است.
.PP
بنابراین یک اپلاینس supermin معمولاً دست‌کم از دو فایل کنترلی تشکیل می‌شود (\fIpackages\fR و \fIbase.tar.gz\fR).
.IP \fIpackages\fR 4
.IX Item "packages"
فهرست بسته‌هایی که باید از میزبان کپی شوند. وابستگی‌ها به‌طور خودکار حل‌وفصل می‌شوند.
.Sp
این فایل به صورت متن ساده است، با یک نام بسته در هر سطر.
.IP \fIbase.tar\fR 4
.IX Item "base.tar"
.PD 0
.IP \fIbase.tar.gz\fR 4
.IX Item "base.tar.gz"
.PD
این فایل tar (که ممکن است فشرده شده باشد) حاوی اسکلت فایل‌سیستم است. این فایل عمدتاً شامل دایرکتوری‌ها و تعداد کمی فایل پیکربندی است.
.Sp
تمام مسیرها در فایل tar باید نسبت به دایرکتوری ریشهٔ اپلاینس باشند.
.IP \fIhostfiles\fR 4
.IX Item "hostfiles"
هر فایل دیگری که باید از میزبان کپی شود. این یک فایل متنی ساده با یک نام مسیر در هر سطر است.
.Sp
مسیرها می‌توانند شامل نویسه‌های عام (wildcards) باشند که هنگام ایجاد اپلاینس بسط داده می‌شوند؛ به عنوان مثال:
.Sp
.Vb 1
\& /etc/yum.repos.d/*.repo
.Ve
.Sp
تمام فایل‌های \fI*.repo\fR را درون اپلاینس کپی می‌کند.
.Sp
هر نام مسیر در فایل باید با نویسهٔ \f(CW\*(C`/\*(C'\fR آغاز شود.
.Sp
خود supermin فایل‌های hostfiles را ایجاد نمی‌کند (اگرچه پیش از نسخهٔ\ 5، این سازوکار اصلیِ مورد استفاده برای ایجاد اپلاینس کامل بود). با این حال، اگر می‌خواهید فایل‌های متفرقه و بسته‌بندی‌نشده را در اپلاینس کامل کپی کنید، می‌توانید یک یا چند مورد از این فایل‌ها را درون دایرکتوری اپلاینس supermin قرار دهید.
.IP \fIexcludefiles\fR 4
.IX Item "excludefiles"
فهرستی از نام فایل‌ها، نام دایرکتوری‌ها، یا الگوهای نویسه عامِ دارای پیشوند \f(CW\*(C`\-\*(C'\fR که از اپلاینس نهایی مستثنی می‌شوند.
.Sp
این رویکرد نسبتاً بی‌رحمانه است، چرا که صرفاً موارد را حذف می‌کند و احتمالاً باعث ناقص شدن بسته‌ها می‌شود. با این حال می‌تواند روشی مناسب برای به حداقل رساندن اندازهٔ اپلاینس نهایی باشد.
.Sp
خود supermin فایل‌های excludefiles را ایجاد نمی‌کند. با این وجود، برای جلوگیری از کپی شدن فایل‌های بسته‌بندی‌شده در اپلاینس کامل، می‌توانید یک یا چند مورد از این فایل‌ها را درون دایرکتوری اپلاینس supermin قرار دهید.
.PP
توجه داشته باشید که نام‌های بالا صرفاً پیشنهاد هستند. می‌توانید از هر نام دلخواهی استفاده کنید، زیرا supermin هنگام بازسازی اپلاینس، محتوای هر فایل را تشخیص می‌دهد. همچنین می‌توانید از هر نوع فایل، چندین مورد داشته باشید..SS "بازسازی اَپلاینس (RECONSTRUCTING THE APPLIANCE)"
.IX Subsection "RECONSTRUCTING THE APPLIANCE"
حالت مجزای \f(CW\*(C`supermin \-\-build\*(C'\fR برای بازسازی یک اپلاینس از فایل‌های اپلاینس supermin استفاده می‌شود.
.PP
این برنامه در واقع به صورت بازگشتی روی فایل‌ها و دایرکتوری‌های ارائه‌شده پیمایش می‌کند. یک ساختار معمول می‌تواند به این شکل باشد:
.PP
.Vb 5
\& supermin.d/
\& supermin.d/base.tar.gz
\& supermin.d/extra.tar.gz
\& supermin.d/packages
\& supermin.d/zz\-hostfiles
.Ve
.PP
به این ترتیب می‌توان فایل‌های اضافی را تنها با ساخت یک فایل tar دیگر (در مثال بالا \fIextra.tar.gz\fR) و قرار دادن آن در دایرکتوری اضافه کرد، و فایل‌های میزبان اضافی را نیز افزود (در مثال بالا \fIzz-hostfiles\fR). وقتی اپلاینس ساخته شود، فایل‌های اضافی در آن نمایان خواهند شد.
.SS "کمینه‌سازی اَپلاینس سوپرمین (MINIMIZING THE SUPERMIN APPLIANCE)"
.IX Subsection "MINIMIZING THE SUPERMIN APPLIANCE"
ممکن است بخواهید برای صرفه‌جویی در زمان و فضا هنگام نمونه‌سازی، اپلاینس supermin را «کمینه» کنید. معمولاً ممکن است بخواهید مستندات، فایل‌های info، صفحات راهنما (man pages) و محلی‌سازی‌ها (locales) را حذف کنید.
.PP
می‌توانید این کار را با ساختن یک فایل excludefiles که فایل‌ها، دایرکتوری‌ها یا الگوهای عام (wildcards) ناخواسته را فهرست می‌کند، انجام دهید. این موارد هنگام ساخت اپلاینس کامل نادیده گرفته می‌شوند.
.PP
.Vb 5
\& \-/boot/*
\& \-/lib/modules/*
\& \-/usr/share/doc/*
\& \-/usr/share/info/*
\& \-/usr/share/man/*
.Ve
.PP
در حذف فایل‌ها دقت کنید، زیرا ممکن است برخی فایل‌ها برای عملکرد صحیح اپلاینس ضروری باشند.
.SS "کرنل و ماژول‌های کرنل (KERNEL AND KERNEL MODULES)"
.IX Subsection "KERNEL AND KERNEL MODULES"
معمولاً کرنل و ماژول‌های کرنل در اپلاینس supermin گنجانده \fIنمی‌شوند\fR.
.PP
هنگامی که اپلاینس کامل ساخته می‌شود، ماژول‌های کرنل از سیستم میزبان به داخل آن کپی شده و با استفاده از کرنل میزبان بوت می‌شود.
.PP
\fIاستفاده از کرنل و ماژول‌های کرنل سفارشی (USING A CUSTOM KERNEL AND KERNEL MODULES)\fR
.IX Subsection "USING A CUSTOM KERNEL AND KERNEL MODULES"
.PP
برنامه supermin قادر است بهترین کرنل میزبان موجود را برای بوت کردن اپلاینس انتخاب کند. با این حال می‌توانید با تنظیم متغیرهای محیطی این مورد را بازنویسی کنید (بخش «متغیرهای محیطی (ENVIRONMENT VARIABLES)» در زیر را ببینید).
.PP
اگر یک کرنل سفارشی می‌سازید (مثلاً از طریق کامپایل لینوکس از سورس‌کد)، در این صورت باید کاری مشابه این انجام دهید:
.PP
.Vb 4
\& mkdir /tmp/kmods
\& make bzImage
\& make modules
\& make modules_install INSTALL_MOD_PATH=/tmp/kmods
\& 
\& export SUPERMIN_KERNEL=/path/to/linux.git/arch/x86/boot/bzImage
\& export SUPERMIN_MODULES=/tmp/kmods/lib/modules/3.xx.yy
\& 
\& supermin \-\-build \-f ext2 [etc]
.Ve
.SS "اجبار در دسترس بودن بسته‌ها (ENFORCING AVAILABILITY OF PACKAGES)"
.IX Subsection "ENFORCING AVAILABILITY OF PACKAGES"
برنامه supermin با کپی کردن بسته‌های فهرست‌شده در \&\fIpackages\fR اپلاینس را می‌سازد. برای اینکه این فرایند کار کند، آن بسته‌ها باید در دسترس باشند. ما معمولاً این موضوع را با افزودن وابستگی‌ها (مثلاً خطوط \f(CW\*(C`Requires:\*(C'\fR در RPM) به بسته‌ای که از اپلاینس supermin استفاده می‌کند اعمال می‌کنیم، تا آن بسته نتواند بدون واکشی بسته‌های وابسته نصب شود و بدین ترتیب اطمینان حاصل شود که بسته‌ها برای استفاده supermin نصب شده‌اند.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.IX Header "ENVIRONMENT VARIABLES"
.IP SUPERMIN_KERNEL 4
.IX Item "SUPERMIN_KERNEL"
اگر این متغیر محیطی تنظیم شود، انتخاب خودکار کرنل نادیده گرفته شده و از این کرنل استفاده می‌شود.
.Sp
این متغیر محیطی باید به یک فایل کرنل اشاره کند،
مانند \fI/boot/vmlinuz\-3.0.x86_64\fR
.IP SUPERMIN_MODULES 4
.IX Item "SUPERMIN_MODULES"
این متغیر، دایرکتوری ماژول‌های کرنل مورد استفاده را مشخص می‌کند.
.Sp
این متغیر محیطی باید به دایرکتوری ماژول‌ها اشاره کند،
مانند \fI/lib/modules/3.0.x86_64/\fR
.IP SUPERMIN_KERNEL_VERSION 4
.IX Item "SUPERMIN_KERNEL_VERSION"
در معماری‌های غیر x86، اگر supermin نتواند نسخه کرنلِ
\&\f(CW\*(C`SUPERMIN_KERNEL\*(C'\fR را تنها با بررسی فایل تشخیص دهد، ممکن است لازم باشد این متغیر محیطی را تنظیم کنید..SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
<http://people.redhat.com/~rjones/supermin>،
\&\fBguestfs\fR\|(3)،
<http://libguestfs.org>.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
.IP \(bu 4
Richard W.M. Jones <http://people.redhat.com/~rjones>
.IP \(bu 4
Matthew Booth
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2016 Red Hat Inc.
.PP
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU General Public License) که توسط «بنیاد نرم‌افزارهای آزاد» (Free Software Foundation) منتشر شده است ‐ چه نسخهٔ ۲ پروانه و چه (به انتخاب خودتان) هر نسخهٔ بعدی دیگری ‐ بازتوزیع کرده و/یا تغییر دهید.
.PP
این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت تجاری یا مناسب بودن برای هدفی خاص. برای جزئیات بیشتر به پروانه عمومی همگانی گنو مراجعه کنید.
.PP
شما باید به همراه این برنامه یک نسخه از پروانه عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، با Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA مکاتبه کنید.