-# .poprc sample
+# fetchmail control file sample
#
# This file (or one of your own creation, rather) should be located
-# in your home directory with the name .poprc. Permissions on this
-# file may be no greater than -rw-------, or fetchmail will refuse to
+# in your home directory with the name .fetchmailrc. Permissions on this
+# file may be no greater than -rw------- (0600), or fetchmail will refuse to
# use it.
#
-# To see what effect your ~/.poprc file has, do
+# To see what effect your ~/.fetchmailrc file has, do
#
# fetchmail --version
#
# arguments in this file, the command-line arguments take precedence.
#
# Legal keywords are
-# server
-# protocol (or proto)
-# username (or user)
-# password (or pass)
-# remotefolder (or remote)
-# localfolder (or local)
-# mda
+# poll -- must be followed by a mailserver name or label
+# skip -- must be followed by a mailserver name or label
+# via -- must be followed by true name of host to poll
+# interval -- must be followed by an interval skip count
+# protocol (or proto) -- must be followed by a protocol ID
+# uidl
+# no uidl
+# port -- must be followed by a TCP/IP port number
+# authenticate (or auth) -- must be followed by an authentication type
+# timeout -- must be followed by a numeric timeout value
+# envelope -- must be followed by an envelope header name
+# aka -- must be followed by one or more server aliases
+# localdomains -- must be followed by one or more domain names
+# interface -- must be followed by device/IP address/mask
+# monitor -- must be followed by IP address
+#
+# username (or user) -- must be followed by a name
+# is -- must be followed by one or more names
+# folder -- must be followed by remote folder names
+# password (or pass) -- must be followed by a password string
+# smtphost (or smtp) -- must be followed by host names
+# mda -- must be followed by an MDA command string
+# preconnect (or pre) -- must be followed by an initialization command
+#
# keep
# flush
# fetchall
-# nokeep
-# noflush
-# nofetchall
+# rewrite
+# forcecr
+# stripcr
+# pass8bits
+# dropstatus
+# dns
+# no keep
+# no flush
+# no fetchall
+# no rewrite
+# no forcecr
+# no stripcr
+# no dns
+# no envelope
+# no pass8bits
+# no dropstatus
+# limit -- must be followed by numeric size limit
+# fetchlimit -- must be followed by numeric msg fetch limit
+# batchlimit -- must be followed by numeric SMTP batch limit
#
# Legal protocol identifiers are
# pop2 (or POP2)
# pop3 (or POP3)
# imap (or IMAP)
+# imap-k4 (or IMAP-K4)
# apop (or APOP)
# rpop (or RPOP)
+# kpop (or KPOP)
+# etrn (or ETRN)
#
-# Basic format is
-# server SERVERNAME protocol PROTOCOL username NAME password PASSWORD
-# Example:
+# Legal authentication types are
+# login
+# kerberos
#
-server pop.provider.net protocol pop3 username jsmith password secret1
-
-# Or, using some abbreviations:
+# Legal global option statements are
#
-server pop.provider.net proto pop3 user jsmith password secret1
-
-# Multiple servers may be listed
+# set logfile = -- must be followed by a string
+# set daemon -- must be followed by a number
+# set syslog
+#
+# The noise keywords `and', `with', `has', `wants', and `options' are ignored
+# anywhere in an entry; they can be used to make it resemble English. The
+# punctuation characters `,' `:' `;' are also ignored.
#
-server pop.provider.net proto pop3 user jsmith password secret1
-server other.provider.net proto pop2 user John.Smith password My^Hat
+# The run control file format is fully described (with more examples) on the
+# fetchmail manual page.
+#
+# This is what the developer's .fetchmailrc looks like:
+
+set daemon 300 # Poll at 5-minute intervals
+
+defaults
+ interface "sl0/10.0.2.15" # SLIRP standard address
+ user esr is esr fetchmail-friends magic-numbers here
+ fetchall
+
+# Use this for production
+poll imap.ccil.org protocol IMAP:
+ no dns, aka snark.thyrsus.com thyrsus.com locke.ccil.org ccil.org
+ password my_remote_password;
+
+# Use this to test POP3
+skip pop3.ccil.org with protocol APOP:
+ no dns, aka snark.thyrsus.com thyrsus.com locke.ccil.org ccil.org
+ password my_apop_secret;
-# Other possibilities (note use of \ to escape newline -- this is all
-# one server definition.
-server pop.provider.net \
- proto pop3 \
- user jsmith \
- pass secret1 \
- localfolder ~/mbox
+# Use this to test against a different server
+skip pop3.netaxs.com:
+ password my_netaxs.password;