NAME

       queue-repair - deal with the qmail queue directory structure

SYNOPSIS

       queue-repair [ -htrcbn ] [ -n split ] [ conf-qmail ]

DESCRIPTION

       queue-repair  deals  with  the  qmail queue structure; it can create a new queue, move and
       properly rename a queue, dynamically change the conf-split value, convert big-todo  queues
       to non-big-todo and vice versa, and repair a corrupted queue.

       conf-qmail defaults to /var/lib/qmail/ on Debian.

OPTIONS

       -h|--help
              Display usage information and built-in defaults, then exit.

       -t|--test
              Run  in  test-only  mode.  queue-repair will attempt to report all problems that it
              finds, without correcting them.  This is the default.

       -r|--repair
              Run in repair mode.  queue-repair will attempt to  correct  all  problems  that  it
              finds,  except  if the basic queue directories (queue, queue/mess, queue/info, etc)
              are not found.

       -c|--create
              Run in create-and-repair mode.  queue-repair will attempt to correct  all  problems
              that it finds, including creation of a new queue structure from scratch.

       -s|--split split
              Specify   split  as  the  value  of  conf-split.   This  is  the  number  of  split
              subdirectories for those queue directories which are hashed.  The default for qmail
              is  23.   Appropriate  values  depend  on the volume of mail handled, OS filesystem
              efficiency, and other factors, but this should always be a prime number.

              If you do not specify  conf-split,  queue-repair  will  attempt  to  determine  the
              current value from the existing queue.  This option can be used, however, to change
              the conf-split value of an existing queue (qmail will still have to  be  recompiled
              with  the  new  value).   When  creating  a  new  queue, this option must always be
              specified.

       -b|--bigtoto
              Use big-todo.  queue-repair should be able to  automatically  determine  if  you're
              using  qmail patched with the big-todo patch.  This option can be used, however, to
              convert a non-big-todo queue to a big-todo queue  (qmail  will  still  have  to  be
              recompiled with the big-todo patch).

              If  neither  this  option  nor  --no-bigtodo  is used, queue-repair will attempt to
              determine this automatically.  When creating a new queue,  either  this  option  or
              --no-bigtodo must always be specified.

       -n|--no-bigtodo
              Do  not  use  big-todo.   queue-repair should be able to automatically determine if
              you're using qmail patched with the big-todo  patch.   This  option  can  be  used,
              however, to convert a big-todo queue to a non big-todo queue (qmail will still have
              to be recompiled without the big-todo patch).

              If neither this  option  nor  --bigtodo  is  used,  queue-repair  will  attempt  to
              determine  this  automatically.   When  creating a new queue, either this option or
              --bigtodo must always be specified.

       --i-want-a-broken-conf-split
              Force the use of a non-prime value for conf-split.

SEE ALSO

       qmail(7)

                                                                                  queue-repair(8)