Copyright (c) 2010-2018 Dovecot authors, see the included COPYING file
DOVEADM-FETCH 1 "2015-05-09" "Dovecot v2.3" "Dovecot"
NAME
doveadm-fetch - Fetch partial/full messages or message information ------------------------------------------------------------------------
SYNOPSIS
doveadm " [" -Dv "] [" -f formatter ] fetch " [" -S socket_path "] " "fields search_query"

-------------------------------------
doveadm " [" -Dv "] [" -f formatter ] fetch " [" -S socket_path "]" -A " fields search_query"

-------------------------------------
doveadm " [" -Dv "] [" -f formatter ] fetch " [" -S socket_path "]" -F " file fields search_query"

-------------------------------------
doveadm " [" -Dv "] [" -f formatter ] fetch " [" -S socket_path "]" -u " user fields search_query" ------------------------------------------------------------------------

DESCRIPTION
doveadm fetch can be used to fetch messages\(aq contents and metadata. This can be useful for scripts and for debugging. If you want to fetch messages one at a time, see doveadm-search (1).
Important:
Please respect your users\(aq privacy. ------------------------------------------------------------------------
@INCLUDE:global-options-formatter@ --- command specific options --- "/.

This command uses by default the output formatter pager .

Command specific options : -------------------------------------
@INCLUDE:option-A@ -------------------------------------
@INCLUDE:option-F-file@ -------------------------------------
@INCLUDE:option-S-socket@ -------------------------------------
@INCLUDE:option-u-user@ ------------------------------------------------------------------------

ARGUMENTS

fields One or more result field names to display, if the search_query matches any messages. In order to specify multiple fields, enclose them in single or double quotes.

Supported fields are:

body -----------------
The body of a message.

date.received Date and time of final delivery, when the message was delivered to a user\(aqs mailbox for the first time.

The internal date and time of the source message, when the message was copied by the IMAP COPY command.

The date-time attribute when present, otherwise the current time, when the message was saved by the IMAP APPEND command. -----------------

date.saved Date and time when the message was saved to mailbox. -----------------

date.sent Date and time of the message\(aqs Date: header. -----------------

flags A message\(aqs IMAP flags, e.g. \(rsSeen -----------------

guid A message\(aqs globally unique identifier. -----------------

hdr The header of the message. -----------------

imap.body IMAP BODY output of the message (see RFC 3501). -----------------

imap.bodystructure IMAP BODYSTRUCTURE output of the message (see RFC 3501). -----------------

imap.envelope IMAP ENVELOPE output of the message (see RFC 3501). -----------------

mailbox Name of the mailbox, in which the message is stored. The name is in UTF-8. -----------------

mailbox-guid The globally unique identifier of the mailbox, in which the message is located. -----------------

pop3.uidl A message\(aqs unique (POP3) identifier within a mailbox. -----------------

seq A message\(aqs sequence number in a mailbox. -----------------

size.physical A message\(aqs physical size. -----------------

size.virtual A message\(aqs virtual size, computed with CRLF line terminators. -----------------

text The entire message (header and body). -----------------

text.utf8 The entire message (header and body) \(em UTF-8 encoded. -----------------

uid A message\(aqs unique (IMAP) identifier in a mailbox. -----------------

user A message owner\(aqs login name. -----------------

-------------------------------------

search_query Fetch messages matching this search query. See doveadm-search-query (7) for details. ------------------------------------------------------------------------

EXAMPLE
This example based on the first example from doveadm-search (1). We are fetching the fields mailbox and date.sent from user bob\(aqs mailbox with the guid \(dq3a94c928d66ebe4bda04000015811c6a\(dq for the messages with the UIDs 8 , 25 and 45 . 

 doveadm fetch -u bob \(dqmailbox date.sent\(dq \(rs  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)
------------------------------------------------------------------------
@INCLUDE:reporting-bugs@ ------------------------------------------------------------------------
SEE ALSO
doveadm (1), doveadm-search (1), doveadm-search-query (7)