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

FreeBSD Manual Pages

  
 
  

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

NAME
     cgraph -- build call graphs from C files

SYNOPSIS
     cgraph [-AcCGgPr] [-d num] [-i incl] [-R root] [file ...]

DESCRIPTION
     The  cgraph  utility  reads C source code files and prints call graphs from
     their contents.

OPTIONS
     The following options are supported:

     -A      Exclude ANSI C keywords. All globals and functions defined  by  the
	     ANSI C standard are ignored.

     -c      Print all calls within a function, including subsequent invocations
	     of the same function.

     -C      Exclude  C99 keywords. All globals and functions defined by the C99
	     standard are ignored. This does not include the  ANSI  C  standard,
	     but only new keywords of the C99 standard.

     -d num  The depth at which the graph is cut off. The num argument must be a
	     positive integer >=0.

     -G      Exclude GCC specific keywords. All keywords defined and used by the
	     GNU C compiler are ignored.

     -g      Produce a dot(1) graph for graphviz output.

     -i incl
	     Increase  the  number of included symbols. The incl argument can be
	     one of the following characters:

		   x   Include external and static data symbols.

		   _   Include names that begin with an underscore.

     -P      Exclude POSIX keywords. All globals and functions	defined  by  the
	     IEEE  Std	1003.1-2001  ("POSIX.1") specification are ignored. This
	     does not include the ANSI C or C99 standards, but keywords  of  the
	     IEEE Std 1003.1-2001 ("POSIX.1") specification.

     -r      Print  the flowgraph in reversed order, producing an inverted list-
	     ing showing the callers of each function.

     -R root
	     The function to use as root function. The default is "main". If set
	     to a name, that cannot be found in  the  file,  all  functions  are
	     printed.

EXAMPLES
     TODO

EXIT STATUS
     The cgraph utility exits 0 on success, and >0 if an error occurs.

SEE ALSO
     cflow(1), asmgraph(1)

BUGS
     The  cgraph  utility  does not process any macro substitution, preprocessor
     conditions like #ifdef or	#include  directives,  thus  some  calls  within
     macros and function declarations within header files are not processed cor-
     rectly.  Use the cflow(1) utility if you want to have a better control over
     the flowgraph.

AUTHORS
     Marcus von Appen <marcus@sysfault.org>

FreeBSD ports 15.quarterly	 October 2, 2009		       CGRAPH(1)

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

home | help