GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
getmails(1) User Commands getmails(1)

getmails - wrapper for getmail to access multiple mailboxes

getmails [-p] [OPTION] ...

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.

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

Copyright 2011-2017 Osamu Aoki
Copyright 2021 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.
May 2021 getmail6

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.