Download Datasheet
 Download User Manual
 Download Demo

HS SMTP C Source Library

 ORDER NOW

 CONTACT US

Features

SMTP Client Operation

Server name resolution

Supports up to 5 contexts

Message Header Transfer

Message Text Transfer

Asynchonous Operation

ESMTP extension for authentication
using LOGIN base64 encoding

Message sending to multiple recipients
from address list

Sending binary file attachments using MIME version 1.0 base64 encoding

Secure SMTP over TLS / SLL
(RFC 3207)

customization

Hillstone Software provides additional services for customization, porting and integration of the library code to better suit the needs of your products

api summary

HsSmtpInit
HsSmtpDestroy
HsSmtpTick
HsSmtpSendMail
HsSmtpAbortMail
HsSmtpContinue

Secure SMTP
Implementation Details

Secure SMTP over TLS / SSL is implemented according RFC 3207. If secure SMTP support is requested in parameters to HsSmtpSendMail API function, HS SMTP shall issue STARTTLS command once TCP connection is established to SMTP server.

Support for SSL / TLS is implemented in HsSock library (which is included with HsSmtp).

HsSock library has a compile option to incude SSL support or not. Is SSL support is compiled in, HsSock library interfaces to OpenSSL API in order to manage SSL connections, secure negotiation and data encryption and decryption.

OpenSSL binaries are supplied with HSSMTP Demo application.

In order to compile HS SMTP library with SSL support user must have installed OpenSSL. The HS SMTP project file must be adjusted to point it to include OpenSSL header files from correct directory.

SSL support is optional and it is possible to use HS SMTP without OpenSSL. To do that HsSock compile option must be changed not to include SSL support.

* This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit

overview: HS SMTP is a software library in C (supplied with full source code) which implements the client side of Simple Mail Transfer Protocol (SMTP) over TCP socket layer according to RFC 821. Support for transfer of basic message header and text is provided.

From version 1.1, HS SMTP supports ESMTP extension for LOGIN Authentication using Base64 encoding and message sending to multiple recipients from address list.

From version 1.2 HS SMTP supports sending binary file attachments using MIME version 1.0 base64 encoding

From version 2.0.0 HS SMTP supports secure SMTP over TLS / SSL (RFC 3207)

The use of HS SMTP C Source Library is Royalty Free

how it works

To send a text email message to any address on the internet, the user application calls a single function HsSmtpSendMail, specifying mail server name or IP address, sender address, recipient address, message text buffer and length, subject, cc and an event callback function to use for reporting of operation result and server errors.

HS SMTP library then resolves the server name, connects to it and transmits the message according to SMTP RFC 821 protocol. HS SMTP Library incorporates the necessary state machine, transparency procedures, and server response processing required to comply to a simple and robust SMTP client implementation.

Modular design makes it easy to port HS SMTP protocol module to any environment. HS SMTP internally at a lower layer interfaces to HS Sock library which provides TCP transport services. User application need not worry about Winsock - HS SMTP does all transmission, reception and event handling over socket layer.

hs SMTP library architecture

The library is a stand-alone module which links directly to customer application: