UBINIZE(8)                  System Manager's Manual                 UBINIZE(8)

نام (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)
       Copyright © International Business Machines Corp., 2006
       Copyright © 2008 Nokia Corporation
       Copyright © 2016 sigma star gmbh

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

همچنین ببینید (SEE ALSO)
       mkfs.jffs2(1)

mtd-utils                       September 2016                      UBINIZE(8)