1 # fetchmail control file sample
3 # This file (or one of your own creation, rather) should be located
4 # in your home directory with the name .fetchmailrc. Permissions on this
5 # file may be no greater than -rw-------, or fetchmail will refuse to
8 # To see what effect your ~/.fetchmailrc file has, do
12 # This will display the fetchmail version number and an explanation
13 # in English of what the currently set options and defaults mean.
15 # Comments begin with a '#' and extend through the end of the line.
16 # Blank lines between server entries are ignored.
17 # Keywords and identifiers are case sensitive.
18 # When there is a conflict between the command-line arguments and the
19 # arguments in this file, the command-line arguments take precedence.
22 # poll -- must be followed by a mailserver name
23 # skip -- must be followed by a mailserver name
24 # protocol (or proto) -- must be followed by a protocol ID
25 # port -- must be followed by a TCP/IP port number
26 # authenticate (or auth) -- must be followed by an authentication type
27 # timeout -- must be followed by a numeric timeout value
28 # aka -- must be followed by one or more server aliases
30 # username (or user) -- must be followed by a name
31 # is -- must be followed by one or more names
32 # remotefolder (or remote) -- must be followed by a filename
33 # password (or pass) -- must be followed by a password string
34 # smtphost (or smtp) -- must be followed by a host name
35 # mda -- must be followed by an MDA command string
45 # Legal protocol identifiers are
52 # Legal authentication types are
56 # Legal global option statements are
58 # set batchlimit = -- must be followed by a number
60 # The noise keywords `and', `with', `has', `wants', and `options' are ignored
61 # anywhere in an entry; they can be used to make it resemble English. The
62 # punctuation charactes `,' `:' `;' are also ignored.
64 # The run control file format is fully described (with more examples) on the
65 # fetchmail manual page.
67 # This is what the developer's .fetchmailrc looks like:
69 set batchlimit 0 # I forward to sendmail
71 defaults password not_blowing_my_cover;
73 # Use this for production
74 poll locke.ccil.org with protocol APOP:
75 user esr there with password my_apop_secret is esr here;
77 # Use this to test IMAP
78 skip locke protocol IMAP:
79 user esr here is esr there;
81 # Use this to test against POP2 using a local server
82 skip localhost protocol pop2:
83 user esr here is esr there;