.TH "DOVEADM-FS" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
\fBdoveadm-fs\fR \- تعامل با فایل‌سیستم انتزاعی ذخیره‌سازی ایمیل
.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
\fIگزینه‌های\fR عمومی doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
حالت پرگویی (\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
پرگویی را فعال می‌کند، از جمله نمایش شمارنده پیشرفت.
.RE 0

.RE 0

.P
\fB-i\fR \fIinstance-name\fR
.RS 0
.RS 4
.P
در صورت استفاده از چند نمونه‌ی 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-separated) به دنبال آن می‌آیند.
.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
هنگام استفاده از ماژول userdb مبتنی بر SQL، اطمینان حاصل کنید که تنظیم \fBuserdb_sql_iterate_query\fR با ساختار پایگاه داده شما مطابقت داشته باشد.
.P
هنگام استفاده از ماژول userdb مبتنی بر LDAP، اطمینان حاصل کنید که تنظیمات \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) داده‌شده. همچنین امکان استفاده از نویسه‌های عمومی '\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
اختصاص دادن یک مقدار به یک متادیتا. می‌تواند به هر تعداد بار که نیاز است مشخص شود. نیازمند درایور 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 "مثال‌ها (EXAMPLES)"
.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)