cpptasks: Compile tasks for Apache Ant - linker

ant-contrib

##### Get cpptasks

- Download
- Changes
- License

##### About cpptasks

- Usage

##### Elements

- cc
- compiler
- defineset
- distributer
- libraryset
- linker
- syslibraryset
- targetplatform
- versioninfo

##### Community

- Mailing Lists
- Issue Tracking
- Project Page
- News

##### Development

- Repository
- JavaDoc
- Continuous Integration

## linker

### 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.

### parameters

Attribute | Description | Type
base | Sets the base address. May be specified in either decimal or hex. | FlexLong
classname | Sets the class name for the adapter. Use the "name" attribute when the tool is supported. | String
debug | If set true, all targets will be built for debugging. | boolean
description | Sets a description of the current data type. | String
entry | Sets the starting address. | String
extends | 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. | Reference
fixed | If true, marks the file to be loaded only at its preferred address. | boolean
id | Sets an id that can be used to reference this element. | String
if | 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. | String
incremental | If true, allows incremental linking. | boolean
inherit | If inherit has the default value of true, defines, includes and other settings from the containing cc element will be inherited. | boolean
libtool | Set use of libtool. If set to true, the "libtool " will be prepended to the command line | boolean
map | If set to true, a map file will be produced. | boolean
name | Sets linker type.
Supported linkers
gcc | Gcc Linker
g++ | G++ Linker
ld | Ld Linker
ar | Gcc Librarian
msvc | Microsoft Linker
bcc | Borland Linker
df | Compaq Visual Fortran Linker
icl | Intel Linker for Windows (IA-32)
ecl | Intel Linker for Windows (IA-64)
icc | Intel Linker for Linux (IA-32)
ecc | Intel Linker for Linux (IA-64)
CC | Sun ONE Linker
aCC | HP aC++ Linker
os390 | OS390 Linker
os390batch | OS390 Linker
os400 | IccLinker
sunc89 | C89 Linker
xlC | VisualAge Linker
wcl | OpenWatcom C/C++ linker
wfl | OpenWatcom FORTRAN linker
| LinkerEnum
newenvironment | Do not propagate old environment when new environment variables are specified. | boolean
rebuild | If set true, all targets will be unconditionally rebuilt. | boolean
refid | 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". | Reference
stack | Sets stack size in bytes. | FlexInteger
unless | 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. | String

### parameters as nested elements

env
  Add an environment variable to the launched process.
fileset
  Adds a source file set. Files in these set will be processed by this configuration and will not participate in the auction.
libset
  Adds a system library set.
linkerarg
  Adds a linker command-line arg.
linkerparam
  Adds a compiler command-line arg.
syslibset
  Adds a system library set.