annotate man/smtpmail.texi @ 84154:b1b8da4e0ccd

Move to ../doc/emacs/, misc/
author Glenn Morris <rgm@gnu.org>
date Thu, 06 Sep 2007 04:36:26 +0000
parents 88224dc74061
children 02b9a9aa5b0c e6fdae9180d4
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
75348
3d45362f1d38 Add 2007 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 72807
diff changeset
6 Copyright @copyright{} 2003, 2004, 2005, 2006, 2007 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
65555
69b3598a61c5 Update all manuals to specify GFDL version 1.2.
Romain Francoise <romain@orebokech.com>
parents: 64890
diff changeset
10 under the terms of the GNU Free Documentation License, Version 1.2 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.
77235
88224dc74061 Include GFDL.
Chong Yidong <cyd@stupidchicken.com>
parents: 75348
diff changeset
58 * GNU Free Documentation License:: The license for this documentation.
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
59
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
60 Indices
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
61
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
62 * Index:: Index over variables and functions.
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
63 @end menu
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
64
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
65 @node How Mail Works
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
66 @chapter How Mail Works
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
67
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
68 @cindex SMTP
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
69 @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
70 On the internet, mail is sent from mail host to mail host using the
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
71 simple mail transfer protocol (SMTP). To send and receive mail, you
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
72 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
73 mail transfer agent (MTA) such as Exim that accepts mails and passes
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
74 them on. The communication between a mail host and other clients does
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
75 not necessarily involve SMTP, however. Here is short overview of what
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
76 is involved.
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
77
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
78 @cindex MUA
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
79 The mail program --- also called a mail user agent (MUA) ---
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
80 usually sends outgoing mail to a mail host. When your computer is
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
81 permanently connected to the internet, it might even be a mail host
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
82 itself. In this case, the MUA will pipe mail to the
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
83 @file{/usr/lib/sendmail} application. It will take care of your mail
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
84 and pass it on to the next mail host.
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
85
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
86 @cindex ISP
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
87 When you are only connected to the internet from time to time, your
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
88 internet service provider (ISP) has probably told you which mail host
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
89 to use. You must configure your MUA to use that mail host. Since you
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
90 are reading this manual, you probably want to configure Emacs to use
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
91 SMTP to send mail to that mail host. More on that in the next
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
92 section.
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
93
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
94 @cindex MDA
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
95 Things are different when reading mail. The mail host responsible
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
96 for your mail keeps it in a file somewhere. The messages get into the
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
97 file by way of a mail delivery agent (MDA) such as procmail. These
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
98 delivery agents often allow you to filter and munge your mails before
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
99 you get to see it. When your computer is that mail host, this file is
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
100 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
101 @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
102 spool, then.
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
103
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
104 @cindex POP3
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
105 @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
106 When your computer is not always connected to the internet, you
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
107 must get the mail from the remote mail host using a protocol such as
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
108 POP3 or IMAP. POP3 essentially downloads all your mail from the mail
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
109 host to your computer. The mail is stored in some file on your
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
110 computer, and again, all your MUA has to do is read mail from the
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
111 spool.
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
112
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
113 When you read mail from various machines, downloading mail from the
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
114 mail host to your current machine is not convenient. In that case,
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
115 you will probably want to use the IMAP protocol. Your mail is kept on
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
116 the mail host, and you can read it while you are connected via IMAP to
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
117 the mail host.
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
118
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
119 @cindex Webmail
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
120 So how does reading mail via the web work, you ask. In that case,
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
121 the web interface just allows you to remote-control a MUA on the web
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
122 host. Whether the web host is also a mail host, and how all the
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
123 pieces interact is completely irrelevant. You usually cannot use
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
124 Emacs to read mail via the web, unless you use software that parses
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
125 the ever-changing HTML of the web interface.
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
126
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
127 @node Emacs Speaks SMTP
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
128 @chapter Emacs Speaks SMTP
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
129
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
130 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
131 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
132 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
133 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
134 machine is often disconnected from the internet.
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
135
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
136 Sending mail via SMTP requires configuring your mail user agent
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
137 (@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
138 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
139 mail user agent the variable @code{send-mail-function} (@pxref{Mail
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
140 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
141 variable @code{message-send-mail-function} (@pxref{Mail
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
142 Variables,,,message}) is used.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
143
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
144 @example
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
145 ;; If you use the default mail user agent.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
146 (setq send-mail-function 'smtpmail-send-it)
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
147 ;; If you use Message or Gnus.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
148 (setq message-send-mail-function 'smtpmail-send-it)
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
149 @end example
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
150
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
151 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
152 to use. Your system administrator should provide you with this
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
153 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
154 from.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
155
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
156 @table @code
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
157 @item smtpmail-smtp-server
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
158 @vindex smtpmail-smtp-server
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
159 @vindex SMTPSERVER
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
160 The variable @code{smtpmail-smtp-server} controls the hostname of
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
161 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
162 defaults to the contents of the @env{SMTPSERVER} environment
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
163 variable, or, if empty, the contents of
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
164 @code{smtpmail-default-smtp-server}.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
165
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
166 @item smtpmail-default-smtp-server
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
167 @vindex smtpmail-default-smtp-server
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
168 The variable @code{smtpmail-default-smtp-server} controls the
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
169 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
170 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
171 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
172 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
173 set by system administrators in a site wide initialization file.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
174 @end table
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
175
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
176 The following example illustrates what you could put in
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
177 @file{~/.emacs} to set the SMTP server name.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
178
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
179 @example
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
180 ;; Send mail using SMTP via mail.example.org.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
181 (setq smtpmail-smtp-server "mail.example.org")
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
182 @end example
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
183
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
184 @cindex Mail Submission
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
185 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
186 Some environments use SMTP in ``Mail Submission'' mode, which uses
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
187 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
188 obscurity purposes, port forwarding, or otherwise.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
189
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
190 @table @code
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
191 @item smtpmail-smtp-service
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
192 @vindex smtpmail-smtp-service
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
193 The variable @code{smtpmail-smtp-service} controls the port on the
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
194 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
195 translated into an integer using system calls, or an integer.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
196 @end table
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
197
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
198 The following example illustrates what you could put in
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
199 @file{~/.emacs} to set the SMTP service port.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
200
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
201 @example
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
202 ;; Send mail using SMTP on the mail submission port 587.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
203 (setq smtpmail-smtp-service 587)
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
204 @end example
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
205
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
206 @node Authentication
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
207 @chapter Authentication
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
208
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
209 @cindex SASL
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
210 @cindex CRAM-MD5
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
211 @cindex LOGIN
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
212 @cindex STARTTLS
72672
886b4823edf4 2006-09-06 Simon Josefsson <jas@extundo.com>
Simon Josefsson <jas@extundo.com>
parents: 68639
diff changeset
213 @cindex TLS
886b4823edf4 2006-09-06 Simon Josefsson <jas@extundo.com>
Simon Josefsson <jas@extundo.com>
parents: 68639
diff changeset
214 @cindex SSL
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
215 Many environments require SMTP clients to authenticate themselves
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
216 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
217 variables contains the authentication information needed for this.
72807
155c26718860 * smtpmail.texi (Authentication): Explain TLS and SSL better, based on
Simon Josefsson <jas@extundo.com>
parents: 72672
diff changeset
218
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
219 The first variable, @code{smtpmail-auth-credentials}, instructs the
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
220 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
221 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
222 that order if the server support both.
310e8ba0a51e smtpmail.texi (Authentication): Improve STARTTLS discussion.
Simon Josefsson <jas@extundo.com>
parents: 54201
diff changeset
223
310e8ba0a51e smtpmail.texi (Authentication): Improve STARTTLS discussion.
Simon Josefsson <jas@extundo.com>
parents: 54201
diff changeset
224 The second variable, @code{smtpmail-starttls-credentials}, instructs
310e8ba0a51e smtpmail.texi (Authentication): Improve STARTTLS discussion.
Simon Josefsson <jas@extundo.com>
parents: 54201
diff changeset
225 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
226 the protocol exchange may be integrity protected and confidential by
72807
155c26718860 * smtpmail.texi (Authentication): Explain TLS and SSL better, based on
Simon Josefsson <jas@extundo.com>
parents: 72672
diff changeset
227 using the Transport Layer Security (TLS) protocol, and optionally also
155c26718860 * smtpmail.texi (Authentication): Explain TLS and SSL better, based on
Simon Josefsson <jas@extundo.com>
parents: 72672
diff changeset
228 authentication of the client and server.
155c26718860 * smtpmail.texi (Authentication): Explain TLS and SSL better, based on
Simon Josefsson <jas@extundo.com>
parents: 72672
diff changeset
229
155c26718860 * smtpmail.texi (Authentication): Explain TLS and SSL better, based on
Simon Josefsson <jas@extundo.com>
parents: 72672
diff changeset
230 TLS is a security protocol that is also known as SSL, although
155c26718860 * smtpmail.texi (Authentication): Explain TLS and SSL better, based on
Simon Josefsson <jas@extundo.com>
parents: 72672
diff changeset
231 strictly speaking, SSL is an older variant of TLS. TLS is backwards
155c26718860 * smtpmail.texi (Authentication): Explain TLS and SSL better, based on
Simon Josefsson <jas@extundo.com>
parents: 72672
diff changeset
232 compatible with SSL. In most mundane situations, the two terms are
155c26718860 * smtpmail.texi (Authentication): Explain TLS and SSL better, based on
Simon Josefsson <jas@extundo.com>
parents: 72672
diff changeset
233 equivalent.
155c26718860 * smtpmail.texi (Authentication): Explain TLS and SSL better, based on
Simon Josefsson <jas@extundo.com>
parents: 72672
diff changeset
234
155c26718860 * smtpmail.texi (Authentication): Explain TLS and SSL better, based on
Simon Josefsson <jas@extundo.com>
parents: 72672
diff changeset
235 The TLS feature uses the elisp package @file{starttls.el} (see it for
155c26718860 * smtpmail.texi (Authentication): Explain TLS and SSL better, based on
Simon Josefsson <jas@extundo.com>
parents: 72672
diff changeset
236 more information on customization), which in turn require that at
155c26718860 * smtpmail.texi (Authentication): Explain TLS and SSL better, based on
Simon Josefsson <jas@extundo.com>
parents: 72672
diff changeset
237 least one of the following external tools are installed:
55785
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 @enumerate
310e8ba0a51e smtpmail.texi (Authentication): Improve STARTTLS discussion.
Simon Josefsson <jas@extundo.com>
parents: 54201
diff changeset
240 @item
310e8ba0a51e smtpmail.texi (Authentication): Improve STARTTLS discussion.
Simon Josefsson <jas@extundo.com>
parents: 54201
diff changeset
241 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
242 @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
243 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
244
310e8ba0a51e smtpmail.texi (Authentication): Improve STARTTLS discussion.
Simon Josefsson <jas@extundo.com>
parents: 54201
diff changeset
245 @item
310e8ba0a51e smtpmail.texi (Authentication): Improve STARTTLS discussion.
Simon Josefsson <jas@extundo.com>
parents: 54201
diff changeset
246 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
247 @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
248 @end enumerate
310e8ba0a51e smtpmail.texi (Authentication): Improve STARTTLS discussion.
Simon Josefsson <jas@extundo.com>
parents: 54201
diff changeset
249
310e8ba0a51e smtpmail.texi (Authentication): Improve STARTTLS discussion.
Simon Josefsson <jas@extundo.com>
parents: 54201
diff changeset
250 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
251 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
252 authentication.
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
253
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
254 @table @code
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
255 @item smtpmail-auth-credentials
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
256 @vindex smtpmail-auth-credentials
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
257 The variable @code{smtpmail-auth-credentials} contains a list of
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
258 hostname, port, username and password tuples. When the SMTP library
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
259 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
260 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
261 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
262 used.
310e8ba0a51e smtpmail.texi (Authentication): Improve STARTTLS discussion.
Simon Josefsson <jas@extundo.com>
parents: 54201
diff changeset
263
310e8ba0a51e smtpmail.texi (Authentication): Improve STARTTLS discussion.
Simon Josefsson <jas@extundo.com>
parents: 54201
diff changeset
264 The hostname field follows the same format as
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
265 @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
266 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
267 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
268 @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
269 interactively, should be strings with the username and password,
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
270 respectively, information that is normally provided by system
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
271 administrators.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
272
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
273 @item smtpmail-starttls-credentials
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
274 @vindex smtpmail-starttls-credentials
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
275 The variable @code{smtpmail-starttls-credentials} contains a list of
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
276 tuples with hostname, port, name of file containing client key, and
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
277 name of file containing client certificate. The processing is similar
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
278 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
279 @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
280 @end table
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
281
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
282 The following example illustrates what you could put in
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
283 @file{~/.emacs} to enable both SASL authentication and STARTTLS. The
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
284 server name (@code{smtpmail-smtp-server}) is @var{hostname}, the
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
285 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
286 username and password are @var{username} and @var{password}
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
287 respectively.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
288
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
289 @example
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
290 ;; Authenticate using this username and password against my server.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
291 (setq smtpmail-auth-credentials
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
292 '(("@var{hostname}" "@var{port}" "@var{username}" "@var{password}")))
57059
Simon Josefsson <jas@extundo.com>
parents: 55785
diff changeset
293
Simon Josefsson <jas@extundo.com>
parents: 55785
diff changeset
294 ;; Note that if @var{port} is an integer, you must not quote it as a
Simon Josefsson <jas@extundo.com>
parents: 55785
diff changeset
295 ;; string. Normally @var{port} should be the integer 25, and the example
Simon Josefsson <jas@extundo.com>
parents: 55785
diff changeset
296 ;; become:
Simon Josefsson <jas@extundo.com>
parents: 55785
diff changeset
297 (setq smtpmail-auth-credentials
Simon Josefsson <jas@extundo.com>
parents: 55785
diff changeset
298 '(("@var{hostname}" 25 "@var{username}" "@var{password}")))
Simon Josefsson <jas@extundo.com>
parents: 55785
diff changeset
299
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
300 ;; Use STARTTLS without authentication against the server.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
301 (setq smtpmail-starttls-credentials
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
302 '(("@var{hostname}" "@var{port}" nil nil)))
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
303 @end example
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
304
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
305 @node Queued delivery
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
306 @chapter Queued delivery
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
307
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
308 @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
309 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
310 other reason don't have permanent internet connection, sending mail
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
311 will fail when you are not connected. The SMTP library implements
63600
c8b57e4594b8 Fix spellings.
Juanma Barranquero <lekktu@gmail.com>
parents: 57059
diff changeset
312 queued delivery, and the following variable control its behavior.
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
313
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
314 @table @code
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
315 @item smtpmail-queue-mail
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
316 @vindex smtpmail-queue-mail
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
317 The variable @code{smtpmail-queue-mail} controls whether a simple
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
318 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
319 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
320 not sent immediately but rather queued in the directory
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
321 @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
322 @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
323 internet).
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
324
52071
25d8603103b7 Fix typos and mark-up (from Jesper Harder <harder@ifa.au.dk>).
Juanma Barranquero <lekktu@gmail.com>
parents: 50669
diff changeset
325 @item smtpmail-queue-dir
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
326 @vindex smtpmail-queue-dir
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
327 The variable @code{smtpmail-queue-dir} specifies the name of the
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
328 directory to hold queued messages. It defaults to
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
329 @file{~/Mail/queued-mail/}.
49938
Simon Josefsson <jas@extundo.com>
parents: 49937
diff changeset
330 @end table
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
331
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
332 @findex smtpmail-send-queued-mail
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
333 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
334 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
335 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
336 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
337
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
338 @node Server workarounds
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
339 @chapter Server workarounds
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
340
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
341 Some SMTP servers have special requirements. The following variables
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
342 implement support for common requirements.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
343
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
344 @table @code
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
345
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
346 @item smtpmail-local-domain
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
347 @vindex smtpmail-local-domain
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
348 The variable @code{smtpmail-local-domain} controls the hostname sent
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
349 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
350 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
351 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
352 unless your server complains.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
353
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
354 @item smtpmail-sendto-domain
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
355 @vindex smtpmail-sendto-domain
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
356 The variable @code{smtpmail-sendto-domain} makes the SMTP library
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
357 add @samp{@@} and the specified value to recipients specified in the
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
358 message when they are sent using the @code{RCPT TO} command. Some
63600
c8b57e4594b8 Fix spellings.
Juanma Barranquero <lekktu@gmail.com>
parents: 57059
diff changeset
359 configurations of sendmail requires this behavior. Don't bother to
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
360 set this unless you have get an error like:
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
361
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
362 @example
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
363 Sending failed; SMTP protocol error
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
364 @end example
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 when sending mail, and the debug buffer (@pxref{Debugging})) contains
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
367 an error such as:
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 @example
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
370 RCPT TO: @var{someone}
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
371 501 @var{someone}: recipient address must contain a domain
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
372 @end example
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 @end table
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
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
377 @node Debugging
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
378 @chapter Debugging
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
379
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
380 Sometimes delivery fails, often with the generic error message
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
381 @samp{Sending failed; SMTP protocol error}. Enabling one or both of
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
382 the following variables and inspecting a trace buffer will often give
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
383 clues to the reason for the error.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
384
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
385 @table @code
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
386
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
387 @item smtpmail-debug-info
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
388 @vindex smtpmail-debug-info
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
389 The variable @code{smtpmail-debug-info} controls whether to print
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
390 the SMTP protocol exchange in the minibuffer, and retain the entire
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
391 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
392 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
393 mail.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
394
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
395 @item smtpmail-debug-verb
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
396 @vindex smtpmail-debug-verb
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
397 The variable @code{smtpmail-debug-verb} controls whether to send the
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
398 @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
399 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
400 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
401 together with @code{smtpmail-debug-info}. Note that this may cause
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
402 mail delivery to take considerable time if the final destination
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
403 cannot accept mail.
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
404
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
405 @end table
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
406
77235
88224dc74061 Include GFDL.
Chong Yidong <cyd@stupidchicken.com>
parents: 75348
diff changeset
407 @node GNU Free Documentation License
88224dc74061 Include GFDL.
Chong Yidong <cyd@stupidchicken.com>
parents: 75348
diff changeset
408 @chapter GNU Free Documentation License
88224dc74061 Include GFDL.
Chong Yidong <cyd@stupidchicken.com>
parents: 75348
diff changeset
409 @include doclicense.texi
88224dc74061 Include GFDL.
Chong Yidong <cyd@stupidchicken.com>
parents: 75348
diff changeset
410
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
411 @node Index
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
412 @chapter Index
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
413
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
414 @section Concept Index
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
415
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
416 @printindex cp
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
417
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
418 @section Function and Variable Index
49937
Simon Josefsson <jas@extundo.com>
parents: 49924
diff changeset
419
49924
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
420 @printindex fn
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
421
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
422 @contents
99fd2891ce11 Manual for smtpmail.el.
Simon Josefsson <jas@extundo.com>
parents:
diff changeset
423 @bye
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 52071
diff changeset
424
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 52071
diff changeset
425 @ignore
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 52071
diff changeset
426 arch-tag: 6316abdf-b366-4562-87a2-f37e8f894b6f
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 52071
diff changeset
427 @end ignore