VMS Help CXXLINK, /PRELINK=(option[,option2]) *Conan The Librarian |
Specifies one or more prelink options. If multiple options are specified, they must be enclosed in parentheses and separated by commas. You can specify the following options: USE_OBJECT_FILES (D) Tells CXXLINK not to use the CXX$LINK.OLB library found in a repository directory. Instead, CXXLINK looks for the specific object files and adds them to the linker options file. Use of this qualifier also prevents CXXLINK from creating and populating a CXX$LINK.OLB object library in the repository directory. USE_OLB Tells CXXLINK to use the CXX$LINK.OLB found in a repository directory. Specifying this option might improve link-time performance but in some cases could produce unresolved template symbols. TEMPLATE_PRELINK (D) NOTEMPLATE_PRELINK Controls whether CXXLINK bypasses the template instantiation process. By default, CXXLINK performs at least one partial link to determine whether there are any unresolved template symbols that need to be instantiated. If you know that your program does not use templates, then you can specify /PRELINK=NOTEMPLATE_PRELINK to bypass this partial link and proceed directly to the final link. This qualifier has the same effect as specifying /TEMPLATE_PRELINK or /NOTEMPLATE_PRELINK. Because in the future, the OpenVMS Linker Utility might require that /TEMPLATE_PRELINK be removed, it is recommended that users modify their use of CXXLINK to use this new form of the qualifier. ADD_INCLUDE_LIBRARIES (D) NOADD_INCLUDE_LIBRARIES Controls whether, if initial link fails, CXXLINK adds to the linker options file the names of any object libraries specified on the command line using the /INCLUDE= syntax. CXXLINK also checks for any /INCLUDE= library when SYS$INPUT:/OPT is used. CXXLINK does not parse any other linker options file for /INCLUDE= syntax. Because of the order of dependencies between template instantiations and object files, the OpenVMS Linker Utility sometimes fails to extract all the required modules from an object library that was specified using /INCLUDE=. To work around the problem CXXLINK provides that library as input to the linker in its linker options file without the /INCLUDE= syntax, thereby allowing the linker to scan that object library one more time for missing symbols. This qualifier should be used only if a CXXLINK user requires more control over which object files are included from a given object library.
|