DOVEADM-FETCH(1) Dovecot DOVEADM-FETCH(1)

doveadm-fetch - واکشی بخشی یا تمام پیام‌ها یا اطلاعات پیام

doveadm [GLOBAL OPTIONS] [-f formatter] fetch [-S socket_path] -A fields search_query

doveadm [GLOBAL OPTIONS] [-f formatter] fetch [-S socket_path] -F file fields search_query

doveadm [GLOBAL OPTIONS] [-f formatter] fetch [-S socket_path] --no-userdb-lookup fields search_query

doveadm [GLOBAL OPTIONS] [-f formatter] fetch [-S socket_path] -u user fields search_query

دستور doveadm fetch می‌تواند برای واکشی محتوا و متاداده‌های پیام‌ها استفاده شود. این دستور می‌تواند برای اسکریپت‌ها و اشکال‌زدایی مفید باشد. اگر می‌خواهید پیام‌ها را یکی‌یکی واکشی کنید، doveadm-search(1) را ببینید.

•
لطفاً به حریم خصوصی کاربران خود احترام بگذارید.

گزینه‌های عمومی doveadm(1):

-D

حالت پُرگویی و پیام‌های اشکال‌زدایی را فعال می‌کند.

-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 از اشیاء JSON را چاپ می‌کند.

pager

هر جفت key: value را در خط جداگانه‌ای چاپ کرده و رکوردها را با نویسهٔ form feed (^L) جدا می‌کند.

tab

یک سربرگ جدول و در ادامه خطوط مقادیر جداشده با تب (tab) را چاپ می‌کند.

table

یک سربرگ جدول و در ادامه خطوط مقادیر تراز و هم‌راستاشده را چاپ می‌کند.

این دستور به‌طور پیش‌فرض از قالب‌ساز خروجی pager استفاده می‌کند..SH "گزینه‌ها (OPTIONS)"

-A

در صورت وجود گزینهٔ -A، دستور command برای همهٔ کاربران اجرا خواهد شد. استفاده از این گزینه در ترکیب با کاربران سیستمی از userdb { driver = passwd } توصیه نمی‌شود، زیرا شامل کاربرانی با شناسهٔ UID کمتر از مقدار پیکربندی‌شده در تنظیمات first_valid_uid نیز می‌شود.

هنگامی که ماژول SQL userdb استفاده می‌شود، مطمئن شوید که تنظیم userdb_sql_iterate_query با چیدمان پایگاه‌دادهٔ شما مطابقت دارد.

هنگام استفاده از ماژول LDAP userdb، مطمئن شوید که تنظیمات userdb_fields و userdb_ldap_iterate_fields با طرحوارهٔ (schema) LDAP شما مطابقت دارند. در غیر این صورت doveadm(1) قادر نخواهد بود روی همهٔ کاربران پیمایش کند.

-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 داده‌شده. همچنین امکان استفاده از نویسه‌های عام (wildcard) '*' و '?' وجود دارد (مانند ‎-u *@example.org).

fields

یک یا چند نام فیلد نتیجه برای نمایش، در صورتی که search_query با هر پیامی مطابقت داشته باشد. برای مشخص کردن چندین فیلد، آن‌ها را داخل علامت نقل‌قول تکی یا دوتایی قرار دهید.

فیلدهای (fields) پشتیبانی‌شده عبارتند از:

binary : بدنهٔ پیام در قالب رمزگشایی‌شده.

binary.<section> : بخشی از بدنه به‌صورت رمزگشایی‌شده، مانند binary.1

body : بدنهٔ یک پیام.

body.<section> : بخشی از بدنه، مانند body.1

body.preview : پیش‌نمایش کوتاهی از بدنه.

body.snippet : نام مستعار قدیمی برای preview.

date.received : تاریخ و زمان تحویل نهایی، هنگامی که پیام برای نخستین بار به صندوق پستی کاربر تحویل داده شد.

تاریخ و زمان داخلی پیام مبدأ، هنگامی که پیام توسط دستور IMAP COPY رونوشت شد.

صفت تاریخ-زمان در صورت وجود، وگرنه زمان کنونی، هنگامی که پیام توسط دستور IMAP APPEND ذخیره شد.

date.received.unixtime : مقدار date.received به عنوان برچسب زمانی یونیکس (unix timestamp).

date.saved : تاریخ و زمانی که پیام در صندوق پستی ذخیره شد.

date.saved.unixtime : مقدار date.saved به عنوان برچسب زمانی یونیکس (unix timestamp).

date.sent : تاریخ و زمان سرآیند Date: پیام.

date.sent.unixtime : مقدار date.sent به عنوان برچسب زمانی یونیکس (unix timestamp).

flags : پرچم‌های IMAP پیام، مانند \Seen

guid : شناسهٔ منحصربه‌فرد جهانی (GUID) پیام.

hdr : سرآیند پیام.

hdr.<name> : سرآیند نام‌گذاری‌شده از پیام.

imap.body : خروجی IMAP BODY از پیام (RFC 3501 را ببینید).

imap.bodystructure : خروجی IMAP BODYSTRUCTURE از پیام (RFC 3501 را ببینید).

imap.envelope : خروجی IMAP ENVELOPE از پیام (RFC 3501 را ببینید).

mailbox : نام صندوق پستی که پیام در آن ذخیره شده است. این نام در قالب UTF-8 است.

mailbox-guid : شناسهٔ منحصربه‌فرد جهانی صندوق پستی که پیام در آن قرار دارد.

modseq : شماره توالی تغییرات (modification sequence number) برای ایمیل.

pop3.order : شماره ترتیب یک پیام درون صندوق پستی.

pop3.uidl : شناسه یکتای (POP3) یک پیام درون صندوق پستی.

refcount : تعداد ارجاع ایمیل، فقط برای mdbox.

seq : شماره توالی یک پیام در صندوق پستی.

size.physical : اندازه فیزیکی یک پیام.

size.virtual : اندازه مجازی یک پیام، محاسبه‌شده با پایان‌دهنده‌های خط CRLF.

storageid : شناسه اختصاصی راه‌انداز صندوق پستی برای ایمیل.

text : کل پیام (سرآیند و بدنه).

text.utf8 : کل پیام (سرآیند و بدنه) — کدگذاری‌شده با UTF-8.

uid : شناسه یکتای (IMAP) یک پیام در صندوق پستی.

user : نام کاربری ورودِ مالک پیام.

search_query

واکشی پیام‌های منطبق با این پرس‌وجوی جستجو. برای جزئیات doveadm-search-query(1) را ببینید.

این مثال بر اساس اولین مثال از doveadm-search(1) است. ما فیلدهای mailbox و date.sent را از صندوق پستی کاربر bob با guid مقدار "3a94c928d66ebe4bda04000015811c6a" برای پیام‌هایی با UIDهای 8، 25 و 45 واکشی می‌کنیم.

doveadm fetch -u bob "mailbox date.sent" mailbox-guid 3a94c928d66ebe4bda04000015811c6a uid 8,25,45
mailbox: dovecot/pigeonhole/2.0
date.sent: 2010-01-19 01:17:41 (+0100)
^L
mailbox: dovecot/pigeonhole/2.0
date.sent: 2010-01-28 09:38:49 (+0100)
^L
mailbox: dovecot/pigeonhole/2.0
date.sent: 2010-03-28 18:41:14 (+0200)

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

doveadm(1)

May 2026 e5ac02a