Data Structures
struct	lws_email

Enumerations
enum	lwsgs_smtp_states { LGSSMTP_IDLE, LGSSMTP_CONNECTING, LGSSMTP_CONNECTED, LGSSMTP_SENT_HELO, LGSSMTP_SENT_FROM, LGSSMTP_SENT_TO, LGSSMTP_SENT_DATA, LGSSMTP_SENT_BODY, LGSSMTP_SENT_QUIT }

Functions
LWS_VISIBLE LWS_EXTERN int	lws_email_init (struct lws_email email, uv_loop_t loop, int max_content)

LWS_VISIBLE LWS_EXTERN void	lws_email_check (struct lws_email *email)

LWS_VISIBLE LWS_EXTERN void	lws_email_destroy (struct lws_email *email)

Detailed Description

SMTP related functions

These apis let you communicate with a local SMTP server to send email from lws. It handles all the SMTP sequencing and protocol actions.

Your system should have postfix, sendmail or another MTA listening on port 25 and able to send email using the "mail" commandline app. Usually distro MTAs are configured for this by default.

It runs via its own libuv events if initialized (which requires giving it a libuv loop to attach to).

It operates using three callbacks, on_next() queries if there is a new email to send, on_get_body() asks for the body of the email, and on_sent() is called after the email is successfully sent.

To use it

create an lws_email struct
initialize data, loop, the email_* strings, max_content_size and the callbacks
call lws_email_init()

When you have at least one email to send, call lws_email_check() to schedule starting to send it.

Enumeration Type Documentation

§ lwsgs_smtp_states

enum lwsgs_smtp_states

#include <lib/libwebsockets.h>

enum lwsgs_smtp_states - where we are in SMTP protocol sequence

Enumerator
LGSSMTP_IDLE	awaiting new email
LGSSMTP_CONNECTING	opening tcp connection to MTA
LGSSMTP_CONNECTED	tcp connection to MTA is connected
LGSSMTP_SENT_HELO	sent the HELO
LGSSMTP_SENT_FROM	sent FROM
LGSSMTP_SENT_TO	sent TO
LGSSMTP_SENT_DATA	sent DATA request
LGSSMTP_SENT_BODY	sent the email body
LGSSMTP_SENT_QUIT	sent the session quit

                        {
         LGSSMTP_IDLE, 
         LGSSMTP_CONNECTING, 
         LGSSMTP_CONNECTED, 
         LGSSMTP_SENT_HELO, 
         LGSSMTP_SENT_FROM, 
         LGSSMTP_SENT_TO, 
         LGSSMTP_SENT_DATA, 
         LGSSMTP_SENT_BODY, 
         LGSSMTP_SENT_QUIT, 
 };