DOVEADM-EXPUNGE(1)                  Dovecot                 DOVEADM-EXPUNGE(1)

نام (NAME)
       doveadm-expunge - حذف دائم پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده

خلاصه دستور (SYNOPSIS)
       doveadm [گزینه‌های سراسری] expunge [-S socket_path] [-d] -A search_query

       doveadm [گزینه‌های سراسری] expunge [-S socket_path] [-d] -F file
       search_query

       doveadm [گزینه‌های سراسری] expunge [-S socket_path] [-d]
       --no-userdb-lookup search_query

       doveadm [گزینه‌های سراسری] expunge [-S socket_path] [-d] -u user
       search_query

توضیحات (DESCRIPTION)
       از این دستور می‌توان برای حذف دائم (expunge) پیام‌های منطبق با پرس‌وجوی
       جستجوی داده‌شده استفاده کرد. این دستور معمولاً برای حذف پیام‌های قدیمی از
       صندوق‌های پستی سطل زباله (Trash) و/یا هرزنامه (Spam) کاربران به کار
       می‌رود. برای آزمایش این‌که چه پیام‌هایی با یک پرس‌وجوی جستجوی مشخص مطابقت
       دارند، می‌توانید از دستورات doveadm fetch یا doveadm search استفاده
       کنید.

       در حالت اول، دستور برای همهٔ کاربران اجرا خواهد شد.

       در حالت دوم، doveadm(1) پیام‌های کاربرانی را که در file داده‌شده فهرست
       شده‌اند، حذف خواهد کرد.

       در حالت سوم، دستور برای کاربری که نام او در متغیر محیطی USER قرار دارد،
       اجرا خواهد شد.

       در حالت آخر، تنها پیام‌های منطبق مربوط به user (کاربر یا کاربران)
       داده‌شده حذف خواهند شد.

گزینه‌های سراسری (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 می‌تواند چندین بار مشخص شود.



گزینه‌ها (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 با طرحوارهٔ
           (اسکیما) LDAP شما مطابقت دارند. در غیر این صورت doveadm(1) قادر به
           پیمایش روی تمام کاربران نخواهد بود.



       -d

           اگر صندوق پستی پس از حذف دائم پیام‌ها خالی شود، آن را حذف می‌کند.



       -F file

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



       --no-userdb-lookup

           جستجو در userdb را انجام نمی‌دهد. از متغیر محیطی USER برای مشخص کردن
           نام کاربری استفاده می‌کند.



       -S socket_path

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

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



       -u user/mask

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



آرگومان‌ها (ARGUMENTS)
       search_query

           پیام‌های منطبق با این پرس‌وجوی جستجو را حذف دائم می‌کند. برای جزئیات
           به doveadm-search-query(7) مراجعه کنید.

           پارامتر mailbox الزامی است.

           محدودکنندهٔ بازهٔ پیام الزامی است. به عبارت دیگر، شما باید حداقل یک
           پارامتر پرس‌وجو داشته باشید که بازهٔ پیام را محدود کند. اگر همهٔ
           پیام‌ها مد نظر باشند، می‌توان از پارامتر پرس‌وجوی "all" استفاده کرد.



مثال (EXAMPLE)
       این مثال پیام‌هایی از صندوق پستی Spam را که بیش از دو هفته پیش در آنجا
       ذخیره یا کپی شده‌اند، به طور دائم حذف می‌کند:

         doveadm expunge -u jane.doe@example.org mailbox Spam savedbefore 2w

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

همچنین ببینید (SEE ALSO)
       doveadm(1), doveadm-search(1), doveadm-search-query(7)

e5ac02a                            May 2026                 DOVEADM-EXPUNGE(1)