packages icon



 CFLOW(1)                           CFLOW                           CFLOW(1)
                              February 27, 2014



 NAME
      cflow - generate a C-language flowgraph

 SYNOPSIS
      cflow [-rxaSblnTv] [-d NUMBER] [-f NAME] [-i CLASSES] [-o FILE] [-D
      NAME[=DEFN]] [-I DIR] [-m NAME] [-p NUMBER] [-s SYMBOL:[=]TYPE] [-U
      NAME] [--depth=NUMBER] [--format=NAME] [--include=CLASSES]
      [--output=FILE] [--reverse] [--xref] [--ansi] [--define=NAME[=DEFN]]
      [--include-dir=DIR] [--main=NAME] [--pushdown=NUMBER]
      [--preprocess[=COMMAND]] [--cpp[=COMMAND]] [--symbol=SYMBOL:[=]TYPE]
      [--use-indentation] [--undefine=NAME] [--brief] [--emacs]
      [--print-level] [--level-indent=ELEMENT] [--number] [--omit-arguments]
      [--omit-symbol-names] [--tree] [--debug[=NUMBER]] [--verbose] FILE...

      cflow [-?V] [--help] [--usage] [--version]

 NOTE
      This manpage is a short description of GNU cflow.  For a detailed dis-
      cussion,  including  examples  and usage recommendations, refer to the
      GNU Cflow Manual available in texinfo format.  If the info reader  and
      the  cflow  documentation  are  properly installed on your system, the
      command

          info cflow

      should give you access to the complete manual.

      You can also view the manual using the info mode in emacs(1), or  find
      it in various formats online at

          http://www.gnu.org/software/cflow/manual

      If any discrepancies occur between this  manpage  and  the  GNU  Cflow
      Manual, the later shall be considered the authoritative source.

 DESCRIPTION
      Cflow analyzes a collection of input files written  in  C  programming
      language  and  writes to standard output a graph charting dependencies
      between various functions.

 OPTIONS
    General-purpose options
      -d, --depth=NUMBER
           Set the depth at which the flowgraph is cut off.  By default  the
           depth is not limited.

      --debug[=NUMBER]
           Set debugging level.

      -f, --format=NAME
           Use given output format NAME. Valid names are gnu  (the  default)



                                    - 1 -         Formatted:  March 28, 2024






 CFLOW(1)                           CFLOW                           CFLOW(1)
                              February 27, 2014



           and posix.

      -i, --include=CLASSES
           Include specified classes of symbols.  The ^or-  symbol  excludes
           the classes that follow it.  Valid classes are:

           _(underscore)
                Symbols whose names begin with an underscore.

           s    Static symbols

           t    Typedefs (for cross-references only).

           x    All data symbols, both external and static

      -o, --output=FILE
           Set output file name (default is -, meaning stdout).

      -r, --reverse
           Print reverse call tree.

      --no-reverse
           Disable the effect of the previous --reverse option.

      -x, --xref
           Produce cross-reference listing only.

      -v, --verbose
           Enable verbose error diagnostics.

    Parser control
      -a, --ansi
           Accept only sources in ANSI C.

      --no-ansi
           Don't assume input files are written in ANSI C.

      -D, --define=NAME[=DEFN]
           Predefine NAME as a macro.

      -I, --include-dir=DIR
           Add the directory DIR to the list of directories to  be  searched
           for header files.

      -m, --main=NAME
           Assume main function is NAME

      -p, --pushdown=NUMBER
           Set initial token stack size to NUMBER.





                                    - 2 -         Formatted:  March 28, 2024






 CFLOW(1)                           CFLOW                           CFLOW(1)
                              February 27, 2014



      --preprocess[=COMMAND], --cpp[=COMMAND]
           Run the specified preprocessor command.

      --no-preprocess, --no-cpp
           Disable preprocessing.

      -s, --symbol=SYMBOL:[=]TYPE
           Register SYMBOL with given TYPE, or define an  alias  (if  :=  is
           used). Valid types are: keyword(orkw), modifier, qualifier, iden-
           tifier, type, and wrapper.  Any unambiguous abbreviation  of  the
           above is also accepted.

      -S, --use-indentation
           Rely on indentation to solve suspicious constructs.

      --no-use-indentation
           Don't use indentation in parsing (default).

      -U, --undefine=NAME
           Cancel any previous definition of NAME.

    Output control
      -b, --brief
           Brief output.

      --no-brief
           Disable brief output.

      --emacs
           Format output for use with GNU Emacs.

      --no-emacs
           Disable the effect of the previous --emacs option.

      -l, --print-level
           Print nesting level along with the call tree.

      --no-print-level
           Don't print nesting level.

      --level-indent=ELEMENT
           Control graph appearance.

      -n, --number
           Print line numbers.

      --no-number
           Don't print line numbers.

      --omit-arguments
           Do not print argument lists in function declarations.



                                    - 3 -         Formatted:  March 28, 2024






 CFLOW(1)                           CFLOW                           CFLOW(1)
                              February 27, 2014



      --no-omit-arguments
           Print argument lists in function declarations (the default).

      --omit-symbol-names
           Do not print symbol names in declaration strings.

      --no-omit-symbol-names
           Print symbol names in declaration strings (the default).

      -T, --tree
           Draw ASCII art tree.

      --no-tree
           Disable tree output.

    Informational options
      These options instruct the program to output the  requested  piece  of
      information and exit.

      -?, --help
           Print a short help summary.

      --usage
           Print a summary of available options.

      -V, --version
           Print program version.

 RETURN VALUE
      0    Successful completion.

      1    Fatal error occurred.

      2    Some input files cannot be read or parsed.

      3    Command line usage error.

 SEE ALSO
      Online copies of GNU cflow documentation in  various  formats  can  be
      found at:

          http://www.gnu.org/software/cflow/manual

 AUTHORS
      Sergey Poznyakoff

 BUG REPORTS
      Report bugs to <bug-cflow@gnu.org>.

 COPYRIGHT
      Copyright c 2014 Sergey Poznyakoff



                                    - 4 -         Formatted:  March 28, 2024






 CFLOW(1)                           CFLOW                           CFLOW(1)
                              February 27, 2014



      License GPLv3+: GNU GPL version 3 or later
      <http://gnu.org/licenses/gpl.html>
      This is free software: you are free to  change  and  redistribute  it.
      There is NO WARRANTY, to the extent permitted by law.


















































                                    - 5 -         Formatted:  March 28, 2024