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