RPI-IMAGER(1) General Commands Manual RPI-IMAGER(1)

rpi-imager - نوشتن تصویر دیسک بر روی رسانه‌های ذخیره‌سازی جداشدنی

rpi-imager [--debug] [--repo url] [--qm translations] [--disable-telemetry] [--enable-secure-boot] [image-uri]
rpi-imager --cli [--debug] [--quiet] [--disable-verify] [--sha256 expected-hash] [--secure-boot-key key-file] image-uri destination-device
rpi-imager --version
rpi-imager --help

دستور rpi-imager ابزاری برای نوشتن فایل تصویر دیسک (که می‌تواند به صورت اختیاری فشرده شده باشد) بر روی دیسک مقصد جداشدنی، مانند کارت حافظه micro-SD یا درایو SSD متصل‌شده از طریق USB است.

هنگامی که این ابزار بدون هیچ آرگومان خط فرمانی اجرا شود، یک رابط گرافیکی ساده به همراه گزینه‌های کنترلی برای انتخاب فایل تصویر، انتخاب درایو مقصد و دکمه‌ای برای شروع نوشتن نمایش می‌دهد. در این حالت، برای دریافت فهرست تصویرهای سیستم‌عامل موجود، از کارسازهای Raspberry Pi (و احتمالاً کارسازهای شخص ثالث) استعلام گرفته می‌شود. همچنین می‌توانید یک image-uri (که می‌تواند یک فایل محلی یا نشانی اینترنتی تحت پروتکل‌های HTTP یا HTTPS باشد) را مستقیماً در خط فرمان برای نوشتن مشخص کنید.

هنگامی که با آرگومان --cli اجرا شود، این ابزار مستقیماً image-uri داده‌شده را بر روی destination-device مشخص‌شده می‌نویسد. در این حالت، می‌توان از گزینه --sha256 برای ارسال چک‌سام SHA256 مورد انتظار تصویر استفاده کرد.

عدم اجرای رابط کاربری گرافیکی؛ صرفاً نوشتن تصویر مشخص‌شده بر روی درایو تعیین‌شده. در این حالت، باید هر دو پارامتر image-uri و destination-device مشخص شوند.
چاپ اطلاعات اشکال‌زدایی تکمیلی در کنسول.
گزارش ندادن عملیات نوشتن سیستم‌عامل به نشانی http://rpi-imager-stats.raspberrypi.com
پس از اتمام نوشتن تصویر، برای اعتبارسنجی صحت داده‌های نوشته‌شده تلاشی صورت نگیرد. تنها در صورت اجرا به همراه --cli معتبر است.
فعال‌سازی اجباری مرحله سفارشی‌سازی راه‌اندازی امن (Secure Boot) در رابط کاربری گرافیکی، صرف‌نظر از اینکه آیا سیستم‌عامل انتخاب‌شده پشتیبانی از راه‌اندازی امن را از طریق فلگ قابلیت‌های خود اعلام کرده است یا خیر. این گزینه برای آزمایش یا سناریوهای استفاده پیشرفته که در آن‌ها امضای راه‌اندازی امن باید حتی برای سیستم‌عامل‌هایی که این ویژگی را به صراحت تبلیغ نمی‌کنند در دسترس باشد، مفید است.
نمایش خلاصه‌ای از ساختار دستوری خط فرمان و خروج.
بی‌صدا کردن تمام خروجی‌های کنسول. تنها در صورت اجرا به همراه --cli معتبر است.
مشخص کردن فایل ترجمه پیام‌های Qt جایگزین جهت استفاده در رابط گرافیکی.
استعلام گرفتن از این نشانی وب به جای استعلام از کارسازهای Raspberry Pi برای دریافت فهرست تصویرهای سیستم‌عامل در دسترس. انتظار می‌رود این نشانی یک فایل JSON منطبق با قالب توصیف‌شده در json-schema مربوطه را بازگرداند.
مسیر فایل کلید خصوصی 2048 بیتی RSA در قالب PEM برای امضای پارتیشن بوت جهت فعال‌سازی راه‌اندازی امن Raspberry Pi. در صورت مشخص شدن، این ابزار فایل‌های boot.img و boot.sig را بر روی پارتیشن بوت ایجاد می‌کند. فایل کلید باید وجود داشته باشد و قابل خواندن باشد. این گزینه می‌تواند با سایر گزینه‌های سفارشی‌سازی مانند --first-run-script یا --cloudinit-userdata ترکیب شود. تنها در صورت اجرا به همراه --cli معتبر است.
اعتبارسنجی اینکه آیا تصویر دیسک با expected-hash مطابقت دارد یا خیر، پیش از نوشتن آن بر روی مقصد مشخص‌شده. تنها در صورت اجرا به همراه --cli معتبر است.
گزارش نسخه ابزار و نشانی اینترنتی پیش‌فرضی که برای تعیین تصویرهای سیستم‌عامل موجود استعلام خواهد کرد.
در صورت تعیین، نشانی URI تصویر برای نوشتن بر روی مقصد است. این مقدار می‌تواند یک فایل محلی یا یک نشانی اینترنتی راه دور با پروتکل‌های HTTP یا HTTPS باشد. در هنگام استفاده از --cli تعیین این پارامتر الزامی است.
دستگاهی که تصویر مشخص‌شده باید بر روی آن نوشته شود، برای نمونه /dev/mmcblk0. تنها در صورت اجرا به همراه --cli معتبر است.

اجرای رابط کاربری گرافیکی.
آزمایش نسخه محلی فهرست سیستم‌عامل در رابط کاربری گرافیکی.
نوشتن test.img روی /dev/mmcblk0 بدون هیچ‌گونه اعتبارسنجی تصویر دیسک و بدون بررسی صحت فلش شدن آن. این حالت از اجرای رابط گرافیکی نیز جلوگیری می‌کند.
نوشتن raspios.img روی /dev/mmcblk0 و امضای پارتیشن بوت با کلید خصوصی RSA واقع در ~/secure-boot-key.pem. این کار اعتبارسنجی راه‌اندازی امن Raspberry Pi را فعال می‌کند.
اجرای رابط گرافیکی در حالی که مرحله سفارشی‌سازی راه‌اندازی امن برای تمامی سیستم‌عامل‌ها صرف‌نظر از قابلیت‌های اعلام‌شده آن‌ها فعال است. با این حال کلید RSA همچنان باید در پنجره App Options تنظیم شود.

dd(1)