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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>4.README</title>
<link rel="stylesheet" type="text/css" href="vg_basic.css">
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="Valgrind Documentation">
<link rel="up" href="dist.html" title="Valgrind Distribution Documents">
<link rel="prev" href="dist.news.old.html" title="3.OLDER NEWS">
<link rel="next" href="dist.readme-missing.html" title="5.README_MISSING_SYSCALL_OR_IOCTL">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div><table class="nav" width="100%" cellspacing="3" cellpadding="3" border="0" summary="Navigation header"><tr>
<td width="22px" align="center" valign="middle"><a accesskey="p" href="dist.news.old.html"><img src="images/prev.png" width="18" height="21" border="0" alt="Prev"></a></td>
<td width="25px" align="center" valign="middle"><a accesskey="u" href="dist.html"><img src="images/up.png" width="21" height="18" border="0" alt="Up"></a></td>
<td width="31px" align="center" valign="middle"><a accesskey="h" href="index.html"><img src="images/home.png" width="27" height="20" border="0" alt="Up"></a></td>
<th align="center" valign="middle">Valgrind Distribution Documents</th>
<td width="22px" align="center" valign="middle"><a accesskey="n" href="dist.readme-missing.html"><img src="images/next.png" width="18" height="21" border="0" alt="Next"></a></td>
</tr></table></div>
<div class="chapter">
<div class="titlepage"><div><div><h1 class="title">
<a name="dist.readme"></a>4.README</h1></div></div></div>
<div class="literallayout"><p><br>
<br>
ReleasenotesforValgrind<br>
~~~~~~~~~~~~~~~~~~~~~~~~~~<br>
IfyouarebuildingabinarypackageofValgrindfordistribution,<br>
pleasereadREADME_PACKAGERS.Itcontainssomeimportantinformation.<br>
<br>
IfyouaredevelopingValgrind,pleasereadREADME_DEVELOPERS.Itcontains<br>
someusefulinformation.<br>
<br>
Forinstructionsonhowtobuild/install,seetheendofthisfile.<br>
<br>
Ifyouhaveproblems,consulttheFAQtoseeifthereareworkarounds.<br>
<br>
<br>
ExecutiveSummary<br>
~~~~~~~~~~~~~~~~~<br>
Valgrindisaframeworkforbuildingdynamicanalysistools.Thereare<br>
Valgrindtoolsthatcanautomaticallydetectmanymemorymanagement<br>
andthreadingbugs,andprofileyourprogramsindetail.Youcanalso<br>
useValgrindtobuildnewtools.<br>
<br>
TheValgrinddistributioncurrentlyincludessixproduction-quality<br>
tools:amemoryerrordetector,twothreaderrordetectors,acache<br>
andbranch-predictionprofiler,acall-graphgeneratingcacheabd<br>
branch-predictionprofiler,andaheapprofiler.Italsoincludes<br>
threeexperimentaltools:aheap/stack/globalarrayoverrundetector,<br>
adifferentkindofheapprofiler,andaSimPointbasicblockvector<br>
generator.<br>
<br>
ValgrindiscloselytiedtodetailsoftheCPU,operatingsystemandto<br>
alesserextent,compilerandbasicClibraries.Thismakesitdifficult<br>
tomakeitportable.Nonetheless,itisavailableforthefollowing<br>
platforms:<br>
<br>
-X86/Linux<br>
-AMD64/Linux<br>
-PPC32/Linux<br>
-PPC64/Linux<br>
-ARM/Linux<br>
-x86/MacOSX<br>
-AMD64/MacOSX<br>
-S390X/Linux<br>
-MIPS32/Linux<br>
-MIPS64/Linux<br>
<br>
NotethatAMD64isjustanothernameforx86_64,andValgrindrunsfine<br>
onIntelprocessors.AlsonotethatthecoreofMacOSXiscalled<br>
"Darwin"andthisnameisusedsometimes.<br>
<br>
ValgrindislicensedundertheGNUGeneralPublicLicense,version2.<br>
ReadthefileCOPYINGinthesourcedistributionfordetails.<br>
<br>
However:ifyoucontributecode,youneedtomakeitavailableasGPL<br>
version2orlater,andnot2-only.<br>
<br>
<br>
Documentation<br>
~~~~~~~~~~~~~<br>
Acomprehensiveuserguideissupplied.Pointyourbrowserat<br>
$PREFIX/share/doc/valgrind/manual.html,where$PREFIXiswhateveryou<br>
specifiedwith--prefix=whenbuilding.<br>
<br>
<br>
Buildingandinstallingit<br>
~~~~~~~~~~~~~~~~~~~~~~~~~~<br>
ToinstallfromtheSubversionrepository:<br>
<br>
0.CheckoutthecodefromSVN,followingtheinstructionsat<br>
http://www.valgrind.org/downloads/repository.html.<br>
<br>
1.cdintothesourcedirectory.<br>
<br>
2.Run./autogen.shtosetuptheenvironment(youneedthestandard<br>
autoconftoolstodoso).<br>
<br>
3.Continuewiththefollowinginstructions...<br>
<br>
Toinstallfromatar.bz2distribution:<br>
<br>
4.Run./configure,withsomeoptionsifyouwish.Theonlyinteresting<br>
oneistheusual--prefix=/where/you/want/it/installed.<br>
<br>
5.Run"make".<br>
<br>
6.Run"makeinstall",possiblyasrootifthedestinationpermissions<br>
requirethat.<br>
<br>
7.Seeifitworks.Try"valgrindls-l".Eitherthisworks,orit<br>
bombsoutwithsomecomplaint.Inthatcase,pleaseletusknow<br>
(seewww.valgrind.org).<br>
<br>
Important!Donotmovethevalgrindinstallationintoaplace<br>
differentfromthatspecifiedby--prefixatbuildtime.Thiswill<br>
causethingstobreakinsubtleways,mostlywhenValgrindhandles<br>
fork/execcalls.<br>
<br>
<br>
TheValgrindDevelopers<br>
<br>
</p></div>
</div>
<div>
<br><table class="nav" width="100%" cellspacing="3" cellpadding="2" border="0" summary="Navigation footer">
<tr>
<td rowspan="2" width="40%" align="left">
<a accesskey="p" href="dist.news.old.html"><<3.OLDER NEWS</a></td>
<td width="20%" align="center"><a accesskey="u" href="dist.html">Up</a></td>
<td rowspan="2" width="40%" align="right"><a accesskey="n" href="dist.readme-missing.html">5.README_MISSING_SYSCALL_OR_IOCTL>></a>
</td>
</tr>
<tr><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td></tr>
</table>
</div>
</body>
</html>
|
