prof(5) [ultrix man page]

prof(5) 							File Formats Manual							   prof(5)

Name
       prof - profile within a function

Syntax
       #define MARK
       #include <prof.h>

       void MARK (name)

Description
       The  symbol  produces  a mark called name that is treated the same as a function entry point.  Execution of the mark increments the counter
       for that mark, and the program-counter time spent is accounted to the preceding mark or to the function if a preceding mark is  not  within
       the active function.

       The  name argument can be any combination of numbers or underscores.  Each name in a single compilation must be unique, but can be the same
       as any ordinary program symbol.

       For marks to be effective, the symbol must be defined before the header file is included.  This may be defined by a preprocessor  directive
       as in the synopsis, or by a command line argument.  For example:
       cc -p -DMARK foo.c
       If is not defined, the statements may remain in the source files, but they will be ignored.

Examples
       In  the following example, marks are used to determine how much time is spent in each loop.  Unless the example is compiled with defined on
       the command line, the marks are ignored:
       #include <prof.h>
       foo( )
       {
	    int i, j;
	    .
	    .
	    .
	    MARK(loop1);
	    for (i = 0; i < 2000; i++) {
		 . . .
	    }
	    MARK(loop2);
	    for (j = 0; j < 2000; j++) {
		 . . .
	    }
       }

See Also
       prof(1), profil(2), monitor(3c)

								       RISC								   prof(5)

PROF(1) 						      General Commands Manual							   PROF(1)

NAME

       prof, kprof - display profiling data

SYNOPSIS

       prof [ -dr ] [ program ] [ profile ]

       kprof kernel kpdata

DESCRIPTION

       Prof  interprets  files	produced  automatically  by programs loaded using the -p option of 2l(1) or other loader.  The symbol table in the
       named program file by default) is read and correlated with the profile file by default).  For each symbol, the percentage of time (in  sec-
       onds)  spent executing between that symbol and the next is printed (in decreasing order), together with the time spent there and the number
       of times that routine was called.

       Under option -d, prof prints the dynamic call graph of the target program, annotating the calls with the time spent  in	each  routine  and
       those it calls, recursively.  The output is indented two spaces for each call, and is formatted as
	    symbol:time/ncall
       where  symbol is the entry point of the call, time is in milliseconds, and ncall is the number of times that entry point was called at that
       point in the call graph.  If ncall is one, the /ncall is elided.  Normally recursive calls are compressed to keep the output brief;  option
       -r prints the full call graph.

       The  size  of  the buffer in program used to hold the profiling data, by default 2000 entries, may be controlled by setting the environment
       variable profsize before running program.  If the buffer fills, subsequent function calls may not be recorded.

       Kprof is similar to prof, but presents the data accumulated by the kernel profiling device, kprof(3).  The symbol table file, that  of  the
       operating system kernel, and the data file, typically /dev/kpdata, must be provided.  Kprof has no options and cannot present dynamic data.

SOURCE

       /sys/src/cmd/prof.c
       /sys/src/cmd/kprof.c

SEE ALSO

       2l(1), kprof(3)

																	   PROF(1)