xref: /curl/docs/examples/anyauthput.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 /* <DESC>
25  * HTTP PUT upload with authentication using "any" method. libcurl picks the
26  * one the server supports/wants.
27  * </DESC>
28  */
29 #include <stdio.h>
30 #include <fcntl.h>
31 #include <sys/types.h>
32 #include <sys/stat.h>
33 
34 #include <curl/curl.h>
35 
36 #ifdef _WIN32
37 #  define FILENO(fp) _fileno(fp)
38 #else
39 #  define FILENO(fp) fileno(fp)
40 #endif
41 
42 #if LIBCURL_VERSION_NUM < 0x070c03
43 #error "upgrade your libcurl to no less than 7.12.3"
44 #endif
45 
46 /*
47  * This example shows an HTTP PUT operation with authentication using "any"
48  * type. It PUTs a file given as a command line argument to the URL also given
49  * on the command line.
50  *
51  * Since libcurl 7.12.3, using "any" auth and POST/PUT requires a set seek
52  * function.
53  *
54  * This example also uses its own read callback.
55  */
56 
57 /* seek callback function */
my_seek(void * userp,curl_off_t offset,int origin)58 static int my_seek(void *userp, curl_off_t offset, int origin)
59 {
60   FILE *fp = (FILE *) userp;
61 
62   if(-1 == fseek(fp, (long) offset, origin))
63     /* could not seek */
64     return CURL_SEEKFUNC_CANTSEEK;
65 
66   return CURL_SEEKFUNC_OK; /* success! */
67 }
68 
69 /* read callback function, fread() look alike */
read_callback(char * ptr,size_t size,size_t nmemb,void * stream)70 static size_t read_callback(char *ptr, size_t size, size_t nmemb, void *stream)
71 {
72   size_t nread;
73 
74   nread = fread(ptr, size, nmemb, stream);
75 
76   if(nread > 0) {
77     fprintf(stderr, "*** We read %lu bytes from file\n", (unsigned long)nread);
78   }
79 
80   return nread;
81 }
82 
main(int argc,char ** argv)83 int main(int argc, char **argv)
84 {
85   CURL *curl;
86   CURLcode res;
87   FILE *fp;
88   struct stat file_info;
89 
90   char *file;
91   char *url;
92 
93   if(argc < 3)
94     return 1;
95 
96   file = argv[1];
97   url = argv[2];
98 
99   /* get the file size of the local file */
100   fp = fopen(file, "rb");
101   fstat(FILENO(fp), &file_info);
102 
103   /* In Windows, this inits the Winsock stuff */
104   curl_global_init(CURL_GLOBAL_ALL);
105 
106   /* get a curl handle */
107   curl = curl_easy_init();
108   if(curl) {
109     /* we want to use our own read function */
110     curl_easy_setopt(curl, CURLOPT_READFUNCTION, read_callback);
111 
112     /* which file to upload */
113     curl_easy_setopt(curl, CURLOPT_READDATA, (void *) fp);
114 
115     /* set the seek function */
116     curl_easy_setopt(curl, CURLOPT_SEEKFUNCTION, my_seek);
117 
118     /* pass the file descriptor to the seek callback as well */
119     curl_easy_setopt(curl, CURLOPT_SEEKDATA, (void *) fp);
120 
121     /* enable "uploading" (which means PUT when doing HTTP) */
122     curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
123 
124     /* specify target URL, and note that this URL should also include a file
125        name, not only a directory (as you can do with GTP uploads) */
126     curl_easy_setopt(curl, CURLOPT_URL, url);
127 
128     /* and give the size of the upload, this supports large file sizes
129        on systems that have general support for it */
130     curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE,
131                      (curl_off_t)file_info.st_size);
132 
133     /* tell libcurl we can use "any" auth, which lets the lib pick one, but it
134        also costs one extra round-trip and possibly sending of all the PUT
135        data twice!!! */
136     curl_easy_setopt(curl, CURLOPT_HTTPAUTH, (long)CURLAUTH_ANY);
137 
138     /* set user name and password for the authentication */
139     curl_easy_setopt(curl, CURLOPT_USERPWD, "user:password");
140 
141     /* Now run off and do what you have been told! */
142     res = curl_easy_perform(curl);
143     /* Check for errors */
144     if(res != CURLE_OK)
145       fprintf(stderr, "curl_easy_perform() failed: %s\n",
146               curl_easy_strerror(res));
147 
148     /* always cleanup */
149     curl_easy_cleanup(curl);
150   }
151   fclose(fp); /* close the local file */
152 
153   curl_global_cleanup();
154   return 0;
155 }
156