Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
mlprof(1)		     General Commands Manual		       mlprof(1)

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 -pro-
     file  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	decreas-
     ing  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	informa-
	    tion 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.

				January 17, 2021		       mlprof(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mlprof&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help