prof(5)                                                             prof(5)


   NAME
         prof - profile within a function

   SYNOPSIS
         #define MARK
         #include <prof.h>

         void MARK (name);

   DESCRIPTION
         MARK introduces a mark called name that is treated the same as a
         function entry point. Execution of the mark adds to a counter for
         that mark, and program-counter time spent is 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 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, either by a preprocessor directive as
         in the synopsis, or by a command line argument:

               cc -p -DMARK foo.c

         If MARK is not defined, the MARK(name) statements may be left in the
         source files containing them and are ignored.  prof -g must be used
         to get information on all labels.

   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++) {
                           . . .
                     }
                     MARK(loop2);
                     for (j = 0; j < 2000; j++) {
                           . . .
                     }
               }




   7/91                                                                 Page 1

   prof(5)                                                             prof(5)


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



















































   Page 2                                                                 7/91