.\" SCCSID: @(#)cflow.1	8.1	9/11/90.TH cflow 1.SH Namecflow \- generate C flow graph.SH Syntax.B cflow[\fB\-r\fR] [\fB\-ix\fR] [\fI\-i_\fR\|][\fB\-d\fInum\fR] \fIfiles\fR.SH Description.NXR "cflow command".NXS "C flow graph" "cflow command"The.PN cflowcommand analyzes a collection of.SM C\*S,.SM YACC\*S,.SM LEX\*S,assembler, and object filesand attempts to build a graph charting the external references.Files suffixed in.BR \&.y ,.BR \&.l ,.BR \&.c ,and.BR \&.iareYACC\*S'd,LEX\*S'd,and C-preprocessed(bypassed for.B .ifiles)as appropriateand then run through the first pass of.MS lint 1 .The.BR \-I \*S,.BR \-D \*S,and.BR \-Uoptions of the C-preprocessor are also understood.Files suffixed with.B \&.sare assembled and informationis extractedfrom the symbol table.The output of all this non-trivial processingis collected and turned into a graph of external referenceswhich is displayed upon the standard output..PPEach line of output begins with a reference, or line,number, followed by a suitable number of tabsindicating the level.Following the reference number is the name of the global,a colon,and the global's definition.  (See the.PN \i_ option for information on names that begin with an underscore.)For information extracted from C source,the definition consists of an abstract type declaration(for example,.BR "char \(**" ),and, the name of the source fileand the line numberwhere the definition was found.  The name of the sourcefile and the line number are delimited by angel brackets.Definitions extracted from object filesindicate the file name and locationcounter under which the symbol appeared(for example,.IR text ).Leading underscores in C-style external names are deleted..PPOnce a definition of a name has been printed,subsequent references to that name containonly the reference number of the linewhere the definition may be found.For undefined references, only.B <\|>is printed..PPThe following is an example in.IR file.c :.EXint	i;main(){	f();	g();	f();}f(){	i = h();}.EEThe command.EXcflow \-ix file.c.EEproduces the following output:.EX1	main: int(), <file.c 4>2		f: int(), <file.c 11>3			h: <>4			i: int, <file.c 1>5		g: <>.EE.PPWhen the nesting level becomes too deep, the.BR \-eoption of.MS pr 1can be used to compress the tab expansion to somethingless than every eight spaces..SH Options.NXR "cflow command" "options".TP 20.BI \-d numThe.I numdecimal integer indicates the depth at which the flow graphis cut off.By default this is a very large number.Attempts to setthe cutoff depth to a nonpositive integer will be met with contempt..TP.B \-i_Includes names that begin with an underscore. The default is to excludethese functions (and data if \fI-ix\fP is used)..TP.B \-ixIncludes external and static data symbols. The default is to includeonly functions in the flow graph..TP.B \-rReverse the ``caller:callee'' relationship producing an inverted listingshowing the callers of each function.The listing is also sorted inlexicographical order by callee..SH Restrictions .NXR "cflow command" "restricted"Files produced by.MS lex 1and.MS yacc 1cause the reordering of line number declarations which canconfuse.PN cflow .To get proper results, feed.PN cflowthe.PN yaccor.PN lexinput..SH DiagnosticsComplains about bad options.Complains about multiple definitionsand only believes the first.Other messages may come from the variousprograms used (for example, the C-preprocessor)..SH See Alsoas(1), cc(1), lex(1), lint(1), nm(1), pr(1), yacc(1)