RAD Studio (Common)
ContentsIndex
PreviousUpNext
Linker Linking

ProjectOptionsLinkerLinking 

Use this dialog box to set Linker Linking options.

Build Configuration option 
Description 
Build Configuration 
Displays the active build configuration. Use the drop-down menu to select another build configuration.  
Save As... 
Displays the Save As dialog box to save the current configuration's options to a file that can be loaded as a named option set.  
Load... 
Displays the Apply Option Set dialog box to apply the options in a named option set to the current configuration.  

 

Linking options 
Description 
Dynamic RTL 
Controls whether C RTL links statically or dynamically with runtime library (cc3280.dll). Default = false  
Full debug information (-v) 
Includes information in the output file needed to debug your application with the C++Builder integrated debugger or Turbo Debugger.
On the command line this option causes the linker to include debugging information in the executable file for all object modules that contain debugging information. You can use the -v+ and -v- options to selectively enable or disable debugging information on a module-by-module basis (but not on the same command line where you use -v). For example, the following command includes debugging information for modules mod2 and mod3, but not for mod1 and mod4:
ILINK32 mod1 —v+ mod2 mod3 -v- mod4
Default = false  
Keep output files (-Gk) 
Tells the linker to keep output files that would otherwise be deleted on errors. The linker has been changed to delete its output file (EXE/DLL) if there are errors in the link. The old behavior was to leave these files and not delete them. Default = false  
Maximum errors (-Enn) 
Sets the specified number of errors encountered (nn) before the link is aborted. Default = 0  
Generate package library (-Gl) 
Generates a static package library containing code from all the .OBJs in the package so that it can be linked to. Default = false  
Generate .drc file (-GD) 
ILink32 generates Delphi compatible .RC files (drc files). The drc file has the same name as the executable file and is emitted to the same directory as the executable file. Default = false  
Generate import library (-Gi) 
Generates import library (DLL and package projects only). Default = false  
Disable incremental link (-Gn) 
Suppresses the generation of linker state files, disabling incremental linking. If you use -Gn, subsequent links take just as long as the first one. Default = false  

 

Advanced options 
Description 
Do image checksum (-Gz) 
Calculates the checksum of the target and places the result in the target’s PE header. This is used for NT Kernel mode drivers and system DLLs. Default = false  
Fast TLS (-Gt) 
Allocate TLS (thread-local storage) from Windows instead of using the mechanism to share TLS. Default = false  
Replace resources (-Rr) 
Add and/or replace resources without stripping away the existing resources. Default = false  
Case sensitive link (-c) 
The linker differentiates between upper and lowercase characters in public and external symbols. Normally, this option should be set, since C and C++ are both case-sensitive languages. Default = true  
Verbose (-r) 
Sets the verbose option rlink32 and detailed information is emitted during the resource link. Default = false  
Clear state before linking (-C) 
Deletes the existing incremental linker state files and then recreates these files and continues with the link. This option allows you to refresh the state files. Default = false  
File alignment (-Af) 
Specifies page alignment for code and data within the executable file. The linker uses the file alignment value when it writes the various objects and sections (such as code and data) to the file. For example, if you use the default value of 0x200, the linker stores the section of the image on 512-byte boundaries within the executable file.
When using this option, you must specify a file alignment value that is a power of 2, with the smallest value being 16.
The old style of this option (/A:dd) is still supported for backward compatibility. With this option, the decimal number dd is multiplied by the power of 2 to calculate the file alignment value.
The command-line version of this option (/Afxxxx) accepts either decimal or hexadecimal numbers as the file alignment value. The value setting is 512 (0x200).
Default = 0x200  
Object alignment (-Ao) 
The linker uses the object alignment value to determine the virtual addresses of the various objects and sections (such as code and data) in your application. For example, if you specify an object alignment value of 8192, the linker aligns the virtual addresses of the sections in the image on 8192-byte (0x2000) boundaries.
When using this option, you must specify an object alignment value that is a power of 2, with the smallest value being 4096 (0x1000) , the default.
The command-line version of this option (/Ao) accepts either decimal or hexadecimal numbers as the object alignment value.
Default = 0x1000  
Delay load .DLLs (-d) 
Delayed loading of DLLs is useful for DLLs that are used very infrequently by an application, but might have high startup costs. DLLs that have been delay loaded are not loaded and initialized until an entry point in the DLL is actually called. There is accompanying RTL support for delayed load DLLs that the user can hook into to handle errors on loading and to supplant the delayed load system, if so desired.
Click [...] to display a dialog to manage of list of DLLs. Check the Merge box to act as if the immediate ancestor's DLLs are merged into this list, though this list is not actually changed.  
Additional options 
Enter any additional linker options.  

 

General option 
Description 
Default 
Saves the current settings as the default for each new project.  
Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!