2
<title>testcurl.pl man page</title>
3
<meta name="generator" content="roffit 0.7">
4
<STYLE type="text/css">
30
background-color: #e0e0e0;
36
font-family: monospace;
46
<p class="level0"><a name="NAME"></a><h2 class="nroffsh">NAME</h2>
47
<p class="level0">testcurl.pl - (automatically) test curl <a name="SYNOPSIS"></a><h2 class="nroffsh">SYNOPSIS</h2>
48
<p class="level0"><span Class="bold">testcurl.pl [options] [dir] > output</span> <a name="DESCRIPTION"></a><h2 class="nroffsh">DESCRIPTION</h2>
49
<p class="level0"><span Class="emphasis">testcurl.pl</span> is the master script to use for automatic testing of curl off CVS 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) will be published on the curl site, at <a href="http://curl.haxx.se/auto/">http://curl.haxx.se/auto/</a>
50
<p class="level0"><span Class="emphasis">options</span> may be omitted. See <span Class="emphasis">--setup</span> for what happens then.
51
<p class="level0"><span Class="emphasis">dir</span> is a curl source dir, possibly a daily snapshot one. Using this will make testcurl.pl skip the 'buildconf' stage and thus it removes the dependency on automake, autoconf, libtool, GNU m4 and possibly a few other things.
52
<p class="level0">testcurl.pl will run 'buildconf' (or similar), run configure, build curl and libcurl in a separate build directory and then run 'make test' to test the fresh build. <a name="OPTIONS"></a><h2 class="nroffsh">OPTIONS</h2>
54
<p class="level0"><a name="--configureoptions"></a><span class="nroffip">--configure=[options]</span>
55
<p class="level1">Configure options passed to configure.
56
<p class="level0"><a name="--crosscompile"></a><span class="nroffip">--crosscompile</span>
57
<p class="level1">This is a cross-compile. Makes <span Class="emphasis">testcurl.pl</span> skip a few things.
58
<p class="level0"><a name="--descdesc"></a><span class="nroffip">--desc=[desc]</span>
59
<p class="level1">Description of your test system. Displayed on the build summary page on the weba site.
60
<p class="level0"><a name="--emailemail"></a><span class="nroffip">--email=[email]</span>
61
<p class="level1">Set email address to report as. Displayed in the build logs on the site.
62
<p class="level0"><a name="--mktarballcommand"></a><span class="nroffip">--mktarball=[command]</span>
63
<p class="level1">Generic command to run after completed test.
64
<p class="level0"><a name="--namename"></a><span class="nroffip">--name=[name]</span>
65
<p class="level1">Set name to report as. Displayed in the build summary on the site.
66
<p class="level0"><a name="--nocvsup"></a><span class="nroffip">--nocvsup</span>
67
<p class="level1">Don't update from CVS even though it is a CVS tree. Useful to still be able to test even though your network is down, or similar.
68
<p class="level0"><a name="--runtestoptsoptions"></a><span class="nroffip">--runtestopts=[options]</span>
69
<p class="level1">Options that is passed to the runtests.pl script. Useful for disabling valgrind by force, and similar.
70
<p class="level0"><a name="--setupfile"></a><span class="nroffip">--setup=[file name]</span>
71
<p class="level1">File name to read setup from (deprecated). The old style of providing info. If info is missing when testcurl.pl is started, it will prompt you and then store the info in a 'setup' file, which it will look for on each invoke. Use <span Class="emphasis">--name</span>, <span Class="emphasis">--emacs</span>, <span Class="emphasis">--configure</span> and <span Class="emphasis">--desc</span> instead.
72
<p class="level0"><a name="--targetyour"></a><span class="nroffip">--target=[your os]</span>
73
<p class="level1">Specify your target environment. Recognized strings include 'vc', 'mingw32', 'borland' and 'netware'. <a name="INITIAL"></a><h2 class="nroffsh">INITIAL SETUP</h2>
74
<p class="level0">First you make a checkout from CVS (or you write a script that downloads daily snapshots automatically, find inspiration at <a href="http://curl.haxx.se/auto/autocurl.txt">http://curl.haxx.se/auto/autocurl.txt</a>):
75
<p class="level0"><pre>
76
<p class="level0"> $ mkdir daily-curl
77
$ cd daily-curl
78
$ cvs -d :pserver:anonymous@cool.haxx.se:/cvsroot/curl login
79
[enter return when prompted for password ]
80
$ cvs -d :pserver:anonymous@cool.haxx.se:/cvsroot/curl checkout curl
81
<p class="level0">With the curl sources checked out, or downloaded, you can start testing right
82
away. If you want to use <span Class="emphasis">testcurl.pl</span> without command line arguments and
83
to have it store and remember the config in its 'setup' file, then start it
84
manually now and fill in the answers to the questions it prompts you for:
85
<p class="level0"><pre>
86
<p class="level0"> $ ./curl/tests/testcurl.pl
87
<p class="level0">Now you are ready to go. If you let the script run, it will perform a full
88
cycle and spit out lots of output. Mail us that output as described above.
90
<a name="CRONTAB"></a><h2 class="nroffsh">CRONTAB EXAMPLE</h2>
91
<p class="level0">The crontab could include something like this:
92
<p class="level0"><pre>
93
<p class="level0"># autobuild curl:
94
0 4 * * * cd daily-curl && ./testit.sh
95
<p class="level0">Where testit.sh is a shell script that could look similar to this:
96
<p class="level0"><pre>
97
<p class="level0">mail="mail -s autobuild curl-autocompile@haxx.se"
99
email="--email=iamme@nowhere"
100
desc='"--desc=supermachine Turbo 2000"'
101
testprog="perl ./curl/tests/testcurl.pl $name $email $desc"
102
opts1="--configure=--enable-debug"
103
opts2="--configure=--enable-ipv6"
104
<p class="level0"># run first test
105
$testprog $opts1 | $mail
106
<p class="level0"># run second test
107
$testprog $opts2 | $mail
109
This HTML page was made with <a href="http://daniel.haxx.se/projects/roffit/">roffit</a>.
added
removed
tests/testcurl.html
