'\" t
.\"     Title: cryptsetup-bitlkopen
.\"    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\-BITLKOPEN" "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-bitlkOpen \- باز کردن یک دستگاه رمزگذاریشده با بیتلاکر (BitLocker) و ایجاد نگاشت
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcryptsetup \fIbitlkOpen\fP [<\fIگزینه‌ها\fP>] <\fIدستگاه\fP> <\fIنام\fP>\fP
.br
\fBcryptsetup \fIopen \-\-type bitlk\fP [<\fIگزینه‌ها\fP>] <\fIدستگاه\fP> <\fIنام\fP>\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستگاه سازگار با بیت‌لاکر (BITLK) با نام <\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
اجازه استفاده از درخواست‌های دورریز (discard/TRIM) را برای دستگاه می‌دهد.
این قابلیت برای دستگاه‌های 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 تعیین می‌کند. آرگومان ورودی باید مضربی از ۸ باشد. اندازه‌های ممکن کلید توسط الگوریتم رمزگذاری (cipher) و حالت مورد استفاده محدود می‌شوند.
.sp
برای اطلاعات بیشتر به /proc/crypto مراجعه کنید. توجه داشته باشید که اندازه کلید در /proc/crypto بر حسب بایت بیان شده است.
.sp
این گزینه می‌تواند برای دستگاه‌های \fIplain\fP و \fIluks\fP استفاده شود. برای دستگاه‌های LUKS2 در حین رمزگذاری مجدد (reencryption)، می‌توانید از این پارامتر دو بار برای تعیین اندازه هر دو کلید حجم قدیم و جدید استفاده کنید.
هر گزینه \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
راه‌اندازی یک نگاشت فقط‌خواندنی.
.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
برای دستگاه‌های در حال رمزگذاری مجدد (reencryption)، این گزینه ممکن است دو بار برای مشخص کردن هر دو کلید حجم قدیم و جدید استفاده شود.
هنگام استفاده دوگانه از این گزینه، مطمئن شوید که هر گزینه \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" "."