X-Git-Url: http://pileus.org/git/?p=~andy%2Ffetchmail;a=blobdiff_plain;f=sample.rcfile;h=1d0b09a29aa3482d1a1064f3c731f2e9cbccab8f;hp=d9822f014664d5a6b9b1d3e8049d15aaed77f3b9;hb=53293ee30678d3db753e51820cc554c0b2b1bd97;hpb=7f32cacbd31832e7c2410b24a40aa6e7c8f820bf

diff --git a/sample.rcfile b/sample.rcfile
index d9822f01..1d0b09a2 100644
--- a/sample.rcfile
+++ b/sample.rcfile
@@ -1,8 +1,8 @@
-# fetchmail control file sample
+# 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-------, or fetchmail will refuse to
+# file may be no greater than -rw------- (0600), or fetchmail will refuse to
 # use it.
 #
 # To see what effect your ~/.fetchmailrc file has, do 
@@ -18,76 +18,37 @@
 # 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
-#   skip                      -- must be followed by a mailserver name
-#   protocol (or proto)       -- must be followed by a protocol ID
-#   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
-#
-#   username (or user)        -- must be followed by a name
-#   is                        -- must be followed by one or more names
-#   remotefolder (or remote)  -- must be followed by a filename
-#   password (or pass)        -- must be followed by a password string
-#   smtphost (or smtp)        -- must be followed by a host name
-#   mda                       -- must be followed by an MDA command string
-#   preconnect (or pre)       -- must be followed by an initialization command
-#
-#   keep
-#   flush
-#   fetchall
-#   rewrite
-#   nokeep
-#   noflush
-#   nofetchall
-#   norewrite
-#   limit                     -- must be followed by numeric size limit
-#   fetchlimit                -- must be followed by numeric msg fetch limit
-#
-# Legal protocol identifiers are
-#   pop2 (or POP2)
-#   pop3 (or POP3)
-#   imap (or IMAP)
-#   apop (or APOP)
-#   kpop (or KPOP)
-#
-# Legal authentication types are
-#   login
-#   kerberos
-#
-# Legal global option statements are
-#
-#   set batchlimit =		-- must be followed by a number
-#   set logfile =		-- must be followed by a string
-#   set interface =             -- must be followed by IP address
-#   set monitor =               -- must be followed by IP address
-#
-# 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 charactes `,' `:' `;' 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:
+#
+# This is what the former developer's .fetchmailrc looks like:
 
-set batchlimit = 0		# I forward to sendmail
-set interface = sl0/10.0.2.15	# SLIRP's default IP address
+set daemon 300	# Sleep 300 seconds after the poll, then poll again.
 
-defaults password not_blowing_my_cover;
+defaults
+	# only poll when the sl0 interface is up (only available on some systems)
+	interface "sl0/10.0.2.15"	# SLIRP standard address
+	# log in with name "esr" and do multidrop fetch for the users
+	# esr, fetchmail-friends, and magic-numbers
+	user esr is esr fetchmail-friends magic-numbers here
+	# fetch (and delete after retrieval) all messages
+	fetchall
 
 # Use this for production
-poll locke.ccil.org with protocol APOP:
-	user esr there with password my_apop_secret is esr here;
+poll imap.example.org protocol IMAP:
+	# do not use MX lookups to check of server aliases, but pass
+	# them explicitly:
+	no dns, aka snark.thyrsus.com thyrsus.com locke.example.org example.org 
+	password my_remote_password;
 
-# Use this to test IMAP
-skip locke protocol IMAP:
-	user esr here is esr there;
+# Use this to test POP3
+skip pop3.example.org with protocol APOP:
+	# do not use MX lookups to check of server aliases, but pass
+	# them explicitly:
+	no dns, aka snark.thyrsus.com thyrsus.com locke.example.org example.org 
+	password my_apop_secret;
 
-# Use this to test against POP2 using a local server
-skip localhost protocol pop2:
-	user esr here is esr there;
+# Use this to test against a different server - it is skipped unless
+# you give its name on fetchmail's command line.
+skip pop3.netaxs.com:
+	password my_netaxs.password;