1 #ifndef HEADER_CURL_SMTP_H 2 #define HEADER_CURL_SMTP_H 3 /*************************************************************************** 4 * _ _ ____ _ 5 * Project ___| | | | _ \| | 6 * / __| | | | |_) | | 7 * | (__| |_| | _ <| |___ 8 * \___|\___/|_| \_\_____| 9 * 10 * Copyright (C) 2009 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. 11 * 12 * This software is licensed as described in the file COPYING, which 13 * you should have received as part of this distribution. The terms 14 * are also available at https://curl.haxx.se/docs/copyright.html. 15 * 16 * You may opt to use, copy, modify, merge, publish, distribute and/or sell 17 * copies of the Software, and permit persons to whom the Software is 18 * furnished to do so, under the terms of the COPYING file. 19 * 20 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY 21 * KIND, either express or implied. 22 * 23 ***************************************************************************/ 24 25 #include "pingpong.h" 26 #include "curl_sasl.h" 27 28 /**************************************************************************** 29 * SMTP unique setup 30 ***************************************************************************/ 31 typedef enum { 32 SMTP_STOP, /* do nothing state, stops the state machine */ 33 SMTP_SERVERGREET, /* waiting for the initial greeting immediately after 34 a connect */ 35 SMTP_EHLO, 36 SMTP_HELO, 37 SMTP_STARTTLS, 38 SMTP_UPGRADETLS, /* asynchronously upgrade the connection to SSL/TLS 39 (multi mode only) */ 40 SMTP_AUTH, 41 SMTP_COMMAND, /* VRFY, EXPN, NOOP, RSET and HELP */ 42 SMTP_MAIL, /* MAIL FROM */ 43 SMTP_RCPT, /* RCPT TO */ 44 SMTP_DATA, 45 SMTP_POSTDATA, 46 SMTP_QUIT, 47 SMTP_LAST /* never used */ 48 } smtpstate; 49 50 /* This SMTP struct is used in the Curl_easy. All SMTP data that is 51 connection-oriented must be in smtp_conn to properly deal with the fact that 52 perhaps the Curl_easy is changed between the times the connection is 53 used. */ 54 struct SMTP { 55 curl_pp_transfer transfer; 56 char *custom; /* Custom Request */ 57 struct curl_slist *rcpt; /* Recipient list */ 58 bool rcpt_had_ok; /* Whether any of RCPT TO commands (depends on 59 total number of recipients) succeeded so far */ 60 int rcpt_last_error; /* The last error received for RCPT TO command */ 61 size_t eob; /* Number of bytes of the EOB (End Of Body) that 62 have been received so far */ 63 bool trailing_crlf; /* Specifies if the tailing CRLF is present */ 64 }; 65 66 /* smtp_conn is used for struct connection-oriented data in the connectdata 67 struct */ 68 struct smtp_conn { 69 struct pingpong pp; 70 smtpstate state; /* Always use smtp.c:state() to change state! */ 71 bool ssldone; /* Is connect() over SSL done? */ 72 char *domain; /* Client address/name to send in the EHLO */ 73 struct SASL sasl; /* SASL-related storage */ 74 bool tls_supported; /* StartTLS capability supported by server */ 75 bool size_supported; /* If server supports SIZE extension according to 76 RFC 1870 */ 77 bool utf8_supported; /* If server supports SMTPUTF8 extension according 78 to RFC 6531 */ 79 bool auth_supported; /* AUTH capability supported by server */ 80 }; 81 82 extern const struct Curl_handler Curl_handler_smtp; 83 extern const struct Curl_handler Curl_handler_smtps; 84 85 /* this is the 5-bytes End-Of-Body marker for SMTP */ 86 #define SMTP_EOB "\x0d\x0a\x2e\x0d\x0a" 87 #define SMTP_EOB_LEN 5 88 #define SMTP_EOB_FIND_LEN 3 89 90 /* if found in data, replace it with this string instead */ 91 #define SMTP_EOB_REPL "\x0d\x0a\x2e\x2e" 92 #define SMTP_EOB_REPL_LEN 4 93 94 CURLcode Curl_smtp_escape_eob(struct connectdata *conn, const ssize_t nread); 95 96 #endif /* HEADER_CURL_SMTP_H */ 97