master
1#ifndef HEADER_CURL_THRDPOOL_H
2#define HEADER_CURL_THRDPOOL_H
3/***************************************************************************
4 * _ _ ____ _
5 * Project ___| | | | _ \| |
6 * / __| | | | |_) | |
7 * | (__| |_| | _ <| |___
8 * \___|\___/|_| \_\_____|
9 *
10 * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
11 *
12 * This software is licensed as described in the file COPYING, which
13 * you should have received as part of this distribution. The terms
14 * are also available at https://curl.se/docs/copyright.html.
15 *
16 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
17 * copies of the Software, and permit persons to whom the Software is
18 * furnished to do so, under the terms of the COPYING file.
19 *
20 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
21 * KIND, either express or implied.
22 *
23 * SPDX-License-Identifier: curl
24 *
25 ***************************************************************************/
26#include "curl_setup.h"
27#include "curlx/timediff.h"
29#ifdef USE_THREADS
31struct curl_thrdpool;
32struct Curl_easy;
34/* Invoked under thread pool lock to get an "item" to work on. Must
35 * return NULL if there is nothing to do.
36 * Caller might return a descriptive string about the "item", where
37 * available. The string needs to have the same lifetime as the
38 * item itself. */
39typedef void *Curl_thrdpool_take_item_cb(void *user_data,
40 const char **pdescription,
41 timediff_t *ptimeout_ms);
43/* Invoked outside thread pool lock to process the item taken. */
44typedef void Curl_thrdpool_process_item_cb(void *item);
46/* Invoked under thread pool lock to return a processed item back
47 * to the producer.
48 * If the thread pool has been destroyed, `user_data` will be NULL
49 * and the callback is responsible to release all `item` resources. */
50typedef void Curl_thrdpool_return_item_cb(void *item, void *user_data);
52/* Create a new thread pool.
53 * @param name name of pool for tracing purposes
54 * @param min_threads minimum number of threads to have always running
55 * @param max_threads maximum number of threads running, ever.
56 * @param idle_time_ms maximum time a thread should wait for tasks to
57 * process before shutting down (unless the pool is
58 * already at minimum thread count), use 0 for
59 * infinite wait.
60 * @param fn_take take the next item to process
61 * @param fn_process process the item taken
62 * @param fn_return return the processed item
63 * @param user_data parameter passed to take/return callbacks
64 */
65CURLcode Curl_thrdpool_create(struct curl_thrdpool **ptpool,
66 const char *name,
67 uint32_t min_threads,
68 uint32_t max_threads,
69 uint32_t idle_time_ms,
70 Curl_thrdpool_take_item_cb *fn_take,
71 Curl_thrdpool_process_item_cb *fn_process,
72 Curl_thrdpool_return_item_cb *fn_return,
73 void *user_data);
75/* Destroy the thread pool, release its resources.
76 * With `join` being TRUE, the call will wait for all threads to finish
77 * processing before returning. On FALSE, it will detach all threads
78 * running. Ongoing item processing will continue to run and
79 * `fn_return` will be invoked with NULL user_data before the thread exits.
80 */
81void Curl_thrdpool_destroy(struct curl_thrdpool *tpool, bool join);
83/* Signal the pool to wake up `nthreads` idle worker threads, possible
84 * creating new threads up to the max limit. The number should reflect
85 * the items that can actually be taken for processing right away, e.g.
86 * the producers "queue" length of outstanding items.
87 */
88CURLcode Curl_thrdpool_signal(struct curl_thrdpool *tpool, uint32_t nthreads);
90CURLcode Curl_thrdpool_await_idle(struct curl_thrdpool *tpool,
91 uint32_t timeout_ms);
93/* Change the properties of a threadpool. */
94CURLcode Curl_thrdpool_set_props(struct curl_thrdpool *tpool,
95 uint32_t min_threads,
96 uint32_t max_threads,
97 uint32_t idle_time_ms);
99#ifdef CURLVERBOSE
100void Curl_thrdpool_trace(struct curl_thrdpool *tpool,
101 struct Curl_easy *data);
102#endif
104#endif /* USE_THREADS */
106#endif /* HEADER_CURL_THRDPOOL_H */
Diagnostics4 git calls · 222 ms
CallStatusSizeTime0222 ms
discover200152 B2 ms
git.upload-pack discover http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=2 git.response.bytes=152 git.server.agent=gitty/1.0 git.server.object_format=sha1 git.server.caps=agent ls-refs fetch object-format git.server.fetch=shallow filter sideband-all git.protocol.version=2 git.pkt.frames=8 git.pkt.data=6 git.pkt.flush=2 git.pkt.delim=0 git.pkt.bytes=152 git.pkt.payload.max=34
ls-refs200149 B · hit2 ms
git.upload-pack ls-refs http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=2 git.response.bytes=149 git.response.cache=HIT git.response.duration_ms=2 git.protocol.version=2 git.pkt.frames=3 git.pkt.data=2 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=149 git.pkt.payload.max=78 git.ls_refs.count=2 git.ls_refs.head=refs/heads/master
fetchblob:none · deepen 10200287 KiB · hit3 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=3 git.response.bytes=293470 git.response.cache=HIT git.response.duration_ms=3 git.fetch.filter=blob:none git.fetch.filter.requested=tree:0 git.fetch.filter.fallback=blob:none git.fetch.filter.learned=false git.fetch.wants=31c911efe5652725e930f4d2e60c9060e5f6646d git.fetch.haves.count=0 git.fetch.deepen=10 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=10 git.pkt.data=8 git.pkt.flush=1 git.pkt.delim=1 git.pkt.bytes=293470 git.pkt.payload.max=65516 git.sideband.band1.bytes=293354 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=87 git.pack.bytes=293354 git.pack.ofs_delta=0 git.pack.ref_delta=1 git.pack.chain.max=1 git.pack.trailer=6a646bcda6740bab42e321b51998b52ea15146c0 git.pack.full=86Open pack map
fetch2001.6 KiB217 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=217 git.response.bytes=1680 git.response.cache=MISS git.response.duration_ms=217 git.fetch.wants=cc81fb6fcba511d94c3b7439edb7162a4cb58b47 git.fetch.haves.count=0 git.fetch.deepen=0 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=3 git.pkt.data=2 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=1680 git.pkt.payload.max=1659 git.sideband.band1.bytes=1658 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0
Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.
- Remote
- https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/curl.git
- Ref
- refs/heads/master
- Commit
- 31c911efe5652725e930f4d2e60c9060e5f6646d
- cf-ray
- a5e15f40087c725b
- Request
- 097a4a58…
- Protocol
- v2 · sha1
- Agent
- gitty/1.0
- Filter
- advertised
- Fetch
- shallow filter sideband-all
- Capabilities
- agent ls-refs fetch object-format