The IDE uses launch configurations to remember logging settings as well as running
programs.
To create a launch configuration specific to kernel event tracing:
-
In any perspective where you might have a Target Navigator view, right-click a
target, then select . You want to open the Log Configurations dialog.
The Log Configuration dialog takes you through the process of selecting:
- the location of the captured log file (both on the target temporarily
and on the host in your workspace)
- the duration of the event capture
- the size of the kernel buffers
- the number of qconn buffers
- the event-capture filters (to control which events are captured)
-
On the Main tab, specify the location where you want the
IDE to save the log file.
-
To share the resulting log file with others, in the Save Log
Configuration as area, select
Shared.
-
In the Target Selection area, select the target you
created earlier that's specific for system profiling.
-
Click Apply and then select the Trace
Settings tab.
-
In the Tracing duration area, choose one of the
following options for your trace:
- Period of time: The duration of the capture of
events as defined by a period of time (a specified time is reached).
This is the default.
- Iterations: The duration of the capture of events
as defined by the number of kernel event buffers (a specified amount of
data is captured).
-
If you selected Period of Time, specify the
Period length (a floating-point value in seconds)
that representing the length of time to capture kernel events on the target;
otherwise, for Iterations, specify the total number of
full kernel event buffers to log on the target.
-
In the Trace file area, select a
Mode type:
- Save on target then upload: In this mode, kernel
event buffers are first saved in a file on the target, then uploaded to
your workspace. This is the default. In the Filename on
target field specify the name and location of the file
used to save the kernel event buffers on the target.
- Stream: In this mode, no file is saved on the
target. Kernel event buffers are directly sent from
qconn to the IDE.
-
In the Trace statistics file area, select a
Mode type:
-
In the Buffers area, specify the following:
- Number of kernel buffers: Size of the static ring
of buffers allocated in the kernel. The default is 32.
- Number of qconn buffers: Maximum size of the
dynamic ring of buffers allocated in the qconn target
agent. The default is 128.
-
Click Apply and select the Event
Filters tab.
An event includes the category the event belongs to (the event class, which
includes these event types: kernel call, interrupt servicing, process and
thread management, and user-generated events), and event-specific data.
These events can be either fast or wide, and each provides a different
amount of information for the log:
-
In the Mode field, select a type of mode to use based on
the following:
Event type |
Amount of information |
Work for kernel |
Size of log file |
Fast |
Smaller |
Smaller |
Smaller |
Wide |
Larger |
Larger |
Larger |
Class-specific |
Smaller |
Smaller |
Smaller |
Disable |
None |
None |
None |
-
If you selected Event-specific, follow the instructions
in Capture instrumentation data in an event log file to configure the type of events you want to include in your log
file.
-
If you want to set address translation information within the Kernel Event
Trace Log launch configuration, follow the instructions in Address Translation.
-
Click Log to begin the logging process.
Now that the IDE captured the event trace data, you are ready to view and interpret this captured information.
-
Click Open to begin viewisng the logged results in the QNX IDE System Profiler.