SYNTAX

       mailutil check [-debug] [-verbose] mailbox
       mailutil create [-debug] [-verbose] new_mailbox
       mailutil copy [-debug] [-verbose] old_mailbox new_mailbox
       mailutil move [-debug] [-verbose] old_mailbox new_mailbox
       mailutil append [-debug] [-verbose] source destination
       mailutil appenddelete [-debug] [-verbose] source dest
       mailutil transfer [-debug] [-verbose] [-merge m] src dst


DESCRIPTION

       mailutil  replaces  the  old  chkmail, imapcopy, imapmove,
       imapxfer, mbxcopy, mbxcreat, and mbxcvt programs.

       mailutil check determines whether new mail exists  in  the
       given  mailbox.   The number of new messages is defined as
       the number of messages that have "Recent" status set.   If
       the  mailbox contains no new messages, mailutil check will
       indicate that no new mail is present; otherwise,  it  will
       report  the  number  of  new messages.  In either case, it
       will also indicate the canonical form of the name  of  the
       mailbox.

       mailutil create creates a new mailbox with the given name.
       The mailbox name must not already exist.  A mailbox can be
       created  in a particular format by prefixing the name with
       #driver.  followed by the format name and a  /  character.
       For example, the command
          mailutil create #driver.mbx/junkmail
       will  create a new mailbox named "junkmail" in mbx format.

       mailutil copy and mailutil move creates a new mailbox  and
       copies  messages  from the old mailbox to the new mailbox.
       In addition, will also remove  (delete  and  expunge)  the
       messages  from  the  old mailbox after copying them to the
       new mailbox.  As in mailutil create a mailbox  format  can
       be  specified  with  the  new  mailbox.   For example, the
       command
          mailutil copy INBOX #driver.mbx/INBOX
       will copy messages from your existing  INBOX  to  an  mbx-
       format INBOX.

       mailutil  append  and mailutil appenddelete are similar to
       mailutil copy and mailutil move except that  they  do  not
       create the destination mailbox.

       mailutil  transfer copies an entire hierarchy of mailboxes
       from the named source to the named destination.  Mailboxes
       are  created  on  the destination as needed.  Any error in
       copying messages will cause the transfer to stop.

       Normally, any error in creation will cause the transfer to
       stop.   However,  if  -merge  mode is specified, a merging
       given suffix to the name.  It that alternative name  can't
       be  created,  then  the  user  will  be  prompted  for  an
       alternative name.

       The source hierarchy consists of all mailboxes which start
       with  the  given  source  name.   With  the exception of a
       remote system  specification  (within  "{}"  braces),  the
       source  name  is used as the name of the destination.  The
       destination hierarchy is a prefix applied to any new names
       being created.  For example,
          mailutil transfer foo bar
       will copy all mailboxes with names beginning with "foo" to
       names beginning with "bar" (hence "foobar" will be  copied
       to "barfoobar").  Similarly,
          mailutil transfer "{imap.foo.com}" "{imap.bar.com}old/"
       will copy all mailboxes from the imap.foo.com IMAP  server
       to   equivalent   names   starting   with  "old/"  on  the
       imap.bar.com IMAP server.


FLAGS

       The -debug flag prints full debugging telemetry  including
       protocol  operations.   The  -verbose  flag prints verbose
       (non-error) telemetry.


ARGUMENTS

       The arguments are  standard  c-client  mailbox  names.   A
       variety of mailbox name formats and types of mailboxes are
       supported by c-client; examples of the most  common  forms
       of names are:


       Name           Meaning

       INBOX          primary  incoming  mail folder on the local
                      system

       archive/tx-project
                      mail folder named "tx-project" in "archive"
                      subdirectory   of   local  filesystem  home
                      directory

       {imapserver.foo.com}INBOX
                      primary incoming mail folder on IMAP server
                      system "imapserver.foo.com"

       {imapserver.foo.com}archive/tx-project
                      mail folder named "tx-project" in "archive"
                      subdirectory   on   IMAP   server    system
                      "imapserver.foo.com"

       #news.comp.mail.misc
                      newsgroup    "comp.mail.misc"    on   local

       You  must surround a {host}mailbox argument with quotation
       marks if you run mailutil from csh(1) or another shell for
       which braces have special meaning.

       You  must  surround a #driver.format/mailbox argument with
       quotation marks if you run mailutil from a shell in  which
       "#" is the comment character.


AUTHOR

       Mark Crispin, MRC@CAC.Washington.EDU



                           14 July 2002           mailutil(LOCAL)

Man(1) output converted with man2html