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###########################################################################
25#
26# This script grew out of help from Przemyslaw Iskra and Balint Szilakszi
27# a late evening in the #curl IRC channel.
28#
30use strict;
31use warnings;
33use allversions;
35# we may get the directory root pointed out
36my $root = $ARGV[0] || ".";
37my $error = 0;
38my $versions = $ARGV[1];
40my @syms;
41my %manpage;
42my %symadded;
44our %pastversion;
46sub checkmanpage {
47 my ($m) = @_;
49 open(my $mh, "<", $m);
50 my $line = 1;
51 my $title;
52 my $addedin;
53 while(<$mh>) {
54 if(/^Title: (.*)/i) {
55 $title = $1;
56 }
57 elsif(/^Added-in: ([an0-9.\/]*)/i) {
58 $addedin = $1;
60 if(($addedin ne "n/a") && !$pastversion{$addedin}) {
61 print "$m: was added in a never released version: $addedin\n";
62 $error++;
63 }
64 }
65 if($addedin && $title) {
66 if($manpage{$title}) {
67 print "$title is a duplicate symbol in file $m\n";
68 $error++;
69 }
70 $manpage{$title} = $addedin;
71 last;
72 }
73 $line++;
74 }
75 close($mh);
76}
78sub scanman_md_dir {
79 my ($d) = @_;
80 opendir(my $dh, $d) or die "Cannot opendir: $!";
81 my @mans = grep { /.md\z/ } readdir($dh);
82 closedir $dh;
83 for my $m (@mans) {
84 checkmanpage("$d/$m");
85 }
86}
88# get all the past versions
89allversions($versions);
91scanman_md_dir("$root/docs/libcurl");
92scanman_md_dir("$root/docs/libcurl/opts");
94open(my $s, "<", "$root/docs/libcurl/symbols-in-versions");
95while(<$s>) {
96 chomp;
97 if(/^(\S+) +([0-9.]*)/) {
98 my ($sym, $ver) = ($1, $2);
99 push @syms, $sym;
101 $symadded{$sym} = $ver;
102 if(!$pastversion{$ver}) {
103 printf "SIV: says $sym was added in non-existing %s\n", $ver;
104 $error++;
105 }
106 }
107}
108close $s;
110my $ignored = 0;
111for my $e (sort @syms) {
112 if($manpage{$e}) {
113 if($manpage{$e} ne $symadded{$e}) {
114 printf "%s.md says version %s, but SIV says %s\n",
115 $e, $manpage{$e}, $symadded{$e};
116 $error++;
117 }
118 }
119}
120print "OK\n" if(!$error);
121exit $error;
Diagnostics4 git calls · 59 ms
CallStatusSizeTime059 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 · hit3 ms
git.upload-pack ls-refs http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=3 git.response.bytes=149 git.response.cache=HIT git.response.duration_ms=3 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.4 KiB · hit53 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=53 git.response.bytes=1433 git.response.cache=HIT git.response.duration_ms=53 git.fetch.wants=5df385b119c0872d9e7d3bb65a6036c77c39a4b4 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=1433 git.pkt.payload.max=1412 git.sideband.band1.bytes=1411 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
- a5e1c3562c5136cd
- Request
- a4701d92…
- Protocol
- v2 · sha1
- Agent
- gitty/1.0
- Filter
- advertised
- Fetch
- shallow filter sideband-all
- Capabilities
- agent ls-refs fetch object-format