GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
CFLOW(1) FreeBSD General Commands Manual CFLOW(1)

cflow
build call graphs from C, Lex, Yacc and Assembler files

cflow [-aAcCGgnpPr] [-d num] [-D name[=value]] [-f filelist] [-i incl] [-I directory] [-U name] [-R root] [file ...]

The cflow utility reads C, Lex, Yacc or Assembler source code files and prints call graphs from their contents.

The following options are supported:
Use the GNU as(1) syntax parser for assembler files. This flag only works for assembler source code files.
Exclude ANSI C keywords. All globals and functions defined by the ANSI C standard are ignored. This flag only works for C source code files.
Print all calls within a function, including subsequent invocations of the same function.
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. This flag only works for C source code files.
num
The depth at which the graph is cut off. The num argument must be a positive integer >=0.
name=[value]
Define name as if by a C-language #define directive. This option behaves exactly like the [-D] argument of the c99(1) utility. This flag only works for C source code files and implicitily sets the [-p] argument.
Exclude GCC specific keywords. All keywords defined and used by the GNU C compiler are ignored. This flag only works for C source code files.
Produce a dot(1) graph for graphviz output.
incl
Increase the number of included symbols. The incl argument can be one of the following characters:
Include external and static data symbols.
Include names that begin with an underscore.
directory
Change the algorithm for searching for headers whose names are not absolute pathnames to look in the directory named by the directory pathname before looking in the usual places. This option behaves exactly like the [-I] argument of the c99(1) utility. This flag only works for C source code files and implicitily sets the [-p] argument.
Use the nasm(1) syntax parser for assembler files. This flag only works for assembler source code files and will be the default, if neither [-a] nor [-n] are set.
Use the C preprocessor on the file before building the flowgraph. By default "cc -E" will be used for preprocessing, if the environment variable CPP is unset. This flag only works for C source code files.
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. This flag only works for C source code files.
Print the flowgraph in reversed order, producing an inverted listing showing the callers of each function.
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.
name
Remove any initial definition of name. This option behaves exactly like the [-U] argument of the c99(1) utility. This flag only works for C source code files and implicitily sets the [-p] argument.

TODO

The cflow utility exits 0 on success, and >0 if an error occurs.

cgraph(1), asmgraph(1)

The cflow utility will examine the CPP environment variable and use its contents to invoke the preprocessor, if the [-p] argument is used.

The cflow utility is compliant with the IEEE Std 1003.1-2001 (“POSIX.1”) specification.

The flags [-aAcCfGgnPpR] are extensions to the specification.

TODO

Marcus von Appen ⟨marcus@sysfault.org⟩
October 1, 2009 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.