From: John L. <mov...@us...> - 2003-02-01 21:47:51
|
Update of /cvsroot/oprofile/oprofile/doc In directory sc8-pr-cvs1:/tmp/cvs-serv5234/doc Modified Files: oprofile.1.in oprofile.xml Log Message: Format vma width right on 64 bit. Change --separate-samples to --separate=library in opcontrol. Users of CVS will need to rm -rf ~root/.oprofile/ to turn it back on when needed. Index: oprofile.1.in =================================================================== RCS file: /cvsroot/oprofile/oprofile/doc/oprofile.1.in,v retrieving revision 1.52 retrieving revision 1.53 diff -u -d -r1.52 -r1.53 --- oprofile.1.in 4 Jan 2003 01:48:13 -0000 1.52 +++ oprofile.1.in 1 Feb 2003 21:47:47 -0000 1.53 @@ -137,8 +137,10 @@ Only profile process tty group pgrp (only avilable for 2.4 version) .br .TP -.BI "--separate-samples" -Separate samples for each distinct application shared library. +.BI "--separate="[library] +Separate samples based on the given separator. Currently only +"library" is supported, which gives sample files for libraries +on a per-application basis. .br .TP .BI "--vmlinux=" file @@ -201,7 +203,7 @@ .br .TP .BI "--show-shared-libs -k" -Show the details for each shared lib which belongs to one application. This option is useful only if you have profiled with --separate-samples option and you specify on the oprofpp command line either --list-symbols or --list-all-symbols-details. +Show the details for each shared lib which belongs to one application. This option is useful only if you have profiled with --separate=library option and you specify on the oprofpp command line either --list-symbols or --list-all-symbols-details. .br .TP .BI "--reverse -r" @@ -303,7 +305,7 @@ .TP .br .BI "--show-shared-libs -k" -Show the details for each shared lib which belongs to one application. This option is usefull only if you have profiled with --separate-samples option +Show the details for each shared lib which belongs to one application. This option is usefull only if you have profiled with --separate=library option .TP .br .BI "--list-symbols -l" @@ -319,7 +321,7 @@ .br .TP .BI "--output-format " vsSpPnlLiIeEh ", -t " vsSpPnlLiIeEh -Specify the output format where a single format char is a field intended for: 'v' vma, 's' nr samples, 'S' nr cumulated samples, 'p' percent samples, 'P' cumulated percent samples, 'n' symbol name, 'l' source file name and line nr, 'L' ditto as 'l' but with basename of source file name, 'i' image name, 'I' ditto as 'i' but with base name of image name, 'e' application name, 'E' basename of application name 'e' and 'E' are useless unless you profile with --separate-samples, 'd' details for each samples for the selected symbols and 'h' for the header itself. This option is available only with --list-symbols +Specify the output format where a single format char is a field intended for: 'v' vma, 's' nr samples, 'S' nr cumulated samples, 'p' percent samples, 'P' cumulated percent samples, 'n' symbol name, 'l' source file name and line nr, 'L' ditto as 'l' but with basename of source file name, 'i' image name, 'I' ditto as 'i' but with base name of image name, 'e' application name, 'E' basename of application name 'e' and 'E' are useless unless you profile with --separate=library, 'd' details for each samples for the selected symbols and 'h' for the header itself. This option is available only with --list-symbols .br .TP .BI "--reverse -r" Index: oprofile.xml =================================================================== RCS file: /cvsroot/oprofile/oprofile/doc/oprofile.xml,v retrieving revision 1.44 retrieving revision 1.45 diff -u -d -r1.44 -r1.45 --- oprofile.xml 4 Jan 2003 01:48:13 -0000 1.44 +++ oprofile.xml 1 Feb 2003 21:47:47 -0000 1.45 @@ -528,9 +528,11 @@ </para></listitem> </varlistentry> <varlistentry> - <term><option>--separate-samples</option></term> + <term><option>--separate=</option>[library]</term> <listitem><para> - Separate samples for each distinct application shared library. + Separate samples using the separator given. Currently, only + <option>--separate=library</option> is supported, which provides + per-application sample files for dynamically linked libraries. </para></listitem> </varlistentry> <varlistentry> @@ -986,7 +988,7 @@ <term><option>-k</option></term> <listitem><para> Show the details for each shared lib which belongs to the given application. This option is useful only - if you have profiled with the <option>--separate-samples</option> option and you specify on the + if you have profiled with the <option>--separate=library</option> option and you specify on the oprofpp command line either <option>--list-symbols</option> or <option>--list-all-symbols-details</option>. </para></listitem> @@ -1192,7 +1194,7 @@ <title><command>op_merge</command>: merging samples files</title> <para> <command>op_merge</command> is used to merge samples wich belongs to the same binary image. Its main purpose -is to merge samples files created by profiling with --separate-samples. So you can create one samples +is to merge samples files created by profiling with the option <option>--separate</option>. So you can create one samples file containing all samples for a shared library : <command>op_merge</command><filename>/usr/lib/ld-2.1.2.so</filename> will create a samples file named <filename>}usr}lib}ld-2.1.2.so</filename> ready to use with <command>oprofpp</command> or other post-profiling tools. @@ -1248,7 +1250,7 @@ <term><option>-k</option></term> <listitem><para> Show the details for each shared lib which belongs to one application. This option is - useful only if you have profiled with the <option>--separate-samples</option> option. + useful only if you have profiled with the <option>--separate=library</option> option. </para></listitem> </varlistentry> <varlistentry> @@ -1318,7 +1320,8 @@ </tbody></tgroup> </informaltable> <para> - <option>e</option> and <option>E</option> are useless unless you profile with --separate-samples. + <option>e</option> and <option>E</option> are useless unless you profile with + <option>--separate=library</option>. </para> <para> These options can only be used in conjunction with <option>--list-symbols</option>. |