summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAnju T Sudhakar <anju@linux.vnet.ibm.com>2019-03-22 12:13:48 +0530
committerStewart Smith <stewart@linux.ibm.com>2019-03-28 15:24:13 +1100
commitf3a0fb69904074341ece69a26f375bdd948a9073 (patch)
treeb1967680b2d5b2c25c35b24c78af1ed71649c064
parent09e9121090703d828d2e122043513e9dca49a7c4 (diff)
downloadblackbird-skiboot-f3a0fb69904074341ece69a26f375bdd948a9073.tar.gz
blackbird-skiboot-f3a0fb69904074341ece69a26f375bdd948a9073.zip
doc/opal-api: Edit documentation for IMC opal call to include trace-imc
OPAL call APIs for In-Memory Collection Counter infrastructure(IMC), includes a new device type called OPAL_IMC_COUNTERS_TRACE. Edit the documentation to include this information. Signed-off-by: Anju T Sudhakar <anju@linux.vnet.ibm.com> Signed-off-by: Stewart Smith <stewart@linux.ibm.com>
-rw-r--r--doc/opal-api/opal-imc-counters.rst17
1 files changed, 9 insertions, 8 deletions
diff --git a/doc/opal-api/opal-imc-counters.rst b/doc/opal-api/opal-imc-counters.rst
index 0caef491..ee06d706 100644
--- a/doc/opal-api/opal-imc-counters.rst
+++ b/doc/opal-api/opal-imc-counters.rst
@@ -4,7 +4,7 @@ OPAL_IMC_COUNTERS_INIT
==============================
OPAL call interface to initialize In-memory collection
infrastructure. Call does multiple scom writes on each
-incavation for Core IMC initialization. And for the
+invocation for Core/Trace IMC initialization. And for the
Nest IMC, at this point, call is a no-op and returns
OPAL_SUCCESS. Incase of kexec, OS driver should first
stop the engine via OPAL_IMC_COUNTER_STOP(and then
@@ -24,7 +24,8 @@ Parameters
----------
``uint32_t type``
This parameter specifies the imc counter domain.
- The value should be 'OPAL_IMC_COUNTERS_CORE'
+ The value can be 'OPAL_IMC_COUNTERS_NEST', 'OPAL_IMC_COUNTERS_CORE'
+ or 'OPAL_IMC_COUNTERS_TRACE'.
``uint64_t addr``
This parameter must have a non-zero value.
@@ -49,14 +50,14 @@ OPAL_SUCCESS
OPAL_IMC_COUNTERS_START
============================
OPAL call interface for starting the In-Memory Collection
-counters for a specified domain (NEST/CORE).
+counters for a specified domain (NEST/CORE/TRACE).
Parameters
----------
``uint32_t type``
This parameter specifies the imc counter domain.
- The value can be either 'OPAL_IMC_COUNTERS_NEST'
- or 'OPAL_IMC_COUNTERS_CORE'
+ The value can be 'OPAL_IMC_COUNTERS_NEST',
+ 'OPAL_IMC_COUNTERS_CORE' or 'OPAL_IMC_COUNTERS_TRACE'.
``uint64_t cpu_pir``
This parameter specifices target cpu pir
@@ -77,7 +78,7 @@ OPAL_SUCCESS
OPAL_IMC_COUNTERS_STOP
======================
OPAL call interface for stoping In-Memory
-Collection counters for a specified domain (NEST/CORE).
+Collection counters for a specified domain (NEST/CORE/TRACE).
STOP should always be called after a related START.
While STOP *may* run successfully without an associated
START call, this is not gaurenteed.
@@ -86,8 +87,8 @@ Parameters
----------
``uint32_t type``
This parameter specifies the imc counter domain.
- The value can be either 'OPAL_IMC_COUNTERS_NEST'
- or 'OPAL_IMC_COUNTERS_CORE'
+ The value can be 'OPAL_IMC_COUNTERS_NEST',
+ 'OPAL_IMC_COUNTERS_CORE' or 'OPAL_IMC_COUNTERS_TRACE'
``uint64_t cpu_pir``
This parameter specifices target cpu pir
OpenPOWER on IntegriCloud