ld_pa.1 (2010 09)

l
ld_pa(1) PA-RISC Systems Only
ld_pa(1)
+gstsize size
Request a particular hash array size using the global symbol table hash mechanism.
The default value is 1103. The value can be overridden at runtime by setting the
_HP_DLDOPTS environment variable to the value -symtab_size prime number .
You can set the value using
chatr +gstsize size file .
+h internal_name
When building a shared library, record internal_name as the name of the library.
When the library is used to link another executable file (program or shared library),
this internal_name is recorded in the library list of the resulting output file instead
of the file system pathname of the input shared library.
That is, if
+h is not used, the shared library does not have an internal name and
when an executable is built with the shared library, the linker records the library
name that it looks at.
If internal_name is a fully-qualified pathname, it is recorded
as is
in the library
list of any executable file it is subsequently linked against. internal_name is a rela-
tive pathname or no directory component was specified, internal_name is
appended to the file system directory component of the input shared library in the
library list of any executable file it is subsequently linked against.
If more than one +h option is seen on the link line, the first one is used and a warn-
ing message is emitted.
+help Starts the help window utility HP-UX Linker and Libraries Online User Guide
which comes with some HP compilers. (You must be running the X window system
and your DISPLAY environment variable must be set to the name of your worksta-
tion or X terminal.) For more information, refer to the HP-UX Linker and Libraries
User’s Guide manual. See manuals (5) for ordering information.
+init function_name
Specify the initializer functions to be invoked in reverse order, the order the func-
tions appear right to left on the command line. Initializers are called in depth-first
order. For example, when a shared library is loaded, the initializers in all its
dependent libraries are called first.
Use this option while building a shared library, an incomplete executable, or fully
bound executable. Functions specified with this option should take no arguments
and return nothing (void functions). Terminators are invoked only if
main() calls
exit(). They are not called if main() calls return().
Do not use
+init with the -r option. (The linker ignores the +init option.)
You can specify more than one initializer function on the command line with multi-
ple option-symbol pairs, that is, each function you specify must be preceded by the
+init option.
For more details on the initializer function, use the
+help option or see the HP-UX
Linker and Libraries User’s Guide.
+[no]inputmmap
+inputmap enables the feature to use mmap for reading the contents of shared
libraries during linking. This is the default behavior. Linking is usually much fas-
ter when input shared libraries are mmapped, as compared to buffered reading
from disk.
+noinputmmap disables the mmap feature and tells the linker not to mmap text
segments of input shared libraries. The linker uses buffered disk i/o (fread)to
access information from the text segments of input shared libraries.
NOTE: Use
+noinputmmap only in cases where the link fails because of mmap
failures due to lack of memory, as it can significantly increase the link time due to
disk I/O.
+interp file Change the dld path to use the argument as the "interpreter" program instead of
the dld.sl.
+k Direct the linker to only create an executable if there were no errors encountered
during the link. If there were errors found (system errors or unresolved
8 Hewlett-Packard Company − 8 − HP-UX 11i Version 3: September 2010