ld(1)

ld(1)

 

®le whose symbol table provides the basis for de®ning additional symbols. Only newly

 

linked material is entered into the text and data portions of a.out, but the new sym-

 

bol table re¯ects all symbols de®ned before and after the incremental load. Also, the

 

-Roption can be used in conjunction with -A, which allows the newly linked segment

 

to commence at the corresponding address. The default starting address is the old

 

value of _end. The -Aoption is incompatible with -rand -b. Also note that a

 

program that dynamically loads code with ld -Acannot use shared libraries. See

 

the +help option or the HP-UX Linker and Libraries User's Guide manual for a

 

description of this option.

-Cn

Set the maximum parameter-checking level to n. The default maximum is 3. See the

 

language manuals for the meanings of the parameter-checking level.

-Fl

Force load all member objects of an archive library. If you do not use -Fl, the linker

 

only loads the needed archive members. This option is useful for creating a shared

 

library from an archive library, or when you need to load archive member that de®ne

 

symbols needed by shared libraries.

-Fw

Don't emit unwind tables. Do not use this option if your compiler or tools require

 

unwind tables.

-Fz

Disable the linker feature that translates some calls to $$dyncall_external to

 

calls to $$dyncall.

-N

Generate an executable output ®le with ®le type EXEC_MAGIC. This option is incom-

 

patible with -nand -q. This option causes the data to be placed immediately follow-

 

ing the text, and makes the text writable. Files of this type cannot be shared.

-S

Generate an Initial Program Loader (IPL) auxiliary header for the output ®le, instead

 

of the default HP-UX auxiliary header.

-T

Save the load data and relocation information in temporary ®les instead of in memory

 

during linking. This option reduces the virtual memory requirements of the linker. If

 

the TMPDIR environment variable is set, the temporary ®les are created in the

 

speci®ed directory, rather than in /var/tmp.

+cdp oldpath:newpath

Replace the recorded path for a shared library in the a.out. In 32-bit mode, ld records the absolute path names of any shared libraries searched at link time in the a.out ®le. When the program begins execution, the dynamic loader attaches any shared libraries that were searched at link time. Although you can use the +b and/or +s linker options to direct the dynamic loader to directories to search for the shared libraries, the dynamic loader, as a last resort, searches for the shared libraries in its absolute, recorded path in the a.out. You can specify more than one shared library oldpath:newpath, but each must be preceded by the +cdp option.

+cg pathname Specify the use of pathname as the code generator for compiling ISOMs to SOMs. See the discussion of pro®le based optimization in the HP-UX Linker and Libraries Online User's Guide for more information.

+dpv

Display verbose messages regarding procedures which have been removed due to dead

 

procedure elimination. The symbol name, input object ®le, and the size (in bytes) of

 

the deleted procedure are displayed. The total size (in bytes) of the deleted pro-

 

cedures is also displayed.

+filter shared_library_path

Enables the shared library ®lter mechanism, which allows you divide a large library into a "®lter" and several "implementation" libraries for more ef®cient organization of shared libraries. shared_library_path speci®es the location of the ®lter library. See the HP-UX Linker and Libraries User's Guide for more information.

+gstbuckets size

Request a particular number of buckets per entry using the global symbol table hash mechanism. The default value is 3. The value can be overridden at runtime by setting the _HP_DLDOPTS environment variable to the value -symtab_bucketsnumber. You can set the value using chatr +gstbuckets size ®le.

+nosmartbind

Disable SmartBind when binding a shared library. With this option enabled, the

HP-UX Release 11i: December 2000

− 9 −

Section 1−431

l