Prelinking C and C++ Programs

Option Summary

The cool options are summarized in cool Options. A more detailed description of each option is provided in the section Option Descriptions.

The first column lists the option's compiler driver form. This is the form of the option that you will probably use most often. The second column indicates whether the option can be negated. An exclamation point (!) means that the option can be negated. A plus sign (+) means that the option cannot be negated. Both compiler driver options and cool options can be negated. To negate a compiler driver option, precede the option name with no . For example, to negate the -Acontinue option, specify -Anocontinue . To negate a cool option, precede the option name with ! instead of - , for example !p . The third column lists the default for each option that can be negated. The fourth column lists the standalone cool option. This is the form of the option that you must specify when calling cool directly.

Note: Some options have no compiler driver form; they can be used only when calling cool directly. [cautionend]

cool Options
sascc370 Option Negation Default cool Option Description

-Aallowrecool
! -Anoallowrecool
-rc
Specifies that the output object deck can be reprocessed by cool .

-Acidxref
! -Anocidxref
-xxx
Generates an extended name CID cross-reference.

-Aclet (or -Acletall)
! -Anoclet
-m
Suppresses the generation of a non-zero return code for all unresolved references, including those for extended names, and allows an output object module to be stored.

-Acletnoex
! -Anoclet
-mn
Suppresses the generation of a non-zero return code for unresolved references to non-extended names, and allows an output object module to be stored. Unresolved references to extended names result in an error return code from cool.

-Acontinue
! -Anocontinue
-zc
Continues processing even if a corrupted ar370 archive is detected.

-Adglib= pn

-db
Specifies a debugger file qualifier that provides for customization of the destination of the debugger file.

-Adupsname
! -Anodupsname
-zd
Allows multiple input files to define the same SNAME.

-Aendisplaylimit=nnn
+
-ynnnn Defines the maximum number of characters used to display extended names in messages and listings.

-Aenexit= prog,data
+
-xt prog, data
Invokes a user exit program with optional data.

-Agather= prefix
+
-g prefix Specifies a 1- to 6-character GATHER prefix.

-Agmap
! -Anogmap
-yg
Includes "gathered" symbols in the listing file.

-Aignorerecool
! -Anoignorerecool
-ri
Specifies that cool should ignore marks indicating it has already processed an input object deck.

-Ainsert= symbol
+
-i symbol Specifies an external symbol that is to be resolved by the cool autocall mechanism.

-Alinkidxref
! -Anolinkidxref
-xxe
Generates an extended name LINKID cross-reference.

-Alist
! -Anolist
-yl
Echo input control statements to the listing file.

-Anoextname
! -Aextname
-n
Specifies that cool will not process extended names.

-Anoinceof
! -Ainceof
-zi
Processes data after an INCLUDE statement in an input file.

-Anolineno
! -Alineno
-d
Deletes all the line-number and offset table CSECTs.

-Anortconst
! -Artconst
-r
Suppresses the copying of run-time constants CSECTs to the output object file.

-Anowarn
! -Awarn
-w
Suppresses warning messages.

-Anoxfnmkeep
! -Axfnmkeep
-f
Deletes extended function name CSECTs.

-Apagesize= nn +
-s nn Defines the number of lines to print per page in the listing file.

-Aprem
! -Anoprem
-p
Removes pseudoregisters from the output object file.

-Areferences
! -Anoreferences
-xxy
Specifies that referenced symbols and defined symbols are included in the cross-reference listing.

-Aprmap
! -Anoprmap
-yp
Includes a pseudoregister map in the listing.

-Asmponly
! -Anosmponly
-vo
Creates only an @EXTVEC# CSECT.

-Asmpxivec
! -Anosmpxivec
-v
Creates an @EXTVEC# CSECT.

-Asnamexref
! -Anosnamexref
-xxs
Generates an extended name SNAME cross-reference.

-Averbose
! -Anoverbose
-zv
Prints additional informational messages.

-Axsymkeep
! -Anoxsymkeep
-e
Retains extended external identifier CSECTs.

-h [name] Produces a listing and, optionally, directs the listing to the specified file.

-l name

-l name Identifies an ar370 archive, lib name. a , containing files that may be included by cool to resolve external references.

-L directory

-L directory Specifies a directory that is searched for lib name. a files.

-o filename
Specifies an output file.

*cool* Options
sascc370 Option	Negation	Default	cool Option	Description
`-Aallowrecool`	!	`-Anoallowrecool`	`-rc`	Specifies that the output object deck can be reprocessed by `cool` .
`-Acidxref`	!	`-Anocidxref`	`-xxx`	Generates an extended name `CID` cross-reference.
`-Aclet (or -Acletall)`	!	`-Anoclet`	`-m`	Suppresses the generation of a non-zero return code for all unresolved references, including those for extended names, and allows an output object module to be stored.
`-Acletnoex`	!	`-Anoclet`	`-mn`	Suppresses the generation of a non-zero return code for unresolved references to non-extended names, and allows an output object module to be stored. Unresolved references to extended names result in an error return code from cool.
`-Acontinue`	!	`-Anocontinue`	`-zc`	Continues processing even if a corrupted `ar370` archive is detected.
`-Adglib=` pn			`-db`	Specifies a debugger file qualifier that provides for customization of the destination of the debugger file.
`-Adupsname`	!	`-Anodupsname`	`-zd`	Allows multiple input files to define the same SNAME.
`-Aendisplaylimit=`nnn	+		-ynnnn	Defines the maximum number of characters used to display extended names in messages and listings.
`-Aenexit=` prog,data	+		`-xt` prog, data	Invokes a user exit program with optional data.
`-Agather=` prefix	+		`-g` prefix	Specifies a 1- to 6-character `GATHER` prefix.
`-Agmap`	!	`-Anogmap`	`-yg`	Includes "gathered" symbols in the listing file.
`-Aignorerecool`	!	`-Anoignorerecool`	`-ri`	Specifies that `cool` should ignore marks indicating it has already processed an input object deck.
`-Ainsert=` symbol	+		`-i` symbol	Specifies an external symbol that is to be resolved by the `cool` autocall mechanism.
`-Alinkidxref`	!	`-Anolinkidxref`	`-xxe`	Generates an extended name `LINKID` cross-reference.
`-Alist`	!	`-Anolist`	`-yl`	Echo input control statements to the listing file.
`-Anoextname`	!	`-Aextname`	`-n`	Specifies that `cool` will not process extended names.
`-Anoinceof`	!	`-Ainceof`	`-zi`	Processes data after an INCLUDE statement in an input file.
`-Anolineno`	!	`-Alineno`	`-d`	Deletes all the line-number and offset table CSECTs.
`-Anortconst`	!	`-Artconst`	`-r`	Suppresses the copying of run-time constants CSECTs to the output object file.
`-Anowarn`	!	`-Awarn`	`-w`	Suppresses warning messages.
`-Anoxfnmkeep`	!	`-Axfnmkeep`	`-f`	Deletes extended function name CSECTs.
`-Apagesize=` nn	+		`-s` nn	Defines the number of lines to print per page in the listing file.
`-Aprem`	!	`-Anoprem`	`-p`	Removes pseudoregisters from the output object file.
`-Areferences`	!	`-Anoreferences`	`-xxy`	Specifies that referenced symbols and defined symbols are included in the cross-reference listing.
`-Aprmap`	!	`-Anoprmap`	`-yp`	Includes a pseudoregister map in the listing.
`-Asmponly`	!	`-Anosmponly`	`-vo`	Creates only an @EXTVEC# CSECT.
`-Asmpxivec`	!	`-Anosmpxivec`	`-v`	Creates an @EXTVEC# CSECT.
`-Asnamexref`	!	`-Anosnamexref`	`-xxs`	Generates an extended name SNAME cross-reference.
`-Averbose`	!	`-Anoverbose`	`-zv`	Prints additional informational messages.
`-Axsymkeep`	!	`-Anoxsymkeep`	`-e`	Retains extended external identifier CSECTs.
			`-h` [name]	Produces a listing and, optionally, directs the listing to the specified file.
`-l` name			`-l` name	Identifies an `ar370` archive, `lib` name. `a` , containing files that may be included by `cool` to resolve external references.
`-L` directory			`-L` directory	Specifies a directory that is searched for `lib` name. `a` files.
			`-o` filename	Specifies an output file.

Chapter Contents
Previous
Next
Top of Page