Pileus Git - ~andy/fetchmail/blob - sample.rcfile

   1 # fetchmail control file sample
   2 #
   3 # This file (or one of your own creation, rather) should be located
   4 # in your home directory with the name .fetchmailrc.  Permissions on this
   5 # file may be no greater than -rw-------, or fetchmail will refuse to
   6 # use it.
   7 #
   8 # To see what effect your ~/.fetchmailrc file has, do
   9 #
  10 #       fetchmail --version
  11 #
  12 # This will display the fetchmail version number and an explanation
  13 # in English of what the currently set options and defaults mean.
  14 #
  15 # Comments begin with a '#' and extend through the end of the line.
  16 # Blank lines between server entries are ignored.
  17 # Keywords and identifiers are case sensitive.
  18 # When there is a conflict between the command-line arguments and the
  19 # arguments in this file, the command-line arguments take precedence.
  20 #
  21 # Legal keywords are
  22 #   poll                      -- must be followed by a mailserver name
  23 #   skip                      -- must be followed by a mailserver name
  24 #   protocol (or proto)       -- must be followed by a protocol ID
  25 #   port                      -- must be followed by a TCP/IP port number
  26 #   authenticate (or auth)    -- must be followed by an authentication type
  27 #   timeout                   -- must be followed by a numeric timeout value
  28 #   envelope                  -- must be followed by an envelope header name
  29 #   aka                       -- must be followed by one or more server aliases
  30 #
  31 #   username (or user)        -- must be followed by a name
  32 #   is                        -- must be followed by one or more names
  33 #   remotefolder (or remote)  -- must be followed by a filename
  34 #   password (or pass)        -- must be followed by a password string
  35 #   smtphost (or smtp)        -- must be followed by a host name
  36 #   mda                       -- must be followed by an MDA command string
  37 #   preconnect (or pre)       -- must be followed by an initialization command
  38 #
  39 #   keep
  40 #   flush
  41 #   fetchall
  42 #   rewrite
  43 #   nokeep
  44 #   noflush
  45 #   nofetchall
  46 #   norewrite
  47 #   limit                     -- must be followed by numeric size limit
  48 #   fetchlimit                -- must be followed by numeric msg fetch limit
  49 #
  50 # Legal protocol identifiers are
  51 #   pop2 (or POP2)
  52 #   pop3 (or POP3)
  53 #   imap (or IMAP)
  54 #   apop (or APOP)
  55 #   kpop (or KPOP)
  56 #
  57 # Legal authentication types are
  58 #   login
  59 #   kerberos
  60 #
  61 # Legal global option statements are
  62 #
  63 #   set batchlimit =            -- must be followed by a number
  64 #   set logfile =               -- must be followed by a string
  65 #   set interface =             -- must be followed by IP address
  66 #   set monitor =               -- must be followed by IP address
  67 #
  68 # The noise keywords `and', `with', `has', `wants', and `options' are ignored
  69 # anywhere in an entry; they can be used to make it resemble English.  The
  70 # punctuation charactes `,' `:' `;' are also ignored.
  71 #
  72 # The run control file format is fully described (with more examples) on the
  73 # fetchmail manual page.
  74 #
  75 # This is what the developer's .fetchmailrc looks like:
  76
  77 set batchlimit = 0              # I forward to sendmail
  78 set interface = sl0/10.0.2.15   # SLIRP's default IP address
  79
  80 defaults password not_blowing_my_cover;
  81
  82 # Use this for production
  83 poll locke.ccil.org with protocol APOP:
  84         user esr there with password my_apop_secret is esr here;
  85
  86 # Use this to test IMAP
  87 skip locke protocol IMAP:
  88         user esr here is esr there;
  89
  90 # Use this to test against POP2 using a local server
  91 skip localhost protocol pop2:
  92         user esr here is esr there;