examples: Added IMAP APPEND example
[platform/upstream/curl.git] / docs / examples / imap-append.c
1 /***************************************************************************
2  *                                  _   _ ____  _
3  *  Project                     ___| | | |  _ \| |
4  *                             / __| | | | |_) | |
5  *                            | (__| |_| |  _ <| |___
6  *                             \___|\___/|_| \_\_____|
7  *
8  * Copyright (C) 1998 - 2014, 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 http://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 #include <stdio.h>
23 #include <curl/curl.h>
24
25 /* This is a simple example showing how to send mail using libcurl's IMAP
26  * capabilities.
27  *
28  * Note that this example requires libcurl 7.30.0 or above.
29  */
30
31 #define FROM    "<sender@example.org>"
32 #define TO      "<addressee@example.net>"
33 #define CC      "<info@example.org>"
34
35 static const char *payload_text[] = {
36   "Date: Mon, 29 Nov 2010 21:54:29 +1100\r\n",
37   "To: " TO "\r\n",
38   "From: " FROM "(Example User)\r\n",
39   "Cc: " CC "(Another example User)\r\n",
40   "Message-ID: <dcd7cb36-11db-487a-9f3a-e652a9458efd@rfcpedant.example.org>\r\n",
41   "Subject: IMAP example message\r\n",
42   "\r\n", /* empty line to divide headers from body, see RFC5322 */
43   "The body of the message starts here.\r\n",
44   "\r\n",
45   "It could be a lot of lines, could be MIME encoded, whatever.\r\n",
46   "Check RFC5322.\r\n",
47   NULL
48 };
49
50 struct upload_status {
51   int lines_read;
52 };
53
54 static size_t payload_source(void *ptr, size_t size, size_t nmemb, void *userp)
55 {
56   struct upload_status *upload_ctx = (struct upload_status *)userp;
57   const char *data;
58
59   if((size == 0) || (nmemb == 0) || ((size*nmemb) < 1)) {
60     return 0;
61   }
62
63   data = payload_text[upload_ctx->lines_read];
64
65   if(data) {
66     size_t len = strlen(data);
67     memcpy(ptr, data, len);
68     upload_ctx->lines_read++;
69
70     return len;
71   }
72
73   return 0;
74 }
75
76 int main(void)
77 {
78   CURL *curl;
79   CURLcode res = CURLE_OK;
80   struct upload_status upload_ctx;
81
82   upload_ctx.lines_read = 0;
83
84   curl = curl_easy_init();
85   if(curl) {
86     /* Set username and password */
87     curl_easy_setopt(curl, CURLOPT_USERPWD, "user:password");
88
89     /* This will create a new message 100. Note that you should perform an
90      * EXAMINE command to obtain the UID of the next message to create and a
91      * SELECT to ensure you are creating the message in the OUTBOX. */
92     curl_easy_setopt(curl, CURLOPT_URL, "imap://imap.example.com/100");
93
94     /* In this case, we're using a callback function to specify the data. You
95      * could just use the CURLOPT_READDATA option to specify a FILE pointer to
96      * read from. */
97     curl_easy_setopt(curl, CURLOPT_READFUNCTION, payload_source);
98     curl_easy_setopt(curl, CURLOPT_READDATA, &upload_ctx);
99     curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
100
101     /* Perform the append */
102     res = curl_easy_perform(curl);
103
104     /* Check for errors */
105     if(res != CURLE_OK)
106       fprintf(stderr, "curl_easy_perform() failed: %s\n",
107               curl_easy_strerror(res));
108
109     /* Always cleanup */
110     curl_easy_cleanup(curl);
111   }
112
113   return (int)res;
114 }