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

FreeBSD Manual Pages

  
 
  

home | help
CGRAPH(1)		  BSD 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 invoca-
	     tions 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	stan-
	     dard, 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
	     listing 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
     correctly.	Use the	cflow(1) utility if you	want to	have a better control
     over the flowgraph.

AUTHORS
     Marcus von	Appen <marcus@sysfault.org>

BSD				October	2, 2009				   BSD

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | SEE ALSO | BUGS | AUTHORS

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

home | help