1 #include "git-compat-util.h"
5 #include "run-command.h"
8 #include "credential.h"
14 size_t http_post_buffer = 16 * LARGE_PACKET_MAX;
16 #if LIBCURL_VERSION_NUM >= 0x070a06
17 #define LIBCURL_CAN_HANDLE_AUTH_ANY
20 static int min_curl_sessions = 1;
21 static int curl_session_count;
23 static int max_requests = -1;
26 #ifndef NO_CURL_EASY_DUPHANDLE
27 static CURL *curl_default;
30 #define PREV_BUF_SIZE 4096
31 #define RANGE_HEADER_SIZE 30
33 char curl_errorstr[CURL_ERROR_SIZE];
35 static int curl_ssl_verify = -1;
36 static int curl_ssl_try;
37 static const char *ssl_cert;
38 #if LIBCURL_VERSION_NUM >= 0x070903
39 static const char *ssl_key;
41 #if LIBCURL_VERSION_NUM >= 0x070908
42 static const char *ssl_capath;
44 static const char *ssl_cainfo;
45 static long curl_low_speed_limit = -1;
46 static long curl_low_speed_time = -1;
47 static int curl_ftp_no_epsv;
48 static const char *curl_http_proxy;
49 static const char *curl_cookie_file;
50 static int curl_save_cookies;
51 struct credential http_auth = CREDENTIAL_INIT;
52 static int http_proactive_auth;
53 static const char *user_agent;
55 #if LIBCURL_VERSION_NUM >= 0x071700
56 /* Use CURLOPT_KEYPASSWD as is */
57 #elif LIBCURL_VERSION_NUM >= 0x070903
58 #define CURLOPT_KEYPASSWD CURLOPT_SSLKEYPASSWD
60 #define CURLOPT_KEYPASSWD CURLOPT_SSLCERTPASSWD
63 static struct credential cert_auth = CREDENTIAL_INIT;
64 static int ssl_cert_password_required;
66 static struct curl_slist *pragma_header;
67 static struct curl_slist *no_pragma_header;
69 static struct active_request_slot *active_queue_head;
71 static char *cached_accept_language;
73 size_t fread_buffer(char *ptr, size_t eltsize, size_t nmemb, void *buffer_)
75 size_t size = eltsize * nmemb;
76 struct buffer *buffer = buffer_;
78 if (size > buffer->buf.len - buffer->posn)
79 size = buffer->buf.len - buffer->posn;
80 memcpy(ptr, buffer->buf.buf + buffer->posn, size);
87 curlioerr ioctl_buffer(CURL *handle, int cmd, void *clientp)
89 struct buffer *buffer = clientp;
95 case CURLIOCMD_RESTARTREAD:
100 return CURLIOE_UNKNOWNCMD;
105 size_t fwrite_buffer(char *ptr, size_t eltsize, size_t nmemb, void *buffer_)
107 size_t size = eltsize * nmemb;
108 struct strbuf *buffer = buffer_;
110 strbuf_add(buffer, ptr, size);
114 size_t fwrite_null(char *ptr, size_t eltsize, size_t nmemb, void *strbuf)
116 return eltsize * nmemb;
119 #ifdef USE_CURL_MULTI
120 static void process_curl_messages(void)
123 struct active_request_slot *slot;
124 CURLMsg *curl_message = curl_multi_info_read(curlm, &num_messages);
126 while (curl_message != NULL) {
127 if (curl_message->msg == CURLMSG_DONE) {
128 int curl_result = curl_message->data.result;
129 slot = active_queue_head;
130 while (slot != NULL &&
131 slot->curl != curl_message->easy_handle)
134 curl_multi_remove_handle(curlm, slot->curl);
135 slot->curl_result = curl_result;
136 finish_active_slot(slot);
138 fprintf(stderr, "Received DONE message for unknown request!\n");
141 fprintf(stderr, "Unknown CURL message received: %d\n",
142 (int)curl_message->msg);
144 curl_message = curl_multi_info_read(curlm, &num_messages);
149 static int http_options(const char *var, const char *value, void *cb)
151 if (!strcmp("http.sslverify", var)) {
152 curl_ssl_verify = git_config_bool(var, value);
155 if (!strcmp("http.sslcert", var))
156 return git_config_string(&ssl_cert, var, value);
157 #if LIBCURL_VERSION_NUM >= 0x070903
158 if (!strcmp("http.sslkey", var))
159 return git_config_string(&ssl_key, var, value);
161 #if LIBCURL_VERSION_NUM >= 0x070908
162 if (!strcmp("http.sslcapath", var))
163 return git_config_string(&ssl_capath, var, value);
165 if (!strcmp("http.sslcainfo", var))
166 return git_config_string(&ssl_cainfo, var, value);
167 if (!strcmp("http.sslcertpasswordprotected", var)) {
168 ssl_cert_password_required = git_config_bool(var, value);
171 if (!strcmp("http.ssltry", var)) {
172 curl_ssl_try = git_config_bool(var, value);
175 if (!strcmp("http.minsessions", var)) {
176 min_curl_sessions = git_config_int(var, value);
177 #ifndef USE_CURL_MULTI
178 if (min_curl_sessions > 1)
179 min_curl_sessions = 1;
183 #ifdef USE_CURL_MULTI
184 if (!strcmp("http.maxrequests", var)) {
185 max_requests = git_config_int(var, value);
189 if (!strcmp("http.lowspeedlimit", var)) {
190 curl_low_speed_limit = (long)git_config_int(var, value);
193 if (!strcmp("http.lowspeedtime", var)) {
194 curl_low_speed_time = (long)git_config_int(var, value);
198 if (!strcmp("http.noepsv", var)) {
199 curl_ftp_no_epsv = git_config_bool(var, value);
202 if (!strcmp("http.proxy", var))
203 return git_config_string(&curl_http_proxy, var, value);
205 if (!strcmp("http.cookiefile", var))
206 return git_config_string(&curl_cookie_file, var, value);
207 if (!strcmp("http.savecookies", var)) {
208 curl_save_cookies = git_config_bool(var, value);
212 if (!strcmp("http.postbuffer", var)) {
213 http_post_buffer = git_config_int(var, value);
214 if (http_post_buffer < LARGE_PACKET_MAX)
215 http_post_buffer = LARGE_PACKET_MAX;
219 if (!strcmp("http.useragent", var))
220 return git_config_string(&user_agent, var, value);
222 /* Fall back on the default ones */
223 return git_default_config(var, value, cb);
226 static void init_curl_http_auth(CURL *result)
228 if (!http_auth.username)
231 credential_fill(&http_auth);
233 #if LIBCURL_VERSION_NUM >= 0x071301
234 curl_easy_setopt(result, CURLOPT_USERNAME, http_auth.username);
235 curl_easy_setopt(result, CURLOPT_PASSWORD, http_auth.password);
238 static struct strbuf up = STRBUF_INIT;
240 * Note that we assume we only ever have a single set of
241 * credentials in a given program run, so we do not have
242 * to worry about updating this buffer, only setting its
246 strbuf_addf(&up, "%s:%s",
247 http_auth.username, http_auth.password);
248 curl_easy_setopt(result, CURLOPT_USERPWD, up.buf);
253 static int has_cert_password(void)
255 if (ssl_cert == NULL || ssl_cert_password_required != 1)
257 if (!cert_auth.password) {
258 cert_auth.protocol = xstrdup("cert");
259 cert_auth.username = xstrdup("");
260 cert_auth.path = xstrdup(ssl_cert);
261 credential_fill(&cert_auth);
266 #if LIBCURL_VERSION_NUM >= 0x071900
267 static void set_curl_keepalive(CURL *c)
269 curl_easy_setopt(c, CURLOPT_TCP_KEEPALIVE, 1);
272 #elif LIBCURL_VERSION_NUM >= 0x071000
273 static int sockopt_callback(void *client, curl_socket_t fd, curlsocktype type)
277 socklen_t len = (socklen_t)sizeof(ka);
279 if (type != CURLSOCKTYPE_IPCXN)
282 rc = setsockopt(fd, SOL_SOCKET, SO_KEEPALIVE, (void *)&ka, len);
284 warning("unable to set SO_KEEPALIVE on socket %s",
287 return 0; /* CURL_SOCKOPT_OK only exists since curl 7.21.5 */
290 static void set_curl_keepalive(CURL *c)
292 curl_easy_setopt(c, CURLOPT_SOCKOPTFUNCTION, sockopt_callback);
296 static void set_curl_keepalive(CURL *c)
298 /* not supported on older curl versions */
302 static CURL *get_curl_handle(void)
304 CURL *result = curl_easy_init();
307 die("curl_easy_init failed");
309 if (!curl_ssl_verify) {
310 curl_easy_setopt(result, CURLOPT_SSL_VERIFYPEER, 0);
311 curl_easy_setopt(result, CURLOPT_SSL_VERIFYHOST, 0);
313 /* Verify authenticity of the peer's certificate */
314 curl_easy_setopt(result, CURLOPT_SSL_VERIFYPEER, 1);
315 /* The name in the cert must match whom we tried to connect */
316 curl_easy_setopt(result, CURLOPT_SSL_VERIFYHOST, 2);
319 #if LIBCURL_VERSION_NUM >= 0x070907
320 curl_easy_setopt(result, CURLOPT_NETRC, CURL_NETRC_OPTIONAL);
322 #ifdef LIBCURL_CAN_HANDLE_AUTH_ANY
323 curl_easy_setopt(result, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
326 if (http_proactive_auth)
327 init_curl_http_auth(result);
329 if (ssl_cert != NULL)
330 curl_easy_setopt(result, CURLOPT_SSLCERT, ssl_cert);
331 if (has_cert_password())
332 curl_easy_setopt(result, CURLOPT_KEYPASSWD, cert_auth.password);
333 #if LIBCURL_VERSION_NUM >= 0x070903
335 curl_easy_setopt(result, CURLOPT_SSLKEY, ssl_key);
337 #if LIBCURL_VERSION_NUM >= 0x070908
338 if (ssl_capath != NULL)
339 curl_easy_setopt(result, CURLOPT_CAPATH, ssl_capath);
341 if (ssl_cainfo != NULL)
342 curl_easy_setopt(result, CURLOPT_CAINFO, ssl_cainfo);
344 if (curl_low_speed_limit > 0 && curl_low_speed_time > 0) {
345 curl_easy_setopt(result, CURLOPT_LOW_SPEED_LIMIT,
346 curl_low_speed_limit);
347 curl_easy_setopt(result, CURLOPT_LOW_SPEED_TIME,
348 curl_low_speed_time);
351 curl_easy_setopt(result, CURLOPT_FOLLOWLOCATION, 1);
352 #if LIBCURL_VERSION_NUM >= 0x071301
353 curl_easy_setopt(result, CURLOPT_POSTREDIR, CURL_REDIR_POST_ALL);
354 #elif LIBCURL_VERSION_NUM >= 0x071101
355 curl_easy_setopt(result, CURLOPT_POST301, 1);
358 if (getenv("GIT_CURL_VERBOSE"))
359 curl_easy_setopt(result, CURLOPT_VERBOSE, 1);
361 curl_easy_setopt(result, CURLOPT_USERAGENT,
362 user_agent ? user_agent : git_user_agent());
364 if (curl_ftp_no_epsv)
365 curl_easy_setopt(result, CURLOPT_FTP_USE_EPSV, 0);
367 #ifdef CURLOPT_USE_SSL
369 curl_easy_setopt(result, CURLOPT_USE_SSL, CURLUSESSL_TRY);
372 if (curl_http_proxy) {
373 curl_easy_setopt(result, CURLOPT_PROXY, curl_http_proxy);
374 curl_easy_setopt(result, CURLOPT_PROXYAUTH, CURLAUTH_ANY);
377 set_curl_keepalive(result);
382 static void set_from_env(const char **var, const char *envname)
384 const char *val = getenv(envname);
389 void http_init(struct remote *remote, const char *url, int proactive_auth)
391 char *low_speed_limit;
392 char *low_speed_time;
393 char *normalized_url;
394 struct urlmatch_config config = { STRING_LIST_INIT_DUP };
396 config.section = "http";
398 config.collect_fn = http_options;
399 config.cascade_fn = git_default_config;
403 normalized_url = url_normalize(url, &config.url);
405 git_config(urlmatch_config_entry, &config);
406 free(normalized_url);
408 if (curl_global_init(CURL_GLOBAL_ALL) != CURLE_OK)
409 die("curl_global_init failed");
411 http_proactive_auth = proactive_auth;
413 if (remote && remote->http_proxy)
414 curl_http_proxy = xstrdup(remote->http_proxy);
416 pragma_header = curl_slist_append(pragma_header, "Pragma: no-cache");
417 no_pragma_header = curl_slist_append(no_pragma_header, "Pragma:");
419 #ifdef USE_CURL_MULTI
421 char *http_max_requests = getenv("GIT_HTTP_MAX_REQUESTS");
422 if (http_max_requests != NULL)
423 max_requests = atoi(http_max_requests);
426 curlm = curl_multi_init();
428 die("curl_multi_init failed");
431 if (getenv("GIT_SSL_NO_VERIFY"))
434 set_from_env(&ssl_cert, "GIT_SSL_CERT");
435 #if LIBCURL_VERSION_NUM >= 0x070903
436 set_from_env(&ssl_key, "GIT_SSL_KEY");
438 #if LIBCURL_VERSION_NUM >= 0x070908
439 set_from_env(&ssl_capath, "GIT_SSL_CAPATH");
441 set_from_env(&ssl_cainfo, "GIT_SSL_CAINFO");
443 set_from_env(&user_agent, "GIT_HTTP_USER_AGENT");
445 low_speed_limit = getenv("GIT_HTTP_LOW_SPEED_LIMIT");
446 if (low_speed_limit != NULL)
447 curl_low_speed_limit = strtol(low_speed_limit, NULL, 10);
448 low_speed_time = getenv("GIT_HTTP_LOW_SPEED_TIME");
449 if (low_speed_time != NULL)
450 curl_low_speed_time = strtol(low_speed_time, NULL, 10);
452 if (curl_ssl_verify == -1)
455 curl_session_count = 0;
456 #ifdef USE_CURL_MULTI
457 if (max_requests < 1)
458 max_requests = DEFAULT_MAX_REQUESTS;
461 if (getenv("GIT_CURL_FTP_NO_EPSV"))
462 curl_ftp_no_epsv = 1;
465 credential_from_url(&http_auth, url);
466 if (!ssl_cert_password_required &&
467 getenv("GIT_SSL_CERT_PASSWORD_PROTECTED") &&
468 starts_with(url, "https://"))
469 ssl_cert_password_required = 1;
472 #ifndef NO_CURL_EASY_DUPHANDLE
473 curl_default = get_curl_handle();
477 void http_cleanup(void)
479 struct active_request_slot *slot = active_queue_head;
481 while (slot != NULL) {
482 struct active_request_slot *next = slot->next;
483 if (slot->curl != NULL) {
484 #ifdef USE_CURL_MULTI
485 curl_multi_remove_handle(curlm, slot->curl);
487 curl_easy_cleanup(slot->curl);
492 active_queue_head = NULL;
494 #ifndef NO_CURL_EASY_DUPHANDLE
495 curl_easy_cleanup(curl_default);
498 #ifdef USE_CURL_MULTI
499 curl_multi_cleanup(curlm);
501 curl_global_cleanup();
503 curl_slist_free_all(pragma_header);
504 pragma_header = NULL;
506 curl_slist_free_all(no_pragma_header);
507 no_pragma_header = NULL;
509 if (curl_http_proxy) {
510 free((void *)curl_http_proxy);
511 curl_http_proxy = NULL;
514 if (cert_auth.password != NULL) {
515 memset(cert_auth.password, 0, strlen(cert_auth.password));
516 free(cert_auth.password);
517 cert_auth.password = NULL;
519 ssl_cert_password_required = 0;
521 free(cached_accept_language);
522 cached_accept_language = NULL;
525 struct active_request_slot *get_active_slot(void)
527 struct active_request_slot *slot = active_queue_head;
528 struct active_request_slot *newslot;
530 #ifdef USE_CURL_MULTI
533 /* Wait for a slot to open up if the queue is full */
534 while (active_requests >= max_requests) {
535 curl_multi_perform(curlm, &num_transfers);
536 if (num_transfers < active_requests)
537 process_curl_messages();
541 while (slot != NULL && slot->in_use)
545 newslot = xmalloc(sizeof(*newslot));
546 newslot->curl = NULL;
548 newslot->next = NULL;
550 slot = active_queue_head;
552 active_queue_head = newslot;
554 while (slot->next != NULL)
556 slot->next = newslot;
561 if (slot->curl == NULL) {
562 #ifdef NO_CURL_EASY_DUPHANDLE
563 slot->curl = get_curl_handle();
565 slot->curl = curl_easy_duphandle(curl_default);
567 curl_session_count++;
572 slot->results = NULL;
573 slot->finished = NULL;
574 slot->callback_data = NULL;
575 slot->callback_func = NULL;
576 curl_easy_setopt(slot->curl, CURLOPT_COOKIEFILE, curl_cookie_file);
577 if (curl_save_cookies)
578 curl_easy_setopt(slot->curl, CURLOPT_COOKIEJAR, curl_cookie_file);
579 curl_easy_setopt(slot->curl, CURLOPT_HTTPHEADER, pragma_header);
580 curl_easy_setopt(slot->curl, CURLOPT_ERRORBUFFER, curl_errorstr);
581 curl_easy_setopt(slot->curl, CURLOPT_CUSTOMREQUEST, NULL);
582 curl_easy_setopt(slot->curl, CURLOPT_READFUNCTION, NULL);
583 curl_easy_setopt(slot->curl, CURLOPT_WRITEFUNCTION, NULL);
584 curl_easy_setopt(slot->curl, CURLOPT_POSTFIELDS, NULL);
585 curl_easy_setopt(slot->curl, CURLOPT_UPLOAD, 0);
586 curl_easy_setopt(slot->curl, CURLOPT_HTTPGET, 1);
587 curl_easy_setopt(slot->curl, CURLOPT_FAILONERROR, 1);
588 if (http_auth.password)
589 init_curl_http_auth(slot->curl);
594 int start_active_slot(struct active_request_slot *slot)
596 #ifdef USE_CURL_MULTI
597 CURLMcode curlm_result = curl_multi_add_handle(curlm, slot->curl);
600 if (curlm_result != CURLM_OK &&
601 curlm_result != CURLM_CALL_MULTI_PERFORM) {
608 * We know there must be something to do, since we just added
611 curl_multi_perform(curlm, &num_transfers);
616 #ifdef USE_CURL_MULTI
620 struct fill_chain *next;
623 static struct fill_chain *fill_cfg;
625 void add_fill_function(void *data, int (*fill)(void *))
627 struct fill_chain *new = xmalloc(sizeof(*new));
628 struct fill_chain **linkp = &fill_cfg;
633 linkp = &(*linkp)->next;
637 void fill_active_slots(void)
639 struct active_request_slot *slot = active_queue_head;
641 while (active_requests < max_requests) {
642 struct fill_chain *fill;
643 for (fill = fill_cfg; fill; fill = fill->next)
644 if (fill->fill(fill->data))
651 while (slot != NULL) {
652 if (!slot->in_use && slot->curl != NULL
653 && curl_session_count > min_curl_sessions) {
654 curl_easy_cleanup(slot->curl);
656 curl_session_count--;
662 void step_active_slots(void)
665 CURLMcode curlm_result;
668 curlm_result = curl_multi_perform(curlm, &num_transfers);
669 } while (curlm_result == CURLM_CALL_MULTI_PERFORM);
670 if (num_transfers < active_requests) {
671 process_curl_messages();
677 void run_active_slot(struct active_request_slot *slot)
679 #ifdef USE_CURL_MULTI
684 struct timeval select_timeout;
687 slot->finished = &finished;
692 #if LIBCURL_VERSION_NUM >= 0x070f04
694 curl_multi_timeout(curlm, &curl_timeout);
695 if (curl_timeout == 0) {
697 } else if (curl_timeout == -1) {
698 select_timeout.tv_sec = 0;
699 select_timeout.tv_usec = 50000;
701 select_timeout.tv_sec = curl_timeout / 1000;
702 select_timeout.tv_usec = (curl_timeout % 1000) * 1000;
705 select_timeout.tv_sec = 0;
706 select_timeout.tv_usec = 50000;
713 curl_multi_fdset(curlm, &readfds, &writefds, &excfds, &max_fd);
716 * It can happen that curl_multi_timeout returns a pathologically
717 * long timeout when curl_multi_fdset returns no file descriptors
718 * to read. See commit message for more details.
721 (select_timeout.tv_sec > 0 ||
722 select_timeout.tv_usec > 50000)) {
723 select_timeout.tv_sec = 0;
724 select_timeout.tv_usec = 50000;
727 select(max_fd+1, &readfds, &writefds, &excfds, &select_timeout);
731 while (slot->in_use) {
732 slot->curl_result = curl_easy_perform(slot->curl);
733 finish_active_slot(slot);
738 static void closedown_active_slot(struct active_request_slot *slot)
744 static void release_active_slot(struct active_request_slot *slot)
746 closedown_active_slot(slot);
747 if (slot->curl && curl_session_count > min_curl_sessions) {
748 #ifdef USE_CURL_MULTI
749 curl_multi_remove_handle(curlm, slot->curl);
751 curl_easy_cleanup(slot->curl);
753 curl_session_count--;
755 #ifdef USE_CURL_MULTI
760 void finish_active_slot(struct active_request_slot *slot)
762 closedown_active_slot(slot);
763 curl_easy_getinfo(slot->curl, CURLINFO_HTTP_CODE, &slot->http_code);
765 if (slot->finished != NULL)
766 (*slot->finished) = 1;
768 /* Store slot results so they can be read after the slot is reused */
769 if (slot->results != NULL) {
770 slot->results->curl_result = slot->curl_result;
771 slot->results->http_code = slot->http_code;
772 #if LIBCURL_VERSION_NUM >= 0x070a08
773 curl_easy_getinfo(slot->curl, CURLINFO_HTTPAUTH_AVAIL,
774 &slot->results->auth_avail);
776 slot->results->auth_avail = 0;
780 /* Run callback if appropriate */
781 if (slot->callback_func != NULL)
782 slot->callback_func(slot->callback_data);
785 void finish_all_active_slots(void)
787 struct active_request_slot *slot = active_queue_head;
791 run_active_slot(slot);
792 slot = active_queue_head;
798 /* Helpers for modifying and creating URLs */
799 static inline int needs_quote(int ch)
801 if (((ch >= 'A') && (ch <= 'Z'))
802 || ((ch >= 'a') && (ch <= 'z'))
803 || ((ch >= '0') && (ch <= '9'))
811 static char *quote_ref_url(const char *base, const char *ref)
813 struct strbuf buf = STRBUF_INIT;
817 end_url_with_slash(&buf, base);
819 for (cp = ref; (ch = *cp) != 0; cp++)
821 strbuf_addf(&buf, "%%%02x", ch);
823 strbuf_addch(&buf, *cp);
825 return strbuf_detach(&buf, NULL);
828 void append_remote_object_url(struct strbuf *buf, const char *url,
830 int only_two_digit_prefix)
832 end_url_with_slash(buf, url);
834 strbuf_addf(buf, "objects/%.*s/", 2, hex);
835 if (!only_two_digit_prefix)
836 strbuf_addf(buf, "%s", hex+2);
839 char *get_remote_object_url(const char *url, const char *hex,
840 int only_two_digit_prefix)
842 struct strbuf buf = STRBUF_INIT;
843 append_remote_object_url(&buf, url, hex, only_two_digit_prefix);
844 return strbuf_detach(&buf, NULL);
847 int handle_curl_result(struct slot_results *results)
850 * If we see a failing http code with CURLE_OK, we have turned off
851 * FAILONERROR (to keep the server's custom error response), and should
852 * translate the code into failure here.
854 if (results->curl_result == CURLE_OK &&
855 results->http_code >= 400) {
856 results->curl_result = CURLE_HTTP_RETURNED_ERROR;
858 * Normally curl will already have put the "reason phrase"
859 * from the server into curl_errorstr; unfortunately without
860 * FAILONERROR it is lost, so we can give only the numeric
863 snprintf(curl_errorstr, sizeof(curl_errorstr),
864 "The requested URL returned error: %ld",
868 if (results->curl_result == CURLE_OK) {
869 credential_approve(&http_auth);
871 } else if (missing_target(results))
872 return HTTP_MISSING_TARGET;
873 else if (results->http_code == 401) {
874 if (http_auth.username && http_auth.password) {
875 credential_reject(&http_auth);
881 #if LIBCURL_VERSION_NUM >= 0x070c00
882 if (!curl_errorstr[0])
883 strlcpy(curl_errorstr,
884 curl_easy_strerror(results->curl_result),
885 sizeof(curl_errorstr));
891 int run_one_slot(struct active_request_slot *slot,
892 struct slot_results *results)
894 slot->results = results;
895 if (!start_active_slot(slot)) {
896 snprintf(curl_errorstr, sizeof(curl_errorstr),
897 "failed to start HTTP request");
898 return HTTP_START_FAILED;
901 run_active_slot(slot);
902 return handle_curl_result(results);
905 static CURLcode curlinfo_strbuf(CURL *curl, CURLINFO info, struct strbuf *buf)
911 ret = curl_easy_getinfo(curl, info, &ptr);
913 strbuf_addstr(buf, ptr);
918 * Check for and extract a content-type parameter. "raw"
919 * should be positioned at the start of the potential
920 * parameter, with any whitespace already removed.
922 * "name" is the name of the parameter. The value is appended
925 static int extract_param(const char *raw, const char *name,
928 size_t len = strlen(name);
930 if (strncasecmp(raw, name, len))
938 while (*raw && !isspace(*raw) && *raw != ';')
939 strbuf_addch(out, *raw++);
944 * Extract a normalized version of the content type, with any
945 * spaces suppressed, all letters lowercased, and no trailing ";"
948 * Note that we will silently remove even invalid whitespace. For
949 * example, "text / plain" is specifically forbidden by RFC 2616,
950 * but "text/plain" is the only reasonable output, and this keeps
953 * If the "charset" argument is not NULL, store the value of any
954 * charset parameter there.
957 * "TEXT/PLAIN; charset=utf-8" -> "text/plain", "utf-8"
958 * "text / plain" -> "text/plain"
960 static void extract_content_type(struct strbuf *raw, struct strbuf *type,
961 struct strbuf *charset)
966 strbuf_grow(type, raw->len);
967 for (p = raw->buf; *p; p++) {
974 strbuf_addch(type, tolower(*p));
980 strbuf_reset(charset);
982 while (isspace(*p) || *p == ';')
984 if (!extract_param(p, "charset", charset))
986 while (*p && !isspace(*p))
990 if (!charset->len && starts_with(type->buf, "text/"))
991 strbuf_addstr(charset, "ISO-8859-1");
995 * Guess the user's preferred languages from the value in LANGUAGE environment
996 * variable and LC_MESSAGES locale category if NO_GETTEXT is not defined.
998 * The result can be a colon-separated list like "ko:ja:en".
1000 static const char *get_preferred_languages(void)
1004 retval = getenv("LANGUAGE");
1005 if (retval && *retval)
1009 retval = setlocale(LC_MESSAGES, NULL);
1010 if (retval && *retval &&
1011 strcmp(retval, "C") &&
1012 strcmp(retval, "POSIX"))
1019 static void write_accept_language(struct strbuf *buf)
1022 * MAX_DECIMAL_PLACES must not be larger than 3. If it is larger than
1023 * that, q-value will be smaller than 0.001, the minimum q-value the
1024 * HTTP specification allows. See
1025 * http://tools.ietf.org/html/rfc7231#section-5.3.1 for q-value.
1027 const int MAX_DECIMAL_PLACES = 3;
1028 const int MAX_LANGUAGE_TAGS = 1000;
1029 const int MAX_ACCEPT_LANGUAGE_HEADER_SIZE = 4000;
1030 char **language_tags = NULL;
1032 const char *s = get_preferred_languages();
1034 struct strbuf tag = STRBUF_INIT;
1036 /* Don't add Accept-Language header if no language is preferred. */
1041 * Split the colon-separated string of preferred languages into
1042 * language_tags array.
1045 /* collect language tag */
1046 for (; *s && (isalnum(*s) || *s == '_'); s++)
1047 strbuf_addch(&tag, *s == '_' ? '-' : *s);
1049 /* skip .codeset, @modifier and any other unnecessary parts */
1050 while (*s && *s != ':')
1055 REALLOC_ARRAY(language_tags, num_langs);
1056 language_tags[num_langs - 1] = strbuf_detach(&tag, NULL);
1057 if (num_langs >= MAX_LANGUAGE_TAGS - 1) /* -1 for '*' */
1062 /* write Accept-Language header into buf */
1064 int last_buf_len = 0;
1070 REALLOC_ARRAY(language_tags, num_langs + 1);
1071 language_tags[num_langs++] = "*"; /* it's OK; this won't be freed */
1073 /* compute decimal_places */
1074 for (max_q = 1, decimal_places = 0;
1075 max_q < num_langs && decimal_places <= MAX_DECIMAL_PLACES;
1076 decimal_places++, max_q *= 10)
1079 sprintf(q_format, ";q=0.%%0%dd", decimal_places);
1081 strbuf_addstr(buf, "Accept-Language: ");
1083 for (i = 0; i < num_langs; i++) {
1085 strbuf_addstr(buf, ", ");
1087 strbuf_addstr(buf, language_tags[i]);
1090 strbuf_addf(buf, q_format, max_q - i);
1092 if (buf->len > MAX_ACCEPT_LANGUAGE_HEADER_SIZE) {
1093 strbuf_remove(buf, last_buf_len, buf->len - last_buf_len);
1097 last_buf_len = buf->len;
1101 /* free language tags -- last one is a static '*' */
1102 for (i = 0; i < num_langs - 1; i++)
1103 free(language_tags[i]);
1104 free(language_tags);
1108 * Get an Accept-Language header which indicates user's preferred languages.
1112 * LANGUAGE=ko:en -> "Accept-Language: ko, en; q=0.9, *; q=0.1"
1113 * LANGUAGE=ko_KR.UTF-8:sr@latin -> "Accept-Language: ko-KR, sr; q=0.9, *; q=0.1"
1114 * LANGUAGE=ko LANG=en_US.UTF-8 -> "Accept-Language: ko, *; q=0.1"
1115 * LANGUAGE= LANG=en_US.UTF-8 -> "Accept-Language: en-US, *; q=0.1"
1116 * LANGUAGE= LANG=C -> ""
1118 static const char *get_accept_language(void)
1120 if (!cached_accept_language) {
1121 struct strbuf buf = STRBUF_INIT;
1122 write_accept_language(&buf);
1124 cached_accept_language = strbuf_detach(&buf, NULL);
1127 return cached_accept_language;
1130 /* http_request() targets */
1131 #define HTTP_REQUEST_STRBUF 0
1132 #define HTTP_REQUEST_FILE 1
1134 static int http_request(const char *url,
1135 void *result, int target,
1136 const struct http_get_options *options)
1138 struct active_request_slot *slot;
1139 struct slot_results results;
1140 struct curl_slist *headers = NULL;
1141 struct strbuf buf = STRBUF_INIT;
1142 const char *accept_language;
1145 slot = get_active_slot();
1146 curl_easy_setopt(slot->curl, CURLOPT_HTTPGET, 1);
1148 if (result == NULL) {
1149 curl_easy_setopt(slot->curl, CURLOPT_NOBODY, 1);
1151 curl_easy_setopt(slot->curl, CURLOPT_NOBODY, 0);
1152 curl_easy_setopt(slot->curl, CURLOPT_FILE, result);
1154 if (target == HTTP_REQUEST_FILE) {
1155 long posn = ftell(result);
1156 curl_easy_setopt(slot->curl, CURLOPT_WRITEFUNCTION,
1159 strbuf_addf(&buf, "Range: bytes=%ld-", posn);
1160 headers = curl_slist_append(headers, buf.buf);
1164 curl_easy_setopt(slot->curl, CURLOPT_WRITEFUNCTION,
1168 accept_language = get_accept_language();
1170 if (accept_language)
1171 headers = curl_slist_append(headers, accept_language);
1173 strbuf_addstr(&buf, "Pragma:");
1174 if (options && options->no_cache)
1175 strbuf_addstr(&buf, " no-cache");
1176 if (options && options->keep_error)
1177 curl_easy_setopt(slot->curl, CURLOPT_FAILONERROR, 0);
1179 headers = curl_slist_append(headers, buf.buf);
1181 curl_easy_setopt(slot->curl, CURLOPT_URL, url);
1182 curl_easy_setopt(slot->curl, CURLOPT_HTTPHEADER, headers);
1183 curl_easy_setopt(slot->curl, CURLOPT_ENCODING, "gzip");
1185 ret = run_one_slot(slot, &results);
1187 if (options && options->content_type) {
1188 struct strbuf raw = STRBUF_INIT;
1189 curlinfo_strbuf(slot->curl, CURLINFO_CONTENT_TYPE, &raw);
1190 extract_content_type(&raw, options->content_type,
1192 strbuf_release(&raw);
1195 if (options && options->effective_url)
1196 curlinfo_strbuf(slot->curl, CURLINFO_EFFECTIVE_URL,
1197 options->effective_url);
1199 curl_slist_free_all(headers);
1200 strbuf_release(&buf);
1206 * Update the "base" url to a more appropriate value, as deduced by
1207 * redirects seen when requesting a URL starting with "url".
1209 * The "asked" parameter is a URL that we asked curl to access, and must begin
1212 * The "got" parameter is the URL that curl reported to us as where we ended
1215 * Returns 1 if we updated the base url, 0 otherwise.
1217 * Our basic strategy is to compare "base" and "asked" to find the bits
1218 * specific to our request. We then strip those bits off of "got" to yield the
1219 * new base. So for example, if our base is "http://example.com/foo.git",
1220 * and we ask for "http://example.com/foo.git/info/refs", we might end up
1221 * with "https://other.example.com/foo.git/info/refs". We would want the
1222 * new URL to become "https://other.example.com/foo.git".
1224 * Note that this assumes a sane redirect scheme. It's entirely possible
1225 * in the example above to end up at a URL that does not even end in
1226 * "info/refs". In such a case we simply punt, as there is not much we can
1227 * do (and such a scheme is unlikely to represent a real git repository,
1228 * which means we are likely about to abort anyway).
1230 static int update_url_from_redirect(struct strbuf *base,
1232 const struct strbuf *got)
1237 if (!strcmp(asked, got->buf))
1240 if (!skip_prefix(asked, base->buf, &tail))
1241 die("BUG: update_url_from_redirect: %s is not a superset of %s",
1244 tail_len = strlen(tail);
1246 if (got->len < tail_len ||
1247 strcmp(tail, got->buf + got->len - tail_len))
1248 return 0; /* insane redirect scheme */
1251 strbuf_add(base, got->buf, got->len - tail_len);
1255 static int http_request_reauth(const char *url,
1256 void *result, int target,
1257 struct http_get_options *options)
1259 int ret = http_request(url, result, target, options);
1261 if (options && options->effective_url && options->base_url) {
1262 if (update_url_from_redirect(options->base_url,
1263 url, options->effective_url)) {
1264 credential_from_url(&http_auth, options->base_url->buf);
1265 url = options->effective_url->buf;
1269 if (ret != HTTP_REAUTH)
1273 * If we are using KEEP_ERROR, the previous request may have
1274 * put cruft into our output stream; we should clear it out before
1275 * making our next request. We only know how to do this for
1276 * the strbuf case, but that is enough to satisfy current callers.
1278 if (options && options->keep_error) {
1280 case HTTP_REQUEST_STRBUF:
1281 strbuf_reset(result);
1284 die("BUG: HTTP_KEEP_ERROR is only supported with strbufs");
1288 credential_fill(&http_auth);
1290 return http_request(url, result, target, options);
1293 int http_get_strbuf(const char *url,
1294 struct strbuf *result,
1295 struct http_get_options *options)
1297 return http_request_reauth(url, result, HTTP_REQUEST_STRBUF, options);
1301 * Downloads a URL and stores the result in the given file.
1303 * If a previous interrupted download is detected (i.e. a previous temporary
1304 * file is still around) the download is resumed.
1306 static int http_get_file(const char *url, const char *filename,
1307 struct http_get_options *options)
1310 struct strbuf tmpfile = STRBUF_INIT;
1313 strbuf_addf(&tmpfile, "%s.temp", filename);
1314 result = fopen(tmpfile.buf, "a");
1316 error("Unable to open local file %s", tmpfile.buf);
1321 ret = http_request_reauth(url, result, HTTP_REQUEST_FILE, options);
1324 if (ret == HTTP_OK && move_temp_to_file(tmpfile.buf, filename))
1327 strbuf_release(&tmpfile);
1331 int http_fetch_ref(const char *base, struct ref *ref)
1333 struct http_get_options options = {0};
1335 struct strbuf buffer = STRBUF_INIT;
1338 options.no_cache = 1;
1340 url = quote_ref_url(base, ref->name);
1341 if (http_get_strbuf(url, &buffer, &options) == HTTP_OK) {
1342 strbuf_rtrim(&buffer);
1343 if (buffer.len == 40)
1344 ret = get_sha1_hex(buffer.buf, ref->old_sha1);
1345 else if (starts_with(buffer.buf, "ref: ")) {
1346 ref->symref = xstrdup(buffer.buf + 5);
1351 strbuf_release(&buffer);
1356 /* Helpers for fetching packs */
1357 static char *fetch_pack_index(unsigned char *sha1, const char *base_url)
1360 struct strbuf buf = STRBUF_INIT;
1362 if (http_is_verbose)
1363 fprintf(stderr, "Getting index for pack %s\n", sha1_to_hex(sha1));
1365 end_url_with_slash(&buf, base_url);
1366 strbuf_addf(&buf, "objects/pack/pack-%s.idx", sha1_to_hex(sha1));
1367 url = strbuf_detach(&buf, NULL);
1369 strbuf_addf(&buf, "%s.temp", sha1_pack_index_name(sha1));
1370 tmp = strbuf_detach(&buf, NULL);
1372 if (http_get_file(url, tmp, NULL) != HTTP_OK) {
1373 error("Unable to get pack index %s", url);
1382 static int fetch_and_setup_pack_index(struct packed_git **packs_head,
1383 unsigned char *sha1, const char *base_url)
1385 struct packed_git *new_pack;
1386 char *tmp_idx = NULL;
1389 if (has_pack_index(sha1)) {
1390 new_pack = parse_pack_index(sha1, NULL);
1392 return -1; /* parse_pack_index() already issued error message */
1396 tmp_idx = fetch_pack_index(sha1, base_url);
1400 new_pack = parse_pack_index(sha1, tmp_idx);
1405 return -1; /* parse_pack_index() already issued error message */
1408 ret = verify_pack_index(new_pack);
1410 close_pack_index(new_pack);
1411 ret = move_temp_to_file(tmp_idx, sha1_pack_index_name(sha1));
1418 new_pack->next = *packs_head;
1419 *packs_head = new_pack;
1423 int http_get_info_packs(const char *base_url, struct packed_git **packs_head)
1425 struct http_get_options options = {0};
1428 struct strbuf buf = STRBUF_INIT;
1429 unsigned char sha1[20];
1431 end_url_with_slash(&buf, base_url);
1432 strbuf_addstr(&buf, "objects/info/packs");
1433 url = strbuf_detach(&buf, NULL);
1435 options.no_cache = 1;
1436 ret = http_get_strbuf(url, &buf, &options);
1441 while (i < buf.len) {
1445 if (i + 52 <= buf.len &&
1446 starts_with(data + i, " pack-") &&
1447 starts_with(data + i + 46, ".pack\n")) {
1448 get_sha1_hex(data + i + 6, sha1);
1449 fetch_and_setup_pack_index(packs_head, sha1,
1455 while (i < buf.len && data[i] != '\n')
1466 void release_http_pack_request(struct http_pack_request *preq)
1468 if (preq->packfile != NULL) {
1469 fclose(preq->packfile);
1470 preq->packfile = NULL;
1472 if (preq->range_header != NULL) {
1473 curl_slist_free_all(preq->range_header);
1474 preq->range_header = NULL;
1480 int finish_http_pack_request(struct http_pack_request *preq)
1482 struct packed_git **lst;
1483 struct packed_git *p = preq->target;
1485 struct child_process ip = CHILD_PROCESS_INIT;
1486 const char *ip_argv[8];
1488 close_pack_index(p);
1490 fclose(preq->packfile);
1491 preq->packfile = NULL;
1495 lst = &((*lst)->next);
1496 *lst = (*lst)->next;
1498 tmp_idx = xstrdup(preq->tmpfile);
1499 strcpy(tmp_idx + strlen(tmp_idx) - strlen(".pack.temp"),
1502 ip_argv[0] = "index-pack";
1504 ip_argv[2] = tmp_idx;
1505 ip_argv[3] = preq->tmpfile;
1513 if (run_command(&ip)) {
1514 unlink(preq->tmpfile);
1520 unlink(sha1_pack_index_name(p->sha1));
1522 if (move_temp_to_file(preq->tmpfile, sha1_pack_name(p->sha1))
1523 || move_temp_to_file(tmp_idx, sha1_pack_index_name(p->sha1))) {
1528 install_packed_git(p);
1533 struct http_pack_request *new_http_pack_request(
1534 struct packed_git *target, const char *base_url)
1537 char range[RANGE_HEADER_SIZE];
1538 struct strbuf buf = STRBUF_INIT;
1539 struct http_pack_request *preq;
1541 preq = xcalloc(1, sizeof(*preq));
1542 preq->target = target;
1544 end_url_with_slash(&buf, base_url);
1545 strbuf_addf(&buf, "objects/pack/pack-%s.pack",
1546 sha1_to_hex(target->sha1));
1547 preq->url = strbuf_detach(&buf, NULL);
1549 snprintf(preq->tmpfile, sizeof(preq->tmpfile), "%s.temp",
1550 sha1_pack_name(target->sha1));
1551 preq->packfile = fopen(preq->tmpfile, "a");
1552 if (!preq->packfile) {
1553 error("Unable to open local file %s for pack",
1558 preq->slot = get_active_slot();
1559 curl_easy_setopt(preq->slot->curl, CURLOPT_FILE, preq->packfile);
1560 curl_easy_setopt(preq->slot->curl, CURLOPT_WRITEFUNCTION, fwrite);
1561 curl_easy_setopt(preq->slot->curl, CURLOPT_URL, preq->url);
1562 curl_easy_setopt(preq->slot->curl, CURLOPT_HTTPHEADER,
1566 * If there is data present from a previous transfer attempt,
1567 * resume where it left off
1569 prev_posn = ftell(preq->packfile);
1571 if (http_is_verbose)
1573 "Resuming fetch of pack %s at byte %ld\n",
1574 sha1_to_hex(target->sha1), prev_posn);
1575 sprintf(range, "Range: bytes=%ld-", prev_posn);
1576 preq->range_header = curl_slist_append(NULL, range);
1577 curl_easy_setopt(preq->slot->curl, CURLOPT_HTTPHEADER,
1578 preq->range_header);
1589 /* Helpers for fetching objects (loose) */
1590 static size_t fwrite_sha1_file(char *ptr, size_t eltsize, size_t nmemb,
1593 unsigned char expn[4096];
1594 size_t size = eltsize * nmemb;
1596 struct http_object_request *freq =
1597 (struct http_object_request *)data;
1599 ssize_t retval = xwrite(freq->localfile,
1600 (char *) ptr + posn, size - posn);
1604 } while (posn < size);
1606 freq->stream.avail_in = size;
1607 freq->stream.next_in = (void *)ptr;
1609 freq->stream.next_out = expn;
1610 freq->stream.avail_out = sizeof(expn);
1611 freq->zret = git_inflate(&freq->stream, Z_SYNC_FLUSH);
1612 git_SHA1_Update(&freq->c, expn,
1613 sizeof(expn) - freq->stream.avail_out);
1614 } while (freq->stream.avail_in && freq->zret == Z_OK);
1618 struct http_object_request *new_http_object_request(const char *base_url,
1619 unsigned char *sha1)
1621 char *hex = sha1_to_hex(sha1);
1622 const char *filename;
1623 char prevfile[PATH_MAX];
1625 char prev_buf[PREV_BUF_SIZE];
1626 ssize_t prev_read = 0;
1628 char range[RANGE_HEADER_SIZE];
1629 struct curl_slist *range_header = NULL;
1630 struct http_object_request *freq;
1632 freq = xcalloc(1, sizeof(*freq));
1633 hashcpy(freq->sha1, sha1);
1634 freq->localfile = -1;
1636 filename = sha1_file_name(sha1);
1637 snprintf(freq->tmpfile, sizeof(freq->tmpfile),
1638 "%s.temp", filename);
1640 snprintf(prevfile, sizeof(prevfile), "%s.prev", filename);
1641 unlink_or_warn(prevfile);
1642 rename(freq->tmpfile, prevfile);
1643 unlink_or_warn(freq->tmpfile);
1645 if (freq->localfile != -1)
1646 error("fd leakage in start: %d", freq->localfile);
1647 freq->localfile = open(freq->tmpfile,
1648 O_WRONLY | O_CREAT | O_EXCL, 0666);
1650 * This could have failed due to the "lazy directory creation";
1651 * try to mkdir the last path component.
1653 if (freq->localfile < 0 && errno == ENOENT) {
1654 char *dir = strrchr(freq->tmpfile, '/');
1657 mkdir(freq->tmpfile, 0777);
1660 freq->localfile = open(freq->tmpfile,
1661 O_WRONLY | O_CREAT | O_EXCL, 0666);
1664 if (freq->localfile < 0) {
1665 error("Couldn't create temporary file %s: %s",
1666 freq->tmpfile, strerror(errno));
1670 git_inflate_init(&freq->stream);
1672 git_SHA1_Init(&freq->c);
1674 freq->url = get_remote_object_url(base_url, hex, 0);
1677 * If a previous temp file is present, process what was already
1680 prevlocal = open(prevfile, O_RDONLY);
1681 if (prevlocal != -1) {
1683 prev_read = xread(prevlocal, prev_buf, PREV_BUF_SIZE);
1685 if (fwrite_sha1_file(prev_buf,
1688 freq) == prev_read) {
1689 prev_posn += prev_read;
1694 } while (prev_read > 0);
1697 unlink_or_warn(prevfile);
1700 * Reset inflate/SHA1 if there was an error reading the previous temp
1701 * file; also rewind to the beginning of the local file.
1703 if (prev_read == -1) {
1704 memset(&freq->stream, 0, sizeof(freq->stream));
1705 git_inflate_init(&freq->stream);
1706 git_SHA1_Init(&freq->c);
1709 lseek(freq->localfile, 0, SEEK_SET);
1710 if (ftruncate(freq->localfile, 0) < 0) {
1711 error("Couldn't truncate temporary file %s: %s",
1712 freq->tmpfile, strerror(errno));
1718 freq->slot = get_active_slot();
1720 curl_easy_setopt(freq->slot->curl, CURLOPT_FILE, freq);
1721 curl_easy_setopt(freq->slot->curl, CURLOPT_WRITEFUNCTION, fwrite_sha1_file);
1722 curl_easy_setopt(freq->slot->curl, CURLOPT_ERRORBUFFER, freq->errorstr);
1723 curl_easy_setopt(freq->slot->curl, CURLOPT_URL, freq->url);
1724 curl_easy_setopt(freq->slot->curl, CURLOPT_HTTPHEADER, no_pragma_header);
1727 * If we have successfully processed data from a previous fetch
1728 * attempt, only fetch the data we don't already have.
1731 if (http_is_verbose)
1733 "Resuming fetch of object %s at byte %ld\n",
1735 sprintf(range, "Range: bytes=%ld-", prev_posn);
1736 range_header = curl_slist_append(range_header, range);
1737 curl_easy_setopt(freq->slot->curl,
1738 CURLOPT_HTTPHEADER, range_header);
1749 void process_http_object_request(struct http_object_request *freq)
1751 if (freq->slot == NULL)
1753 freq->curl_result = freq->slot->curl_result;
1754 freq->http_code = freq->slot->http_code;
1758 int finish_http_object_request(struct http_object_request *freq)
1762 close(freq->localfile);
1763 freq->localfile = -1;
1765 process_http_object_request(freq);
1767 if (freq->http_code == 416) {
1768 warning("requested range invalid; we may already have all the data.");
1769 } else if (freq->curl_result != CURLE_OK) {
1770 if (stat(freq->tmpfile, &st) == 0)
1771 if (st.st_size == 0)
1772 unlink_or_warn(freq->tmpfile);
1776 git_inflate_end(&freq->stream);
1777 git_SHA1_Final(freq->real_sha1, &freq->c);
1778 if (freq->zret != Z_STREAM_END) {
1779 unlink_or_warn(freq->tmpfile);
1782 if (hashcmp(freq->sha1, freq->real_sha1)) {
1783 unlink_or_warn(freq->tmpfile);
1787 move_temp_to_file(freq->tmpfile, sha1_file_name(freq->sha1));
1789 return freq->rename;
1792 void abort_http_object_request(struct http_object_request *freq)
1794 unlink_or_warn(freq->tmpfile);
1796 release_http_object_request(freq);
1799 void release_http_object_request(struct http_object_request *freq)
1801 if (freq->localfile != -1) {
1802 close(freq->localfile);
1803 freq->localfile = -1;
1805 if (freq->url != NULL) {
1809 if (freq->slot != NULL) {
1810 freq->slot->callback_func = NULL;
1811 freq->slot->callback_data = NULL;
1812 release_active_slot(freq->slot);