getmail_fetch − retrieve messages from one or more POP3 or POP3-over-SSL mailboxes and deliver to a maildir, mboxrd-format mbox file, or external MDA
getmail_fetch [OPTIONS] SERVER USERNAME PASSWORD DESTINATION
getmail_fetch retrieves messages from POP3 or POP3-over-SSL mailboxes and delivers to a maildir, mboxrd, or external MDA. This command is intended primarily for scripting, and as such does not require a client-side configuration file, and does not record any state.
The DESTINATION argument is interpreted as follows:
If it begins with a dot or a slash and ends with a slash, it is assumed to be a path to a maildir.
If it begins with a dot or a slash and does not end with a slash, it is assumed to be a path to an mboxrd file.
If it begins with a pipe, it is assumed to be a path to an external MDA command. Note that arguments can be included in this string by separating them by whitespace; untrusted data must not be used in constructing this string.
−−version
show program’s version number and exit
−h, −−help
show a short usage summary and exit
−v, −−verbose
output information messages while running
−q, −−quiet
output only on error
−mFILE, −−message=FILE
read well-formatted RFC822 message from FILE and deliver prior to connecting to POP server
−pPORT, −−port=PORT
use port PORT instead of default (POP3: 110, POP3-over-SSL: 995)
−d, −−delete
delete messages from server after delivery
−tTIMEOUT, −−timeout=TIMEOUT
use timeout of TIMEOUT seconds instead of default 180
−a, −−apop
use APOP authentication
−s, −−ssl
use POP3-over-SSL
getmail_fetch exits zero on success, and nonzero on any error. The specific values of the exit code are not documented and may change from version to version.
Written by Charles Cazabon.
Report bugs to <charlesc-getmail-bugs@pyropus.ca>.
IMPORTANT: include the output of getmail [options] --dump with any bug report.
Copyright
© 1998-2021 Charles Cazabon
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.
The full documentation for getmail is maintained in HTML and plaintext formats. See the included files for details.