pmcannotate: Add a '-m' mode option to control per-line annotations.

[jhb]

Summary

• "block" (the default mode) displays per-block percentages in front of each annotated line.

• "global" displays a global percentage in front of each line.

• "raw" displays the raw count of sample hits in front of each line.

Sponsored by: University of Cambridge, Google, Inc.

[mav]

I have no objections, but I am fine with the current format. Global percents from the whole kernel would be a pretty small number. Raw number may be pretty big for a hot part of a small program. But whatever...

[pauamma_gundo.com]

usr.sbin/pmcannotate/pmcannotate.8

90–100

What I think this means, after staring at it for a bit, is (using example numbers of 4 samples in a given line, 20 samples in the block - however defined - that line is in, and 80 samples altogether:

• raw would display: 4
• block would display; 20%
• global would display: 1.25%

Is that what you mean?

[pauamma_gundo.com]

usr.sbin/pmcannotate/pmcannotate.8

90–100

• global would display: 1.25%

5%, not 1.25%.

[jhb]

usr.sbin/pmcannotate/pmcannotate.8

90–100

Yes, that is what it means.

[pauamma_gundo.com]

usr.sbin/pmcannotate/pmcannotate.8

90–100

Thanks for confirming.

95–98

Suggestion for clarity.

[jhb]

man page suggestion.

[bcr]

OK from manpages.