.TH "DOVEADM-FETCH" "1" "May 2026" "e5ac02a" "Dovecot" .SH "نام (NAME)" \fBdoveadm-fetch\fR \- واکشی بخشی یا تمام پیام‌ها یا اطلاعات پیام .SH "خلاصه دستور (SYNOPSIS)" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \[lB]\fB-f\fR \fIformatter\fR\[rB] \fBfetch\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-A\fR \fIfields\fR \fIsearch_query\fR .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \[lB]\fB-f\fR \fIformatter\fR\[rB] \fBfetch\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-F\fR \fIfile\fR \fIfields\fR \fIsearch_query\fR .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \[lB]\fB-f\fR \fIformatter\fR\[rB] \fBfetch\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB--no-userdb-lookup\fR \fIfields\fR \fIsearch_query\fR .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \[lB]\fB-f\fR \fIformatter\fR\[rB] \fBfetch\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-u\fR \fIuser\fR \fIfields\fR \fIsearch_query\fR .SH "توضیحات (DESCRIPTION)" .P دستور \fBdoveadm fetch\fR می‌تواند برای واکشی محتوا و متاداده‌های پیام‌ها استفاده شود. این دستور می‌تواند برای اسکریپت‌ها و اشکال‌زدایی مفید باشد. اگر می‌خواهید پیام‌ها را یکی‌یکی واکشی کنید، doveadm-search(1) را ببینید. .RS 0 .IP \(bu 4 لطفاً به حریم خصوصی کاربران خود احترام بگذارید. .RE 0 .SH "گزینه‌های عمومی (GLOBAL OPTIONS)" .P گزینه‌های عمومی doveadm(1): .P \fB-D\fR .RS 0 .RS 4 .P حالت \fIپُرگویی\fR و پیام‌های اشکال‌زدایی را فعال می‌کند. .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 .P \fB-f\fR \fIformatter\fR .RS 0 .RS 4 .P قالب‌ساز خروجی (\fIformatter\fR) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌سازهای پشتیبانی‌شده عبارتند از: .P \fBflow\fR .RS 4 .P هر خط را با جفت‌های \fIkey\fR\fB=\fR\fIvalue\fR چاپ می‌کند. .RE 0 .P \fBjson\fR .RS 4 .P یک آرایهٔ JSON از اشیاء JSON را چاپ می‌کند. .RE 0 .P \fBpager\fR .RS 4 .P هر جفت \fIkey\fR: \fIvalue\fR را در خط جداگانه‌ای چاپ کرده و رکوردها را با نویسهٔ 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 این دستور به‌طور پیش‌فرض از قالب‌ساز خروجی \fBpager\fR استفاده می‌کند..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-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 داده‌شده. همچنین امکان استفاده از نویسه‌های عام (wildcard) '\fB*\fR' و '\fB?\fR' وجود دارد (مانند ‎-u *@example.org). .RE 0 .RE 0 .SH "آرگومان‌ها (ARGUMENTS)" .P \fIfields\fR .RS 0 .RS 4 .P یک یا چند نام فیلد نتیجه برای نمایش، در صورتی که \fIsearch_query\fR با هر پیامی مطابقت داشته باشد. برای مشخص کردن چندین فیلد، آن‌ها را داخل علامت نقل‌قول تکی یا دوتایی قرار دهید. .P فیلدهای (\fIfields\fR) پشتیبانی‌شده عبارتند از: .RS 4 .P \fBbinary\fR : بدنهٔ پیام در قالب رمزگشایی‌شده. .RE 0 .RS 4 .P \fBbinary.
\fR : بخشی از بدنه به‌صورت رمزگشایی‌شده، مانند binary.1 .RE 0 .RS 4 .P \fBbody\fR : بدنهٔ یک پیام. .RE 0 .RS 4 .P \fBbody.
\fR : بخشی از بدنه، مانند body.1 .RE 0 .RS 4 .P \fBbody.preview\fR : پیش‌نمایش کوتاهی از بدنه. .RE 0 .RS 4 .P \fBbody.snippet\fR : نام مستعار قدیمی برای preview. .RE 0 .RS 4 .P \fBdate.received\fR : تاریخ و زمان تحویل نهایی، هنگامی که پیام برای نخستین بار به صندوق پستی کاربر تحویل داده شد. .P تاریخ و زمان داخلی پیام مبدأ، هنگامی که پیام توسط دستور IMAP COPY رونوشت شد. .P صفت تاریخ\-زمان در صورت وجود، وگرنه زمان کنونی، هنگامی که پیام توسط دستور IMAP APPEND ذخیره شد. .RE 0 .RS 4 .P \fBdate.received.unixtime\fR : مقدار date.received به عنوان برچسب زمانی یونیکس (unix timestamp). .RE 0 .RS 4 .P \fBdate.saved\fR : تاریخ و زمانی که پیام در صندوق پستی ذخیره شد. .RE 0 .RS 4 .P \fBdate.saved.unixtime\fR : مقدار date.saved به عنوان برچسب زمانی یونیکس (unix timestamp). .RE 0 .RS 4 .P \fBdate.sent\fR : تاریخ و زمان سرآیند Date: پیام. .RE 0 .RS 4 .P \fBdate.sent.unixtime\fR : مقدار date.sent به عنوان برچسب زمانی یونیکس (unix timestamp). .RE 0 .RS 4 .P \fBflags\fR : پرچم‌های IMAP پیام، مانند \[rs]Seen .RE 0 .RS 4 .P \fBguid\fR : شناسهٔ منحصربه‌فرد جهانی (GUID) پیام. .RE 0 .RS 4 .P \fBhdr\fR : سرآیند پیام. .RE 0 .RS 4 .P \fBhdr.\fR : سرآیند نام‌گذاری‌شده از پیام. .RE 0 .RS 4 .P \fBimap.body\fR : خروجی IMAP BODY از پیام (RFC 3501 را ببینید). .RE 0 .RS 4 .P \fBimap.bodystructure\fR : خروجی IMAP BODYSTRUCTURE از پیام (RFC 3501 را ببینید). .RE 0 .RS 4 .P \fBimap.envelope\fR : خروجی IMAP ENVELOPE از پیام (RFC 3501 را ببینید). .RE 0 .RS 4 .P \fBmailbox\fR : نام صندوق پستی که پیام در آن ذخیره شده است. این نام در قالب UTF-8 است. .RE 0 .RS 4 .P \fBmailbox-guid\fR : شناسهٔ منحصربه‌فرد جهانی صندوق پستی که پیام در آن قرار دارد. .RE 0 .RS 4 .P \fBmodseq\fR : شماره توالی تغییرات (modification sequence number) برای ایمیل. .RE 0 .RS 4.P \fBpop3.order\fR : شماره ترتیب یک پیام درون صندوق پستی. .RE 0 .RS 4 .P \fBpop3.uidl\fR : شناسه یکتای (POP3) یک پیام درون صندوق پستی. .RE 0 .RS 4 .P \fBrefcount\fR : تعداد ارجاع ایمیل، فقط برای mdbox. .RE 0 .RS 4 .P \fBseq\fR : شماره توالی یک پیام در صندوق پستی. .RE 0 .RS 4 .P \fBsize.physical\fR : اندازه فیزیکی یک پیام. .RE 0 .RS 4 .P \fBsize.virtual\fR : اندازه مجازی یک پیام، محاسبه‌شده با پایان‌دهنده‌های خط CRLF. .RE 0 .RS 4 .P \fBstorageid\fR : شناسه اختصاصی راه‌انداز صندوق پستی برای ایمیل. .RE 0 .RS 4 .P \fBtext\fR : کل پیام (سرآیند و بدنه). .RE 0 .RS 4 .P \fBtext.utf8\fR : کل پیام (سرآیند و بدنه) \[em] کدگذاری‌شده با UTF-8. .RE 0 .RS 4 .P \fBuid\fR : شناسه یکتای (IMAP) یک پیام در صندوق پستی. .RE 0 .RS 4 .P \fBuser\fR : نام کاربری ورودِ مالک پیام. .RE 0 .RE 0 .RE 0 .P \fIsearch_query\fR .RS 0 .RS 4 .P واکشی پیام‌های منطبق با این پرس‌وجوی جستجو. برای جزئیات doveadm-search-query(1) را ببینید. .RE 0 .RE 0 .SH "مثال‌ها (EXAMPLES)" .P این مثال بر اساس اولین مثال از doveadm-search(1) است. ما فیلدهای \fBmailbox\fR و \fBdate.sent\fR را از صندوق پستی کاربر bob با guid مقدار "3a94c928d66ebe4bda04000015811c6a" برای پیام‌هایی با UIDهای \fB8\fR، \fB25\fR و \fB45\fR واکشی می‌کنیم. .P .RS 2 .nf doveadm fetch -u bob "mailbox date.sent" mailbox-guid 3a94c928d66ebe4bda04000015811c6a uid 8,25,45 .fi .RE .P .RS 2 .nf 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) .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 doveadm(1)