.TH "DOVEADM-DEDUPLICATE" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
\fBdoveadm-deduplicate\fR \- پاک‌سازی پیام‌های تکراری
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBdeduplicate\fR \[lB]\fB-u\fR \fIuser\fR | \fB-A\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-m\fR\[rB] \fIsearch_query\fR
.SH "توضیحات (DESCRIPTION)"
.P
این دستور برای پاک‌سازی و حذف پیام‌های تکراری در صندوق‌های پستی استفاده می‌شود. \fBdoveadm deduplicate\fR عمدتاً برای بازگرداندن تغییرات ناشی از ایجاد تصادفی پیام‌های تکراری، مانند پس از اجرای \fBdoveadm copy\fR یا \fBdoveadm import\fR، کاربرد دارد. دستور doveadm(1) جدیدترین پیام‌های تکراری را از صندوق پستی حذف کرده و قدیمی‌ترین آن‌ها را نگه می‌دارد.
.P
حذف موارد تکراری در میان چند صندوق پستی به‌صورت هم‌زمان پشتیبانی نمی‌شود.
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.P
گزینه‌های سراسری doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
حالت پرگویی (\fIverbosity\fR) و نمایش پیام‌های اشکال‌زدایی (debug) را فعال می‌کند.
.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 با طرحوارهٔ (schema) LDAP شما مطابقت دارند. در غیر این صورت، doveadm(1) قادر به پیمایش روی همهٔ کاربران نخواهد بود.
.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-m\fR
.RS 0
.RS 4
.P
اگر گزینهٔ \fB-m\fR مشخص شود، doveadm(1) حذف موارد تکراری را بر اساس سرآیند Message-Id انجام خواهد داد. به‌طور پیش‌فرض، حذف پیام‌های تکراری بر اساس شناسهٔ یکتای پیام‌ها (GUID) انجام می‌شود.
.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
این به مدیر سیستم اجازه می‌دهد تا دستورهای پستی doveadm(1) را از طریق سوکت داده‌شده اجرا کند.
.RE 0

.RE 0

.P
\fB-u\fR \fIuser/mask\fR
.RS 0
.RS 4
.P
دستور (\fIcommand\fR) را فقط برای \fIuser\fR داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عام (wildcards) «\fB*\fR» و «\fB?\fR» نیز وجود دارد (مانند ‎-u *@example.org).
.RE 0

.RE 0

.SH "آرگومان‌ها (ARGUMENTS)"
.P
\fIsearch_query\fR
.RS 0
.RS 4
.P
پیام‌های تکراری یافت‌شده از میان پیام‌های منطبق با عبارت جستجوی داده‌شده را پاک‌سازی می‌کند. معمولاً یک عبارت جستجو مانند '\fBmailbox\fR \fImailbox_name\fR \fBOR mailbox\fR \fIother_box\fR' کافی خواهد بود. برای جزئیات بیشتر doveadm-search-query(7) را ببینید.
.RE 0

.RE 0

.SH "مثال‌ها (EXAMPLES)"
.P
این مثال نحوه فهرست کردن و پاک‌سازی پیام‌های تکراری را از یک صندوق پستی نشان می‌دهد.
.P
.RS 2
.nf
doveadm -f table fetch -u jane 'guid uid' mailbox a_Box | sort
.fi
.RE
.P
.RS 2
.nf
guid                             uid
8aad0f0a30169f4bea620000ca356bad 18751
8aad0f0a30169f4bea620000ca356bad 18756
923e301ab9219b4b4f440000ca356bad 18748
923e301ab9219b4b4f440000ca356bad 18753
...
.fi
.RE
.P
.RS 2
.nf
doveadm deduplicate -u jane mailbox a_Box
doveadm -f table fetch -u jane 'guid uid' mailbox a_Box | sort
.fi
.RE
.P
.RS 2
.nf
guid                             uid
8aad0f0a30169f4bea620000ca356bad 18751
923e301ab9219b4b4f440000ca356bad 18748
a7999e1530739c4bd26d0000ca356bad 18749
...
.fi
.RE
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش باگ‌ها، شامل خروجی \fIdoveconf -n\fR را به فهرست پستی Dovecot به نشانی \fI\(ladovecot@dovecot.org\(ra\fR ارسال کنید. اطلاعات درباره نحوه گزارش باگ‌ها در این نشانی در دسترس است: \fI\(lahttps://dovecot.org/bugreport.html\(ra\fR
.SH "همچنین ببینید (SEE ALSO)"
.P
doveadm(1), doveadm-import(1)