mailto.h

Go to the documentation of this file.

/*NB_REVISION*/
 
/*NB_COPYRIGHT*/
 
#ifndef _NB_MAILTO
#define _NB_MAILTO
 
#include <predef.h>
#include <nettypes.h>
#define STATUS_OK (0)                         
#define CONNECT_TO_SMTP_SERVER_FAILED (-1)    
#define INITIAL_SERVER_REPLY_FAILED (-2)      
#define HELO_SERVER_REPLY_FAILED (-3)         
#define MAIL_FROM_SERVER_REPLY_FAILED (-4)    
#define RCPT_TO_SERVER_REPLY_FAILED (-5)      
#define DATA_SERVER_REPLY_FAILED (-6)         
#define DATA_END_SERVER_REPLY_FAILED (-7)     
#define AUTH_LOGIN_SERVER_REPLY_FAILED (-8)   
#define USER_ID_SERVER_REPLY_FAILED (-9)      
#define PASSWORD_SERVER_REPLY_FAILED (-10)    
#define CONNECT931_SMTP_SERVER_FAILED (-11)   
/*-------------------------------------------------------------------
 * Send an email
 * Returns 0 on failure, 1 on success
 *------------------------------------------------------------------ */
int SendMail(IPADDR smtp_server, /* IP address of the SMTP server */
             PCSTR userid,       /* ASCII String to provide for RFC931 IDentification */
             PCSTR from_addr,    /* From E-Mail address */
             PCSTR to_addr,      /* To E-Mail Address */
             PCSTR subject,      /* E-Mail subject */
             PCSTR textbody /* E-Mail body */);
 
/*-------------------------------------------------------------------
 * Send an email with plain text authentication
 * Returns 0 on failure, 1 on success
 *-------------------------------------------------------------------*/
int SendMailAuth(IPADDR smtp_server, /*IP address of the SMTP server */
                 PCSTR userid,       /* ASCII String to provide for RFC931 IDentification */
                 PCSTR pass,         /* ASCII String to provide for AUTH IDentification */
                 PCSTR from_addr,    /* From E-Mail address */
                 PCSTR to_addr,      /* To E-Mail Address */
                 PCSTR subject,      /* E-Mail subject */
                 PCSTR textbody /* E-Mail body */);
 
/*-------------------------------------------------------------------
 * Similar to SendMail() with the following additions:
 * 1. The from_addr_rev_path is used to include the reverse source
 *    route per RFC 821 reverse-path option.
 * 2. The email contains the memo header. The mail data includes
 *    the memo header items such at DATE, Subject, TO, CC and From.
 *------------------------------------------------------------------*/
int SendMailEx(IPADDR smtp_server,
               PCSTR userid,
               PCSTR from_addr_rev_path,
               PCSTR from_addr_memo_hdr,
               PCSTR to_addr,
               PCSTR subject,
               PCSTR textbody);
 
/*-------------------------------------------------------------------
 * Send an email as if the NetBurner device was a SMTP server, rather
 * than the standard way of sending an email through an external
 * SMTP server through a user account.
 * ------------------------------------------------------------------*/
int SendMailAsServer(PCSTR from_addr, PCSTR to_addr, PCSTR subject, PCSTR textbody);
 
extern uint16_t SMTP_PORT;
extern uint16_t SMTP_AUTH_PORT;
extern uint16_t RFC931_PORT;
extern uint16_t LOCAL_MAIL_PORT;
 
/*-------------------------------------------------------------------
 * The following functions, variables and definitions are used for
 * error reporting of the mail system.
 * -----------------------------------------------------------------*/
 
// Returns 0 or error code
int IsMailError();
 
void PrintNBError(int fd = 0);
 
void PrintServerLog(int fd = 0);
 
// Returns 0 or error code
extern int NB_Mail_Error_Code;
 
// Last error string reported by NetBurner mail library. This is usually
// displayed on the debug serial port.
extern char NB_Mail_Error_String[];
 
// Last error string received from mail server
extern char Server_Mail_Log_String[];
 
extern enum CONTENT_TYPE_ENUM {
    CONTENT_TYPE_PLAIN_TEXT,          
    CONTENT_TYPE_PLAIN_TEXT_ATTACH,   
    CONTENT_TYPE_BINARY_ATTACH,       
    CONTENT_TYPE_HTML_DECOMP,         
    // Add additional types above CONTENT_TYPE_END
    CONTENT_TYPE_END   
} CONTENT_TYPE;
int SendMailAuthStartMIME(IPADDR smtp_server, PCSTR userid, PCSTR pass, PCSTR from_addr, PCSTR to_addr, PCSTR subject, int &fd);
 
int SendMailAuthAddMIME(int fd, int ContentType, const char *pContent, const char *FileName);
 
int SendMailAuthEndMIME(int fd, PCSTR userid);
 
void MIME_SendMultipartHeader(int fd);
 
#endif
 
#ifdef _NB_SSL_MAILTO
/*-------------------------------------------------------------------
 * Function to look for matching server return codes
 * ----------------------------------------------------------------*/
int SMPMatch(int fd, int fd931, PCSTR userid, PCSTR match, uint32_t timeout);
int writeb64string(int fd, const char *cp);
void SaveToMailLog(const char *buffer, int rv);
extern uint16_t Server_String_Count;
#endif