Options Accepted by the Compilation System

These are linker control options accepted by the compilation system:

-i

Ignores LD_LIBRARY_PATH setting. When an LD_LIBRARY_PATH setting is in effect, this option is useful to influence the runtime library search, which interferes with the link editing being performed.

-s

Strips symbolic information from the output file. Any debugging information and associated relocation entries are removed. Except for relocatable files or shared objects, the symbol table and string table sections are also removed from the output object file.

-V

Output a message about the version of ild being used.

-B dynamic | static

Options governing library inclusion. Option -B dynamic is valid in dynamic mode only. These options can be specified any number of times on the command line as toggles: if the -B static option is given, no shared objects are accepted until -B dynamic is seen. See option -l x.

-g

The compilation systems invoke ild in place of ld when the -g option (output debugging information) is given, unless any of the following are true:

• The -G option (produce a shared library) is given

• The -xildoff option is present

• Any source files are named on the command line

  
  

  -d y | n

  When -dy (the default) is specified, ild uses dynamic linking; when -dn is specified, ild uses static linking. See option -B dynamic | static.

  
  

  -L path (space is optional)

  Adds path to the library search directories. ild searches for libraries first in any directories specified by the -L options, and then in the standard directories. This option is useful only if it precedes the -l options to which it applies on the command line. The environment variable LD_LIBRARY_PATH or LD_LIBRARY_PATH_64 (in 64-bit link mode) can be used to supplement the library search path (see Failed Cross Reference Format).

  
  

  -l x (space is optional)

  Searches a library libx.so or lib.a, the conventional names for shared object and archive libraries, respectively. In dynamic mode, unless the -Bstatic option is in effect, ild searches each directory specified in the library search path for a file libx.so or libx.a. The directory search stops at the first directory containing either ild chooses the file ending in .so if -l expands to two files whose names are of the form libx.so and libx.a. If no libx.so is found, then ild accepts libx.a. In static mode, or when the -B static option is in effect, ild selects only the file ending in .a. A library is searched when its name is encountered, so the placement of -l is significant.

  
  

  -o outfile

  Produces an output object file named outfile. The name of the default object file is a.out.

  
  

  -Q y | n

  Under -Qy, an ident string is added to the .comment section of the output file to identify the version of the link editor used to create the file. This results in multiple ld idents when there have been multiple linking steps, such as when using ld -r. This is identical with the default action of the cc command. Option -Qn suppresses version identification.

  
  

  path-R (space is optional)

  This option gives a colon-separated list of directories that specifies library search directories to the runtime linker. If present and not null, path is recorded in the output object file and passed to the runtime linker. Multiple instances of this option are concatenated and separated by a colon.

  
  

  -xildoff

  Incremental linker off. Force the use of bundled ld. This is the default if -g is not being used, or -G is being used. You can override this default with -xildon.

  
  

  -xildon

  Incremental linker. Force the use of ild in incremental mode. This is the default if -g is being used. You can override this default with -xildoff.

  
  

  -Y P,dirlist (space is optional)

  (cc only) Changes the default directories used for finding libraries. Option dirlist is a colon-separated path list.

  ---

  Note -

  The "-z name" form is used by ild for special options. The i_ prefix to the -z options identifies those options peculiar to ild.

  ---

  
  

  -z defs

  Forces a fatal error if any undefined symbols remain at the end of the link. This is the default when building an executable. It is also useful when building a shared object to assure that the object is self-contained, that is, that all its symbolic references are resolved internally.

  
  

  -z i_dryrun

  (ild only.) Prints the list of files that would be linked by ild and exits.

  
  

  -z i_full

  (ild only.) Does a complete relink in incremental mode.

  
  

  -z i_noincr

  (ild only.) Runs ild in nonincremental mode (not recommended for customer use -- used for testing only).

  
  

  -z i_quiet

  (ild only) Turns off all ild relink messages.

  
  

  -z i_verbose

  (ild only) Expands on default information on some ild relink messages.

  
  

  -z nodefs

  Allows undefined symbols. This is the default when building a shared object. When used with executables, the behavior of references to such "undefined symbols" is unspecified.

  
  

  -z allextract | defaultextract | weakextract

  Under -z allextract, all archive members are extracted from the archive. -z defaultextract provides a means of returning to the default following use of the former extract options. A weak reference to a symbol (-z weakextract) causes a file defining that symbol to be extracted from a static library.