/ gwmail.h / Functions / Description

Functions



gw_mail_check_msg

Checks if the server doesn't return an error.
int gw_mail_check_msg ( char * msg, char * code);
This function checks if the server doesn't return an error.


Parameters
msg server response
code error code to check

Result: an error code.
Returns 0 when it's done.
Returns -1 when an error occured.
.


gw_mail_read_msg

Reads messages on a socket.
int gw_mail_read_msg ( int sd);
This function reads messages on a socket.


Parameters
sd socket descriptor

Result: an error code.
Returns 0 when it's done.
Returns -1 when an error occured.
.


gw_mail_send_msg

Sends messages on a socket.
int gw_mail_send_msg ( int sd, char * msg);
This function sends messages on a socket.


Parameters
sd socket descriptor
msg message to send

Result: an error code.
Returns 0 when it's done.
Returns -1 when an error occured.
.


gw_mail_attachment_encode_base64_and_send

Encodes in base 64 and sends a file on a socket.
int gw_mail_attachment_encode_base64_and_send ( int sd, char * file );
This function encodes in base 64 and sends a file on a socket.


Parameters
sd socket descriptor
file file name to encode and send

Result: an error code.
Returns 0 when it's done.
Returns -1 when an error occured.
.


gw_mail_send_mail

Sends a mail.
int gw_mail_send_mail ( char * hostname, int server_port, char * from, char * to, char * cc, char * bcc, char * object, char * msg, char * file);
This function sends a mail.


Parameters
hostname server host name
server_port server port
from mail "from" field
to mail "to" field
cc mail "cc" field
bcc mail "bcc" field
object mail "object" field
msg mail message
file file name to attach

Result: an error code.
Returns 0 when it's done.
Returns -1 when an error occured.
.


gw_mail_check_email_list

Checks an email list format
gboolean gw_mail_check_email_list ( const char * email_list);
This function checks an email list format.
An email list have good format if each email address are seperated by ";" character and if each email address have an "@" character.

Parameters
email_list email list to check

Result: returns TRUE if the email list have the good format.
Returns FALSE when an error occured.
.