Deprecate OMNITRACE_USE_PERFETTO, OMNITRACE_USE_TIMEMORY (#306)

* Rename OMNITRACE_USE_PERFETTO to OMNITRACE_TRACE

* Rename OMNITRACE_USE_TIMEMORY to OMNITRACE_PROFILE

* Revert change to Perfetto.cmake

* Fix formatting

clang-format-11 was complaining about formatting

source/docs/instrumenting.md

@@ -249,7 +249,7 @@ Options:
     -d, --default-components       Default components to instrument (only useful when timemory is enabled in omnitrace
                                    library)
     --env                          Environment variables to add to the runtime in form VARIABLE=VALUE. E.g. use '--env
-                                   OMNITRACE_USE_TIMEMORY=ON' to default to using timemory instead of perfetto
+                                   OMNITRACE_PROFILE=ON' to default to using timemory instead of perfetto
     --mpi                          Enable MPI support (requires omnitrace built w/ full or partial MPI support). NOTE: this
                                    will automatically be activated if MPI_Init, MPI_Init_thread, MPI_Finalize,
                                    MPI_Comm_rank, or MPI_Comm_size are found in the symbol table of target

source/docs/output.md

@@ -16,8 +16,8 @@ E.g. with the base configuration:
 export OMNITRACE_OUTPUT_PATH=omnitrace-example-output
 export OMNITRACE_TIME_OUTPUT=ON
 export OMNITRACE_USE_PID=OFF
-export OMNITRACE_USE_TIMEMORY=ON
-export OMNITRACE_USE_PERFETTO=ON
+export OMNITRACE_PROFILE=ON
+export OMNITRACE_TRACE=ON
 ```
 
 ```shell

source/docs/python.md

@@ -115,7 +115,7 @@ if __name__ == "__main__":
     run(20)
 ```
 
-Using `omnitrace-python ./example.py` with `OMNITRACE_USE_TIMEMORY=ON` and `OMNITRACE_TIMEMORY_COMPONENTS=trip_count` would produce:
+Using `omnitrace-python ./example.py` with `OMNITRACE_PROFILE=ON` and `OMNITRACE_TIMEMORY_COMPONENTS=trip_count` would produce:
 
 ```console
 |-------------------------------------------------------------------------------------------|

source/docs/runtime.md

@@ -24,8 +24,8 @@ and tweak some sampling default values:
 
 ```console
 # ...
-OMNITRACE_USE_PERFETTO         = true
-OMNITRACE_USE_TIMEMORY         = true
+OMNITRACE_TRACE                = true
+OMNITRACE_PROFILE              = true
 OMNITRACE_USE_SAMPLING         = true
 OMNITRACE_USE_PROCESS_SAMPLING = true
 # ...
@@ -50,7 +50,7 @@ match to nearly all common expressions for boolean logic: ON, OFF, YES, NO, TRUE
 ### Exploring Components
 
 [OmniTrace](https://github.com/AMDResearch/omnitrace) uses [timemory](https://github.com/NERSC/timemory) extensively to provide various capabilities and manage
-data and resources. By default, when `OMNITRACE_USE_TIMEMORY=ON`, omnitrace will only collect wall-clock
+data and resources. By default, when `OMNITRACE_PROFILE=ON`, omnitrace will only collect wall-clock
 timing values; however, by modifying the `OMNITRACE_TIMEMORY_COMPONENTS` setting, omnitrace can be configured to
 collect hardware counters, CPU-clock timers, memory usage, context-switches, page-faults, network statistics,
 and many more. In fact, omnitrace can actually be used as a dynamic instrumentation vehicle for other 3rd-party profiling
@@ -179,8 +179,8 @@ $ cat ~/.omnitrace.cfg
 
 OMNITRACE_CONFIG_FILE                              =
 OMNITRACE_MODE                                     = trace
-OMNITRACE_USE_PERFETTO                             = true
-OMNITRACE_USE_TIMEMORY                             = false
+OMNITRACE_TRACE                                    = true
+OMNITRACE_PROFILE                                  = false
 OMNITRACE_USE_SAMPLING                             = false
 OMNITRACE_USE_PROCESS_SAMPLING                     = true
 OMNITRACE_USE_ROCTRACER                            = true
@@ -352,13 +352,13 @@ $ omnitrace-avail -S -bd
 | OMNITRACE_USE_CODE_COVERAGE             | Enable support for code coverage        |
 | OMNITRACE_USE_KOKKOSP                   | Enable support for Kokkos Tools         |
 | OMNITRACE_USE_OMPT                      | Enable support for OpenMP-Tools         |
-| OMNITRACE_USE_PERFETTO                  | Enable perfetto backend                 |
+| OMNITRACE_TRACE                         | Enable perfetto backend                 |
 | OMNITRACE_USE_PID                       | Enable tagging filenames with proces... |
 | OMNITRACE_USE_ROCM_SMI                  | Enable sampling GPU power, temp, uti... |
 | OMNITRACE_USE_ROCTRACER                 | Enable ROCM tracing                     |
 | OMNITRACE_USE_SAMPLING                  | Enable statistical sampling of call-... |
 | OMNITRACE_USE_PROCESS_SAMPLING          | Enable a background thread which sam... |
-| OMNITRACE_USE_TIMEMORY                  | Enable timemory backend                 |
+| OMNITRACE_PROFILE                       | Enable timemory backend                 |
 | OMNITRACE_VERBOSE                       | Verbosity level                         |
 | OMNITRACE_WIDTH                         | Set the global output width for comp... |
 |-----------------------------------------|-----------------------------------------|
@@ -1192,8 +1192,8 @@ $ENABLE                         = ON
 $SAMPLE                         = OFF
 
 # use fields
-OMNITRACE_USE_PERFETTO          = $ENABLE
-OMNITRACE_USE_TIMEMORY          = $ENABLE
+OMNITRACE_TRACE                 = $ENABLE
+OMNITRACE_PROFILE               = $ENABLE
 OMNITRACE_USE_SAMPLING          = $SAMPLE
 OMNITRACE_USE_PROCESS_SAMPLING  = $SAMPLE
 

source/docs/sampling.md

@@ -235,7 +235,7 @@ OMNITRACE_TRACE_THREAD_SPIN_LOCKS=true
 OMNITRACE_USE_KOKKOSP=true
 OMNITRACE_USE_MPIP=true
 OMNITRACE_USE_OMPT=true
-OMNITRACE_USE_PERFETTO=true
+OMNITRACE_TRACE=true
 OMNITRACE_USE_PROCESS_SAMPLING=true
 OMNITRACE_USE_RCCLP=true
 OMNITRACE_USE_ROCM_SMI=true
@@ -243,7 +243,7 @@ OMNITRACE_USE_ROCPROFILER=true
 OMNITRACE_USE_ROCTRACER=true
 OMNITRACE_USE_ROCTX=true
 OMNITRACE_USE_SAMPLING=true
-OMNITRACE_USE_TIMEMORY=true
+OMNITRACE_PROFILE=true
 OMP_TOOL_LIBRARIES=/opt/omnitrace/lib/libomnitrace-dl.so.1.7.1
 ROCP_TOOL_LIB=/opt/omnitrace/lib/libomnitrace.so.1.7.1
 
@@ -267,7 +267,7 @@ OMNITRACE_TRACE_THREAD_SPIN_LOCKS=false
 OMNITRACE_USE_KOKKOSP=false
 OMNITRACE_USE_MPIP=false
 OMNITRACE_USE_OMPT=false
-OMNITRACE_USE_PERFETTO=true
+OMNITRACE_TRACE=true
 OMNITRACE_USE_PROCESS_SAMPLING=true
 OMNITRACE_USE_RCCLP=false
 OMNITRACE_USE_ROCM_SMI=false
@@ -275,7 +275,7 @@ OMNITRACE_USE_ROCPROFILER=false
 OMNITRACE_USE_ROCTRACER=false
 OMNITRACE_USE_ROCTX=false
 OMNITRACE_USE_SAMPLING=true
-OMNITRACE_USE_TIMEMORY=true
+OMNITRACE_PROFILE=true
 
 ...
 ```
@@ -297,7 +297,7 @@ OMNITRACE_TRACE_THREAD_SPIN_LOCKS=false
 OMNITRACE_USE_KOKKOSP=false
 OMNITRACE_USE_MPIP=false
 OMNITRACE_USE_OMPT=false
-OMNITRACE_USE_PERFETTO=true
+OMNITRACE_TRACE=true
 OMNITRACE_USE_PROCESS_SAMPLING=true
 OMNITRACE_USE_RCCLP=false
 OMNITRACE_USE_ROCM_SMI=false
@@ -305,7 +305,7 @@ OMNITRACE_USE_ROCPROFILER=false
 OMNITRACE_USE_ROCTRACER=false
 OMNITRACE_USE_ROCTX=false
 OMNITRACE_USE_SAMPLING=true
-OMNITRACE_USE_TIMEMORY=true
+OMNITRACE_PROFILE=true
 
 [omnitrace][omnitrace_init_tooling] Instrumentation mode: Sampling