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 <> برای سیستم دبیان گنو/لینوکس نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود). همچنین ببینید (SEE ALSO) casync(1), mksquashfs(1), unsquashfs(1) حق نشر (COPYRIGHT) 2016-2026, Jan Luebbe, Enrico Joerns, the RAUC contributors 1.15.2 March 28, 2026 RAUC(1)