Lightfoot Link

Description

Runs the Lightfoot linker to link the files together into an application

Parameters

Attribute Description Required
outputfile
The name of the output file Yes
mapfile
The name of the mapfile
No
quiet
If set to yes, supress all messages
No
debug
If set to yes, include debug information
No
bspdir
The name of the BSP dir where all installed BSPs can be found
No
verbose
If set to yes, show verbose messages
No
csvfile
The name of the CSV map file
No
lstfile
The name of the file to create a listing for
No
cmdfile
The name of the linker command file
No
searchref
The reference for the search path
No

Parameters specified as nested elements

Define

A defined variable.

BSP

Used used to list the BSPs to reference.

Attribute Description Required
target
The name of a single BSP
Yes unless targets is set
version
The version of a single BSP
Yes if target is set
targets
A comma separated list of BSPs and version. The BSP and version are colon separated
No unless target is not set

Sources

The set of source object files

Libraries

Libraries to be included in the build.

Attribute Description Required
dir The directory to search libraries for
Yes
libs Comma separated list of libraries. Yes

Examples

    <lightfoot.link    outputfile="${lfafile}"
        mapfile="${mapfile}"
        quiet="yes"
        debug="${debug}"
        bspdir="${bspdir}">
        <bsp target="${bsp.target}" version="${bsp.version}" debug="${debug.bsp}"/>
        <bsp targets="${extra_bsps}" debug="${debug.bsp}"/>
        <sources>
            <filelist dir="${libdir}" files="${system.objects}"/>
            <fileset dir="${objdir}">
                <include name="**/*.lfo"/>
            </fileset>
        </sources>
        <libraries dir="${libdir}" libs="${java_libraries}"/>
        <libraries dir="${extra_librarypath}" libs="${extra_libraries}"/>
        <libraries dir="${libdir}" libs="${system.libraries}"/>
        <libraries dir="${libdir}" libs="${debugger.library}"/>
        <libraries dir="${libdir}" libs="${stubs.library}"/>
    </lightfoot.link>