[Next] [Previous] [Index] [Top]

Notice

CHAPTER 1 - Introduction

Intended Audience

Using this Book

Overview

Aprobe By Example

The Aprobe Window Interface

The Aprobe Command Prompt

CHAPTER 2 - Aprobe Basics

Overview of Aprobe

Some Definitions

A Simple Example

Using Aprobe

Predefined Probes

Built-in Operations

Summary

CHAPTER 3 - Writing APC Probes

Introduction

The Aprobe Preprocessor Directives

The probe Directive

Specifying Function Names

Probe Action Directives

The log Directive

Target Expressions

Nesting of Probes

Logging and Formatting Data

The Aprobe API

Debugging Your Probes

CHAPTER 4 - Advanced Topics

Probe Nesting and Visibility Rules

Probe Activation and State Transitions

Nested Probes and Recursive Calls

Parameters to Probe Actions

Symbols, Modules and Functions

The probe all Directive

Probe Types

Dynamic Probe Allocation, Deletion

Programmatic Instrumentation

Multiple APD Files

Parameters to a UAL

Aprobe Performance Considerations

CHAPTER 5 - Writing Java Probes

Requirements

Applying Java Probes

Tracing Java Programs

A Simple Example

Applying One Probe to Many Methods

Using Method IDs

Logging Data from Java

The onLine() Method

Advanced Java Probes

APPENDIX A - Tools Reference

Overview

apc

apcgen

apformat

apinfo

apjava

apmkadi

aprobe

atcmerge

APPENDIX B - Files Reference

ADI file

APC file

APD file

TC file

UAL file

XMJ file

APPENDIX C - Aprobe API Reference

Overview

Contents

Private Types and Operations

Basic Types

Action Routine Prototype

Aprobe Execution State

Enabling and Disabling Probes

Overview of Modules, Symbols, and Functions

Aprobe Module Operations

Aprobe Symbol Operations

Function ID Operations

Source Line Operations

Process and Thread Support

Instrumentation Support

Logging Support

Snapshot Support

APD File Information

UAL Support

Java Support

Logging String Values

Traceback Support

Stub Support

Exception Support

Time Support

Periodic Function Invocation

Support For Thread-Safe Operations

Reading Raw Memory

Bit Manipulation

Tracing Support

Memory Allocation Functions

General Utilities

APPENDIX D - Predefined Probes and Libraries Reference

Overview

How They Work

Performance Issues

Common Interfaces

Test Coverage Probe: coverage.dll

Performance Probe: events.dll

Profile Probe: profile.dll

Trace Probe: trace.dll

Trace Configuration GUI

Memory Watch Probe: memwatch.dll

Info Probe: info.dll

quick_gui Library

APPENDIX E - Perfmon and Eventlog Interfaces

Perfmon

Eventlog

Index