| mmc-utils(1) | General Commands Manual | mmc-utils(1) |
نام (NAME)
mmc - ابزاری برای پیکربندی و مدیریت دستگاه‌های ذخیره‌سازی MMC و eMMC
خلاصه دستور (SYNOPSIS)
mmc [گزینه‌ها] [دستگاه-بلوکی-mmc]...
توضیحات (DESCRIPTION)
ابزار mmc-utils
یک ابزار
تک‌نخی (single-threaded)
برای اجرای
عملیات
تعیین‌شده MMC
توسط کاربر
است.
کاربرد
متداول mmc-utils
دسترسی به
دستگاه
حافظه MMC جهت
پیکربندی
یا خواندن
ثبات‌های
پیکربندی
(configuration registers) آن است.
گزینه‌ها (OPTIONS)
- extcsd read device
- خواندن و چاپ ثبات CSD توسعه‌یافته (extcsd).
- extcsd write offset value device
- نوشتن مقدار value در آفست offset در ثبات extcsd دستگاه.
- writeprotect boot get device
- چاپ وضعیت حفاظت در برابر نوشتن (write protect) پارتیشن‌های بوت.
- writeprotect boot set device [number]
- تنظیم
وضعیت
حفاظت در
برابر
نوشتن
پارتیشن
بوت دستگاه.
اگر number ارسال شود (۰ یا ۱)، تنها همان پارتیشن بوت eMMC محافظت می‌شود؛ در غیر این صورت هر دو پارتیشن محافظت خواهند شد.
این حفاظت تا راه‌اندازی (بوت) بعدی پایدار خواهد بود. - writeprotect user get device
- چاپ پیکربندی حفاظت در برابر نوشتن ناحیه کاربری برای دستگاه.
- writeprotect user set type start-block blocks device
- تنظیم
پیکربندی
حفاظت در
برابر
نوشتن برای
محدوده
مشخصی از
ناحیه
کاربری
دستگاه.
start-block بلوک آغازین ناحیه محافظت‌شده را مشخص می‌کند.
blocks اندازه ناحیه محافظت‌شده را بر حسب تعداد بلوک‌ها مشخص می‌سازد.
توجه! این محدوده باید در مرزهای گروه حفاظت در برابر نوشتن آغاز شده و پایان یابد. از دستور "writeprotect user get" برای دریافت اندازه گروه حفاظت استفاده کنید. type یکی از مقادیر زیر است:
- disable 512B emulation device
- تنظیم اندازه سکتور داده eMMC به ۴ کیلوبایت با غیرفعال‌سازی شبیه‌سازی روی دستگاه.
- gp create dry-run length-KiB partition enh-attr ext-attr device
- ایجاد
پارتیشن
همه‌منظوره
(general purpose) برای
دستگاه.
توجه! این یک تغییر یک‌باربرنامه‌ریزی‌پذیر (غیرقابل بازگشت) است.
برای تنظیم ویژگی بهبودیافته (enhanced) برای پارتیشن، مقدار enh-attr را ۱ و در غیر این صورت ۰ بگذارید.
dry-run یکی از موارد زیر است:
- enh_area set dry-run start-KiB length-KiB device
- فعال‌سازی ناحیه کاربری بهبودیافته برای دستگاه (غیرقابل بازگشت).
- write_reliability set dry-run partition device
- فعال‌سازی قابلیت اطمینان نوشتن به ازای هر پارتیشن برای دستگاه (غیرقابل بازگشت).
- status get device
- چاپ پاسخ دستور STATUS_SEND (CMD13).
- bootpart enable boot-partition send-ackn device
- فعال‌سازی پارتیشن بوت برای دستگاه (اگر boot-partition برابر با ۰ باشد، غیرفعال می‌شود).
- bootbus set boot-mode reset-boot-bus-conditions boot-bus-width device
- تنظیم شرایط گذرگاه بوت (Boot Bus Conditions).
- bkops_en mode device
- فعال‌سازی
قابلیت BKOPS
مربوط به eMMC
روی دستگاه.
mode می‌تواند auto (خودکار) یا manual (دستی) باشد (حالت دستی غیرقابل بازگشت است). - hwreset enable device
- فعال‌سازی دائمی قابلیت بازنشانی سخت‌افزاری eMMC روی دستگاه (غیرقابل بازگشت).
- hwreset disable device
- غیرفعال‌سازی دائمی قابلیت بازنشانی سخت‌افزاری eMMC روی دستگاه (غیرقابل بازگشت).
- sanitize device [timeout_ms]
- ارسال دستور Sanitize به دستگاه جهت پاک‌سازی قطعی نواحی نگاشت‌نشده حافظه.
- rpmb write-key rpmb-device key-file
- برنامه‌ریزی کلید احراز هویت ۳۲ بایتی ذخیره‌شده در فایل تعیین‌شده (یا '-' برای ورودی استاندارد). غیرقابل بازگشت است.
- rpmb read-counter rpmb-device
- خواندن مقدار شمارنده rpmb-device در خروجی استاندارد.
- rpmb read-block rpmb-device address blocks-count output-file [key-file]
- خواندن بلوک‌های ۲۵۶ بایتی از rpmb-device به پرونده خروجی یا stdout.
- rpmb write-block rpmb-device address 256-byte-data-file key-file
- نوشتن بلوک ۲۵۶ بایتی از فایل داده به rpmb-device.
- rpmb secure-wp-mode-on rpmb-device key-file
- فعال‌سازی حالت حفاظت امن در برابر نوشتن.
- rpmb secure-wp-mode-off rpmb-device key-file
- غیرفعال‌سازی حالت حفاظت امن در برابر نوشتن (حالت موروثی).
- cache enable device
- فعال‌سازی قابلیت حافظه نهان (کَش) eMMC روی دستگاه.
- cache disable device
- غیرفعال‌سازی قابلیت حافظه نهان (کَش) eMMC روی دستگاه.
- csd read [-h][-v] [-b bus_type] [-r register] <device-path>
- چاپ داده‌های ثبات CSD از مسیر دستگاه.
- cid read [-h][-v] [-b bus_type] [-r register] <device-path>
- چاپ داده‌های ثبات شناسه کارت CID از مسیر دستگاه.
- scr read [-h][-v] [-b bus_type] [-r register] <device-path>
- چاپ داده‌های ثبات پیکربندی SD (ثبات SCR) از مسیر دستگاه.
- ffu image-file-name device [chunk-bytes]
- اجرای به‌روزرسانی میان‌افزار میدانی (Field Firmware Update / FFU) با تصویر مشخص‌شده روی دستگاه.
- erase type start-address end-address device
- ارسال دستور Erase CMD38 برای پاک‌سازی بازه مشخص‌شده از داده‌های کاربری.
- gen_cmd read device [arg]
- ارسال دستور عمومی GEN_CMD (CMD56) جهت خواندن داده‌های سلامت یا اطلاعات اختصاصی سازنده دستگاه.
- softreset device
- ارسال فرمان CMD0 برای بازنشانی نرم‌افزاری.
- boot_operation boot-data-file device
- اجرای عملیات بوت جایگزین و نوشتن بلوک‌های اولیه داده‌های بوت در پرونده درخواستی.
- --help | help | -h
- نمایش راهنمای دستورات.
- cmd --help
- نمایش راهنمای تفصیلی برای دستور خاص cmd.
دستورات RPMB (RPMB COMMANDS)
پارتیشن RPMB
(بلوک حافظه
محافظت‌شده
در برابر
بازپخش) در
دستگاه‌های
eMMC ناحیه
ویژه‌ای
برای
ذخیره‌سازی
امن
اطلاعات با
امضای
رمزنگاری‌شده
توسط یک
کلید
محرمانه
اختصاصی
است.
جهت نوشتن و
خواندن
رکوردها از
این ناحیه
ویژه،
احراز هویت
الزامی است.
دسترسی به
ناحیه RPMB
*منحصراً* از
طریق ioctl() از
فضای
کاربری
انجام
می‌شود.
مثال‌ها (EXAMPLES)
نمونه‌های RPMB
برنامه‌ریزی کلید RPMB از طریق ورودی استاندارد:
$ echo -n AAAABBBBCCCCDDDDEEEEFFFFGGGGHHHH | mmc rpmb write-key /dev/mmcblk0rpmb -
خواندن ۲ بلوک از آدرس ۲ و چاپ در خروجی استاندارد با اعتبارسنجی فریم‌ها با کلید:
$ echo -n AAAABBBBCCCCDDDDEEEEFFFFGGGGHHHH | mmc rpmb read-block /dev/mmcblk0rpmb 0x02 2 -
خواندن ۲ بلوک بدون اعتبارسنجی از آدرس ۲ و ذخیره در پرونده /tmp/block:
$ mmc rpmb read-block /dev/mmcblk0rpmb 0x02 2 /tmp/block
نمونه‌های به‌روزرسانی میان‌افزار (FFU)
اجرای FFU با حداکثر اندازه قطعه مجاز:
$ mmc ffu IO4e0aC2056001801M1100042AE1.fluf /dev/mmcblk0
مشابه بالا اما با قطعات ۴ کیلوبایتی:
$ mmc ffu IO4e0aC2056001801M1100042AE1.fluf /dev/mmcblk0 4096
نویسندگان (AUTHORS)
ابزار mmc-utils
توسط Chris Ball <cjb@laptop.org> و
<chris@printf.net> نوشته
شده است.
این ابزار
در حال حاضر
توسط Ulf Hansson <ulf.hansson@linaro.org>
نگهداری
می‌شود.
گزارش اشکالات (REPORTING BUGS)
اشکالات را به فهرست رایانامه‌ای mmc به نشانی <linux-mmc@vger.kernel.org> گزارش دهید.
همچنین ببینید (SEE ALSO)
برای
مستندات
تکمیلی
پرونده README
را مطالعه
فرمایید.
مقدمه
کوتاه:
https://docs.kernel.org/driver-api/mmc/mmc-tools.html
درخت رسمی
گیت:
https://git.kernel.org/pub/scm/utils/mmc/mmc-utils.git
| April 2024 | User Manual |