# fetchmail control file sample (remove this header comment from yours!)
#
# This file (or one of your own creation, rather) should be located
# 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 ~/.fetchmailrc file has, do
#
# fetchmail --version
#
# This will display the fetchmail version number and an explanation
# in English of what the currently set options and defaults mean.
#
# Comments begin with a '#' and extend through the end of the line.
# Blank lines between server entries are ignored.
# Keywords and identifiers are case sensitive.
# When there is a conflict between the command-line arguments and the
# arguments in this file, the command-line arguments take precedence.
#
# Legal keywords are
# 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
# principal -- must be followed by a principal name
# ssl
# sslkeyfile -- must be followed by path to private key file
# sslcertfile -- must be followed by path to certificate file
# 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
# qvirtual -- must be followed by a name prefix
# no envelope
# 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 device
# plugin -- must be followed by a string command name
# plugout -- must be followed by a string command name
# dns
# no dns
# checkalias -- do multidrop address comparison by IP address
# no checkalias -- do multidrop address comparison by name
#
# 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
# smtpaddress -- must be followed by a host name
# antispam -- must be followed by a numeric response value
# mda -- must be followed by an MDA command string
# bsmtp -- must be followed by a filename or -
# lmtp
# preconnect (or pre) -- must be followed by an executable command
# postconnect (or post) -- must be followed by an executable command
#
# keep
# flush
# fetchall
# rewrite
# forcecr
# stripcr
# pass8bits
# dropstatus
# mimedecode
# idle
# no keep
# no flush
# no fetchall
# no rewrite
# no forcecr
# no stripcr
# no pass8bits
# no dropstatus
# no mimedecode
# no idle
# limit -- must be followed by numeric size limit
# warnings -- 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
# expunge -- must be followed by numeric delete count
# properties -- must be followed by a string
#
# 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)
#
# Add ssl for protocols operating over an SSL connection (POP3 and IMAP)
# Default port for IMAPS (IMAP over SSL) is 993
# Default port for POP3S (POP3 over SSL) is 995
# Taken from assigned numbers and compatible with netscape/outlook usage.
#
# Legal authentication types are
# login
# kerberos
# kerberos_v5
#
# Legal global option statements are
#
# set logfile -- must be followed by a string
# set idfile -- must be followed by a string
# set postmaster -- must be followed by a string
# set daemon -- must be followed by a number
# set syslog
# set invisible
# set showdots
#
# 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.
#
# 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;
# Use this to test against a different server
skip pop3.netaxs.com:
password my_netaxs.password;