1getmail_fetch(1) User Commands getmail_fetch(1)
2
3
4
6 getmail_fetch - retrieve messages from one or more POP3 or POP3-over-
7 SSL mailboxes and deliver to a maildir, mboxrd-format mbox file, or
8 external MDA
9
11 getmail_fetch [OPTIONS] SERVER USERNAME PASSWORD DESTINATION
12
14 getmail_fetch retrieves messages from POP3 or POP3-over-SSL mailboxes
15 and delivers to a maildir, mboxrd, or external MDA. This command is
16 intended primarily for scripting, and as such does not require a
17 client-side configuration file, and does not record any state.
18
19 The DESTINATION argument is interpreted as follows:
20
21 If it begins with a dot or a slash and ends with a slash, it is assumed
22 to be a path to a maildir.
23
24 If it begins with a dot or a slash and does not end with a slash, it is
25 assumed to be a path to an mboxrd file.
26
27 If it begins with a pipe, it is assumed to be a path to an external MDA
28 command. Note that arguments can be included in this string by sepa‐
29 rating them by whitespace; untrusted data must not be used in con‐
30 structing this string.
31
33 --version
34 show program's version number and exit
35
36 -h, --help
37 show a short usage summary and exit
38
39 -v, --verbose
40 output information messages while running
41
42 -q, --quiet
43 output only on error
44
45 -mFILE, --message=FILE
46 read well-formatted RFC822 message from FILE and deliver prior
47 to connecting to POP server
48
49 -pPORT, --port=PORT
50 use port PORT instead of default (POP3: 110, POP3-over-SSL: 995)
51
52 -d, --delete
53 delete messages from server after delivery
54
55 -tTIMEOUT, --timeout=TIMEOUT
56 use timeout of TIMEOUT seconds instead of default 180
57
58 -a, --apop
59 use APOP authentication
60
61 -s, --ssl
62 use POP3-over-SSL
63
65 Written by Charles Cazabon.
66
68 Report bugs to <charlesc-getmail-bugs@pyropus.ca>.
69
70 IMPORTANT: include the output of getmail [options] --dump with any bug
71 report.
72
74 Copyright © 1998-2009 Charles Cazabon
75 This is free software; see the file COPYING for copying conditions.
76 There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
77 PARTICULAR PURPOSE.
78
80 The full documentation for getmail is maintained in HTML and plaintext
81 formats. See the included files for details.
82
83
84
85getmail 4 November 2005 getmail_fetch(1)