view doc/man/doveadm-purge.1.in @ 18137:3009a1a6f6d5

global: freshen copyright Robomatically: git ls-files | xargs perl -p -i -e 's/(\d+)-201[0-4]/$1-2015/g;s/ (201[0-4]) Dovecot/ $1-2015 Dovecot/' Happy 2015 everyone! Signed-off-by: Phil Carmody <phil@dovecot.fi>
author Phil Carmody <phil@dovecot.fi>
date Mon, 05 Jan 2015 22:20:10 +0200
parents 1f3f21081ee5
children c469d8f4cde7
line wrap: on
line source

.\" Copyright (c) 2010-2015 Dovecot authors, see the included COPYING file
.TH DOVEADM\-PURGE 1 "2010-11-25" "Dovecot v2.2" "Dovecot"
.SH NAME
doveadm\-purge \- Remove messages with refcount=0 from mdbox files
.\"------------------------------------------------------------------------
.SH SYNOPSIS
.BR doveadm " [" \-Dv "] " purge " [" \-S
.IR socket_path "] "
.\"-------------------------------------
.br
.BR doveadm " [" \-Dv "] " purge " [" \-S
.IR socket_path ]
.B \-A
.\"-------------------------------------
.br
.BR doveadm " [" \-Dv "] " purge " [" \-S
.IR socket_path "] "
.BI \-u \ user
.\"------------------------------------------------------------------------
.SH DESCRIPTION
The
.B doveadm purge
command is used to remove all messages with refcount=0 from a user\(aqs
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.
.PP
In the first form,
.BR doveadm (1)
will perform the
.B purge
action for the currently logged in user.
.PP
In the second form, the command will be executed for all users
.PP
In the last form, only messages of the given
.IR user (s)
will be purged.
.\"------------------------------------------------------------------------
@INCLUDE:global-options@
.\" --- command specific options --- "/.
.PP
Command specific
.IR options :
.\"-------------------------------------
@INCLUDE:option-A@
.\"-------------------------------------
@INCLUDE:option-S-socket@
.\"-------------------------------------
@INCLUDE:option-u-user@
.\"------------------------------------------------------------------------
@INCLUDE:reporting-bugs@
.\"------------------------------------------------------------------------
.SH SEE ALSO
.BR doveadm (1),
.BR doveadm\-expunge (1)
.PP
See http://wiki2.dovecot.org/MailboxFormat/dbox#Multi\-dbox for some
details.