--- name: "getmails" section: "1" platform: "linux" package: "getmail6" version: "6.19.07-1" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/getmails" --- # getmails(1) wrapper for getmail to access multiple mailboxes ## 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 \ ## COPYRIGHT Copyright 2011-2017 Osamu Aoki\ Copyright 2025 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.