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

FreeBSD Manual Pages

  
 
  

home | help
cgprof(1)		    Linux Reference Manual		     cgprof(1)

NAME
       cgprof -	generate colored call graph for	profiled executables

SYNOPSIS
       cgprof [-h] [-T dev] [-g	gmon_data] [gprof_file]

DESCRIPTION
       cgprof generate a function calling graph	for a profiled executable. The
       executable must have been compiled and linked to	output	data  suitable
       for  gprof(1) (look at -pg option of gcc(1)). If	no -T option is	given,
       output is dot(1)	commands. All the results are printed on standard out-
       put. cgprof takes gprof_file as input, or standard input.

       The  result  is	a  directed acyclic graph (DAG), where nodes represent
       functions traversed during the program execution,  and  edges  function
       calls (arrow is from the	caller to the called).

       Node colors represent the cumulative execution time spent by a function
       and its children. Colors	range from intense red (100 %  time)  to  pale
       violet  (0  %),	like  a	rainbow. A node	is white filled	when it	has no
       time execution data available, which may	 be  the  case	for  profiling
       functions or not	instrumented functions.

       cgprof  helps  to  have a better	understanding of program structure and
       execution. It makes hot spots identification visual and intuitive,  and
       provides	a minimum code coverage	function.

OPTIONS
       -h     Display this help	text.

       -T dev This  option  sets  the output format to dev. Possible values of
	      dev are :

	      X	     X11 output, with direct previewing	using dotty(1).

	      ps     Postscript	output,	using dot(1)  processor.  The  drawing
		     will be sized to fill one landscape page.

EXAMPLE
       to  print  a report from	execution of test_hash,	run the	following com-
       mand:

	     $ cc -pg -o test_hash test_hash.c
	     $ test_hash < test_data
	     $ gprof test_hash | cgprof	-Tps | lpr

SEE ALSO
       gprof(1), dot(1), dotty(1), cc(1).

HISTORY
       cgprof is inspired by a gprof2dot, a similar tool  from	AT&T  Research
       Labs,  distributed part of graphviz (http://www.graphviz.org) which in-
       cludes also dot tools.

AUTHOR
       Marc Vertes <mvertes@free.fr>

cgprof-1.2		       December	16, 2004		     cgprof(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLE | SEE ALSO | HISTORY | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=cgprof&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help