نام (NAME)

virt-make-fs - ایجاد سیستم فایل از یک دایرکتوری یا فایل tar

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

virt-make-fs [--options] input.tar output.img
virt-make-fs [--options] input.tar.gz output.img
virt-make-fs [--options] directory output.img

توضیحات (DESCRIPTION)

دستور Virt-make-fs یک ابزار خط فرمانی برای ساخت یک سیستم فایل از یک بایگانی tar یا تعدادی فایل درون یک دایرکتوری است. این ابزار مشابه ابزارهایی مانند mkisofs(1)، genisoimage(1) و mksquashfs(1) است. بر خلاف آن ابزارها، این برنامه می‌تواند انواع سیستم‌فایل‌های متداول مانند ext2/3 یا NTFS را ایجاد کند، که در صورت تمایل به ضمیمه کردن این سیستم‌فایل‌ها به ماشین‌های مجازی موجود (مثلاً برای وارد کردن حجم بالایی از داده‌های فقط‌خواندنی به یک VM) بسیار مفید است.

برای ساخت دیسک‌های خالی، از virt-format(1) استفاده کنید. برای ساخت لایه‌بندی‌های پیچیده، از guestfish(1) استفاده نمایید.

روش استفاده پایه:

virt-make-fs input output.img

که در آن "input" یا یک دایرکتوری شامل فایل‌هایی است که می‌خواهید اضافه کنید، یا یک بایگانی tar (شامل tar فشرده‌نشده یا فشرده‌شده با gzip)؛ و output.img یک ایمیج دیسک است. نوع ورودی به طور خودکار تشخیص داده می‌شود. ایمیج دیسک خروجی به‌طور پیش‌فرض یک ایمیج خلوت (sparse) خام ext2 خواهد بود، مگر اینکه گزینه‌های اضافی را مشخص کنید (بخش "گزینه‌ها" در ادامه را ببینید).

virt-make-fs --type=minix input minixfs.img

virt-make-fs --partition -- input disk.img

virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img

virt-make-fs --format=qcow2 --size=+200M input output.img

گزینه‌ها (OPTIONS)

--help

نمایش راهنمای خلاصه.

--blocksize=512

--blocksize=4096

این پارامتر اندازه سکتور ایمیج دیسک خروجی را تعیین می‌کند.

مقدار پیش‌فرض 512 بایت است.

همچنین "guestfs_add_drive_opts" در guestfs(3) را ببینید.

--floppy

ساخت یک دیسکت فلاپی مجازی.

در حال حاضر این گزینه اندازه (1440K)، نوع پارتیشن (MBR) و نوع سیستم فایل (VFAT) را از پیش تعیین می‌کند. در آینده ممکن است هندسه (geometry) را نیز انتخاب کند.

--size=N

--size=+N

-s N

-s +N

از گزینه --size (یا -s) برای انتخاب اندازه ایمیج خروجی استفاده کنید.

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

برای انتخاب یک دیسک خروجی با اندازه ثابت، یک عدد مطلق همراه با یکی از پسوندهای b/K/M/G/T/P/E به معنای بایت، کیلوبایت، مگابایت، گیگابایت، ترابایت، پتابایت یا اگزابایت مشخص کنید. این مقدار باید به اندازه کافی بزرگ باشد تا تمام فایل‌های ورودی را در بر گیرد، در غیر این صورت با خطا مواجه خواهید شد.

برای باقی گذاشتن فضای اضافی، یک علامت "+" (مثبت) و یک عدد همراه با یکی از پسوندهای b/K/M/G/T/P/E به معنای بایت، کیلوبایت، مگابایت، گیگابایت، ترابایت، پتابایت یا اگزابایت مشخص کنید. برای مثال: --size=+200M به معنای فضای کافی برای فایل‌های ورودی به علاوه (تقریباً) ۲۰۰ مگابایت فضای خالی اضافی است.

توجه داشته باشید که virt-make-fs فضای خالی را تخمین می‌زند و بنابراین سیستم‌فایل‌هایی که تولید می‌کند دقیقاً شامل مقدار فضای خالی درخواست‌شده نخواهند بود. (تولید یک سیستم فایل که دقیقاً دارای فضای خالی مورد نظر باشد بسیار هزینه‌برتر و زمان‌برتر است).

--format=FMT

-F FMT

انتخاب فرمت ایمیج دیسک خروجی.

مقدار پیش‌فرض "raw" (ایمیج دیسک خلوت خام) است.

--type=FS

-t FS

انتخاب نوع سیستم فایل خروجی.

مقدار پیش‌فرض "ext2" است.

هر سیستم فایلی که به صورت خواندن/نوشتن توسط libguestfs پشتیبانی شود در اینجا قابل استفاده است.

--label=LABEL

تنظیم برچسب (label) سیستم فایل.

--partition

--partition=PARTTYPE

در صورت تعیین، این پرچم یک جدول پارتیشن MBR به ایمیج دیسک خروجی اضافه می‌کند.

می‌توانید نوع جدول پارتیشن را تغییر دهید، مثلاً --partition=gpt برای دیسک‌های بزرگ.

برای MBR، ابزار virt-make-fs بایت نوع پارتیشن را به طور خودکار تنظیم می‌کند.

-v

--verbose

فعال‌سازی اطلاعات اشکال‌زدایی (debugging).

-V

--version

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

-x

فعال‌سازی ردگیری (trace) در libguestfs.

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

guestfish(1)، virt-format(1)، virt-resize(1)، virt-tar-in(1)، mkisofs(1)، genisoimage(1)، mksquashfs(1)، mke2fs(8)، resize2fs(8)، guestfs(3)، http://libguestfs.org

نویسنده (AUTHOR)

Richard W.M. Jones http://people.redhat.com/~rjones

حق نشر (COPYRIGHT)

Copyright (C) 2010-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) را اجرا کرده و خروجی کامل و ویرایش‌نشده آن را در گزارش اشکال جای‌گذاری نمایید.