smtp.h

Go to the documentation of this file.

#ifndef SMTP_H
#define SMTP_H

#include <sys/types.h>
#include <stddef.h>
#include <stdio.h>

#ifndef SIZE_MAX

# define SIZE_MAX ((size_t)(-1))
#endif /* SIZE_MAX */

enum smtp_status_code{
  SMTP_STATUS_OK              = 0,

  SMTP_STATUS_NOMEM           = 1,

  SMTP_STATUS_CONNECT         = 2,

  SMTP_STATUS_HANDSHAKE       = 3,

  SMTP_STATUS_AUTH            = 4,

  SMTP_STATUS_SEND            = 5,

  SMTP_STATUS_RECV            = 6,

  SMTP_STATUS_CLOSE           = 7,

  SMTP_STATUS_SERVER_RESPONSE = 8,

  SMTP_STATUS_PARAM           = 9,

  SMTP_STATUS_FILE            = 10,

  SMTP_STATUS_DATE            = 11,

  SMTP_STATUS__LAST
};

enum smtp_address_type{
  SMTP_ADDRESS_FROM = 0,

  SMTP_ADDRESS_TO   = 1,

  SMTP_ADDRESS_CC   = 2,

  SMTP_ADDRESS_BCC  = 3
};

enum smtp_connection_security{
#ifdef SMTP_OPENSSL

  SMTP_SECURITY_STARTTLS = 0,

  SMTP_SECURITY_TLS      = 1,
#endif /* SMTP_OPENSSL */

  SMTP_SECURITY_NONE     = 2
};

enum smtp_authentication_method{
#ifdef SMTP_OPENSSL

  SMTP_AUTH_CRAM_MD5 = 0,
#endif /* SMTP_OPENSSL */

  SMTP_AUTH_NONE     = 1,

  SMTP_AUTH_PLAIN    = 2,

  SMTP_AUTH_LOGIN    = 3
};

enum smtp_flag{
  SMTP_DEBUG          = 1 << 0,

  SMTP_NO_CERT_VERIFY = 1 << 1
};

struct smtp;

#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */

enum smtp_status_code
smtp_open(const char *const server,
          const char *const port,
          enum smtp_connection_security connection_security,
          enum smtp_flag flags,
          const char *const cafile,
          struct smtp **smtp);

enum smtp_status_code
smtp_auth(struct smtp *const smtp,
          enum smtp_authentication_method auth_method,
          const char *const user,
          const char *const pass);

enum smtp_status_code
smtp_mail(struct smtp *const smtp,
          const char *const body);

enum smtp_status_code
smtp_close(struct smtp *smtp);

enum smtp_status_code
smtp_status_code_get(const struct smtp *const smtp);

enum smtp_status_code
smtp_status_code_clear(struct smtp *const smtp);

enum smtp_status_code
smtp_status_code_set(struct smtp *const smtp,
                     enum smtp_status_code new_status_code);

const char *
smtp_status_code_errstr(enum smtp_status_code status_code);

enum smtp_status_code
smtp_header_add(struct smtp *const smtp,
                const char *const key,
                const char *const value);

void
smtp_header_clear_all(struct smtp *const smtp);

enum smtp_status_code
smtp_address_add(struct smtp *const smtp,
                 enum smtp_address_type type,
                 const char *const email,
                 const char *const name);

void
smtp_address_clear_all(struct smtp *const smtp);

enum smtp_status_code
smtp_attachment_add_path(struct smtp *const smtp,
                         const char *const name,
                         const char *const path);

enum smtp_status_code
smtp_attachment_add_fp(struct smtp *const smtp,
                       const char *const name,
                       FILE *fp);

enum smtp_status_code
smtp_attachment_add_mem(struct smtp *const smtp,
                        const char *const name,
                        const void *const data,
                        size_t datasz);

void
smtp_attachment_clear_all(struct smtp *const smtp);


/*
 * The SMTP_INTERNAL DEFINE section contains definitions that get used
 * internally by the SMTP client library.
 */
#ifdef SMTP_INTERNAL_DEFINE

enum smtp_result_code{
  SMTP_INTERNAL_ERROR =  -1,

  SMTP_READY          = 220,

  SMTP_CLOSE          = 221,

  SMTP_AUTH_SUCCESS   = 235,

  SMTP_DONE           = 250,

  SMTP_AUTH_CONTINUE  = 334,

  SMTP_BEGIN_MAIL     = 354
};

struct smtp_command{
  enum smtp_result_code code;

  int more;

  const char *text;
};

enum str_getdelim_retcode{
  STRING_GETDELIMFD_ERROR = -1,

  STRING_GETDELIMFD_NEXT  =  0,

  STRING_GETDELIMFD_DONE  =  1
};

struct str_getdelimfd{
  char *_buf;

  size_t _bufsz;

  size_t _buf_len;

  char *line;

  size_t line_len;

  long (*getdelimfd_read)(struct str_getdelimfd *const gdfd,
                          void *buf,
                          size_t count);

  void *user_data;

  int delim;

  char pad[4];
};

#endif /* SMTP_INTERNAL_DEFINE */

#ifdef __cplusplus
}
#endif /* __cplusplus */

#endif /* SMTP_H */