*** UNIX MANUAL PAGE BROWSER ***

pixstats(1) General Commands Manual pixstats(1) NAME pixstats - analyze program execution SYNOPSIS pixstats program [ options ] PARAMETERS Name of the program executable to be instrumented. This program should be compiled with the -g1, -g2, or -g3 flag to obtain more complete pro- filing information. If the default symbol table level (-g0) has been used, line number information, static procedure names, and file names are unavailable to the profiling code. FLAGS The pixstats command accepts the following options: Use file instead of program.Addrs as the pixie address file. Use file instead of pro- gram.Counts as the pixie counts file. Assume a ns cycle time when con- verting cycle counts to seconds. Assume MHz cycle frequency when con- verting counts to seconds. By default, pixstats uses the cycle time of the processor on which program was run. Disassemble and show the ana- lyzed object code. Limit the disassembly to blocks with f% frequency. Use 1 for each basic block count. DESCRIPTION The pixstats program analyzes a program's execution characteristics. To use pixstats, first use pixie(5) to translate and instrument the ex- ecutable object module for the program. Next, execute the translation on an appropriate input. This produces a .Counts file. Finally, use pixstats to generate a detailed report on opcode frequencies, a mini- profile, and more. RESTRICTIONS The pixstats program models execution assuming a perfect memory system. Memory system events such as cache misses will increase execution above the pixstats predictions. The pixstats program assumes that every instruction executes in one cy- cle, both when estimating the total runtime in seconds and when print- ing the flat profile. Pipeline interlocks are ignored. Use the prof -pixie -truecycles n command (specifying 0, 1, or 2 for n) to print a variety of profiles that do account for interlocks. RELATED INFORMATION prof(1), pixie(5) Programmer's Guide delim off pixstats(1)