'\" t
.\"     Title: cryptsetup-luksresume
.\"    Author: [بخش "نویسندگان" را ببینید]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-05-04
.\"    Manual: دستورهای مدیریتی و نگهداری
.\"    Source: cryptsetup 2.7.5
.\"  Language: Persian
.\"
.TH "CRYPTSETUP\-LUKSRESUME" "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-luksResume \- از سرگیری فعالیت یک دستگاه معلق و بازگرداندن کلید رمزنگاری
.SH "خلاصه دستور (SYNOPSIS)"
\fBcryptsetup \fIluksResume\fP [<\fIگزینه‌ها\fP>] <\fIنام\fP>\fP
.SH "توضیحات (DESCRIPTION)"
فعالیت یک دستگاه معلق‌شده را از سر می‌گیرد و کلید رمزنگاری را مجدداً برقرار می‌کند. در صورتی که هیچ توکنی قابل استفاده نباشد (فقط در LUKS2) یا گزینه \fB\-\-key\-file\fP داده نشده باشد، به صورت تعاملی گذرواژه را درخواست می‌کند.
.sp
<\fIگزینه‌ها\fP> می‌توانند شامل موارد زیر باشند:
.br
[\fB\-\-key\-file\fP، \fB\-\-keyfile\-size\fP، \fB\-\-keyfile\-offset\fP، \fB\-\-key\-slot\fP، \fB\-\-header\fP، \fB\-\-disable\-keyring\fP، \fB\-\-disable\-locks\fP، \fB\-\-token\-id\fP، \fB\-\-token\-only\fP، \fB\-\-token\-type\fP، \fB\-\-disable\-external\-tokens\fP، \fB\-\-type\fP، \fB\-\-tries\fP، \fB\-\-timeout\fP، \fB\-\-verify\-passphrase\fP، \fB\-\-volume\-key\-keyring\fP، \fB\-\-link\-vk\-to\-keyring\fP، \fB\-\-external\-tokens\-path\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\-external\-tokens\fP
.RS 4
بارگذاری افزونه‌ها را برای توکن‌های خارجی LUKS2 غیرفعال می‌کند.
.RE
.sp
\fB\-\-disable\-keyring\fP
.RS 4
کلید حجم را در جاکلیدی هسته (kernel keyring) بارگذاری نمی‌کند و در عوض آن را مستقیماً در هدف dm\-crypt ذخیره می‌کند. این گزینه فقط برای نوع LUKS2 پشتیبانی می‌شود.
.RE
.sp
\fB\-\-disable\-locks\fP
.RS 4
غیرفعال کردن محافظت از طریق قفل برای متاداده‌های روی دیسک. این گزینه فقط برای LUKS2 معتبر است و برای سایر قالب‌ها نادیده گرفته می‌شود.
.sp
\fBهشدار:\fP از این گزینه استفاده نکنید مگر اینکه cryptsetup را در یک محیط محدود اجرا کنید که در آن امکان قفل‌گذاری وجود ندارد (جایی که نمی‌توان از دایرکتوری ‎/run استفاده کرد).
.RE
.sp
\fB\-\-external\-tokens\-path\fP \fIمسیر_مطلق\fP
.RS 4
مسیر دایرکتوری سیستمی را که cryptsetup در آن به دنبال گرداننده‌های توکن خارجی (یا افزونه‌های توکن) می‌گردد بازنویسی (override) می‌کند. این مسیر باید یک مسیر مطلق باشد (که با نویسه \*(Aq/\*(Aq شروع می‌شود).
.RE
.sp
\fB\-\-header <دستگاه یا فایل ذخیره‌کننده هدر LUKS>\fP
.RS 4
استفاده از یک دستگاه یا فایل متاداده جداگانه که هدر LUKS در آن ذخیره شده است. این گزینه امکان ذخیره متن رمزشده و هدر 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) خوانده خواهد شد. در این حالت، فرایند خواندن با رسیدن به نویسه خط جدید متوقف نمی‌شود.
.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\-\-link\-vk\-to\-keyring\fP \fI<شرح_جاکلیدی>::<شرح_کلید>\fP
.RS 4
پیوند دادن کلید حجم در یک جاکلیدی با نام کلید مشخص‌شده. کلید حجم تنها در صورتی پیوند داده می‌شود که اقدام درخواستی با موفقیت به پایان برسد (همراه با \fB\-\-test\-passphrase\fP، کلید حجم اعتبارسنجی‌شده بدون اقدام بیشتر در یک جاکلیدی پیوند داده می‌شود).
.sp
رشته \fI<شرح_جاکلیدی>\fP باید شامل توصیف یک جاکلیدی موجود در هسته باشد. نام جاکلیدی می‌تواند به صورت اختیاری دارای پیشوندهای نوع "%:" یا "%keyring:" باشد. یا همچنین می‌توان جاکلیدی را مستقیماً با شناسه عددی کلید مشخص کرد. همچنین نمادگذاری‌های ویژه جاکلیدی که با "@" شروع می‌شوند می‌توانند برای انتخاب جاکلیدی‌های پیش‌تعریف‌شده موجود در هسته استفاده شوند.
.sp
رشته "::" جداکننده‌ای است که برای تفکیک شرح جاکلیدی و شرح کلید استفاده می‌شود.
.sp
بخش \fI<شرح_کلید>\fP نوع کلید و نام کلیدِ کلید حجمِ پیوند داده‌شده در جاکلیدی شرح داده‌شده در \fI<شرح_جاکلیدی>\fP را توصیف می‌کند. نوع را می‌توان با افزودن پیشوند "%<type_name>:" در ابتدای نام کلید مشخص کرد. در صورت عدم وجود نوع، نوع پیش‌فرض \fIuser\fP اعمال می‌شود. اگر کلیدی با همان نام و همان نوع از قبل وجود داشته باشد (از قبل در جاکلیدی پیوند داده شده باشد)، در این فرآیند جایگزین خواهد شد.
.sp
همچنین بخش \fBKEY IDENTIFIERS\fP از \fBkeyctl\fP(1) را ببینید.
.RE
.sp
\fB\-\-timeout, \-t <تعداد ثانیه‌ها>\fP
.RS 4
تعداد ثانیه‌های انتظار قبل از سرآمدن زمان مهلت (تایم‌اوت) برای ورود گذرواژه از طریق ترمینال. این مقدار هر بار که گذرواژه‌ای درخواست شود اعمال می‌گردد. در صورت استفاده هم‌زمان با \fB\-\-key\-file\fP هیچ تاثیری ندارد.
.sp
این گزینه زمانی مفید است که سیستم در صورت عدم ورود گذرواژه توسط کاربر نباید معطل یا متوقف بماند؛ به عنوان مثال هنگام راه‌اندازی و بوت سیستم. مقدار پیش‌فرض ۰ ثانیه است، به این معنی که تا ابد منتظر می‌ماند.
.RE
.sp
\fB\-\-token\-id\fP
.RS 4
مشخص می‌کند که از چه توکنی استفاده شود و به درخواست پین (PIN) توکن اجازه می‌دهد بر درخواست تعاملی گذرواژه اسلات کلید اولویت داشته باشد. در صورت حذف، تمام توکن‌های موجود (که با پین محافظت نشده‌اند) قبل از ادامه کار با درخواست گذرواژه بررسی خواهند شد.
.RE
.sp
\fB\-\-token\-only\fP
.RS 4
اگر باز کردن قفل اسلات کلید مبتنی بر توکن با شکست مواجه شد، اقدام را ادامه نده. بدون این گزینه، برای ادامه عملیات گذرواژه درخواست می‌شود.
.sp
این گزینه به توکن‌های LUKS2 محافظت‌شده با پین (PIN) اجازه می‌دهد بر درخواست تعاملی گذرواژه اسلات کلید اولویت پیدا کنند.
.RE
.sp
\fB\-\-token\-type\fP \fIنوع\fP
.RS 4
محدود کردن توکن‌های واجد شرایط برای عملیات به یک \fIنوع\fP توکن خاص. بیشتر زمانی مفید است که هیچ \fB\-\-token\-id\fP مشخص نشده باشد.
.sp
این گزینه به توکن‌های نوع (\fItype\fP) در LUKS2 که با پین محافظت شده‌اند اجازه می‌دهد بر درخواست تعاملی گذرواژه اسلات کلید اولویت داشته باشند.
.RE
.sp
\fB\-\-tries, \-T\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\-\-verify\-passphrase, \-y\fP
.RS 4
هنگام درخواست تعاملی گذرواژه، آن را دو بار می‌پرسد و در صورت عدم تطابق هر دو ورودی، خطا اعلام می‌کند. در صورت ورود از فایل یا ورودی استاندارد (stdin) نادیده گرفته می‌شود.
.RE
.sp
\fB\-\-version, \-V\fP
.RS 4
نمایش نسخه برنامه.
.RE
.sp
\fB\-\-volume\-key\-keyring\fP \fI<شرح کلید>\fP
.RS 4
استفاده از یک کلید حجم ذخیره‌شده در یک جاکلیدی (keyring).
این گزینه امکان باز کردن انواع دستگاه و \fIluks\fP را بدون وارد کردن گذرواژه فراهم می‌کند.
کلید و نوع مربوطه باید از فضای کاربری قابل خواندن باشند تا خلاصه (دایجست) کلید حجم پیش از فعال‌سازی قابل اعتبارسنجی باشد.
.sp
شناسه \fI<شرح کلید>\fP از ساختار نحوی سازگار با keyctl استفاده می‌کند. این مقدار می‌تواند یک شناسه عددی کلید یا یک نام رشته‌ای با قالب \fI%<key type>:<key name>\fP باشد. همچنین بخش \fBKEY IDENTIFIERS\fP از \fBkeyctl\fP(1) را ببینید. هنگامی که هیچ پیشوند \fI%<key type>:\fP مشخص نشده باشد، فرض می‌شود که نوع کلید \fIuser\fP (نوع پیش‌فرض) است.
.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" "."