cd18162498

KPTrace
KPTrace for STLinux
Data Brief
Description
Features
KPTrace is a Linux system tracing solution for
STLinux running on ST40 and ARM cores. It is a
truly innovative solution providing end-users with
a real competitive advantage for their
developments.
■
New tracepoints can be added on any symbol
without rebuilding or rebooting the system.
■
All tracepoints can be enabled and disabled at
run-time and, because only enabled
tracepoints are actually present in the system,
the system intrusion is minimized.
■
No additional hardware is required.
■
KPTrace can be driven from inside
STWorkbench. STWorkbench provides a
powerful interface for enabling, disabling and
creating tracepoints, generating traces and,
most importantly, representing traces in
graphical time charts.
KPTrace allows dynamic tracepoints to be added
to both the kernel and user applications, and
provides a simple interface to collect and view the
trace. Over 300 useful tracepoints are
pre-defined, including interrupts, context
switches, system calls and much more.
KPTrace can be driven from the command line, or
from a very intuitive and powerful graphical
interface inside STWorkbench.
KPTrace is available now in the STLinux 2.3
distribution.
October 2008
8162498 Rev A
For further information contact your local STMicroelectronics sales office.
1/4
www.st.com
1
Features (continued)
KPTrace
Features (continued)
■
An easy-to-use command line interface is also provided. This includes a script to display
traces in a human-readable format.
■
Highly accurate statistics are gathered showing how much time the system spends in
each process, thread, softirq or interrupt handler. The statistics also provide detailed
information on interrupt latency, ISR duration and more.
■
A “flight recorder” mode is available. This uses a single circular trace buffer which allows
KPTrace to run for long periods while still generating a trace file of a manageable size.
■
All events are timestamped to microsecond precision.
■
In the case of a catastrophic crash, the current trace buffer can be extracted over JTAG
using an ST Micro Connect.
■
Tracing can be paused and restarted at designated “stop” and “start” tracepoints, or
programatically using a kernel API.
■
A printf-style interface to the trace buffer is provided. This allows users to add
additional instrumentation in the context of the trace.
Distribution
KPTrace is available in STLinux, which is distributed through the STMicroelectronics
STLinux website (www.stlinux.com).
System requirements
The minimum host system requirements for STLinux are as follows:
Note:
2/4
●
1 GHz processor
●
512-Mbyte RAM
●
1024 x 768 high color screen
●
a supported Linux x86 distribution (see Supported hosts)
In order to run STWorkbench, the Sun Java Runtime Environment 5.0 or later is required.
No other JVMs are supported, and using earlier versions will prevent STWorkbench working
correctly.
8162498
KPTrace
Supported hosts
Supported hosts
The STLinux development environment is based upon an x86 architecture Linux PC as the
development host.
The distribution and tools are supported on:
●
Red Hat Enterprise Linux workstation 4
●
Red Hat free Fedora distributions
In practice, many current x86 Linux PC distributions are usable.
Revision history
Table 1.
Document revision history
Date
Revision
21-Oct-2008
A
Changes
Initial release.
8162498
3/4
KPTrace
Please Read Carefully:
Information in this document is provided solely in connection with ST products. STMicroelectronics NV and its subsidiaries (“ST”) reserve the
right to make changes, corrections, modifications or improvements, to this document, and the products and services described herein at any
time, without notice.
All ST products are sold pursuant to ST’s terms and conditions of sale.
Purchasers are solely responsible for the choice, selection and use of the ST products and services described herein, and ST assumes no
liability whatsoever relating to the choice, selection or use of the ST products and services described herein.
No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted under this document. If any part of this
document refers to any third party products or services it shall not be deemed a license grant by ST for the use of such third party products
or services, or any intellectual property contained therein or considered as a warranty covering the use in any manner whatsoever of such
third party products or services or any intellectual property contained therein.
UNLESS OTHERWISE SET FORTH IN ST’S TERMS AND CONDITIONS OF SALE ST DISCLAIMS ANY EXPRESS OR IMPLIED
WARRANTY WITH RESPECT TO THE USE AND/OR SALE OF ST PRODUCTS INCLUDING WITHOUT LIMITATION IMPLIED
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE (AND THEIR EQUIVALENTS UNDER THE LAWS
OF ANY JURISDICTION), OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT.
UNLESS EXPRESSLY APPROVED IN WRITING BY AN AUTHORIZED ST REPRESENTATIVE, ST PRODUCTS ARE NOT
RECOMMENDED, AUTHORIZED OR WARRANTED FOR USE IN MILITARY, AIR CRAFT, SPACE, LIFE SAVING, OR LIFE SUSTAINING
APPLICATIONS, NOR IN PRODUCTS OR SYSTEMS WHERE FAILURE OR MALFUNCTION MAY RESULT IN PERSONAL INJURY,
DEATH, OR SEVERE PROPERTY OR ENVIRONMENTAL DAMAGE. ST PRODUCTS WHICH ARE NOT SPECIFIED AS "AUTOMOTIVE
GRADE" MAY ONLY BE USED IN AUTOMOTIVE APPLICATIONS AT USER’S OWN RISK.
Resale of ST products with provisions different from the statements and/or technical features set forth in this document shall immediately void
any warranty granted by ST for the ST product or service described herein and shall not create or extend in any manner whatsoever, any
liability of ST.
ST and the ST logo are trademarks or registered trademarks of ST in various countries.
Information in this document supersedes and replaces all information previously supplied.
The ST logo is a registered trademark of STMicroelectronics. All other names are the property of their respective owners.
© 2008 STMicroelectronics - All rights reserved
STMicroelectronics group of companies
Australia - Belgium - Brazil - Canada - China - Czech Republic - Finland - France - Germany - Hong Kong - India - Israel - Italy - Japan Malaysia - Malta - Morocco - Singapore - Spain - Sweden - Switzerland - United Kingdom - United States of America
www.st.com
4/4
8162498
Similar pages