'\" t
.\"     Title: cryptsetup-fvault2open
.\"    Author: [بخش "نویسندگان" را ببینید]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-07
.\"    Manual: دستورهای مدیریتی سیستم
.\"    Source: cryptsetup 2.8.8
.\"  Language: Persian
.\"
.TH "CRYPTSETUP\-FVAULT2OPEN" "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-fvault2Open \- باز کردن یک دستگاه رمزگذاری‌شده با فایلوالت ۲ (FileVault2) و ایجاد نگاشت
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcryptsetup \fIfvault2Open\fP [<\fIگزینه‌ها\fP>] <\fIدستگاه\fP> <\fIنام\fP>\fP
.br
\fBcryptsetup \fIopen \-\-type fvault2\fP [<\fIگزینه‌ها\fP>] <\fIدستگاه\fP> <\fIنام\fP>\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستگاه سازگار با FileVault2 با شناسه <\fIدستگاه\fP> را باز می‌کند و نگاشت <\fIنام\fP> را راه‌اندازی می‌نماید.
.sp
توجه داشته باشید که \fB\-\-test\-passphrase\fP همراه با \fB\-\-volume\-key\-file\fP کار نمی‌کند، زیرا نمی‌توان بررسی کرد که آیا کلید حجم ارائه‌شده برای این دستگاه صحیح است یا خیر.
هنگام استفاده از \fB\-\-volume\-key\-file\fP، دستگاه حتی در صورت نادرست بودن کلید ارائه‌شده نیز باز خواهد شد.
.sp
<\fIگزینه‌ها\fP> می‌توانند شامل موارد زیر باشند:
.br
[\fB\-\-allow\-discards\fP, \fB\-\-batch\-mode\fP, \fB\-\-debug\fP, \fB\-\-help\fP, \fB\-\-key\-file\fP, \fB\-\-keyfile\-offset\fP, \fB\-\-keyfile\-size\fP, \fB\-\-key\-size\fP, \fB\-\-readonly\fP, \fB\-\-test\-passphrase\fP, \fB\-\-timeout\fP, \fB\-\-tries\fP, \fB\-\-usage\fP, \fB\-\-version\fP, \fB\-\-verify\-passphrase\fP, \fB\-\-volume\-key\-file\fP].
.SH "گزینه‌ها (OPTIONS)"

.sp
\fB\-\-allow\-discards\fP
.RS 4
اجازه استفاده از درخواست‌های دور انداختن (TRIM / discard) برای دستگاه.
این قابلیت برای دستگاه‌های LUKS2 با محافظت از یکپارچگی داده‌ها پشتیبانی نمی‌شود.
.RE

.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\-\-help, \-?\fP
.RS 4
نمایش متن راهنما و پارامترهای پیش‌فرض.
.RE

.sp
\fB\-\-key\-file, \-d\fP \fIفایل\fP
.RS 4
خواندن گذرواژه از فایل.
.sp
اگر نام داده‌شده "\-" باشد، گذرواژه از ورودی استاندارد (stdin) خوانده خواهد شد.
در این حالت، خواندن با رسیدن به نویسه خط جدید متوقف نمی‌شود.
.sp
در دستگاه‌های نوع \fIplain\fP، گذرواژه به‌دست‌آمده از طریق گزینه \fB\-\-key\-file\fP مستقیماً به dm\-crypt تحویل داده می‌شود؛
بر خلاف حالت تعاملی (stdin) که در آن، خلاصه (digest) گذرواژه به dm\-crypt ارسال می‌گردد.
.sp
برای اطلاعات بیشتر، بخش \fINOTES ON PASSPHRASE PROCESSING\fP را در \fBcryptsetup\fP(8) ببینید.
.RE

.sp
\fB\-\-key\-size, \-s\fP \fIبیت‌ها\fP
.RS 4
تنظیم اندازه کلید بر حسب \fIبیت\fP.
آرگومان باید مضربی از ۸ باشد.
اندازه‌های ممکن کلید توسط الگوریتم رمزنگاری و حالت مورد استفاده محدود می‌شوند.
.sp
برای اطلاعات بیشتر، ‎/proc/crypto را ببینید.
توجه داشته باشید که اندازه کلید در ‎/proc/crypto بر حسب بایت بیان شده است.
.sp
این گزینه می‌تواند برای دستگاه‌های \fIplain\fP و \fIluks\fP استفاده شود.
برای دستگاه‌های LUKS2 در حال رمزگذاری مجدد (re-encryption)، می‌توانید از این پارامتر دو بار برای تعیین اندازه هر دو کلید حجم قدیم و جدید استفاده کنید.
هر گزینه \fB\-\-key\-size\fP با پارامتر متناظر \fB\-\-volume\-key\-file\fP مطابقت دارد (که آن هم تا دو بار مجاز به استفاده است).
.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
این گزینه به عنوان مثال برای حذف خطوط جدید پایانی (trailing newlines) مفید است.
اگر \fB\-\-keyfile\-offset\fP نیز داده شده باشد، شمارش اندازه از پس از آفست آغاز می‌شود.
.RE

.sp
\fB\-\-readonly, \-r\fP
.RS 4
راه‌اندازی یک نگاشت فقط‌خواندنی (read\-only).
.RE

.sp
\fB\-\-test\-passphrase\fP
.RS 4
دستگاه را فعال نکن، فقط گذرواژه را اعتبارسنجی کن.
در صورت استفاده از این گزینه، تعیین نام نگاشت دستگاه اجباری نیست.
.RE

.sp
\fB\-\-timeout, \-t\fP \fIثانیه‌ها\fP
.RS 4
تعداد ثانیه‌های انتظار قبل از سرآمدن زمان مهلت (تایم‌اوت) برای ورود گذرواژه از طریق ترمینال.
این مقدار هر بار که گذرواژه‌ای درخواست شود اعمال می‌گردد.
در صورت استفاده هم‌زمان با \fB\-\-key\-file\fP هیچ تاثیری ندارد.
.sp
این گزینه زمانی مفید است که سیستم در صورت عدم ورود گذرواژه توسط کاربر نباید معطل یا متوقف بماند؛ به عنوان مثال هنگام راه‌اندازی و بوت سیستم.
مقدار پیش‌فرض ۰ ثانیه است، به این معنی که تا ابد منتظر می‌ماند.
.RE

.sp
\fB\-\-tries, \-T\fP
.RS 4
تعداد دفعات مجاز برای تلاش مجدد جهت ورود گذرواژه.
مقدار پیش‌فرض ۳ بار است.
.RE

.sp
\fB\-\-usage\fP
.RS 4
نمایش راهنمای کوتاه گزینه‌ها.
.RE

.sp
\fB\-\-verify\-passphrase, \-y\fP
.RS 4
هنگام درخواست تعاملی گذرواژه، آن را دو بار می‌پرسد و در صورت عدم تطابق هر دو ورودی، خطا اعلام می‌کند.
استفاده از این گزینه هنگام ایجاد نگاشت از نوع \fIplain\fP برای اولین بار توصیه می‌شود.
در صورت دریافت ورودی از فایل یا ورودی استاندارد (stdin) نادیده گرفته می‌شود.
.RE

.sp
\fB\-\-version, \-V\fP
.RS 4
نمایش نسخه برنامه.
.RE

.sp
\fB\-\-volume\-key\-file\fP \fIفایل\fP, \fB\-\-master\-key\-file\fP \fIفایل\fP (نام مستعار منسوخ‌شده)
.RS 4
استفاده از یک کلید حجم ذخیره‌شده در یک فایل.
.sp
این گزینه امکان باز کردن انواع دستگاه‌های \fIluks\fP و \fIbitlk\fP را بدون وارد کردن گذرواژه فراهم می‌کند.
.sp
برای دستگاه‌های در حال رمزگذاری مجدد (re-encryption)، این گزینه ممکن است دو بار برای تعیین هر دو کلید حجم قدیمی و جدید استفاده شود.
هنگام استفاده دوگانه از این گزینه، مطمئن شوید که هر گزینه \fB\-\-volume\-key\-file\fP را با پارامتر متناظر \fB\-\-key\-size\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" "."