eld Manual
Table Of Contents
- eld Manual
- Legal Notices
- Contents
- What’s New in This Manual
- Manual Information
- New and Changed Information
- About This Manual
- Notation Conventions
- 1 Introduction to eld
- 2 eld Input and Output
- 3 Binding of References
- Overview
- Presetting Loadfiles
- To Preset or Not to Preset, and Creation of the LIC
- Handling Unresolved References
- Using User Libraries
- Creating Import Libraries
- Ignoring Optional Libraries
- Merging Symbols Found in Input Linkfiles
- Accepting Multiply-Defined Symbols
- Using the -cross_dll_cleanup option
- Specifying Which Symbols to Export, and Creating the Export Digest
- Public Libraries and DLLs
- The Public Library Registry
- 4 Other eld Processing
- Adjusting Loadfiles: The -alf Option
- Additional rules about -alf
- The -set and -change Options
- eld Functionality for 64-Bit
- Checking the C++ Language Dialect
- Renaming Symbols
- Creating Linker-Defined Symbols
- Updating Or Stripping DWARF Symbol Table Information
- Modifying the Data Sections that Contain Stack Unwinding Information
- Creating the MCB
- Processing of Floating Point Versions and Data Models
- Specification of the Main Entry Point
- Specifying Runtime Search Path Information for DLLs
- Merging Source RTDUs
- 5 Summary of Linker Options
- 6 Output Listings and Error Handling
- A TNS/E Native Object Files
- Glossary
- Index

Output Listings and Error Handling
eld Manual—527255-009
6-97
Error Messages
Cause. You used the -local_libname option, which tells eld where to find a copy
of the user library for the program that you are building, but the file that you have told
eld to create is not a program.
Effect. Fatal error (eld immediately stops without creating an output file).
Recovery. If your intention is to create a program, specify that correctly. For example,
don’t specify the -dll, -shared, or -ul options, which mean that you are telling eld
to build a DLL, rather than a program. And don’t specify the -r option, which tells eld
that you are building another object file that can be used as input to eld, rather than a
program. Or, if you don’t intend to create a program, then don’t specify the -
local_libname option.
Cause. You are running eld on the PC and creating a program that has a user library.
The -set libname option tells the Guardian filename that the user library will have at
runtime, to be stored in the file. The -local_libname option tells eld where to find
a copy of the user library during the link. eld needs both pieces of information. You
have given the -local_libname option, but not the -set libname option. If you
run eld on NSK, and the name given for -local_libname is in the Guardian
namespace, then it’s okay to omit the -set libname option, and eld will assume
that the user library will be in the same location at runtime. However, on the PC, it is
an error to give -local_libname without -set libname.
Effect. Fatal error (eld immediately stops without creating an output file).
Recovery. If you are using a user library, then you must decide the Guardian filename
that the user library will have at runtime, and specify that with the -set libname
option.
Cause. You are creating a program that has a user library, and you have given eld
the filename for a copy of the user library, by specifying the -local_libname, -
libname, or -set libname option. A user library is a DLL. However, eld opened
the user library and found that it wasn’t a DLL but instead was an archive, such as is
created by the “ar” tool.
Effect. Fatal error (eld immediately stops without creating an output file).
Recovery. If you want to create a program that uses a user library
, you must create
the user library as a DLL by running eld and specifying an option such as -dll, -
shared, or -ul. Then you can give the name of that user library to eld when you
create the program.
1561 On the PC, if you specify the -local_libname option, you
must also specify the -set libname option, to tell the
Guardian name of the user library for runtime.
1562 File <filename>, specified as the user library, is an
archive.










