xenial (1) mlprof.1.gz

Provided by: mlton-tools_20100608-5.1_amd64 bug

NAME

       mlprof - display profiling information for a MLton-compiled executable

SYNOPSIS

       mlprof [option ...] a.out [mlmon.out ...]

DESCRIPTION

       mlprof extracts information from an executable compiled by MLton with -profile alloc or -profile time and
       the resulting mlmon.out file produced by running the executable.

       The output of mlprof consists of an initial line indicating  the  total  amount  of  CPU  time  or  bytes
       allocated.   After  this,  source  functions are listed along with the percentage of this total that they
       used, in decreasing order.  If the program was compiled with -profile-stack true, mlprof will display the
       time  spent  or  bytes allocated while the function was on the stack and in GC in addition to the time or
       bytes that the function is directly responsible for.

       With multiple mlmon.out files, mlprof will sum the profiling information.

OPTIONS

       -call-graph file
              Write a call graph containing the table data to a dot file.  See the MLton User Guide for details.

       -graph-title string
              Set the call-graph title.

       -gray {false|true}
              Gray call-graph nodes according to stack %.  This only makes sense if the executable was  compiled
              -profile-stack true.

       -keep exp
              Only  show functions specified by exp.  For details on the allowed expressions, see the MLton User
              Guide.  Multiple -keep expressions are not allowed.

       -mlmon file
              Process the list of whitespace-separated mlmon.out files found in the specified file.

       -raw {false|true}
              Show the raw counts in addition to the percentages.

       -show-line {false|true}
              Show the file and line for each function.

       -split regexp
              Treat duplicates of functions whose name matches regexp as different functions.

       -thresh x
              An abbreviation for -keep '(thresh x)',  which  only  prints  information  about  functions  whose
              percentage is greater than or equal to x, where 0 <= x <= 100.0.

       -tolerant {false|true}
              Print a warning about broken mlmon.out files, but do not exit.

SEE ALSO

       mlton(1) and the MLton Guide.

                                                  June 8, 2010                                         mlprof(1)