Artifactspublic-v0

curl

master
ply4 git calls34 ms289 KiB3 cachedprotocol v2
138 lines4.0 KiBRaw

NAME

testcurl.pl - (automatically) test curl

SYNOPSIS

testcurl.pl [options] [dir] > output

DESCRIPTION

testcurl is the master script to use for automatic distributed testing of curl from git or daily snapshots. It is written for the purpose of being run from a crontab job or similar at a regular interval. The output is suitable to be mailed to curl-autocompile@haxx.se to be dealt with automatically (make sure the subject includes the word "autobuild" as the mail gets silently discarded otherwise). The most current build status (with a reasonable backlog) is published on the curl site, at https://curl.se/dev/builds.html

options may be omitted. See --setup for what happens then.

dir is a curl source directory, possibly a daily snapshot one. Using this makes testcurl skip the autoreconf stage and thus it removes the dependency on automake, autoconf, libtool, GNU m4 and possibly a few other things.

testcurl runs autoreconf (or similar), configure, builds curl and libcurl in a separate build directory and then runs make test to test the fresh build.

OPTIONS

--configure=[options]

Configure options passed to configure.

--crosscompile

This is a cross-compile. Makes testcurl skip a few things.

--desc=[desc]

Description of your test system. Displayed on the build summary page on the website.

--email=[email]

Set email address to report as. Displayed in the build logs on the site.

--mktarball=[command]

Generic command to run after completed test.

--name=[name]

Set name to report as. Displayed in the build summary on the site.

--nobuildconf

Do not run autoreconf. Useful when many builds use the same source tree, as then only one need to do this. Also, if multiple processes run tests simultaneously on the same source tree (like several hosts on a NFS mounted directory), simultaneous autoreconf invokes may cause problems. (Added in 7.14.1)

--nogitpull

Do not update from git even though it is a git tree. Useful to still be able to test even though your network is down, or similar.

--runtestopts=[options]

Options that is passed to the runtests script. Useful for disabling valgrind by force, and similar.

--setup=[filename]

filename to read setup from (deprecated). The old style of providing info. If info is missing when testcurl is started, it prompts you and then stores the info in a 'setup' file, which it looks for on each invoke. Use --name, --email, --configure and --desc instead.

--target=[your os]

Specify your target environment. Recognized strings include vc, mingw32, and borland.

INITIAL SETUP

First, make a checkout from git (or you write a script that downloads daily snapshots automatically):

$ mkdir curl-testing
$ cd curl-testing
$ git clone https://github.com/curl/curl

With the curl sources checked out, or downloaded, you can start testing right away. If you want to use testcurl without command line arguments and to have it store and remember the config in its 'setup' file, then start it manually now and fill in the answers to the questions it prompts you for:

$ ./curl/tests/testcurl

Now you are ready to go. If you let the script run, it performs a full cycle and spit out lots of output. Mail us that output as described above.

CRONTAB EXAMPLE

The crontab could include something like this:

# autobuild curl:
0 4 * * * cd curl-testing && ./testit.sh

Where testit.sh is a shell script that could look similar to this:

mail="mail -s autobuild curl-autocompile@haxx.se"
name="--name=whoami"
email="--email=iamme@nowhere"
desc='"--desc=supermachine Turbo 2000"'
testprog="perl ./curl/tests/testcurl.pl $name $email $desc"
opts1="--configure=--enable-debug"
opts2="--configure=--enable-ipv6"

# run first test
$testprog $opts1 | $mail

# run second test
$testprog $opts2 | $mail
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: testcurl.pl
5Section: 1
6Source: testcurl
7See-also:
8 - runtests.pl
9Added-in: 7.11.2
10---
12# NAME
14testcurl.pl - (automatically) test curl
16# SYNOPSIS
18**testcurl.pl [options] [dir] \> output**
20# DESCRIPTION
22*testcurl* is the master script to use for automatic distributed testing of
23curl from git or daily snapshots. It is written for the purpose of being run
24from a crontab job or similar at a regular interval. The output is suitable to
25be mailed to **curl-autocompile@haxx.se** to be dealt with automatically (make
26sure the subject includes the word "autobuild" as the mail gets silently
27discarded otherwise). The most current build status (with a reasonable
28backlog) is published on the curl site, at https://curl.se/dev/builds.html
30*options* may be omitted. See *--setup* for what happens then.
32*dir* is a curl source directory, possibly a daily snapshot one. Using this
33makes *testcurl* skip the *autoreconf* stage and thus it removes the
34dependency on automake, autoconf, libtool, GNU m4 and possibly a few other
35things.
37*testcurl* runs `autoreconf` (or similar), configure, builds curl and libcurl
38in a separate build directory and then runs `make test` to test the fresh
39build.
41# OPTIONS
43## `--configure=[options]`
45Configure options passed to configure.
47## `--crosscompile`
49This is a cross-compile. Makes *testcurl* skip a few things.
51## `--desc=[desc]`
53Description of your test system. Displayed on the build summary page on the
54website.
56## `--email=[email]`
58Set email address to report as. Displayed in the build logs on the site.
60## `--mktarball=[command]`
62Generic command to run after completed test.
64## `--name=[name]`
66Set name to report as. Displayed in the build summary on the site.
68## `--nobuildconf`
70Do not run autoreconf. Useful when many builds use the same source tree, as
71then only one need to do this. Also, if multiple processes run tests
72simultaneously on the same source tree (like several hosts on a NFS mounted
73directory), simultaneous autoreconf invokes may cause problems. (Added in
747.14.1)
76## `--nogitpull`
78Do not update from git even though it is a git tree. Useful to still be able
79to test even though your network is down, or similar.
81## `--runtestopts=[options]`
83Options that is passed to the runtests script. Useful for disabling valgrind
84by force, and similar.
86## `--setup=[filename]`
88filename to read setup from (deprecated). The old style of providing info. If
89info is missing when *testcurl* is started, it prompts you and then stores the
90info in a 'setup' file, which it looks for on each invoke. Use *--name*,
91*--email*, *--configure* and *--desc* instead.
93## `--target=[your os]`
95Specify your target environment. Recognized strings include `vc`, `mingw32`,
96and `borland`.
98# INITIAL SETUP
100First, make a checkout from git (or you write a script that downloads daily
101snapshots automatically):
103 $ mkdir curl-testing
104 $ cd curl-testing
105 $ git clone https://github.com/curl/curl
107With the curl sources checked out, or downloaded, you can start testing right
108away. If you want to use *testcurl* without command line arguments and to have
109it store and remember the config in its 'setup' file, then start it manually
110now and fill in the answers to the questions it prompts you for:
112 $ ./curl/tests/testcurl
114Now you are ready to go. If you let the script run, it performs a full cycle
115and spit out lots of output. Mail us that output as described above.
117# CRONTAB EXAMPLE
119The crontab could include something like this:
121 # autobuild curl:
122 0 4 * * * cd curl-testing && ./testit.sh
124Where `testit.sh` is a shell script that could look similar to this:
126 mail="mail -s autobuild curl-autocompile@haxx.se"
127 name="--name=whoami"
128 email="--email=iamme@nowhere"
129 desc='"--desc=supermachine Turbo 2000"'
130 testprog="perl ./curl/tests/testcurl.pl $name $email $desc"
131 opts1="--configure=--enable-debug"
132 opts2="--configure=--enable-ipv6"
134 # run first test
135 $testprog $opts1 | $mail
137 # run second test
138 $testprog $opts2 | $mail
Diagnostics4 git calls · 34 ms
CallStatusSizeTime034 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=86
Open pack map
fetch2002.0 KiB · hit28 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=28
git.response.bytes=2079
git.response.cache=HIT
git.response.duration_ms=28
git.fetch.wants=090401aac03afb75f27ef2a6c055a79743486fba
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=2079
git.pkt.payload.max=2058
git.sideband.band1.bytes=2057
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
a5e2a58aacac1293
Request
cae1eb94…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format