z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

c89, cc, and c++
acceptable to have unresolved symbols, especially the program entry point
symbol (which is usually main). The -r option is normally used when you
wish to combine object files incrementally. You would specify some object
files during the initial link-edit that uses -r. Later, you would specify the
output of the initial link-edit, along with the remaining object files in a final
link-edit that is done without using -r. In such situations where you wish to
combine IPA compiled object files, there is an alternative which does not
involve the link editor. That alternative is to concatenate the object files into
one larger file. This larger file can later be used in a final link-edit, when the
remainder of the object files are also made available. (This concatenation
can easily be done using the cp or cat utilities.)
-s Specifies that the compilation phase is to produce a file.o file that does not
include symbolic information, and that the link-editing phase produce an
executable that is marked reentrant. This is the default behavior for
c89/cc/c++.
-U name
Undefines a C or C++ macro specified with name. This option affects only
macros defined by the -D option, including those automatically specified by
c89/cc/c++. For information about macros that c89/cc/c++ automatically
define, see Usage Note 5 on page 98. Also see Usage Note 13 on page
100.
Note: The xlc utility uses different semantics for handling the -U option.
See “xlc — Compiler invocation using a customizable configuration
file” on page 796 for more information.
-u function
Specifies the name of the function to be added to the list of symbols which
are not yet defined. This can be useful if the only input to c89/cc/c++ is
archive libraries. Non–C++ linkage symbols of up to 255 characters in
length may be specified. You can specify an S-name by preceding the
function name with double slash (//). (For more information about
S-names, see Usage Note 23 on page 103.) The function //ceemain is the
default for non-IPA Link-editing, and the function main is the default for IPA
Link-editing. However, if this -u option is used, or the DLL link editor option
is used, then the default function is not added to the list.
-V This verbose option produces and directs output to stdout as compiler,
assembler, IPA linker, prelinker, and link editor listings. If the -O, -2, or -3
options are specified and cause c89/cc/c++ to use the compiler INLINE
option, then the inline report is also produced with the compiler listing. Error
output continues to be directed to stderr. Because this option causes
c89/cc/c++ to change the options passed to the steps producing these
listings so that they produce more information, it may also result in
additional messages being directed to stderr. In the case of the compile
step, it may also result in the return code of the compiler changing from 0
to 4.
Note: This option has a different meaning when using the xlc utility. See
“xlc — Compiler invocation using a customizable configuration file”
on page 796 for more information.
-v This verbose option causes pseudo-JCL to be written to stdout before the
compiler, assembler, IPA linker, prelinker, and link editor programs are run.
76 z/OS V1R9.0 UNIX System Services Command Reference
Example: It also causes phaseid information to be emitted in stderr:
FSUM0000I Utility(c89) Level(UQ99999)