This file is indexed.

/usr/share/doc/racket/raco/cc.html is in racket-doc 6.1-4.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"/><title>12.1&nbsp;Compiling and Linking C Extensions</title><link rel="stylesheet" type="text/css" href="../scribble.css" title="default"/><link rel="stylesheet" type="text/css" href="../racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-style.css" title="default"/><link rel="stylesheet" type="text/css" href="../manual-racket.css" title="default"/><link rel="stylesheet" type="text/css" href="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_0&quot;);">&#9658;</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco</span>:<span class="mywbr"> &nbsp;</span> Racket Command-<wbr></wbr>Line Tools</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1&nbsp;</td><td><a href="make.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco make</span>:<span class="mywbr"> &nbsp;</span> Compiling Source to Bytecode</a></td></tr><tr><td align="right">2&nbsp;</td><td><a href="exe.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco exe</span>:<span class="mywbr"> &nbsp;</span> Creating Stand-<wbr></wbr>Alone Executables</a></td></tr><tr><td align="right">3&nbsp;</td><td><a href="exe-dist.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco distribute</span>:<span class="mywbr"> &nbsp;</span> Sharing Stand-<wbr></wbr>Alone Executables</a></td></tr><tr><td align="right">4&nbsp;</td><td><a href="planet.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco planet</span>:<span class="mywbr"> &nbsp;</span> Automatic Package Distribution</a></td></tr><tr><td align="right">5&nbsp;</td><td><a href="pkg.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco pkg</span>:<span class="mywbr"> &nbsp;</span> Package Management</a></td></tr><tr><td align="right">6&nbsp;</td><td><a href="setup.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco setup</span>:<span class="mywbr"> &nbsp;</span> Installation Management</a></td></tr><tr><td align="right">7&nbsp;</td><td><a href="decompile.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco decompile</span>:<span class="mywbr"> &nbsp;</span> Decompiling Bytecode</a></td></tr><tr><td align="right">8&nbsp;</td><td><a href="demod.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco demod</span>:<span class="mywbr"> &nbsp;</span> Demodularizing Programs</a></td></tr><tr><td align="right">9&nbsp;</td><td><a href="link.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco link</span>:<span class="mywbr"> &nbsp;</span> Library Collection Links</a></td></tr><tr><td align="right">10&nbsp;</td><td><a href="plt.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco pack</span>:<span class="mywbr"> &nbsp;</span> Packing Library Collections</a></td></tr><tr><td align="right">11&nbsp;</td><td><a href="unpack.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco unpack</span>:<span class="mywbr"> &nbsp;</span> Unpacking Library Collections</a></td></tr><tr><td align="right">12&nbsp;</td><td><a href="ctool.html" class="tocviewselflink" data-pltdoc="x"><span class="stt">raco ctool</span>:<span class="mywbr"> &nbsp;</span> Working with C Code</a></td></tr><tr><td align="right">13&nbsp;</td><td><a href="test.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco test</span>:<span class="mywbr"> &nbsp;</span> Run tests</a></td></tr><tr><td align="right">14&nbsp;</td><td><a href="docs.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco docs</span>:<span class="mywbr"> &nbsp;</span> Documentation Search</a></td></tr><tr><td align="right">15&nbsp;</td><td><a href="expand.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco expand</span>:<span class="mywbr"> &nbsp;</span> Macro Expansion</a></td></tr><tr><td align="right">16&nbsp;</td><td><a href="scribble.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco scribble</span>:<span class="mywbr"> &nbsp;</span> Building Documentation</a></td></tr><tr><td align="right">17&nbsp;</td><td><a href="command.html" class="tocviewlink" data-pltdoc="x">Adding a <span class="stt">raco</span> Command</a></td></tr><tr><td align="right">18&nbsp;</td><td><a href="config-file.html" class="tocviewlink" data-pltdoc="x">Installation Configuration and Search Paths</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_1&quot;);">&#9660;</a></td><td>12&nbsp;</td><td><a href="ctool.html" class="tocviewlink" data-pltdoc="x"><span class="stt">raco ctool</span>:<span class="mywbr"> &nbsp;</span> Working with C Code</a></td></tr></table><div class="tocviewsublist" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1&nbsp;</td><td><a href="" class="tocviewselflink" data-pltdoc="x">Compiling and Linking C Extensions</a></td></tr><tr><td align="right">12.2&nbsp;</td><td><a href="c-mods.html" class="tocviewlink" data-pltdoc="x">Embedding Modules via C</a></td></tr><tr><td align="right">12.3&nbsp;</td><td><a href="API_for_Raw_Compilation.html" class="tocviewlink" data-pltdoc="x">API for Raw Compilation</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,&quot;tocview_2&quot;);">&#9658;</a></td><td>12.1&nbsp;</td><td><a href="" class="tocviewselflink" data-pltdoc="x">Compiling and Linking C Extensions</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_2"><table cellspacing="0" cellpadding="0"><tr><td align="right">12.1.1&nbsp;</td><td><a href="#%28part._xform-api%29" class="tocviewlink" data-pltdoc="x">API for 3m Transformation</a></td></tr></table></div></div></div><div class="tocsub"><div class="tocsubtitle">On this page:</div><table class="tocsublist" cellspacing="0"><tr><td><span class="tocsublinknumber">12.1.1<tt>&nbsp;</tt></span><a href="#%28part._xform-api%29" class="tocsubseclink" data-pltdoc="x">API for 3m Transformation</a></td></tr><tr><td><a href="#%28def._%28%28lib._compiler%2Fxform..rkt%29._xform%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">xform</span></span></a></td></tr></table></div></div><div class="maincolumn"><div class="main"><div class="navsettop"><span class="navleft"><form class="searchform"><input class="searchbox" style="color: #888;" type="text" value="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;6.1&quot;, &quot;../&quot;);" onfocus="this.style.color=&quot;black&quot;; this.style.textAlign=&quot;left&quot;; if (this.value == &quot;...search manuals...&quot;) this.value=&quot;&quot;;" onblur="if (this.value.match(/^ *$/)) { this.style.color=&quot;#888&quot;; this.style.textAlign=&quot;center&quot;; this.value=&quot;...search manuals...&quot;; }"/></form>&nbsp;&nbsp;<a href="../index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;6.1&quot;);">top</a></span><span class="navright">&nbsp;&nbsp;<a href="ctool.html" title="backward to &quot;12 raco ctool: Working with C Code&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ctool.html" title="up to &quot;12 raco ctool: Working with C Code&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="c-mods.html" title="forward to &quot;12.2 Embedding Modules via C&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div><h4 x-source-module="(lib &quot;scribblings/raco/raco.scrbl&quot;)" x-part-tag="&quot;cc&quot;">12.1<tt>&nbsp;</tt><a name="(part._cc)"></a>Compiling and Linking C Extensions</h4><p>A <a name="(tech._dynamic._extension)"></a><span style="font-style: italic">dynamic extension</span> is a shared library (a.k.a. DLL) that
extends Racket using the C API. An extension can be loaded explicitly
via <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._load-extension%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">load-extension</a></span>, or it can be loaded implicitly through
<span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=6.1" class="RktStxLink Sq" data-pltdoc="x">require</a></span> or <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=eval.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._load%252Fuse-compiled%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">load/use-compiled</a></span> in place of a source
<span class="RktVar">file</span> when the extension is located at</p><blockquote class="SCodeFlow"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=Manipulating_Paths.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._build-path%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">build-path</a></span><span class="hspace">&nbsp;</span><span class="RktVal">"compiled"</span><span class="hspace">&nbsp;</span><span class="RktVal">"native"</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._system-library-subpath%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">system-library-subpath</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=Manipulating_Paths.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._path-add-suffix%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">path-add-suffix</a></span><span class="hspace">&nbsp;</span><span class="RktVar">file</span><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=runtime.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._system-type%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">system-type</a></span><span class="hspace">&nbsp;</span><span class="RktVal">'</span><span class="RktVal">so-suffix</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></blockquote><p>relative to <span class="RktVar">file</span>.</p><p>For information on writing extensions, see <a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=inside&amp;rel=index.html&amp;version=6.1" class="Sq" data-pltdoc="x">Inside: Racket C API</a>.</p><p>Three <span class="stt">raco ctool</span> modes help for building extensions:</p><ul><li><p><span class="nobreak"><span class="stt">--cc</span></span> : Runs the host system&rsquo;s C compiler, automatically
supplying flags to locate the Racket header files and to
compile for inclusion in a shared library.</p></li><li><p><span class="nobreak"><span class="stt">--ld</span></span> : Runs the host system&rsquo;s C linker, automatically
supplying flags to locate and link to the Racket libraries
and to generate a shared library.</p></li><li><p><span class="nobreak"><span class="stt">--xform</span></span> : Transforms C code that is written without
explicit GC-cooperation hooks to cooperate with Racket&rsquo;s 3m
garbage collector; see <a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=inside&amp;rel=overview.html&amp;version=6.1" class="Sq" data-pltdoc="x">Overview</a> in
<a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=inside&amp;rel=index.html&amp;version=6.1" class="Sq" data-pltdoc="x">Inside: Racket C API</a>.</p></li></ul><p>Compilation and linking build on the <a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=dynext&amp;rel=Compilation.html&amp;version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">dynext/compile</span></a>
and <a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=dynext&amp;rel=Linking.html&amp;version=6.1" class="RktModLink Sq" data-pltdoc="x"><span class="RktSym">dynext/link</span></a> libraries. The following <span class="stt">raco ctool</span> flags
correspond to setting or accessing parameters for those libraries: <a name="(idx._(gentag._33._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--tool</span></span>,
<a name="(idx._(gentag._34._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--compiler</span></span>, <a name="(idx._(gentag._35._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--ccf</span></span>, <a name="(idx._(gentag._36._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--ccf</span></span>, <a name="(idx._(gentag._37._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--ccf-clear</span></span>,
<a name="(idx._(gentag._38._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--ccf-show</span></span>, <a name="(idx._(gentag._39._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--linker</span></span>, <a name="(idx._(gentag._40._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">++ldf</span></span>, <a name="(idx._(gentag._41._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--ldf</span></span>,
<a name="(idx._(gentag._42._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--ldf-clear</span></span>, <a name="(idx._(gentag._43._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--ldf-show</span></span>, <a name="(idx._(gentag._44._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">++ldl</span></span>, <a name="(idx._(gentag._45._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--ldl-show</span></span>,
<a name="(idx._(gentag._46._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">++cppf</span></span>, <a name="(idx._(gentag._47._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">++cppf</span></span> <a name="(idx._(gentag._48._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">++cppf-clear</span></span>, and <a name="(idx._(gentag._49._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--cppf-show</span></span>.</p><p>The <a name="(idx._(gentag._50._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--3m</span></span> flag specifies that the extension is to be
loaded into the 3m variant of Racket. The <a name="(idx._(gentag._51._(lib._scribblings/raco/raco..scrbl)))"></a><span class="nobreak"><span class="stt">--cgc</span></span>
flag specifies that the extension is to be used with the CGC. The
default depends on <span class="stt">raco</span>: <span class="nobreak"><span class="stt">--3m</span></span> if <span class="stt">raco</span> itself is running in
3m, <span class="nobreak"><span class="stt">--cgc</span></span> if <span class="stt">raco</span> itself is running in CGC.</p><h5 x-source-module="(lib &quot;scribblings/raco/raco.scrbl&quot;)" x-part-tag="&quot;xform-api&quot;">12.1.1<tt>&nbsp;</tt><a name="(part._xform-api)"></a><a name="(mod-path._compiler/xform)"></a>API for 3m Transformation</h5><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&amp;version=6.1" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="#%28mod-path._compiler%2Fxform%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">compiler/xform</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller">&nbsp;package:</span> <span class="stt">cext-lib</span></span></td></tr></table></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td><span class="RktPn">(</span><a name="(def._((lib._compiler/xform..rkt)._xform))"></a><span title="Provided from: compiler/xform | Package: cext-lib"><span class="RktSym"><a href="#%28def._%28%28lib._compiler%2Fxform..rkt%29._xform%29%29" class="RktValDef RktValLink" data-pltdoc="x">xform</a></span></span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktVar">quiet?</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktVar">input-file</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktVar">output-file</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="RktVar">include-dirs</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span></td></tr><tr><td><span class="hspace">&nbsp;</span></td><td><span class="hspace">&nbsp;</span>[</td><td><span class="RktPn">#:keep-lines?</span><span class="hspace">&nbsp;</span><span class="RktVar">keep-lines?</span>]<span class="RktPn">)</span></td><td><span class="hspace">&nbsp;</span></td><td>&rarr;</td><td><span class="hspace">&nbsp;</span></td><td><span class="RktSym">any/c</span></td></tr></table></blockquote></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">quiet?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym">any/c</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">input-file</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=Manipulating_Paths.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._path-string%7E3f%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">output-file</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=Manipulating_Paths.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._path-string%7E3f%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">path-string?</a></span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">include-dirs</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktPn">(</span><span class="RktSym">listof</span><span class="hspace">&nbsp;</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=Manipulating_Paths.html%23%2528def._%2528%2528lib._racket%252Fprivate%252Fmisc..rkt%2529._path-string%7E3f%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">path-string?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace">&nbsp;&nbsp;</span><span class="RktVar">keep-lines?</span><span class="hspace">&nbsp;</span>:<span class="hspace">&nbsp;</span><span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=reference&amp;rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span><span class="hspace">&nbsp;</span>=<span class="hspace">&nbsp;</span><span class="RktVal">#f</span></td></tr></table></blockquote></div><div class="SIntrapara">Transforms C code that is written without explicit GC-cooperation
hooks to cooperate with Racket&rsquo;s 3m garbage collector; see
<a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=inside&amp;rel=overview.html&amp;version=6.1" class="Sq" data-pltdoc="x">Overview</a> in
<a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=inside&amp;rel=index.html&amp;version=6.1" class="Sq" data-pltdoc="x">Inside: Racket C API</a>.</div></p><p>The arguments are as for <span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=dynext&amp;rel=Compilation.html%23%2528def._%2528%2528lib._dynext%252Fcompile..rkt%2529._compile-extension%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">compile-extension</a></span>; in addition
<span class="RktVar">keep-lines?</span> can be <span class="RktVal">#t</span> to generate GCC-style
annotations to connect the generated C code with the original source
locations.</p><p>The file generated by <span class="RktSym"><a href="#%28def._%28%28lib._compiler%2Fxform..rkt%29._xform%29%29" class="RktValLink" data-pltdoc="x">xform</a></span> can be compiled via
<span class="RktSym"><a href="http://download.racket-lang.org/docs/6.1/html/local-redirect/index.html?doc=dynext&amp;rel=Compilation.html%23%2528def._%2528%2528lib._dynext%252Fcompile..rkt%2529._compile-extension%2529%2529&amp;version=6.1" class="RktValLink Sq" data-pltdoc="x">compile-extension</a></span>.</p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" style="color: #888;" type="text" value="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, &quot;6.1&quot;, &quot;../&quot;);" onfocus="this.style.color=&quot;black&quot;; this.style.textAlign=&quot;left&quot;; if (this.value == &quot;...search manuals...&quot;) this.value=&quot;&quot;;" onblur="if (this.value.match(/^ *$/)) { this.style.color=&quot;#888&quot;; this.style.textAlign=&quot;center&quot;; this.value=&quot;...search manuals...&quot;; }"/></form>&nbsp;&nbsp;<a href="../index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot(&quot;6.1&quot;);">top</a></span><span class="navright">&nbsp;&nbsp;<a href="ctool.html" title="backward to &quot;12 raco ctool: Working with C Code&quot;" data-pltdoc="x">&larr; prev</a>&nbsp;&nbsp;<a href="ctool.html" title="up to &quot;12 raco ctool: Working with C Code&quot;" data-pltdoc="x">up</a>&nbsp;&nbsp;<a href="c-mods.html" title="forward to &quot;12.2 Embedding Modules via C&quot;" data-pltdoc="x">next &rarr;</a></span>&nbsp;</div></div></div><div id="contextindicator">&nbsp;</div></body></html>