prof(1) [v7 man page]

PROF(1) 						      General Commands Manual							   PROF(1)

NAME

       prof - display profile data

SYNOPSIS

       prof [ -v ] [ -a ] [ -l ] [ -low [ -high ] ] [ file ]

DESCRIPTION

       Prof interprets the file mon.out produced by the monitor subroutine.  Under default modes, the symbol table in the named object file (a.out
       default) is read and correlated with the mon.out profile file.  For each external symbol, the percentage of time  spent	executing  between
       that symbol and the next is printed (in decreasing order), together with the number of times that routine was called and the number of mil-
       liseconds per call.

       If the -a option is used, all symbols are reported rather than just external symbols.  If the -l option is used, the output  is	listed	by
       symbol value rather than decreasing percentage.

       If the -v option is used, all printing is suppressed and a graphic version of the profile is produced on the standard output for display by
       the plot(1) filters.  The numbers low and high, by default 0 and 100, cause a selected percentage of the profile to be plotted with accord-
       ingly higher resolution.

       In  order for the number of calls to a routine to be tallied, the -p option of cc must have been given when the file containing the routine
       was compiled.  This option also arranges for the mon.out file to be produced automatically.

FILES

       mon.out	for profile
       a.out	for namelist

SEE ALSO

       monitor(3), profil(2), cc(1), plot(1)

BUGS

       Beware of quantization errors.

																	   PROF(1)

prof(1) 						      General Commands Manual							   prof(1)

NAME

       prof - display profile data

SYNOPSIS

       mdata] [prog]

DESCRIPTION

       interprets  a profile file produced by (see monitor(3C)).  The symbol table in the object file prog by default) is read and correlated with
       a profile file by default).  For each external text symbol, the percentage of time spent executing between the address of that  symbol  and
       the  address  of the next is printed, together with the number of times that function was called and the average number of milliseconds per
       call.

       The mutually exclusive options and determine the type of sorting of the output lines:

	      Sort by decreasing percentage of total time (default).

	      Sort by decreasing number of calls.

	      Sort by increasing symbol address.

	      Sort by symbol name in ascending collation order
			  (see Environment Variables below).

       The mutually exclusive options and specify the printing of the address of each symbol monitored:

	      Print each symbol address (in octal) along with the symbol name.

	      Print each symbol address (in hexadecimal) along with the symbol name.

       The following options can be used in any combination:

	      Include non-global symbols (static functions).

	      Include all symbols in the profile range (see
			  monitor(3C)), even if associated with zero number of calls and zero time.

	      Suppress the heading normally printed on the report.
			  (This is useful if the report is to be processed further.)

	      Print a summary of several of the monitoring parameters and statistics
			  on the standard error output.

	      Use file	  mdata instead of as the input profile file.

       A program creates a profile file if it has been loaded using the option (see cc_bundled(1)).  This option to the command arranges for calls
       to  at  the  beginning and end of execution (see monitor(3C)).  It is the call to the command at the end of execution that causes a profile
       file to be written.  The number of calls to a function is tallied if the option was used when the file containing  the  function  was  com-
       piled.

       The  name  of  the file created by a profiled program is controlled by the environment variable If is not set, is produced in the directory
       current when the program terminates.  If is produced, where progname consists of argv[0] with any path prefix removed, and pid is the  pro-
       gram's process ID.  If is set to a null string, no profiling output is produced.

EXTERNAL INFLUENCES

   Environment Variables
       determines the collating order output by the option.

       If  is not specified in the environment or is set to the empty string, the value of is used as a default.  If is not specified or is set to
       the empty string, a default of ``C'' (see lang(5)) is used instead of If any internationalization variable  contains  an  invalid  setting,
       behaves as if all internationalization variables are set to ``C'' (see environ(5)).

WARNINGS

       The  times  reported  in successive identical runs may show variances of 20% or more, because of varying cache-hit ratios due to sharing of
       the cache with other processes.	Even if a program seems to be the only one using the machine, hidden background or asynchronous  processes
       may  blur  the  data.   In  rare  cases,  the clock ticks initiating recording of the program counter may ``beat'' with loops in a program,
       grossly distorting measurements.

       Call counts are always recorded precisely, however.

       Only programs that call (see exit(2)) or return from cause a profile file to be produced, unless a final call to is explicitly coded.

       The use of the option to invoke profiling imposes a limit of 600 functions that can have call counters established  during  program  execu-
       tion.   For  more  counters, call directly.  If this limit is exceeded, other data is overwritten and the file is corrupted.  The number of
       call counters used is reported automatically by the command whenever the number exceeds 5/6 of the maximum.

FILES

       for profile
       for namelist

SEE ALSO

       cc_bundled(1), exit(2), profil(2), crt0(3), end(3C), monitor(3C).

STANDARDS CONFORMANCE

																	   prof(1)