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

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

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

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

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

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

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

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

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

-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).

search_query

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

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

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

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

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

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

doveadm(1), doveadm-search(1), doveadm-search-query(7)

May 2026 e5ac02a