]> Pileus Git - ~andy/fetchmail/blob - sample.rcfile
a6973156e832786a5e7768a90084ab6a481e4888
[~andy/fetchmail] / sample.rcfile
1 # .poprc sample
2 #
3 #    $Log: sample.rcfile,v $
4 #    Revision 1.2  1996/06/26 19:09:01  esr
5 #    This is what I sent Harris.
6 #
7 #    Revision 1.1  1996/06/25 16:50:31  esr
8 #    Initial revision
9 #
10 #    Revision 1.2  1995/08/10 00:32:46  ceharris
11 #    Preparation for 3.0b3 beta release:
12 #    -  added code for --kill/--keep, --limit, --protocol, --flush
13 #       options; --pop2 and --pop3 options now obsoleted by --protocol.
14 #    -  added support for APOP authentication, including --with-APOP
15 #       argument for configure.
16 #    -  provisional and broken support for RPOP
17 #    -  added buffering to SockGets and SockRead functions.
18 #    -  fixed problem of command-line options not being correctly
19 #       carried into the merged options record.
20 #
21 #    Revision 1.1  1995/08/09 01:33:04  ceharris
22 #    Version 3.0 beta 2 release.
23 #    Added
24 #    -  .poprc functionality
25 #    -  GNU long options
26 #    -  multiple servers on the command line.
27 #    Fixed
28 #    -  Passwords showing up in ps output.
29 #
30 #
31 # This file (or one of your own creation, rather) should be located 
32 # in your home directory with the name .poprc.  Permissions on this
33 # file may be no greater than -rw-------, or popclient will refuse to
34 # use it.
35 #
36 # I'd like to point out here that I do not, repeat DO NOT, endorse
37 # the use of plaintext passwords in the .poprc file.  I include the
38 # password option because SO MANY people asked me about having such
39 # an option.  I don't use it myself.  And I recommend that you don't
40 # use it.  
41 #
42 # I'd also like to point out that the syntax of this file is still
43 # under development (during the 3.0 beta series of releases).  If you
44 # would like to suggest revisions, please do.
45 #
46 # Comments begin with a '#' and extend through the end of the line.
47 # Blank lines between server entries are ignored.
48 # Keywords and identifiers are case sensitive.
49 # When there is a conflict between the command-line arguments and the
50 # arguments in this file, the command-line arguments take precedence.
51 #
52 # Legal keywords are
53 #   server
54 #   protocol (or proto)
55 #   username (or user)
56 #   password (or pass)
57 #   remotefolder (or remote)
58 #   localfolder (or local)
59 #   mda
60 #   keep
61 #   flush
62 #   fetchall
63 #   nokeep
64 #   noflush
65 #   nofetchall
66 #
67 # Legal protocol identifiers are
68 #   pop2 (or POP2)
69 #   pop3 (or POP3)
70 #   imap (or IMAP)
71 #   apop (or APOP)
72 #   rpop (or RPOP)
73 #
74 # Basic format is
75 server SERVERNAME protocol PROTOCOL username NAME password PASSWORD 
76 # Example
77 server pop.provider.net protocol pop3 username jsmith password secret1
78 # Or, using some abbreviations
79 server pop.provider.net proto pop3 user jsmith password secret1
80
81 # Multiple servers may be listed
82 server pop.provider.net proto pop3 user jsmith password secret1
83 server other.provider.net proto pop2 user John.Smith password My^Hat
84
85 # Other possibilities (note use of \ to escape newline -- this is all 
86 # one server definition.
87 server pop.provider.net         \
88         proto pop3              \
89         user jsmith             \
90         pass secret1            \
91         localfolder ~/mbox