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 up to six letters, 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( )
          {
               int i, j;

               .
               .
               .
               MARK(loop1);
               for (i = 0; i < 2000; i++) {
                    . . .



     Page 1                                        (last mod. 1/14/87)

     prof(5)                                                   prof(5)



               }
               MARK(loop2);
               for (j = 0; j < 2000; j++) {
                    . . .
               }
          }

     SEE ALSO
          prof(1), profil(2), monitor(3C).














































     Page 2                                        (last mod. 1/14/87)