aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEric S. Raymond <esr@thyrsus.com>1996-09-25 21:22:00 +0000
committerEric S. Raymond <esr@thyrsus.com>1996-09-25 21:22:00 +0000
commitf13d100f2c027590fb5b110e5e527aa5ab513797 (patch)
treebc6f5c6980f7365db50d3648cf6d3528209baf68
parent6c4d0e25165d9f3256bd486028d010033d7a2e9c (diff)
downloadfetchmail-f13d100f2c027590fb5b110e5e527aa5ab513797.tar.gz
fetchmail-f13d100f2c027590fb5b110e5e527aa5ab513797.tar.bz2
fetchmail-f13d100f2c027590fb5b110e5e527aa5ab513797.zip
Name of run control file changed.
svn path=/trunk/; revision=148
-rw-r--r--fetchmail.man26
-rw-r--r--options.c55
2 files changed, 40 insertions, 41 deletions
diff --git a/fetchmail.man b/fetchmail.man
index 2630453d..14a41526 100644
--- a/fetchmail.man
+++ b/fetchmail.man
@@ -25,9 +25,9 @@ RPOP and LAST facilities removed from later POP3 versions.
The behavior of
.I fetchmail
is controlled by comand-line options and a run control file,
-.I ~/.fetchrc
+.I ~/.fetchmailrc
the syntax of which we describe below. Command-line options override
-.I ~/.fetchrc
+.I ~/.fetchmailrc
declarations.
.PP
To facilitate the use of
@@ -38,7 +38,7 @@ termination -- see EXIT CODES below.
Each server name that you specify (following the options on the
command line) will be queried. If you don't specify any servers
on the command line, each server in your
-.I ~/.fetchrc
+.I ~/.fetchmailrc
file will be queried.
.TP
.B \-2
@@ -84,8 +84,8 @@ options on the same command line.
POP3/IMAP only. Delete old (previously retrieved) messages from the mailserver
before retrieving new messages.
.TP
-.B \-f pathname, --fetchrc pathname
-Specify an alternate name for the .fetchrc run control file.
+.B \-f pathname, --fetchmailrc pathname
+Specify an alternate name for the .fetchmailrc run control file.
.TP
.B \-i pathname, --idfile pathname
Specify an alternate name for the .fetchids file.
@@ -231,7 +231,7 @@ established. This is the safest way to use
.I fetchmail
and ensures that your password will not be compromised. You may also specify
your password in your
-.I ~/.fetchrc
+.I ~/.fetchmailrc
file. This is convenient when using
.I fetchmail
in daemon mode or with scripts.
@@ -244,7 +244,7 @@ the correct user-id and password for your mailbox account.
POP3 versions up to the RFC1225 version supported an alternate
authentication mechanism called RPOP intended to remove the security
risk inherent in sending unencrypted account passwords across the net
-(in RFC1460 this facility was replaced with APOP). If your .fetchrc
+(in RFC1460 this facility was replaced with APOP). If your .fetchmailrc
file specifies an RPOP id and a connection port in the privileged
range (1..1024),
.I fetchmail will
@@ -358,7 +358,7 @@ Simply invoking
fetchmail -d 900
.PP
will, therefore, poll the hosts described in your
-.I ~/.fetchrc
+.I ~/.fetchmailrc
file once every fifteen minutes.
.PP
Only one daemon process is permitted per user; in daemon mode,
@@ -376,8 +376,8 @@ mode into a specified logfile (follow the option with the logfile name).
This is primarily useful for debugging configurations.
.SH THE RUN CONTROL FILE
The preferred way to set up fetchmail (and the only way if you want to
-specify a password) is to write a .fetchrc file in your home directory.
-To protect the security of your passwords, your ~/.fetchrc may not have
+specify a password) is to write a .fetchmailrc file in your home directory.
+To protect the security of your passwords, your ~/.fetchmailrc may not have
more than u+r,u+w permissions;
.I fetchmail
will complain and exit otherwise.
@@ -575,7 +575,7 @@ created by the new SMTP forwarding default.
.PP
.SH FILES
.TP 5
-~/.fetchrc
+~/.fetchmailrc
default run control file
.TP 5
~/.fetchids
@@ -616,12 +616,12 @@ protocols such as DMSP in the future).
The --password option of previous (popclient) versions has been removed -- it
encouraged people to expose passwords in scripts. Passwords
must now be specified either interactively or in your
-.I ~/.fetchrc
+.I ~/.fetchmailrc
file. The short-form -p option now specifies the protocol to use.
.PP
The reason the password isn't stored encrypted is because this doesn't
actually add protection. Anyone who's acquired permissions to read your
-fetchrc file will be able to run
+fetchmailrc file will be able to run
.I fetchmail
as you anyway -- and if it's
your password they're after, they'd be able to use the necessary decoder from
diff --git a/options.c b/options.c
index c9fa747a..4b103846 100644
--- a/options.c
+++ b/options.c
@@ -29,7 +29,7 @@
#define LA_FLUSH 9
#define LA_PROTOCOL 10
#define LA_DAEMON 11
-#define LA_FETCHRC 12
+#define LA_RCFILE 12
#define LA_IDFILE 13
#define LA_USERNAME 14
#define LA_REMOTEFILE 15
@@ -56,7 +56,7 @@ static struct option longoptions[] = {
{"protocol", required_argument, (int *) 0, LA_PROTOCOL },
{"proto", required_argument, (int *) 0, LA_PROTOCOL },
{"daemon", required_argument, (int *) 0, LA_DAEMON },
- {"fetchrc", required_argument, (int *) 0, LA_FETCHRC },
+ {"fetchmailrc",required_argument,(int *) 0, LA_RCFILE },
{"user", required_argument, (int *) 0, LA_USERNAME },
{"username", required_argument, (int *) 0, LA_USERNAME },
{"remote", required_argument, (int *) 0, LA_REMOTEFILE },
@@ -190,7 +190,7 @@ struct hostrec *queryctl;
poll_interval = atoi(optarg);
break;
case 'f':
- case LA_FETCHRC:
+ case LA_RCFILE:
rcfile = (char *) xmalloc(strlen(optarg)+1);
strcpy(rcfile,optarg);
break;
@@ -260,29 +260,28 @@ struct hostrec *queryctl;
/* squawk if syntax errors were detected */
fputs("usage: fetchmail [options] [server ...]\n", stderr);
fputs(" options\n",stderr);
- fputs(" -2 use POP2 protocol\n", stderr);
- fputs(" -3 use POP3 protocol\n", stderr);
- fputs(" -p, --protocol specify pop2, pop3, imap, apop, or rpop\n",
- stderr);
- fputs(" -V, --version display version info\n", stderr);
- fputs(" -a, --all retrieve old and new messages\n", stderr);
- fputs(" -F, --flush delete old messages from server\n", stderr);
- fputs(" -K, --kill delete new messages after retrieval\n", stderr);
- fputs(" -k, --keep save new messages after retrieval\n", stderr);
- fputs(" -l, --limit retrieve at most n message lines\n", stderr);
- fputs(" -m, --mda set mail user agent to pass to\n", stderr);
- fputs(" -S, --smtphost set SMTP forwarding host\n", stderr);
- fputs(" -q, --quit kill daemon process\n", stderr);
- fputs(" -s, --silent work silently\n", stderr);
- fputs(" -v, --verbose work noisily (diagnostic output)\n", stderr);
- fputs(" -d, --daemon run as a daemon once per n seconds\n", stderr);
- fputs(" -f, --fetchrc specify alternate config file\n", stderr);
- fputs(" -i, --idfile specify alternate ID database\n", stderr);
- fputs(" -u, --username specify server user ID\n", stderr);
- fputs(" -c, --stdout write received mail to stdout\n", stderr);
- fputs(" -o, --local specify filename for received mail\n", stderr);
- fputs(" -r, --remote specify remote folder name\n", stderr);
- fputs(" -L, --logfile specify logfile name\n", stderr);
+ fputs(" -2 use POP2 protocol\n", stderr);
+ fputs(" -3 use POP3 protocol\n", stderr);
+ fputs(" -p, --protocol specify pop2, pop3, imap, apop\n", stderr);
+ fputs(" -V, --version display version info\n", stderr);
+ fputs(" -a, --all retrieve old and new messages\n", stderr);
+ fputs(" -F, --flush delete old messages from server\n", stderr);
+ fputs(" -K, --kill delete new messages after retrieval\n", stderr);
+ fputs(" -k, --keep save new messages after retrieval\n", stderr);
+ fputs(" -l, --limit retrieve at most n message lines\n", stderr);
+ fputs(" -m, --mda set mail user agent to pass to\n", stderr);
+ fputs(" -S, --smtphost set SMTP forwarding host\n", stderr);
+ fputs(" -q, --quit kill daemon process\n", stderr);
+ fputs(" -s, --silent work silently\n", stderr);
+ fputs(" -v, --verbose work noisily (diagnostic output)\n", stderr);
+ fputs(" -d, --daemon run as a daemon once per n seconds\n", stderr);
+ fputs(" -f, --fetchmailrc specify alternate run control file\n", stderr);
+ fputs(" -i, --idfile specify alternate ID database\n", stderr);
+ fputs(" -u, --username specify server user ID\n", stderr);
+ fputs(" -c, --stdout write received mail to stdout\n", stderr);
+ fputs(" -o, --local specify filename for received mail\n", stderr);
+ fputs(" -r, --remote specify remote folder name\n", stderr);
+ fputs(" -L, --logfile specify logfile name\n", stderr);
return(-1);
}
else {
@@ -350,11 +349,11 @@ struct hostrec *queryctl;
(void) sprintf(queryctl->mda, DEF_MDA, queryctl->localname);
rcfile =
- (char *) xmalloc(strlen(home)+strlen(FETCHRC_NAME)+2);
+ (char *) xmalloc(strlen(home)+strlen(RCFILE_NAME)+2);
strcpy(rcfile, home);
strcat(rcfile, "/");
- strcat(rcfile, FETCHRC_NAME);
+ strcat(rcfile, RCFILE_NAME);
idfile =
(char *) xmalloc(strlen(home)+strlen(IDFILE_NAME)+2);