| [FrontPage] [TitleIndex] [WordIndex]

# TmdaPendingAsMaildir

Contents

1. Introduction
2. Enabling Maildir support
3. Converting your current pending queue
4. Maildir tools
5. More Maildir info

## Introduction

As of TMDA v1.1.7, your pending queue can be a Maildir rather than the default, which is a custom single directory based format. This allows you to use any program that supports Maildir to browse or search your pending queue, rather than relying on the `tmda-pending` and `tmda-cgi` programs, though the latter will still work.

Remember to use common sense when using external programs to manipulate your TMDA pending queue. If you hand remove a message from the queue that is waiting to be confirmed for example, and the sender then tries to confirm it, he will get back a bounce saying his message can't be found, which might be confusing to him. When in doubt, copy messages from your pending queue rather than moving/deleting them.

## Enabling Maildir support

If you wish to try this, you must set the PENDING_QUEUE_FORMAT variable in your configuration.

`PENDING_QUEUE_FORMAT = 'maildir'`

## Converting your current pending queue

Future releases will likely provide a tool to handle conversion for you, but for now, you must also convert your current pending queue to a Maildir by hand, which is not difficult since the formats are fairly similar. Your pending queue is controlled by PENDING_DIR, which by default is `~/.tmda/pending`. Use the following shell commands or in a script as appropriate to suspend delivery, copy your pending messages, and then enable delivery:

    % chmod +t $HOME
    % cd ~/.tmda
    % mv pending pending.old
    % mkdir -m 0700 -p pending/{new,cur,tmp}
    % cp pending.old/*.msg pending/new
    % chmod -t $HOME

On the other hand, if your current pending queue contains only spam and you don't need to convert it, you can just blow it away and TMDA will automatically create the Maildir next time a message arrives:

    % chmod +t $HOME
    % rm -rf ~/.tmda/pending
    % chmod -t $HOME

## Maildir tools

Here's a list of some links to other programs which support Maildir and might be useful to TMDA users for pending queue browsing, searching, indexing, etc. Feel free to add to this list.

- mdfrm is a nice command-line summary program for Maildir.

- nmzmail is a tool, primarily to be used with mutt, for indexing and searching Maildir folders.

- mairix is a program for indexing and searching email messages stored in Maildir folders.

- MDMH is a command-line interface similar to MH, but for Maildir.

- Binc and Dovecot are IMAP servers that support Maildir.

- Mutt is a popular text-based mail client that supports Maildir.

## More Maildir info

- Maildir man page (from qmail)

- djb's Maildir page

- Maildir++ is a minor extension to the standard Maildir structure.

- dovecot's Maildir page

2007-07-30 15:45