opannotate

OPANNOTATE(1)							OPANNOTATE(1)



NAME
       opannotate - produce source or assembly annotated with profile data

SYNOPSIS
       opannotate [ options ] [profile specification]

DESCRIPTION
       opannotate  outputs annotated source and/or assembly from profile data
       of an OProfile session.


OPTIONS
       --assembly / -a
	      Output annotated assembly. If this is combined  with  --source,
	      then mixed source / assembly annotations are output.

       --demangle none|smart|normal
	      none:  no	 demangling.  normal: use default demangler (default)
	      smart: use pattern-matching to make C++ symbol demangling	 more
	      readable.

       --exclude-dependent / -x
	      Do  not include application-specific images for libraries, ker-
	      nel modules and the kernel. This option only makes sense if the
	      profile session used --separate.

       --exclude-file [files]
	      Exclude  all  files  in  the given comma-separated list of glob
	      patterns.

       --exclude-symbols / -e [symbols]
	      Exclude all the symbols in the given comma-separated list.

       --help / -? / --usage
	      Show help message.

       --image-path / -p [paths]
	      Comma-separated list of additional paths to  search  for	bina-
	      ries.   This  is	needed	to  find  modules  in kernels 2.6 and
	      upwards.

       --include-file [files]
	      Only include files in the given comma-separated  list  of	 glob
	      patterns.

       --include-symbols / -i [symbols]
	      Only include symbols in the given comma-separated list.

       --objdump-params [params]
	      Pass the given parameters as extra values when calling objdump.

       --output-dir / -o [dir]
	      Output directory. This makes opannotate  output  one  annotated
	      file for each source file.

       --search-dirs / -d [paths]
	      Comma-separated  list  of paths to search for source files. You
	      may need to use this option when the debug information  for  an
	      image contains relative paths.

       --base-dirs / -b [paths]
	      Comma-separated list of paths to strip from debug source files,
	      prior to looking for them in --search-dirs.

       --source / -s
	      Output annotated source. This requires debugging information to
	      be available for the binaries.

       --threshold / -t [percentage]
	      Only output data for symbols that have more than the given per-
	      centage of total samples.

       --verbose / -V [options]
	      Give verbose debugging output.

       --version / -v
	      Show version.


ENVIRONMENT
       No special environment variables are recognised by opannotate.


FILES
       /var/lib/oprofile/samples/
	      The location of the generated sample files.


VERSION
       This man page is current for oprofile-0.8.1.


SEE ALSO
       /usr/share/doc/oprofile/, oprofile(1)



4th Berkeley Distribution    Sat 17 November 2007		OPANNOTATE(1)