نام (NAME)

ubinize - ابزاری برای تولید ایمیج‌های UBI

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

ubinize [-o filename] [-p <bytes>] [-m <bytes>] [-s <bytes>] [-O <num>] [-e <num>] [-x <num>] [-Q <num>] [-v] [-h] [-V] [--output=<filename>] [--peb-size=<bytes>] [--min-io-size=<bytes>] [--sub-page-size=<bytes>] [--vid-hdr-offset=<num>] [--erase-counter=<num>] [--ubi-ver=<num>] [--image-seq=<num>] [--verbose] [--help] [--version] ini-file

توضیحات (DESCRIPTION)

یک ایمیج UBI ممکن است شامل یک یا چند حجم (Volume) از نوع UBI باشد که باید در فایل پیکربندی ini ورودی تعریف شوند. فایل ini تمام حجم‌های UBI - مشخصات و محتویات آن‌ها - را تعریف می‌کند، اما مشخصات حافظه فلشی که ایمیج UBI برای آن تولید می‌شود را تعریف نمی‌کند. در عوض، مشخصات فلش از طریق گزینه‌های خط فرمان مشخص می‌شوند. توجه داشته باشید در صورتی که در مورد برخی از پارامترهای خط فرمان مطمئن نیستید، آن‌ها را مشخص نکنید تا این ابزار از مقادیر پیش‌فرض استفاده کند.

گزینه‌ها (OPTIONS)

-o, --output=file: مشخص کردن فایل خروجی.
-p, --peb-size=bytes: اندازه بلوک پاک‌سازی فیزیکی (PEB) حافظه فلشی که این ایمیج UBI برای آن ایجاد می‌شود بر حسب بایت، کیلوبایت (KiB) یا مگابایت (MiB). این پارامتر اجباری است.
-m, --min-io-size=bytes: حداقل اندازه واحد ورودی/خروجی (I/O) حافظه فلش بر حسب بایت.
-s, --sub-page-size=bytes: حداقل واحد ورودی/خروجی مورد استفاده برای هدرهای UBI، مانند اندازه زیرصفحه (sub-page) در حافظه فلش NAND (به طور پیش‌فرض معادل حداقل اندازه واحد ورودی/خروجی است).
-O, --vid-hdr-offset=num: فاصله افست هدر VID از ابتدای بلوک پاک‌سازی فیزیکی (پیش‌فرض، حداقل واحد ورودی/خروجی یا زیرصفحه بعدی پس از هدر EC است).
-e, --erase-counter=num: مقدار شمارنده پاک‌سازی (erase counter) برای قرار گرفتن در هدرهای EC (پیش‌فرض 0 است).
-x, --ubi-ver=num: شماره نسخه UBI برای قرار گرفتن در هدرهای EC (پیش‌فرض 1 است).
-Q, --image-seq=num: شماره ترتیبی ۳۲ بیتی ایمیج UBI (به طور پیش‌فرض یک عدد تصادفی انتخاب می‌شود).
-v, --verbose: نمایش خروجی با جزئیات بیشتر.
-h, --help: چاپ پیام راهنما و خروج.
-V, --version: چاپ نسخه برنامه و خروج.

مثال‌ها (EXAMPLES)

ubinize -o ubi.img -p 16KiB -m 512 -s 256 cfg.ini

تولید ایمیج UBI با نام ubi.img مطابق با توضیحات فایل پیکربندی cfg.ini.

یک بلوک پاک‌سازی فیزیکی روی حافظه فلش دارای اندازه 16KiB است و صفحاتی با اندازه 512 بایت به همراه زیرصفحه‌های 256 بایتی دارد.

قالب فایل INI (INI-FILE FORMAT)

فایل پیکربندی ini ورودی، تمام حجم‌هایی را که باید در ایمیج UBI خروجی گنجانده شوند توصیف می‌کند. هر حجم در بخش مختص به خود توصیف می‌شود که می‌توان آن را به دلخواه نام‌گذاری کرد. هر بخش شامل جفت‌های "key=value" (کلید=مقدار) است؛ به عنوان مثال:

[jffs2-volume]
mode=ubi
image=../jffs2.img
vol_id=1
vol_size=30MiB
vol_type=dynamic
vol_name=jffs2_volume
vol_flags=autoresize
vol_alignment=1

این نمونه فایل پیکربندی به ابزار اعلام می‌کند یک ایمیج UBI با یک حجم با شناسه 1، اندازه حجم 30MiB، نوع حجم پویا (dynamic)، نام jffs2_volume، پرچم حجم autoresize و تراز 1 بسازد.

خط image=../jffs2.img به ابزار می‌گوید محتوای حجم را از فایل ../jffs2.img بردارد. اندازه فایل ایمیج باید کمتر یا مساوی با اندازه حجم (30MiB) باشد.

خط mode=ubi اجباری است و مشخص می‌کند که این بخش یک حجم UBI را توصیف می‌کند - حالت‌های دیگری برای بخش‌ها ممکن است در آینده اضافه شوند.

نکات:

•: اندازه در vol_size می‌تواند بر حسب کیلوبایت (KiB)، مگابایت (MiB)، گیگابایت (GiB) یا بایت (بدون پسوند) مشخص شود.
•: اگر کلید vol_size وجود نداشته باشد، اندازه حجم برابر با اندازه فایل ایمیج (تعیین‌شده توسط کلید image) در نظر گرفته می‌شود.
•: اگر کلید image وجود نداشته باشد، حجم به صورت خالی فرض می‌شود.
•: تراز حجم (Volume alignment) نباید بزرگتر از اندازه بلوک پاک‌سازی منطقی (LEB) باشد.
•: یک فایل ini می‌تواند شامل تعداد دلخواهی از بخش‌ها باشد، و ابزار تمام حجم‌های توصیف‌شده در این بخش‌ها را در فایل ایمیج UBI خروجی قرار خواهد داد.

نویسندگان (AUTHORS)

صفحه راهنما توسط David Oberhollenzer بر اساس متن راهنمای
ابزار ubinize نوشته شده توسط Artem Bityutskiy و Oliver Lohmann نگاشته شده است.

گزارش باگ‌ها (REPORTING BUGS)

گزارش باگ‌های mtd-utils را به فهرست پستی mtd لینوکس ارسال کنید.

فهرست پستی mtd لینوکس: <linux-mtd@lists.infradead.org>
صفحه اصلی mtd لینوکس: http://www.linux-mtd.infradead.org

در دسترس بودن (AVAILABILITY)

دستور ubinize بخشی از بسته mtd-utils است و از طریق نشانی ftp://ftp.infradead.org/pub/mtd-utils در دسترس است.

حق نشر (COPYRIGHT)

مجوز GPLv2: گنو GPL نسخه 2 http://gnu.org/licenses/gpl2.html.
این نرم‌افزار آزاد است: شما مجاز به تغییر و بازتوزیع آن هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.

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

mkfs.jffs2(1)