Usage: java -jar funcscan.jar $BUILD [nm.lst]

Analyze object (*.o) and related source files (*.c) wrt. global function and
variable definitions. May help to create proper include files and mapfiles,
changing the visibility of symbols or aid versioning.


  $BUILD .. directory, which contains the source (*.c) and object files (*.o).
            E.g. /tmp/pvm3
  nm.lst .. list of preprocessed object files. If omitted and 
            required, it gets produced on the fly.

Other Options:
  -Dhelp       .. print this help and exit
  -Dawk        .. just print out the awk file used to process the object
                  files and exit.
  -Dnm         .. Show how to produce the list of symbols per object file
                  (nm.lst) and exit.
  -Drm=regex   .. Regular expression or String to remove from the module
                  filename to construct its real source file name
  -Df2c[=file] .. find all global functions, list the source file, where
                  they are defined and all source files, where they get
                  called. If file is given, print the results to the given
                  file (gets overwritten), otherwise print to stdout.
  -Dv2c[=file] .. Same as -Df2c, but for variables (data object symbols).
  -Dinc=flags  .. The CPP flags to be use, when source file need to be 
                  processed (see -Dfd and Dvd). Include pathes must be 
                  specified either as absolute path or relative to $BUILD.
  -Dfd[=file]  .. Print the function definitions for each modul. If file is
                  given, they are printed to the given file. Otherwise if 
                  -Df2c is used, it gets combined with the caller output.
                  Otherwise they will be printed to stdout.
  -Dvd[=file]  .. Same as -Dfd but for variables and -Dv2c.
  -Dsun[=bool] .. Enable/disable optimizations wrt. source scanning of the 
                  'cc -E' output and assumes cc == Sun Studio C Compiler.
                  bool might be 'true' or 'false'. If =bool is not given,
                  'true' is assumed. Per default 'true' on Solaris, otherwise
                  set 'false'. 'false' has negative effects wrt. memory
                  consumption and performance when scanning source files,
                  however, it may find some more variable/function definitions.
  -Dversion    .. Show version information and exit.
  -Djvm        .. Show JVM information and exit.