| DOVEADM-SEARCH(1) | Dovecot | DOVEADM-SEARCH(1) |
نام (NAME)
doveadm-search - نمایش فهرستی از GUIDهای صندوق‌های پستی و UIDهای پیام‌های منطبق با عبارت جستجوی داده‌شده
خلاصه دستور (SYNOPSIS)
doveadm [گزینه‌های عمومی] [-f قالب‌بند] search [-S socket_path] -A search_query
doveadm [گزینه‌های عمومی] [-f قالب‌بند] search [-S socket_path] -F file search_query
doveadm [گزینه‌های عمومی] [-f قالب‌بند] search [-S socket_path] --no-userdb-lookup search_query
doveadm [گزینه‌های عمومی] [-f قالب‌بند] search [-S socket_path] -u user search_query
توضیحات (DESCRIPTION)
دستور search برای یافتن پیام‌های منطبق استفاده می‌شود. doveadm(1) برای هر مورد منطبق، شناسه guid صندوق پستی و شناسه uid پیام را چاپ می‌کند.
هنگامی که با گزینه‌های -A یا -u wildcard استفاده شود، doveadm(1) فیلدهای username، mailbox-guid و uid را برای هر پیام منطبق چاپ خواهد کرد.
در حالت اول، doveadm(1) عملیات search را برای تمام کاربران اجرا خواهد کرد.
در حالت دوم، دستور برای تمام کاربرانی که در file داده‌شده فهرست شده‌اند اجرا می‌شود.
در حالت سوم، دستور برای کاربری که در متغیر محیطی USER مشخص شده اجرا می‌شود.
در حالت آخر، جستجو تنها در میان نامه‌های منطبق با user(های) داده‌شده انجام می‌شود.
گزینه‌های عمومی (GLOBAL OPTIONS)
گزینه‌های عمومی :doveadm(1)
-D
پیام‌های با جزئیات بیشتر (verbosity) و اشکال‌زدایی (debug) را فعال می‌کند.
-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 می‌تواند چندین بار مشخص شود.
-f formatter
قالب‌بند خروجی (formatter) را مشخص می‌کند. قالب‌بندهای پشتیبانی‌شده عبارتند از:
flow
هر خط را به‌صورت جفت‌های key=value چاپ می‌کند.
json
آرایه‌ای از اشیاء JSON را چاپ می‌کند.
pager
هر جفت key: value را در خط اختصاصی خود چاپ کرده و رکوردها را با کاراکتر Form Feed (^L) از هم جدا می‌کند.
tab
هدر جدول را چاپ کرده و خطوط مقادیر را با نویسه Tab از یکدیگر جدا می‌کند.
table
هدر جدول را چاپ کرده و خطوط مقادیر را به‌صورت تراز شده نمایش می‌دهد.
این دستور به‌طور پیش‌فرض از قالب‌بند خروجی flow (بدون پیشوند key=) استفاده می‌کند.
گزینه‌ها (OPTIONS)
-A
در صورت وجود گزینه -A، دستور برای تمام کاربران انجام خواهد شد. استفاده از این گزینه در ترکیب با کاربران سیستمی از userdb { driver = passwd } توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم first_valid_uid نیز می‌شود.
هنگام استفاده از ماژول userdb مبتنی بر SQL، اطمینان حاصل کنید که تنظیم userdb_sql_iterate_query با ساختار پایگاه داده شما مطابقت داشته باشد.
هنگام استفاده از ماژول userdb مبتنی بر LDAP، اطمینان حاصل کنید که تنظیمات userdb_fields و userdb_ldap_iterate_fields با اسکیمای LDAP شما مطابقت داشته باشند. در غیر این صورت doveadm(1) قادر به پیمایش روی تمام کاربران نخواهد بود.
-F file
دستور را برای تمام کاربران موجود در file اجرا می‌کند. این گزینه مشابه گزینه -A است، اما به‌جای دریافت فهرست کاربران از userdb، آن‌ها از file داده‌شده خوانده می‌شوند. این file باید در هر خط شامل یک نام کاربری باشد.
--no-userdb-lookup
جستجو در userdb را انجام ندهد. از متغیر محیطی USER برای تعیین نام کاربری استفاده کند.
-S socket_path
آرگومان این گزینه یا یک مسیر مطلق به یک سوکت دامنه یونیکس (UNIX domain socket) محلی است، یا یک نام میزبان و درگاه (hostname:port) به منظور اتصال به یک میزبان راه دور از طریق سوکت TCP.
این گزینه به مدیر سیستم اجازه می‌دهد تا دستورهای پستی doveadm(1) را از طریق سوکت داده‌شده اجرا کند.
-u user/mask
دستور را فقط برای user داده‌شده اجرا می‌کند. همچنین می‌توان از نویسه‌های عمومی (wildcards) '*' و '?' استفاده کرد (مانند -u *@example.org).
آرگومان‌ها (ARGUMENTS)
search_query
پیام‌های منطبق با این عبارت جستجو را نمایش می‌دهد. برای جزئیات به doveadm-search-query(7) مراجعه کنید.
مثال‌ها (EXAMPLES)
جستجوی تمام پیام‌هایی که در هدر Subject: آن‌ها کلمه "todo" وجود دارد در صندوق‌های پستی dovecot کاربر bob:
doveadm search -u bob mailbox dovecot\* subject todo
3a94c928d66ebe4bda04000015811c6a 8 3a94c928d66ebe4bda04000015811c6a 25 3a94c928d66ebe4bda04000015811c6a 45
دستور search عمدتاً زمانی مفید است که همراه با دستور doveadm-fetch(1) استفاده شود.
به‌عنوان مثال، برای ذخیره بدنه تمام پیام‌های موجود در INBOX که در موضوع آن‌ها کلمه "todo" وجود دارد، از دستور زیر استفاده کنید:
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
گزارش باگ‌ها (REPORTING BUGS)
گزارش باگ‌ها، از جمله خروجی doveconf -n، را به فهرست پستی Dovecot به نشانی ⟨dovecot@dovecot.org⟩ ارسال کنید. اطلاعات مربوط به گزارش باگ‌ها در نشانی زیر در دسترس است: ⟨https://dovecot.org/bugreport.html⟩
همچنین ببینید (SEE ALSO)
| May 2026 | e5ac02a |