NAME

       getmails - wrapper for getmail to access multiple mailboxes

SYNOPSIS

       getmails [-p] [OPTION] ...

DESCRIPTION

       getmails  is  a  wrapper  script for getmail to retrieve messages with multiple independent configuration
       files $XDG_CONFIG_HOME/getmail/* or for backward compatibility ~/.getmail/config/* instead  of  a  single
       ~/.getmailrc file.

       The  configuration file name can be any arbitrary names.  It's a good idea to use the corresponding email
       address   as   its    name    since    it    is    the    most    intuitive    choice.     For    example
       $XDG_CONFIG_HOME/getmail/foo@example.org .

       To  disable  operation  for  an email account temporary, rename its configuration file to the hidden file
       such as $XDG_CONFIG_HOME/getmail/.foo@example.org .  Then, it is ignored as configuration file.

       For  the  robust  operation,  the  editor  generated  files  such  as   $XDG_CONFIG_HOME/getmail/foo~   ,
       $XDG_CONFIG_HOME/getmail/#foo#  , $XDG_CONFIG_HOME/getmail/foo.swp , and $XDG_CONFIG_HOME/getmail/foo.bak
       are also ignored as configuration file.

       When there are multiple email configuration files, getmails retrieves mails sequentially.  But adding  an
       optional  option  -p  before  other options makes getmails invoke getmail with each configuration file in
       parallel to retrieve mails.

       The option provided as OPTION is passed to getmail as is.  The use of the -r option is not a good idea.

       The existence of $XDG_CONFIG_HOME/getmail/stop can prevent this wrapper script to execute getmail.

REPORTING BUGS

       Report bugs to <https://github.com/getmail6/getmail6/issues>

COPYRIGHT

       Copyright 2011-2017 Osamu Aoki
       Copyright 2022 Roland Puntaier
       This is free software; see the file COPYING for copying conditions.
       There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

getmail6                                            May 2022                                         getmails(1)