pmcannotate man page on PC-BSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
PC-BSD logo
[printable version]

PMCANNOTATE(8)		  BSD System Manager's Manual		PMCANNOTATE(8)

NAME
     pmcannotate — sources printout with inlined profiling

SYNOPSIS
     pmcannotate [-a] [-h] [-k pathname] [-l level] pmcout.out binaryobj

DESCRIPTION
     The pmcannotate utility can produce both C sources or assembly sources of
     a program with a line-by-line based profiling.  The profiling informa‐
     tions are retrieved through a pmcstat(8) raw output while the program
     operations are retrieved through the objdump(1) tool.

     When calling pmcannotate the raw output is passed through the pmcout.out
     argument, while the program is passed through the binaryobj argument.

     As long as pmcannotate relies on objdump(1) and pmcstat(8) to work, it
     will fail if one of them is not available.

OPTIONS
     The following options are available:

     -a	     Shows the program profiling inlined in the assembly code only.
	     No C informations involving C sources are provided.

     -h	     Prints out informations about the usage of the tool.

     -l level
	     Changes the lower bound (expressed in percentage) for traced
	     functions that will be printed out in the report.	The default
	     value is 0.5%.

     -k kerneldir
	     Set the pathname of the kernel directory to argument kerneldir.
	     This directory specifies where pmcannotate should look for the
	     kernel and its modules.  The default is /boot/kernel.

LIMITATIONS
     As long as pmcannotate relies on the objdump(1) utility to retrieve the C
     code, the program needs to be compiled with debugging options.  Some‐
     times, in particular with heavy optimization levels, the objdump(1) util‐
     ity embeds the code of inlining functions directly in the callers, making
     an output difficult to read.  The x86 version reports the sampling from
     pmcstat collecting the following instruction in regard of the interrupted
     one.  This means that the samples may be attributed to the line below the
     one of interest.

SEE ALSO
     objdump(1), pmcstat(8)

AUTHORS
     Attilio Rao ⟨attilio@FreeBSD.org⟩

BSD			       November 20, 2008			   BSD
[top]

List of man pages available for PC-BSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net