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

نام (NAME)
       doveadm-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

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



       -O

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



       -k

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



       -v

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



       -i instance-name

           در صورت استفاده از چند نمونه‌ی 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-separated)
           به دنبال آن می‌آیند.


       table

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




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

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

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

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



       -u user/mask

           اجرای دستور (command) تنها برای کاربر (user) داده‌شده. همچنین امکان
           استفاده از نویسه‌های عمومی '*' و '?' وجود دارد (مثلاً ‎-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

           اختصاص دادن یک مقدار به یک متادیتا. می‌تواند به هر تعداد بار که نیاز
           است مشخص شود. نیازمند درایور 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⟩

مثال‌ها (EXAMPLES)
       نحوه خارج کردن یک فایل از حالت فشرده.

         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-FS(1)