'\" t
.\"     Title: cryptsetup-convert
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-07
.\"    Manual: دستورهای مدیریتی سیستم
.\"    Source: cryptsetup 2.8.8
.\"  Language: Persian
.\"
.TH "CRYPTSETUP\-CONVERT" "8" "2026-09-07" "cryptsetup 2.8.8" "دستورهای مدیریتی سیستم"
.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-convert \- تبدیل قالب دستگاه رمزنگاریشده میان LUKS1 و LUKS2
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcryptsetup \fIconvert\fP \-\-type <\fIقالب\fP> [<\fIگزینه‌ها\fP>] <\fIدستگاه\fP>\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستگاه را میان قالب‌های LUKS1 و LUKS2 (در صورت امکان) تبدیل می‌کند.
در صورتی که ویژگی اضافی LUKS2 وجود داشته باشد یا اندازه هدر LUKS1 پشتیبانی نشود، عملیات تبدیل انجام نخواهد شد.
.sp
برای تبدیل از LUKS2 به LUKS1، تمامی اسلات‌های کلید (keyslots) فعال باید از تابع مشتق‌گیری کلید PBKDF2 استفاده کنند.
هش PBKDF2 و فیلتر ضد جرم‌شناسی قانونی (AF) باید با هش استفاده‌شده در دایجست (digest) یکسان باشد.
شماره تمامی اسلات‌های کلید باید کمتر از ۸ باشد (حداکثر شماره اسلات در LUKS1).
باید حداقل یک اسلات کلید فعال وجود داشته باشد و هیچ اسلات کلید ناوابسته (unbound) یا در حال رمزنگاری مجدد (reencryption) وجود نداشته باشد.
.sp
عملیات تبدیل (در هر دو جهت) باید روی یک دستگاه غیرفعال انجام شود.
نباید هیچ نگاشت فعال dm\-crypt برای هدر LUKS که درخواست تبدیل آن داده شده است، وجود داشته باشد.
.sp
گزینه \fB\-\-type\fP با مقادیر پذیرفته‌شده زیر الزامی است: \fIluks1\fP یا \fIluks2\fP.
.sp
\fBهشدار:\fP عملیات \fIconvert\fP در صورت خرابی و کرش در حین تبدیل یا بروز خطای رسانه می‌تواند هدر LUKS را تخریب کند.
همیشه پیش از انجام این عملیات یک نسخه پشتیبان از هدر تهیه کنید!
.sp
<\fIگزینه‌ها\fP> می‌توانند شامل [\fB\-\-header\fP, \fB\-\-type\fP, \fB\-\-disable\-locks\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\-\-type <نوع\-دستگاه>\fP
.RS 4
نوع دستگاه مورد نیاز را مشخص می‌کند؛ برای اطلاعات بیشتر، بخش \fIBASIC ACTIONS\fP را در \fBcryptsetup\fP(8) بخوانید.
.RE
.sp
\fB\-\-usage\fP
.RS 4
نمایش راهنمای کوتاه گزینه‌ها.
.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" "."