.TH UBINIZE 8 "September 2016" "mtd-utils"
.SH "نام (NAME)"
ubinize \- ابزاری برای تولید ایمیج‌های UBI
.SH "خلاصه دستور (SYNOPSIS)"
.B ubinize
[\-o \fIfilename\fP] [\-p <\fIbytes\fP>] [\-m <\fIbytes\fP>] [\-s <\fIbytes\fP>] [\-O <\fInum\fP>] [\-e <\fInum\fP>]
[\-x <\fInum\fP>] [\-Q <\fInum\fP>] [\-v] [\-h] [\-V] [\-\-output=<\fIfilename\fP>] [\-\-peb\-size=<\fIbytes\fP>]
[\-\-min\-io\-size=<\fIbytes\fP>] [\-\-sub\-page\-size=<\fIbytes\fP>] [\-\-vid\-hdr\-offset=<\fInum\fP>]
[\-\-erase\-counter=<\fInum\fP>] [\-\-ubi\-ver=<\fInum\fP>] [\-\-image\-seq=<\fInum\fP>] [\-\-verbose]
[\-\-help] [\-\-version] \fIini-file\fR
.SH "توضیحات (DESCRIPTION)"
یک ایمیج UBI ممکن است شامل یک یا چند حجم (Volume) از نوع UBI باشد که باید در
فایل پیکربندی ini ورودی تعریف شوند. فایل ini تمام حجم‌های UBI \-
مشخصات و محتویات آن‌ها \- را تعریف می‌کند، اما مشخصات
حافظه فلشی که ایمیج UBI برای آن تولید می‌شود را تعریف نمی‌کند. در عوض،
مشخصات فلش از طریق گزینه‌های خط فرمان مشخص می‌شوند. توجه داشته باشید در صورتی که
در مورد برخی از پارامترهای خط فرمان مطمئن نیستید، آن‌ها را مشخص نکنید تا
این ابزار از مقادیر پیش‌فرض استفاده کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-o , " \-\-output=\fIfile\fP"
مشخص کردن فایل خروجی.
.TP
.BR \-p , " \-\-peb\-size=\fIbytes\fP"
اندازه بلوک پاک‌سازی فیزیکی (PEB) حافظه فلشی که این ایمیج UBI برای آن ایجاد می‌شود
بر حسب بایت، کیلوبایت (KiB) یا مگابایت (MiB). این پارامتر اجباری است.
.TP
.BR \-m , " \-\-min\-io\-size=\fIbytes\fP"
حداقل اندازه واحد ورودی/خروجی (I/O) حافظه فلش بر حسب بایت.
.TP
.BR \-s , " \-\-sub\-page\-size=\fIbytes\fP"
حداقل واحد ورودی/خروجی مورد استفاده برای هدرهای UBI، مانند اندازه زیرصفحه (sub-page) در
حافظه فلش NAND (به طور پیش‌فرض معادل حداقل اندازه واحد ورودی/خروجی است).
.TP
.BR \-O , " \-\-vid\-hdr\-offset=\fInum\fP"
فاصله افست هدر VID از ابتدای بلوک پاک‌سازی فیزیکی (پیش‌فرض، حداقل واحد
ورودی/خروجی یا زیرصفحه بعدی پس از هدر EC است).
.TP
.BR \-e , " \-\-erase\-counter=\fInum\fP"
مقدار شمارنده پاک‌سازی (erase counter) برای قرار گرفتن در هدرهای EC (پیش‌فرض 0 است).
.TP
.BR \-x , " \-\-ubi\-ver=\fInum\fP"
شماره نسخه UBI برای قرار گرفتن در هدرهای EC (پیش‌فرض 1 است).
.TP
.BR \-Q , " \-\-image\-seq=\fInum\fP"
شماره ترتیبی ۳۲ بیتی ایمیج UBI (به طور پیش‌فرض یک عدد تصادفی انتخاب می‌شود).
.TP
.BR \-v , " \-\-verbose"
نمایش خروجی با جزئیات بیشتر.
.TP
.BR \-h , " \-\-help"
چاپ پیام راهنما و خروج.
.TP
.BR \-V , " \-\-version"
چاپ نسخه برنامه و خروج.
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
ubinize \-o ubi.img \-p 16KiB \-m 512 \-s 256 cfg.ini
.fi
.PP
تولید ایمیج UBI با نام
.I ubi.img
مطابق با توضیحات فایل پیکربندی
.IR cfg.ini .
.PP
یک بلوک پاک‌سازی فیزیکی روی حافظه فلش دارای اندازه
.I 16KiB
است و صفحاتی با اندازه
.I 512
بایت به همراه زیرصفحه‌های
.I 256
بایتی دارد.
.SH "قالب فایل INI (INI-FILE FORMAT)"
فایل پیکربندی ini ورودی، تمام حجم‌هایی را که باید در ایمیج UBI
خروجی گنجانده شوند توصیف می‌کند. هر حجم در بخش مختص به خود توصیف
می‌شود که می‌توان آن را به دلخواه نام‌گذاری کرد. هر بخش شامل
جفت‌های "key=value" (کلید=مقدار) است؛ به عنوان مثال:
.PP
.in +4n
.nf
[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
.fi
.in
.PP
این نمونه فایل پیکربندی به ابزار اعلام می‌کند یک ایمیج UBI با یک حجم با
شناسه 1، اندازه حجم 30MiB، نوع حجم پویا (dynamic)، نام
.IR jffs2_volume ،
پرچم حجم
.I autoresize
و تراز 1 بسازد.
.PP
خط
.B image=../jffs2.img
به ابزار می‌گوید محتوای حجم را از فایل
.B ../jffs2.img
بردارد. اندازه فایل ایمیج باید کمتر یا مساوی با اندازه حجم (30MiB) باشد.
.PP
خط
.B mode=ubi
اجباری است و مشخص می‌کند که این بخش یک حجم UBI را توصیف می‌کند \- حالت‌های
دیگری برای بخش‌ها ممکن است در آینده اضافه شوند.
.PP
نکات:
.IP \[bu] 4
اندازه در
.B vol_size
می‌تواند بر حسب کیلوبایت (KiB)، مگابایت (MiB)، گیگابایت (GiB) یا بایت (بدون پسوند) مشخص شود.
.IP \[bu]
اگر کلید
.B vol_size
وجود نداشته باشد، اندازه حجم برابر با اندازه فایل ایمیج (تعیین‌شده توسط کلید
.BR image )
در نظر گرفته می‌شود.
.IP \[bu]
اگر کلید
.B image
وجود نداشته باشد، حجم به صورت خالی فرض می‌شود.
.IP \[bu]
تراز حجم (Volume alignment) نباید بزرگتر از اندازه بلوک پاک‌سازی منطقی (LEB) باشد.
.IP \[bu]
یک فایل ini می‌تواند شامل تعداد دلخواهی از بخش‌ها باشد، و ابزار تمام
حجم‌های توصیف‌شده در این بخش‌ها را در فایل ایمیج UBI خروجی قرار خواهد داد.
.SH "نویسندگان (AUTHORS)"
.nf
صفحه راهنما توسط David Oberhollenzer بر اساس متن راهنمای
ابزار ubinize نوشته شده توسط Artem Bityutskiy و Oliver Lohmann نگاشته شده است.
.fi
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌های mtd-utils را به فهرست پستی mtd لینوکس ارسال کنید.
.TP
فهرست پستی mtd لینوکس: <linux-mtd@lists.infradead.org>
.TP
صفحه اصلی mtd لینوکس: <http://www.linux-mtd.infradead.org>
.SH "در دسترس بودن (AVAILABILITY)"
دستور ubinize بخشی از بسته mtd-utils است و از طریق نشانی
ftp://ftp.infradead.org/pub/mtd-utils
در دسترس است.
.SH "حق نشر (COPYRIGHT)"
Copyright \(co International Business Machines Corp., 2006
.br
Copyright \(co 2008 Nokia Corporation
.br
Copyright \(co 2016 sigma star gmbh
.PP
مجوز GPLv2: گنو GPL نسخه 2 <http://gnu.org/licenses/gpl2.html>.
.br
این نرم‌افزار آزاد است: شما مجاز به تغییر و بازتوزیع آن هستید.
هیچ ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
.BR mkfs.jffs2 (1)