SMTP functions

• smtp_open

  SMTPSTREAM *smtp_open(char **hostlist, long debug);
  

  
  hostlist

  Vector of SMTP server host names to try.

  
  debug

  Non-zero if want protocol telemetry debugging.

  This function opens an SMTP connection to one of the hosts in the host list and if successful returns a stream suitable for use by the other SMTP functions. The hosts are tried in order until a connection is successfully opened. If debug is non-NIL, protocol telemetry is logged via mm_dlog. NIL is returned if this function fails to open a connection to any of the hosts in the list.

• smtp_close

  void smtp_close(SMTPSTREAM *stream);
  

  
  stream

  Stream to close.

  This function closes the SMTP stream and frees all resources associated with it that it may have created.

• smtp_mail

  long smtp_mail(SMTPSTREAM *stream, char *type, ENVELOPE *msg, BODY *body);
  

  
  stream

  Stream to transmit mail.

  
  type

  Mail type (MAIL, SEND, SAML, SOML).

  
  msg

  Message envelope.

  
  body

  Message body.

  This function negotiates an SMTP transaction of the specified type (one of MAIL, SEND, SAML, or SOML) to deliver the specified message. This function returns T if success or NIL if there is any failure. The text reason for the failure is in stream->reply item; if it is associated with a recipient it is also in that address's address->error item.

• smtp_debug

  void smtp_debug(SMTPSTREAM *stream);
  

  
  stream

  Stream to enable debugging telemetry.

  This function enables SMTP protocol telemetry logging for this stream. All SMTP protocol operations are passed to the application via the mm_dlog facility.

• smtp_nodebug

  void smtp_nodebug(SMTPSTREAM *stream);
  

  
  stream

  Stream to disable debugging telemetry.

  This function disables SMTP protocol telemetry logging for this stream.

• smtpverbose_t

  typedef void (*smtpverbose_t)(char *buffer);
  

  
  buffer

  Pointer to verbose reply buffer.

  This is the argument to the SET_SMTPVERBOSE mail_parmameter call. If this function pointer is non-NIL, then if a verbose SMTP response (with SMTP code less than 100) is received, this function is called with that response text as its argument.