<?xml version="1.0" encoding="UTF-8"?>
<!--

Licensed to the Ant-Contrib Project under one or more
 contributor license agreements.  See the NOTICE file distributed with
 this work for additional information regarding copyright ownership.
 The Ant-Contrib Project licenses this file to You under the Apache License, Version 2.0
 (the "License"); you may not use this file except in compliance with
 the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.

  -->
<document xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:taskdocs="http://ant-contrib.sf.net/taskdocs">
<properties>
<title>linker</title>
</properties>
<body>
<section name="linker">
<subsection name="Description">A linker definition. linker elements may be placed either as children of a
 cc element or the project element. A linker element with an id attribute may
 be referenced by linker elements with refid or extends attributes.</subsection>
<subsection name="parameters">
<table>
<tr>
<td>
<b>Attribute</b>
</td>
<td>
<b>Description</b>
</td>
<td>
<b>Type</b>
</td>
</tr>
<tr>
<td>base</td>
<td>Sets the base address. May be specified in either decimal or hex.</td>
<td>
<a href="../apidocs/net/sf/antcontrib/cpptasks/types/FlexLong.html">FlexLong</a>
</td>
</tr>
<tr>
<td>classname</td>
<td>Sets the class name for the adapter. Use the "name" attribute when the
 tool is supported.</td>
<td>String</td>
</tr>
<tr>
<td>debug</td>
<td>If set true, all targets will be built for debugging.</td>
<td>boolean</td>
</tr>
<tr>
<td>description</td>
<td>Sets a description of the current data type.</td>
<td>String</td>
</tr>
<tr>
<td>entry</td>
<td>Sets the starting address.</td>
<td>String</td>
</tr>
<tr>
<td>extends</td>
<td>Specifies that this element extends the element with id attribute with a
 matching value. The configuration will be constructed from the settings
 of this element, element referenced by extends, and the containing cc
 element.</td>
<td>Reference</td>
</tr>
<tr>
<td>fixed</td>
<td>If true, marks the file to be loaded only at its preferred address.</td>
<td>boolean</td>
</tr>
<tr>
<td>id</td>
<td>Sets an id that can be used to reference this element.</td>
<td>String</td>
</tr>
<tr>
<td>if</td>
<td>Sets the property name for the 'if' condition.
 
 The configuration will be ignored unless the property is defined.
 
 The value of the property is insignificant, but values that would imply
 misinterpretation ("false", "no") will throw an exception when
 evaluated.</td>
<td>String</td>
</tr>
<tr>
<td>incremental</td>
<td>If true, allows incremental linking.</td>
<td>boolean</td>
</tr>
<tr>
<td>inherit</td>
<td>If inherit has the default value of true, defines, includes and other
 settings from the containing cc element will be inherited.</td>
<td>boolean</td>
</tr>
<tr>
<td>libtool</td>
<td>Set use of libtool.
 
 If set to true, the "libtool " will be prepended to the command line</td>
<td>boolean</td>
</tr>
<tr>
<td>map</td>
<td>If set to true, a map file will be produced.</td>
<td>boolean</td>
</tr>
<tr>
<td>name</td>
<td>Sets linker type.
 
 
 <table> <thead>Supported linkers </thead>
 <tr>
 <td>gcc</td>
 <td>Gcc Linker</td>
 </tr>
 <tr>
 <td>g++</td>
 <td>G++ Linker</td>
 </tr>
 <tr>
 <td>ld</td>
 <td>Ld Linker</td>
 </tr>
 <tr>
 <td>ar</td>
 <td>Gcc Librarian</td>
 </tr>
 <tr>
 <td>msvc</td>
 <td>Microsoft Linker</td>
 </tr>
 <tr>
 <td>bcc</td>
 <td>Borland Linker</td>
 </tr>
 <tr>
 <td>df</td>
 <td>Compaq Visual Fortran Linker</td>
 </tr>
 <tr>
 <td>icl</td>
 <td>Intel Linker for Windows (IA-32)</td>
 </tr>
 <tr>
 <td>ecl</td>
 <td>Intel Linker for Windows (IA-64)</td>
 </tr>
 <tr>
 <td>icc</td>
 <td>Intel Linker for Linux (IA-32)</td>
 </tr>
 <tr>
 <td>ecc</td>
 <td>Intel Linker for Linux (IA-64)</td>
 </tr>
 <tr>
 <td>CC</td>
 <td>Sun ONE Linker</td>
 </tr>
 <tr>
 <td>aCC</td>
 <td>HP aC++ Linker</td>
 </tr>
 <tr>
 <td>os390</td>
 <td>OS390 Linker</td>
 </tr>
 <tr>
 <td>os390batch</td>
 <td>OS390 Linker</td>
 </tr>
 <tr>
 <td>os400</td>
 <td>IccLinker</td>
 </tr>
 <tr>
 <td>sunc89</td>
 <td>C89 Linker</td>
 </tr>
 <tr>
 <td>xlC</td>
 <td>VisualAge Linker</td>
 </tr>
 <tr>
 <td>wcl</td>
 <td>OpenWatcom C/C++ linker</td>
 </tr>
 <tr>
 <td>wfl</td>
 <td>OpenWatcom FORTRAN linker</td>
 </tr>
 </table>
</td>
<td>
<a href="../apidocs/net/sf/antcontrib/cpptasks/LinkerEnum.html">LinkerEnum</a>
</td>
</tr>
<tr>
<td>newenvironment</td>
<td>Do not propagate old environment when new environment variables are
 specified.</td>
<td>boolean</td>
</tr>
<tr>
<td>rebuild</td>
<td>If set true, all targets will be unconditionally rebuilt.</td>
<td>boolean</td>
</tr>
<tr>
<td>refid</td>
<td>Specifies that this element should behave as if the content of the
 element with the matching id attribute was inserted at this location. If
 specified, no other attributes or child content should be specified,
 other than "if", "unless" and "description".</td>
<td>Reference</td>
</tr>
<tr>
<td>stack</td>
<td>Sets stack size in bytes.</td>
<td>FlexInteger</td>
</tr>
<tr>
<td>unless</td>
<td>Set the property name for the 'unless' condition.
 
 If named property is set, the configuration will be ignored.
 
 The value of the property is insignificant, but values that would imply
 misinterpretation ("false", "no") of the behavior will throw an
 exception when evaluated.</td>
<td>String</td>
</tr>
</table>
</subsection>
<subsection name="parameters as nested elements">
<dl>
<dt>
<a href="about:blank">env</a>
</dt>
<dd>Add an environment variable to the launched process.</dd>
<dt>
<a href="ConditionalFileSet.html">fileset</a>
</dt>
<dd>Adds a source file set.
 
 Files in these set will be processed by this configuration and will not
 participate in the auction.</dd>
<dt>
<a href="LibrarySet.html">libset</a>
</dt>
<dd>Adds a system library set.</dd>
<dt>
<a href="LinkerArgument.html">linkerarg</a>
</dt>
<dd>Adds a linker command-line arg.</dd>
<dt>
<a href="LinkerParam.html">linkerparam</a>
</dt>
<dd>Adds a compiler command-line arg.</dd>
<dt>
<a href="SystemLibrarySet.html">syslibset</a>
</dt>
<dd>Adds a system library set.</dd>
</dl>
</subsection>
</section>
</body>
</document>
