<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-2E253B30-2611-546D-AE5B-1752556FC8E8" xml:lang="en"><title>SMTP
Concepts</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>This section section describes the Simple Mail Transfer Protocol (SMTP)
and its implementation on Symbian platform. </p>
<section id="GUID-DBF1C87D-7360-54B7-8658-B6659BF77F06-GENID-1-10-1-19-1-1-6-1-7-1-4-1-2-2"><title>SMTP protocol</title> <p>SMTP
is the most widely used protocol for sending emails. It is a text-based and <b>push</b> protocol
that cannot <b>pull</b> messages from a remote server on demand. </p> <p>One
or more recipients of a message are specified in a message along with the
message text and other encoded objects. The message is then transferred to
a remote server using a procedure of queries and responses between the client
and server. Either an end-user's email client (Mail User Agent (MUA)) or a
relaying server's Mail Transport Agents (MTA) can act as an SMTP client. The
SMTP client initiates a TCP connection to SMTP server on port 25 (unless overridden
by configuration). </p> <p>SMTP is more suitable for a machine permanently
connected to the Internet. To retrieve messages only on demand, which is the
most common requirement on a single-user computer, a mail client must use
POP3 or IMAP4. POP3 is mostly preferred when single-user computers connected
to the Internet only intermittently. </p> </section>
<section><title>Symbian platform implementation of SMTP</title> <p>SMTP is
a Mail Transfer Agent (MTA) used to transfer emails to a SMTP server which
then forwards them on to a specified destination. </p> <p>Sending an email
generally consists of three phases: connect and authorise to server, send
emails and quit. </p> <p>The SMTP component is responsible for sending email
messages composed and stored in the Message Server’s Message Store. </p> <ol id="GUID-8FCD7F76-46FD-58E9-9EBA-B178B98F0782">
<li id="GUID-A8B5A1FA-DE84-51E8-B2B3-B4FCD073E0D2"><p>The SMTP client initiates
a connection with the SMTP server. Depending on the user’s email settings,
this may have been initiated over a secure SSL/TLS socket on port 465. </p> </li>
<li id="GUID-F18E9E52-DF7A-5127-B6DD-FB08663025E0"><p>Depending on how the
user has configured the email settings and the capabilities of the SMTP server,
SMTP authentication may also be required. </p> </li>
<li id="GUID-74561ABB-4B7A-58E7-B79D-5473C3149476"><p>Mail <b>From</b> and
recipient <b>To</b> are sent. </p> </li>
<li id="GUID-7ABADE92-CAF1-524A-A8AB-288E9849BED1"><p>The message header fields
for the email message stored in the Message Store are then transmitted, each
one separated by a CRLF. </p> </li>
<li id="GUID-7932B3D6-270F-5983-8521-8AC83C7AA450"><p>The last CRLF is sent
to indicate the end of the RFC 2822 header. </p> </li>
<li id="GUID-2A05FF85-4E42-5EEE-A2C5-4763C887E3D2"><p>The message body and
encoded attachments are sent. </p> <p>The encoding format (uuencode or MIME,
character sets) depends on the user’s email settings and locale. </p> </li>
<li id="GUID-7040A4EB-AA7C-5932-B7FF-89595D9256D0"><p>Finally, the body is
terminated by a CRLF. </p> <p>CRLF sequence, and the email is queued by the
SMTP server for sending. </p> </li>
</ol> </section>
<section><title>SMTP example</title> <p>For more details on implementing the
IMAP4 MTM functions, see <xref href="GUID-D73AD200-BE4D-50BF-BCF9-14627DE530B7.dita">example
code</xref>. </p> </section>
</conbody><related-links>
<link href="GUID-4F703F85-080F-5B77-B94D-5449764828F3.dita"><linktext>SMTP MTM</linktext>
</link>
</related-links></concept>