cxxlink$help.HLP
Command_Parameters
file-spec [,...]
The CXXLINK facility is layered on top of the OpenVMS Linker utility.
The CXXLINK command accepts the same parameters and qualifiers as the
OpenVMS Linker utility. Refer to the online help for the OpenVMS
Linker utility, HELP LINK, for more information.
Qualifiers
Refer to the online help for the OpenVMS Linker utility, HELP LINK, for
information. Additionally, the following qualifiers are accepted by the
CXXLINK command:
o /[NO]LOG_FILE [=filename]
o /PRELINK=(option[,option2])
o /REPOSITORY=(writeable-repository[,readonly-repository,...])
o /VERSION
Obsolete_Qualifiers
The following qualifers should no longer be used. Instead, use the
corresponding /PRELINK=option qualifier.
Additional Information on:
/EXPAND (D)
/TEMPLATE_PRELINK (D)
/LOG_FILE[=filename]
/NOLOG_FILE (D)
This qualifier is obsolete and may be removed in a future release
to support new OpenVMS Link Untilty qualifiers. Please use
/PRELINK=DEMANGLE instead.
/PRELINK=(option[,option2])
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
Tells CXXLINK not to use any CXX$LINK.OLB object libraries 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.
The qualifier is disabled by default and should be used only
if CXXLINK fails to link an application correctly.
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.
DEMANGLE_NAMES (D)
NODEMANGLE_NAMES
Controls whether CXXLINK displays unresolved C++ symbols in their
mangled or demangled form. By default, CXXLINK displays symbols in
their demangled form.
This qualifier has the same effect as specifying /EXPAND or /NOEXPAND.
Because in the future, the OpenVMS Linker Utility might require
that /EXPAND 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, in 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 instantions 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.
/REPOSITORY=(writeable-repository[,readonly-repository,...])
Name the repository directories. The first item in the list is
considered the writeable repository, and the remaining items (if any)
are considered repositories that are read only.
If you do not specify the /REPOSITORY qualifier, CXXLINK uses the
default respository, SYS$DISK:[.CXX_REPOSITORY].
/VERSION
Direct CXXLINK to display its version identification and then exit.
Customer_feedback
You can send comments or suggestions regarding this help file, or any
C++ documentation, by electronic mail to the following Internet
address:
cxx_docs@bookie.enet.dec.com
|