Annotation of embedaddon/curl/docs/examples/smtp-multi.c, revision 1.1

1.1     ! misho       1: /***************************************************************************
        !             2:  *                                  _   _ ____  _
        !             3:  *  Project                     ___| | | |  _ \| |
        !             4:  *                             / __| | | | |_) | |
        !             5:  *                            | (__| |_| |  _ <| |___
        !             6:  *                             \___|\___/|_| \_\_____|
        !             7:  *
        !             8:  * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al.
        !             9:  *
        !            10:  * This software is licensed as described in the file COPYING, which
        !            11:  * you should have received as part of this distribution. The terms
        !            12:  * are also available at https://curl.haxx.se/docs/copyright.html.
        !            13:  *
        !            14:  * You may opt to use, copy, modify, merge, publish, distribute and/or sell
        !            15:  * copies of the Software, and permit persons to whom the Software is
        !            16:  * furnished to do so, under the terms of the COPYING file.
        !            17:  *
        !            18:  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
        !            19:  * KIND, either express or implied.
        !            20:  *
        !            21:  ***************************************************************************/
        !            22: 
        !            23: /* <DESC>
        !            24:  * SMTP example using the multi interface
        !            25:  * </DESC>
        !            26:  */
        !            27: 
        !            28: #include <string.h>
        !            29: #include <curl/curl.h>
        !            30: 
        !            31: /* This is an example showing how to send mail using libcurl's SMTP
        !            32:  * capabilities. It builds on the smtp-mail.c example to demonstrate how to use
        !            33:  * libcurl's multi interface.
        !            34:  *
        !            35:  * Note that this example requires libcurl 7.20.0 or above.
        !            36:  */
        !            37: 
        !            38: #define FROM     "<sender@example.com>"
        !            39: #define TO       "<recipient@example.com>"
        !            40: #define CC       "<info@example.com>"
        !            41: 
        !            42: #define MULTI_PERFORM_HANG_TIMEOUT 60 * 1000
        !            43: 
        !            44: static const char *payload_text[] = {
        !            45:   "Date: Mon, 29 Nov 2010 21:54:29 +1100\r\n",
        !            46:   "To: " TO "\r\n",
        !            47:   "From: " FROM " (Example User)\r\n",
        !            48:   "Cc: " CC " (Another example User)\r\n",
        !            49:   "Message-ID: <dcd7cb36-11db-487a-9f3a-e652a9458efd@"
        !            50:   "rfcpedant.example.org>\r\n",
        !            51:   "Subject: SMTP multi example message\r\n",
        !            52:   "\r\n", /* empty line to divide headers from body, see RFC5322 */
        !            53:   "The body of the message starts here.\r\n",
        !            54:   "\r\n",
        !            55:   "It could be a lot of lines, could be MIME encoded, whatever.\r\n",
        !            56:   "Check RFC5322.\r\n",
        !            57:   NULL
        !            58: };
        !            59: 
        !            60: struct upload_status {
        !            61:   int lines_read;
        !            62: };
        !            63: 
        !            64: static size_t payload_source(void *ptr, size_t size, size_t nmemb, void *userp)
        !            65: {
        !            66:   struct upload_status *upload_ctx = (struct upload_status *)userp;
        !            67:   const char *data;
        !            68: 
        !            69:   if((size == 0) || (nmemb == 0) || ((size*nmemb) < 1)) {
        !            70:     return 0;
        !            71:   }
        !            72: 
        !            73:   data = payload_text[upload_ctx->lines_read];
        !            74: 
        !            75:   if(data) {
        !            76:     size_t len = strlen(data);
        !            77:     memcpy(ptr, data, len);
        !            78:     upload_ctx->lines_read++;
        !            79: 
        !            80:     return len;
        !            81:   }
        !            82: 
        !            83:   return 0;
        !            84: }
        !            85: 
        !            86: static struct timeval tvnow(void)
        !            87: {
        !            88:   struct timeval now;
        !            89: 
        !            90:   /* time() returns the value of time in seconds since the epoch */
        !            91:   now.tv_sec = (long)time(NULL);
        !            92:   now.tv_usec = 0;
        !            93: 
        !            94:   return now;
        !            95: }
        !            96: 
        !            97: static long tvdiff(struct timeval newer, struct timeval older)
        !            98: {
        !            99:   return (newer.tv_sec - older.tv_sec) * 1000 +
        !           100:     (newer.tv_usec - older.tv_usec) / 1000;
        !           101: }
        !           102: 
        !           103: int main(void)
        !           104: {
        !           105:   CURL *curl;
        !           106:   CURLM *mcurl;
        !           107:   int still_running = 1;
        !           108:   struct timeval mp_start;
        !           109:   struct curl_slist *recipients = NULL;
        !           110:   struct upload_status upload_ctx;
        !           111: 
        !           112:   upload_ctx.lines_read = 0;
        !           113: 
        !           114:   curl_global_init(CURL_GLOBAL_DEFAULT);
        !           115: 
        !           116:   curl = curl_easy_init();
        !           117:   if(!curl)
        !           118:     return 1;
        !           119: 
        !           120:   mcurl = curl_multi_init();
        !           121:   if(!mcurl)
        !           122:     return 2;
        !           123: 
        !           124:   /* This is the URL for your mailserver */
        !           125:   curl_easy_setopt(curl, CURLOPT_URL, "smtp://mail.example.com");
        !           126: 
        !           127:   /* Note that this option isn't strictly required, omitting it will result in
        !           128:    * libcurl sending the MAIL FROM command with empty sender data. All
        !           129:    * autoresponses should have an empty reverse-path, and should be directed
        !           130:    * to the address in the reverse-path which triggered them. Otherwise, they
        !           131:    * could cause an endless loop. See RFC 5321 Section 4.5.5 for more details.
        !           132:    */
        !           133:   curl_easy_setopt(curl, CURLOPT_MAIL_FROM, FROM);
        !           134: 
        !           135:   /* Add two recipients, in this particular case they correspond to the
        !           136:    * To: and Cc: addressees in the header, but they could be any kind of
        !           137:    * recipient. */
        !           138:   recipients = curl_slist_append(recipients, TO);
        !           139:   recipients = curl_slist_append(recipients, CC);
        !           140:   curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, recipients);
        !           141: 
        !           142:   /* We're using a callback function to specify the payload (the headers and
        !           143:    * body of the message). You could just use the CURLOPT_READDATA option to
        !           144:    * specify a FILE pointer to read from. */
        !           145:   curl_easy_setopt(curl, CURLOPT_READFUNCTION, payload_source);
        !           146:   curl_easy_setopt(curl, CURLOPT_READDATA, &upload_ctx);
        !           147:   curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
        !           148: 
        !           149:   /* Tell the multi stack about our easy handle */
        !           150:   curl_multi_add_handle(mcurl, curl);
        !           151: 
        !           152:   /* Record the start time which we can use later */
        !           153:   mp_start = tvnow();
        !           154: 
        !           155:   /* We start some action by calling perform right away */
        !           156:   curl_multi_perform(mcurl, &still_running);
        !           157: 
        !           158:   while(still_running) {
        !           159:     struct timeval timeout;
        !           160:     fd_set fdread;
        !           161:     fd_set fdwrite;
        !           162:     fd_set fdexcep;
        !           163:     int maxfd = -1;
        !           164:     int rc;
        !           165:     CURLMcode mc; /* curl_multi_fdset() return code */
        !           166: 
        !           167:     long curl_timeo = -1;
        !           168: 
        !           169:     /* Initialise the file descriptors */
        !           170:     FD_ZERO(&fdread);
        !           171:     FD_ZERO(&fdwrite);
        !           172:     FD_ZERO(&fdexcep);
        !           173: 
        !           174:     /* Set a suitable timeout to play around with */
        !           175:     timeout.tv_sec = 1;
        !           176:     timeout.tv_usec = 0;
        !           177: 
        !           178:     curl_multi_timeout(mcurl, &curl_timeo);
        !           179:     if(curl_timeo >= 0) {
        !           180:       timeout.tv_sec = curl_timeo / 1000;
        !           181:       if(timeout.tv_sec > 1)
        !           182:         timeout.tv_sec = 1;
        !           183:       else
        !           184:         timeout.tv_usec = (curl_timeo % 1000) * 1000;
        !           185:     }
        !           186: 
        !           187:     /* get file descriptors from the transfers */
        !           188:     mc = curl_multi_fdset(mcurl, &fdread, &fdwrite, &fdexcep, &maxfd);
        !           189: 
        !           190:     if(mc != CURLM_OK) {
        !           191:       fprintf(stderr, "curl_multi_fdset() failed, code %d.\n", mc);
        !           192:       break;
        !           193:     }
        !           194: 
        !           195:     /* On success the value of maxfd is guaranteed to be >= -1. We call
        !           196:        select(maxfd + 1, ...); specially in case of (maxfd == -1) there are
        !           197:        no fds ready yet so we call select(0, ...) --or Sleep() on Windows--
        !           198:        to sleep 100ms, which is the minimum suggested value in the
        !           199:        curl_multi_fdset() doc. */
        !           200: 
        !           201:     if(maxfd == -1) {
        !           202: #ifdef _WIN32
        !           203:       Sleep(100);
        !           204:       rc = 0;
        !           205: #else
        !           206:       /* Portable sleep for platforms other than Windows. */
        !           207:       struct timeval wait = { 0, 100 * 1000 }; /* 100ms */
        !           208:       rc = select(0, NULL, NULL, NULL, &wait);
        !           209: #endif
        !           210:     }
        !           211:     else {
        !           212:       /* Note that on some platforms 'timeout' may be modified by select().
        !           213:          If you need access to the original value save a copy beforehand. */
        !           214:       rc = select(maxfd + 1, &fdread, &fdwrite, &fdexcep, &timeout);
        !           215:     }
        !           216: 
        !           217:     if(tvdiff(tvnow(), mp_start) > MULTI_PERFORM_HANG_TIMEOUT) {
        !           218:       fprintf(stderr,
        !           219:               "ABORTING: Since it seems that we would have run forever.\n");
        !           220:       break;
        !           221:     }
        !           222: 
        !           223:     switch(rc) {
        !           224:     case -1:  /* select error */
        !           225:       break;
        !           226:     case 0:   /* timeout */
        !           227:     default:  /* action */
        !           228:       curl_multi_perform(mcurl, &still_running);
        !           229:       break;
        !           230:     }
        !           231:   }
        !           232: 
        !           233:   /* Free the list of recipients */
        !           234:   curl_slist_free_all(recipients);
        !           235: 
        !           236:   /* Always cleanup */
        !           237:   curl_multi_remove_handle(mcurl, curl);
        !           238:   curl_multi_cleanup(mcurl);
        !           239:   curl_easy_cleanup(curl);
        !           240:   curl_global_cleanup();
        !           241: 
        !           242:   return 0;
        !           243: }

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>