'\" t
.\"     Title: cryptsetup-resize
.\"    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\-RESIZE" "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-resize \- تغییر اندازه یک دستگاه رمزنگاریشده فعال
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcryptsetup \fIresize\fP [<\fIگزینهها\fP>] <\fIنام\fP>\fP
.SH "توضیحات (DESCRIPTION)"
.sp
اندازه نگاشت فعال برای یک دستگاه رمزنگاریشده را تغییر میدهد.
.sp
اگر \fB\-\-size\fP (بر حسب سکتورهای ۵۱۲ بایتی) یا \fB\-\-device\-size\fP مشخص نشده باشند، اندازه از روی دستگاه زیرین محاسبه می‌شود. برای LUKS این مقدار برابر با اندازه دستگاه زیرین منهای ناحیه اختصاص‌یافته به هدر LUKS است (انحراف بار داده یا همان data payload offset را در دستور \fBluksDump\fP ببینید). برای دستگاه رمزنگاری ساده (plain crypt)، اندازه کل دستگاه استفاده می‌شود.
.sp
توجه داشته باشید که این عمل هندسه فیزیکی خام دستگاه (raw device geometry) را تغییر نمی‌دهد، بلکه صرفاً مشخص می‌کند چه تعداد از سکتورهای دستگاه خام در دستگاه نگاشت‌شده نشان داده شوند.
.sp
اگر cryptsetup تشخیص دهد کلید حجم برای دستگاه فعال در سرویس دسته‌کلید کرنل (kernel keyring) بارگذاری شده است، عملیات تغییر اندازه ابتدا تلاش می‌کند کلید را با استفاده از یک توکن بازیابی کند. تنها در صورت شکست، برای باز کردن قفل اسلات کلید (در LUKS) یا اشتقاق مجدد کلید حجم (در حالت plain) درخواست گذرواژه خواهد کرد. دسته‌کلید کرنل به طور پیش‌فرض برای دستگاه‌های LUKS2 استفاده می‌شود.
.sp
<\fBگزینه‌ها\fP> می‌توانند شامل موارد زیر باشند:
.br
[\fB\-\-size\fP, \fB\-\-device\-size\fP, \fB\-\-token\-id\fP, \fB\-\-token\-only\fP, \fB\-\-token\-type\fP, \fB\-\-key\-slot\fP, \fB\-\-key\-file\fP, \fB\-\-keyfile\-size\fP, \fB\-\-keyfile\-offset\fP, \fB\-\-timeout\fP, \fB\-\-disable\-external\-tokens\fP, \fB\-\-disable\-locks\fP, \fB\-\-disable\-keyring\fP, \fB\-\-verify\-passphrase\fP, \fB\-\-timeout\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\fP یا \fB\-\-debug\-json\fP
.RS 4
اجرا در حالت اشکال‌زدایی با گزارش‌های تشخیصی کامل. خطوط خروجی اشکال‌زدایی همیشه دارای پیشوند \fB#\fP هستند.
.sp
اگر از \fB\-\-debug\-json\fP استفاده شود، ساختارهای داده اضافی LUKS2 JSON نیز چاپ می‌شوند.
.RE
.sp
\fB\-\-device\-size\fP \fIاندازه[واحدها]\fP
.RS 4
اندازه جدید دستگاه را تنظیم می‌کند. در صورت عدم تنظیم، اندازه واقعی دستگاه استفاده می‌شود.
.sp
اگر هیچ پسوند واحدی مشخص نشود، اندازه بر حسب بایت در نظر گرفته می‌شود.
.sp
پسوند واحد می‌تواند S برای سکتورهای ۵۱۲ بایتی، K/M/G/T (یا KiB، MiB، GiB، TiB) برای واحدهای بر پایه ۱۰۲۴ یا KB/MB/GB/TB برای پایه ۱۰۰۰ (مقیاس SI) باشد.
.RE
.sp
\fB\-\-disable\-external\-tokens\fP
.RS 4
بارگذاری افزونه‌ها برای توکن‌های خارجی LUKS2 را غیرفعال می‌کند.
.RE
.sp
\fB\-\-disable\-keyring\fP
.RS 4
کلید حجم را در دسته‌کلید کرنل بارگذاری نمی‌کند و در عوض آن را مستقیماً در هدف 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 در آن ذخیره شده است. این گزینه امکان ذخیره متن رمزنگاری‌شده (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) خوانده خواهد شد. در این حالت، فرایند خواندن با رسیدن به نویسه خط جدید متوقف نمی‌شود.
.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\-\-size, \-b <تعداد سکتورهای ۵۱۲ بایتی>\fP
.RS 4
تنظیم اندازه دستگاه بر حسب سکتورهای ۵۱۲ بایتی.
.RE
.sp
\fB\-\-timeout, \-t <تعداد ثانیه‌ها>\fP
.RS 4
تعداد ثانیه‌هایی که باید پیش از اتمام مهلت زمانی (timeout) برای ورود گذرواژه از طریق ترمینال منتظر بماند. این مقدار هر زمان که گذرواژه‌ای درخواست شود موثر است. در صورت استفاده همزمان با \fB\-\-key\-file\fP هیچ اثری ندارد.
.sp
این گزینه زمانی مفید است که سیستم در صورت عدم ورود گذرواژه توسط کاربر نباید متوقف یا معطل شود، برای مثال در طول راه‌اندازی (boot). مقدار پیش‌فرض ۰ ثانیه است، به این معنی که برای همیشه منتظر می‌ماند.
.RE
.sp
\fB\-\-token\-id\fP
.RS 4
مشخص می‌کند از کدام توکن استفاده شود و به اعلان پین (PIN) توکن اجازه می‌دهد بر اعلان تعاملی گذرواژه اسلات کلید اولویت داشته باشد. در صورت عدم تعیین، تمام توکن‌های موجود (که با پین محافظت نشده‌اند) پیش از ادامه کار با اعلان گذرواژه بررسی خواهند شد.
.RE
.sp
\fB\-\-token\-only\fP
.RS 4
در صورتی که باز کردن قفل اسلات کلید مبتنی بر توکن ناموفق باشد، عملیات را متوقف می‌کند. بدون این گزینه، عملیات برای ادامه کار درخواست گذرواژه خواهد کرد.
.sp
این گزینه به توکن‌های LUKS2 محافظت‌شده با پین اجازه می‌دهد بر اعلان تعاملی گذرواژه اسلات کلید اولویت داشته باشند.
.RE
.sp
\fB\-\-token\-type\fP \fIنوع\fP
.RS 4
توکن‌های مجاز برای عملیات را به \fIنوع\fP خاصی از توکن محدود می‌کند. بیشتر زمانی کاربرد دارد که \fB\-\-token\-id\fP مشخص نشده باشد.
.sp
این گزینه به توکن‌های \fIنوع\fP LUKS2 محافظت‌شده با پین اجازه می‌دهد بر اعلان تعاملی گذرواژه اسلات کلید اولویت داشته باشند.
.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" "."