.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "RAUC" "1" "Mar 28, 2026" "1.15.2" "RAUC"
.SH "نام (NAME)"
rauc \- به‌روزرسانی امن و مطمئن سیستم
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBrauc\fP [\fIOPTIONS\fP\&...] \fBbundle\fP \fIINPUTDIR\fP \fIBUNDLE\fP
.sp
\fBrauc\fP [\fIOPTIONS\fP\&...] \fBresign\fP \fIINBUNDLE\fP \fIOUTBUNDLE\fP
.sp
\fBrauc\fP [\fIOPTIONS\fP\&...] \fBextract\fP \fIBUNDLE\fP \fIOUTPUTDIR\fP
.sp
\fBrauc\fP [\fIOPTIONS\fP\&...] \fBextract\-signature\fP \fIBUNDLE\fP \fIOUTPUTSIG\fP
.sp
\fBrauc\fP [\fIOPTIONS\fP\&...] \fBconvert\fP \fIINBUNDLE\fP \fIOUTBUNDLE\fP
.sp
\fBrauc\fP [\fIOPTIONS\fP\&...] \fBencrypt\fP \fIINBUNDLE\fP \fIOUTBUNDLE\fP
.sp
\fBrauc\fP [\fIOPTIONS\fP\&...] \fBinstall\fP \fIBUNDLE\fP
.sp
\fBrauc\fP [\fIOPTIONS\fP\&...] \fBinfo\fP \fIBUNDLE\fP
.sp
\fBrauc\fP [\fIOPTIONS\fP\&...] \fBmount\fP \fIBUNDLE\fP
.sp
\fBrauc\fP [\fIOPTIONS\fP\&...] \fBstatus\fP [\fISLOTNAME\fP |
\fBmark\-\fP{\fBgood\fP,\fBbad\fP,\fBactive\fP}
[\fBbooted\fP|\fBother\fP|\fISLOTNAME\fP]]
.sp
\fBrauc\fP [\fIOPTIONS\fP\&...] \fBwrite\-slot\fP \fISLOTNAME\fP \fIIMAGEFILE\fP
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه RAUC یک کلاینت به‌روزرسانی سبک‌وزن است که روی دستگاه‌های لینوکس تعبیه‌شده
(Embedded Linux) اجرا شده و فرآیند به‌روزرسانی دستگاه با میان‌افزار جدید را
به‌طور قابل‌اعتماد کنترل می‌کند.
.sp
ابزار RAUC همچنین ابزاری روی سیستم میزبان است که برای ساخت، بازرسی
و تغییر فایل‌های به‌روزرسانی («دسته‌ها» یا \(dqbundles\(dq) دستگاه استفاده می‌شود.
.sp
این صفحه راهنما، ابزار خط فرمان \fBrauc\fP را به اختصار مستند می‌کند.
.sp
این صفحه برای توزیع دبیان گنو/لینوکس نوشته شده است تا الزامات بسته‌بندی را
برآورده سازد. بنابراین صرفاً باید به عنوان یک خلاصه در نظر گرفته شود، و مطالعه
راهنمای جامع برخط (\fBhttps://rauc.readthedocs.io\fP) توصیه می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.sp
گزینه‌های عمومی زیر با بیشتر دستورات قابل استفاده هستند، اگرچه
همه ترکیب‌ها ممکن است معنادار نباشند.
.INDENT 0.0
.TP
\fB\-c\fP \fIFILENAME\fP, \fB\-\-conf=\fP\fIFILENAME\fP
استفاده از فایل پیکربندی ارائه‌شده به جای مسیر پیش‌فرض کامپایل‌شده
.TP
\fB\-C\fP \fISECTION:KEY=VALUE\fP, \fB\-\-confopt=\fP\fISECTION:KEY=VALUE\fP
بازنویسی پارامترها از فایل پیکربندی با تنظیمات مشخص‌شده. اگر پارامتر مشخص‌شده در فایل
پیکربندی موجود نباشد، همچنان توسط این گزینه تنظیم خواهد شد.
.TP
\fB\-\-keyring=\fP\fIPEMFILE\fP
استفاده از فایل جاکلیدی (کی‌رینگ) مشخص
.TP
\fB\-\-mount=\fP\fIPATH\fP
پیشوند نقطه اتصال (به‌طور پیش‌فرض /mnt/rauc)
.TP
\fB\-d\fP, \fB\-\-debug\fP
فعال‌سازی خروجی خطایابی (دیباگ)
.TP
\fB\-\-version\fP
نمایش نسخه برنامه
.TP
\fB\-h\fP, \fB\-\-help\fP
چاپ راهنمای استفاده
.UNINDENT
.SH "دستورات (COMMANDS)"
.sp
\fBbundle\fP \fIINPUTDIR\fP \fIBUNDLE\fP
.INDENT 0.0
.INDENT 3.5
ساخت یک بسته از دایرکتوری محتوا.
.sp
\fBگزینه‌ها:\fP
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-\-cert=\fP\fIPEMFILE\fP|\fIPKCS11\-URL\fP
استفاده از فایل گواهی ارائه‌شده یا گواهی مورد ارجاع توسط
نشانی اینترنتی PKCS#11 مشخص‌شده
.TP
\fB\-\-key=\fP\fIPEMFILE\fP|\fIPKCS11\-URL\fP
استفاده از فایل کلید خصوصی ارائه‌شده یا کلید مورد ارجاع توسط
نشانی اینترنتی PKCS#11 مشخص‌شده
.TP
\fB\-\-intermediate=\fP\fIPEMFILE\fP|\fIPKCS11\-URL\fP
فایل گواهی واسط CA یا گواهی مورد ارجاع توسط نشانی
اینترنتی PKCS#11 مشخص‌شده
.TP
\fB\-\-signing\-keyring=\fP\fIPEMFILE\fP
فایل جاکلیدی اعتبارسنجی
.TP
\fB\-\-mksquashfs\-args=\fP\fIARGS\fP
آرگومان‌های اضافی برای mksquashfs
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBresign\fP \fIINBUNDLE\fP \fIOUTBUNDLE\fP
.INDENT 0.0
.INDENT 3.5
امضای مجدد یک بسته از پیش امضاشده.
.sp
\fBگزینه‌ها:\fP
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-\-append\fP
الحاق امضا به جای جایگزینی آن
.TP
\fB\-\-cert=\fP\fIPEMFILE\fP|\fIPKCS11\-URL\fP
استفاده از فایل گواهی ارائه‌شده یا گواهی مورد ارجاع توسط
نشانی اینترنتی PKCS#11 مشخص‌شده
.TP
\fB\-\-key=\fP\fIPEMFILE\fP|\fIPKCS11\-URL\fP
استفاده از فایل کلید خصوصی ارائه‌شده یا کلید مورد ارجاع توسط
نشانی اینترنتی PKCS#11 مشخص‌شده
.TP
\fB\-\-intermediate=\fP\fIPEMFILE\fP|\fIPKCS11\-URL\fP
فایل گواهی واسط CA یا گواهی مورد ارجاع توسط نشانی
اینترنتی PKCS#11 مشخص‌شده
.TP
\fB\-\-no\-verify\fP
غیرفعال‌سازی اعتبارسنجی بسته
.TP
\fB\-\-no\-check\-time\fP
عدم بررسی دوره اعتبار گواهی‌ها در مقایسه با زمان فعلی
.TP
\fB\-\-signing\-keyring=\fP\fIPEMFILE\fP
فایل جاکلیدی اعتبارسنجی
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBextract\fP \fIBUNDLE\fP \fIOUTPUTDIR\fP
.INDENT 0.0
.INDENT 3.5
استخراج محتوای بسته به یک دایرکتوری.
.sp
\fBگزینه‌ها:\fP
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-\-key=\fP\fIPEMFILE\fP|\fIPKCS11\-URL\fP
استفاده از فایل کلید رمزگشایی ارائه‌شده یا کلید رمزگشایی مورد ارجاع
توسط نشانی اینترنتی PKCS#11 مشخص‌شده
.TP
\fB\-\-trust\-environment\fP
اعتماد به محیط و صرف‌نظر از بررسی‌های دسترسی بسته
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBextract\-signature\fP \fIBUNDLE\fP \fIOUTPUTSIG\fP
.INDENT 0.0
.INDENT 3.5
استخراج امضای دیجیتال بسته.
.sp
\fBگزینه‌ها:\fP
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-\-key=\fP\fIPEMFILE\fP|\fIPKCS11\-URL\fP
استفاده از فایل کلید رمزگشایی ارائه‌شده یا کلید رمزگشایی مورد ارجاع
توسط نشانی اینترنتی PKCS#11 مشخص‌شده
.TP
\fB\-\-trust\-environment\fP
اعتماد به محیط و صرف‌نظر از بررسی‌های دسترسی بسته
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBconvert\fP \fIINBUNDLE\fP \fIOUTBUNDLE\fP
.INDENT 0.0
.INDENT 3.5
تبدیل یک بسته موجود به بسته شاخص و مخزن casync.
.sp
\fBگزینه‌ها:\fP
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-\-cert=\fP\fIPEMFILE\fP|\fIPKCS11\-URL\fP
استفاده از فایل گواهی ارائه‌شده یا گواهی مورد ارجاع توسط
نشانی اینترنتی PKCS#11 مشخص‌شده
.TP
\fB\-\-key=\fP\fIPEMFILE\fP|\fIPKCS11\-URL\fP
استفاده از فایل کلید خصوصی ارائه‌شده یا کلید مورد ارجاع توسط
نشانی اینترنتی PKCS#11 مشخص‌شده
.TP
\fB\-\-intermediate=\fP\fIPEMFILE\fP|\fIPKCS11\-URL\fP
فایل گواهی واسط CA یا گواهی مورد ارجاع توسط نشانی
اینترنتی PKCS#11 مشخص‌شده
.TP
\fB\-\-trust\-environment\fP
اعتماد به محیط و صرف‌نظر از بررسی‌های دسترسی بسته
.TP
\fB\-\-no\-verify\fP
غیرفعال‌سازی اعتبارسنجی بسته
.TP
\fB\-\-signing\-keyring=\fP\fIPEMFILE\fP
فایل جاکلیدی اعتبارسنجی
.TP
\fB\-\-mksquashfs\-args=\fP\fIARGS\fP
آرگومان‌های اضافی برای mksquashfs
.TP
\fB\-\-casync\-args=\fP\fIARGS\fP
آرگومان‌های اضافی برای casync
.TP
\fB\-\-ignore\-image=\fP\fISLOTCLASS\fP
نادیده گرفتن ایمیج در طول تبدیل
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBencrypt\fP \fIINBUNDLE\fP \fIOUTBUNDLE\fP
.INDENT 0.0
.INDENT 3.5
رمزگذاری یک بسته رمزنگاری‌شده (crypt bundle).
.sp
\fBگزینه‌ها:\fP
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-\-to\fP \fIPEMFILE\fP
گواهی(های) گیرنده
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBinstall\fP \fIBUNDLE\fP
.INDENT 0.0
.INDENT 3.5
نصب یک بسته.
.sp
\fBگزینه‌ها:\fP
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-\-ignore\-compatible\fP
غیرفعال‌سازی بررسی سازگاری
.TP
\fB\-\-ignore\-version\-limit=\fP
غیرفعال‌سازی بررسی نسخه
.TP
\fB\-\-transaction\-id=\fP\fIUUID\fP
شناسه تراکنش سفارشی
.TP
\fB\-\-require\-manifest\-hash=\fP\fIHASH\fP
الزام به هش مشخص برای مانیفست
.TP
\fB\-\-progress\fP
نمایش نوار پیشرفت
.TP
\fB\-\-tls\-cert=\fP\fIPEMFILE|PKCS11\-URL\fP
فایل گواهی کلاینت TLS یا نشانی اینترنتی PKCS#11
.TP
\fB\-\-tls\-key=\fP\fIPEMFILE|PKCS11\-URL\fP
فایل کلید کلاینت TLS یا نشانی اینترنتی PKCS#11
.TP
\fB\-\-tls\-ca=\fP\fIPEMFILE\fP
فایل مرجع گواهی (CA) مربوط به TLS
.TP
\fB\-\-tls\-no\-verify\fP
عدم اعتبارسنجی گواهی سرور TLS
.TP
\fB\-H\fP, \fB\-\-http\-header\fP=\fI\(aqHEADER: VALUE\(aq\fP
هدر درخواست HTTP (استفاده چندباره پشتیبانی می‌شود)
.TP
\fB\-\-handler\-args=\fP\fIARGS\fP
آرگومان‌های اضافی برای دستگرداننده (هندلر) کاملاً سفارشی
.TP
\fB\-\-override\-boot\-slot=\fP\fIBOOTNAME\fP
بازنویسی و نادیده‌گیری تشخیص خودکار اسلات راه‌اندازی‌شده
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBinfo\fP \fIBUNDLE\fP
.INDENT 0.0
.INDENT 3.5
چاپ اطلاعات بسته.
.sp
\fBگزینه‌ها:\fP
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-\-no\-verify\fP
غیرفعال‌سازی اعتبارسنجی بسته
.TP
\fB\-\-no\-check\-time\fP
عدم بررسی دوره اعتبار گواهی‌ها در مقایسه با زمان فعلی
.TP
\fB\-\-key=\fP\fIPEMFILE\fP|\fIPKCS11\-URL\fP
استفاده از فایل کلید رمزگشایی ارائه‌شده یا کلید رمزگشایی مورد ارجاع
توسط نشانی اینترنتی PKCS#11 مشخص‌شده
.TP
\fB\-\-output\-format=\fP[\fBreadable\fP|\fBshell\fP|\fBjson\fP|\fBjson\-pretty\fP|\fBjson\-2\fP]
انتخاب قالب خروجی
.UNINDENT
.sp
قالب خروجی json\-2 با ساختار API دی‌باس (D\-Bus) مربوط به InspectBundle مطابقت دارد
و باید به جای \fBjson\fP یا \fBjson\-pretty\fP استفاده شود.
.INDENT 0.0
.TP
\fB\-\-dump\-cert\fP
تخلیه و چاپ گواهی
.TP
\fB\-\-dump\-recipients\fP
تخلیه و چاپ گیرندگان
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmount\fP \fIBUNDLE\fP
.INDENT 0.0
.INDENT 3.5
اتصال (mount) یک بسته برای اهداف توسعه در دایرکتوری بسته در
پیشوند مانت RAUC. این مورد باید به صورت دستی توسط کاربر جدا (unmount) شود.
.UNINDENT
.UNINDENT
.sp
\fBstatus\fP [\fISLOTNAME\fP | \fBmark\-\fP{\fBgood\fP,\fBbad\fP,\fBactive\fP}
[\fBbooted\fP|\fBother\fP|\fISLOTNAME\fP]]
.INDENT 0.0
.INDENT 3.5
بدون زیردستور اضافی، وضعیت کلی سیستم یا وضعیت یک اسلات
خاص را نشان می‌دهد.
.sp
زیردستورهای \fBmark\-good\fP و \fBmark\-bad\fP می‌توانند برای تنظیم صریح وضعیت یک
اسلات استفاده شوند. این زیردستورها معمولاً روی اسلات جاری راه‌اندازی‌شده
عمل می‌کنند مگر اینکه با پارامتر اضافی مشخص شوند.
.sp
زیردستور \fBmark\-active\fP امکان جابه‌جایی دستی به اسلات دیگر را فراهم می‌سازد.
در اینجا نیز اسلات مورد نظر می‌تواند با پارامتر مشخص شود، در غیر این صورت
از اسلات جاری راه‌اندازی‌شده استفاده خواهد شد.
.sp
\fBگزینه‌ها:\fP
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-\-detailed\fP
نمایش جزئیات بیشتر وضعیت
.TP
\fB\-\-output\-format=\fP[\fBreadable\fP|\fBshell\fP|\fBjson\fP|\fBjson\-pretty\fP]
انتخاب قالب خروجی
.TP
\fB\-\-override\-boot\-slot=\fP\fIBOOTNAME\fP
بازنویسی و نادیده‌گیری تشخیص خودکار اسلات راه‌اندازی‌شده
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBwrite\-slot\fP \fISLOTNAME\fP \fIIMAGEFILE\fP
.INDENT 0.0
.INDENT 3.5
نوشتن دستی ایمیج در اسلات (با استفاده از دستگرداننده به‌روزرسانی اسلات). این کار
تمام منطق‌های دیگر به‌روزرسانی را دور می‌زند و صرفاً برای اهداف توسعه یا موارد خاص است!
.sp
\fBگزینه‌ها:\fP
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-\-image\-type\fP
انتخاب صریح نوع ایمیج برای استفاده.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH "محیط (ENVIRONMENT)"
.INDENT 0.0
.TP
\fBRAUC_KEY_PASSPHRASE\fP
عبارت عبور برای دسترسی به فایل‌های کلید (صرفاً برای امضا)
.TP
\fBRAUC_PKCS11_MODULE\fP
نام فایل کتابخانه ماژول PKCS#11 (صرفاً برای امضا)
.TP
\fBRAUC_PKCS11_PIN\fP
کد PIN برای دسترسی به کلیدهای PKCS#11 (صرفاً برای امضا)
.UNINDENT
.SH "فایل‌ها (FILES)"
.sp
\fB/etc/rauc/system.conf, /run/rauc/system.conf, /usr/lib/rauc/system.conf\fP
.sp
فایل پیکربندی سیستم، پیکربندی مرکزی در RAUC است که ساختار ذخیره‌سازی،
پارتیشن‌بندی و راهبرد راه‌اندازی برد شما را به یک دید یکپارچه و منسجم از افزونگی
(redundancy) برای RAUC تبدیل و انتزاع می‌کند.
.sp
فایل‌های پیکربندی RAUC از یکی از دایرکتوری‌های فهرست‌شده به ترتیب اولویت
بارگذاری می‌شوند؛ فقط اولین فایل یافت‌شده استفاده می‌شود: \fB/etc/rauc/\fP،
\fB/run/rauc/\fP، \fB/usr/lib/rauc/\fP\&.
.sp
فایل \fBsystem.conf\fP باید سیستمی را که RAUC روی آن اجرا می‌شود به گونه‌ای
توصیف کند که تمام اطلاعات لازم برای انجام به‌روزرسانی و تصمیم‌گیری ارائه شوند.
.sp
مشابه سایر فایل‌های پیکربندی مورداستفاده در RAUC، پیکربندی سیستم از نحو
کلید\-مقدار (مشابه فایل‌های .ini) استفاده می‌کند.
.SH "نویسندگان (AUTHORS)"
.sp
برنامه rauc توسط Jan Luebbe، Enrico Joerns، Juergen Borleis و
مشارکت‌کنندگان توسعه یافته است.
.sp
این صفحه راهنما توسط Michael Heimpold <\%<mhei@\:heimpold\:.de>> برای
سیستم دبیان گنو/لینوکس نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBcasync\fP(1), \fBmksquashfs\fP(1), \fBunsquashfs\fP(1)
.SH "حق نشر (COPYRIGHT)"
2016-2026, Jan Luebbe, Enrico Joerns, the RAUC contributors
.\" End of generated man page.