NAME

       mm_tic - Start an iteration of profiling
       mm_toc - Add a point of measure to an iteration

SYNOPSIS

       #include <mmprofile.h>

       void mm_tic();
       void mm_toc();
       void mm_toc_label(const char* label);

       Link with -lmmlib

DESCRIPTION

       mm_tic()  starts  an  iteration  of profiling. It updates the timing statistics with the previous data if
       applicable and reset the metadata for a new timing iteration. Finally it measures the  timestamp  of  the
       iteration start.

       mm_toc()  Add  simply a new point of measure to the current iteration of profiling. If the maximum number
       of point of measure per iteration has been reached, then the new point will silently be ignored.

       mm_toc_label() is the same as mm_toc() excepting it provides a way to label the  meansure  point.  Beware
       than  only  the  first  occurrence  of  a  label  associated  with  a measure point will be retained. Any
       subsequent call to mm_toc_label() at the same measure point will be the same as calling mm_toc().

       Care must be taken if a precision of few microseconds or less is desired with mm_toc_label().  The  label
       copy  has  indeed overhead.  However this overhead has influence only on the iteration that will actually
       copy the label string, thus will affect only the current and max timing measures. The  influence  on  the
       mean  will  be  negligible  if  the  number  of  iterations  is  large  enough. Therefore results must be
       interpreted in the light of this short coming.

       The way the time is measured depends on the type of timer set by the mm_profile_reset(3) function.

RETURN VALUE

       None.

SEE ALSO

       mm_profile_reset(3), mm_profile_print(3)

                                                      2014                                              MMTIC(3)