summaryrefslogtreecommitdiffstats
path: root/doc/man/doveadm-flags.1.in
blob: 4e72d44892adcded6b357ad7970eda692065d1dc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
.\" Copyright (c) 2013-2018 Dovecot authors, see the included COPYING file
.TH DOVEADM\-FLAGS 1 "2015-05-09" "Dovecot v2.3" "Dovecot"
.SH NAME
doveadm\-flags \- add, remove or replace messages\(aq flags
.\"------------------------------------------------------------------------
.SH SYNOPSIS
.BR doveadm " [" \-Dv "] " flags " [" \-S
.IR socket_path "] " "command flags search_query"
.\"-------------------------------------
.br
.BR doveadm " [" \-Dv "] " flags " [" \-S
.IR socket_path "] " "command flags search_query"
.B \-A
.\"-------------------------------------
.br
.BR doveadm " [" \-Dv "] " flags " [" \-S
.IR socket_path "] " "command flags search_query"
.BI "\-F " file
.\"-------------------------------------
.br
.BR doveadm " [" \-Dv "] " flags " [" \-S
.IR socket_path "] " "command flags search_query"
.BI "\-u " user
.\"------------------------------------------------------------------------
.SH DESCRIPTION
This command is used to manipulate flags of messages.
.\"------------------------------------------------------------------------
@INCLUDE:global-options@
.\"-------------------------------------
.PP
Command specific
.IR options :
.\"-------------------------------------
@INCLUDE:option-A@
.\"-------------------------------------
@INCLUDE:option-F-file@
.\"-------------------------------------
@INCLUDE:option-S-socket@
.\"-------------------------------------
@INCLUDE:option-u-user@
.\"------------------------------------------------------------------------
.SH ARGUMENTS
.TP
.I flags
Message flags as described in RFC 3501, section 2.3.2 (Flags Message
Attribute):
.BR \(rsAnswered ", " \(rsDeleted ", " \(rsDraft ", " \(rsFlagged ", "
.BR \(rsRecent " and " \(rsSeen .
And the IMAP keywords
.BR \(DoForwarded ", " \(DoMDNSent ", " \(DoSubmitPending " and "
.B \(DoSubmitted
or user\-defined keywords, e.g. Junk, \(DoNonSpam or \(DoLabel1.
.br
One or multiple flags and/or keywords can be specified.
.\"-------------------------------------
.TP
.I search_query
Manipulate the flags of messages matching the given search query.
See
.BR doveadm\-search\-query (7)
for details.
.\"------------------------------------------------------------------------
.SH COMMANDS
.SS flags add
.BR "doveadm flags add" " [" \-u
.IR user |\c
.BR \-A | \-F
.IR file ]
.RB [ \-S
.IR socket_path "] " "flags search_query"
.PP
This command is used to extend the current set of flags with the given
.IR flags .
.\"-------------------------------------
.SS flags remove
.BR "doveadm flags remove" " [" \-u
.IR user |\c
.BR \-A | \-F
.IR file ]
.RB [ \-S
.IR socket_path "] " "flags search_query"
.PP
In order to remove the given
.I flags
from the current set of flags, use this command.
.\"-------------------------------------
.SS flags replace
.BR "doveadm flags replace" " [" \-u
.IR user |\c
.BR \-A | \-F
.IR file ]
.RB [ \-S
.IR socket_path "] " "flags search_query"
.PP
This command is used to replace ALL current flags with the given
.IR flags .
.\"------------------------------------------------------------------------
.SH EXAMPLE
List and manipulate the message flags of the message with uid 81563
.sp
.nf
.ft B
doveadm fetch \-u bob \(aquid flags\(aq mailbox dovecot uid 81563
.ft P
uid: 81563
flags: \(rsAnswered \(rsSeen NonJunk

.ft B
doveadm flags remove \-u bob NonJunk mailbox dovecot uid 81563
doveadm flags add \-u bob \(aq\(rsFlagged \(DoForwarded\(aq \
mailbox dovecot uid 81563
.ft P
.fi
.\"------------------------------------------------------------------------
@INCLUDE:reporting-bugs@
.\"------------------------------------------------------------------------
.SH SEE ALSO
.BR doveadm (1),
.BR doveadm\-fetch (1),
.BR doveadm\-search\-query (7)