annotate doc/misc/smtpmail.texi @ 110213:bf2aa62d9d6c

imap.el (imap-debug): Removed -- doesn't seem very useful.
author Katsumi Yamaoka <yamaoka@jpl.org>
date Sun, 05 Sep 2010 23:49:02 +0000
parents a91e94388547
children 376148b31b5e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
84316
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1 \input texinfo @c -*-texinfo-*-
84329
3d431f1997d8 (setfilename): Go up one more level to ../../info.
Glenn Morris <rgm@gnu.org>
parents: 84316
diff changeset
2 @setfilename ../../info/smtpmail
84316
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3 @settitle Emacs SMTP Library
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4 @syncodeindex vr fn
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5 @copying
106815
1d1d5d9bd884 Add 2010 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 102059
diff changeset
6 Copyright @copyright{} 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
87903
5d58981e6690 Merge from emacs--rel--22
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
7 Free Software Foundation, Inc.
84316
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9 @quotation
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
10 Permission is granted to copy, distribute and/or modify this document
99709
6de181810d0f Relicense all texi files under FDL 1.3 or later.
Glenn Morris <rgm@gnu.org>
parents: 95937
diff changeset
11 under the terms of the GNU Free Documentation License, Version 1.3 or
84316
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
12 any later version published by the Free Software Foundation; with no
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
13 Invariant Sections, with the Front-Cover texts being ``A GNU Manual'',
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
14 and with the Back-Cover Texts as in (a) below. A copy of the license
95937
6f0fce2c3559 Remove references to external license, since doclicense is included.
Glenn Morris <rgm@gnu.org>
parents: 95874
diff changeset
15 is included in the section entitled ``GNU Free Documentation License''.
84316
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
16
95874
eafbd7a5c9be Update Back-Cover Text as per maintain.info.
Glenn Morris <rgm@gnu.org>
parents: 87903
diff changeset
17 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
eafbd7a5c9be Update Back-Cover Text as per maintain.info.
Glenn Morris <rgm@gnu.org>
parents: 87903
diff changeset
18 modify this GNU manual. Buying copies from the FSF supports it in
eafbd7a5c9be Update Back-Cover Text as per maintain.info.
Glenn Morris <rgm@gnu.org>
parents: 87903
diff changeset
19 developing GNU and promoting software freedom.''
84316
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
20 @end quotation
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
21 @end copying
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
22
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
23 @dircategory Emacs
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
24 @direntry
109274
a91e94388547 Minor doc/misc/*.texi direntry fixes.
Glenn Morris <rgm@gnu.org>
parents: 109270
diff changeset
25 * SMTP: (smtpmail). Emacs library for sending mail via SMTP.
84316
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
26 @end direntry
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
27
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
28 @titlepage
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
29 @title{Emacs SMTP Library}
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
30 @subtitle{An Emacs package for sending mail via SMTP}
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
31 @author{Simon Josefsson, Alex Schroeder}
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
32 @page
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
33 @vskip 0pt plus 1filll
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
34 @insertcopying
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
35 @end titlepage
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
36
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
37 @contents
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
38
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
39 @ifnottex
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
40 @node Top
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
41 @top Emacs SMTP Library
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
42
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
43 @insertcopying
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
44 @end ifnottex
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
45
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
46 @menu
109264
f1266b2f017e Untabify doc/misc/*.texi.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
47 * How Mail Works:: Brief introduction to mail concepts.
84316
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
48 * Emacs Speaks SMTP:: How to use the SMTP library in Emacs.
109264
f1266b2f017e Untabify doc/misc/*.texi.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
49 * Authentication:: Authenticating yourself to the server.
f1266b2f017e Untabify doc/misc/*.texi.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
50 * Queued delivery:: Sending mail without an internet connection.
f1266b2f017e Untabify doc/misc/*.texi.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
51 * Server workarounds:: Mail servers with special requirements.
f1266b2f017e Untabify doc/misc/*.texi.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
52 * Debugging:: Tracking down problems.
84316
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
53 * GNU Free Documentation License:: The license for this documentation.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
54
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
55 Indices
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
56
109264
f1266b2f017e Untabify doc/misc/*.texi.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
57 * Index:: Index over variables and functions.
84316
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
58 @end menu
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
59
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
60 @node How Mail Works
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
61 @chapter How Mail Works
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
62
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
63 @cindex SMTP
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
64 @cindex MTA
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
65 On the internet, mail is sent from mail host to mail host using the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
66 simple mail transfer protocol (SMTP). To send and receive mail, you
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
67 must get it from and send it to a mail host. Every mail host runs a
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
68 mail transfer agent (MTA) such as Exim that accepts mails and passes
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
69 them on. The communication between a mail host and other clients does
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
70 not necessarily involve SMTP, however. Here is short overview of what
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
71 is involved.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
72
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
73 @cindex MUA
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
74 The mail program --- also called a mail user agent (MUA) ---
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
75 usually sends outgoing mail to a mail host. When your computer is
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
76 permanently connected to the internet, it might even be a mail host
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
77 itself. In this case, the MUA will pipe mail to the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
78 @file{/usr/lib/sendmail} application. It will take care of your mail
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
79 and pass it on to the next mail host.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
80
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
81 @cindex ISP
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
82 When you are only connected to the internet from time to time, your
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
83 internet service provider (ISP) has probably told you which mail host
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
84 to use. You must configure your MUA to use that mail host. Since you
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
85 are reading this manual, you probably want to configure Emacs to use
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
86 SMTP to send mail to that mail host. More on that in the next
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
87 section.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
88
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
89 @cindex MDA
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
90 Things are different when reading mail. The mail host responsible
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
91 for your mail keeps it in a file somewhere. The messages get into the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
92 file by way of a mail delivery agent (MDA) such as procmail. These
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
93 delivery agents often allow you to filter and munge your mails before
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
94 you get to see it. When your computer is that mail host, this file is
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
95 called a spool, and sometimes located in the directory
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
96 @file{/var/spool/mail/}. All your MUA has to do is read mail from the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
97 spool, then.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
98
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
99 @cindex POP3
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
100 @cindex IMAP
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
101 When your computer is not always connected to the internet, you
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
102 must get the mail from the remote mail host using a protocol such as
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
103 POP3 or IMAP. POP3 essentially downloads all your mail from the mail
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
104 host to your computer. The mail is stored in some file on your
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
105 computer, and again, all your MUA has to do is read mail from the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
106 spool.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
107
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
108 When you read mail from various machines, downloading mail from the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
109 mail host to your current machine is not convenient. In that case,
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
110 you will probably want to use the IMAP protocol. Your mail is kept on
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
111 the mail host, and you can read it while you are connected via IMAP to
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
112 the mail host.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
113
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
114 @cindex Webmail
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
115 So how does reading mail via the web work, you ask. In that case,
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
116 the web interface just allows you to remote-control a MUA on the web
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
117 host. Whether the web host is also a mail host, and how all the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
118 pieces interact is completely irrelevant. You usually cannot use
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
119 Emacs to read mail via the web, unless you use software that parses
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
120 the ever-changing HTML of the web interface.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
121
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
122 @node Emacs Speaks SMTP
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
123 @chapter Emacs Speaks SMTP
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
124
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
125 Emacs includes a package for sending your mail to a SMTP server and
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
126 have it take care of delivering it to the final destination, rather
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
127 than letting the MTA on your local system take care of it. This can
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
128 be useful if you don't have a MTA set up on your host, or if your
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
129 machine is often disconnected from the internet.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
130
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
131 Sending mail via SMTP requires configuring your mail user agent
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
132 (@pxref{Mail Methods,,,emacs}) to use the SMTP library. How to do
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
133 this should be described for each mail user agent; for the default
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
134 mail user agent the variable @code{send-mail-function} (@pxref{Mail
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
135 Sending,,,emacs}) is used; for the Message and Gnus user agents the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
136 variable @code{message-send-mail-function} (@pxref{Mail
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
137 Variables,,,message}) is used.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
138
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
139 @example
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
140 ;; If you use the default mail user agent.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
141 (setq send-mail-function 'smtpmail-send-it)
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
142 ;; If you use Message or Gnus.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
143 (setq message-send-mail-function 'smtpmail-send-it)
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
144 @end example
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
145
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
146 Before using SMTP you must find out the hostname of the SMTP server
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
147 to use. Your system administrator should provide you with this
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
148 information, but often it is the same as the server you receive mail
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
149 from.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
150
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
151 @table @code
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
152 @item smtpmail-smtp-server
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
153 @vindex smtpmail-smtp-server
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
154 @vindex SMTPSERVER
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
155 The variable @code{smtpmail-smtp-server} controls the hostname of
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
156 the server to use. It is a string with an IP address or hostname. It
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
157 defaults to the contents of the @env{SMTPSERVER} environment
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
158 variable, or, if empty, the contents of
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
159 @code{smtpmail-default-smtp-server}.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
160
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
161 @item smtpmail-default-smtp-server
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
162 @vindex smtpmail-default-smtp-server
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
163 The variable @code{smtpmail-default-smtp-server} controls the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
164 default hostname of the server to use. It is a string with an IP
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
165 address or hostname. It must be set before the SMTP library is
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
166 loaded. It has no effect if set after the SMTP library has been
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
167 loaded, or if @code{smtpmail-smtp-server} is defined. It is usually
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
168 set by system administrators in a site wide initialization file.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
169 @end table
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
170
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
171 The following example illustrates what you could put in
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
172 @file{~/.emacs} to set the SMTP server name.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
173
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
174 @example
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
175 ;; Send mail using SMTP via mail.example.org.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
176 (setq smtpmail-smtp-server "mail.example.org")
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
177 @end example
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
178
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
179 @cindex Mail Submission
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
180 SMTP is normally used on the registered ``smtp'' TCP service port 25.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
181 Some environments use SMTP in ``Mail Submission'' mode, which uses
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
182 port 587. Using other ports is not uncommon, either for security by
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
183 obscurity purposes, port forwarding, or otherwise.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
184
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
185 @table @code
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
186 @item smtpmail-smtp-service
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
187 @vindex smtpmail-smtp-service
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
188 The variable @code{smtpmail-smtp-service} controls the port on the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
189 server to contact. It is either a string, in which case it will be
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
190 translated into an integer using system calls, or an integer.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
191 @end table
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
192
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
193 The following example illustrates what you could put in
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
194 @file{~/.emacs} to set the SMTP service port.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
195
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
196 @example
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
197 ;; Send mail using SMTP on the mail submission port 587.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
198 (setq smtpmail-smtp-service 587)
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
199 @end example
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
200
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
201 @node Authentication
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
202 @chapter Authentication
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
203
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
204 @cindex SASL
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
205 @cindex CRAM-MD5
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
206 @cindex LOGIN
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
207 @cindex STARTTLS
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
208 @cindex TLS
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
209 @cindex SSL
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
210 Many environments require SMTP clients to authenticate themselves
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
211 before they are allowed to route mail via a server. The two following
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
212 variables contains the authentication information needed for this.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
213
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
214 The first variable, @code{smtpmail-auth-credentials}, instructs the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
215 SMTP library to use a SASL authentication step, currently only the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
216 CRAM-MD5 and LOGIN mechanisms are supported and will be selected in
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
217 that order if the server support both.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
218
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
219 The second variable, @code{smtpmail-starttls-credentials}, instructs
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
220 the SMTP library to connect to the server using STARTTLS. This means
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
221 the protocol exchange may be integrity protected and confidential by
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
222 using the Transport Layer Security (TLS) protocol, and optionally also
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
223 authentication of the client and server.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
224
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
225 TLS is a security protocol that is also known as SSL, although
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
226 strictly speaking, SSL is an older variant of TLS. TLS is backwards
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
227 compatible with SSL. In most mundane situations, the two terms are
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
228 equivalent.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
229
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
230 The TLS feature uses the elisp package @file{starttls.el} (see it for
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
231 more information on customization), which in turn require that at
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
232 least one of the following external tools are installed:
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
233
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
234 @enumerate
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
235 @item
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
236 The GNUTLS command line tool @samp{gnutls-cli}, you can get it from
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
237 @url{http://www.gnu.org/software/gnutls/}. This is the recommended
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
238 tool, mainly because it can verify the server certificates.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
239
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
240 @item
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
241 The @samp{starttls} external program, you can get it from
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
242 @file{starttls-*.tar.gz} from @uref{ftp://ftp.opaopa.org/pub/elisp/}.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
243 @end enumerate
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
244
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
245 It is not uncommon to use both these mechanisms, e.g., to use STARTTLS
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
246 to achieve integrity and confidentiality and then use SASL for client
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
247 authentication.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
248
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
249 @table @code
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
250 @item smtpmail-auth-credentials
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
251 @vindex smtpmail-auth-credentials
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
252 The variable @code{smtpmail-auth-credentials} contains a list of
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
253 hostname, port, username and password tuples. When the SMTP library
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
254 connects to a host on a certain port, this variable is searched to
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
255 find a matching entry for that hostname and port. If an entry is
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
256 found, the authentication process is invoked and the credentials are
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
257 used.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
258
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
259 The hostname field follows the same format as
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
260 @code{smtpmail-smtp-server} (i.e., a string) and the port field the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
261 same format as @code{smtpmail-smtp-service} (i.e., a string or an
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
262 integer). The username and password fields, which either can be
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
263 @code{nil} to indicate that the user is prompted for the value
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
264 interactively, should be strings with the username and password,
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
265 respectively, information that is normally provided by system
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
266 administrators.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
267
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
268 @item smtpmail-starttls-credentials
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
269 @vindex smtpmail-starttls-credentials
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
270 The variable @code{smtpmail-starttls-credentials} contains a list of
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
271 tuples with hostname, port, name of file containing client key, and
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
272 name of file containing client certificate. The processing is similar
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
273 to the previous variable. The client key and certificate may be
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
274 @code{nil} if you do not wish to use client authentication.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
275 @end table
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
276
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
277 The following example illustrates what you could put in
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
278 @file{~/.emacs} to enable both SASL authentication and STARTTLS. The
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
279 server name (@code{smtpmail-smtp-server}) is @var{hostname}, the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
280 server port (@code{smtpmail-smtp-service}) is @var{port}, and the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
281 username and password are @var{username} and @var{password}
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
282 respectively.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
283
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
284 @example
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
285 ;; Authenticate using this username and password against my server.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
286 (setq smtpmail-auth-credentials
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
287 '(("@var{hostname}" "@var{port}" "@var{username}" "@var{password}")))
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
288
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
289 ;; Note that if @var{port} is an integer, you must not quote it as a
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
290 ;; string. Normally @var{port} should be the integer 25, and the example
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
291 ;; become:
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
292 (setq smtpmail-auth-credentials
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
293 '(("@var{hostname}" 25 "@var{username}" "@var{password}")))
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
294
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
295 ;; Use STARTTLS without authentication against the server.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
296 (setq smtpmail-starttls-credentials
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
297 '(("@var{hostname}" "@var{port}" nil nil)))
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
298 @end example
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
299
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
300 @node Queued delivery
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
301 @chapter Queued delivery
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
302
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
303 @cindex Dialup connection
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
304 If you connect to the internet via a dialup connection, or for some
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
305 other reason don't have permanent internet connection, sending mail
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
306 will fail when you are not connected. The SMTP library implements
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
307 queued delivery, and the following variable control its behavior.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
308
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
309 @table @code
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
310 @item smtpmail-queue-mail
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
311 @vindex smtpmail-queue-mail
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
312 The variable @code{smtpmail-queue-mail} controls whether a simple
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
313 off line mail sender is active. This variable is a boolean, and
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
314 defaults to @code{nil} (disabled). If this is non-@code{nil}, mail is
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
315 not sent immediately but rather queued in the directory
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
316 @code{smtpmail-queue-dir} and can be later sent manually by invoking
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
317 @code{smtpmail-send-queued-mail} (typically when you connect to the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
318 internet).
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
319
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
320 @item smtpmail-queue-dir
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
321 @vindex smtpmail-queue-dir
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
322 The variable @code{smtpmail-queue-dir} specifies the name of the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
323 directory to hold queued messages. It defaults to
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
324 @file{~/Mail/queued-mail/}.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
325 @end table
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
326
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
327 @findex smtpmail-send-queued-mail
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
328 The function @code{smtpmail-send-queued-mail} can be used to send
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
329 any queued mail when @code{smtpmail-queue-mail} is enabled. It is
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
330 typically invoked interactively with @kbd{M-x
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
331 smtpmail-send-queued-mail RET} when you are connected to the internet.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
332
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
333 @node Server workarounds
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
334 @chapter Server workarounds
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
335
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
336 Some SMTP servers have special requirements. The following variables
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
337 implement support for common requirements.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
338
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
339 @table @code
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
340
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
341 @item smtpmail-local-domain
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
342 @vindex smtpmail-local-domain
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
343 The variable @code{smtpmail-local-domain} controls the hostname sent
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
344 in the first @code{EHLO} or @code{HELO} command sent to the server.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
345 It should only be set if the @code{system-name} function returns a
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
346 name that isn't accepted by the server. Do not set this variable
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
347 unless your server complains.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
348
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
349 @item smtpmail-sendto-domain
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
350 @vindex smtpmail-sendto-domain
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
351 The variable @code{smtpmail-sendto-domain} makes the SMTP library
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
352 add @samp{@@} and the specified value to recipients specified in the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
353 message when they are sent using the @code{RCPT TO} command. Some
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
354 configurations of sendmail requires this behavior. Don't bother to
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
355 set this unless you have get an error like:
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
356
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
357 @example
109270
a7253b87aad9 Remove remaining tabs from non-verbatim in doc/misc/*.texi.
Glenn Morris <rgm@gnu.org>
parents: 109264
diff changeset
358 Sending failed; SMTP protocol error
84316
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
359 @end example
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
360
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
361 when sending mail, and the debug buffer (@pxref{Debugging})) contains
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
362 an error such as:
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
363
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
364 @example
109270
a7253b87aad9 Remove remaining tabs from non-verbatim in doc/misc/*.texi.
Glenn Morris <rgm@gnu.org>
parents: 109264
diff changeset
365 RCPT TO: @var{someone}
a7253b87aad9 Remove remaining tabs from non-verbatim in doc/misc/*.texi.
Glenn Morris <rgm@gnu.org>
parents: 109264
diff changeset
366 501 @var{someone}: recipient address must contain a domain
84316
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
367 @end example
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
368
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
369 @end table
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
370
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
371
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
372 @node Debugging
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
373 @chapter Debugging
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
374
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
375 Sometimes delivery fails, often with the generic error message
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
376 @samp{Sending failed; SMTP protocol error}. Enabling one or both of
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
377 the following variables and inspecting a trace buffer will often give
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
378 clues to the reason for the error.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
379
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
380 @table @code
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
381
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
382 @item smtpmail-debug-info
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
383 @vindex smtpmail-debug-info
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
384 The variable @code{smtpmail-debug-info} controls whether to print
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
385 the SMTP protocol exchange in the minibuffer, and retain the entire
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
386 exchange in a buffer @samp{*trace of SMTP session to @var{server}*},
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
387 where @var{server} is the name of the mail server to which you send
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
388 mail.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
389
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
390 @item smtpmail-debug-verb
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
391 @vindex smtpmail-debug-verb
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
392 The variable @code{smtpmail-debug-verb} controls whether to send the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
393 @code{VERB} token to the server. The @code{VERB} server instructs the
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
394 server to be more verbose, and often also to attempt final delivery
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
395 while your SMTP session is still running. It is usually only useful
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
396 together with @code{smtpmail-debug-info}. Note that this may cause
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
397 mail delivery to take considerable time if the final destination
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
398 cannot accept mail.
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
399
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
400 @end table
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
401
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
402 @node GNU Free Documentation License
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
403 @chapter GNU Free Documentation License
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
404 @include doclicense.texi
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
405
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
406 @node Index
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
407 @chapter Index
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
408
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
409 @section Concept Index
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
410
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
411 @printindex cp
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
412
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
413 @section Function and Variable Index
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
414
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
415 @printindex fn
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
416
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
417 @bye
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
418
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
419 @ignore
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
420 arch-tag: 6316abdf-b366-4562-87a2-f37e8f894b6f
cd349e2703f1 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
421 @end ignore