pixie(1)						      General Commands Manual							  pixie(1)

Name
       pixie - add profiling code to a program

Syntax
       pixie in_prog_name [ options ]

Description
       The pixie command reads an executable program, partitions it into basic blocks, and writes an equivalent program containing additional code
       that counts the execution of each basic block. A basic block is a region of the program that can be  entered  only  at  the  beginning  and
       exited only at the end.	The pixie command also generates a file containing the address of each of the basic blocks.

       When  you run the pixie-generated program, it (provided it terminates normally or via a call to generates a file containing the basic block
       counts. The name of the file is that of the original program with any leading directory names removed and ".Counts" appended.  and can ana-
       lyze these files and produce a listing of profiling data.

Options
       -o out_prog_name    Specify  a  name  for  the translation.  The default is to remove any leading directory names from the in_prog_name and
			   append ".pixie".

       -bbaddrs name	   Specify a name for the file of basic block addresses.  Default is to  remove  any  leading  directory  names  from  the
			   in_prog_name and append ".Addrs".

       -[no]quiet	   Controls whether a summary is given of the binary-to-binary translation process. The default is -noquiet.

       -[no]dwops	   Controls translation of double-word load/store instructions so that binaries using these instructions can be run on old
			   processors.	The default is -nodwops (translate).

       -[no]textdata	   Controls whether pixie puts the original text into the translated output.  This is required to correctly translate pro-
			   grams  with	data  in  the text section (for example, f77 format statements in some compiler releases).  The default is
			   -textdata (include original text).

       -[no]idtrace	   Disables or enables tracing of instruction and data memory references.  -idtrace is equivalent to  using  both  -itrace
			   and -dtrace together.  The default is -noidtrace

       -[no]itrace	   Disable or enable tracing of instruction memory references.	The default is -noitrace

       -[no]dtrace	   Disable or enable tracing of data memory references.  Currently, -dtrace requires -itrace.  The default is -nodtrace

       -[no]oldtrace	   Disable or enable the old memory reference trace format.  The default is -oldtrace.

       -idtrace_sample number
			   Record only 1 out of every number memory reference chunks. (This feature not yet implemented.)

       -idtrace_file number
			   Specify a UNIX file descriptor number for the trace output file.  The default is 19.

Restrictions
       The handler function address to the signal system calls is not translated, therefore, programs that receive signals  cannot work pixified.

       Programs  that  call vfork cannot work pixified because the child process modifies the parent state required for pixie operation.  Use fork
       instead.

       Pixified code is substantially larger than the original code.  Conditional branches that used to fit  in  the  16-bit  branch  displacement
       field may no longer fit, generating a pixie error.

See Also
       prof(1), pixstats(1)

4th Berkeley Distribution					       RISC								  pixie(1)