.TH "DOVEADM-EXPUNGE" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
doveadm\-expunge \- حذف دائم پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های سراسری\fR\[rB] \fBexpunge\fR \[lB]\fB\-S\fR \fIsocket_path\fR\[rB] \[lB]\fB\-d\fR\[rB] \fB\-A\fR \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های سراسری\fR\[rB] \fBexpunge\fR \[lB]\fB\-S\fR \fIsocket_path\fR\[rB] \[lB]\fB\-d\fR\[rB] \fB\-F\fR \fIfile\fR \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های سراسری\fR\[rB] \fBexpunge\fR \[lB]\fB\-S\fR \fIsocket_path\fR\[rB] \[lB]\fB\-d\fR\[rB] \fB\-\-no\-userdb\-lookup\fR \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های سراسری\fR\[rB] \fBexpunge\fR \[lB]\fB\-S\fR \fIsocket_path\fR\[rB] \[lB]\fB\-d\fR\[rB] \fB\-u\fR \fIuser\fR \fIsearch_query\fR
.SH "توضیحات (DESCRIPTION)"
.P
از این دستور می‌توان برای حذف دائم (expunge) پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده استفاده کرد. این دستور معمولاً برای حذف پیام‌های قدیمی از صندوق‌های پستی سطل زباله (Trash) و/یا هرزنامه (Spam) کاربران به کار می‌رود. برای آزمایش این‌که چه پیام‌هایی با یک پرس‌وجوی جستجوی مشخص مطابقت دارند، می‌توانید از دستورات \fIdoveadm fetch\fR یا \fIdoveadm search\fR استفاده کنید.
.P
در حالت اول، دستور برای همهٔ کاربران اجرا خواهد شد.
.P
در حالت دوم، \fBdoveadm\fR(1) پیام‌های کاربرانی را که در \fIfile\fR داده‌شده فهرست شده‌اند، حذف خواهد کرد.
.P
در حالت سوم، دستور برای کاربری که نام او در متغیر محیطی \fIUSER\fR قرار دارد، اجرا خواهد شد.
.P
در حالت آخر، تنها پیام‌های منطبق مربوط به \fIuser\fR (کاربر یا کاربران) داده‌شده حذف خواهند شد.
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.P
گزینه‌های سراسری \fBdoveadm\fR(1):
.P
\fB\-D\fR
.RS 0
.RS 4
.P
پیام‌های پرگویی (verbosity) و اشکال‌زدایی را فعال می‌کند.
.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

.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
هنگام استفاده از ماژول SQL userdb، مطمئن شوید که تنظیم \fBuserdb_sql_iterate_query\fR با ساختار پایگاه‌داده شما مطابقت داشته باشد.
.P
هنگام استفاده از ماژول LDAP userdb، مطمئن شوید که تنظیم \fBuserdb_fields\fR و تنظیم \fBuserdb_ldap_iterate_fields\fR با طرحوارهٔ (اسکیما) LDAP شما مطابقت دارند. در غیر این صورت \fBdoveadm\fR(1) قادر به پیمایش روی تمام کاربران نخواهد بود.
.RE 0

.RE 0

.P
\fB\-d\fR
.RS 0
.RS 4
.P
اگر صندوق پستی پس از حذف دائم پیام‌ها خالی شود، آن را حذف می‌کند.
.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\-\-no\-userdb\-lookup\fR
.RS 0
.RS 4
.P
جستجو در userdb را انجام نمی‌دهد. از متغیر محیطی \fBUSER\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
این گزینه به مدیر سیستم اجازه می‌دهد دستورات ایمیل \fBdoveadm\fR(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' وجود دارد (مثلاً \fB\-u\fR *@example.org).
.RE 0

.RE 0

.SH "آرگومان‌ها (ARGUMENTS)"
.P
\fIsearch_query\fR
.RS 0
.RS 4
.P
پیام‌های منطبق با این پرس‌وجوی جستجو را حذف دائم می‌کند. برای جزئیات به \fBdoveadm\-search\-query\fR(7) مراجعه کنید.
.P
پارامتر mailbox الزامی است.
.P
محدودکنندهٔ بازهٔ پیام الزامی است. به عبارت دیگر، شما باید حداقل یک پارامتر پرس‌وجو داشته باشید که بازهٔ پیام را محدود کند. اگر همهٔ پیام‌ها مد نظر باشند، می‌توان از پارامتر پرس‌وجوی "all" استفاده کرد.
.RE 0

.RE 0

.SH "مثال (EXAMPLE)"
.P
این مثال پیام‌هایی از صندوق پستی Spam را که بیش از دو هفته پیش در آنجا ذخیره یا کپی شده‌اند، به طور دائم حذف می‌کند:
.P
.RS 2
.nf
doveadm expunge -u jane.doe@example.org mailbox Spam savedbefore 2w
.fi
.RE
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.P
گزارش باگ‌ها، شامل خروجی \fIdoveconf \-n\fR را به فهرست پستی Dovecot به آدرس \fI\(ladovecot@dovecot.org\(ra\fR ارسال کنید. اطلاعات مربوط به گزارش باگ‌ها در آدرس زیر در دسترس است: \fI\(lahttps://dovecot.org/bugreport.html\(ra\fR
.SH "همچنین ببینید (SEE ALSO)"
.P
\fBdoveadm\fR(1), \fBdoveadm\-search\fR(1), \fBdoveadm\-search\-query\fR(7)