TNF Probes

Several of the Prism TNF commands (tnflist, tnfdebug, tnfenable, and tnfdisable) take arguments specifying probes by name, by wildcard, and by group name.

The Sun MPI 4.0 Programming and Reference Guide contains a complete list of the names of the probes in the TNF-instrumented Sun MPI library. The list includes the fields defined for each probe.

You can specify probes using arguments that include shell pattern matching wildcards, such as the asterisk (*). These wildcards take the form described in the fnmatch(5) man page.

You can also specify probes by group name. The TNF probe groups defined in the TNF-instrumented version of the Sun MPI library are listed in Table 6-2.

Table 6-2 Sun MPI Library TNF Probe Groups

Probe Group	Description
mpi_api	All API-level MPI functions
mpi_pt2pt	Functions that initiate point-to-point communications
mpi_blkp2p	All blocking point-to-point calls
mpi_nblkp2p	All nonblocking point-to-point calls
mpi_coll	Collective routines
mpi_procmgmt	Functions that deal with spawning and connecting to jobs
mpi_comm	Functions that create and manipulate communicators
mpi_datatypes	Functions that manipulate types or data in respect to types
mpi_request	Functions that create or operate on requests
mpi_topo	Functions that create and manipulate topology layouts

If you choose to insert TNF probes into your own code, you must define your own probe group identifiers. Group identifiers are required in order to use the group name as an argument to the tnfenable, tnfdisable, tnfdebug, and tnflist commands. To add group identifiers to any probes that you create, use the keys argument to the TNF_PROBE macro. For information about the TNF_PROBE macro, see the TNF_PROBE(3X) man page.

---

Note -

Neither the names of probes that you define nor the names of probe groups that you define should start with mpi_.

---