diff mbox series

[082/110] doc: Document OPAL_QUERY_CPU_STATUS

Message ID 20190531061351.22973-83-stewart@linux.ibm.com
State Accepted
Headers show
Series Big documentation cleanup/expansion | expand

Checks

Context Check Description
snowpatch_ozlabs/apply_patch success Successfully applied on branch master (76f7316bc8fc8a18fdbfcbc0e1fe1bb992d2a7d7)
snowpatch_ozlabs/snowpatch_job_snowpatch-skiboot fail Test snowpatch/job/snowpatch-skiboot on branch master
snowpatch_ozlabs/snowpatch_job_snowpatch-skiboot-dco success Signed-off-by present

Commit Message

Stewart Smith May 31, 2019, 6:13 a.m. UTC 
Signed-off-by: Stewart Smith <stewart@linux.ibm.com>
---
 doc/opal-api/opal-query-cpu-status-42.rst | 35 +++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 doc/opal-api/opal-query-cpu-status-42.rst
diff mbox series

Patch

diff --git a/doc/opal-api/opal-query-cpu-status-42.rst b/doc/opal-api/opal-query-cpu-status-42.rst
new file mode 100644
index 000000000000..b33edddc6ceb
--- /dev/null
+++ b/doc/opal-api/opal-query-cpu-status-42.rst
@@ -0,0 +1,35 @@ 
+.. _OPAL_QUERY_CPU_STATUS:
+
+OPAL_QUERY_CPU_STATUS
+=====================
+
+.. code-block:: c
+
+   #define OPAL_QUERY_CPU_STATUS			42
+
+   enum OpalThreadStatus {
+	OPAL_THREAD_INACTIVE = 0x0,
+	OPAL_THREAD_STARTED = 0x1,
+	OPAL_THREAD_UNAVAILABLE = 0x2 /* opal-v3 */
+   };
+
+   int64_t opal_query_cpu_status(uint64_t server_no, uint8_t *thread_status);
+
+Sets `thread_status` to be the state of the `server_no` CPU thread. CPU threads
+can be owned by OPAL or the OS. Ownership changes based on :ref:`OPAL_START_CPU`
+and :ref:`OPAL_RETURN_CPU`.
+
+``OPAL_THREAD_INACTIVE``
+  Active in skiboot, not in OS. Skiboot owns the CPU thread.
+``OPAL_THREAD_STARTED``
+  CPU has been started by OS, not owned by OPAL.
+``OPAL_THREAD_UNAVAILABLE``
+  CPU is unavailable. e.g. is guarded out.
+
+Returns
+-------
+
+:ref:`OPAL_PARAMETER`
+     Invalid address for `thread_status`, invalid CPU, or CPU not in OPAL or OS.
+:ref:`OPAL_SUCCESS`
+     Successfully retreived status.