/docs/MyDocs

Compilation Requirements

  * Debuging flags: -g -gdwarf-2 -g3

  * Disable inlining: -fno-inline

 

Supported Events

    opcontrol --list-events

 

    CPU_CLK_UNHALTED                    - CPU load

    BR_MISSP_EXEC                       - Branch missprediction

    L2_LINES_IN                         - L2 Cache lines modifications

    ...

    

 

Initialization

    opcontrol --init

    opcontrol --start-daemon

    opcontrol --vmlinux=vmlinux (uncompressed and not stripped

        Normally coudl be found after compilation in

        /usr/src/linux/arch/x86/boot/compressed/vmlinux

 

    opcontrol --status                  - Daemon configuration

    

Shutdown

    opcontrol --shutdown

 

 Events:

    opcontrol --event=<event1_spec> --event=<event2_spec>

    - This should be executed before daemon started

    - The number of supported counters dependens on CPU (1-8)

    - Default event counter (depends on CPU): CPU_CLK_UNHALTED:100000:0:1:1

    - Multiple events are not working for me (core duo, just first is collected)

 

    event_spec: <name:sample_rate:mask:kernel_mode:user_mode>

        + name and mask are obtained using 'ophelp'

        + sample_rate - events are generated once at specified amount of cycles

        + if kernel_mode = 0, the events obtained in kernel mode are ignored

        + if user_mode = 0, the events obtained in user mode are ignored

 

    opcontrol  --separate=<mode>

        + none          - do not separate the profiles (default)

        + library       - generate per-application profiles for libraries

        + kernel        - generate per-application profiles for the kernel 

                        and kernel modules

        + all           - generate per-application profiles for libraries and 

                        per-application profiles for the kernel and kernel 

                        modules

 

    oprof_start         - Simple UI allowing selection of events from list

 

Running

    opcontrol --reset

    opcontrol --start

    run app

    opcontrol --stop

 

    opcontrol --dump    forces daemon to flush current data

    

Analyzing

 Dump all shared libraries and apps consumed cpu cycles

    opreport --threshold 4.0    

 

 Dump symbols used cpu cycles (apps should be compiled with -g to get this info)

    opreport --symbols --debug-info /path/to/library_or_app

 

 Get line infomation

    opreport --symbols --debug-info --details --include-symbols symbol /path/to/library_or_app

        

 Anotate library source

    opannotate --source /home/csa/opc/libds/libds.so

    opannotate --source --output-dir=<result_dir> /home/csa/opc/libds/libds.so

    opannotate --assembly /home/csa/opc/libds/libds.so

 

 Filtering certain events:

    opreport event:CPU_CLK_UNHALTED cpu:1 ... (see man opreport)

    opreport -l /usr/sbin/apach2 (full path is mandatory)

    

 

Counter Multiplexing

====================

 There is limited amount of counters which can monitor arbitrary events. AMD

have 4 and Intel have 2 (actually 5, but 3 is predefined and not used by

oprofile). To count more, the counter multiplexing is could be used by 

modules. This actually implemented for AMD (and probably old P4 of Intel).

However, the support for modern Intel CPU's is still missing.

 Development is going on in oprofile git branch by Robert Richter and he is

promising to include complete version 2.6.30 or 31.

 http://git.kernel.org/?p=linux/kernel/git/rric/oprofile.git;a=shortlog;h=multiplexing

    arch/x86/oprofile/nmi_int.c:op_nmi_init     appropriate CPU model

        op_model_ppro.c - is currently used for Core* processors

 Patch agains 2.6.28 is certainly not including support for Intel

 There is also was development to update oprofile apps to work with perfmon2

 module, already supporting multiplexing, but it's only for ia64 at the moment

    http://sourceforge.net/mailarchive/forum.php?thread_name=20090212222748.GA7205%40suse.de&forum_name=perfmon2-devel