xref: /curl/docs/examples/ftpupload.c (revision f81f351b)
1 /***************************************************************************
2  *                                  _   _ ____  _
3  *  Project                     ___| | | |  _ \| |
4  *                             / __| | | | |_) | |
5  *                            | (__| |_| |  _ <| |___
6  *                             \___|\___/|_| \_\_____|
7  *
8  * Copyright (C) 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.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  * SPDX-License-Identifier: curl
22  *
23  ***************************************************************************/
24 #include <stdio.h>
25 #include <string.h>
26 
27 #include <curl/curl.h>
28 #include <sys/types.h>
29 #include <sys/stat.h>
30 #include <fcntl.h>
31 #include <errno.h>
32 #ifdef _WIN32
33 #include <io.h>
34 #else
35 #include <unistd.h>
36 #endif
37 
38 /* <DESC>
39  * Performs an FTP upload and renames the file just after a successful
40  * transfer.
41  * </DESC>
42  */
43 
44 #define LOCAL_FILE      "/tmp/uploadthis.txt"
45 #define UPLOAD_FILE_AS  "while-uploading.txt"
46 #define REMOTE_URL      "ftp://example.com/"  UPLOAD_FILE_AS
47 #define RENAME_FILE_TO  "renamed-and-fine.txt"
48 
49 /* NOTE: if you want this example to work on Windows with libcurl as a DLL,
50    you MUST also provide a read callback with CURLOPT_READFUNCTION. Failing to
51    do so might give you a crash since a DLL may not use the variable's memory
52    when passed in to it from an app like this. */
read_callback(char * ptr,size_t size,size_t nmemb,void * stream)53 static size_t read_callback(char *ptr, size_t size, size_t nmemb, void *stream)
54 {
55   unsigned long nread;
56   /* in real-world cases, this would probably get this data differently
57      as this fread() stuff is exactly what the library already would do
58      by default internally */
59   size_t retcode = fread(ptr, size, nmemb, stream);
60 
61   if(retcode > 0) {
62     nread = (unsigned long)retcode;
63     fprintf(stderr, "*** We read %lu bytes from file\n", nread);
64   }
65 
66   return retcode;
67 }
68 
main(void)69 int main(void)
70 {
71   CURL *curl;
72   CURLcode res;
73   FILE *hd_src;
74   struct stat file_info;
75   unsigned long fsize;
76 
77   struct curl_slist *headerlist = NULL;
78   static const char buf_1 [] = "RNFR " UPLOAD_FILE_AS;
79   static const char buf_2 [] = "RNTO " RENAME_FILE_TO;
80 
81   /* get the file size of the local file */
82   if(stat(LOCAL_FILE, &file_info)) {
83     printf("Couldn't open '%s': %s\n", LOCAL_FILE, strerror(errno));
84     return 1;
85   }
86   fsize = (unsigned long)file_info.st_size;
87 
88   printf("Local file size: %lu bytes.\n", fsize);
89 
90   /* get a FILE * of the same file */
91   hd_src = fopen(LOCAL_FILE, "rb");
92 
93   /* In Windows, this inits the Winsock stuff */
94   curl_global_init(CURL_GLOBAL_ALL);
95 
96   /* get a curl handle */
97   curl = curl_easy_init();
98   if(curl) {
99     /* build a list of commands to pass to libcurl */
100     headerlist = curl_slist_append(headerlist, buf_1);
101     headerlist = curl_slist_append(headerlist, buf_2);
102 
103     /* we want to use our own read function */
104     curl_easy_setopt(curl, CURLOPT_READFUNCTION, read_callback);
105 
106     /* enable uploading */
107     curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
108 
109     /* specify target */
110     curl_easy_setopt(curl, CURLOPT_URL, REMOTE_URL);
111 
112     /* pass in that last of FTP commands to run after the transfer */
113     curl_easy_setopt(curl, CURLOPT_POSTQUOTE, headerlist);
114 
115     /* now specify which file to upload */
116     curl_easy_setopt(curl, CURLOPT_READDATA, hd_src);
117 
118     /* Set the size of the file to upload (optional).  If you give a *_LARGE
119        option you MUST make sure that the type of the passed-in argument is a
120        curl_off_t. If you use CURLOPT_INFILESIZE (without _LARGE) you must
121        make sure that to pass in a type 'long' argument. */
122     curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE,
123                      (curl_off_t)fsize);
124 
125     /* Now run off and do what you have been told! */
126     res = curl_easy_perform(curl);
127     /* Check for errors */
128     if(res != CURLE_OK)
129       fprintf(stderr, "curl_easy_perform() failed: %s\n",
130               curl_easy_strerror(res));
131 
132     /* clean up the FTP commands list */
133     curl_slist_free_all(headerlist);
134 
135     /* always cleanup */
136     curl_easy_cleanup(curl);
137   }
138   fclose(hd_src); /* close the local file */
139 
140   curl_global_cleanup();
141   return 0;
142 }
143