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 یکی از مقادیر زیر است:

                     none   پاک کردن حفاظت موقت در برابر نوشتن.

                     temp   تنظیم حفاظت موقت در برابر نوشتن.

                     pwron  تنظیم حفاظت در برابر نوشتن تا زمان قطع و وصل مجدد
                            برق (power cycle).

       disable 512B emulation device
              تنظیم اندازه سکتور داده eMMC به ۴ کیلوبایت با غیرفعال‌سازی
              شبیه‌سازی روی دستگاه.

       gp create dry-run length-KiB partition enh-attr ext-attr device
              ایجاد پارتیشن همه‌منظوره (general purpose) برای دستگاه.
              توجه! این یک تغییر یک‌باربرنامه‌ریزی‌پذیر (غیرقابل بازگشت) است.
              برای تنظیم ویژگی بهبودیافته (enhanced) برای پارتیشن، مقدار
              enh-attr را ۱ و در غیر این صورت ۰ بگذارید.
              dry-run یکی از موارد زیر است:

                     -y     مقدار PARTITION_SETTING_COMPLETED در extcsd تنظیم
                            شده و عملیات پارتیشن‌بندی نهایی و اعمال می‌گردد.

                     -c     تنظیمات پارتیشن‌بندی بیشتری در راه است؛ عملیات هنوز
                            نهایی نمی‌شود.

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

       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>

User Manual                       April 2024                      mmc-utils(1)