1 <html> 2 <head> 3 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> 4 <title>4.README</title> 5 <link rel="stylesheet" type="text/css" href="vg_basic.css"> 6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 7 <link rel="home" href="index.html" title="Valgrind Documentation"> 8 <link rel="up" href="dist.html" title="Valgrind Distribution Documents"> 9 <link rel="prev" href="dist.news.old.html" title="3.OLDER NEWS"> 10 <link rel="next" href="dist.readme-missing.html" title="5.README_MISSING_SYSCALL_OR_IOCTL"> 11 </head> 12 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 13 <div><table class="nav" width="100%" cellspacing="3" cellpadding="3" border="0" summary="Navigation header"><tr> 14 <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> 15 <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> 16 <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> 17 <th align="center" valign="middle">Valgrind Distribution Documents</th> 18 <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> 19 </tr></table></div> 20 <div class="chapter"> 21 <div class="titlepage"><div><div><h1 class="title"> 22 <a name="dist.readme"></a>4.README</h1></div></div></div> 23 <div class="literallayout"><p><br> 24 <br> 25 ReleasenotesforValgrind<br> 26 ~~~~~~~~~~~~~~~~~~~~~~~~~~<br> 27 IfyouarebuildingabinarypackageofValgrindfordistribution,<br> 28 pleasereadREADME_PACKAGERS.Itcontainssomeimportantinformation.<br> 29 <br> 30 IfyouaredevelopingValgrind,pleasereadREADME_DEVELOPERS.Itcontains<br> 31 someusefulinformation.<br> 32 <br> 33 Forinstructionsonhowtobuild/install,seetheendofthisfile.<br> 34 <br> 35 Ifyouhaveproblems,consulttheFAQtoseeifthereareworkarounds.<br> 36 <br> 37 <br> 38 ExecutiveSummary<br> 39 ~~~~~~~~~~~~~~~~~<br> 40 Valgrindisaframeworkforbuildingdynamicanalysistools.Thereare<br> 41 Valgrindtoolsthatcanautomaticallydetectmanymemorymanagement<br> 42 andthreadingbugs,andprofileyourprogramsindetail.Youcanalso<br> 43 useValgrindtobuildnewtools.<br> 44 <br> 45 TheValgrinddistributioncurrentlyincludessixproduction-quality<br> 46 tools:amemoryerrordetector,twothreaderrordetectors,acache<br> 47 andbranch-predictionprofiler,acall-graphgeneratingcacheabd<br> 48 branch-predictionprofiler,andaheapprofiler.Italsoincludes<br> 49 threeexperimentaltools:aheap/stack/globalarrayoverrundetector,<br> 50 adifferentkindofheapprofiler,andaSimPointbasicblockvector<br> 51 generator.<br> 52 <br> 53 ValgrindiscloselytiedtodetailsoftheCPU,operatingsystemandto<br> 54 alesserextent,compilerandbasicClibraries.Thismakesitdifficult<br> 55 tomakeitportable.Nonetheless,itisavailableforthefollowing<br> 56 platforms:<br> 57 <br> 58 -X86/Linux<br> 59 -AMD64/Linux<br> 60 -PPC32/Linux<br> 61 -PPC64/Linux<br> 62 -ARM/Linux<br> 63 -x86/MacOSX<br> 64 -AMD64/MacOSX<br> 65 -S390X/Linux<br> 66 -MIPS32/Linux<br> 67 -MIPS64/Linux<br> 68 -X86/Solaris<br> 69 -AMD64/Solaris<br> 70 <br> 71 NotethatAMD64isjustanothernameforx86_64,andValgrindrunsfine<br> 72 onIntelprocessors.AlsonotethatthecoreofMacOSXiscalled<br> 73 "Darwin"andthisnameisusedsometimes.<br> 74 <br> 75 ValgrindislicensedundertheGNUGeneralPublicLicense,version2.<br> 76 ReadthefileCOPYINGinthesourcedistributionfordetails.<br> 77 <br> 78 However:ifyoucontributecode,youneedtomakeitavailableasGPL<br> 79 version2orlater,andnot2-only.<br> 80 <br> 81 <br> 82 Documentation<br> 83 ~~~~~~~~~~~~~<br> 84 Acomprehensiveuserguideissupplied.Pointyourbrowserat<br> 85 $PREFIX/share/doc/valgrind/manual.html,where$PREFIXiswhateveryou<br> 86 specifiedwith--prefix=whenbuilding.<br> 87 <br> 88 <br> 89 Buildingandinstallingit<br> 90 ~~~~~~~~~~~~~~~~~~~~~~~~~~<br> 91 ToinstallfromtheSubversionrepository:<br> 92 <br> 93 0.CheckoutthecodefromSVN,followingtheinstructionsat<br> 94 http://www.valgrind.org/downloads/repository.html.<br> 95 <br> 96 1.cdintothesourcedirectory.<br> 97 <br> 98 2.Run./autogen.shtosetuptheenvironment(youneedthestandard<br> 99 autoconftoolstodoso).<br> 100 <br> 101 3.Continuewiththefollowinginstructions...<br> 102 <br> 103 Toinstallfromatar.bz2distribution:<br> 104 <br> 105 4.Run./configure,withsomeoptionsifyouwish.Theonlyinteresting<br> 106 oneistheusual--prefix=/where/you/want/it/installed.<br> 107 <br> 108 5.Run"make".<br> 109 <br> 110 6.Run"makeinstall",possiblyasrootifthedestinationpermissions<br> 111 requirethat.<br> 112 <br> 113 7.Seeifitworks.Try"valgrindls-l".Eitherthisworks,orit<br> 114 bombsoutwithsomecomplaint.Inthatcase,pleaseletusknow<br> 115 (seewww.valgrind.org).<br> 116 <br> 117 Important!Donotmovethevalgrindinstallationintoaplace<br> 118 differentfromthatspecifiedby--prefixatbuildtime.Thiswill<br> 119 causethingstobreakinsubtleways,mostlywhenValgrindhandles<br> 120 fork/execcalls.<br> 121 <br> 122 <br> 123 TheValgrindDevelopers<br> 124 <br> 125 </p></div> 126 </div> 127 <div> 128 <br><table class="nav" width="100%" cellspacing="3" cellpadding="2" border="0" summary="Navigation footer"> 129 <tr> 130 <td rowspan="2" width="40%" align="left"> 131 <a accesskey="p" href="dist.news.old.html"><<3.OLDER NEWS</a></td> 132 <td width="20%" align="center"><a accesskey="u" href="dist.html">Up</a></td> 133 <td rowspan="2" width="40%" align="right"><a accesskey="n" href="dist.readme-missing.html">5.README_MISSING_SYSCALL_OR_IOCTL>></a> 134 </td> 135 </tr> 136 <tr><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td></tr> 137 </table> 138 </div> 139 </body> 140 </html> 141
