/
_howto.html
123 lines (104 loc) · 3.57 KB
/
_howto.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
#include "_doctype.html"
<html>
<head> <title>curl - Automatic Build HOWTO</title>
#include "css.t"
</head>
#define DEVEL_BUILDSTATS
#include "_menu.html"
#include "setup.t"
WHERE2(Development, "/dev/", Automatic Build HOWTO)
TITLE(Setup Your Machine to Autobuild from git)
#include "setup.t"
SUBTITLE(Get a Fresh Check-out from git)
<p>
First, run these commands:
<pre>
$ mkdir someplacenice
$ cd someplacenice
$ git clone https://github.com/curl/curl.git
$ ./curl/tests/testcurl.pl
</pre>
<p>
The first time to run <a href="testcurl.html">testcurl.pl</a>, it'll prompt
you for some info (unless you provide that data using command line
options). That info is then stored in the file named 'setup' in the current
directory and will be used when this script is subsequently run. The format
is easily manually edited using a text editor.
<p>
You'll now see a full compile, build and test perform. Make sure everything
works out fine.
<p>
Then, in a cron job do:
<pre>
$ cd someplacenice
$ ./curl/tests/testcurl.pl | mail -s "autobuild" curl-autocompile@haxx.se
</pre>
<p>
<b>Note:</b> It is important that you do include the word 'autobuild' in the
subject of the mail, as mails to this receiver without that word in the
subject will mercilessly get sent to /dev/null with no questions asked.
#if 0
<p>
If mailing the info is not suitable for you, but you have a working curl
version installed, you can upload the file with curl self:
<pre>
$ ./curl/tests/testcurl.pl | curl -s -F file=@- https://curl.haxx.se/dev/upload.cgi
</pre>
<p>
You can also use this
<a href="https://curl.haxx.se/dev/upload.cgi">upload form</a> "manually".
#endif
SUBTITLE(Other platforms than Unix)
On Unix/Linux testcurl.pl assumes a GNU-like build with configure; on Win32
the MSVC build is default. The testcurl.pl can now take an option
'<tt>--target=[your_os]</tt>' so you can specify to build targets for other
platforms. With this option it should now be very easy to add other
autobuilds for platforms not able to use GNU-like build systems.
SUBTITLE(Build from daily tarballs)
<p>
If you can't checkout or update the sources from git easily, another approach
to automated testing of the latest sources is made by getting the latest <a
href="https://curl.haxx.se/snapshots/">daily tarballs</a> automatically
instead.
<p>
This is easily done with the use of the <a href="autocurl.txt">autocurl</a>
shell script, written by Ralph Mitchell.
SUBTITLE(Make more tests run)
<p>
The number of tests run on some tests are not the maximum amount, but instead
numerous ones are "skipped".
<p>
This is because some of the tests require specal conditions that are not
enabled everywhere. You can improve this situation by using the configure's
<b>--enable-debug</b> option (which enables much more thorough memory and
netrc debugging) and to make sure that you have <b>stunnel</b> installed
(which enables HTTPS tests to run).
SUBTITLE(Build Table Updates)
<p>
The tables are rebuilt every 20 minutes if there has been a new build log
mailed in since the previous table was built.
<p>
We automatically remove build logs older than 10 - 12 days to reduce the
amount of data and used disk space.
<hr>
SUBTITLE(Platforms/Options We Want Tested As Well)
<p>
If you feel like helping out the project, have a peek here and see what
autobuilds we would appreciate to get going!
<p>
We have no automatic building/testing on these platforms:
<ul>
<li> AmigaOS
<li> BeOS
<li> HP-UX
<li> Hurd
<li> Mac OS X
<li> OS/2
<li> OpenBSD
<li> QNX
<li> RiscOS
<li> SCO Unix
<li> VMS
</ul>
#include "_footer.html"
</body> </html>