Minor enhancements.

[~andy/fetchmail] / sample.rcfile

diff --git a/sample.rcfile b/sample.rcfile
index 6464f2a7ff51f758d2bf5ab998b9bb366f63b458..089657720f4f64c3d7a04858e5df341c0a4fc099 100644 (file)
--- a/sample.rcfile
+++ b/sample.rcfile
@@ -2,7 +2,7 @@
 #
 # 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 
@@ -19,9 +19,13 @@
 # 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
+#   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
@@ -33,9 +37,9 @@
 #
 #   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
+#   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 a host name
+#   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
 #
@@ -43,12 +47,21 @@
 #   flush
 #   fetchall
 #   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
@@ -57,9 +70,11 @@
 #   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)
 #
 # Legal authentication types are
 #   login
@@ -68,6 +83,8 @@
 # Legal global option statements are
 #
 #   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
@@ -78,19 +95,23 @@
 # 
 # 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 locke.ccil.org with protocol APOP:
-       password my_apop_secret;
-
-# Use this to test IMAP
-skip locke protocol IMAP:
+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 against POP2 using a local server
-skip localhost protocol pop2:
-       password my_local_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;