.. _man-1_doveadm-purge:

=============
doveadm-purge
=============

NAME
====

doveadm-purge - Remove messages with refcount=0 from mdbox files

SYNOPSIS
========

**doveadm** [*GLOBAL OPTIONS*] **purge** [**-S** *socket_path*] **-A**

**doveadm** [*GLOBAL OPTIONS*] **purge** [**-S** *socket_path*] **-F** *file*

**doveadm** [*GLOBAL OPTIONS*] **purge** [**-S** *socket_path*] **-u** *user*

DESCRIPTION
===========

The **doveadm purge** command is used to remove all messages with
refcount=0 from a user's mail storage. The refcount of a message is
decreased to 0 when the user (or some administration utility) has
expunged all instances of a message from all mailboxes.

In the first form, the command will be executed for all users.

In the second form, the command will be executed for all users listed in
the given *file*.

In the last form, only messages of the given *user* (s) will be purged.

.. include:: global-options.inc

OPTIONS
=======

.. include:: option-A.inc

.. include:: option-F-file.inc

.. include:: option-S-socket.inc

.. include:: option-u-user.inc


.. include:: reporting-bugs.inc


SEE ALSO
========

:man:`doveadm(1)`

See https://doc.dovecot.org/admin_manual/mailbox_formats/dbox/ for some
details.