delivery. This option does not work with ETRN and ODMR.
.TP
.B \-\-limitflush
-POP3/IMAP only. Delete oversized messages from the
+POP3/IMAP only, since version 6.3.0. Delete oversized messages from the
mailserver before retrieving new messages. The size limit should be
separately sepecified with the --limit option. This option does not
work with ETRN or ODMR.
.TP
.B \-\-service <servicename>
-(Keyword: service)
+(Keyword: service) Since version 6.3.0.
The service option permits you to specify a service name to connect to.
You can specify a decimal port number here, if your services database
-lacks the required service-port assignments. See the FAQ item R12 for
-details. This replaces the older \-\-port option.
+lacks the required service-port assignments. See the FAQ item R12 and
+the \-\-ssl documentation for details. This replaces the older \-\-port
+option.
.TP
.B \-P <portnumber> | \-\-port <portnumber>
(Keyword: port)
the encrypted variant.
.sp
If your system lacks the corresponding entries from /etc/services, see
-the \-\-port option.
+the \-\-service option and specify the numeric port number as given in
+the previous paragraph (unless your ISP had directed you to different
+ports, which is uncommon however).
.TP
.B \-\-sslcert <name>
(Keyword: sslcert)
AUTHENTICATION below for details). The possible values are \fBany\fR,
\&\fBpassword\fR, \fBkerberos_v5\fR, \fBkerberos\fR (or, for
excruciating exactness, \fBkerberos_v4\fR), \fBgssapi\fR,
-\fBcram-md5\fR, \fBotp\fR, \fBntlm\fR, \fBmsn\fR and \fBssh\fR. When
-\fBany\fR (the default) is specified, fetchmail tries first methods that
-don't require a password (GSSAPI, KERBEROS\ IV, KERBEROS\ 5); then it
-looks for methods that mask your password (CRAM-MD5, X-OTP - note that
-NTLM and MSN are not autoprobed); and only if the
-server doesn't support any of those will it ship your password en clair.
-Other values may be used to force various authentication methods
+\fBcram-md5\fR, \fBotp\fR, \fBntlm\fR, \fBmsn\fR (only for POP3) and
+\fBssh\fR. When \fBany\fR (the default) is specified, fetchmail tries
+first methods that don't require a password (GSSAPI, KERBEROS\ IV,
+KERBEROS\ 5); then it looks for methods that mask your password
+(CRAM-MD5, X-OTP - note that NTLM and MSN are not autoprobed for POP3
+and MSN is only supported for POP3); and only if the server doesn't
+support any of those will it ship your password en clair. Other values
+may be used to force various authentication methods
(\fBssh\fR suppresses authentication). Any value other than
\&\fBpassword\fR, \fBcram-md5\fR, \fBntlm\fR, \fBmsn\fR or \fBotp\fR
suppresses fetchmail's normal inquiry for a password. Specify \fBssh\fR
editor like
.IR fetchmailconf ,
written in Python.
+.SS Removed Options
+.TP
+.B -T | --netsec
+Removed before version 6.3.0, the required underlying inet6_apps library
+had been discontinued and is no longer available.
.SH USER AUTHENTICATION AND ENCRYPTION
All modes except ETRN require authentication of the client to the server.
authentication or multiple timeouts.
.PP
The option
-.B --quit
+.B \-\-quit
will kill a running daemon process instead of waking it up (if there
-is no such process,
-.I fetchmail
-notifies you). If the --quit option is the only command-line option,
-that's all there is to it.
-.PP
-The quit option may also be mixed with other command-line options; its
-effect is to kill any running daemon before doing what the other
-options specify in combination with the fetchmailrc file.
+is no such process, \fIfetchmail\fP will notify you.
+If the \-\-quit option appears last on the command line, \fIfetchmail\fP
+will kill the running daemon process and then quit. Otherwise,
+\fIfetchmail\fP will first kill a running daemon process and then
+continue running with the other options.
.PP
The
.B \-L <filename>
.PP
The
.B \-N
-or --nodetach option suppresses backgrounding and detachment of the
+or
+.B --nodetach
+option suppresses backgrounding and detachment of the
daemon process from its control terminal. This is useful
for debugging or when fetchmail runs as the child of a supervisor
process such as
.fi
.sp
.PP
-Legal authentication types are 'any', 'password', 'kerberos', 'kerberos_v5'
-and 'gssapi', 'cram-md5', 'otp', 'ntlm', 'ssh'.
-The 'password' type specifies authentication by normal transmission of a
-password (the password may be plain text or subject to
-protocol-specific encryption as in APOP); 'kerberos' tells
-\fIfetchmail\fR to try to get a Kerberos ticket at the start of each
-query instead, and send an arbitrary string as the password; and
-\&'gssapi' tells fetchmail to use GSSAPI authentication. See the description
-of the 'auth' keyword for more.
+Legal authentication types are 'any', 'password', 'kerberos',
+\&'kerberos_v4', 'kerberos_v5' and 'gssapi', 'cram-md5', 'otp', 'msn'
+(only for POP3), 'ntlm', 'ssh'. The 'password' type specifies
+authentication by normal transmission of a password (the password may be
+plain text or subject to protocol-specific encryption as in APOP);
+\&'kerberos' tells \fIfetchmail\fR to try to get a Kerberos ticket at the
+start of each query instead, and send an arbitrary string as the
+password; and 'gssapi' tells fetchmail to use GSSAPI authentication.
+See the description of the 'auth' keyword for more.
.PP
Specifying 'kpop' sets POP3 protocol over port 1109 with Kerberos V4
authentication. These defaults may be overridden by later options.
projects / ~andy / fetchmail / blobdiff