master
1#!/usr/bin/env perl
2# ***************************************************************************
3# * _ _ ____ _
4# * Project ___| | | | _ \| |
5# * / __| | | | |_) | |
6# * | (__| |_| | _ <| |___
7# * \___|\___/|_| \_\_____|
8# *
9# * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
10# *
11# * This software is licensed as described in the file COPYING, which
12# * you should have received as part of this distribution. The terms
13# * are also available at https://curl.se/docs/copyright.html.
14# *
15# * You may opt to use, copy, modify, merge, publish, distribute and/or sell
16# * copies of the Software, and permit persons to whom the Software is
17# * furnished to do so, under the terms of the COPYING file.
18# *
19# * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
20# * KIND, either express or implied.
21# *
22# * SPDX-License-Identifier: curl
23# *
24# ***************************************************************************
25use strict;
26use warnings;
28use POSIX qw(strftime);
29my @ts;
30if(defined($ENV{SOURCE_DATE_EPOCH})) {
31 @ts = localtime($ENV{SOURCE_DATE_EPOCH});
32}
33else {
34 @ts = localtime;
35}
36my $date = strftime "%b %e, %Y", @ts;
37my $year = strftime "%Y", @ts;
39print <<HEADER
40---
41c: Copyright (C) Daniel Stenberg, <daniel\@haxx.se>, et al.
42SPDX-License-Identifier: curl
43Title: libcurl-symbols
44Section: 3
45Source: libcurl
46Protocol:
47 - All
48See-also:
49 - libcurl (3)
50 - libcurl-easy (3)
51 - libcurl-multi (3)
52 - libcurl-security (3)
53 - libcurl-thread (3)
54Added-in: n/a
55---
56# libcurl symbols
58This man page details version information for public symbols provided in the
59libcurl header files. This lists the first version in which the symbol was
60introduced and for some symbols two additional information pieces:
62The first version in which the symbol is marked "deprecated" - meaning that
63since that version no new code should be written to use the symbol as it is
64marked for getting removed in a future.
66The last version that featured the specific symbol. Using the symbol in source
67code makes it no longer compile error-free after that specified version.
69This man page is automatically generated from the symbols-in-versions file.
70HEADER
71 ;
73sub nameref {
74 my ($n) = @_;
75 if($n =~ /^CURLOPT_/) {
76 if($n eq "CURLOPT_RTSPHEADER") {
77 $n = "CURLOPT_HTTPHEADER";
78 }
79 elsif($n eq "CURLOPT_WRITEHEADER") {
80 $n = "CURLOPT_HEADERDATA";
81 }
82 elsif($n eq "CURLOPT_WRITEINFO") {
83 ; # now obsolete
84 }
85 else {
86 return "$n(3)";
87 }
88 }
89 elsif($n =~ /^CURLMOPT_/) {
90 return "$n(3)";
91 }
92 elsif($n =~ /^CURLINFO_/) {
93 my %infotypes = (
94 'CURLINFO_TEXT' => 1,
95 'CURLINFO_HEADER_IN' => 1,
96 'CURLINFO_HEADER_OUT' => 1,
97 'CURLINFO_DATA_IN' => 1,
98 'CURLINFO_DATA_OUT' => 1,
99 'CURLINFO_SSL_DATA_IN' => 1,
100 'CURLINFO_SSL_DATA_OUT' => 1,
101 );
102 if($infotypes{$n}) {
103 return "CURLOPT_DEBUGFUNCTION(3)";
104 }
105 }
106 elsif($n =~ /^CURLALTSVC_/) {
107 return "CURLOPT_ALTSVC_CTRL(3)";
108 }
109 elsif($n =~ /^CURLAUTH_/) {
110 return "CURLOPT_HTTPAUTH(3)";
111 }
112 elsif($n =~ /^CURLFORM_/) {
113 return "curl_formadd(3)";
114 }
115 elsif($n =~ /^CURLKH/) {
116 return "CURLOPT_SSH_KEYFUNCTION(3)";
117 }
118 elsif($n =~ /^CURLE_/) {
119 return "libcurl-errors(3)";
120 }
121 elsif($n =~ /^CURLM_/) {
122 return "libcurl-errors(3)";
123 }
124 elsif($n =~ /^CURLUE_/) {
125 return "libcurl-errors(3)";
126 }
127 elsif($n =~ /^CURLHE_/) {
128 return "libcurl-errors(3)";
129 }
130 elsif($n =~ /^CURLSHE_/) {
131 return "libcurl-errors(3)";
132 }
133 elsif($n =~ /^CURLPROTO_/) {
134 return "CURLINFO_PROTOCOL(3)";
135 }
136 elsif($n =~ /^CURLPX_/) {
137 return "CURLINFO_PROXY_ERROR(3)";
138 }
139 elsif($n =~ /^CURLPROXY_/) {
140 return "CURLOPT_PROXYTYPE(3)";
141 }
142 elsif($n =~ /^CURLSSLBACKEND_/) {
143 return "curl_global_sslset(3)";
144 }
145 elsif($n =~ /^CURLSSLOPT_/) {
146 return "CURLOPT_SSL_OPTIONS(3)";
147 }
148 elsif($n =~ /^CURLSSLSET_/) {
149 return "curl_global_sslset(3)";
150 }
151 elsif($n =~ /^CURLUPART_/) {
152 return "curl_url_get(3)";
153 }
154 elsif($n =~ /^CURLU_/) {
155 return "curl_url_get(3)";
156 }
157 elsif($n =~ /^CURLVERSION_/) {
158 return "curl_version_info(3)";
159 }
160 elsif($n =~ /^CURLSHOPT_/) {
161 if($n eq "CURLSHOPT_NONE") {
162 $n = "curl_share_setopt";
163 }
164 return "$n(3)";
165 }
166 elsif($n =~ /^CURLWS_/) {
167 return "curl_ws_send(3)";
168 }
169 elsif($n =~ /^CURL_FORMADD_/) {
170 return "curl_formadd(3)";
171 }
172 elsif($n =~ /^CURL_HTTPPOST_/) {
173 return "curl_formadd(3)";
174 }
175 elsif($n =~ /^CURL_GLOBAL_/) {
176 return "curl_global_init(3)";
177 }
178 elsif($n =~ /^CURL_HTTP_VERSION_/) {
179 return "CURLOPT_HTTP_VERSION(3)";
180 }
181 elsif($n =~ /^CURL_LOCK_/) {
182 return "CURLSHOPT_SHARE(3)";
183 }
184 elsif($n =~ /^CURL_SSLVERSION_/) {
185 return "CURLOPT_SSLVERSION(3)";
186 }
187 elsif($n =~ /^CURL_VERSION_/) {
188 return "curl_version_info(3)";
189 }
190 elsif($n =~ /^CURL_RTSPREQ_/) {
191 return "CURLOPT_RTSP_REQUEST(3)";
192 }
193 elsif($n =~ /^CURLH_/) {
194 return "curl_easy_header(3)";
195 }
196 elsif($n =~ /^CURL_TRAILERFUNC_/) {
197 return "CURLOPT_TRAILERFUNCTION(3)";
198 }
199 elsif($n =~ /^CURLOT_/) {
200 return "curl_easy_option_next(3)";
201 }
202 elsif($n =~ /^CURLFINFOFLAG_/) {
203 return "CURLOPT_CHUNK_BGN_FUNCTION(3)";
204 }
205 elsif($n =~ /^CURLFILETYPE_/) {
206 return "CURLOPT_CHUNK_BGN_FUNCTION(3)";
207 }
208 elsif($n =~ /^CURL_CHUNK_BGN_FUNC_/) {
209 return "CURLOPT_CHUNK_BGN_FUNCTION(3)";
210 }
211 elsif($n =~ /^CURL_CHUNK_END_FUNC_/) {
212 return "CURLOPT_CHUNK_END_FUNCTION(3)";
213 }
214 elsif($n =~ /^CURLSSH_AUTH_/) {
215 return "CURLOPT_SSH_AUTH_TYPES(3)";
216 }
217 elsif($n =~ /^CURL_POLL_/) {
218 return "CURLMOPT_SOCKETFUNCTION(3)";
219 }
220 elsif($n =~ /^CURLMSG_/) {
221 return "curl_multi_info_read(3)";
222 }
223 elsif($n =~ /^CURLFTPAUTH_/) {
224 return "CURLOPT_FTPSSLAUTH(3)";
225 }
226 elsif($n =~ /^CURLFTPMETHOD_/) {
227 return "CURLOPT_FTP_FILEMETHOD(3)";
228 }
229 elsif($n =~ /^CURLFTPSSL_/) {
230 return "CURLOPT_USE_SSL(3)";
231 }
232 elsif($n =~ /^CURLFTP_CREATE_/) {
233 return "CURLOPT_FTP_CREATE_MISSING_DIRS(3)";
234 }
235 elsif($n =~ /^CURLGSSAPI_DELEGATION_/) {
236 return "CURLOPT_GSSAPI_DELEGATION(3)";
237 }
238 elsif($n =~ /^CURLHEADER_/) {
239 return "CURLOPT_HEADEROPT(3)";
240 }
241 elsif($n =~ /^CURLHSTS_/) {
242 return "CURLOPT_HSTS_CTRL(3)";
243 }
244 elsif($n =~ /^CURLIOCMD_/) {
245 return "CURLOPT_IOCTLFUNCTION(3)";
246 }
247 elsif($n =~ /^CURLIOE_/) {
248 return "CURLOPT_IOCTLFUNCTION(3)";
249 }
250 elsif($n =~ /^CURLMIMEOPT_/) {
251 return "CURLOPT_MIME_OPTIONS(3)";
252 }
253 elsif($n =~ /^CURLPAUSE_/) {
254 return "curl_easy_pause(3)";
255 }
256 elsif($n =~ /^CURLPIPE_/) {
257 return "CURLMOPT_PIPELINING(3)";
258 }
259 elsif($n =~ /^CURLSOCKTYPE_/) {
260 return "CURLOPT_SOCKOPTFUNCTION(3)";
261 }
262 elsif($n =~ /^CURLSTS_/) {
263 return "CURLOPT_HSTSREADFUNCTION(3)";
264 }
265 elsif($n =~ /^CURLUSESSL_/) {
266 return "CURLOPT_USE_SSL(3)";
267 }
268 elsif($n =~ /^CURL_CSELECT_/) {
269 return "curl_multi_socket_action(3)";
270 }
271 elsif($n =~ /^CURL_FNMATCHFUNC_/) {
272 return "CURLOPT_FNMATCH_FUNCTION(3)";
273 }
274 elsif($n =~ /^CURL_HET_/) {
275 return "CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS(3)";
276 }
277 elsif($n =~ /^CURL_IPRESOLVE_/) {
278 return "CURLOPT_IPRESOLVE(3)";
279 }
280 elsif($n =~ /^CURL_SEEKFUNC_/) {
281 return "CURLOPT_SEEKFUNCTION(3)";
282 }
283 elsif($n =~ /^CURL_TIMECOND_/) {
284 return "CURLOPT_TIMECONDITION(3)";
285 }
286 elsif($n =~ /^CURL_REDIR_POST_/) {
287 return "CURLOPT_POSTREDIR(3)";
288 }
289}
291while(<STDIN>) {
292 if($_ =~ /^(CURL[A-Z0-9_.]*) *(.*)/i) {
293 my ($symbol, $rest) = ($1, $2);
294 my ($intro, $dep, $rem);
295 if($rest =~ s/^([0-9.]*) *//) {
296 $intro = $1;
297 }
298 if($rest =~ s/^([0-9.]*) *//) {
299 $dep = $1;
300 }
301 if($rest =~ s/^- *([0-9.]*)//) {
302 $rem = $1;
303 }
304 print "\n## $symbol\nIntroduced in $intro.";
305 if($dep) {
306 print " Deprecated since $dep.";
307 }
308 if($rem) {
309 print " Last used in $rem.";
310 }
311 my $see = $rem || $dep ? "" : nameref($symbol);
312 if($see) {
313 print " See $see.";
314 }
315 print "\n";
316 }
317}
Diagnostics4 git calls · 25 ms
CallStatusSizeTime025 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 · hit4 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=4 git.response.bytes=293470 git.response.cache=HIT git.response.duration_ms=4 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
fetch2002.4 KiB · hit19 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=19 git.response.bytes=2434 git.response.cache=HIT git.response.duration_ms=19 git.fetch.wants=54c8338f2bb14c5414be8dbe7748c07c7c9527f7 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=2434 git.pkt.payload.max=2413 git.sideband.band1.bytes=2412 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
- a5e3a293fba35751
- Request
- 4ff1e3eb…
- Protocol
- v2 · sha1
- Agent
- gitty/1.0
- Filter
- advertised
- Fetch
- shallow filter sideband-all
- Capabilities
- agent ls-refs fetch object-format