tnfenable

Turns on the tracing activity associated with the specified TNF probe.

SYNTAX

tnfenable [probes ...]| probe_group

DESCRIPTION

You control TNF probe tracing activity by switching the probes on or off. By default, probes start in the off state. Turn probes on using the tnfenable command.

You can enable probes by:

• Probe name - Defined in the TNF-instrumented Sun MPI library. Specify probes by using a list of space-separated probe names. You can also use probe names created in your own C or C++ program.

• A wildcard expression using shell pattern matching notation.

• A group name defined in the TNF-instrumented version of the Sun MPI library. Probes can belong to multiple probe_groups. If you specify a probe_group, all probes belonging to that probe_group are enabled. You can also use group names created in your own C or C++ program. You can specify only one probe_group per tnfenable command.

For further information about creating TNF probes and groups, see the TNF_PROBE(3X) man page. For further information about the shell pattern matching format accepted by tnfenable, see the fnmatch(5) man page.

To generate trace records, tnfcollection must be on.

EXAMPLES

To enable all MPI_Send* and MPI_Recv* probes:

(prism all) tnfenable *Send* *Recv*

To enable all probes:

(prism all) tnfenable *

You can use the tnfenable command in conjunction with the tnfcollection on command to restrict the set of enabled probes. For example,

(prism all) tnfcollection on; tnfenable probe_group 

accepts all of the defaults set by tnfcollection on, but enables only the probes in probe_group.