.TH RPI\-IMAGER 1
.
.SH "نام (NAME)"
rpi\-imager \- نوشتن تصویر دیسک بر روی رسانه‌های ذخیره‌سازی جداشدنی
.
.
.SH "خلاصه دستور (SYNOPSIS)"
.SY rpi\-imager
.OP \-\-debug
.OP \-\-repo url
.OP \-\-qm translations
.OP \-\-disable\-telemetry
.OP \-\-enable\-secure\-boot
.OP image-uri
.YS
.
.SY rpi\-imager
\-\-cli
.OP \-\-debug
.OP \-\-quiet
.OP \-\-disable\-verify
.OP \-\-sha256 expected-hash
.OP \-\-secure\-boot\-key key-file
image-uri
destination-device
.YS
.
.SY rpi\-imager
\-\-version
.YS
.
.SY rpi\-imager
\-\-help
.YS
.
.
.SH "توضیحات (DESCRIPTION)"
دستور
.B rpi\-imager
ابزاری برای نوشتن فایل تصویر دیسک (که می‌تواند به صورت اختیاری فشرده شده باشد)
بر روی دیسک مقصد جداشدنی، مانند کارت حافظه micro-SD یا درایو SSD
متصل‌شده از طریق USB است.
.
.PP
هنگامی که این ابزار بدون هیچ آرگومان خط فرمانی اجرا شود، یک رابط گرافیکی
ساده به همراه گزینه‌های کنترلی برای انتخاب فایل تصویر، انتخاب درایو مقصد
و دکمه‌ای برای شروع نوشتن نمایش می‌دهد. در این حالت، برای دریافت فهرست
تصویرهای سیستم‌عامل موجود، از کارسازهای Raspberry Pi (و احتمالاً کارسازهای شخص ثالث)
استعلام گرفته می‌شود. همچنین می‌توانید یک
.I image-uri
(که می‌تواند یک فایل محلی یا نشانی اینترنتی تحت پروتکل‌های HTTP یا HTTPS باشد)
را مستقیماً در خط فرمان برای نوشتن مشخص کنید.
.
.PP
هنگامی که با آرگومان
.B \-\-cli
اجرا شود، این ابزار مستقیماً
.I image-uri
داده‌شده را بر روی
.I destination-device
مشخص‌شده می‌نویسد.
در این حالت، می‌توان از گزینه
.B \-\-sha256
برای ارسال چک‌سام SHA256 مورد انتظار تصویر استفاده کرد.
.
.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-\-cli
عدم اجرای رابط کاربری گرافیکی؛ صرفاً نوشتن تصویر مشخص‌شده بر روی
درایو تعیین‌شده. در این حالت، باید هر دو پارامتر
.I image-uri
و
.I destination-device
مشخص شوند.
.
.TP
.B \-\-debug
چاپ اطلاعات اشکال‌زدایی تکمیلی در کنسول.
.
.TP
.B \-\-disable\-telemetry
گزارش ندادن عملیات نوشتن سیستم‌عامل به نشانی
.I http://rpi-imager-stats.raspberrypi.com
.
.TP
.B \-\-disable\-verify
پس از اتمام نوشتن تصویر، برای اعتبارسنجی صحت داده‌های نوشته‌شده تلاشی صورت نگیرد.
تنها در صورت اجرا به همراه
.B \-\-cli
معتبر است.
.
.TP
.B \-\-enable\-secure\-boot
فعال‌سازی اجباری مرحله سفارشی‌سازی راه‌اندازی امن (Secure Boot) در رابط کاربری گرافیکی،
صرف‌نظر از اینکه آیا سیستم‌عامل انتخاب‌شده پشتیبانی از راه‌اندازی امن را از طریق
فلگ قابلیت‌های خود اعلام کرده است یا خیر. این گزینه برای آزمایش یا سناریوهای استفاده
پیشرفته که در آن‌ها امضای راه‌اندازی امن باید حتی برای سیستم‌عامل‌هایی که این ویژگی را
به صراحت تبلیغ نمی‌کنند در دسترس باشد، مفید است.
.
.TP
.B \-\-help
نمایش خلاصه‌ای از ساختار دستوری خط فرمان و خروج.
.
.TP
.B \-\-quiet
بی‌صدا کردن تمام خروجی‌های کنسول.
تنها در صورت اجرا به همراه
.B \-\-cli
معتبر است.
.
.TP
.BI \-\-qm \ translations
مشخص کردن فایل ترجمه پیام‌های Qt جایگزین جهت استفاده در رابط گرافیکی.
.
.TP
.BI \-\-repo \ url
استعلام گرفتن از این نشانی وب به جای استعلام از کارسازهای Raspberry Pi برای
دریافت فهرست تصویرهای سیستم‌عامل در دسترس. انتظار می‌رود این نشانی یک فایل JSON
منطبق با قالب توصیف‌شده در
.I json-schema
مربوطه را بازگرداند.
.
.TP
.BI \-\-secure\-boot\-key \ key-file
مسیر فایل کلید خصوصی 2048 بیتی RSA در قالب PEM برای امضای پارتیشن بوت
جهت فعال‌سازی راه‌اندازی امن Raspberry Pi. در صورت مشخص شدن، این ابزار فایل‌های
boot.img و boot.sig را بر روی پارتیشن بوت ایجاد می‌کند. فایل کلید باید وجود داشته باشد
و قابل خواندن باشد. این گزینه می‌تواند با سایر گزینه‌های سفارشی‌سازی مانند
.B \-\-first\-run\-script
یا
.B \-\-cloudinit\-userdata
ترکیب شود.
تنها در صورت اجرا به همراه
.B \-\-cli
معتبر است.
.
.TP
.BI \-\-sha256 \ expected-hash
اعتبارسنجی اینکه آیا تصویر دیسک با
.I expected-hash
مطابقت دارد یا خیر، پیش از نوشتن آن بر روی مقصد مشخص‌شده.
تنها در صورت اجرا به همراه
.B \-\-cli
معتبر است.
.
.TP
.B \-\-version
گزارش نسخه ابزار و نشانی اینترنتی پیش‌فرضی که برای تعیین تصویرهای سیستم‌عامل
موجود استعلام خواهد کرد.
.
.TP
image-uri
در صورت تعیین، نشانی URI تصویر برای نوشتن بر روی مقصد است. این مقدار می‌تواند
یک فایل محلی یا یک نشانی اینترنتی راه دور با پروتکل‌های HTTP یا HTTPS باشد.
در هنگام استفاده از
.B \-\-cli
تعیین این پارامتر الزامی است.
.
.TP
destination-device
دستگاهی که تصویر مشخص‌شده باید بر روی آن نوشته شود، برای نمونه
.IR /dev/mmcblk0 .
تنها در صورت اجرا به همراه
.B \-\-cli
معتبر است.
.
.
.SH "مثال‌ها (EXAMPLES)"
.TP
.B rpi\-imager
اجرای رابط کاربری گرافیکی.
.
.TP
.B rpi\-imager \-\-repo http://localhost:8080/os_list_utility.json
آزمایش نسخه محلی فهرست سیستم‌عامل در رابط کاربری گرافیکی.
.
.TP
.B rpi\-imager \-\-cli \-\-disable\-verify test.img /dev/mmcblk0
نوشتن
.I test.img
روی
.I /dev/mmcblk0
بدون هیچ‌گونه اعتبارسنجی تصویر دیسک و بدون بررسی صحت فلش شدن آن. این حالت از اجرای رابط گرافیکی نیز جلوگیری می‌کند.
.
.TP
.B rpi\-imager \-\-cli \-\-secure\-boot\-key ~/secure\-boot\-key.pem raspios.img /dev/mmcblk0
نوشتن
.I raspios.img
روی
.I /dev/mmcblk0
و امضای پارتیشن بوت با کلید خصوصی RSA واقع در
.IR ~/secure\-boot\-key.pem .
این کار اعتبارسنجی راه‌اندازی امن Raspberry Pi را فعال می‌کند.
.
.TP
.B rpi\-imager \-\-enable\-secure\-boot
اجرای رابط گرافیکی در حالی که مرحله سفارشی‌سازی راه‌اندازی امن برای تمامی
سیستم‌عامل‌ها صرف‌نظر از قابلیت‌های اعلام‌شده آن‌ها فعال است. با این حال
کلید RSA همچنان باید در پنجره App Options تنظیم شود.
.
.
.SH "همچنین ببینید (SEE ALSO)"
.BR dd (1)