annotate man/smtpmail.texi @ 62897:6181dbed8947

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