Intel XENIX 286 Programmers Guide (86) - Tenox.tc

XENIX Programming cc: C Compiler
To create an assembly language listing, give the name of the desired source file. For
example, the command
cc -5 add.c
creates an assembly language listing file named add.s and the command
cc -L mult.c
creates a listing file named mult.L. Note that both the -S and -L options suppress
subsequent compilation of the source file; they imply the -c option. Thus, no program
file is creat ed and no linking is performed.
Another use of the -S option is to create an assembly language source file that may be
optimized by hand and later submitted to masm for translation. Although this method
can be useful, optimizing should be left to the compiler whenever possible.
The -S and -L options apply to source files only; the compiler cannot create an assembly
language listing file from an existing object file. Furthermore, the options in the
command line must appear before the names of the files for which the assem bly listings
are to be saved.
Profiling a Program
You can examine the flow of execution of a program by adding "profiling" code to the
program with the -p option. The profiling code automatically keeps a record of the
number of times program functions are called during execution of the program. This
record is written to the mon.out file and can be examined with the prof command.
For example, the command
cc -p main.c
adds profiling code to the program created from the source file main.c. The profiling
code automatically calls the monitor function, which creates the mon.out file at normal
termination of the program. The prof command is described in Appendix B,
"Programm ing Commands." The monitor function is described in "System Functions" in
the XENIX 286 C Library Guide.
The -p option must be given in any command line that links object files containing
profiling code. For example, if the command
cc -c -p f1.c f2.c
was used to create the object files fl.o and f2.o, then the command
cc -p f1.o f2.o
must be used to create an executable program from these files.
2-11