RAUC(1)

RAUC

RAUC(1)

نام (NAME)

rauc - به‌روزرسانی امن و مطمئن سیستم

خلاصه دستور (SYNOPSIS)

rauc [OPTIONS...] bundle INPUTDIR BUNDLE

rauc [OPTIONS...] resign INBUNDLE OUTBUNDLE

rauc [OPTIONS...] extract BUNDLE OUTPUTDIR

rauc [OPTIONS...] extract-signature BUNDLE OUTPUTSIG

rauc [OPTIONS...] convert INBUNDLE OUTBUNDLE

rauc [OPTIONS...] encrypt INBUNDLE OUTBUNDLE

rauc [OPTIONS...] install BUNDLE

rauc [OPTIONS...] info BUNDLE

rauc [OPTIONS...] mount BUNDLE

rauc [OPTIONS...] status [SLOTNAME | mark-{good,bad,active} [booted|other|SLOTNAME]]

rauc [OPTIONS...] write-slot SLOTNAME IMAGEFILE

توضیحات (DESCRIPTION)

برنامه RAUC یک کلاینت به‌روزرسانی سبک‌وزن است که روی دستگاه‌های لینوکس تعبیه‌شده (Embedded Linux) اجرا شده و فرآیند به‌روزرسانی دستگاه با میان‌افزار جدید را به‌طور قابل‌اعتماد کنترل می‌کند.

ابزار RAUC همچنین ابزاری روی سیستم میزبان است که برای ساخت، بازرسی و تغییر فایل‌های به‌روزرسانی («دسته‌ها» یا "bundles") دستگاه استفاده می‌شود.

این صفحه راهنما، ابزار خط فرمان rauc را به اختصار مستند می‌کند.

این صفحه برای توزیع دبیان گنو/لینوکس نوشته شده است تا الزامات بسته‌بندی را برآورده سازد. بنابراین صرفاً باید به عنوان یک خلاصه در نظر گرفته شود، و مطالعه راهنمای جامع برخط (https://rauc.readthedocs.io) توصیه می‌شود.

گزینه‌ها (OPTIONS)

گزینه‌های عمومی زیر با بیشتر دستورات قابل استفاده هستند، اگرچه همه ترکیب‌ها ممکن است معنادار نباشند.

-c FILENAME, --conf=FILENAME: استفاده از فایل پیکربندی ارائه‌شده به جای مسیر پیش‌فرض کامپایل‌شده
-C SECTION:KEY=VALUE, --confopt=SECTION:KEY=VALUE: بازنویسی پارامترها از فایل پیکربندی با تنظیمات مشخص‌شده. اگر پارامتر مشخص‌شده در فایل پیکربندی موجود نباشد، همچنان توسط این گزینه تنظیم خواهد شد.
--keyring=PEMFILE: استفاده از فایل جاکلیدی (کی‌رینگ) مشخص
--mount=PATH: پیشوند نقطه اتصال (به‌طور پیش‌فرض /mnt/rauc)
-d, --debug: فعال‌سازی خروجی خطایابی (دیباگ)
--version: نمایش نسخه برنامه
-h, --help: چاپ راهنمای استفاده

دستورات (COMMANDS)

bundle INPUTDIR BUNDLE

ساخت یک بسته از دایرکتوری محتوا.

گزینه‌ها:

--cert=PEMFILE|PKCS11-URL: استفاده از فایل گواهی ارائه‌شده یا گواهی مورد ارجاع توسط نشانی اینترنتی PKCS#11 مشخص‌شده
--key=PEMFILE|PKCS11-URL: استفاده از فایل کلید خصوصی ارائه‌شده یا کلید مورد ارجاع توسط نشانی اینترنتی PKCS#11 مشخص‌شده
--intermediate=PEMFILE|PKCS11-URL: فایل گواهی واسط CA یا گواهی مورد ارجاع توسط نشانی اینترنتی PKCS#11 مشخص‌شده
--signing-keyring=PEMFILE: فایل جاکلیدی اعتبارسنجی
--mksquashfs-args=ARGS: آرگومان‌های اضافی برای mksquashfs

resign INBUNDLE OUTBUNDLE

امضای مجدد یک بسته از پیش امضاشده.

گزینه‌ها:

--append: الحاق امضا به جای جایگزینی آن
--cert=PEMFILE|PKCS11-URL: استفاده از فایل گواهی ارائه‌شده یا گواهی مورد ارجاع توسط نشانی اینترنتی PKCS#11 مشخص‌شده
--key=PEMFILE|PKCS11-URL: استفاده از فایل کلید خصوصی ارائه‌شده یا کلید مورد ارجاع توسط نشانی اینترنتی PKCS#11 مشخص‌شده
--intermediate=PEMFILE|PKCS11-URL: فایل گواهی واسط CA یا گواهی مورد ارجاع توسط نشانی اینترنتی PKCS#11 مشخص‌شده
--no-verify: غیرفعال‌سازی اعتبارسنجی بسته
--no-check-time: عدم بررسی دوره اعتبار گواهی‌ها در مقایسه با زمان فعلی
--signing-keyring=PEMFILE: فایل جاکلیدی اعتبارسنجی

extract BUNDLE OUTPUTDIR

استخراج محتوای بسته به یک دایرکتوری.

گزینه‌ها:

--key=PEMFILE|PKCS11-URL: استفاده از فایل کلید رمزگشایی ارائه‌شده یا کلید رمزگشایی مورد ارجاع توسط نشانی اینترنتی PKCS#11 مشخص‌شده
--trust-environment: اعتماد به محیط و صرف‌نظر از بررسی‌های دسترسی بسته

extract-signature BUNDLE OUTPUTSIG

استخراج امضای دیجیتال بسته.

گزینه‌ها:

--key=PEMFILE|PKCS11-URL: استفاده از فایل کلید رمزگشایی ارائه‌شده یا کلید رمزگشایی مورد ارجاع توسط نشانی اینترنتی PKCS#11 مشخص‌شده
--trust-environment: اعتماد به محیط و صرف‌نظر از بررسی‌های دسترسی بسته

convert INBUNDLE OUTBUNDLE

تبدیل یک بسته موجود به بسته شاخص و مخزن casync.

گزینه‌ها:

--cert=PEMFILE|PKCS11-URL: استفاده از فایل گواهی ارائه‌شده یا گواهی مورد ارجاع توسط نشانی اینترنتی PKCS#11 مشخص‌شده
--key=PEMFILE|PKCS11-URL: استفاده از فایل کلید خصوصی ارائه‌شده یا کلید مورد ارجاع توسط نشانی اینترنتی PKCS#11 مشخص‌شده
--intermediate=PEMFILE|PKCS11-URL: فایل گواهی واسط CA یا گواهی مورد ارجاع توسط نشانی اینترنتی PKCS#11 مشخص‌شده
--trust-environment: اعتماد به محیط و صرف‌نظر از بررسی‌های دسترسی بسته
--no-verify: غیرفعال‌سازی اعتبارسنجی بسته
--signing-keyring=PEMFILE: فایل جاکلیدی اعتبارسنجی
--mksquashfs-args=ARGS: آرگومان‌های اضافی برای mksquashfs
--casync-args=ARGS: آرگومان‌های اضافی برای casync
--ignore-image=SLOTCLASS: نادیده گرفتن ایمیج در طول تبدیل

encrypt INBUNDLE OUTBUNDLE

رمزگذاری یک بسته رمزنگاری‌شده (crypt bundle).

گزینه‌ها:

--to PEMFILE: گواهی(های) گیرنده

install BUNDLE

نصب یک بسته.

گزینه‌ها:

--ignore-compatible: غیرفعال‌سازی بررسی سازگاری
--ignore-version-limit=: غیرفعال‌سازی بررسی نسخه
--transaction-id=UUID: شناسه تراکنش سفارشی
--require-manifest-hash=HASH: الزام به هش مشخص برای مانیفست
--progress: نمایش نوار پیشرفت
--tls-cert=PEMFILE|PKCS11-URL: فایل گواهی کلاینت TLS یا نشانی اینترنتی PKCS#11
--tls-key=PEMFILE|PKCS11-URL: فایل کلید کلاینت TLS یا نشانی اینترنتی PKCS#11
--tls-ca=PEMFILE: فایل مرجع گواهی (CA) مربوط به TLS
--tls-no-verify: عدم اعتبارسنجی گواهی سرور TLS
-H, --http-header='HEADER: VALUE': هدر درخواست HTTP (استفاده چندباره پشتیبانی می‌شود)
--handler-args=ARGS: آرگومان‌های اضافی برای دستگرداننده (هندلر) کاملاً سفارشی
--override-boot-slot=BOOTNAME: بازنویسی و نادیده‌گیری تشخیص خودکار اسلات راه‌اندازی‌شده

info BUNDLE

چاپ اطلاعات بسته.

گزینه‌ها:

--no-verify: غیرفعال‌سازی اعتبارسنجی بسته
--no-check-time: عدم بررسی دوره اعتبار گواهی‌ها در مقایسه با زمان فعلی
--key=PEMFILE|PKCS11-URL: استفاده از فایل کلید رمزگشایی ارائه‌شده یا کلید رمزگشایی مورد ارجاع توسط نشانی اینترنتی PKCS#11 مشخص‌شده
--output-format=[readable|shell|json|json-pretty|json-2]: انتخاب قالب خروجی

قالب خروجی json-2 با ساختار API دی‌باس (D-Bus) مربوط به InspectBundle مطابقت دارد و باید به جای json یا json-pretty استفاده شود.

--dump-cert: تخلیه و چاپ گواهی
--dump-recipients: تخلیه و چاپ گیرندگان

mount BUNDLE

اتصال (mount) یک بسته برای اهداف توسعه در دایرکتوری بسته در پیشوند مانت RAUC. این مورد باید به صورت دستی توسط کاربر جدا (unmount) شود.

status [SLOTNAME | mark-{good,bad,active} [booted|other|SLOTNAME]]

بدون زیردستور اضافی، وضعیت کلی سیستم یا وضعیت یک اسلات خاص را نشان می‌دهد.

زیردستورهای mark-good و mark-bad می‌توانند برای تنظیم صریح وضعیت یک اسلات استفاده شوند. این زیردستورها معمولاً روی اسلات جاری راه‌اندازی‌شده عمل می‌کنند مگر اینکه با پارامتر اضافی مشخص شوند.

زیردستور mark-active امکان جابه‌جایی دستی به اسلات دیگر را فراهم می‌سازد. در اینجا نیز اسلات مورد نظر می‌تواند با پارامتر مشخص شود، در غیر این صورت از اسلات جاری راه‌اندازی‌شده استفاده خواهد شد.

گزینه‌ها:

--detailed: نمایش جزئیات بیشتر وضعیت
--output-format=[readable|shell|json|json-pretty]: انتخاب قالب خروجی
--override-boot-slot=BOOTNAME: بازنویسی و نادیده‌گیری تشخیص خودکار اسلات راه‌اندازی‌شده

write-slot SLOTNAME IMAGEFILE

نوشتن دستی ایمیج در اسلات (با استفاده از دستگرداننده به‌روزرسانی اسلات). این کار تمام منطق‌های دیگر به‌روزرسانی را دور می‌زند و صرفاً برای اهداف توسعه یا موارد خاص است!

گزینه‌ها:

--image-type: انتخاب صریح نوع ایمیج برای استفاده.

محیط (ENVIRONMENT)

RAUC_KEY_PASSPHRASE: عبارت عبور برای دسترسی به فایل‌های کلید (صرفاً برای امضا)
RAUC_PKCS11_MODULE: نام فایل کتابخانه ماژول PKCS#11 (صرفاً برای امضا)
RAUC_PKCS11_PIN: کد PIN برای دسترسی به کلیدهای PKCS#11 (صرفاً برای امضا)

فایل‌ها (FILES)

/etc/rauc/system.conf, /run/rauc/system.conf, /usr/lib/rauc/system.conf

فایل پیکربندی سیستم، پیکربندی مرکزی در RAUC است که ساختار ذخیره‌سازی، پارتیشن‌بندی و راهبرد راه‌اندازی برد شما را به یک دید یکپارچه و منسجم از افزونگی (redundancy) برای RAUC تبدیل و انتزاع می‌کند.

فایل‌های پیکربندی RAUC از یکی از دایرکتوری‌های فهرست‌شده به ترتیب اولویت بارگذاری می‌شوند؛ فقط اولین فایل یافت‌شده استفاده می‌شود: /etc/rauc/، /run/rauc/، /usr/lib/rauc/.

فایل system.conf باید سیستمی را که RAUC روی آن اجرا می‌شود به گونه‌ای توصیف کند که تمام اطلاعات لازم برای انجام به‌روزرسانی و تصمیم‌گیری ارائه شوند.

مشابه سایر فایل‌های پیکربندی مورداستفاده در RAUC، پیکربندی سیستم از نحو کلید-مقدار (مشابه فایل‌های .ini) استفاده می‌کند.

نویسندگان (AUTHORS)

برنامه rauc توسط Jan Luebbe، Enrico Joerns، Juergen Borleis و مشارکت‌کنندگان توسعه یافته است.

این صفحه راهنما توسط Michael Heimpold <<mhei@heimpold.de>> برای سیستم دبیان گنو/لینوکس نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).

همچنین ببینید (SEE ALSO)

casync(1), mksquashfs(1), unsquashfs(1)

حق نشر (COPYRIGHT)

2016-2026, Jan Luebbe, Enrico Joerns, the RAUC contributors

March 28, 2026

1.15.2