.\" Copyright (c) 2010 Dovecot authors, see the included COPYING file
.TH DOVEADM 1M "2011-05-11" "Dovecot v2.0" "Dovecot"
.SH NAME
doveadm \- Dovecot\(aqs administration utility
.\"------------------------------------------------------------------------
.SH SYNOPSIS
.BR doveadm " [" \-Dv "] [" \-f
.IR formatter ]
.IR command " [" command_options "] [" command_arguments ]
.\"------------------------------------------------------------------------
.SH DESCRIPTION
.B doveadm
is the Dovecot administration tool. It can be used to manage various parts
of Dovecot, as well as access users\(aq mailboxes.
.br
Execute
.BR doveadm\ help ,
for a command usage listing.
.\"------------------------------------------------------------------------
.SH OPTIONS
Global
.BR doveadm (1M)
.IR options :
.TP
.B \-D
Enables verbosity and debug messages.
.TP
.BI \-f\  formatter
Specifies the
.I formatter
for formatting the output.
Supported formatters are:
.RS
.TP
.B flow
prints each line with
.IB key = value
pairs.
.TP
.B pager
prints each
.IR key :\  value
pair on its own line and separates records with form feed character
.RB ( ^L ).
.TP
.B tab
prints a table header followed by tab separated value lines.
.TP
.B table
prints a table header followed by adjusted value lines.
.RE
.TP
.B \-v
Enables verbosity, including progress counter.
.\"------------------------------------------------------------------------
.SH COMMANDS
.\"------------------------------------------------------------------------
These commands work directly with Dovecot\(aqs master process.
.\"-------------------------------------
.SS reload
.B doveadm reload
.PP
Force
.BR dovecot (1M)
to reload the configuration.
.\"------------------------------------------------------------------------
.SS stop
.B doveadm stop
.PP
Stop
.BR dovecot (1M)
and all its child processes.
.\"------------------------------------------------------------------------
.SS ADDITIONAL MASTER COMMANDS
.TP
.B doveadm director
.BR doveadm\-director (1M),
Manage Dovecot directors (if used by proxy servers).
.\"-------------------------------------
.TP
.B doveadm kick
.BR doveadm\-kick (1M),
Disconnect users by user name and/or IP address.
.\"-------------------------------------
.TP
.B doveadm log
.BR doveadm\-log (1M),
Locate, test or reopen Dovecot\(aqs log files.
.\"-------------------------------------
.TP
.B doveadm penalty
.BR doveadm\-penalty (1M),
Show current penalties.
.\"-------------------------------------
.TP
.B doveadm who
.BR doveadm\-who (1M);
Show who is logged in to the Dovecot server.
.\"------------------------------------------------------------------------
.SS AUTHENTICATION COMMANDS
.\"-------------------------------------
.TP
.B doveadm auth
.BR doveadm\-auth (1M),
Test authentication for a user.
.\"-------------------------------------
.TP
.B doveadm pw
.BR doveadm\-pw (1M),
Dovecot\(aqs password hash generator.
.\"-------------------------------------
.TP
.B doveadm user
.BR doveadm\-user (1M),
Perform a user lookup in Dovecot\(aqs userdbs
.\"------------------------------------------------------------------------
.SS MAILBOX COMMANDS
.TP
.B doveadm altmove
.BR doveadm\-altmove (1M),
Move matching mails to the alternative storage.
.\"-------------------------------------
.TP
.B doveadm dump
.BR doveadm\-dump (1M),
Dump the content of Dovecot\(aqs binary mailbox index/log.
.\"-------------------------------------
.TP
.B doveadm expunge
.BR doveadm\-expunge (1M),
Expunge messages matching given search query.
.\"-------------------------------------
.TP
.B doveadm fetch
.BR doveadm\-fetch (1M),
Fetch messages matching given search query.
.\"-------------------------------------
.TP
.B doveadm force\-resync
.BR doveadm\-force\-resync (1M),
Repair broken mailboxes, in case Dovecot doesn\(aqt automatically do that.
.\"-------------------------------------
.TP
.B doveadm import
.BR doveadm\-import (1M),
Import messages matching given search query.
.\"-------------------------------------
.TP
.B doveadm index
.BR doveadm\-index (1M),
Index messages in a given mailbox.
.\"-------------------------------------
.TP
.B doveadm mailbox
.BR doveadm\-mailbox (1M),
Various commands related to handling mailboxes.
.\"-------------------------------------
.TP
.B doveadm purge
.BR doveadm\-purge (1M)
Remove messages with refcount=0 from mdbox files.
.\"-------------------------------------
.TP
.B doveadm quota
.BR doveadm\-quota (1M),
Initialize/recalculate or show current quota usage.
.\"-------------------------------------
.TP
.B doveadm search
.BR doveadm\-search (1M),
Show a list of mailbox GUIDs and message UIDs matching given search query.
.\"------------------------------------------------------------------------
.SH "EXIT STATUS"
.B doveadm
will exit with one of the following values:
.TP 4
.B 0
Selected command was executed successful.
.TP
.B >0
Command failed in some way.
.\"------------------------------------------------------------------------
.SH ENVIRONMENT
.TP
.B USER
This environment variable is used to determine the
.I user
if a command accepts a
.I user
but none was specified.
.\"------------------------------------------------------------------------
.SH FILES
.TP
.I /etc/dovecot/dovecot.conf
Dovecot\(aqs main configuration file.
.TP
.I /etc/dovecot/conf.d/10\-mail.conf
Mailbox locations and namespaces.
.TP
.I /etc/dovecot/conf.d/90\-plugin.conf
Plugin specific settings.
.\"------------------------------------------------------------------------
.SH REPORTING BUGS
Report bugs, including
.I doveconf \-n
output, to the Dovecot Mailing List <dovecot@dovecot.org>.
Information about reporting bugs is available at:
http://dovecot.org/bugreport.html
.\"------------------------------------------------------------------------
.SH SEE ALSO
.BR doveadm\-help (1M),
.BR doveconf (1M),
.BR dovecot (1M),
.BR dsync (1M),