DOVEADM-MAIL-FS(1)                  Dovecot                 DOVEADM-MAIL-FS(1)

نام (NAME)
       doveadm-mail-fs - تعامل با سامانهٔ فایل انتزاعی ذخیره‌سازی ایمیل در بافت
       کاربر

خلاصه دستور (SYNOPSIS)
       doveadm [GLOBAL OPTIONS] fs command config-filter-name [ARGUMENTS]

       doveadm [GLOBAL OPTIONS] mail fs command [OPTIONS] config-filter-name
       [ARGUMENTS]

توضیحات (DESCRIPTION)
       دستورات doveadm fs برای تعامل انتزاعی با درایور ذخیره‌سازیِ تعریف‌شده در
       پیکربندی Dovecot استفاده می‌شوند. این دستورات امکان دسترسی به ساختار
       صندوق پستی را بدون نیاز به دانستن جزئیات نحوهٔ طراحی درایور ذخیره‌سازی
       فراهم می‌سازند.

       config-filter-name

           نام فیلتری که هنگام جستجوی تنظیمات fs استفاده می‌شود؛ برای نمونه
           mail_attachments، obox، metacache، fts/dovecot. همچنین می‌توان از یک
           نام فیلتر خالی استفاده کرد و تنظیمات fs را با استفاده از پارامتر -o
           مشخص نمود.



گزینه‌های عمومی (GLOBAL OPTIONS)
       گزینه‌های عمومی doveadm(1):

       -D

           پیام‌های اشکال‌زدایی (debug) و پرگویی (verbosity) را فعال می‌کند.



       -O

           هیچ فایل پیکربندی‌ای را نمی‌خواند و صرفاً از مقادیر پیش‌فرض استفاده
           می‌کند. تنظیم dovecot_storage_version به‌طور پیش‌فرض روی جدیدترین نسخه
           قرار دارد، اما می‌توان آن را با -o بازنویسی کرد.



       -k

           تمام محیط را برای doveadm حفظ می‌کند، نه فقط تنظیم
           import_environment را.



       -v

           پرگویی (verbosity)، از جمله شمارندهٔ پیشرفت را فعال می‌کند.



       -i instance-name

           در صورت استفاده از چندین نمونه (instance) از Dovecot، فایل پیکربندی
           را بر اساس این نام نمونه انتخاب می‌کند.

           برای اطلاعات بیشتر به تنظیم instance_name مراجعه کنید.



       -c config-file

           پیکربندی را از config-file داده‌شده می‌خواند. به‌طور پیش‌فرض ابتدا سوکت
           پیکربندی را می‌خواند و در صورت در دسترس نبودن به
           /etc/dovecot/dovecot.conf بازمی‌گردد. همچنین می‌توانید این مقدار را
           به سوکت پیکربندی نمونه‌ای که نسخه‌ای سازگار را اجرا می‌کند هدایت کنید.



       -o setting=value

           تنظیم پیکربندی setting را از /etc/dovecot/dovecot.conf و از userdb
           با مقدار داده‌شدهٔ value بازنویسی می‌کند. جهت بازنویسی چندین تنظیم،
           می‌توان گزینهٔ -o را چندین بار مشخص کرد.



       -f formatter

           قالب‌بند (formatter) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندهای
           پشتیبانی‌شده عبارتند از:

           flow

               هر خط را با جفت‌های key=value چاپ می‌کند.


       json

           یک آرایهٔ JSON از اشیاء JSON را چاپ می‌کند.


       pager

           هر جفت key: value را در خط اختصاصی خود چاپ کرده و رکوردها را با
           نویسهٔ فرم‌فید (^L) جدا می‌کند.


       tab

           یک سربرگ جدول و به‌دنبال آن خطوط مقادیر جداشده با تب (tab) را چاپ
           می‌کند.


       table

           یک سربرگ جدول و به‌دنبال آن خطوط مقادیر تراز‌شده را چاپ می‌کند.




گزینه‌ها (OPTIONS)
       -A

           اگر گزینهٔ -A مشخص شود، دستور (command) برای همه کاربران انجام خواهد
           شد. استفاده از این گزینه همراه با کاربران سیستمیِ userdb { driver =
           passwd } توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار
           پیکربندی‌شده در تنظیم first_valid_uid نیز می‌شود.

           هنگامی که از ماژول SQL userdb استفاده می‌شود، اطمینان حاصل کنید که
           تنظیم userdb_sql_iterate_query با ساختار پایگاه داده شما مطابقت
           دارد.

           هنگام استفاده از ماژول LDAP userdb، اطمینان حاصل کنید که تنظیمات
           userdb_fields و userdb_ldap_iterate_fields با طرحوارهٔ (schema) LDAP
           شما مطابقت دارند؛ در غیر این صورت doveadm(1) قادر به پیمایش روی
           تمام کاربران نخواهد بود.



       -u user/mask

           دستور (command) را تنها برای user داده‌شده اجرا می‌کند. همچنین امکان
           استفاده از نویسه‌های عام (wildcards) '*' و '?' وجود دارد (مانند -u
           *@example.org).



       -F file

           دستور (command) را برای تمام کاربران موجود در file اجرا می‌کند. این
           مشابه گزینهٔ -A است، اما به‌جای دریافت فهرست کاربران از userdb، آن‌ها
           از file داده‌شده خوانده می‌شوند. این file در هر سطر شامل یک نام
           کاربری است.



       -S socket_path

           آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی دامنه یونیکس
           (UNIX domain socket) است، یا یک نام میزبان و درگاه (hostname:port)
           برای اتصال به یک میزبان دوردست از طریق سوکت TCP.

           این به مدیر سیستم اجازه می‌دهد دستورات ایمیل doveadm(1) را از طریق
           سوکت داده‌شده اجرا کند.



دستورها (COMMANDS)
   copy
       doveadm [GLOBAL OPTIONS] fs copy config-filter-name source-path dest-
       path

       doveadm [GLOBAL OPTIONS] mail fs copy [-A | -u user | -F file] [-S
       socket_path] config-filter-name source-path dest-path

       مسیر مبدأ را به مسیر مقصد کپی می‌کند.

   delete
       doveadm [GLOBAL OPTIONS] fs delete [-R] [-n count] config-filter-name
       path [path ...]

       doveadm [GLOBAL OPTIONS] mail fs delete [-A | -u user | -F file] [-S
       socket_path] [-R] [-n count] config-filter-name path [path ...]

       تمام داده‌های مرتبط با مسیر ارائه‌شده را حذف می‌کند.

       -R

           فایل‌ها را به‌صورت بازگشتی حذف می‌کند.



       -n count

           حداکثر تعداد عملیات‌های موازی برای اجرا.



   get
       doveadm [GLOBAL OPTIONS] fs get config-filter-name path

       doveadm [GLOBAL OPTIONS] mail fs get [-A | -u user | -F file] [-S
       socket_path] config-filter-name path

       داده‌های مرتبط با مسیر ارائه‌شده را بازیابی می‌کند.

   iter
       doveadm [GLOBAL OPTIONS] fs iter config-filter-name path

       doveadm [GLOBAL OPTIONS] mail fs iter [-A | -u user | -F file] [-S
       socket_path] config-filter-name path

       تمام فایل‌های داده را در مسیر ارائه‌شده پیمایش می‌کند.

   iter-dirs
       doveadm [GLOBAL OPTIONS] fs iter-dirs config-filter-name path

       doveadm [GLOBAL OPTIONS] mail fs iter-dirs [-A | -u user | -F file] [-S
       socket_path] config-filter-name path

       تمام دایرکتوری‌ها را در مسیر ارائه‌شده پیمایش می‌کند.

   put
       doveadm [GLOBAL OPTIONS] fs put [-h hash] [-m key=value] config-filter-
       name input_path path

       doveadm [GLOBAL OPTIONS] mail fs put [-A | -u user | -F file] [-S
       socket_path] [-h hash] [-m key=value] config-filter-name path

       داده‌ها را در مسیر ارائه‌شده ذخیره می‌کند.

       -h hash

           هش ارائه‌شده را به عنوان هش محتوا ذخیره می‌کند. باید به صورت ارقام
           هگزادسیمال MD5 یا SHA256 باشد.



       -m key=value

           مقداری را به یک فراداده (metadata) اختصاص می‌دهد. می‌توان هر تعداد
           بار که نیاز باشد از آن استفاده کرد. به درایور metawrap یا یک درایور
           FS با قابلیت پشتیبانی از فراداده نیاز دارد.



   stat
       doveadm [GLOBAL OPTIONS] fs stat config-filter-name path

       doveadm [GLOBAL OPTIONS] mail fs stat [-A | -u user | -F file] [-S
       socket_path] config-filter-name path

       وضعیت فایل‌ها را برای مسیر ارائه‌شده بازیابی می‌کند. در حال حاضر، تنها حجم
       کل مورد (بر حسب بایت) بازگردانده می‌شود.

گزارش باگ‌ها (REPORTING BUGS)
       گزارش باگ‌ها، شامل خروجی doveconf -n را به فهرست پستی Dovecot به نشانی
       ⟨dovecot@dovecot.org⟩ ارسال کنید. اطلاعات درباره نحوه گزارش باگ‌ها در
       این نشانی در دسترس است: ⟨https://dovecot.org/bugreport.html⟩

مثال (EXAMPLE)
       نحوهٔ استخراج یک فایل فشرده:

         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

       استفاده از یک فیلتر نام‌گذاری‌شده:

         doveadm mail fs -u testuser get obox path/to/file

همچنین ببینید (SEE ALSO)
       doveadm(1)

e5ac02a                            May 2026                 DOVEADM-MAIL-FS(1)