Programming Utilities Guide

Attributes

Attributes are characteristics by which you identify probe points in your code. Table 1-3 lists the predefined attributes. You can add more attributes with the TNF_PROBE macros. See "Using the TNF_PROBE Macros".

Table 1-3 Predefined Attributes

Attribute 

Characteristics 

Value  

enable

A probe point performs the action that it is set up for only if it is enabled. For example, even when the tracing state is set, tracing occurs only if the probe point has been enabled. 

OFF (default) 

file

The name of the file containing the probe point. 

work.c
funcs

Shows the list of probe functions connected to this probe. Currently, only the debug function is available. 

<no value> (default) 

keys

The groups to which the probe point belongs. If any key in a probe point is enabled, then that probe point is enabled.  

work_module 

work 

line

The line number in the code on which the probe point occurs. 

10 

name

The name of the probe point. 

work_start 

object

The name of the shared object or executable that the probe is in. Useful for selecting all the probes in a particular module. 

work 

slots

The names of the probe point arguments (arg_name_n, see Failed Cross Reference Format.)

int_input 

string_input 

trace

When tracing for a probe point is on, a line is written to the trace file each time the probe point is executed in your program. 

ON (default)