(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
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.