mailApi: Email Services Example

This example contains basic functionality test on NETOS V6.0 or later email APIs.
It sends, receives, lists and deletes mails.

This example requires user to setup definitions for sending simple mail,
sending attachment, sending mail with authentication, listing mails, 
retrieving mails, and deleting mail.

It also sends mail with attachment from the file system. This requires BSP_INCLUDE_FILESYSTEM_FOR_CLIBRARY 
to be set to TRUE in bsp_fs.h and this APP_FILE_SYSTEM must be defined in the Makefile.

This APP_FILE_SYSTEM is to enable Net+OS file system interface (see file.c).

User needs to setup:
		POP3_ADDRESS	- POP3 server address for retrieving mail
		SMTP_ADDRESS	- SMTP server address for sending mail
		POP3_USERNAME	- Username to login POP3 
		POP3_PASSWORD	- Password to login POP3
		SENDER_ADDR		- Sender email address (from address for sending mail)
		RECIPIENT_ADDR	- Recipient email address (to address for sending mail)

		SMTP_MD5_ADDRESS	- SMTP server address that supports Digest-MD5 authentication

		MD5_USERNAME		- Username to login SMTP server with authentication.
		MD5_PASSWORD		- Password to login SMTP server with authentication.
                            - The MD5_USERNAME and MD5_PASSWORD are used for sending email message 
                              with authentication. This example will obtain any authentications
                              that SMTP server supports and uses one of the authentication.
                            

The application uses the following files located in the
netos\src\linkerScripts directory.  These files are generated
when the BSP is built.

bootldr.dat     bootloader configuration file used to generate the
                file image.bin.  It controls the information placed
                in the bootloader header of the image.

image.ldr       GNU linker script used to build an image that can
                be debugged and used with the bootloader.
                
customize.ldr   Customizable GNU linker script
