This file is indexed.

/usr/share/pcp/demos/trace/README is in pcp 3.10.8build1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
sample pcp_trace applications
=============================

pmtrace
 is a sample application that uses the pcp_trace interface to send
trace data to the trace PMDA (Performance Metrics Domain Agent).

The binary is shipped as part of pcp and should be installed in
$PCP_BIN_DIR/pmtrace.  A pmtrace(1) man page is available.

The source is shipped as part of pcp as well and is installed in
$PCP_DEMOS_DIR/trace.  If you have the C compiler installed, the
source and Makefile in this directory may be used to create a
functionally equivalent binary, simply by entering the command

	% make pmtrace

The source in pmtrace.c demonstrates many of the trace services.


The C interface		( pmtrace.c, app1.c, app2.c, and app3.c )
===============
    The default Makefile rules build the C applications only, so
these applications can be built simply by using the command

	% make


The Fortran Interface	( fapp1.f )
=====================
    To build the sample Fortran program, using either the f77 or
f90 compilers, use one of these commands

	% make fortran77
	% make fortran90


The Java Interface	( japp1.java )
==================
    To build the sample Java program, and provided you have the
java compiler installed, use the command

	% make java

    Setting the environment variable $CLASSPATH to include the full
path to the trace.class file (/usr/java/classes/com/sgi/pcp) allows
the application to compile and run successfuly.
To run the demo application, after compilation type

	% java japp1

which passes the compiled class file into the java interpreter for
subsequent execution.


The pcp_trace "stub" library
============================
    To ensure that applications linked with the pcp_trace library are
not locked into being SGI-specific, a "stub" library which has all of
the pcp_trace entry points defined and simple debug switching enabled,
is provided (stub.c).  This shared library can be built using

	% make -f Makefile.stub

and is intended to be simple to port to other platforms.


Related manual pages
====================
    pmdatrace(1), pmtrace(1), and pmdatrace(3).