PROF(5) PROF(5)
NAME
prof - profile within a function
SYNOPSIS
#define MARK
#include <prof.h>
void MARK (name)
DESCRIPTION
MARK will introduce a mark called name that will be treated
the same as a function entry point. Execution of the mark
will add to a counter for that mark, and program-counter
time spent will be accounted to the immediately preceding
mark or to the function if there are no preceding marks
within the active function.
Name may be any combination of numbers or underscores. Each
name in a single compilation must be unique, but may be the
same as any ordinary program symbol.
For marks to be effective, the symbol MARK must be defined
before the header file <prof.h> is included. This may be
defined by a preprocessor directive as in the synopsis, or
by a command line argument, i.e:
cc -p -DMARK foo.c
If MARK is not defined, the MARK(name) statements may be
left in the source files containing them and will be
ignored.
EXAMPLE
In this example, marks can be used to determine how much
time is spent in each loop. Unless this example is compiled
with MARK defined on the command line, the marks are
ignored.
#include <prof.h>
foo( )
Page 1 May 1989
PROF(5) PROF(5)
{
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).
Page 2 May 1989