.TH "DOVEADM-MAIL-FS" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
doveadm\-mail\-fs \- تعامل با سامانهٔ فایل انتزاعی ذخیره‌سازی ایمیل در بافت کاربر
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBfs\fR \fIcommand\fR \fIconfig-filter-name\fR \[lB]\fIARGUMENTS\fR\[rB]
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBmail fs\fR \fIcommand\fR \[lB]\fIOPTIONS\fR\[rB] \fIconfig-filter-name\fR \[lB]\fIARGUMENTS\fR\[rB]
.SH "توضیحات (DESCRIPTION)"
.P
دستورات \fBdoveadm fs\fR برای تعامل انتزاعی با درایور ذخیره‌سازیِ تعریف‌شده در پیکربندی Dovecot استفاده می‌شوند. این دستورات امکان دسترسی به ساختار صندوق پستی را بدون نیاز به دانستن جزئیات نحوهٔ طراحی درایور ذخیره‌سازی فراهم می‌سازند.
.P
\fIconfig-filter-name\fR
.RS 0
.RS 4
.P
نام فیلتری که هنگام جستجوی تنظیمات fs استفاده می‌شود؛ برای نمونه \fImail_attachments\fR، \fIobox\fR، \fImetacache\fR، \fIfts/dovecot\fR. همچنین می‌توان از یک نام فیلتر خالی استفاده کرد و تنظیمات fs را با استفاده از پارامتر \fB-o\fR مشخص نمود.
.RE 0

.RE 0

.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.P
گزینه‌های عمومی doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
پیام‌های اشکال‌زدایی (debug) و پرگویی (\fIverbosity\fR) را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-O\fR
.RS 0
.RS 4
.P
هیچ فایل پیکربندی‌ای را نمی‌خواند و صرفاً از مقادیر پیش‌فرض استفاده می‌کند. تنظیم \fBdovecot_storage_version\fR به‌طور پیش‌فرض روی جدیدترین نسخه قرار دارد، اما می‌توان آن را با \fB-o\fR بازنویسی کرد.
.RE 0

.RE 0

.P
\fB-k\fR
.RS 0
.RS 4
.P
تمام محیط را برای doveadm حفظ می‌کند، نه فقط تنظیم \fBimport_environment\fR را.
.RE 0

.RE 0

.P
\fB-v\fR
.RS 0
.RS 4
.P
پرگویی (verbosity)، از جمله شمارندهٔ پیشرفت را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-i\fR \fIinstance-name\fR
.RS 0
.RS 4
.P
در صورت استفاده از چندین نمونه (instance) از Dovecot، فایل پیکربندی را بر اساس این نام نمونه انتخاب می‌کند.
.P
برای اطلاعات بیشتر به تنظیم \fBinstance_name\fR مراجعه کنید.
.RE 0

.RE 0

.P
\fB-c\fR \fIconfig-file\fR
.RS 0
.RS 4
.P
پیکربندی را از \fIconfig-file\fR داده‌شده می‌خواند. به‌طور پیش‌فرض ابتدا سوکت پیکربندی را می‌خواند و در صورت در دسترس نبودن به \fI/etc/dovecot/dovecot.conf\fR بازمی‌گردد. همچنین می‌توانید این مقدار را به سوکت پیکربندی نمونه‌ای که نسخه‌ای سازگار را اجرا می‌کند هدایت کنید.
.RE 0

.RE 0

.P
\fB-o\fR \fIsetting\fR\fB=\fR\fIvalue\fR
.RS 0
.RS 4
.P
تنظیم پیکربندی \fIsetting\fR را از \fI/etc/dovecot/dovecot.conf\fR و از userdb با مقدار داده‌شدهٔ \fIvalue\fR بازنویسی می‌کند. جهت بازنویسی چندین تنظیم، می‌توان گزینهٔ \fB-o\fR را چندین بار مشخص کرد.
.RE 0

.RE 0

.P
\fB-f\fR \fIformatter\fR
.RS 0
.RS 4
.P
قالب‌بند (\fIformatter\fR) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندهای پشتیبانی‌شده عبارتند از:
.P
\fBflow\fR
.RS 4
.P
هر خط را با جفت‌های \fIkey\fR\fB=\fR\fIvalue\fR چاپ می‌کند.
.RE 0

.P
\fBjson\fR
.RS 4
.P
یک آرایهٔ JSON از اشیاء JSON را چاپ می‌کند.
.RE 0

.P
\fBpager\fR
.RS 4
.P
هر جفت \fIkey\fR: \fIvalue\fR را در خط اختصاصی خود چاپ کرده و رکوردها را با نویسهٔ فرم‌فید (\fB^L\fR) جدا می‌کند.
.RE 0

.P
\fBtab\fR
.RS 4
.P
یک سربرگ جدول و به‌دنبال آن خطوط مقادیر جداشده با تب (tab) را چاپ می‌کند.
.RE 0

.P
\fBtable\fR
.RS 4
.P
یک سربرگ جدول و به‌دنبال آن خطوط مقادیر تراز‌شده را چاپ می‌کند.
.RE 0

.RE 0

.RE 0

.SH "گزینه‌ها (OPTIONS)"
.P
\fB-A\fR
.RS 0
.RS 4
.P
اگر گزینهٔ \fB-A\fR مشخص شود، دستور (\fIcommand\fR) برای همه کاربران انجام خواهد شد. استفاده از این گزینه همراه با کاربران سیستمیِ \fBuserdb { driver = passwd }\fR توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم \fBfirst_valid_uid\fR نیز می‌شود.
.P
هنگامی که از ماژول SQL userdb استفاده می‌شود، اطمینان حاصل کنید که تنظیم \fBuserdb_sql_iterate_query\fR با ساختار پایگاه داده شما مطابقت دارد.
.P
هنگام استفاده از ماژول LDAP userdb، اطمینان حاصل کنید که تنظیمات \fBuserdb_fields\fR و \fBuserdb_ldap_iterate_fields\fR با طرحوارهٔ (schema) LDAP شما مطابقت دارند؛ در غیر این صورت doveadm(1) قادر به پیمایش روی تمام کاربران نخواهد بود.
.RE 0

.RE 0

.P
\fB-u\fR \fIuser/mask\fR
.RS 0
.RS 4
.P
دستور (\fIcommand\fR) را تنها برای \fIuser\fR داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عام (wildcards) '\fB*\fR' و '\fB?\fR' وجود دارد (مانند -u *@example.org).
.RE 0

.RE 0

.P
\fB-F\fR \fIfile\fR
.RS 0
.RS 4
.P
دستور (\fIcommand\fR) را برای تمام کاربران موجود در \fIfile\fR اجرا می‌کند. این مشابه گزینهٔ \fB-A\fR است، اما به‌جای دریافت فهرست کاربران از userdb، آن‌ها از \fIfile\fR داده‌شده خوانده می‌شوند. این \fIfile\fR در هر سطر شامل یک نام کاربری است.
.RE 0

.RE 0

.P
\fB-S\fR \fIsocket_path\fR
.RS 0
.RS 4
.P
آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی دامنه یونیکس (UNIX domain socket) است، یا یک نام میزبان و درگاه (\fIhostname\fR:\fIport\fR) برای اتصال به یک میزبان دوردست از طریق سوکت TCP.
.P
این به مدیر سیستم اجازه می‌دهد دستورات ایمیل doveadm(1) را از طریق سوکت داده‌شده اجرا کند.
.RE 0

.RE 0

.SH "دستورها (COMMANDS)"
.SS "copy"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fs copy \fIconfig-filter-name\fR \fIsource-path\fR \fIdest-path\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mail fs copy \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIconfig-filter-name\fR \fIsource-path\fR \fIdest-path\fR
.P
مسیر مبدأ را به مسیر مقصد کپی می‌کند.
.SS "delete"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fs delete \[lB]\fB-R\fR\[rB] \[lB]\fB-n\fR \fIcount\fR\[rB] \fIconfig-filter-name\fR \fIpath\fR \[lB]\fIpath\fR ...\[rB]
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mail fs delete \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-R\fR\[rB] \[lB]\fB-n\fR \fIcount\fR\[rB] \fIconfig-filter-name\fR \fIpath\fR \[lB]\fIpath\fR ...\[rB]
.P
تمام داده‌های مرتبط با مسیر ارائه‌شده را حذف می‌کند.
.P
\fB-R\fR
.RS 0
.RS 4
.P
فایل‌ها را به‌صورت بازگشتی حذف می‌کند.
.RE 0

.RE 0

.P
\fB-n\fR \fIcount\fR
.RS 0
.RS 4
.P
حداکثر تعداد عملیات‌های موازی برای اجرا.
.RE 0

.RE 0

.SS "get"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fs get \fIconfig-filter-name\fR \fIpath\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mail fs get \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIconfig-filter-name\fR \fIpath\fR
.P
داده‌های مرتبط با مسیر ارائه‌شده را بازیابی می‌کند.
.SS "iter"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fs iter \fIconfig-filter-name\fR \fIpath\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mail fs iter \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIconfig-filter-name\fR \fIpath\fR
.P
تمام فایل‌های داده را در مسیر ارائه‌شده پیمایش می‌کند.
.SS "iter-dirs"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fs iter-dirs \fIconfig-filter-name\fR \fIpath\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mail fs iter-dirs \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIconfig-filter-name\fR \fIpath\fR
.P
تمام دایرکتوری‌ها را در مسیر ارائه‌شده پیمایش می‌کند.
.SS "put"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fs put \[lB]\fB-h\fR \fIhash\fR\[rB] \[lB]\fB-m\fR \fIkey\fR=\fIvalue\fR\[rB] \fIconfig-filter-name\fR \fIinput_path\fR \fIpath\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mail fs put \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-h\fR \fIhash\fR\[rB] \[lB]\fB-m\fR \fIkey\fR=\fIvalue\fR\[rB] \fIconfig-filter-name\fR \fIpath\fR
.P
داده‌ها را در مسیر ارائه‌شده ذخیره می‌کند.
.P
\fB-h\fR \fIhash\fR
.RS 0
.RS 4
.P
هش ارائه‌شده را به عنوان هش محتوا ذخیره می‌کند. باید به صورت ارقام هگزادسیمال MD5 یا SHA256 باشد.
.RE 0

.RE 0

.P
\fB-m\fR \fIkey=value\fR
.RS 0
.RS 4
.P
مقداری را به یک فراداده (metadata) اختصاص می‌دهد. می‌توان هر تعداد بار که نیاز باشد از آن استفاده کرد. به درایور metawrap یا یک درایور FS با قابلیت پشتیبانی از فراداده نیاز دارد.
.RE 0

.RE 0

.SS "stat"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fs stat \fIconfig-filter-name\fR \fIpath\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mail fs stat \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIconfig-filter-name\fR \fIpath\fR
.P
وضعیت فایل‌ها را برای مسیر ارائه‌شده بازیابی می‌کند. در حال حاضر، تنها حجم کل مورد (بر حسب بایت) بازگردانده می‌شود.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.P
گزارش باگ‌ها، شامل خروجی \fIdoveconf -n\fR را به فهرست پستی Dovecot به نشانی \fI\(ladovecot@dovecot.org\(ra\fR ارسال کنید. اطلاعات درباره نحوه گزارش باگ‌ها در این نشانی در دسترس است: \fI\(lahttps://dovecot.org/bugreport.html\(ra\fR
.SH "مثال (EXAMPLE)"
.P
نحوهٔ استخراج یک فایل فشرده:
.P
.RS 2
.nf
doveadm -o fs=compress,posix -o fs/compress/fs_driver=compress -o fs/posix/fs_driver=posix -o fs_posix_prefix=/tmp/ fs get "" test.gz
.fi
.RE
.P
استفاده از یک فیلتر نام‌گذاری‌شده:
.P
.RS 2
.nf
doveadm mail fs -u testuser get obox path/to/file
.fi
.RE
.SH "همچنین ببینید (SEE ALSO)"
.P
doveadm(1)