sample.rcfile   [plain text]


# 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;