.TH "DOVEADM-SEARCH" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
\fBdoveadm-search\fR \- نمایش فهرستی از GUIDهای صندوق‌های پستی و UIDهای پیام‌های منطبق با عبارت جستجوی داده‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های عمومی\fR\[rB] \[lB]\fB-f\fR \fIقالب‌بند\fR\[rB] \fBsearch\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-A\fR \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های عمومی\fR\[rB] \[lB]\fB-f\fR \fIقالب‌بند\fR\[rB] \fBsearch\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-F\fR \fIfile\fR \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های عمومی\fR\[rB] \[lB]\fB-f\fR \fIقالب‌بند\fR\[rB] \fBsearch\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB--no-userdb-lookup\fR \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های عمومی\fR\[rB] \[lB]\fB-f\fR \fIقالب‌بند\fR\[rB] \fBsearch\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-u\fR \fIuser\fR \fIsearch_query\fR
.SH "توضیحات (DESCRIPTION)"
.P
دستور
.B search
برای یافتن پیام‌های منطبق استفاده می‌شود.
.BR doveadm (1)
برای هر مورد منطبق، شناسه guid صندوق پستی و شناسه uid پیام را چاپ می‌کند.
.P
هنگامی که با گزینه‌های
.B \-A
یا
.B \-u
.I wildcard
استفاده شود،
.BR doveadm (1)
فیلدهای
.BR username ،
.B mailbox-guid
و
.B uid
را برای هر پیام منطبق چاپ خواهد کرد.
.P
در حالت اول،
.BR doveadm (1)
عملیات
.B search
را برای تمام کاربران اجرا خواهد کرد.
.P
در حالت دوم، دستور برای تمام کاربرانی که در
.I file
داده‌شده فهرست شده‌اند اجرا می‌شود.
.P
در حالت سوم، دستور برای کاربری که در متغیر محیطی
.I USER
مشخص شده اجرا می‌شود.
.P
در حالت آخر، جستجو تنها در میان نامه‌های منطبق با
.IR user (های)
داده‌شده انجام می‌شود.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.P
.I گزینه‌های
عمومی
: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
هیچ فایل پیکربندی را نمی‌خواند و تنها از مقادیر پیش‌فرض استفاده می‌کند. تنظیم
.B dovecot_storage_version
به‌طور پیش‌فرض به آخرین نسخه تنظیم می‌شود، اما با
.B \-o
می‌توان آن را بازنویسی کرد.
.RE 0

.RE 0

.P
\fB-k\fR
.RS 0
.RS 4
.P
کل متغیرهای محیطی را برای doveadm حفظ می‌کند، نه فقط تنظیم
.BR import_environment .
.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
برای اطلاعات بیشتر به تنظیم
.B instance_name
مراجعه کنید.
.RE 0

.RE 0

.P
\fB-c\fR \fIconfig-file\fR
.RS 0
.RS 4
.P
پیکربندی را از
.I config-file
داده‌شده می‌خواند. به‌طور پیش‌فرض ابتدا سوکت پیکربندی خوانده می‌شود و در صورت عدم موفقیت به
.I /etc/dovecot/dovecot.conf
رجوع می‌گردد. همچنین می‌توانید آن را به سوکت پیکربندی نمونه‌ای که نسخه سازگار را اجرا می‌کند ارجاع دهید.
.RE 0

.RE 0

.P
\fB-o\fR \fIsetting\fR\fB=\fR\fIvalue\fR
.RS 0
.RS 4
.P
تنظیم پیکربندی
.I setting
از
.I /etc/dovecot/dovecot.conf
و از userdb را با
.I value
داده‌شده بازنویسی می‌کند. به منظور بازنویسی چند تنظیم، گزینه
.B \-o
می‌تواند چندین بار مشخص شود.
.RE 0

.RE 0

.P
\fB-f\fR \fIformatter\fR
.RS 0
.RS 4
.P
قالب‌بند خروجی (\fIformatter\fR) را مشخص می‌کند. قالب‌بندهای پشتیبانی‌شده عبارتند از:
.P
\fBflow\fR
.RS 4
.P
هر خط را به‌صورت جفت‌های
.IR key \fB=\fR value
چاپ می‌کند.
.RE 0

.P
\fBjson\fR
.RS 4
.P
آرایه‌ای از اشیاء JSON را چاپ می‌کند.
.RE 0

.P
\fBpager\fR
.RS 4
.P
هر جفت
.IR key :\  value
را در خط اختصاصی خود چاپ کرده و رکوردها را با کاراکتر Form Feed (\fB^L\fR) از هم جدا می‌کند.
.RE 0

.P
\fBtab\fR
.RS 4
.P
هدر جدول را چاپ کرده و خطوط مقادیر را با نویسه Tab از یکدیگر جدا می‌کند.
.RE 0

.P
\fBtable\fR
.RS 4
.P
هدر جدول را چاپ کرده و خطوط مقادیر را به‌صورت تراز شده نمایش می‌دهد.
.RE 0

.RE 0

.RE 0

.P
این دستور به‌طور پیش‌فرض از قالب‌بند خروجی
.B flow
(بدون پیشوند
\fIkey\fR=)
استفاده می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.P
\fB-A\fR
.RS 0
.RS 4
.P
در صورت وجود گزینه
.BR \-A ،
.I دستور
برای تمام کاربران انجام خواهد شد. استفاده از این گزینه در ترکیب با کاربران سیستمی از
.B userdb { driver = passwd }
توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم
.B first_valid_uid
نیز می‌شود.
.P
هنگام استفاده از ماژول userdb مبتنی بر SQL، اطمینان حاصل کنید که تنظیم
.B userdb_sql_iterate_query
با ساختار پایگاه داده شما مطابقت داشته باشد.
.P
هنگام استفاده از ماژول userdb مبتنی بر LDAP، اطمینان حاصل کنید که تنظیمات
.B userdb_fields
و
.B userdb_ldap_iterate_fields
با اسکیمای LDAP شما مطابقت داشته باشند. در غیر این صورت
.BR doveadm (1)
قادر به پیمایش روی تمام کاربران نخواهد بود.
.RE 0

.RE 0

.P
\fB-F\fR \fIfile\fR
.RS 0
.RS 4
.P
.I دستور
را برای تمام کاربران موجود در
.I file
اجرا می‌کند. این گزینه مشابه گزینه
.B \-A
است، اما به‌جای دریافت فهرست کاربران از userdb، آن‌ها از
.I file
داده‌شده خوانده می‌شوند. این
.I file
باید در هر خط شامل یک نام کاربری باشد.
.RE 0

.RE 0

.P
\fB--no-userdb-lookup\fR
.RS 0
.RS 4
.P
جستجو در userdb را انجام ندهد. از متغیر محیطی
.B USER
برای تعیین نام کاربری استفاده کند.
.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
این گزینه به مدیر سیستم اجازه می‌دهد تا دستورهای پستی
.BR doveadm (1)
را از طریق سوکت داده‌شده اجرا کند.
.RE 0

.RE 0

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

.RE 0

.SH "آرگومان‌ها (ARGUMENTS)"
.P
\fIsearch_query\fR
.RS 0
.RS 4
.P
پیام‌های منطبق با این عبارت جستجو را نمایش می‌دهد. برای جزئیات به
.BR doveadm-search-query (7)
مراجعه کنید.
.RE 0

.RE 0

.SH "مثال‌ها (EXAMPLES)"
.P
جستجوی تمام پیام‌هایی که در هدر Subject: آن‌ها کلمه "todo" وجود دارد در صندوق‌های پستی dovecot کاربر bob:
.P
.RS 2
.nf
doveadm search -u bob mailbox dovecot\[rs]* subject todo
.fi
.RE
.P
.RS 2
.nf
3a94c928d66ebe4bda04000015811c6a	8
3a94c928d66ebe4bda04000015811c6a	25
3a94c928d66ebe4bda04000015811c6a	45
.fi
.RE
.P
دستور search عمدتاً زمانی مفید است که همراه با دستور
.BR doveadm-fetch (1)
استفاده شود.
.P
به‌عنوان مثال، برای ذخیره بدنه تمام پیام‌های موجود در INBOX که در موضوع آن‌ها کلمه "todo" وجود دارد، از دستور زیر استفاده کنید:
.P
.RS 2
.nf
doveadm search -u bob mailbox INBOX subject todo
while read guid uid; do
  doveadm fetch -u bob body mailbox-guid $guid uid $uid > msg.$uid
done
.fi
.RE
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.P
گزارش باگ‌ها، از جمله خروجی
.IR "doveconf -n" ،
را به فهرست پستی Dovecot به نشانی
\fI\(ladovecot@dovecot.org\(ra\fR
ارسال کنید. اطلاعات مربوط به گزارش باگ‌ها در نشانی زیر در دسترس است:
\fI\(lahttps://dovecot.org/bugreport.html\(ra\fR
.SH "همچنین ببینید (SEE ALSO)"
.P
.BR doveadm (1),
.BR doveadm-search-query (7)