'\" t
.\"     Title: cryptsetup-repair
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-05-04
.\"    Manual: دستورهای مدیریتی و نگهداری
.\"    Source: cryptsetup 2.7.5
.\"  Language: Persian
.\"
.TH "CRYPTSETUP\-REPAIR" "8" "مه ۲۰۲۵" "cryptsetup 2.7.5" "دستورهای مدیریتی و نگهداری"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
cryptsetup-repair \- تلاش برای تعمیر هدر یا متادیتای آسیبدیده یک دستگاه رمزنگاریشده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcryptsetup \fIrepair\fP [<\fIگزینهها\fP>] <\fIدستگاه\fP>\fP
.SH "توضیحات (DESCRIPTION)"
.sp
تلاش میکند تا متادیتای هدر آسیبدیده LUKS یا سایر کانتینرهای رمزنگاریشده را بازیابی و تعمیر کند.
در حال حاضر تنها برای نوع دستگاه LUKS پشتیبانی می‌شود.
.sp
این دستور برای ترمیم برخی آسیب‌دیدگی‌های خوش‌خیم و شناخته‌شده در هدر متاداده LUKS مفید است. تنها آسیب‌دیدگی‌های پایه‌ای اسلات‌های کلید (keyslot) استفاده‌نشده قابل تعمیر هستند. این دستور فقط هدر LUKS را تغییر می‌دهد و داده‌های هیچ اسلات کلیدی را دستکاری نمی‌کند. می‌توانید با افزودن گزینه \fB\-\-type\fP نسخه LUKS را تحمیل و مشخص کنید.
.sp
همچنین متاداده رمزنگاری مجدد (reencryption) در LUKS2 را با افزودن یک دایجست متاداده که آن را در برابر تغییرات مخرب محافظت می‌کند، تعمیر (ارتقا) می‌دهد.
.sp
اگر عملیات رمزنگاری مجدد LUKS2 در میانه نوشتن بخش رمزنگاری مجدد متوقف یا قطع شده باشد، می‌توان از دستور repair برای انجام بازیابی فرایند رمزنگاری مجدد استفاده کرد تا این عملیات بعداً بتواند ادامه یابد. تعمیر فرایند رمزنگاری مجدد نیازمند تایید اعتبار اسلات کلید مربوط به رمزنگاری مجدد است، بنابراین عبارت عبور یا فایل کلید مورد نیاز خواهد بود.
.sp
<\fIگزینه‌ها\fP> می‌توانند شامل [\fB\-\-timeout\fP, \fB\-\-verify\-passphrase\fP, \fB\-\-disable\-locks\fP, \fB\-\-type\fP, \fB\-\-header\fP, \fB\-\-key\-file\fP, \fB\-\-keyfile\-size\fP, \fB\-\-keyfile\-offset\fP, \fB\-\-key\-slot\fP] باشند.
.sp
\fBهشدار:\fP همیشه پیش از فراخوانی این دستور، یک نسخه پشتیبان باینری از هدر اصلی تهیه کنید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-\-batch\-mode, \-q\fP
.RS 4
تمامی پرسش‌های تاییدیه را لغو می‌کند. با احتیاط استفاده کنید!
.sp
اگر گزینه \fB\-\-verify\-passphrase\fP مشخص نشده باشد، این گزینه تایید و اعتبارسنجی عبارت عبور را نیز غیرفعال می‌کند.
.RE
.sp
\fB\-\-debug یا \-\-debug\-json\fP
.RS 4
اجرا در حالت اشکال‌زدایی همراه با گزارش‌های تشخیصی کامل. خطوط خروجی اشکال‌زدایی همیشه دارای پیشوند \fB#\fP هستند.
.sp
اگر از \fB\-\-debug\-json\fP استفاده شود، ساختارهای داده اضافی LUKS2 JSON نیز چاپ می‌شوند.
.RE
.sp
\fB\-\-disable\-locks\fP
.RS 4
محافظت از قفل را برای متاداده روی دیسک غیرفعال می‌کند. این گزینه فقط برای LUKS2 معتبر است و برای سایر قالب‌ها نادیده گرفته می‌شود.
.sp
\fBهشدار:\fP از این گزینه استفاده نکنید مگر آنکه cryptsetup را در یک محیط محدود که امکان قفل‌گذاری در آن وجود ندارد (جایی که دایرکتوری ‎/run قابل استفاده نیست) اجرا کنید.
.RE
.sp
\fB\-\-header <دستگاه یا فایل ذخیره‌کننده هدر LUKS>\fP
.RS 4
استفاده از یک دستگاه یا فایل متاداده جداگانه (جداشده) که هدر LUKS در آن ذخیره شده است. این گزینه اجازه می‌دهد متن رمزشده (ciphertext) و هدر LUKS روی دستگاه‌های متفاوتی ذخیره شوند.
.sp
برای دستورهایی که هدر LUKS را تغییر می‌دهند (مانند \fIluksAddKey\fP)، دستگاه یا فایل حاوی هدر LUKS را مستقیماً به عنوان دستگاه LUKS مشخص کنید.
.RE
.sp
\fB\-\-help, \-?\fP
.RS 4
نمایش متن راهنما و پارامترهای پیش‌فرض.
.RE
.sp
\fB\-\-key\-file, \-d\fP \fIنام\fP
.RS 4
خواندن عبارت عبور از فایل.
.sp
اگر نام داده‌شده "\-" باشد، عبارت عبور از ورودی استاندارد (stdin) خوانده خواهد شد. در این حالت، خواندن با نویسه‌های خط جدید (newline) متوقف نخواهد شد.
.sp
برای اطلاعات بیشتر بخش \fINOTES ON PASSPHRASE PROCESSING\fP را در \fBcryptsetup\fP(8) ببینید.
.RE
.sp
\fB\-\-keyfile\-offset\fP \fIمقدار\fP
.RS 4
نادیده گرفتن و پرش از \fIمقدار\fP بایت در ابتدای فایل کلید.
.RE
.sp
\fB\-\-keyfile\-size, \-l\fP \fIمقدار\fP
.RS 4
خواندن حداکثر \fIمقدار\fP بایت از فایل کلید. حالت پیش‌فرض خواندن کل فایل تا سقف حداکثر کامپایل‌شده درون برنامه است که می‌توان آن را با \fB\-\-help\fP استعلام کرد. وارد کردن داده‌های بیشتر از حداکثر کامپایل‌شده، عملیات را متوقف می‌کند.
.sp
این گزینه برای مثال جهت حذف خطوط جدید پایانی مفید است. اگر \fB\-\-keyfile\-offset\fP نیز داده شده باشد، شمارش اندازه پس از مقدار آفست آغاز می‌شود.
.RE
.sp
\fB\-\-key\-slot, \-S <0\-N>\fP
.RS 4
برای عملیات‌های LUKS که داده‌های کلید اضافه می‌کنند، این گزینه به شما امکان می‌دهد مشخص کنید کدام اسلات کلید برای کلید جدید انتخاب شود.
.sp
حداکثر تعداد اسلات‌های کلید به نسخه LUKS بستگی دارد. LUKS1 می‌تواند تا ۸ اسلات کلید داشته باشد. LUKS2 بسته به اندازه ناحیه اسلات کلید و اندازه کلید می‌تواند تا ۳۲ اسلات کلید داشته باشد، اما یک شناسه معتبر اسلات کلید برای LUKS2 همیشه می‌تواند بین ۰ تا ۳۱ باشد.
.RE
.sp
\fB\-\-timeout, \-t <تعداد ثانیه>\fP
.RS 4
تعداد ثانیه‌های انتظار پیش از اتمام مهلت زمانی در دریافت عبارت عبور از طریق ترمینال. این مورد هر زمان که عبارت عبور درخواست شود اعمال می‌گردد. در صورت استفاده همزمان با \fB\-\-key\-file\fP تاثیری ندارد.
.sp
این گزینه زمانی کاربرد دارد که اگر کاربر عبارت عبور را وارد نکرد، سیستم نباید معطل بماند (برای نمونه در زمان بوت). مقدار پیش‌فرض ۰ ثانیه است که به معنای انتظار همیشگی است.
.RE
.sp
\fB\-\-type <نوع\-دستگاه>\fP
.RS 4
نوع دستگاه مورد نیاز را مشخص می‌کند؛ برای اطلاعات بیشتر بخش \fIBASIC ACTIONS\fP را در \fBcryptsetup\fP(8) بخوانید.
.RE
.sp
\fB\-\-usage\fP
.RS 4
نمایش راهنمای کوتاه گزینه‌ها.
.RE
.sp
\fB\-\-verify\-passphrase, \-y\fP
.RS 4
هنگام دریافت تعاملی عبارت عبور، دو بار آن را بپرسد و اگر هر دو ورودی یکسان نبودند خطا اعلام کند. در صورت ورود اطلاعات از فایل یا ورودی استاندارد (stdin) نادیده گرفته می‌شود.
.RE
.sp
\fB\-\-version, \-V\fP
.RS 4
نمایش نسخه برنامه.
.RE
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
گزارش باگ‌ها در \c
.MTO "cryptsetup\(atlists.linux.dev" "\fBلیست پستی cryptsetup\fP"
یا در \c
.URL "https://gitlab.com/cryptsetup/cryptsetup/\-/issues/new" "\fBبخش مسائل پروژه\fP" "."
.sp
لطفاً خروجی دستور ناموفق را همراه با گزینه \fB\-\-debug\fP پیوست کنید.
.SH "همچنین ببینید (SEE ALSO)"
.sp
.URL "https://gitlab.com/cryptsetup/cryptsetup/wikis/FrequentlyAskedQuestions" "\fBپرسش‌های متداول cryptsetup (FAQ)\fP" ""
.sp
\fBcryptsetup\fP(8)، \fBintegritysetup\fP(8) و \fBveritysetup\fP(8)
.SH "کریپت‌ست‌آپ (CRYPTSETUP)"
.sp
بخشی از \c
.URL "https://gitlab.com/cryptsetup/cryptsetup" "\fBپروژه cryptsetup\fP" "."