.TH "E4CRYPT" "8" "مه ۲۰۲۵" "e2fsprogs" "دستورهای مدیریتی و نگهداری"
.SH "نام (NAME)"
e4crypt \- ابزار مدیریت رمزنگاری سیستمفایل ext4
.SH "خلاصه دستور (SYNOPSIS)"
\fBe4crypt add_key\fP [ \fB\-S\fP ] [ \fB\-k\fP \fIدسته_کلید\fP ] [ \fB\-v\fP ] [ \fB\-q\fP ] [ \fB\-p\fP \fIپدینگ\fP ] [ \fIمسیر\fP... ]
.br
\fBe4crypt new_session\fP
.br
\fBe4crypt get_policy\fP \fIمسیر\fP...
.br
\fBe4crypt set_policy\fP [ \fB\-p\fP \fIپدینگ\fP ] \fIخطمشی\fP \fIمسیر\fP...
.SH "توضیحات (DESCRIPTION)"
دستور \fBe4crypt\fR مدیریت رمزنگاری در سیستمفایلهای ext4 را فراهم میکند.
.SH "دستورها (COMMANDS)"
.TP
\fBe4crypt add_key\fP [ \fB\-vq\fP ] [ \fB\-S\fP \fIنمک\fP ] [ \fB\-k\fP \fIدسته_کلید\fP ] [ \fB\-p\fP \fIپدینگ\fP ] [ \fIمسیر\fP... ]
از کاربر یک عبارت عبور (passphrase) درخواست کرده و آن را در دسته‌کلید مشخص‌شده درج می‌کند. اگر هیچ دسته‌کلیدی مشخص نشده باشد،
.B e4crypt
در صورت وجود از دسته‌کلید نشست (session keyring) و در غیر این صورت از دسته‌کلید نشست کاربر (user session keyring) استفاده خواهد کرد.
.IP
آرگومان
.I نمک
بسته به مقدار پیشوند آن، به روش‌های گوناگونی تفسیر می‌شود. اگر دو نویسه نخست «s:» باشد، مابقی آرگومان به عنوان یک رشته متنی در نظر گرفته شده و به عنوان مقدار نمک (salt) استفاده می‌شود. اگر دو نویسه نخست «0x» باشد، مابقی آرگومان به عنوان یک رشته هگزادسیمال پردازش شده و به عنوان نمک استفاده خواهد شد. اگر نویسه‌های نخست «f:» باشد، مابقی آرگومان به عنوان نام فایلی که مقدار نمک از آن خوانده می‌شود تفسیر خواهد شد. اگر رشته با نویسه «/» آغاز شود، به طور مشابه به عنوان نام فایل رفتار خواهد شد. در نهایت، اگر آرگومان
.I نمک
بتواند به عنوان یک شناسه یکتای جهانی (UUID) معتبر پردازش شود، مقدار UUID به عنوان مقدار نمک به کار می‌رود.
.IP
آرگومان
.I دسته_کلید
دسته‌کلیدی که کلید باید به آن افزوده شود را مشخص می‌کند.
.IP
مقدار
.I پدینگ
تعداد بایت‌های فاصله‌گذاری (padding) که برای اهداف مبهم‌سازی به نام پوشه‌ها افزوده می‌شود را مشخص می‌کند. مقادیر معتبر برای
.I پدینگ
شامل ۴، ۸، ۱۶، و ۳۲ هستند.
.IP
اگر یک یا چند مسیر پوشه مشخص شده باشند،
.B e4crypt
تلاش می‌کند تا خط‌مشی آن پوشه‌ها را طوری تنظیم کند که از کلیدی که به تازگی با دستور
.B add_key
افزوده شده است استفاده کنند. اگر یک نمک صراحتاً مشخص شده باشد، برای اشتقاق کلید رمزنگاری آن پوشه‌ها به کار می‌رود؛ در غیر این صورت از یک نمک پیش‌فرض مختص پوشه استفاده خواهد شد.
.TP
\fBe4crypt get_policy\fP \fIمسیر\fP...
خط‌مشی پوشه‌های مشخص‌شده در خط فرمان را چاپ می‌کند.
.TP
\fBe4crypt new_session\fP
به فرایند فراخواننده (معمولاً یک پوسته) یک دسته‌کلید نشست جدید اختصاص می‌دهد و دسته‌کلید نشست قبلی آن را دور می‌اندازد.
.TP
\fBe4crypt set_policy\fP [ \fB\-p\fP \fIپدینگ\fP ] \fIخطمشی\fP \fIمسیر\fP...
خط‌مشی پوشه‌های مشخص‌شده در خط فرمان را تنظیم می‌کند. تمام پوشه‌ها برای تنظیم خط‌مشی باید خالی باشند؛ اگر پوشه از قبل دارای یک خط‌مشی تنظیم‌شده باشد،
.B e4crypt
تطابق خط‌مشی موجود با مقدار مشخص‌شده را اعتبارسنجی می‌کند. یک خط‌مشی، یک شناسه کلید رمزنگاری متشکل از ۱۶ نویسه هگزادسیمال است.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Michael Halcrow <mhalcrow@google.com>، Ildar Muslukhov <muslukhovi@gmail.com>، و Theodore Ts'o <tytso@mit.edu>.
.SH "همچنین ببینید (SEE ALSO)"
.BR keyctl (1),
.BR mke2fs (8),
.BR mount (8).