GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
UNEXPUNGE(8) Cyrus IMAP UNEXPUNGE(8)

unexpunge - Cyrus IMAP documentation

Recover messages the user has (accidentally) deleted.

unexpunge [ -C config-file ] -l mailbox
unexpunge [ -C config-file ] -t time-interval [ -d ] [ -v ] [ -f flagname ] mailbox
unexpunge [ -C config-file ] -a [ -d ] [ -v ] [ -f flagname ] mailbox
unexpunge [ -C config-file ] -u [ -d ] [ -v ] [ -f flagname ] mailbox uid...

The unexpunge program is used to list or restore messages which have been deleted from a mailbox, but still reside in the Cyrus IMAP mail spool.

This utility is only useful when the server is configured with expunge_mode set to delayed in its configuration file.

unexpunge reads its configuration options out of the imapd.conf(5) file unless specified otherwise by -C.

-C config-file
Use the specified configuration file config-file rather than the default imapd.conf(5).

-l
List the expunged messages in the specified mailbox which are available for restoration.

-t time-interval
Unexpunge messages which where expunged within the last time-interval seconds. Use one of the trailing modifiers – m (minutes), h (hours), d (days) or w (weeks) – to specify a different time unit.

-a
Restore all of the expunged messages in the specified mailbox.

-u
Restore only messages matching the UIDs, in a space-separated list at the end of the command invocation, in the specified mailbox.

-d
Unset the \Deleted flag on any restored messages.

-f flagname
Set the user flag \flagname on the messages restored, making it easier for the user(s) to find the restored messages and operate on them (in a batch).

-v
Enable verbose output/logging.

unexpunge -l user/john@example.org
List the messages that are expunged and could be restored for mailbox user/john@example.org.


unexpunge -u user/john@example.org 278787 278788
Unexpunge two of these messages.


mbexamine user/john@example.org
Examine the mailbox for the two restored messages.


unexpunge -u -d user.johnsmith 46908
Unexpunge a select message based on its UID, clearing the \Deleted flag.


unexpunge -a user.johnsmit.Trash
Unexpunge all messages in a user’s Trash, but leave them flagged \Deleted.


unexpunge -a -f Flagged user.johnsmith.Trash
The same, but setting user flag \Flagged to facilitate later bulk operations.


unexpunge -t 24h -d -f Flagged user.johnsmith
Unexpunge messages matching only a given time period.


unexpunge -t 24h -d -f Flagged user/johnsmith
The same command, supporting the unixhierarchysep: yes option in imapd.conf(5).


/etc/imapd.conf

imapd.conf(5)

The Cyrus Team, Nic Bernstein (Onlight), Jeroen van Meeuwen (Kolab Systems)

1993-2018, The Cyrus Team
February 2, 2022 3.4.3

Search for    or go to Top of page |  Section 8 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.