2 * QEMU Block driver for CURL images
4 * Copyright (c) 2009 Alexander Graf <agraf@suse.de>
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
25 #include "qemu/osdep.h"
26 #include "qapi/error.h"
27 #include "qemu/error-report.h"
28 #include "qemu/module.h"
29 #include "qemu/option.h"
30 #include "block/block_int.h"
31 #include "qapi/qmp/qdict.h"
32 #include "qapi/qmp/qstring.h"
33 #include "crypto/secret.h"
34 #include <curl/curl.h>
35 #include "qemu/cutils.h"
38 // #define DEBUG_VERBOSE
40 #if LIBCURL_VERSION_NUM >= 0x071000
41 /* The multi interface timer callback was introduced in 7.16.0 */
42 #define NEED_CURL_TIMER_CALLBACK
43 #define HAVE_SOCKET_ACTION
46 #ifndef HAVE_SOCKET_ACTION
47 /* If curl_multi_socket_action isn't available, define it statically here in
48 * terms of curl_multi_socket. Note that ev_bitmask will be ignored, which is
49 * less efficient but still safe. */
50 static CURLMcode
__curl_multi_socket_action(CURLM
*multi_handle
,
55 return curl_multi_socket(multi_handle
, sockfd
, running_handles
);
57 #define curl_multi_socket_action __curl_multi_socket_action
60 #define PROTOCOLS (CURLPROTO_HTTP | CURLPROTO_HTTPS | \
61 CURLPROTO_FTP | CURLPROTO_FTPS)
63 #define CURL_NUM_STATES 8
64 #define CURL_NUM_ACB 8
65 #define CURL_TIMEOUT_MAX 10000
67 #define CURL_BLOCK_OPT_URL "url"
68 #define CURL_BLOCK_OPT_READAHEAD "readahead"
69 #define CURL_BLOCK_OPT_SSLVERIFY "sslverify"
70 #define CURL_BLOCK_OPT_TIMEOUT "timeout"
71 #define CURL_BLOCK_OPT_COOKIE "cookie"
72 #define CURL_BLOCK_OPT_COOKIE_SECRET "cookie-secret"
73 #define CURL_BLOCK_OPT_USERNAME "username"
74 #define CURL_BLOCK_OPT_PASSWORD_SECRET "password-secret"
75 #define CURL_BLOCK_OPT_PROXY_USERNAME "proxy-username"
76 #define CURL_BLOCK_OPT_PROXY_PASSWORD_SECRET "proxy-password-secret"
78 #define CURL_BLOCK_OPT_READAHEAD_DEFAULT (256 * 1024)
79 #define CURL_BLOCK_OPT_SSLVERIFY_DEFAULT true
80 #define CURL_BLOCK_OPT_TIMEOUT_DEFAULT 5
85 static bool libcurl_initialized
;
87 typedef struct CURLAIOCB
{
99 typedef struct CURLSocket
{
101 struct CURLState
*state
;
102 QLIST_ENTRY(CURLSocket
) next
;
105 typedef struct CURLState
107 struct BDRVCURLState
*s
;
108 CURLAIOCB
*acb
[CURL_NUM_ACB
];
110 QLIST_HEAD(, CURLSocket
) sockets
;
116 char errmsg
[CURL_ERROR_SIZE
];
120 typedef struct BDRVCURLState
{
124 CURLState states
[CURL_NUM_STATES
];
126 size_t readahead_size
;
131 AioContext
*aio_context
;
133 CoQueue free_state_waitq
;
140 static void curl_clean_state(CURLState
*s
);
141 static void curl_multi_do(void *arg
);
143 #ifdef NEED_CURL_TIMER_CALLBACK
144 /* Called from curl_multi_do_locked, with s->mutex held. */
145 static int curl_timer_cb(CURLM
*multi
, long timeout_ms
, void *opaque
)
147 BDRVCURLState
*s
= opaque
;
149 trace_curl_timer_cb(timeout_ms
);
150 if (timeout_ms
== -1) {
151 timer_del(&s
->timer
);
153 int64_t timeout_ns
= (int64_t)timeout_ms
* 1000 * 1000;
155 qemu_clock_get_ns(QEMU_CLOCK_REALTIME
) + timeout_ns
);
161 /* Called from curl_multi_do_locked, with s->mutex held. */
162 static int curl_sock_cb(CURL
*curl
, curl_socket_t fd
, int action
,
163 void *userp
, void *sp
)
166 CURLState
*state
= NULL
;
169 curl_easy_getinfo(curl
, CURLINFO_PRIVATE
, (char **)&state
);
172 QLIST_FOREACH(socket
, &state
->sockets
, next
) {
173 if (socket
->fd
== fd
) {
178 socket
= g_new0(CURLSocket
, 1);
180 socket
->state
= state
;
181 QLIST_INSERT_HEAD(&state
->sockets
, socket
, next
);
184 trace_curl_sock_cb(action
, (int)fd
);
187 aio_set_fd_handler(s
->aio_context
, fd
, false,
188 curl_multi_do
, NULL
, NULL
, socket
);
191 aio_set_fd_handler(s
->aio_context
, fd
, false,
192 NULL
, curl_multi_do
, NULL
, socket
);
194 case CURL_POLL_INOUT
:
195 aio_set_fd_handler(s
->aio_context
, fd
, false,
196 curl_multi_do
, curl_multi_do
, NULL
, socket
);
198 case CURL_POLL_REMOVE
:
199 aio_set_fd_handler(s
->aio_context
, fd
, false,
200 NULL
, NULL
, NULL
, NULL
);
204 if (action
== CURL_POLL_REMOVE
) {
205 QLIST_REMOVE(socket
, next
);
212 /* Called from curl_multi_do_locked, with s->mutex held. */
213 static size_t curl_header_cb(void *ptr
, size_t size
, size_t nmemb
, void *opaque
)
215 BDRVCURLState
*s
= opaque
;
216 size_t realsize
= size
* nmemb
;
217 const char *accept_line
= "Accept-Ranges: bytes";
219 if (realsize
>= strlen(accept_line
)
220 && strncmp((char *)ptr
, accept_line
, strlen(accept_line
)) == 0) {
221 s
->accept_range
= true;
227 /* Called from curl_multi_do_locked, with s->mutex held. */
228 static size_t curl_read_cb(void *ptr
, size_t size
, size_t nmemb
, void *opaque
)
230 CURLState
*s
= ((CURLState
*)opaque
);
231 size_t realsize
= size
* nmemb
;
233 trace_curl_read_cb(realsize
);
235 if (!s
|| !s
->orig_buf
) {
239 if (s
->buf_off
>= s
->buf_len
) {
240 /* buffer full, read nothing */
243 realsize
= MIN(realsize
, s
->buf_len
- s
->buf_off
);
244 memcpy(s
->orig_buf
+ s
->buf_off
, ptr
, realsize
);
245 s
->buf_off
+= realsize
;
248 /* curl will error out if we do not return this value */
252 /* Called with s->mutex held. */
253 static bool curl_find_buf(BDRVCURLState
*s
, uint64_t start
, uint64_t len
,
257 uint64_t end
= start
+ len
;
258 uint64_t clamped_end
= MIN(end
, s
->len
);
259 uint64_t clamped_len
= clamped_end
- start
;
261 for (i
=0; i
<CURL_NUM_STATES
; i
++) {
262 CURLState
*state
= &s
->states
[i
];
263 uint64_t buf_end
= (state
->buf_start
+ state
->buf_off
);
264 uint64_t buf_fend
= (state
->buf_start
+ state
->buf_len
);
266 if (!state
->orig_buf
)
271 // Does the existing buffer cover our section?
272 if ((start
>= state
->buf_start
) &&
273 (start
<= buf_end
) &&
274 (clamped_end
>= state
->buf_start
) &&
275 (clamped_end
<= buf_end
))
277 char *buf
= state
->orig_buf
+ (start
- state
->buf_start
);
279 qemu_iovec_from_buf(acb
->qiov
, 0, buf
, clamped_len
);
280 if (clamped_len
< len
) {
281 qemu_iovec_memset(acb
->qiov
, clamped_len
, 0, len
- clamped_len
);
287 // Wait for unfinished chunks
289 (start
>= state
->buf_start
) &&
290 (start
<= buf_fend
) &&
291 (clamped_end
>= state
->buf_start
) &&
292 (clamped_end
<= buf_fend
))
296 acb
->start
= start
- state
->buf_start
;
297 acb
->end
= acb
->start
+ clamped_len
;
299 for (j
=0; j
<CURL_NUM_ACB
; j
++) {
300 if (!state
->acb
[j
]) {
311 /* Called with s->mutex held. */
312 static void curl_multi_check_completion(BDRVCURLState
*s
)
316 /* Try to find done transfers, so we can free the easy
320 msg
= curl_multi_info_read(s
->multi
, &msgs_in_queue
);
322 /* Quit when there are no more completions */
326 if (msg
->msg
== CURLMSG_DONE
) {
328 CURLState
*state
= NULL
;
329 bool error
= msg
->data
.result
!= CURLE_OK
;
331 curl_easy_getinfo(msg
->easy_handle
, CURLINFO_PRIVATE
,
335 static int errcount
= 100;
337 /* Don't lose the original error message from curl, since
338 * it contains extra data.
341 error_report("curl: %s", state
->errmsg
);
342 if (--errcount
== 0) {
343 error_report("curl: further errors suppressed");
348 for (i
= 0; i
< CURL_NUM_ACB
; i
++) {
349 CURLAIOCB
*acb
= state
->acb
[i
];
356 /* Assert that we have read all data */
357 assert(state
->buf_off
>= acb
->end
);
359 qemu_iovec_from_buf(acb
->qiov
, 0,
360 state
->orig_buf
+ acb
->start
,
361 acb
->end
- acb
->start
);
363 if (acb
->end
- acb
->start
< acb
->bytes
) {
364 size_t offset
= acb
->end
- acb
->start
;
365 qemu_iovec_memset(acb
->qiov
, offset
, 0,
366 acb
->bytes
- offset
);
370 acb
->ret
= error
? -EIO
: 0;
371 state
->acb
[i
] = NULL
;
372 qemu_mutex_unlock(&s
->mutex
);
373 aio_co_wake(acb
->co
);
374 qemu_mutex_lock(&s
->mutex
);
377 curl_clean_state(state
);
383 /* Called with s->mutex held. */
384 static void curl_multi_do_locked(CURLSocket
*socket
)
386 BDRVCURLState
*s
= socket
->state
->s
;
395 r
= curl_multi_socket_action(s
->multi
, socket
->fd
, 0, &running
);
396 } while (r
== CURLM_CALL_MULTI_PERFORM
);
399 static void curl_multi_do(void *arg
)
401 CURLSocket
*socket
= arg
;
402 BDRVCURLState
*s
= socket
->state
->s
;
404 qemu_mutex_lock(&s
->mutex
);
405 curl_multi_do_locked(socket
);
406 curl_multi_check_completion(s
);
407 qemu_mutex_unlock(&s
->mutex
);
410 static void curl_multi_timeout_do(void *arg
)
412 #ifdef NEED_CURL_TIMER_CALLBACK
413 BDRVCURLState
*s
= (BDRVCURLState
*)arg
;
420 qemu_mutex_lock(&s
->mutex
);
421 curl_multi_socket_action(s
->multi
, CURL_SOCKET_TIMEOUT
, 0, &running
);
423 curl_multi_check_completion(s
);
424 qemu_mutex_unlock(&s
->mutex
);
430 /* Called with s->mutex held. */
431 static CURLState
*curl_find_state(BDRVCURLState
*s
)
433 CURLState
*state
= NULL
;
436 for (i
= 0; i
< CURL_NUM_STATES
; i
++) {
437 if (!s
->states
[i
].in_use
) {
438 state
= &s
->states
[i
];
446 static int curl_init_state(BDRVCURLState
*s
, CURLState
*state
)
449 state
->curl
= curl_easy_init();
453 curl_easy_setopt(state
->curl
, CURLOPT_URL
, s
->url
);
454 curl_easy_setopt(state
->curl
, CURLOPT_SSL_VERIFYPEER
,
455 (long) s
->sslverify
);
456 curl_easy_setopt(state
->curl
, CURLOPT_SSL_VERIFYHOST
,
457 s
->sslverify
? 2L : 0L);
459 curl_easy_setopt(state
->curl
, CURLOPT_COOKIE
, s
->cookie
);
461 curl_easy_setopt(state
->curl
, CURLOPT_TIMEOUT
, (long)s
->timeout
);
462 curl_easy_setopt(state
->curl
, CURLOPT_WRITEFUNCTION
,
463 (void *)curl_read_cb
);
464 curl_easy_setopt(state
->curl
, CURLOPT_WRITEDATA
, (void *)state
);
465 curl_easy_setopt(state
->curl
, CURLOPT_PRIVATE
, (void *)state
);
466 curl_easy_setopt(state
->curl
, CURLOPT_AUTOREFERER
, 1);
467 curl_easy_setopt(state
->curl
, CURLOPT_FOLLOWLOCATION
, 1);
468 curl_easy_setopt(state
->curl
, CURLOPT_NOSIGNAL
, 1);
469 curl_easy_setopt(state
->curl
, CURLOPT_ERRORBUFFER
, state
->errmsg
);
470 curl_easy_setopt(state
->curl
, CURLOPT_FAILONERROR
, 1);
473 curl_easy_setopt(state
->curl
, CURLOPT_USERNAME
, s
->username
);
476 curl_easy_setopt(state
->curl
, CURLOPT_PASSWORD
, s
->password
);
478 if (s
->proxyusername
) {
479 curl_easy_setopt(state
->curl
,
480 CURLOPT_PROXYUSERNAME
, s
->proxyusername
);
482 if (s
->proxypassword
) {
483 curl_easy_setopt(state
->curl
,
484 CURLOPT_PROXYPASSWORD
, s
->proxypassword
);
487 /* Restrict supported protocols to avoid security issues in the more
488 * obscure protocols. For example, do not allow POP3/SMTP/IMAP see
491 * Restricting protocols is only supported from 7.19.4 upwards.
493 #if LIBCURL_VERSION_NUM >= 0x071304
494 curl_easy_setopt(state
->curl
, CURLOPT_PROTOCOLS
, PROTOCOLS
);
495 curl_easy_setopt(state
->curl
, CURLOPT_REDIR_PROTOCOLS
, PROTOCOLS
);
499 curl_easy_setopt(state
->curl
, CURLOPT_VERBOSE
, 1);
503 QLIST_INIT(&state
->sockets
);
509 /* Called with s->mutex held. */
510 static void curl_clean_state(CURLState
*s
)
513 for (j
= 0; j
< CURL_NUM_ACB
; j
++) {
518 curl_multi_remove_handle(s
->s
->multi
, s
->curl
);
520 while (!QLIST_EMPTY(&s
->sockets
)) {
521 CURLSocket
*socket
= QLIST_FIRST(&s
->sockets
);
523 QLIST_REMOVE(socket
, next
);
529 qemu_co_enter_next(&s
->s
->free_state_waitq
, &s
->s
->mutex
);
532 static void curl_parse_filename(const char *filename
, QDict
*options
,
535 qdict_put_str(options
, CURL_BLOCK_OPT_URL
, filename
);
538 static void curl_detach_aio_context(BlockDriverState
*bs
)
540 BDRVCURLState
*s
= bs
->opaque
;
543 qemu_mutex_lock(&s
->mutex
);
544 for (i
= 0; i
< CURL_NUM_STATES
; i
++) {
545 if (s
->states
[i
].in_use
) {
546 curl_clean_state(&s
->states
[i
]);
548 if (s
->states
[i
].curl
) {
549 curl_easy_cleanup(s
->states
[i
].curl
);
550 s
->states
[i
].curl
= NULL
;
552 g_free(s
->states
[i
].orig_buf
);
553 s
->states
[i
].orig_buf
= NULL
;
556 curl_multi_cleanup(s
->multi
);
559 qemu_mutex_unlock(&s
->mutex
);
561 timer_del(&s
->timer
);
564 static void curl_attach_aio_context(BlockDriverState
*bs
,
565 AioContext
*new_context
)
567 BDRVCURLState
*s
= bs
->opaque
;
569 aio_timer_init(new_context
, &s
->timer
,
570 QEMU_CLOCK_REALTIME
, SCALE_NS
,
571 curl_multi_timeout_do
, s
);
574 s
->multi
= curl_multi_init();
575 s
->aio_context
= new_context
;
576 curl_multi_setopt(s
->multi
, CURLMOPT_SOCKETFUNCTION
, curl_sock_cb
);
577 #ifdef NEED_CURL_TIMER_CALLBACK
578 curl_multi_setopt(s
->multi
, CURLMOPT_TIMERDATA
, s
);
579 curl_multi_setopt(s
->multi
, CURLMOPT_TIMERFUNCTION
, curl_timer_cb
);
583 static QemuOptsList runtime_opts
= {
585 .head
= QTAILQ_HEAD_INITIALIZER(runtime_opts
.head
),
588 .name
= CURL_BLOCK_OPT_URL
,
589 .type
= QEMU_OPT_STRING
,
590 .help
= "URL to open",
593 .name
= CURL_BLOCK_OPT_READAHEAD
,
594 .type
= QEMU_OPT_SIZE
,
595 .help
= "Readahead size",
598 .name
= CURL_BLOCK_OPT_SSLVERIFY
,
599 .type
= QEMU_OPT_BOOL
,
600 .help
= "Verify SSL certificate"
603 .name
= CURL_BLOCK_OPT_TIMEOUT
,
604 .type
= QEMU_OPT_NUMBER
,
605 .help
= "Curl timeout"
608 .name
= CURL_BLOCK_OPT_COOKIE
,
609 .type
= QEMU_OPT_STRING
,
610 .help
= "Pass the cookie or list of cookies with each request"
613 .name
= CURL_BLOCK_OPT_COOKIE_SECRET
,
614 .type
= QEMU_OPT_STRING
,
615 .help
= "ID of secret used as cookie passed with each request"
618 .name
= CURL_BLOCK_OPT_USERNAME
,
619 .type
= QEMU_OPT_STRING
,
620 .help
= "Username for HTTP auth"
623 .name
= CURL_BLOCK_OPT_PASSWORD_SECRET
,
624 .type
= QEMU_OPT_STRING
,
625 .help
= "ID of secret used as password for HTTP auth",
628 .name
= CURL_BLOCK_OPT_PROXY_USERNAME
,
629 .type
= QEMU_OPT_STRING
,
630 .help
= "Username for HTTP proxy auth"
633 .name
= CURL_BLOCK_OPT_PROXY_PASSWORD_SECRET
,
634 .type
= QEMU_OPT_STRING
,
635 .help
= "ID of secret used as password for HTTP proxy auth",
637 { /* end of list */ }
642 static int curl_open(BlockDriverState
*bs
, QDict
*options
, int flags
,
645 BDRVCURLState
*s
= bs
->opaque
;
646 CURLState
*state
= NULL
;
648 Error
*local_err
= NULL
;
651 const char *cookie_secret
;
653 const char *secretid
;
654 const char *protocol_delimiter
;
657 ret
= bdrv_apply_auto_read_only(bs
, "curl driver does not support writes",
663 if (!libcurl_initialized
) {
664 ret
= curl_global_init(CURL_GLOBAL_ALL
);
666 error_setg(errp
, "libcurl initialization failed with %d", ret
);
669 libcurl_initialized
= true;
672 qemu_mutex_init(&s
->mutex
);
673 opts
= qemu_opts_create(&runtime_opts
, NULL
, 0, &error_abort
);
674 qemu_opts_absorb_qdict(opts
, options
, &local_err
);
676 error_propagate(errp
, local_err
);
680 s
->readahead_size
= qemu_opt_get_size(opts
, CURL_BLOCK_OPT_READAHEAD
,
681 CURL_BLOCK_OPT_READAHEAD_DEFAULT
);
682 if ((s
->readahead_size
& 0x1ff) != 0) {
683 error_setg(errp
, "HTTP_READAHEAD_SIZE %zd is not a multiple of 512",
688 s
->timeout
= qemu_opt_get_number(opts
, CURL_BLOCK_OPT_TIMEOUT
,
689 CURL_BLOCK_OPT_TIMEOUT_DEFAULT
);
690 if (s
->timeout
> CURL_TIMEOUT_MAX
) {
691 error_setg(errp
, "timeout parameter is too large or negative");
695 s
->sslverify
= qemu_opt_get_bool(opts
, CURL_BLOCK_OPT_SSLVERIFY
,
696 CURL_BLOCK_OPT_SSLVERIFY_DEFAULT
);
698 cookie
= qemu_opt_get(opts
, CURL_BLOCK_OPT_COOKIE
);
699 cookie_secret
= qemu_opt_get(opts
, CURL_BLOCK_OPT_COOKIE_SECRET
);
701 if (cookie
&& cookie_secret
) {
703 "curl driver cannot handle both cookie and cookie secret");
708 s
->cookie
= qcrypto_secret_lookup_as_utf8(cookie_secret
, errp
);
713 s
->cookie
= g_strdup(cookie
);
716 file
= qemu_opt_get(opts
, CURL_BLOCK_OPT_URL
);
718 error_setg(errp
, "curl block driver requires an 'url' option");
722 if (!strstart(file
, bs
->drv
->protocol_name
, &protocol_delimiter
) ||
723 !strstart(protocol_delimiter
, "://", NULL
))
725 error_setg(errp
, "%s curl driver cannot handle the URL '%s' (does not "
726 "start with '%s://')", bs
->drv
->protocol_name
, file
,
727 bs
->drv
->protocol_name
);
731 s
->username
= g_strdup(qemu_opt_get(opts
, CURL_BLOCK_OPT_USERNAME
));
732 secretid
= qemu_opt_get(opts
, CURL_BLOCK_OPT_PASSWORD_SECRET
);
735 s
->password
= qcrypto_secret_lookup_as_utf8(secretid
, errp
);
741 s
->proxyusername
= g_strdup(
742 qemu_opt_get(opts
, CURL_BLOCK_OPT_PROXY_USERNAME
));
743 secretid
= qemu_opt_get(opts
, CURL_BLOCK_OPT_PROXY_PASSWORD_SECRET
);
745 s
->proxypassword
= qcrypto_secret_lookup_as_utf8(secretid
, errp
);
746 if (!s
->proxypassword
) {
751 trace_curl_open(file
);
752 qemu_co_queue_init(&s
->free_state_waitq
);
753 s
->aio_context
= bdrv_get_aio_context(bs
);
754 s
->url
= g_strdup(file
);
755 qemu_mutex_lock(&s
->mutex
);
756 state
= curl_find_state(s
);
757 qemu_mutex_unlock(&s
->mutex
);
764 if (curl_init_state(s
, state
) < 0) {
768 s
->accept_range
= false;
769 curl_easy_setopt(state
->curl
, CURLOPT_NOBODY
, 1);
770 curl_easy_setopt(state
->curl
, CURLOPT_HEADERFUNCTION
,
772 curl_easy_setopt(state
->curl
, CURLOPT_HEADERDATA
, s
);
773 if (curl_easy_perform(state
->curl
))
775 if (curl_easy_getinfo(state
->curl
, CURLINFO_CONTENT_LENGTH_DOWNLOAD
, &d
)) {
778 /* Prior CURL 7.19.4 return value of 0 could mean that the file size is not
779 * know or the size is zero. From 7.19.4 CURL returns -1 if size is not
780 * known and zero if it is really zero-length file. */
781 #if LIBCURL_VERSION_NUM >= 0x071304
783 pstrcpy(state
->errmsg
, CURL_ERROR_SIZE
,
784 "Server didn't report file size.");
789 pstrcpy(state
->errmsg
, CURL_ERROR_SIZE
,
790 "Unknown file size or zero-length file.");
797 if ((!strncasecmp(s
->url
, "http://", strlen("http://"))
798 || !strncasecmp(s
->url
, "https://", strlen("https://")))
799 && !s
->accept_range
) {
800 pstrcpy(state
->errmsg
, CURL_ERROR_SIZE
,
801 "Server does not support 'range' (byte ranges).");
804 trace_curl_open_size(s
->len
);
806 qemu_mutex_lock(&s
->mutex
);
807 curl_clean_state(state
);
808 qemu_mutex_unlock(&s
->mutex
);
809 curl_easy_cleanup(state
->curl
);
812 curl_attach_aio_context(bs
, bdrv_get_aio_context(bs
));
818 error_setg(errp
, "CURL: Error opening file: %s", state
->errmsg
);
819 curl_easy_cleanup(state
->curl
);
822 qemu_mutex_destroy(&s
->mutex
);
826 g_free(s
->proxyusername
);
827 g_free(s
->proxypassword
);
832 static void curl_setup_preadv(BlockDriverState
*bs
, CURLAIOCB
*acb
)
837 BDRVCURLState
*s
= bs
->opaque
;
839 uint64_t start
= acb
->offset
;
842 qemu_mutex_lock(&s
->mutex
);
844 // In case we have the requested data already (e.g. read-ahead),
845 // we can just call the callback and be done.
846 if (curl_find_buf(s
, start
, acb
->bytes
, acb
)) {
850 // No cache found, so let's start a new request
852 state
= curl_find_state(s
);
856 qemu_co_queue_wait(&s
->free_state_waitq
, &s
->mutex
);
859 if (curl_init_state(s
, state
) < 0) {
860 curl_clean_state(state
);
866 acb
->end
= MIN(acb
->bytes
, s
->len
- start
);
869 g_free(state
->orig_buf
);
870 state
->buf_start
= start
;
871 state
->buf_len
= MIN(acb
->end
+ s
->readahead_size
, s
->len
- start
);
872 end
= start
+ state
->buf_len
- 1;
873 state
->orig_buf
= g_try_malloc(state
->buf_len
);
874 if (state
->buf_len
&& state
->orig_buf
== NULL
) {
875 curl_clean_state(state
);
881 snprintf(state
->range
, 127, "%" PRIu64
"-%" PRIu64
, start
, end
);
882 trace_curl_setup_preadv(acb
->bytes
, start
, state
->range
);
883 curl_easy_setopt(state
->curl
, CURLOPT_RANGE
, state
->range
);
885 if (curl_multi_add_handle(s
->multi
, state
->curl
) != CURLM_OK
) {
886 state
->acb
[0] = NULL
;
889 curl_clean_state(state
);
893 /* Tell curl it needs to kick things off */
894 curl_multi_socket_action(s
->multi
, CURL_SOCKET_TIMEOUT
, 0, &running
);
897 qemu_mutex_unlock(&s
->mutex
);
900 static int coroutine_fn
curl_co_preadv(BlockDriverState
*bs
,
901 uint64_t offset
, uint64_t bytes
, QEMUIOVector
*qiov
, int flags
)
904 .co
= qemu_coroutine_self(),
911 curl_setup_preadv(bs
, &acb
);
912 while (acb
.ret
== -EINPROGRESS
) {
913 qemu_coroutine_yield();
918 static void curl_close(BlockDriverState
*bs
)
920 BDRVCURLState
*s
= bs
->opaque
;
923 curl_detach_aio_context(bs
);
924 qemu_mutex_destroy(&s
->mutex
);
929 g_free(s
->proxyusername
);
930 g_free(s
->proxypassword
);
933 static int64_t curl_getlength(BlockDriverState
*bs
)
935 BDRVCURLState
*s
= bs
->opaque
;
939 static void curl_refresh_filename(BlockDriverState
*bs
)
941 BDRVCURLState
*s
= bs
->opaque
;
943 /* "readahead" and "timeout" do not change the guest-visible data,
945 if (s
->sslverify
!= CURL_BLOCK_OPT_SSLVERIFY_DEFAULT
||
946 s
->cookie
|| s
->username
|| s
->password
|| s
->proxyusername
||
952 pstrcpy(bs
->exact_filename
, sizeof(bs
->exact_filename
), s
->url
);
956 static const char *const curl_strong_runtime_opts
[] = {
958 CURL_BLOCK_OPT_SSLVERIFY
,
959 CURL_BLOCK_OPT_COOKIE
,
960 CURL_BLOCK_OPT_COOKIE_SECRET
,
961 CURL_BLOCK_OPT_USERNAME
,
962 CURL_BLOCK_OPT_PASSWORD_SECRET
,
963 CURL_BLOCK_OPT_PROXY_USERNAME
,
964 CURL_BLOCK_OPT_PROXY_PASSWORD_SECRET
,
969 static BlockDriver bdrv_http
= {
970 .format_name
= "http",
971 .protocol_name
= "http",
973 .instance_size
= sizeof(BDRVCURLState
),
974 .bdrv_parse_filename
= curl_parse_filename
,
975 .bdrv_file_open
= curl_open
,
976 .bdrv_close
= curl_close
,
977 .bdrv_getlength
= curl_getlength
,
979 .bdrv_co_preadv
= curl_co_preadv
,
981 .bdrv_detach_aio_context
= curl_detach_aio_context
,
982 .bdrv_attach_aio_context
= curl_attach_aio_context
,
984 .bdrv_refresh_filename
= curl_refresh_filename
,
985 .strong_runtime_opts
= curl_strong_runtime_opts
,
988 static BlockDriver bdrv_https
= {
989 .format_name
= "https",
990 .protocol_name
= "https",
992 .instance_size
= sizeof(BDRVCURLState
),
993 .bdrv_parse_filename
= curl_parse_filename
,
994 .bdrv_file_open
= curl_open
,
995 .bdrv_close
= curl_close
,
996 .bdrv_getlength
= curl_getlength
,
998 .bdrv_co_preadv
= curl_co_preadv
,
1000 .bdrv_detach_aio_context
= curl_detach_aio_context
,
1001 .bdrv_attach_aio_context
= curl_attach_aio_context
,
1003 .bdrv_refresh_filename
= curl_refresh_filename
,
1004 .strong_runtime_opts
= curl_strong_runtime_opts
,
1007 static BlockDriver bdrv_ftp
= {
1008 .format_name
= "ftp",
1009 .protocol_name
= "ftp",
1011 .instance_size
= sizeof(BDRVCURLState
),
1012 .bdrv_parse_filename
= curl_parse_filename
,
1013 .bdrv_file_open
= curl_open
,
1014 .bdrv_close
= curl_close
,
1015 .bdrv_getlength
= curl_getlength
,
1017 .bdrv_co_preadv
= curl_co_preadv
,
1019 .bdrv_detach_aio_context
= curl_detach_aio_context
,
1020 .bdrv_attach_aio_context
= curl_attach_aio_context
,
1022 .bdrv_refresh_filename
= curl_refresh_filename
,
1023 .strong_runtime_opts
= curl_strong_runtime_opts
,
1026 static BlockDriver bdrv_ftps
= {
1027 .format_name
= "ftps",
1028 .protocol_name
= "ftps",
1030 .instance_size
= sizeof(BDRVCURLState
),
1031 .bdrv_parse_filename
= curl_parse_filename
,
1032 .bdrv_file_open
= curl_open
,
1033 .bdrv_close
= curl_close
,
1034 .bdrv_getlength
= curl_getlength
,
1036 .bdrv_co_preadv
= curl_co_preadv
,
1038 .bdrv_detach_aio_context
= curl_detach_aio_context
,
1039 .bdrv_attach_aio_context
= curl_attach_aio_context
,
1041 .bdrv_refresh_filename
= curl_refresh_filename
,
1042 .strong_runtime_opts
= curl_strong_runtime_opts
,
1045 static void curl_block_init(void)
1047 bdrv_register(&bdrv_http
);
1048 bdrv_register(&bdrv_https
);
1049 bdrv_register(&bdrv_ftp
);
1050 bdrv_register(&bdrv_ftps
);
1053 block_init(curl_block_init
);